通过 Agent 批量录入条目
此页面面向会使用 AI Agent(如 Claude)的贡献者:把原始资料交给 Agent,按下方提示词整理成 维基条目格式,再通过 API 批量上传。你只需要准备资料,格式化和上传由 Agent 完成。
1. 给 Agent 的提示词
复制下面的提示词,连同你的原始资料一起发给 Agent。
你是奇喵宇宙维基的资料整理员。请把用户提供的原始资料整理成维基条目,并输出 JSON。
## 要求
1. 每条资料生成一个条目对象,格式:
{"title": "条目标题", "content": "Markdown 正文", "summary": "一句话摘要", "author": "你的署名(可空)"}
2. content 使用 Markdown:
- 用 # 作一级标题(可省略,系统会自动加标题)
- 用 ## 分章节(如 ## 内容简介、## 角色介绍)
- 列表用 - 或 1.
- 表格用 | 列 | 列 |
- 需要信息栏时,输出 HTML(见下方模板),放正文开头
3. 信息栏模板(可选):
4. summary 一句话概括条目,供首页展示。
## 输出
只输出一个 JSON 数组,不要输出其他文字:
[
{"title": "...", "content": "...", "summary": "...", "author": "..."}
]
## 资料
[在此粘贴你的原始资料]
| 标题 | |
|---|---|
| 字段名 | 内容 |
2. API 地址
| 批量新建条目 | POST http://qimiaoyuzhou.wiki/api/pages/batch |
| 单个新建条目 | POST http://qimiaoyuzhou.wiki/api/pages |
| 获取现有条目 | GET http://qimiaoyuzhou.wiki/api/pages |
| 请求格式 | JSON,Content-Type: application/json |
批量接口请求体为条目数组;单条接口请求体为单个条目对象。
3. 获取上传密钥
批量上传词条与上传图片前,必须先申请一个一次性密钥。服务器会检查磁盘空间(加预估体积后剩余 > 5GB 才签发), 密钥 24 小时有效,上传总量不得超过预估体积 + 100MB,超配额自动作废。
申请密钥(提交预估体积,单位字节):
curl -X POST "http://qimiaoyuzhou.wiki/api/upload-key/request" \
-H "Content-Type: application/json" \
-d '{"estimatedBytes": 50000000}' # 预估 50MB
# 返回:{"key":"...32位密钥...","expiresAt":...,"quotaBytes":60000000}
批量上传时携带密钥(请求头 x-upload-key):
curl -X POST "http://qimiaoyuzhou.wiki/api/pages/batch" \
-H "Content-Type: application/json" \
-H "x-upload-key: 你的密钥" \
-d '[{"title":"测试条目","content":"## 简介\n这是正文。","summary":"一句话摘要","author":"站长"}]'
图片上传同样需带此请求头。
4. 使用方法
- 把原始资料和上方提示词一起发给 Agent。
- Agent 整理后输出一个 JSON 数组(每条含 title/content/summary/author)。
- 先申请上传密钥,再把 JSON 和密钥交给 Agent 或下方「快速测试」上传。
- 上传成功后刷新首页,新条目即出现。
5. 快速测试
先填预估体积申请密钥,再粘贴 Agent 输出的 JSON 数组上传(会真实创建条目)。