2Ryun 知识底座
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1d3db2ec/2ryun-skill 并阅读其 SKILL.md 后按说明使用。
技能介绍
为 AI Agent 搭建知识工作流时,最常见的坑是把「临时想法」和「值得沉淀的知识」混在一起:所有文档一律写入知识库,结果 AI 每次检索都撞上大量派生内容,既浪费 token,也让知识图谱变得嘈杂。2Ryun 把这个问题拆成了两个清晰的容器——文档(Document) 与笔记(Note),并通过 wikiAutoExtract 开关让创建者明确决定一篇文档是否值得进入知识库。
核心机制:入库决策下沉到创建那一刻
2Ryun 的提取与组织是完全异步后台执行的,Agent 不需要手动调用提取接口。文档创建后,1–3 分钟内后台自动完成提取、去重与关联;如果创建后立刻搜索,大概率查不到刚入库的内容——这一点在对接时必须提前告知用户(「稍等片刻再查」)。文档创建接口的 PUT /restapi/documents/update/:id 和 DELETE /restapi/documents/delete/:id 也保持了同样的 REST 风格:资源即增删改查。
判断一篇文档是否入库,核心原则只有一条:它包含新知识,还是已有知识的重组。
- 适合入库(
wikiAutoExtract: true):用户原创文档、笔记、研究;导入的参考资料、报告、论文;包含个人观点、数据、经验的任何新信息 - 不适合入库(
wikiAutoExtract: false或不设置):基于知识库检索生成的报告与总结;AI 草稿、临时内容;待整理的会议记录
衍生内容再次入库不仅重复,还会在后续检索中稀释相关性——这条规则值得写进你的 Agent prompt 里。
四大能力如何覆盖日常工作流
- 文档管理底座:支持文本创建与文件导入(pdf、docx、xlsx、pptx、md、txt、html),统一走 REST API,
Authorization: Bearer鉴权,Key 形如sk-前缀加随机串。文档树靠rootId与parentId约束:根文档两个字段设为同一 ID,子文档分别指向根与直接父节点 - 结构化知识库:入库后自动构建,Agent 直接语义搜索(按相关度排序)或查看知识图谱与状态;
POST /restapi/wiki/extract等手动接口仅在明确需要时调用 - 可视化发布:单篇文档先从模板接口拿列表再按内容匹配(长文→article-magazine、技术文档→documentation,不要硬编码模板),生成后发布获得
https://www.2ryun.com/restapi/gen-html/public/GEN_ID形式的公开链接;也可从文档树直接搭建多页面站点(https://www.2ryun.com/s/SITE_ID),或聊天式编辑已有网页的局部区域 - 轻量级笔记:笔记天生不提取、不入库,接口与文档独立,适合灵感备忘一类临时记录
容易踩的坑
积分与重试策略是写 Agent 代码时绕不开的:402 配额不足要引导用户去 /pricing 升级,绝不重试;401/403 提示检查 Key,不重试;429 等 Retry-After 秒;500 等 3 秒重试一次仍失败则告知用户。整体上出错重试不超过一次。
另两个细节:查询参数含中文必须 URL 编码(curl 用 --data-urlencode,JavaScript 用 encodeURIComponent);基于知识库生成的报告属于衍生内容,即使通过「知识搜索 + 生成网页报告」流程产出,也应视为新文档且不设 wikiAutoExtract: true。
一句话总结:这个技能的价值不在于功能堆叠,而在于它把「什么值得进知识库」的决策明确下沉给了创建文档的人——Agent 只需诚实地设置开关,剩下的提取、去重、关联、图谱都由服务端异步完成。
使用场景
- 把本地 PDF 研究报告导入知识库,等待后台异步提取完成后再做语义搜索
- 从知识库语义搜索某个主题的资料,汇总成 Markdown 报告并生成网页发布
- 把多篇已写好的文档按树结构组织起来,从文档树一键生成多页面网站并发布
- 随手记录灵感待办时,用笔记接口存为临时内容,避免污染知识库检索结果
适合人员
- 维护个人知识库的技术写作者,希望原创长文和导入论文能自动提取关联,而不是手动整理
- 需要定期归档外部参考资料的研究员,希望报告、论文入库后能被语义搜索准确命中
- 发布内容的个人博主,想把已有文档通过模板生成网页拿到公开链接,而不是重复排版