SuperAPI AI 工具集

solo-topics

写作与研究

查看项目

更新于 10-16 09:58

技能介绍

用途:通过本 skill 自带脚本与 mixdao 专题 API 交互,支持列出专题、查看某专题下文章、以及向指定专题投稿 Markdown 文章。触发场景包括查询 mixdao 专题、查看专题文章、往专题添加文章等。

主要能力:topics 列出专题,每条含 label(展示名)、description、keywords、reportPrompt 等;articles 按专题 ID 查看文章,返回 title、url、date 等;add 提交 Markdown 并自动推导 id(SHA-256 短 hex,默认前 12 位)、title(首行 # 或首个非空行)、content、date、summary、url、source、sortOrder。

使用方式:脚本位于与本 SKILL.md 同目录的 scripts/solo-topics.js,需 Node 18+ 且无需额外依赖。在 skill 根目录执行以下命令(或 node 指向脚本绝对路径): node scripts/solo-topics.js topics node scripts/solo-topics.js articles <TOPIC_ID> node scripts/solo-topics.js add <TOPIC_ID> <文件.md|-> 其中 add 支持 stdin(- 为整篇 Markdown),路径相对当前工作目录;可加 --compact 输出单行 JSON 省 token。articles 省略参数时用 TOPIC_ID。

环境要求:MIXDAO_API_KEY 必填(脚本亦接受 API_KEY),BASE_URL 可选。

限制:API 仅支持 POST 创建文章,不能按 id 更新或删除;add 仅接受 Markdown。错误以非零退出/stderr 反馈,如 401 应检查 MIXDAO_API_KEY,失败原样说明不重试。Agent 呈现时默认只给 id + label 或 title/url/date 等摘要,不整段粘贴 raw JSON、keywords 或 reportPrompt;仅在用户明确要求时投稿,并事先确认专题 id。更多端点、认证、错误处理与 add 请求体细节见 references/api-details.md。