backlink-publisher

name	backlink-publisher
description	根据本地外链 JSON 队列或批次队列，把当前项目发布到免费外链、目录、startup listing、AI tools 和 gallery 平台。用于需要 Codex 使用 @chrome 操作用户已登录的 Chrome、读取项目资料夹、按单个 JSON 或 30 条左右的 batch JSON 逐组处理、通过 subagent 调用 $humanizer 生成自然文案、填写平台提交表单、直接提交免费 listing 并更新队列状态的任务。

外链发布器

概览

从单个 JSON 队列读取外链平台任务，把当前项目提交到免费外链平台。执行时使用 Chrome 插件操作浏览器，用本地项目资料夹作为事实来源，任何需要生成的 listing 文案都必须交给 fresh subagent 处理。

当候选外链很多时，优先使用批次 JSON 逐组运行。推荐每个 batch 控制在 30 条左右，并把可执行 batch 放在 data/backlinks/batches/，例如 data/backlinks/batches/batch-001.json。默认通过 data/backlinks/foreign-backlinks-batches-manifest.json 选择要运行的 batch；manifest 只用于记录批次顺序和数量，不是队列文件，不能直接传给发布流程。

必需输入

• 批次 manifest。默认路径：data/backlinks/foreign-backlinks-batches-manifest.json，用于选择要运行的 batch；实际运行时必须读取其中某一个 batch JSON。
• 外链队列 JSON。默认使用 manifest 指向的批次 JSON，例如 data/backlinks/batches/batch-001.json。旧单文件队列 data/backlinks/free-backlinks.json 只作为兼容入口：只有用户明确指定，或没有可用 manifest 时才使用。
• 项目资料夹，里面必须有 profile.md 和 metadata.json，格式兼容 project-profile-capture 的输出。
• 公开提交信息文件。默认路径：public-submission-info.md，用于保存允许公开使用的邮箱、联系人姓名、公司所在地、成立时间等信息。
• Chrome 中已经登录用户的 Google 账号。
• 团队人数默认为 1，除非用户明确指定

如果当前项目里有多个项目资料夹，并且用户没有指定目标项目，先询问用户使用哪一个。如果没有可用项目资料夹，停止并让用户先用 project-profile-capture 创建。

如果 public-submission-info.md 不存在，先创建模板并询问用户补充公开提交信息。如果文件存在但必填字段为空，第一时间询问用户补齐后再开始处理外链队列。不要从 Chrome、Google 账号或项目文案里推断私人联系信息。

参考文件

• 修改或更新队列前，先读 references/backlinks-json-schema.md。
• 使用 Chrome 或提交 listing 前，先读 references/chrome-workflow.md。
• 请求生成文案前，先读 references/content-subagent-prompt.md。
• 判断错误后是否继续前，先读 references/failure-policy.md。

工作流程

1. 确定本轮队列 JSON：
   • 如果用户指定了具体 JSON 文件，使用该文件。
   • 不要把 batch-*-submitted.json 当作执行队列；这类文件只是已提交结果导出。
   • 如果用户只指定 manifest，或没有指定 JSON 但默认 manifest 存在，先读取 manifest。用户指定了 batch 编号时使用对应 batch；没有指定时，按 manifest 顺序打开 batches[].file，选择第一个实际包含 status: "pending" 队列项的 batch，并在开始前报告 batch 编号和待处理条目数。不要只依赖 manifest 里的 status 字段。
   • 如果没有可用 manifest，再回退到 data/backlinks/free-backlinks.json。
   • 不要把 manifest 当作外链队列传给发布流程。
2. 校验本轮外链 JSON：

python3 skills/backlink-publisher/scripts/validate_backlinks_json.py <queue-json-path>

3. 读取并检查 public-submission-info.md。缺少必填公开信息时，先询问用户补齐：
   • 联系邮箱
   • 联系人姓名
   • 公司所在地
   • 成立时间
4. 读取所选项目资料夹中的 profile.md 和 metadata.json。
5. 默认只处理当前队列 JSON 内 status: "pending" 的队列项，除非用户明确要求重试其他状态。
6. 每处理一个队列项，先把该项状态设为 in_progress。
7. 所有浏览器操作都使用 @chrome。不要改用其他浏览器后端。
8. 打开平台 URL，寻找 submit、add、list、post、suggest 或类似入口。
9. 如果平台出现 Google 账号选择器，默认选择第一个可见的个人 Google 账号继续。如果无法判断是否为个人账号、要求额外敏感权限或没有 Google 登录选项，按失败处理规则更新当前队列项，然后停止本轮任务让用户接手。
10. 如果表单需要生成文案，按 references/content-subagent-prompt.md 启动 fresh subagent。
11. 使用项目资料、公开提交信息、生成文案、项目 URL、logo 和截图填写表单；能从资料中确定的必填和可选字段都尽可能帮用户填完整，不要只填最低必填字段。
12. 如果表单出现验证码或机器人验证，不要立刻停止。先把项目资料和公开提交信息能够确定的所有必填、可选字段全部填好；需要图片时默认上传当前项目资料夹中的 screenshot.png，只有平台明确要求 logo 时才改用 logo.png。然后按用户授权尽可能完成验证。验证码不可读、无法自动完成、需要外部设备/账号确认或需要用户人工判断时，才设为 needs_user，保留已经填好的表单标签页，让用户只需完成验证并提交。
13. 免费 listing 表单的必填字段填完后直接提交。用户明确补充授权：“下次你填写完毕内容就自己提交”；因此不要在字段已填完、且没有新的 CAPTCHA / 付费 / 权限 / 私密信息等停止条件时停下来等用户点击最终提交。
14. 页面出现成功状态、成功提示或可用 listing URL 后，把该项标记为 submitted，并把 result_url 设为 listing URL 或当前页面 URL。
15. 如果当前平台不符合项目要求，例如只收 boilerplate、template、deal、特定集成或其他与当前项目事实不匹配的 listing，把该项标记为 skipped，写入 last_attempt_at 和简短 error，然后继续处理当前 batch 的下一个 pending 队列项。
16. 如果当前平台无法继续提交且需要用户接手或属于真正失败，把该项标记为 needs_user 或 failed，把原因写入 error。只有 needs_user 或 failed 触发停止；如果页面可由用户接手，保留当前 Chrome 标签页。
17. 只有当前 batch 没有触发停止条件且全部处理完后，才报告本批提交、跳过、失败和需要用户处理的数量；除非用户明确要求继续，不要自动进入下一个 batch。

状态更新规则

更新 JSON 队列时：

• 保持队列项顺序不变。
• 保留未来可能新增的未知字段。
• 除非用户要求批量更新，只修改当前正在处理的队列项。
• 如果本轮输入是 batch JSON，状态写回该 batch 文件；不要把状态写回完整候选池或正式队列，除非用户明确指定。
• manifest 只作为批次索引；如果本轮是通过 manifest 选中的 batch，处理结束后同步对应 batch 的 item_count、first_id、last_id 和 status。没有 pending / in_progress 项时，把 manifest 中该 batch 标记为 processed；仍有待处理项时保持或设为 pending。
• last_attempt_at 使用 ISO 8601 时间戳。
• 提交成功时保持 error: null。
• 如果平台定位、分类或硬性要求与当前项目事实不匹配，设为 status: "skipped"，写入 last_attempt_at 和简短 error，然后继续当前 batch 的下一个 pending 项。
• 运行中把当前项设为 skipped 后，不要停止本轮任务；继续处理当前 batch 的下一个 pending 项。
• 只有验证码无法代填或需要用户人工处理时，才把当前项设为 needs_user；设置前必须先填完所有可由项目资料和公开提交信息确定的字段，并默认上传当前项目的 screenshot.png。如果验证码已完成，继续提交当前表单。

停止规则

如果页面要求付费、浏览器权限、私密个人信息、用户未授权的非 Google 登录，或任何超出免费公开项目 listing 提交范围的动作，立即停止本轮任务并报告给用户。通过 Google 登录或继续创建免费 listing 账号是允许的，但只能使用第一个可见的个人 Google 账号，且不能授权敏感权限。

验证码不是默认停止条件。遇到 CAPTCHA、验证码或机器人验证时，先填完所有可确定的表单字段并默认上传项目 screenshot.png，再尽可能帮用户完成验证；只有无法自动完成、不可读、需要外部设备/账号确认或需要用户人工判断时，才停止并设为 needs_user。保留的页面必须处于“用户只需完成验证码/人机验证并提交”的状态，不能留下仍可由项目资料补齐的空字段。

平台不符合当前项目要求但不需要用户接手时，设为 skipped，写入 last_attempt_at 和简短 error，然后继续当前 batch 的下一个 pending 项。

停止时必须更新当前队列项：用户可以在 Chrome 中解决或继续流程的，设为 needs_user；平台明显不可提交且不是项目不匹配跳过场景的，设为 failed。两种状态都要写入 last_attempt_at 和简短 error。如果页面可由用户接手，保留当前 Chrome 标签页，不要清理或继续下一个 pending 项，直到用户明确要求继续、跳过或已处理。