novel-publisher

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/

注册步骤：

1. 点击注册，创建账号
2. 进入个人资料页面
3. 生成 API Key
4. 将 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 不存在时：

1. 检查登录状态

   • 检查 ~/.time-weaver-config 是否存在
   • 不存在 → 执行【首次使用流程】

2. 扫描章节文件

   • 查找 ./chapters/ 目录下所有章节文件
   • 支持的命名格式：
     • chapter_01.md, chapter_02.md...
     • 第1章.md, 第2章.md...
     • chapter-1.md, chapter-2.md...
   • 按序号排序

3. 询问书名

   请输入要发布的小说书名：

4. 逐章发布

   • 对每一章执行：

   node scripts/cli.js publish "书名" "章节标题" "章节文件路径"
   

   • 记录发布结果

5. 创建状态文件

   • 生成 .learnings/PUBLISH_STATUS.md
   • 记录所有章节发布状态

6. 汇报结果

   ✅ 首次发布完成！

   • 共发布 X 章
   • 成功: X 章
   • 失败: X 章
   • 访问 https://time-weaver-782300018128.us-west1.run.app/ 查看

场景2：增量发布

当 .learnings/PUBLISH_STATUS.md 已存在时：

1. 读取状态文件

   • 解析已发布的章节列表
   • 识别待发布章节

2. 扫描新章节

   • 查找 ./chapters/ 目录
   • 对比状态文件，找出新增章节

3. 按序发布新章节

   • 只发布标记为「待发布」的章节
   • 保持章节顺序

4. 更新状态文件

   • 更新已发布章节的状态
   • 更新最后更新时间

5. 汇报结果

   ✅ 增量发布完成！

   • 本次发布: X 章
   • 累计发布: X/X 章

---

章节文件格式

每个章节文件应包含：

# 第一章：章节标题

正文内容...
正文内容...

标题格式要求：

• 第一行必须是 # 第X章：标题 或 # 章节标题
• cli.js 会提取第一行作为章节标题

---

自动发布触发

触发条件

每次 Time Weaver 完成一章写作后，自动调用 novel-publisher：

1. 新章节保存到 ./chapters/chapter_XX.md
2. 触发发布流程
3. 执行增量发布（只发布新章节）

自动发布流程

新章节完成
    ↓
保存章节文件
    ↓
调用 novel-publisher
    ↓
检查登录状态
    ↓
扫描新章节
    ↓
发布未发布章节
    ↓
更新状态文件
    ↓
通知用户发布结果

---

命令参考

手动触发发布

发布我的小说

重新发布特定章节（覆盖模式）

重新发布第3章

查看发布状态

查看小说发布状态

---

错误处理

错误情况	处理方式
API Key 无效	提示重新登录，引导获取新 API Key
网络错误	重试3次，失败后记录待重试状态
章节文件不存在	跳过并记录错误
发布服务器错误	记录错误，稍后重试

---

与 Time Weaver 主技能的集成

主技能 SKILL.md 中需要添加：

1. 写作完成回调

   • 每章完成后保存文件
   • 自动调用 novel-publisher 进行发布

2. 发布状态查询命令

   • 用户可随时查询发布进度

3. 发布相关功能

   • 发布小说
   • 查看发布状态
   • 重新登录/更换 API Key

---

Novel Publisher - 将穿越小说发布到线上