前言¶

把資料沉澱進 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