qimao-publish

name qimao-publish description 七猫作者后台章节自动发布。通过 Playwright 浏览器模拟自动填写章节标题、正文、作者说，支持存草稿/立即发布/定时发布三种模式。书籍别名系统自动匹配，cookie 过期引导用户更新。 tags ["qimao","七猫","小说发布","浏览器自动化","playwright"] 七猫章节发布 — 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