dsh-chapter-whale 0.0.0-stage → 0.4.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 novel-helper contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,217 @@
-# Temporary Holding Version
+# 码章鲸 · 全自动小说写作与番茄发布
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**设好任务，让小说自己写下去、发出去。**
+
+码章鲸是运行在 DeepSeek Harness（DSH）里的无人值守小说工作台。连接模型、登录账号、设定任务后，由本机服务按计划完成章节写作、审查修订、发布与状态核验。你可以安排更新时间、每次章数和篇幅，也可以接入部分免费模型，通过支持的厂商账号渠道完成授权。
+
+**[npm 安装](https://www.npmjs.com/package/dsh-chapter-whale)** · **[下载完整安装包](https://github.com/thus-zhou/dsh-chapter-whale/releases/latest)** · **[从安装到自动连载](docs/quickstart.md)** · **[查看全部实机图](docs/screenshots.md)**
+
+Windows 10/11 x64 · DSH ≥ 0.2.2-rc.1 · 内置 Python 与浏览器 · 首个公开版本
+
+**安装三步**：① 在 DSH 插件管理中添加 npm 包名 `dsh-chapter-whale`，或从[最新发布页](https://github.com/thus-zhou/dsh-chapter-whale/releases/latest)下载完整 `.tgz` → ② 安装后重启 DSH → ③ 侧栏打开「码章鲸」：建作品、配模型，需要发布时再登录番茄作家后台。
+
+首次启动会在 `%LOCALAPPDATA%\ChapterWhale\workspace` 建独立工作区并准备运行时，约占 400MB 磁盘。npm 包首次启动自动下载并校验约 278 MB 的固定版本环境；GitHub 完整包已包含环境。作品与账号数据留在独立工作区，卸载插件不会删除。完整包摘要见发布页的 `SHA256SUMS.txt`。仅支持 Windows x64。
+
+![码章鲸：全自动写作与发布、可自定义任务、部分免费模型与厂商账号登录](assets/chapter-whale-overview.png)
+
+## 把每天要做的更新，交给一个任务
+
+适合已经有故事想法，希望持续产出网文章节、维护连载的创作者。把题材、人物、文风和更新计划设好之后，码章鲸按同一套任务继续往下写，把生成、检查和提交发布接起来。
+
+| 你想完成的事 | 码章鲸如何执行 |
+| --- | --- |
+| 每天按时更新 | 按任务设置的时间和时区触发，支持每天多个时段 |
+| 自动完成一批章节 | 按每次章数、目标字数与已有规划推进写作 |
+| 写完继续检查和修订 | 在任务流程中执行审查，并按设置尝试修订 |
+| 合格章节自动提交番茄 | 校验作品、账号、来源与审查记录后，执行发布并核验状态 |
+| 尽量利用已有模型资源 | 接入部分免费额度模型，以及支持的厂商账号渠道 |
+| 随时知道任务做到哪里 | 查看当前章节、批次、进度、发布状态与操作历史 |
+
+**首次配置完成并启用自动调度后，正常运行不需要逐章手动点击“生成”和“发布”。** 电脑与本地服务需要保持运行，模型可用、账号登录有效；验证码或授权失效时，由账号本人处理后继续。
+
+## 一条自动执行的连载流程
+
+```mermaid
+flowchart LR
+    A[设定作品与日更任务] --> B[到点自动启动]
+    B --> C[按规划与记忆生成章节]
+    C --> D[自动审查与修订]
+    D --> E{满足发布条件}
+    E -->|满足| F[自动入队并提交番茄]
+    F --> G[核验发布状态与记录]
+    G --> H[等待下一次任务]
+    E -->|未满足| I[保留结果与原因，等待恢复或处理]
+```
+
+工作台会保留执行状态、章节内容和发布记录。需要干预时，可以查看原因、调整设置、暂停任务或恢复符合条件的批次。
+
+## 自己定时间、定章数、定篇幅
+
+你可以为作品创建自己的日更计划。例如：每天 08:00 和 20:00 各执行一次，每次 1 章，目标每章 3,500 字，最多修订 2 轮。
+
+| 任务设置 | 可以控制什么 |
+| --- | --- |
+| 作品、平台书名与账号 | 这项任务替哪部作品、哪个账号更新 |
+| 每日时间与时区 | 何时启动；支持多个更新时间 |
+| 每次章节数 | 每个时段推进多少章 |
+| 每章目标字数 | 本次写作希望达到的篇幅 |
+| 修订轮数 | 自动审查后允许继续修改的次数 |
+| 启用、暂停、立即执行与恢复 | 自己控制自动任务的运行节奏 |
+
+![日更任务的时间、章数、字数与执行控制](assets/screenshots/01-automation.png)
+
+*实机记录：截图时任务已经结束并停用，保留当时的真实状态。新建任务和自动调度开关位于随包提供的完整管理页，具体步骤见[上手指南](docs/quickstart.md#4-创建自己的日更任务)。*
+
+## 已接入部分免费模型，也支持部分厂商账号登录
+
+已有可用的厂商账号，可以通过支持的渠道授权，再把可用模型用于写作任务；已有 API 服务，也可以直接配置 OpenAI 兼容接口。
+
+- **渠道集中查看**：在同一个页面查看账号渠道、模型与使用状态。
+- **部分厂商登录**：按对应渠道提供的登录流程完成授权，扫码或验证码由本人操作。
+- **免费额度模型**：选择已可用、已确认额度类型的模型，配置到写作流程或免费渠道池。
+- **按需轮换**：免费渠道池支持选入模型和授权作品，按配置尝试可用连接。
+- **付费备选自行决定**：需要时再配置自己的备选模型与费用策略。
+
+![部分免费模型与厂商账号渠道的实机页面](assets/screenshots/03-free-channels.png)
+
+画面展示 CodeArts、WorkBuddy、Qoder、TRAE 等渠道入口。实际支持的登录方式、可用模型、额度和授权要求，以对应渠道的当前返回为准。完整管理页的「AI 设置 → 免费额度接入」提供渠道服务与授权操作；侧栏「免费渠道」用于查看状态。
+
+## 自动运行，也能看清每一步
+
+### 工作台：看任务进度和发布结果
+
+当前任务是否在运行、正在推进哪一章、批次是否结束、队列里还有多少内容，都能集中查看。已核验发布、未确认和归档待核会分别显示。
+
+![工作台中的作品进度、队列与任务结束状态](assets/screenshots/02-dashboard.png)
+
+### 作品与章节：自动产出的内容仍然可以查看和调整
+
+按章查看标题、字数与审查状态。需要时打开正文、重新审查或润色，把对内容的控制留在自己手里。
+
+![章节列表中的字数、审查状态与操作入口](assets/screenshots/04-chapters.png)
+
+### 连载记忆：让后续写作带着已有设定往前走
+
+共享记忆集中保存固定设定、已发生事实、伏笔与创作偏好。创作约定则保存题材、受众、人物和文风，作为自动写作的方向。
+
+<table>
+  <tr>
+    <td width="50%"><img src="assets/screenshots/05-memory.png" alt="长篇共享记忆中的设定、事实与偏好"><br>随章节积累的长篇记忆</td>
+    <td width="50%"><img src="assets/screenshots/06-creative-brief.png" alt="题材、受众、人物和文风的创作约定"><br>让自动写作遵循你的创作约定</td>
+  </tr>
+</table>
+
+模型分工、审查策略、成本统计和操作历史也保留在工作台中，需要时再进一步调整。[查看七张完整实机图 →](docs/screenshots.md)
+
+> 图片来自作者提供的个人使用环境，已裁剪并以不透明区域遮盖作品信息、账号情况、本机路径及个人配置。未使用 AI 重绘界面或更改任务状态。部分画面沿用旧名称「小说助手」；背景是用户的个性化环境，公开版名称为「码章鲸」，界面随 DSH 主题显示。图中规模和数量是当时的项目记录。
+
+## 安装后，按这四步开始
+
+### 1. 从 npm 安装，或使用完整发行包
+
+**DSH 桌面版**：在应用内「插件」管理中添加包名 `dsh-chapter-whale`，安装完成后重启。桌面 profile 由应用管理，推荐直接使用应用内的安装入口。
+
+**使用 `dsh web` 的用户**：在终端安装到自己的 web profile：
+
+```powershell
+dsh plugin --profile web add dsh-chapter-whale
+```
+
+安装后重启 `dsh web`，侧栏打开「码章鲸」。自定义 profile 请将 `web` 换成实际名称。npm 包提供插件与后端源码，Python 和浏览器会在首次启动时从 GitHub 自动下载，并核对固定大小与 SHA-256，不需要手动安装。
+
+也可以先从 npm 下载压缩包：
+
+```powershell
+npm pack dsh-chapter-whale@latest
+```
+
+然后把生成的 `.tgz` 文件交给 DSH 插件管理安装。`npm pack` 只下载插件包，首次启动仍需要下载运行环境。
+
+**希望一次下载完整环境**：使用下方 GitHub 完整发行包。
+
+在 DSH 插件管理中添加下方地址，安装完成后重启 DSH，从侧栏打开「码章鲸」，点击「开始使用码章鲸」。
+
+```text
+https://github.com/thus-zhou/dsh-chapter-whale/releases/download/v0.4.3/dsh-chapter-whale-0.4.3.tgz
+```
+
+完整包约 **278 MB（265 MiB）**，包含独立 Python、写作后端和 Chromium，无需自己安装 Python、下载后端或填写项目目录。
+
+<details>
+<summary>使用命令行安装</summary>
+
+```powershell
+dsh plugin --profile web add https://github.com/thus-zhou/dsh-chapter-whale/releases/download/v0.4.3/dsh-chapter-whale-0.4.3.tgz
+```
+
+这条命令面向 `dsh web`；桌面版请在应用内添加地址。也可以通过[自定义市场源](https://raw.githubusercontent.com/thus-zhou/dsh-chapter-whale/main/market/index.json)安装；源码安装的首次启动会自动下载并校验同版本环境。
+
+</details>
+
+#### 后续更新
+
+桌面版请在插件管理中检查更新。使用命令行的 web profile：
+
+```powershell
+dsh plugin --profile web update dsh-chapter-whale
+```
+
+更新后重启对应的 DSH。若旧版宿主未完成升级，可显式安装 `dsh-chapter-whale@latest`。更新只替换插件及随版本提供的代码，作品、账号和任务保存在独立工作区；更新前建议备份该目录。首次环境已准备好且运行时版本未变时，不会重复下载。
+
+### 2. 创建作品，连接模型和账号
+
+在「开始创作与账号」填写书名与故事想法，再连接自己的模型。需要使用厂商账号渠道时，按完整管理页的授权流程操作。准备发布时，登录自己的番茄作家账号，并在平台创建对应作品。
+
+### 3. 建立日更任务
+
+插件启动后，打开本机完整管理页：
+
+```text
+http://127.0.0.1:18765
+```
+
+进入「日更任务 → 创建日更任务」，选择作品与账号，设置时间、每次章数、目标字数和修订轮数。侧栏面板可以查看和调整已有任务；完整管理页提供新建任务与全局调度开关。
+
+### 4. 开启自动调度，让任务按计划执行
+
+启用这项任务，再打开「自动调度」。建议先用小章数跑通自己的模型与发布账号，再逐步调整更新量。此后保持本机服务运行，在工作台查看自动执行结果即可。
+
+**[查看完整上手教程：从首次安装到无人值守连载 →](docs/quickstart.md)**
+
+## 常见问题
+
+**可以完全无人值守吗？**
+
+可以在首次配置、模型连接和账号授权完成后，按已启用的任务自动写作、审查、修订并提交发布，正常执行不需要逐章点击。电脑或服务停止、额度耗尽、验证码、平台登录失效等情况需要恢复相应条件。
+
+**免费模型在哪里登录？**
+
+先启动码章鲸，打开本机完整管理页，进入「AI 设置 → 免费额度接入」，启动独立渠道服务，再按支持渠道的页面操作。各厂商的账号、授权和额度规则分别生效。
+
+**为什么建好任务还没有自动运行？**
+
+同时检查任务是否启用、全局「自动调度」是否开启、设定时区和时间是否正确，以及模型与发布账号是否可用。任务状态和操作历史会保留进一步的原因。
+
+**一定要配置多个模型吗？**
+
+不需要从复杂分工开始。先用自己的可用模型跑通流程，再按需要调整各阶段的模型与审查策略。
+
+**作品和账号数据存在哪里？**
+
+默认保存在本机 `%LOCALAPPDATA%\ChapterWhale\workspace`，与插件安装目录分开。更新或卸载插件不会主动删除这些数据；请自行备份工作区。默认后端地址为 `127.0.0.1:18765`。
+
+**支持什么系统和平台？**
+
+当前公开版支持 Windows 10/11 x64、DSH ≥ 0.2.2-rc.1，发布适配番茄小说。平台审核与发布规则仍由平台决定。ARM64、macOS 和 Linux 尚未验收。
+
+## 文档与项目状态
+
+- [从安装到自动连载](docs/quickstart.md)：模型、厂商登录、番茄账号、任务和自动调度。
+- [七张实机截图](docs/screenshots.md)：各页面的用途及脱敏说明。
+- [当前版本验证记录](RELEASE_STATUS.md)：47 项插件测试、148 项后端测试、全新安装与独立 DSH 加载验证。
+- [插件市场收录进度](market/SUBMISSION.md)：已提交的申请与已核对的自动收录记录。
+- [反馈问题](https://github.com/thus-zhou/dsh-chapter-whale/issues)：附上版本、错误提示和脱敏截图，方便定位。
+
+包名为 `dsh-chapter-whale`，当前发行版本为 `0.4.3`（0.3.0 预发行）。项目使用 AI 辅助开发，组件声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+
+**[下载码章鲸，设置你的第一项自动更新任务 →](https://github.com/thus-zhou/dsh-chapter-whale/releases/tag/v0.4.3)**

package/RELEASE_STATUS.md

@@ -0,0 +1,61 @@
+# 0.4.3 安装兼容补丁
+
+0.4.2 之后的线上 Windows 检查发现，新版系统 bsdtar 对中文文件名存在兼容问题。本补丁使用固定版本 node-tar，在解包前检查路径和文件类型，支持中文目录与文件名，保留摘要校验与链接拒绝规则。
+
+本次只更新插件安装器，后端和 Python/Chromium 内容不变，因此复用 0.4.2 的完整运行时资产及其清单（buildId `79a1db4e…`）。插件版本 0.4.3 与运行时版本 0.4.2 分别记录；首次启动按相同 buildId 和完整归档摘要核对。
+
+本地 Node 56 项通过；后端集成 277、管理端 83 项沿用本轮通过记录，合计 416 项。线上实际安装包检查单独登记，不以源码检查代替。
+
+## 0.4.2 验证范围
+
+日期：2026-11-15（北京时间）。本版包含第二轮独立复验 R01—R06 修复，以及此前 main 上尚未进入 0.4.0 安装包的修复。
+
+已完成的本地验证：
+
+- 后端集成 277 项、管理端 83 项、Node 54 项，共 414 项检查通过。
+- 生产函数回归覆盖：损坏数据库阻止请求、首次导入审查提交事实与人物认知、失败重审撤销资格、当前门槛和约定下的版本推荐、人物来源过期、统一预算、场景不重复注入。
+- 实际完整安装包解包到全新目录，自带 Python 启动服务成功；作品、账号、模型凭据为空，调度关闭，写作引擎与提示文件可导入。
+- 实际轻量包首次启动：将同一完整包原始字节作为下载响应，校验大小、SHA-256、buildId 和全部后端文件后安装、启动成功。该步骤是发布前的真实安装链路验证，联网下载回验另行登记。
+- 桌面和 390px 浏览器验证由独立测试环境执行；最终检查结果见仓库的修复验收记录。
+
+本轮新增模型请求 0，没有发布真实章节，没有替换个人日常安装。此前 M09/M15 的两章真实生成、整章 D 审查、跨章人物与事实效果，以及缺少的文风学习主流程仍待补验；414 项离线检查不能代替这些真实效果验证。
+
+发行顺序：生成当前清单 → 构建完整包并检查隔离暂存内容 → 自动写入该包的下载描述 → 构建轻量包 → 对最终包执行首次启动验证 → GitHub / npm / 市场同步。源码、分发和真实模型验证分别记录。
+
+## 历史记录：0.2.0-rc.1 首个公开版本
+
+这是包含完整本地环境的首个公开版本，2026-11-11 起在 GitHub 标记为 Latest。版本号保留 `rc.1`：功能范围已冻结，但后续仍会快速迭代。由 AI 辅助开发。
+
+已执行：
+
+- 47 项插件测试：同源访问、令牌、写白名单、服务归属、客户端注册、清单与市场格式。
+- 148 项后端测试：写作提交、审查回执、发布资格、文件锁、账号隔离、模型配置、设备访问和创作工作流。模型和平台由测试替身提供。
+- 全新临时目录使用自带 Python 启动管理服务，无原作品、账号、密钥或自动调度。
+- 真实 Chromium 渲染面板，创建作品、进入 AI 设置、切换至发布队列；未登录时发布按钮禁用。
+- 桌面和 390px 手机宽度检查；手机页面无横向溢出，浏览器无脚本异常。
+- 修复实体路径字符校验、实体失败写入状态、免费池思考模式接口、旧确认任务静默转为自动执行、无审批服务时工具自行写入，以及日志尾部读取。
+
+本次未调用收费模型、登录真实发布账号或提交真实章节。以上检查不能替代具体模型和平台账号的真实发布验收。请先生成、阅读并审查一章，再在自己的平台账号中核对实际发布记录。
+
+发行后验证（2026-11-10）：
+
+- GitHub 源码与 v0.2.0-rc.1 发行页已公开；2026-11-11 起该版本标记为 Latest（不再是 Pre-release），发行页另附 `SHA256SUMS.txt` 供核对安装包摘要。
+- 完整安装包 277,747,400 字节；GitHub 资产摘要与本地下载清单一致：SHA-256 `158aa68e2154dc2461e9ded20ca380cf240777b5a56a4ae9ea3c57ba2c816d85`。
+- 从 GitHub 标签重新检出不含运行环境的源码，自动下载、完整性校验、解包、启动及空白数据检查通过；本机网络实测 72 秒。
+- 在独立的本机 DSH 0.2.2-rc.1 测试配置中完成安装并打开面板，未见页面脚本异常；本次未更改个人日常 profile。
+- GitHub Actions 的 Windows 与 Ubuntu 源码检查通过。完整运行环境仅支持 Windows x64。
+- 自定义市场索引返回 HTTP 200，并固定到可安装源码提交。
+- 社区精选目录投稿已于 2026-11-11 提交：[申请 #14316](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/14316)，收录以维护者合并为准。
+
+免费渠道依赖中的 Gemini OAuth 默认凭据已从发行副本移除，并更新来源锁定哈希；相关渠道须使用自行配置的凭据。npm 已公开发布；下载安装不要求使用者注册 npm。
+
+
+2026-11-11 npm 发布与安装验证：
+
+- 同步保留当天的首个公开版本说明、最新发行页入口和磁盘占用提示。
+- npm 包 `dsh-chapter-whale@0.2.0-rc.1` 已发布，`latest` 指向该版本；包大小约 9.3 MB，运行环境不重复塞入 npm 包。GitHub 完整包继续保留。
+- 47 项插件检查全部通过；对实际 npm 压缩包解包，确认后端源码、入口、补丁、文档和截图存在，没有作品、账号或本机运行时目录。
+- 使用 npm 压缩包在全新独立目录自动下载并校验固定环境，后端启动成功，作品与账号均为空；本机实测约 81 秒，验证后已停止该测试服务。
+- 这次改动涉及发行方式、文档和市场元数据，没有新增真实模型调用或真实章节发布验收。
+- npm 公开源下载回验一致，并使用本机 DSH CLI 在独立 profile 执行 `add dsh-chapter-whale@0.2.0-rc.1` 安装成功；没有改动日常 DSH 配置。
+- [市场投稿记录](market/SUBMISSION.md)分别记录待审核申请与已核对的自动收录。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,16 @@
+# 第三方组件与来源
+
+本软件由多个组件组合而成，项目使用 AI 辅助开发。以下保留随包组件要求的声明。
+
+| 组件 | 许可状态 | 处理 |
+| --- | --- | --- |
+| 原 dsh-novel-helper 连接器 | MIT，保留原 LICENSE | 新增托管环境与首装功能另见修改记录 |
+| webnovel-writer 写作器 | 上游 README 声明 GPL v3 | 保留 README，随包附 GPL v3 全文与修改记录；对应源码在 backend/webnovel-writer/，原仓库为 https://github.com/981029l/webnovel-writer |
+| 发布适配组件 | AI 辅助开发 | 依据维护者确认的来源说明，不附加个人署名 |
+| Our Free Model 及锁定依赖 | MIT 等，保留各目录许可证 | 来源与本地补丁见 backend/vendor/ofm-source-lock.json |
+| Python | PSF License，随官方发行保留 LICENSE.txt | 下载来源和 SHA-256 见 runtime-manifest.json |
+| Chromium / Playwright / Python 依赖 | 各自许可 | 保留发行包和 dist-info 中的许可证，不删除相关文本 |
+
+权利与联系处理：如发现来源、许可或权利问题，请通过仓库 Issue 联系维护者；维护者将核实并处理。此说明不替代任何组件的许可证。
+
+修改记录（2026-11-10）：增加自带 Windows 环境、独立用户数据目录、首装建书与登录入口、作品切换和发布账号/书名选择；托管模式不读取旧的全局模型配置。现有个人部署没有被替换。

package/backend/fanqie_auto_publish/README.md

@@ -0,0 +1,133 @@
+# Fanqie Auto Publish (番茄小说全自动发文机器人) 🍅🤖
+
+这是一个基于 `Playwright` 的强大的番茄小说全自动网页端发文与状态管理自动化脚本。
+它能在完全无人值守的情况下，将本地批量的 `.txt` 章节文件精准投递并发布到番茄作家后台，且自带极其强悍的“断点续检”与“弹窗斩杀”机制。
+
+## 核心特性 ✨
+
+- **智能断点续传**：意外中断后重启脚本，不会傻傻地重复创建章节，而是会进入【章节管理】自动识别未完成的残片草稿并继续覆盖发布。
+- **神级弹窗斩杀器**：内置基于物理坐标（Y轴边界过滤）的霸道扫雷机制。不管是“新手引导 1/4”、还是“错别字警告”、“内容风险拦截”，都会被脚本瞬间点爆。
+- **强制合规声明**：在最终发布面板中，脚本能自动拦截并勾选“是否使用AI”的法定单选框，确保发布万无一失。
+- **多书隔离管理**：`chapters/` 下按书名建立子目录（如 `chapters/ai编程末日/`、`chapters/青冥独行录/`），脚本自动扫描并列出有待发章节的书籍，输入序号即可精准发布。发文成功后自动归档到 `uploaded/书名/` 下，多部小说章节永不混乱。
+- **自定义发布数量**：选择小说后可自行指定本次发布的章节数（直接回车发布全部，输入数字则只发布前 N 章），灵活应对番茄平台每日发布上限，未发章节保留原位待下次发布。
+- **封面贴字插件**：附带 `add_text.py` 脚本，可调用 `Pillow` 为 AI 生成的纯净封面图自动加上标准排版的极客风书名（应对审核不合格）。
+
+## 目录结构 📁
+
+_由于涉及个人隐私与作品版权，以下数据目录已被 `.gitignore` 保护，不会被上传：_
+
+```
+chapters/                    # 待发章节（按书名建子目录）
+  ├── ai编程末日/
+  │     ├── 101 第101章.txt
+  │     └── 102 第102章.txt
+  └── 青冥独行录/
+        ├── 001 第1章.txt
+        └── 002 第2章.txt
+uploaded/                    # 已发布归档（自动按书名隔离）
+  ├── ai编程末日/
+  └── 青冥独行录/
+images/                      # 封面原图
+docx/                        # 大纲、策划文档
+```
+
+> **注意**：章节 txt 文件不要直接散放在 `chapters/` 根目录下，必须放在对应书名的子目录中。脚本会自动检测并提示。
+
+## 快速开始 🚀
+
+### 1. 安装依赖
+
+```bash
+# 安装核心依赖
+pip install playwright pillow
+
+# 下载 Playwright 需要的内置 Chromium 浏览器内核
+playwright install chromium
+```
+
+### 2. 扫码登录 (仅需一次)
+
+第一次使用前，必须先获取您的番茄平台登录状态（Cookie）：
+
+```bash
+python login.py
+```
+
+这会弹出一个浏览器界面。请在里面手动进行扫码登录番茄作家后台。
+登录成功后关闭浏览器，目录下会自动生成一个非常重要的隐私状态文件 `state.json`（已被忽略上传）。
+
+### 3. 全自动轰炸式发文
+
+在 `chapters/` 下按书名创建子目录，将对应的 txt 章节放入：
+
+```bash
+# 示例：为两本书分别准备章节
+mkdir chapters/我的第一本书
+mkdir chapters/我的第二本书
+# 然后把 txt 文件分别放进去
+```
+
+一键执行大魔王：
+
+```bash
+python publish.py
+```
+
+> **重要（组合安装 · O:\小说助手）**：当前 `publish.py` 采用 fail-closed 契约，
+> 必须由统一桥接层传入“已审查的来源计划”才会提交：
+>
+> ```powershell
+> & "O:\小说助手\.venv\Scripts\python.exe" .\integration\bridge.py publish --project "O:\你的小说项目" --book "番茄书名" --account "账号名"
+> ```
+>
+> 直接运行 `python publish.py` 只会被拒绝并提示需要 reviewed plan；这是为了避免绕过
+> 审查回执、账号绑定与平台发布证据。提交后结果不明的只读核对命令：
+>
+> ```powershell
+> & "O:\小说助手\.venv\Scripts\python.exe" .\integration\bridge.py reconcile --book "番茄书名" --account "账号名"
+> ```
+>
+> 下文的历史交互流程仅适用于独立上游安装（无 integration/bridge.py 时）。
+
+脚本会自动扫描并列出所有有待发章节的书籍：
+
+```
+检测到以下小说有待发章节：
+
+  [1] 我的第一本书  （5 章待发）
+  [2] 我的第二本书  （3 章待发）
+
+>>> 请输入序号选择要发布的小说：
+```
+
+输入序号后，脚本会进一步询问本次要发布的章节数量：
+
+```
+已选择：【我的第一本书】，共 5 章待发
+==================================================
+
+>>> 请输入本次要发布的章节数量（1-5），直接回车则发布全部：
+```
+
+- **直接按回车**：发布该小说所有待发章节
+- **输入数字**（如 `3`）：只发布排序最靠前的 3 章，剩余章节保留待下次发布
+
+这样就可以灵活控制每次的发布量，完美应对番茄平台的每日发布上限。输入完毕后就可以双手离开键盘，喝着咖啡欣赏它像一个没有感情的打字机般疯狂投递了。
+
+---
+
+## 交流与支持 💬
+
+如果在自动化发文途中遇到了平台规则更新或环境报错，亦或者想要交流 AI 写小说的最新干货技巧，欢迎加入我们的**专属讨论阵地**：
+👉 **[点击链接加入群聊【AI交流群】](https://qm.qq.com/q/YBb6naAOcM)**
+
+如果这个超神自动化工具真正帮您解放了双手，帮您顺利度过了新手期并拿到了全勤和首秀打赏，欢迎请作者喝一杯防猝死的冰美式！您的所有充电和支持，都是本脚本持续对抗番茄防线更新的最强核动力！☕️🔋
+
+<div align="center">
+  <img src="https://anta.obs.cn-south-1.myhuaweicloud.com/IMG_0897.JPG" width="250" height="auto" style="margin-right: 20px" alt="微信赞赏码">
+  <img src="https://anta.obs.cn-south-1.myhuaweicloud.com/IMG_0896.JPG" width="250" height="auto" alt="其它打赏码">
+</div>
+
+---
+
+**⚠️ 免责声明**：本脚本纯属技术交流与自动化接口研究。因平台规则随时可能更新，请时刻留意 UI 变动。不要用作恶意批量发布垃圾内容。

package/backend/fanqie_auto_publish/login.py

@@ -0,0 +1,42 @@
+import os
+from playwright.sync_api import sync_playwright
+
+STATE_FILE = "state.json"
+
+def login():
+    print("准备启动浏览器...")
+    with sync_playwright() as p:
+        # 打开 Chromium 浏览器，非无头模式（需要您看到界面扫码）
+        browser = p.chromium.launch(headless=False)
+        
+        if os.path.exists(STATE_FILE):
+            print(f"找到已有的 {STATE_FILE}，将加载现有登录状态尝试打开...")
+            context = browser.new_context(storage_state=STATE_FILE)
+        else:
+            context = browser.new_context()
+            
+        page = context.new_page()
+        
+        print("正在打开番茄小说作家后台...")
+        try:
+            page.goto("https://fanqienovel.com/main/writer/?enter_from=author_zone", timeout=60000)
+        except Exception as e:
+            print(f"打开网页遇到问题，请检查网络: {e}")
+            print("浏览器仍然保持打开，您可以手动在地址栏输入 https://fanqienovel.com/writer")
+        
+        print("\n" + "="*50)
+        print("请在弹出的浏览器窗口中登录您的账号（可以密码、验证码或扫码登录）。")
+        print("如果您已经登录完成，并且看到了作家后台首页，请回到这个黑框/终端里按【回车键】！")
+        print("="*50 + "\n")
+        
+        input(">>> 确认登录完成后，请按回车键以保存登录状态并退出：")
+        
+        # 保存 Cookies 和 Local Storage 等状态
+        context.storage_state(path=STATE_FILE)
+        print(f"\n登录状态已成功保存到当前目录下的 {STATE_FILE} 文件中！")
+        print("以后运行自动发布脚本时，会自动加载这个文件，无需再次手动登录。")
+        
+        browser.close()
+
+if __name__ == "__main__":
+    login()