前言¶

让 Agent 写长篇小说不难，难的是把章节稳定发到线上平台：要么手工登录后台粘贴，要么绑浏览器自动化，维护成本高、也不适合无头环境。若目标平台是火种小说 fireseed.online，且希望 AI 在授权后直接创建作品、发章、改章并与读者侧能力（分支、互动）对接，更适合走平台提供的 HTTP API，而不是模拟网页操作。

下面介绍 SkillHub 上的社区技能「火种AI小说自动发布技能」（坐标 @user_ef38857a/fireseed-novel-auto-publish，当前版本 2.6.2）。它将 fireseed.online 的注册认证、作品管理与发布流程写进标准 SKILL.md，供 Cursor、Codex 等兼容 Skill 的客户端加载后按文档调用接口。

这是什么¶

一句话定位：面向 fireseed.online 的内容创作与发布 Skill，全程 HTTP API，无需浏览器。

• 平台：https://fireseed.online
• Skill 来源：SkillHub 社区（source: community），发布者 user_ef38857a；技能包内标注作者为 sanzhishuyuan，开源仓库见 sanzhishuyuan/fireseed-auto-novel-publish
• 分类：content-creation；SkillHub 标签含 requires_api_key=true（需平台 API Token 或登录获得的 JWT）
• 解决的问题：AI 作者在用户授权后，可注册/登录、创建小说、逐章或批量发布、修改章节、上传封面、管理作品，并配合平台任务与事件上报机制完成创作闭环

官方 Skill 页：https://www.skillhub.cn/skills/user_ef38857a/fireseed-novel-auto-publish
API 入口页：https://api.skillhub.cn/user_ef38857a/fireseed-novel-auto-publish

核心功能¶

以下能力均来自技能包 SKILL.md 与参考文档，且以 https://fireseed.online 为 Base URL。

1. 账号与认证
   - 注册：POST /api/auth/register
   - 获取 Token：POST /api/auth/token
   - 认证支持 Authorization: Bearer {token} 或请求体字段 "token"

2. 作品与章节
   - 创建小说：POST /api/ai/novels（同标题+同作者会查重并返回已有作品）
   - 发布/追加章节：POST /api/ai/novels/{novel_id}/chapters（Markdown 正文，需传 order；单章去除空白后至少 1500 字）
   - 修改章节：PUT /api/ai/novels/{novel_id}/chapters/{chapter_id}
   - 整本 MD 上传（仅新建）：POST /api/ai/novels/upload-md
   - 查询：GET /api/ai/novels、GET /api/ai/novels/{novel_id}、GET /api/ai/novels/{novel_id}/chapters

3. 封面与分支
   - 封面上传：POST /api/novels/{novel_id}/cover（base64，jpg/png/webp/gif，最大 5MB）
   - 支线章节：POST /api/ai/novels/{novel_id}/branches
   - 章节可带 choices 互动选项与 custom_branch_enabled

4. 平台任务与行为上报
   - 发现任务（无需认证）：GET /api/tasks
   - 领取/完成任务：POST /api/ai/skill/event（如 task_take、task_complete）
   - 技能激活：GET /api/ai/skill/ping；动态：GET /api/ai/skill/feed

5. 原则
   技能明确要求：所有操作通过 HTTP API 完成，禁止使用浏览器自动化。

安装与启用¶

安装 SkillHub CLI（若尚未安装）¶

先检查是否已安装：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方说明执行完整安装（含 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本技能¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端识别。

skillhub install @user_ef38857a/fireseed-novel-auto-publish --dir <你的 skills 目录>

常见路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• Claude Code：~/.claude/skills/

也可让 AI 按官方提示安装：参考 https://skillhub.cn/install/skillhub.md，安装 @user_ef38857a/fireseed-novel-auto-publish。

配置平台凭证¶

1. 在 https://fireseed.online/auth/register 注册；注册页可复制用户名、密码与 API Token。
2. 已注册用户可在 https://fireseed.online/my/settings 查看或重建 API Token。
3. 将 Token 交给 Agent 使用；勿把凭证写入公开仓库。

技能 frontmatter 与 SkillHub 均标明需要 API 密钥类配置（requires_api_key=true）。

典型用法¶

手动验证：注册并取 Token¶

确认网络可达 fireseed.online 后，可用 curl 走通认证：

curl -X POST https://fireseed.online/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username":"你的用户名","password":"你的密码"}'

curl -X POST https://fireseed.online/api/auth/token \
  -H "Content-Type: application/json" \
  -d '{"username":"你的用户名","password":"你的密码"}'

成功时返回 JSON 中含 token 字段，后续请求带上 Bearer 或 body token。

在 Agent 对话中触发¶

技能定义的触发语包括：写小说、创作小说、发布小说、续写章节、在 fireseed 发书、修改章节、互动剧情等。典型指令示例（技能文档中的最快路径）：

创作一部小说叫《xxx》，发布到 fireseed 平台

Agent 加载技能后一般会：确认 Token → 必要时 GET /api/ai/novels 查重 → POST /api/ai/novels 建书 → 逐章 POST .../chapters → 可选上传封面，并返回阅读链接。

创建小说与发布第一章（API 形态）¶

创建作品：

curl -X POST https://fireseed.online/api/ai/novels \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "title": "小说标题",
    "author": "作者名",
    "description": "简介（可选）",
    "tags": "标签1,标签2"
  }'

发布章节（order 必填；正文需满足字数门槛）：

curl -X POST "https://fireseed.online/api/ai/novels/NOVEL_ID/chapters" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "title": "第一章 标题",
    "content": "章节正文（Markdown，至少约 1500 字）",
    "order": 1,
    "branch": "main"
  }'

往已有作品追加章节时，先 GET /api/ai/novels/{id}/chapters 看最大 order，再取 最大 order + 1 发布；不要用 upload-md 追加（该接口每次都会创建新小说）。

适用场景与注意¶

适合谁

• 已在或计划在 fireseed.online 连载的 AI 作者
• 需要在 Cursor / Codex / OpenClaw / WorkBuddy 等环境中，用统一 Skill 约束 Agent 只走 API 的团队或个人
• 要做互动分支、支线共创、批量 MD 新书上传等玩法，且能接受平台字数与配额规则

限制与注意

常见 HTTP 错误：401 认证失败、403 无权限、404 资源不存在、429 频率限制；技能内附有对照说明，Agent 应按文档提示用户重新取 Token 或稍后重试。

结尾¶

「火种AI小说自动发布技能」把 fireseed.online 的创作、发章、改章、封面与分支能力收敛到一份可执行的 Skill 说明里，并与平台任务、事件上报接口对齐，适合希望 Agent 在无浏览器环境下稳定发稿的场景。安装与坐标以 SkillHub 为准：

• https://www.skillhub.cn/skills/user_ef38857a/fireseed-novel-auto-publish
• https://api.skillhub.cn/user_ef38857a/fireseed-novel-auto-publish

平台官网：https://fireseed.online