前言¶
在 Agent 裏處理在線文檔，常見做法是整文件下載、本地改完再上傳，或只調用少數開放接口。段落級修改、多維表格字段自動化、合規掃描與 Webhook 聯動往往要你自己拼腳本。若團隊文檔落在金山文檔（WPS）上，又希望 Agent 能按品類走不同編輯策略，就需要一套對齊 WPS 開放平臺、並把本地能力與雲端 API 分開封裝的 Skill。
下面介紹 SkillHub 社區 Skill「金山文檔 KingDoc」（座標 @user_1a470ba8/kingdoc，當前版本 4.3.5），它面向 9 類在線文檔的全生命週期管理，並聲明在騰訊文檔同類能力之上提供 21 項金山側增強。
這是什麼¶
金山文檔 KingDoc 是發佈在 SkillHub 上的 office-efficiency 類 Skill，來源爲 community，維護者爲 user_1a470ba8。
一句話定位：金山文檔 AI 協作助手，深度直連金山文檔（WPS）開放平臺原生 API，覆蓋文檔、智能畫布、電子表格、演示文稿、多維表格、收集表、可視化、歷史管理、全文搜索、附件等品類。
Skill 頁標註 requires_api_key=true，即調用 WPS 開放平臺等雲端能力通常需要配置密鑰；同時官方說明中列出大量「零密鑰可用」能力（本地生成、OCR、硬件畫像、WPS AI、全文搜索、塊級編輯、配額管理、橋接、AirScript、視圖渲染、CRDT、數據 I/O、Webhook、知識中樞、政企合規、主題生成、跨品類對比、合規門面、行業分包、周掃定時化、配額告警等）。實際使用時以 Skill 內文檔爲準：涉及雲文檔讀寫、空間級操作前應先完成 API 配置。
核心功能¶
以下均來自 SkillHub 官方簡介，按品類與版本能力歸納。
九品類與編輯策略¶
| 品類 | 管理方式（官方描述） |
|---|---|
| 文檔 / 演示 / 可視化 | 本地生成 → 上傳覆蓋 |
| 電子表格 / 多維表格 | 開放平臺 API 精細編輯 |
| 智能畫布 | 元素級 CRUD + Markdown 增量追加 |
| 塊級編輯 | 段落級在線編輯，替代整文件替換 |
其餘品類（收集表、歷史管理、全文搜索、附件等）納入同一套全生命週期管理敘事中。
金山側增強（21 項，節選）¶
官方列舉包括但不限於：回收站、版本歷史、格式轉換（覆蓋 jpg/png/txt 等）、純文本提取、本地 OCR（優先橋接 wps-office-suite，未安裝則用 Tesseract 兜底，數據不出域）、通知推送、Webhook、批量任務、政企合規、硬件自適應性能、WPS AI、協同衝突解決、文檔合規檢查、實時協同編輯、文檔對比、模板市場、多維表格視圖增強、手寫/公式識別、智能畫布元素級編輯、全文搜索、塊級編輯、演示頁替換、配額管理器、wps-office-suite 雙向橋接、zwjh 記憶庫打通、表單答卷收集統計、AirScript 在線自動化、多維表格字段自動化、看板/甘特圖視圖渲染、CRDT 表格擴展（單元格級無衝突協作）、Excel/CSV 雙向導入導出（date/link/select/person 四類字段序列化）、Webhook 與通知中心（三通道分發 + 簽名校驗 + SQLite 去重）。
v4.1：多維表格與在線自動化¶
- AirScript：自然語言 → 腳本生成 → 預檢 → 確認 → 在線執行。
- 字段自動化：公式、關聯、彙總字段。
- 視圖渲染：matplotlib 看板柱圖、mermaid 甘特時間線。
- CRDT 表格擴展：單元格級操作日誌 + 向量時鐘衝突標記。
- Excel/CSV 雙向 I/O：四類字段序列化。
- Webhook 通知中心：新增/修改/刪除事件訂閱，金山協作 / 企微 / 釘釘三通道。
v4.2：知識中樞與政企合規¶
- 團隊知識庫：空間級倒排檢索 + 權限矩陣過濾（先鑑權後檢索）。
- 政企合規中心：密級標註落庫、敏感詞與數據泄露全量掃描報告、數據不出域聲明。
- 主題一鍵生成：WPS AI 適配層 generate（大綱 → 智能文檔/PPT/表格初稿，本地降級可切換真源）。
- 跨品類對比與時間線：版本歷史輪詢得到 who/when/what，表格支持單元格級 diff。
- OCR 收斂：單一入口，優先 wps-office-suite，否則 Tesseract。
v4.3：合規中心 v2 與運維告警¶
- 合規套件門面：單入口
quick_scan/full_scan，合併 v4.2 政企合規與 v3.4 內容合規檢查，敏感詞加載邏輯統一。 - 行業敏感詞分包：base 通用 + 教培 / 醫療 / 金融 / 政務，各 200+ 詞條，多包疊加；報告按高/中/低風險分級並定位段落與責任人字段。
- 全域掃描定時化：
schtasks周掃空間，新檢出項經 webhook 三通道簽名推送，跨周去重只推新增。 - 配額管理器閾值告警：用量 80% / 95% 兩級經 webhook 三通道推送，按天 + 級別冪等。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。官方頁面給出的安裝方式爲：讓 Agent 按 SkillHub 安裝文檔操作，並安裝座標 @user_1a470ba8/kingdoc。
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、安裝 KingDoc 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。
skillhub install @user_1a470ba8/kingdoc --dir <skills 目錄>
常用路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可在對話中直接發送官方提示詞：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_1a470ba8/kingdoc`。
3、API 密鑰與零密鑰能力¶
Skill 標籤爲 requires_api_key=true。連接 WPS 開放平臺、在雲空間創建或修改文檔等操作，需在 Skill 說明或環境變量中配置相應密鑰（具體字段名以安裝後的 SKILL.md 爲準）。
本地生成、OCR、合規掃描門面、Webhook 配置、配額告警等官方列出的能力可在無密鑰場景下使用部分路徑；若任務涉及雲文檔 ID、空間權限或在線協同，應提前完成開放平臺授權。
典型用法¶
官方頁面未提供獨立 CLI 示例命令，典型用法是通過已安裝 Skill 的 Agent 用自然語言編排下列能力（表述需與 SKILL.md 中的工具名一致）。
- 寫文檔 / 做 PPT / 可視化：描述大綱或修改意圖 → Skill 本地生成內容 → 上傳覆蓋對應金山文檔。
- 改表格 / 多維表格：說明單元格、字段或視圖需求 → 走 API 精細編輯；需要自動化時可走 AirScript（生成腳本 → 預檢 → 確認 → 在線執行）。
- 智能畫布：對畫布元素增刪改，或以 Markdown 增量追加內容。
- 塊級編輯：指定段落級修改，避免整份文件替換。
- 合規：調用合規門面
quick_scan或full_scan；政企場景可疊加行業敏感詞包；需要持續治理時可配置schtasks周掃與 webhook 推送。 - 運維與集成：訂閱文檔變更事件，經金山協作 / 企微 / 釘釘推送；配額接近 80% / 95% 時接收告警。
經過上面的步驟，Agent 會把「品類差異 + 本地/雲端分工」封裝在 Skill 內，你主要描述業務目標而非手寫開放平臺請求。
適用場景與注意¶
適合誰
- 文檔主陣地是金山文檔 / WPS，希望 Agent 統一處理多品類文檔與附件。
- 需要多維表格自動化、CRDT 協作、Excel/CSV 往返、看板/甘特視圖渲染等增強，而不只想做簡單上傳下載。
- 政企或內網場景關注合規掃描、密級標註、數據不出域 OCR，以及定時掃描 + Webhook 告警。
限制與注意
- 雲端能力依賴 WPS 開放平臺密鑰與賬號權限；未配置時只能使用官方列出的零密鑰子集。
- OCR 優先依賴 wps-office-suite 橋接；無橋接時回退 Tesseract，識別效果與環境有關。
- 周掃、webhook、配額告警涉及本機
schtasks與三通道配置，需在目標環境實測簽名與去重邏輯。 - SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 4750；版本以頁面標註的 4.3.5 爲準。
結尾¶
金山文檔 KingDoc 把 WPS 九品類文檔管理、21 項增強能力以及 v4.1–v4.3 的自動化與合規能力收斂爲一個 Agent Skill，並區分「本地生成上傳」與「表格 API 精編」兩條主路徑。若你正在 SkillHub 上選型辦公效率類 Skill，可從官方頁查看完整能力列表並安裝 @user_1a470ba8/kingdoc。
