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

- URL: https://spark.tlec.top/plays/agent-content-publishing/
- Date: 2026-10-31
- category: agent
- difficulty: beginner
- source: https://spark.tlec.top/agent.md
- tools: HTTP API, Agent
- tags: Agent, 内容管理, 自动化

> 从链接和部署笔记开始，通过内容接口保存草稿、审核、发布，并自动更新网页和搜索。

## 这个玩法做什么

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

## 开始前

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

## 最省事的方式

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

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

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

## 自己在后台投递

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

需要自己写内容时，可在“撰写内容”中填写标题、英文网址名称和 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 接入说明](/agent.md) 和 [接口规范](/api/openapi.json)。