前言¶

WorkBuddy 生成的文档、笔记、脚本散在工作目录里，容易随着换机器、清缓存或误操作丢失。手动整理到知识库又太碎：一篇一篇复制粘贴，还要在浏览器里重新建分类、打标签。

IMA知识库同步 这个 Skill 做的事就是把这类产出批量搬到腾讯 ima 知识库里，直接调用官方 IMA OpenAPI，不走网页端手工操作。下面介绍它的能力、用法和适用边界。

这是什么¶

IMA知识库同步（坐标 @user_d3228c23/qianjin-ima-sync）是 SkillHub 上 community 来源的一个 Skill，发布者为 user_d3228c23，当前版本 2.1.1，分类 knowledge-management。它解决的问题是：让 WorkBuddy 的产出能被自动备份到腾讯 ima 知识库，并支持后续的搜索与归档。

核心功能¶

根据官方简介，已核实的能力包括：

1. 单文件上传：把单个生成文件送进指定知识库。
2. 整目录批量备份：一次把整个目录的内容备份过去。
3. 文本转笔记：把一段文本直接建成 ima 笔记。
4. 网页 / 微信文章收藏：把网页链接或微信文章收进知识库。
5. 自动增量备份：已有内容不重复全量重传。
6. 知识库与笔记搜索：在 ima 侧按库或按笔记检索。
7. 智能路由：按路径或文件类型自动决定写入哪个目标知识库，不需要每次手动指定。

触发词覆盖：备份到ima、上传到ima、存到ima知识库、ima同步、ima备份、归档到ima、自动备份、保存到腾讯ima、搜ima知识库、搜ima笔记。

安装与启用¶

官方地址：https://api.skillhub.cn/user_d3228c23/qianjin-ima-sync
SkillHub 页面：https://www.skillhub.cn/skills/user_d3228c23/qianjin-ima-sync

当前抓取到的资料中没有给出具体的安装命令和配置文件路径，因此这里不替官方补写。该 Skill 的标签里标了 requires_api_key=true，说明启用前需要在配置中填入腾讯 ima 的 OpenAPI 凭据，具体字段名以包内 SKILL.md 或安装页为准。

典型用法¶

下面这些是官方简介里列出的触发方式，对应前面说的功能：

• 对工作目录说「备份到ima」，触发整目录批量备份。
• 对单个文件说「上传到ima」或「存到ima知识库」。
• 说「保存到腾讯ima」，把当前产出落库。
• 说「归档到ima」，走自动增量备份。
• 说「搜ima知识库」或「搜ima笔记」，在 ima 侧检索。

触发词需要按 Skill 实际注册的词表生效，建议先拿一个文件做一次最小验证，确认走的是增量备份而不是全量重传。

适用场景与注意¶

适合的人：已经在用 WorkBuddy 产出文档和笔记，同时希望产出有第二个可搜索的归档位置，不想每次手工搬文件的人。

需要注意的点：

1. 凭据必须就位。requires_api_key=true 意味着没有 API Key 时备份相关功能不可用，且这是腾讯 ima OpenAPI 的调用凭据，不是通用环境变量。
2. 依赖网络与 ima 服务可用性，备份是异步写入，失败重试的窗口由 Skill 自身实现决定，重要产出建议本地再留一份副本。
3. 智能路由按路径和类型分库，归档前先确认目标库的归属是否符合预期，避免把内容写进错误的知识库。
4. 资料中未给出各客户端（Cursor、Codex CLI、Claude Code）的差异化安装说明，使用前以包内文档为准。

结尾¶

IMA知识库同步 的价值在于把「产出后顺手存进知识库」变成一句触发词的事，省掉网页端逐条搬运。它基于官方 IMA OpenAPI，功能面覆盖了备份、收藏和搜索三条主线。如果你已经有稳定的 WorkBuddy 产出目录，可以从这里开始：https://api.skillhub.cn/user_d3228c23/qianjin-ima-sync