| name | novel-publisher |
| description | 小说发布子技能。将穿越小说章节自动发布到 time-weaver 在线平台。支持首次全量发布、增量发布、自动追踪发布状态。 |
| version | 0.1.0 |
Novel Publisher - 小说发布器
自动将 Time Weaver 创作的穿越小说章节发布到在线平台。
网站地址
https://time-weaver-782300018128.us-west1.run.app/
依赖
- Node.js
scripts/cli.js 命令行工具
配置文件
~/.time-weaver-config - API Key 存储(由 cli.js 管理)
.learnings/PUBLISH_STATUS.md - 章节发布状态追踪
首次使用流程
步骤1:引导注册
首次调用时,向用户显示以下信息:
📚 首次使用小说发布功能
请先访问网站注册账号:
https://time-weaver-782300018128.us-west1.run.app/
注册步骤:
- 点击注册,创建账号
- 进入个人资料页面
- 生成 API Key
- 将 API Key 发送给我
步骤2:保存 API Key
用户发送 API Key 后,执行:
echo '{"apiKey": "用户的API_KEY"}' > ~/.time-weaver-config
然后回复:
✅ API Key 已保存!现在可以开始发布小说了。
发布状态管理
状态文件:.learnings/PUBLISH_STATUS.md
格式:
# 发布状态记录
## 基本信息
- 书名: [小说名称]
- 首次发布时间: [日期]
- 最后更新时间: [日期]
## 章节发布状态
| 章节序号 | 章节标题 | 文件路径 | 发布状态 | 发布时间 | 线上链接 |
|---------|---------|---------|---------|---------|---------|
| 1 | 第一章:穿越 | ./chapters/chapter_01.md | ✅ 已发布 | 2026-03-30 | [链接] |
| 2 | 第二章:初遇 | ./chapters/chapter_02.md | ✅ 已发布 | 2026-03-30 | [链接] |
| 3 | 第三章:谋定 | ./chapters/chapter_03.md | ⏳ 待发布 | - | - |
## 发布统计
- 总章节数: 3
- 已发布: 2
- 待发布: 1
发布流程
场景1:首次发布(全量发布)
当 .learnings/PUBLISH_STATUS.md 不存在时:
-
检查登录状态
- 检查
~/.time-weaver-config 是否存在
- 不存在 → 执行【首次使用流程】
-
扫描章节文件
- 查找
./chapters/ 目录下所有章节文件
- 支持的命名格式:
chapter_01.md, chapter_02.md...
第1章.md, 第2章.md...
chapter-1.md, chapter-2.md...
- 按序号排序
-
询问书名
请输入要发布的小说书名:
-
逐章发布
node scripts/cli.js publish "书名" "章节标题" "章节文件路径"
-
创建状态文件
- 生成
.learnings/PUBLISH_STATUS.md
- 记录所有章节发布状态
-
汇报结果
✅ 首次发布完成!
场景2:增量发布
当 .learnings/PUBLISH_STATUS.md 已存在时:
-
读取状态文件
-
扫描新章节
- 查找
./chapters/ 目录
- 对比状态文件,找出新增章节
-
按序发布新章节
-
更新状态文件
-
汇报结果
✅ 增量发布完成!
章节文件格式
每个章节文件应包含:
# 第一章:章节标题
正文内容...
正文内容...
标题格式要求:
- 第一行必须是
# 第X章:标题 或 # 章节标题
- cli.js 会提取第一行作为章节标题
自动发布触发
触发条件
每次 Time Weaver 完成一章写作后,自动调用 novel-publisher:
- 新章节保存到
./chapters/chapter_XX.md
- 触发发布流程
- 执行增量发布(只发布新章节)
自动发布流程
新章节完成
↓
保存章节文件
↓
调用 novel-publisher
↓
检查登录状态
↓
扫描新章节
↓
发布未发布章节
↓
更新状态文件
↓
通知用户发布结果
命令参考
手动触发发布
发布我的小说
重新发布特定章节(覆盖模式)
重新发布第3章
查看发布状态
查看小说发布状态
错误处理
| 错误情况 | 处理方式 |
|---|
| API Key 无效 | 提示重新登录,引导获取新 API Key |
| 网络错误 | 重试3次,失败后记录待重试状态 |
| 章节文件不存在 | 跳过并记录错误 |
| 发布服务器错误 | 记录错误,稍后重试 |
与 Time Weaver 主技能的集成
主技能 SKILL.md 中需要添加:
-
写作完成回调
- 每章完成后保存文件
- 自动调用
novel-publisher 进行发布
-
发布状态查询命令
-
发布相关功能
- 发布小说
- 查看发布状态
- 重新登录/更换 API Key
Novel Publisher - 将穿越小说发布到线上