前言¶
很多團隊把週報、合同、報名表和知識庫都放在金山文檔（WPS 雲文檔 / Kdocs，365.kdocs.cn、www.kdocs.cn）裏。Agent 若只能生成一段 Markdown 或本地文件，還要人工上傳、改格式、設分享權限，鏈路會斷在「雲盤裏那一份真文檔」上。下面介紹 SkillHub 上的「金山」：把新建、讀取、編輯、搜索、分享與整理等能力接到 Agent 側，讓任務儘量在雲端文檔上閉環。
這是什麼¶
「金山」是面向金山文檔雲端的官方 Skill（座標 @user_d6510c26/jinshanwenjian，當前版本 1.0.0）。它在 SkillHub 中歸類爲 office-efficiency，來源爲 community，由發佈者 user_d6510c26 維護；SkillHub 頁面標註作者爲「小燕」。
一句話定位：當用戶任務涉及雲文檔操作時，由 Agent 按 Skill 指引調用金山文檔相關能力，而不是隻產出無法直接落盤的文本。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未單獨列出的接口或參數不在本文展開。
文檔類型與基礎操作¶
支持在雲端處理多種在線文檔形態，包括：
- 智能文檔、Word、Excel、PDF、PPT、演示文稿
- 智能表格、多維表格
- 個人知識庫
圍繞這些對象，Skill 聲明覆蓋：新建、讀取、編輯、搜索、分享、整理。
官方列舉的典型任務¶
簡介中明確適用於（包括但不限於）：
| 方向 | 示例 |
|---|---|
| 辦公寫作 | 週報 / 日報 / 工作彙報 |
| 商務與票據 | 合同、發票處理 |
| 表單與收集 | 報名表、登記表、信息收集、接龍轉表格 |
| 內容與 AI | 文檔總結與內容生成、改寫仿寫、翻譯、AI PPT 生成 |
| 文件處理 | PDF 拆分導出、網頁剪藏 |
| 整理與知識 | 標籤分類歸檔、收藏管理、碎片筆記整理、表格美化、回收站還原、知識庫管理 |
Skill 標籤包含 requires_api_key=true，表示啓用前需要配置 API Key；具體環境變量或配置項名稱以安裝包內 SKILL.md 爲準，本文不臆造字段名。
安裝與啓用¶
1. 準備 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
說明與命令出處：SkillHub 安裝與優先源配置。
2. 安裝「金山」Skill¶
SkillHub 技能頁給出的安裝指引爲：根據上述安裝文檔，安裝座標 @user_d6510c26/jinshanwenjian。
用 CLI 安裝時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法加載。通用命令形式如下（將 <skills 目錄> 換成你當前客戶端的路徑）：
skillhub install @user_d6510c26/jinshanwenjian --dir <skills 目錄>
SkillHub 文檔中列出的常見 skills 目錄示例：
| 客戶端 | 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安裝後按所用 Agent 的要求重啓或刷新技能列表，並按要求配置 API Key（標籤 requires_api_key=true）。
3. 通過自然語言讓 Agent 安裝（可選）¶
也可將 SkillHub 頁面上的提示詞發給 Agent，大意是：請根據 https://skillhub.cn/install/skillhub.md 安裝 @user_d6510c26/jinshanwenjian。適合尚未配置 CLI、但希望 Agent 自行拉取技能的場景。
典型用法¶
本 Skill 基於通用 SKILL.md 格式：Agent 讀取技能說明後，在用戶自然語言意圖與金山文檔能力之間做路由。下列示例與官方簡介中的場景一致，表述方式可按實際對話調整，無需記憶固定 API 名。
-
寫週報並落到雲文檔
「在金山文檔裏新建一份本週工作彙報，結構包含：本週完成、風險、下週計劃；標題用今天的日期。」 -
表格與收集
「把這次接龍里的姓名和手機號整理成智能表格，並保存到我的雲文檔。」 -
閱讀與總結
「打開我雲文檔里名爲『XX 項目紀要』的文檔，總結三條結論並寫回文檔末尾。」 -
分享與整理
「給這份合同 PDF 設置僅指定同事可查看的分享鏈接，並把文檔打上『法務』標籤歸檔。」 -
知識庫
「把這幾條碎片筆記合併進個人知識庫對應文件夾，並刪除重複條目。」
經過上面的步驟，Agent 應在 Skill 約束下調用雲文檔能力；若某一步需要 Key 或賬號授權，按 SKILL.md 與 Agent 提示完成配置後再重試。
適用場景與注意¶
適合誰
- 日常重度使用 WPS 雲文檔 / Kdocs 的團隊或個人
- 希望 Agent 直接改「線上那份」文檔，而不是隻生成本地草稿的開發者或效率用戶
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客戶端，並願意通過 SkillHub 管理技能
限制與注意
- 需有效的金山文檔賬號及 Skill 要求的 API Key；未配置時相關調用會失敗。
- 簡介中的能力以 Skill 實現爲準；複雜排版、企業權限策略等仍以金山文檔產品側規則爲上限。
- SkillHub 抓取信息顯示：評分 100000，下載 4004（統計隨 SkillHub 更新變化）；安裝前可在技能頁覈對版本 v1.0.0 與說明是否仍符合預期。
- 安裝目錄務必使用
--dir指向當前 Agent 的 skills 路徑，避免裝錯位置。
結尾¶
「金山」把 Agent 的對話能力接到金山文檔雲端：新建與編輯、搜索分享、表格與知識庫整理等，都可在 SkillHub 簡介所聲明的範圍內由技能指引完成。需要查看說明、複製安裝提示或覈對版本時，請訪問官方技能頁：
- SkillHub：https://www.skillhub.cn/skills/user_d6510c26/jinshanwenjian
- API 條目：https://api.skillhub.cn/user_d6510c26/jinshanwenjian
