让你的 Agent 把收藏整理成天工玩法

这个玩法做什么

把自己喜欢的本地模型项目、部署记录和操作笔记交给 Agent，让它整理为网页文章，再提交到天工。Agent 可以通过 HTTP API 保存草稿、修改内容、发布，并查询发布结果。

开始前

准备天工的内容管理令牌。它与模型服务的 API Key 是两套凭据：内容令牌用于管理网站，模型 Key 仅供后端整理和翻译。不要把它们放进文章正文或公开仓库。

最省事的方式

把下面这段需求交给你的 Agent，并通过本地凭据文件向它提供内容管理令牌：

读取 https://spark.tlec.top/agent.md。我会发给你喜欢的链接和笔记，请保留出处，提取用途、工具、硬件要求和实际操作步骤，先保存为天工的玩法草稿。缺少依据的信息留空，只有我确认亲测的内容才标注亲测。得到发布授权后再发布，查询任务成功并打开网页验证。

Agent 读取原始链接并提供正文后，网站才能据此整理。只提交一个链接时，网站会保存到收件箱，等待补充原文。

自己在后台投递

打开 内容管理，输入内容管理令牌。在“投递收藏”中粘贴来源链接和原文或笔记，选择栏目后保存。配置文本模型且正文足够时，后台会生成中英文草稿，供你审核。

需要自己写内容时，可在“撰写内容”中填写标题、英文网址名称和 Markdown 正文。可以先保存草稿，再决定发布；只写中文也能发布。

Agent 调用顺序

1. 用 POST /api/v1/submissions 保存原始收藏；已整理好的文章用 POST /api/v1/content。
2. 用 GET /api/v1/content/{id} 读取条目。修改时提供 expectedRevision，避免覆盖其他编辑。
3. 用 POST /api/v1/content/{id}/publish 提交发布任务。
4. 轮询 GET /api/v1/jobs/{jobId}。只有状态为 succeeded 才算完成，再访问返回的网址检查页面。

发布会重新生成静态页面和搜索索引，然后切换到新版本。构建失败时保留此前的线上版本。

自动收集怎么用

定时任务每天 08:00（Asia/Taipei）收集已配置的 GitHub Releases、RSS 和 Hacker News 来源，按原始链接去重。原文不足时保留为候选；有足够正文时可整理为中英草稿。外部自动收集的内容需要审核后发布。

资讯与玩法分开整理：工具更新可以作为资讯；有真实操作步骤的内容，再整理成玩法。不要仅根据新闻标题生成没有依据的安装命令。

完整请求格式见 Agent 接入说明 和 接口规范。