前言¶

把资料沉淀进 ima 知识库之后，本地目录往往还会继续改：笔记更新、导出 PDF、批量整理文件夹。若只靠手工上传，很难判断「云端缺什么、本地多什么」，重复上传和漏传都常见。下面介绍 SkillHub 上的 ima知识库同步工具（@user_3af2e55b/ima-sync）：在 Agent 侧安装 Skill 后，可按官方提供的三种形态做双向差异对比与增量同步，并生成可视化报告。

这是什么¶

ima知识库同步工具 是社区发布者 user_3af2e55b 在 SkillHub 上架的 Skill，分类为 knowledge-management，当前页面标注版本为 v2.0.6。官方简介将其定位为：ima 知识库与本地文件夹的同步工具，强调零依赖、浏览器打开即用。

它解决的核心问题是：在本地目录与 ima 知识库之间建立可对比、可增量、可预检的同步流程，而不是单次手工上传。

核心功能¶

以下能力均来自 SkillHub 页面与已抓取元数据，未展开未在资料中出现的配置项或接口细节。

1. 双向差异对比：对比本地与云端差异，为后续同步提供依据。
2. 增量同步上传：在差异明确后做增量上传，减少全量重复劳动。
3. 可视化 HTML 报告：同步结果以 HTML 报告形式呈现，便于核对。
4. 文件预检过滤：上传前对文件做预检与过滤，降低无效或不合规文件进入知识库的概率。
5. 三种使用形态：
   - 纯前端可视化工具：Chrome / Edge 打开即用，无需安装；
   - Python 命令行脚本：仅使用标准库，无外部依赖；
   - WorkBuddy 定时自动化：适合按周期执行同步。
6. 上传与格式：支持 21 种文件格式；采用 COS 直传 + OpenAPI 双认证，用于提升上传稳定性。

Skill 标签标明 requires_api_key=true，使用前需准备 ima 相关 API 凭证（具体字段以安装后包内 SKILL.md 为准）。

安装与启用¶

通过 SkillHub CLI 安装¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

若未安装，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法识别。在 Cursor 中，常用路径为 ~/.cursor/skills/：

skillhub install user_3af2e55b/ima-sync --dir ~/.cursor/skills/

SkillHub 页面亦提供面向 AI 的安装提示：根据 https://skillhub.cn/install/skillhub.md 安装 @user_3af2e55b/ima-sync。将上述说明交给 Cursor 等 Agent 时，效果与按文档执行 CLI 安装一致，仍以实际 Agent 的 skills 目录为准。

其他 Agent 的 skills 目录¶

SkillHub 安装文档中列出的常见路径包括：

• Claude Code：~/.claude/skills/
• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• workbuddy：~/.workbuddy/skills/

将 --dir 换成对应环境路径即可，安装命令形式不变。

安装完成后，按包内 SKILL.md 完成 API Key 与本地目录等配置；资料中未给出独立配置字段名，此处不臆造。

典型用法¶

结合官方简介，可按场景选择形态，而不是混用三套入口：

1. 偶尔核对、希望零安装：用 Chrome 或 Edge 打开纯前端可视化工具，完成差异查看与同步操作（具体入口以 Skill 包内说明为准）。
2. 脚本化、CI 或本机定时：使用 Python 标准库命令行脚本，在终端执行对比与增量上传；适合已熟悉本地路径与凭证管理的开发者。
3. 周期性自动跑：在 WorkBuddy 等支持 skills 目录的自动化环境中挂载本 Skill，配置定时任务执行同步。

无论哪种形态，流程上可先理解官方描述的顺序：差异对比 → 预检过滤 → 增量上传 → 查看 HTML 报告。凭证与 ima OpenAPI / COS 相关步骤以安装后的 Skill 文档为准。

适用场景与注意¶

适合谁

• 已在使用 ima 知识库，且本地有固定资料目录需要与云端保持一致的个人或团队。
• 希望用 Agent Skill 统一「安装、说明、自动化入口」，而不是单独维护一套未文档化的脚本。

需要注意

• 标签 requires_api_key=true：未配置有效 API Key 时无法完成认证与上传。
• SkillHub 统计（截至页面抓取）：评分 100000，下载 2274；社区来源（community），升级与排障以 SkillHub 页面与包内 FAQ 为准。
• 三种形态面向不同环境：浏览器形态依赖 Chrome/Edge；Python 形态依赖本机 Python；WorkBuddy 形态依赖对应 Agent 的 skills 目录与调度能力。选型错误会导致「装了 Skill 但入口找不到」的错觉，安装时务必对齐 --dir。

结尾¶

ima知识库同步工具 把 ima 知识库与本地文件夹之间的同步，收敛为可对比、可增量、可报告的一条链路，并在前端、Python CLI、WorkBuddy 三种形态间切换，降低「只会上传、不会对齐」的维护成本。

• SkillHub 页面：https://www.skillhub.cn/skills/user_3af2e55b/ima-sync
• 官方 API 坐标：https://api.skillhub.cn/user_3af2e55b/ima-sync
• 安装说明：https://skillhub.cn/install/skillhub.md