IMA知识号自动运营系统

要解决的具体问题

运营 IMA 知识号（type=1004 的公开订阅知识库）时，最消耗精力的不是写单篇文章，而是持续日更：选题、写作、再逐篇手动发布。本技能把这条链路拆开自动化，你只需要决定「写什么方向」，后续的生成与发布交给脚本完成。

技能如何工作

核心能力

• 选题池驱动：topics.json 定义主题、分类与 prompt，系统按顺序轮转，每天处理一个选题。
• AI 生成文章：调用 Agnes 接口产出 Markdown，遇到 429 限流会按 10 × (attempt+1) 秒退避，最多重试 3 次；也可替换为任意 OpenAI 兼容接口。
• 分类路由：autopost.py 中的 KB_MAP 把文章分类映射到目标知识号（kb_id），未知分类兜底到第一条配置。
• 状态管理：state.json 记录发布进度，实现断点续发、跳过当天与防止重复；一轮选题发完后自动回到起点。

关键步骤

1. 发现知识号并记录每个知识库的 kb_id，为后续路由做准备。
2. 可选地优化知识号标题与简介，明确定位。
3. 设计选题池，例如按业务拆成企业微信、效率工具等分类，并为每个选题编写结构化 prompt。
4. 通过 enable_autopost.sh 校验文件、写入 cron（默认每天 10:00）、启动进程并检查状态。
5. 发布时先调用 openapi/note/v1/import_doc 创建笔记，再调用 openapi/wiki/v1/add_knowledge 将笔记加入对应知识库。

适用边界与注意点

• 凭证建议使用平台环境变量 $IMA_OPENAPI_CLIENTID 与 $IMA_OPENAPI_APIKEY；Agnes 密钥同样通过 AGNES_API_KEY 注入，避免写进仓库。
• 若知识号数量超过 10 个，列表查询需要翻页，否则可能漏掉 kb_id。
• 新增分类时要同步更新 KB_MAP，否则文章会落到兜底知识号。
• 沙箱重置会清掉 cron 配置，需要重新执行恢复脚本；/sandbox/workspace/ 下的数据文件仍保留。
• 默认方案依赖定时任务所在的运行环境，长期运行仍需关注脚本自身与上游 API 的稳定性。