前言¶
在 Agent 裏處理 xlsx、docx、pdf 時，常見做法是讓用戶自己裝一堆庫、寫腳本，或把文件交給在線轉換服務。前者步驟多、環境難統一；後者往往要 API Key，且文檔會離開本機。若你希望對話裏直接完成創建、編輯、轉換和簡單分析，又堅持數據不出本地、不配置密鑰，需要一個把能力寫進 Skill、由 Agent 按規範調 Python 的方案。下面介紹 SkillHub 上的「全能本地文檔處理專家」。
這是什麼¶
「全能本地文檔處理專家」是 SkillHub 社區 Skill，座標爲 @user_734b3090/office-toolkit-local，當前版本 1.0.0，分類爲 office-efficiency，發佈者爲 user_734b3090（SkillHub 頁面標註作者爲李傑）。Skill 標籤標明 requires_api_key=false，即不依賴外部 API Key。
一句話定位：在 Agent 中通過自然語言觸發，對 xlsx / docx / pdf / pptx / csv / md 等格式進行創建、編輯、轉換與分析，執行側爲純本地 Python。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_734b3090/office-toolkit-local
- API 座標頁：https://api.skillhub.cn/user_734b3090/office-toolkit-local
核心功能¶
以下能力均來自 SkillHub 簡介與頁面描述，未單獨展開的實現細節以安裝後的 SKILL.md 爲準。
| 方向 | 說明 |
|---|---|
| 表格與數據 | Excel（xlsx）公式、圖表；csv 處理；數據分析與報告類任務 |
| 文稿 | Word（docx）創建與編輯；中文排版與模板 |
| 合併、拆分、水印、加密等常見操作 | |
| 演示與標記 | PPT（pptx）相關處理；Markdown（md）格式轉換 |
| 工程特性 | 批量處理；全程本地、零 API Key |
便於 Agent 匹配的觸發詞包括：文檔、Excel、Word、PDF、PPT、表格、報告、轉換、合併、提取、排版、批量，以及 xlsx、docx、pptx、csv、watermark、encrypt、chart、formula、template、office 等。
安裝與啓用¶
SkillHub 推薦兩種方式：用 CLI 安裝，或把安裝提示詞發給當前 AI，讓其按官方安裝文檔操作。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
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
安裝說明全文：https://skillhub.cn/install/skillhub.md。
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。
skillhub install @user_734b3090/office-toolkit-local --dir <skills 目錄>
常用路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可直接向 Agent 發送 SkillHub 頁面給出的提示詞，讓其根據 https://skillhub.cn/install/skillhub.md 安裝 @user_734b3090/office-toolkit-local。
安裝完成後，按你所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
公開頁面未附帶獨立命令行教程；實際行爲由 Skill 包內的 SKILL.md 與附帶腳本定義。在啓用 Skill 後，可按簡介中的場景用自然語言描述任務，並帶上上述觸發詞，例如：
- 說明輸入輸出路徑與格式（如「把目錄下多個 pdf 合併爲一個文件」）。
- 對 Word，寫明是否需要模板或中文排版要求。
- 對 Excel，寫明公式、圖表或彙總報告需求。
- 對 PDF，寫明合併、拆分、水印或加密等具體操作。
Agent 應在本地 Python 環境中執行 Skill 規定的步驟；若缺少依賴，需按 SKILL.md 或安裝日誌在本地補齊，而非配置雲端密鑰。
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code、Codex 等支持 Skills 的客戶端裏處理 Office 類文件，且希望文檔不經過第三方 API 的開發者或辦公自動化用戶。
- 需要批量轉換、合併、提取或簡單分析報告，又不想每次手寫 openpyxl、python-docx、PyPDF2 等腳本的場景。
需要注意
- 能力邊界以 Skill 簡介爲準；複雜排版、宏、受保護文檔等是否支持，需以安裝後的 Skill 文檔爲準，本文無法覈實未公開的細節。
- 純本地意味着本機需具備相應 Python 依賴與足夠磁盤、算力；大批量文件應先小樣本試跑。
- SkillHub 抓取信息顯示該 Skill 評分 100000、下載 5129 次（統計隨平臺更新而變化）。
結尾¶
「全能本地文檔處理專家」把常見 Office 與 Markdown 操作收斂爲一個 office-efficiency 類 Skill，強調本地 Python 與 零 API Key，適合在 Agent 對話裏用觸發詞驅動文檔流水線。安裝與座標以 SkillHub 爲準：
https://www.skillhub.cn/skills/user_734b3090/office-toolkit-local
