homesafe2017 七猫章节发布 — LLM 使用指南
本文件是大模型（你）的操作指引。部署教程、Cookie 获取步骤等在 README.md 中。 所有可变配置（cookie、书籍别名、默认发布模式）在
config.json中。
如何工作
- 你读取
config.json获取 cookie 和书籍别名列表 - 用户说「发布xxx到《时间流域》」→ 你按别名字典找到 book_id
- 调用
scripts/publish_chapter.py执行发布 - 发布失败（Cookie 过期）→ 引导用户重新提供 cookie → 写入 config.json
config.json 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
cookie |
string | 完整 Cookie 字符串（空串=未设置，需引导用户填写） |
books |
object | 书籍别名映射。key=用户称呼的书名，value={id, title, default_mode, default_author_say} |
books.<name>.id |
string | 七猫书籍 ID（从上传页 URL 的 id= 参数获取） |
books.<name>.title |
string | 书籍全名，用于 URL 编码和日志 |
books.<name>.default_mode |
string | 该书默认发布模式：draft/publish/timed |
books.<name>.default_author_say |
string | 该书默认作者说 |
global_defaults.mode |
string | 全局默认发布模式 |
global_defaults.author_say |
string | 全局默认作者说 |
别名系统
config.json 中的 books 对象即别名映射。例如：
"books": {
"时间流域": { "id": "11901525", "title": "时间流域", "default_mode": "publish" },
"新书": { "id": "11903000", "title": "新书名", "default_mode": "draft" }
}
用户说「发布到时间流域」→ 你查 books["时间流域"] → book_id=11901525。 用户说「存草稿到新书」→ 你查 books["新书"] → book_id=11903000 + mode=draft。
如果用户提到的书名不在 config.json 中： 向用户询问书籍 ID 和书名，添加到 config.json 后再执行。
Cookie 管理流程
首次使用（cookie 为空）
- 告诉用户：需要七猫作者后台的 Cookie
- 提供获取方法简述（详见 README.md）
- 用户提供 cookie 字符串后，写入 config.json
Cookie 过期处理
执行发布时脚本返回失败（exit_code=1），如果在输出中看到「Cookie 可能已过期」：
- 通过微信通知用户：「七猫 Cookie 已过期，请重新获取并发给我」
- 同时提供 README.md 中的获取步骤
- 用户提供新 cookie → 写入 config.json → 重新执行发布
脚本调用方式
export QIMAO_COOKIE='<来自config.json的cookie>'
python scripts/publish_chapter.py <book_id> <章节名> <正文文件路径> \
--book-title <书名> --mode <draft|publish|timed> \
[--author-say "作者说"] [--timed-at "YYYY-MM-DD HH:mm"] [--config config.json]
重要： 始终通过 export QIMAO_COOKIE=... 设置环境变量，不要在命令行参数中传 cookie。
--config config.json： 发布成功后脚本会自动从浏览器会话捕获最新 Cookie 并写入文件，下次无需手动更新。
章节名称规则： 只传标题本身，不携带"第X章"前缀。七猫会自动根据上一章的 name_index 递增编号。例如章节名应为 跃迁 而非 第4章 跃迁。
正文文件规则： 正文文件只包含正文内容，不要包含章节名称、标题等额外文字。
正文文件支持：
- HTML 格式（直接含
<p>标签） - 纯文本格式（自动用
<p>包裹段落，空行分段） - 正文要求 ≥1000 字（七猫硬性限制），不足时发布按钮不会触发
完整发布流程时序（简述）
- 启动 Chromium（headless）→ 注入 Cookie → 导航到上传页
- 验证登录状态 → 填写章节标题 → 填写正文 → 填写作者说（可选）
- draft：点击「存为草稿」→ 截图保存
- publish：存草稿 → 点击「立即发布」→ 处理「重要提醒」对话框 → 点击「确认发布」
- timed：存草稿 → 点击「定时发布」→ 处理对话框 → 填写时间 → 确认
常见故障（LLM 侧排查）
| 症状 | 排查 |
|---|---|
| 找不到按钮 | 通常是 cookie 过期导致页面跳转到登录页 |
| 发布后 URL 不含 book-manage | 结果不确定，检查截图 /tmp/qimao_result_{id}.png |
| Cookie 报错 | 引导用户重新获取 |
| 章节名重复 | 提示用户换一个章节名称 |
| 字数不够 | 检查正文是否 ≥1000 字 |
| Playwright 未安装 | 见 README.md 前置条件 |
| 定时模式报错 | 检查 timed_at 格式 "YYYY-MM-DD HH:mm" |
关键限制
- 正文最少 1000 字，最多 50000 字
- 章节名最多 20 个字
- 作者说最多 2000 字
- 同一本书不允许重复章节名
- 每次登录后首次发布会出现「重要提醒」对话框
- headless 模式可能被风控检测，如失败尝试 headless=False