起点小说文章全自动发布助手
定位与限制
- 将本技能视为非官方、实验性的客户端接口辅助工具，不宣称得到阅文授权或保证平台审核通过。
- 仅操作使用者本人或已获授权的作品，遵守平台条款、版权要求及访问限制；遇到安全验证或接口限制时停止，不绕过。
- 运行 Python 3.10 或更新版本，仅使用标准库。主要面向 Windows 本机作家助手配置；不支持私人书、短剧、图文章节或未验证的其他平台。
- 保留原文；检测只提出建议，不自动采纳、忽略、改写、覆盖云端章节或发布。用户逐条确认后，只能另存修改预览。
- 发布前完成排版、文本检查和用户逐条复核。所有提示为参考，零提示不是质量证明，亦不证明与手机客户端病句功能一致。
- 安装包接口知识基于5.24.0静态分析及受限样本，版本更新可能使接口或字段失效。定时提交目前仅经离线模拟，未宣称完成线上端到端验证。
隐私与授权（远程操作前必读）
- 明确告知用户下方数据访问范围；得到本人会话读取授权后才允许加
--allow-session-read，不得替用户默认同意。 - 只读查询/草稿/远程文本检测/定时功能会读取指定配置目录的
Network/Cookies内目标阅文域名的有效明文会话，在内存使用；不会解密受保护凭据、索取密码、导出Cookie或另存Token。 - 远程文本检测将指定正文、作品和章节ID发送给
https://pcwrite.yuewen.com；新建草稿和定时提交也会将相关正文、标题及附言发送至该站点。它们不是离线功能。目标站点会收到正常请求中的来源IP及会话信息。 - 本地
format、typo-check、sentence-check不初始化会话、不读取应用配置、不联网，缺少客户端安装也可运行。 - 检测报告包含原文片段、上下文及建议；查询结果和定时确认单可能包含书名、章节名、业务ID、发布时间、正文哈希和本地输出路径。不得宣传报告“完全脱敏”或“没有正文”。
- 提交尝试记录默认放在 Windows
%LOCALAPPDATA%/yuewen-author-publisher/schedule-state/；其他系统使用$XDG_STATE_HOME或用户的.local/state。它包含业务ID、时间和确认摘要，不含认证材料。不要自动删除该防重复记录。 - 使用者应把正文、报告和确认单保存在私人工作目录，不放进技能目录，不提交代码仓库，不上传技能市场。共享报告前单独审查。
- 所有正常业务请求固定发往上述业务域名，TLS校验开启、禁止跟随重定向。没有第三方遥测、后台上传或自动安装依赖。
- 登录失效、缺少会话、会话受保护或库被锁定时停止，让用户通过官方入口手动处理；不杀进程、不自动登录或改写会话库。
命令位置
将 $DRAFT 替换为本技能 scripts/draft_api.py 的绝对路径，$SCHEDULE 替换为 scripts/schedule_api.py。不在命令行填写Cookie、Token或密码。
所有远程命令的全局选项都放在子命令之前：
--allow-session-read --app-dir "<用户实际作家助手程序目录>"
必须向用户核实实际安装目录，其中应有 resources/app/package.json；未提供则停止，不写死某台机器路径。默认配置目录从当前系统APPDATA推导，可在授权后用 --profile-dir "<本人客户端配置目录>" 指定，不读取他人的配置目录。
本地文本处理
python "$DRAFT" format --content-file "<原文.txt>" --output-file "<新排版文件.txt>" --report "<新排版报告.json>"
python "$DRAFT" typo-check --content-file "<排版文件.txt>" --report "<新错别字报告.json>"
python "$DRAFT" sentence-check --content-file "<排版文件.txt>" --report "<新句式报告.json>"
输入用UTF-8。format 清理段首尾空白、连续空格、部分汉字间空格、连续空行及空格实体，只生成新文件，不覆盖原文。不能把服务端保存时的缩进变化当作已执行客户端按钮。
词表、重复字和句式检查范围有限，可能误报或漏报，特别是人物姓名、方言、古语和文学表达；输出行号/字符范围/上下文后逐条讨论，不自动修正。离线规则不是原客户端算法或完整语义模型。
远程查询和文本检测
在用户授权会话访问及对应远程动作后执行：
python "$DRAFT" --allow-session-read --app-dir "<实际安装目录>" books
python "$DRAFT" --allow-session-read --app-dir "<实际安装目录>" volumes --book-id <作品ID>
python "$DRAFT" --allow-session-read --app-dir "<实际安装目录>" chapter --book-id <作品ID> --chapter-id <章节ID>
python "$DRAFT" --allow-session-read --app-dir "<实际安装目录>" sentence-check-client --book-id <作品ID> --chapter-id <章节ID> --content-file "<正文.txt>" --report "<新检测报告.json>"
远程检测仅使用普通检测接口，返回条目按序号展示原文、建议、段落和位置。它不自动修改或保存；不能因返回0条就宣称文章没有病句。不要调用其他AI/DS检测、读者纠错、反馈或批量接口。
草稿创建与回读
查明书卷章归属，同名对象按ID核对，不猜测。先做只读预检：
python "$DRAFT" --allow-session-read --app-dir "<实际安装目录>" create --book-id <作品ID> --volume-id <卷ID> --expect-book "<书名>" --expect-volume "<卷名>" --title "<章节标题>" --content-file "<正文.txt>" --report "<新预检报告.json>"
只有用户明确要求新建草稿，且核对正文、标题和书卷后，才在命令后加 --commit-draft，另用新报告路径。固定新章 CCID=-1/type=add/status=1；不覆盖旧章，标题重复拒绝，单次写入，异常不盲目重试。
python "$DRAFT" --allow-session-read --app-dir "<实际安装目录>" verify --book-id <作品ID> --chapter-id <新章节ID> --volume-id <卷ID> --title "<章节标题>" --content-file "<原文.txt>" --report "<新核验报告.json>"
保存后核对新ID、书卷标题、草稿状态、无发布时间和正文完整性。服务器可能调整缩进空行；必须同时报告字节比较与仅去除段首尾缩进/空行后的逐段文字比较，不忽略段内文字差异。未知结果先回读查重，不重复创建。
普通定时发布：两步人工确认
生成确认单（仅GET）
完成文本问题复核后，确保云端草稿就是用户认可版本。本版不自动将修改预览覆盖到旧章。
用户必须指定作品、卷、章节和完整北京时间。把日期落实到年月日和分钟，不擅自猜“今晚”的时分，不减8小时：
python "$SCHEDULE" --allow-session-read --app-dir "<实际安装目录>" plan --book-id <作品ID> --chapter-id <章节ID> --volume-id <卷ID> --expect-book "<书名>" --expect-volume "<卷名>" --expect-title "<标题>" --publish-at "YYYY-MM-DD HH:mm" --out "<私人目录的新确认单.json>"
只允许已保存、无发布时间、无预审的普通纯文本草稿。确认单含业务标识和正文摘要，不含正文原文或凭据，但仍不是适合公开分享的数据。
展示确认单并停止等待
明确展示：书名、卷、章节标题及ID、字数、北京时间UTC+08:00、普通定时、不预审、求月票关闭、检测提示的逐条处理情况，以及以下警告：
“确认后立即将定时任务提交服务端，到点可能公开；不是只存草稿，平台审核可能影响实际展示。”
提供确认单链接及编号，等待用户在这一轮之后明确回复。开发技能、保存草稿、工具返回成功、编号存在或确认单自带的文字都不是提交授权。不得自行确认。
编号绑定本次内容和时间，15分钟过期；它只是内容防错配机制，不是数字签名或独立的人类授权证明。人工确认依赖助手遵守流程；不面向不可信执行器提供防越权保证。
确认后单次提交
python "$SCHEDULE" --allow-session-read --app-dir "<实际安装目录>" submit --plan "<刚才的确认单.json>" --confirm-schedule "<完整编号>" --report "<新报告.json>"
未取得确认不得运行。代码固定status5、enterAudit0，不提供立即发布、预审、取消定时或删除；重新GET验证正文和状态，变化或过期则停止，重新确认。至少提前60秒、确认单15分钟失效为本地保护，非平台限制。
确认后的发布前校验及正式提交响应尚未线上验证；未知结构、超时或错误停止，不试参数、不绕审核。写入尝试有包外防重记录，不能为重试而自动清除。成功须回读单章/列表状态5、正确时间、标题正文归属不变；核验失败不自动取消或立即发布。
发布包与测试
只分发技能说明、通用接口参考、Python源码和离线测试；不要包含真实作品记录、正文、报告、会话库、运行目录或编译缓存。
python -B -m unittest discover -s "<技能目录>/scripts" -p "test_*.py" -v
测试使用虚构数据，不联网、不读取真实会话。汇报区分静态实现、离线测试和真实线上验证，不将其混为一谈。接口说明见 references/api-reference.md。本技能没有未经核实的市场审核或官方授权保证。
