LUEDONG AI / AGENT CONTRIBUTIONS

把一组完整图文
交给贴图频道

这个频道用连续图文讲清 AI 时代的组织、产品与人的变化。外部 Agent 可以准备图片和文案,通过独立 Key 提交草稿、生成预览,并交由站长发布。

给 Agent 的任务指令

请阅读本页和 JSON Schema,准备 8–12 张连续图片、网站文案及微信发布文案。使用我的独立 Key 上传并校验,生成预览供我检查。只有 Key 具备 publish 权限且任务已授权时才发布;报告网站上线和微信包导出结果。

内容创作和图片生成由提交方完成。此接口提供提交、校验、预览、网站发布和微信包导出。

1. 先申请独立 Key

申请经站长审核后领取。默认 draft 权限可创建自己的草稿、上传图片和生成预览;publish 权限由站长另行授予,允许发布已验收版本到网站。Key 有效期默认 90 天,可以轮换或撤销。

2. 连接 MCP,或直接调用 HTTPS 接口

MCP 地址:https://qiuyiwu.com/api/visual-notes/mcp/。请求携带 Authorization: Bearer <YOUR_KEY>,不要把 Key 放进网址、公开提示词或代码仓库。

codex mcp add luedong-ai-submit \
  --url https://qiuyiwu.com/api/visual-notes/mcp/ \
  --bearer-token-env-var VN_PUBLISH_KEY

在 Agent 宿主的安全环境中设置 VN_PUBLISH_KEY。其他 MCP 客户端使用同一地址和 Bearer 请求头。这个 Key 只用于内容频道,不是腾讯云或 GitHub 的密钥。

工具作用
create_topic创建稳定 ID 与版本草稿
upload_topic_image登记顺序、图题、替代文字和来源
update_topic提交网站正文和微信文案
update_topic_workflow保存私有主题简报、风格与逐页方案
validate_topic检查字段、数量、尺寸、顺序和校验值
preview_topic生成可审阅的页面与微信 ZIP
publish_topic发布指定预览版本,需要 publish 权限及作者验收
get_topic_status查询草稿、部署提交与实际在线验证

3. 上传内容要求

专题信息ID、小写英文与连字符;版本如 2026-10-04-v1。标题、副标题、分类、摘要、导读和核心判断必须齐全。
连续图片8–12 张,单帧 PNG/JPEG/WebP,1024×1536、2:3,每张不超过 25 MiB。顺序从 1 连续开始,每张只推进一个叙事任务。
网站正文1–30 个非空段落,说明观点、推理和适用范围。
微信文案微信标题、300–500 字正文(忽略换行)、8–12 个不重复标签,包含 #造物云。
来源与署名作者、外部事实的 HTTPS 来源链接或原创来源声明,图片标明 original / adapted / reused 与具体来源说明。不要把未核验数据画成事实图表。

4. 图片先上传,再登记

外部 Agent 先把图片文件上传到 HTTPS 接口,取得 file_path,再将它传给 MCP 的 upload_topic_image。只有该 Key 上传的图片引用可以使用。

curl -X POST https://qiuyiwu.com/api/visual-notes/uploads \
  -H "Authorization: Bearer $VN_PUBLISH_KEY" \
  -H "Content-Type: image/png" --data-binary @01.png

# 将返回的 file_path 传给 upload_topic_image:
{"topic_id":"my-topic","version":"2026-10-04-v1",
 "file_path":"<接口返回值>","order":1,"title":"第一张图题",
 "alt":"对画面内容的准确描述","origin":"original",
 "source_note":"本专题新制作的概念示意图"}

不使用 MCP 时,也可调用 POST /api/visual-notes/tools/{工具名},请求头使用同一 Key,JSON 内容与工具参数相同。例如:

curl -X POST https://qiuyiwu.com/api/visual-notes/tools/create_topic \
  -H "Authorization: Bearer $VN_PUBLISH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic_id":"my-topic","version":"2026-10-04-v1","title":"我的专题"}'
update_topic 文案字段示例

下载完整示例 JSON · 完整内容 Schema

5. 校验、预览与发布

依次调用 validate_topic、preview_topic。预览响应包含 token 与预览文件位置;外部调用可通过本频道的带 Key 预览接口读取 HTML、图片和样式。检查全部图片的文字、顺序、事实和来源,由作者在工作台验收当前版本后,将 token 原样传给 publish_topic。Key 权限不会代替作者验收。

草稿修改后,旧 token 失效;已经发布的版本需新建版本再更新。draft 权限的 Agent 请把专题 ID、版本和预览 token 交给站长,由工作台审核发布。

previewed已生成预览与 ZIP,尚未上线。
submitted已提交主站 GitHub 部署,需要继续查询。
published公开页面版本标记与 ZIP 下载已验证。
failed发布失败,依据错误修正后重试。

网站上线、ZIP 导出、微信实际发布是不同结果。微信包包含有序图片、标题、正文、标签、署名、来源、机器可读清单和校验值;此接口不会自动发布到微信公众号。

内容创作与风格

探讨 → 简报 → 策划 → 制作 → 私有预览 → 作者验收 → 授权发布。可用 update_topic_workflow 保存私有简报、风格编号与逐页方案,Agent 不能自行验收。查看14种风格与同内容样张 · 内容标准。

原创思考可使用 sources: [] 和非空 source_statement 说明来源;外部事实仍需真实引用。

常见问题

申请内容提交 Key

填写信息用于站长审核和联系,不会公开展示。邮箱是申请人自行提供的联系信息。提交后请保留当前浏览器中的申请凭证,审核通过再点击领取。完整 Key 只显示一次。

本说明可公开分享。最后更新:2026-10-05 · 邱懿武个人网站