番茄小说自动发布

番茄小说章节自动发布工具。使用场景：(1) 发布单个章节到番茄小说平台；(2) 批量发布多个章节；(3) 存入草稿箱；(4) 登录番茄小说作家后台；(5) 查看作品列表和状态。触发词：番茄发布、番茄小说上传、发布章节、存入草稿箱、番茄登录。

Security Scan

代码、依赖和运行说明与“番茄小说章节自动发布”这一功能一致；没有要求与其用途不符的凭据或可疑外部下载，但会在本地保存浏览器 Cookie 并需要安装 Playwright（下载浏览器二进制）。

Purpose & Capability

名称/描述与实际实现一致：脚本使用 Playwright 自动化浏览器、解析 Markdown 章节文件、填表并发布/存为草稿。所需依赖（playwright、浏览器 cookie 工具）与功能对等，没有请求与发布无关的云凭据或外部服务密钥。

Instruction Scope

SKILL.md 的运行指令（pip install -r requirements.txt、playwright install、运行 main.py 的子命令）与代码匹配。运行时会读取本地 .md/.json 章节文件、写入/读取 cookie 文件、截屏并与目标站点 fanqienovel.com 交互；没有指示去读取或发送与功能无关的系统配置或外部端点。

Install Mechanism

这是指令型技能（无额外 install spec），但要求 pip install Playwright 并运行 `playwright install`，这会下载浏览器二进制（正常且必要）。依赖来自 PyPI（可追溯），未见不明 URL 下载或可疑提取操作，风险为常见的第三方包安装风险。

Credentials

不要求环境变量或外部凭据；唯一的持久凭据是本地保存的 cookie 文件（fanqie_cookies.json），这与自动登录/会话保持的目的相符。脚本会访问文件系统（章节文件、cookie、截图），并使用本地剪贴板工具（pbcopy/clip/xclip/xsel），这些都是为实现自动粘贴和文件输入所必需。

Persistence & Privilege

技能不会设置 always:true，也不会修改其它技能或系统范围配置。但会在磁盘上保存会话 cookie（fanqie_cookies.json），这会长期保留能代表用户会话的令牌——这是实现自动登录的正常做法，但也带来本地敏感性。

Assessment

要点与建议： - 该技能实现与描述一致：它通过 Playwright 自动打开浏览器、要求你扫码登录，并在本地保存 cookie 以便后续自动化发布。若你接受这一行为，按 SKILL.md 安装并运行即可。 - 注意 cookie 文件（fanqie_cookies.json）包含会话信息，应妥善保管或在不再使用时删除（logout/clear）。不要在共享或不受信任的机器上保存有效 cookie。若担心安全，使用临时/备用作者账号进行测试。 - 安装 Playwright 会下载浏览器二进制，占用空间并需要网络访问；在受限环境或企业机器上提前确认可接受性。依赖来自 PyPI，审计依赖版本或从可信源安装。 - 代码会调用系统剪贴板命令（pbcopy/clip/xclip/xsel）并使用 subprocess；这在功能上合理但请在受信任环境运行。若你的系统缺少这些工具，脚本会提示安装或回退到直接填充。 - 有轻微代码问题（例如 clipboard 函数末尾有残留/截断的语句，可能在某平台上导致异常）；建议在生产使用前在本地用几章样本和测试账号完全跑通一遍。 - 如果你需要更高安全性：审阅或改造代码以加密 cookie、将 cookie 存放在受限目录，或只用一次性登录并在用后立即清除 cookie。

自动化发布小说章节到番茄小说作家后台。

快速开始

cd /path/to/fanqie-publisher-skill/scripts
pip install -r requirements.txt
playwright install

常用命令

# 登录（扫码）
python main.py login

# 查看作品列表
python main.py works

# 检查登录状态
python main.py status

# 交互式发布
python main.py publish

发布模式

支持两种发布模式：

模式	说明	适用场景
publish	直接发布章节	确认内容无误，直接发布
draft	存入草稿箱	内容待完善，先保存草稿

发布章节

从文件发布单个章节

from publisher import publish_from_file

# 直接发布
result = publish_from_file(
    work_title="灵契觉醒",
    file_path="/path/to/第36章_标题.md"
)

# 存入草稿箱
result = publish_from_file(
    work_title="灵契觉醒",
    file_path="/path/to/第36章_标题.md",
    mode="draft"
)

批量发布

from publisher import publish_batch

chapters = [
    {"title": "第38章 遗迹守护者", "content": "正文内容..."},
    {"title": "第39章 暗影的动向", "content": "正文内容..."},
]

# 直接发布
results = publish_batch("灵契觉醒", chapters, interval=5)

# 存入草稿箱
results = publish_batch("灵契觉醒", chapters, interval=5, mode="draft")

章节文件格式

支持两种模板格式，系统自动检测：

模板A - 详细版（带元数据）

适用于需要记录创作规划的场景：

# 第36章 标题

> **本章概要**：...
> **本章爽点**：...

---

正文内容...

---

> **章末钩子**：...

自动处理：

• 元数据块（开头 > 引用）→ 自动去除
• 章末钩子（结尾 > 引用）→ 自动去除
• 章节号前导零 → 自动去掉（"第05章" → "第5章")

模板B - 简洁版（纯正文）

适用于简洁风格的章节文件：

# 第一章 重生

正文内容...

特点：

• 只有标题和正文
• 无分隔符、无元数据块
• 支持"第一章"、"第1章"等格式

发布流程

直接发布模式 (publish)

1. 进入创建章节页面
2. 关闭引导弹窗
3. 填写章节号、标题、正文
4. 点击下一步
5. 处理弹窗（错别字检测 → 风险检测 → AI选项 → 确认发布）
6. 等待审核

草稿箱模式 (draft)

1. 进入创建章节页面
2. 关闭引导弹窗
3. 填写章节号、标题、正文
4. 点击右上角"存入草稿箱"
5. 确认保存
6. 章节保存到草稿箱

注意事项

• 正文至少 1000 字
• Cookie 有效期约 24 小时
• 批量发布建议间隔 5 秒
• 审核约 1 小时完成
• 草稿箱保存的章节可随时编辑发布