name: kingdoc displayName: 金山文件 KingDoc slug: kingdoc version: 3.6.0 description: > 金山文件 AI 協作助手 — 7 品類線上文件全生命週期管理 （文件/電子表格/簡報/多維表格/收集表/視覺化/附件）， 深度直連金山文件（WPS）開放平臺原生 API，覆蓋騰訊文件全部能力 + 金山獨有 14 項增強 （回收站、版本歷史、格式轉換、純文本提取、本地 Tesseract OCR、通知推送、Webhook、 批次任務、政企合規、硬體自適應效能、WPS AI 能力、協同衝突解決、文件合規檢查、 即時協同編輯、文件對比、WPS AI 深度整合、模板市場）。文字/演示/視覺化採用"本地生成→上傳覆蓋"， 電子表格/多維表格採用 API 精細編輯。本地生成、OCR、硬體畫像、WPS AI 等能力零金鑰可用。 description_zh: "金山文件 AI 協作助手 — 7 品類線上文件全生命週期管理（深度直連 WPS 開放平臺 + WPS AI 深度 + 即時協同 + 文件對比 + 模板市場）" category: 辦公效率 platforms: [WorkBuddy, QClaw, ima, Claude Code, Cursor] tags: [文件處理, 表格處理, PPT生成, 多維表格, 表單收集, 思維導圖, 流程圖, OCR, 政企合規] license: MIT requires_api_key: true icon: assets/icon.png

KingDoc — 金山文件 AI 協作助手 v3.0.0

對標騰訊文件 TENCENT DOCS，功能 1:1 覆蓋 + 差異化增強。 v3.0.0 重點：深度直連線上文件原生 API、危險操作強制確認、硬體自適應效能、免金鑰本地能力。

📣 評測反饋與本輪（v3.0.0）最佳化說明

本版本針對第三方評測（綜合 4.5/5「優秀」）的降分項做了逐項閉環：

⚠️ 首次使用必讀

1. 申請金山開放平臺 App（免費，僅雲端協作需要）

隻影響「上傳到雲端 / 多人協作 / 回收站 / 版本」等聯網能力。 本地生成文件、本地 OCR、硬體畫像完全不需要 Key，開箱即用。

申請步驟： 1. 訪問 金山開放平臺 並登入金山文件賬號 2. 進入「應用管理」→「建立應用」，獲取 App ID 和 App Secret 3. 勾選許可權（OAuth Scope）： - 必須：user:file:write、user:file:read、team:file:write、team:file:read - 建議：user:team:read、user:notification:write 4. 測試階段限速 500 次/天，正式版 10 萬次/天

2. （可選）安裝本地 Tesseract OCR

僅「圖片文字提取」需要；未裝則自動降級雲端 OCR 或給指引，不影響其他功能。

# Windows
winget install UB-Mannheim.TesseractOCR
# macOS
brew install tesseract tesseract-lang
# Linux
sudo apt-get install tesseract-ocr tesseract-ocr-chi-sim

3. 配置並載入

# Linux/macOS
bash setup.sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File setup.ps1

指令碼引導輸入 App ID/Secret，自動生成 config.json、mcp-config.json、模板與圖示，並採集本機硬體畫像。

快速開始

5. 自然語言觸發示例（高階功能怎麼表達）

為避免「不知道怎麼開口」，以下給可直接說的話：

• 批次建表："新建客戶管理多維表格，欄位：客戶名(文本)、簽約金額(數字)、狀態(單選)，並一次寫入 20 條記錄"
• 格式轉換："把《Q2 報告》匯出成 PDF" / "轉成 Word 發我"
• OCR 轉文件："識別這張發票圖片，生成一份 Word 報銷單" / "把這張表格圖片轉成線上電子表格"
• 網頁剪藏："把這個網頁 https://... 收藏成金山文件"
• 通知推送："匯入完成後用企微機器人通知我"
• 版本回滾："列出這份文件的歷史版本，回退到 7 月 1 日那版"
• 許可權管理："給團隊資料夾『2026 專案』裡的文件設定只讀"
• 本地免金鑰生成："本地生成一份週報 DOCX，不用上傳"（無需 App Key）

安全宣告

6. 🚨 危險操作強制確認（v3.0.0 新增鐵律）

評測指出「部分危險操作缺少強制確認」。以下操作執行前必須向用戶顯式確認， 列出具體影響，待使用者明確同意後方可進行；絕不靜默執行。

確認模式（config.json 可配）：

{ "safety": { "confirm_mode": "dangerous", "dry_run": false, "audit_enabled": true } }

• dangerous（預設）：僅上表危險操作需確認
• always：所有寫操作均確認
• dry_run: true：只展示將要執行的操作，不真正呼叫

支援的文件型別（9 品類）

核心能力矩陣

1️⃣ 文件建立（9 品類全覆蓋）

2️⃣ 文件編輯（改內容）

先 kdoc.file.info 確定品類，再路由對應工具集。嚴禁跨品類操作。

3️⃣ 檔案管理

4️⃣ 格式轉換與 OCR

5️⃣ 擴充套件能力（金山獨有）

6️⃣ 本地免金鑰工具（無需 App Key）

7️⃣ WPS AI 能力（v3.2.0 新增，本地降級優先）

WPS AI 目前無公開開發者 API，本模組採用本地降級 + 自研邏輯實現，零金鑰可用。 未來如 WPS AI 開放 API，只需新增後端即可升級，無需改動上層。

後端策略：本地降級優先 → 未來可擴充套件 WPS Open API / COM 自動化 / Web API

10. 協同編輯衝突解決（v3.3.0 新增，自研 difflib 實現）

多人同時編輯同一文件時經常出現衝突（A 修改了第 3 段，B 也修改了第 3 段）。 本模組提供衝突檢測 + 智慧合併 + 視覺化 diff + 解決模板，零外部依賴。

10.1 衝突檢測

10.2 工具列表

10.3 工作流程

① 檢測：kdoc.version.list → 取最近 2-3 個版本 → conflict.detect() → 衝突塊列表
② 合併：conflict.merge() → 自動合併無衝突段 + 標註衝突段 → 合併建議
③ 視覺化：conflict.diff() → Git 風格並排 diff（可匯出 HTML）
④ 解決：使用者選模板 → conflict.resolve() → ⚠️ 強制確認 → kdoc.file.upload 覆蓋回雲端

10.4 解決模板

10.5 安全約束

• 合併結果覆蓋回雲端屬於「覆蓋檔案」危險操作，必須走強制確認鐵律（見第 6 節）
• 衝突段絕不自動覆蓋，必須使用者明確選擇
• 大文件 diff 自動分塊處理，不拖累電腦（硬體自適應）

11. 文件內容合規檢查（v3.4.0 新增，自研正則+規則引擎）

政企客戶對文件內容有嚴格合規要求，手動檢查耗時易遺漏。 本模組提供敏感詞掃描 + 資料洩露檢測 + 格式規範檢查 + 密級標註，零外部依賴。

11.1 工具列表

11.2 工作流程

① 敏感詞掃描：kdoc.file.content → 取全文 → compliance.sensitive() → 命中列表+位置
② 洩露檢測：compliance.leak() → 正則匹配手機/身份證/銀行卡/郵箱 → 風險等級
③ 格式檢查：kdoc.local.docx 解析 → compliance.format() → 不合規清單
④ 密級標註：compliance.classify() → 關鍵詞+規則 → 建議密級

11.3 敏感詞庫管理

• 內建詞庫：references/sensitive_words.txt（適配中國監管要求）
• 使用者黑名單：references/user_blacklist.txt（追加自定義敏感詞）
• 使用者白名單：references/user_whitelist.txt（跳過誤判詞）
• 定期更新：替換 sensitive_words.txt 即可，無需改程式碼

11.4 資料洩露檢測能力

11.5 格式規範檢查

11.6 密級標註規則

12. 即時協同編輯（v3.5.0 新增，序列 CRDT 自研實現）

多人同時編輯同一文件時經常出現衝突（A 修改了第 3 段，B 也修改了第 3 段）。 v3.3 衝突解決是事後 difflib 合併，本模組升級為即時 CRDT 協同，多人同時編輯無衝突。

12.1 工具列表

12.2 核心演算法：序列 CRDT

• 每個字元帶唯一因果 ID（lamport timestamp + client_id + 序列號）
• 插入/刪除操作滿足交換律，順序無關
• 刪除標記 tombstone（保留因果關係，不真正移除）
• 最終一致性：所有客戶端收斂到相同狀態
• 無需中央伺服器協調（P2P 友好）

12.3 工作流程

1) kdoc.realtime.create(client_id) → 建立協同文件
2) 使用者 A 插入：kdoc.realtime.insert("alice", 0, "Hello")
3) 使用者 B 同時插入：kdoc.realtime.insert("bob", 5, " World")
4) 操作自動廣播給所有客戶端
5) kdoc.realtime.get_text(client_id) → 獲取一致文本

13. 文件對比（v3.5.0 新增，複用 difflib 引擎）

對應 TOP50「文件對比檢測器」，兩版文件差異高亮。 複用 conflict_resolver.py 的 difflib 引擎，提供面向使用者的對比能力。

13.1 工具列表

13.2 工作流程

1) kdoc.file.content(file_id) → 獲取當前版本
2) kdoc.version.list(file_id) → 獲取歷史版本
3) kdoc.compare.diff(current, history) → 差異高亮
4) kdoc.compare.summary(current, history) → 變更摘要
5) kdoc.compare.export(current, history, format="html") → 匯出報告

14. 視覺化品類合併（v3.5.0 精簡 9→8 品類，v3.6.0 進一步精簡為 7 品類）

為降低認知門檻、統一渲染管線，v3.6.0 將思維導圖和流程圖合併為「視覺化」品類。

14.1 合併前後對比

14.2 子命令路由

合併後用戶仍可用原有表達方式，引擎自動識別子命令：

14.3 共享渲染管線

使用者意圖 → 品類路由 → visualization
                              ↓
                    子命令識別：mindmap 或 flowchart
                              ↓
                    共享 mermaid→SVG 渲染管線
                              ↓
                        上傳為線上文件
推薦訪問7w4.net獲取更多AI技能。

14.4 引擎邏輯不變

• 底層仍呼叫 engine/local/generators.py 的 MindmapGenerator / FlowchartGenerator
• 渲染方式仍為 mermaid→SVG→上傳覆蓋
• 僅改品類後設資料（engine/categories.py）+ 路由表

15. WPS AI 深度整合（v3.2 本地降級 → v3.6 段落級 AI 操作）

v3.2 已實現全文級 AI 寫作輔助（polish/expand/shorten），v3.6 升級為段落級 AI 深度整合。

15.1 工具列表

15.2 工作流程

1) 使用者在編輯器中選中段落
2) 觸發 AI 操作（改寫/總結/續寫）
3) 介面卡路由到本地降級後端
4) 返回處理結果 → 使用者確認 → 替換原段落
5) 未來 WPS AI API 開放後，切換為原生後端，無需改上層程式碼

15.3 後端策略

當前（v3.6）：本地降級佔位（返回原文+提示）
未來：WPS AI 開放 API → 升級為原生後端（實現 WpsAiDeepBackend 介面即可）

16. 文件模板市場（v3.6.0 新增，行業模板庫一鍵複用）

降低文件建立門檻，提供行業模板庫 + 變數替換 + 一鍵生成。

16.1 工具列表

16.2 模板倉庫結構

templates/
├── meeting.md          # 會議紀要模板
├── weekly-report.md    # 週報模板
├── project-plan.md     # 專案計劃模板
├── contract.md         # 合同模板
├── pitch-deck.md       # 融資路演模板
└── ...

16.3 變數替換

模板使用 {{變數名}} 語法，使用時傳入變數字典：

---
name: weekly-report
category: 工作彙報
description: 標準週報模板
---

# {{title}}
> 作者：{{author}} | 日期：{{date}}

## 本週完成
{{completed}}

## 下週計劃
{{plan}}

## 風險與風險
{{risks}}

呼叫：kdoc.template.use("weekly-report", {"title": "週報", "author": "張三", ...})

16.4 工作流程

1) kdoc.template.list() → 列出可用模板
2) 使用者選擇模板 → kdoc.template.use(name, variables)
3) 引擎替換變數 → 生成 Markdown → 儲存到 output/
4) 返回生成內容 + 檔案路徑
5) 可選：上傳為線上文件

17. 完整場景案例（v3.0.0 新增）

場景 A：月度銷售復盤（全鏈路）

1) kdoc.et.create(name="2026-07 銷售復盤")
2) kdoc.et.range.write(sheet_id, "A1:C21", 表頭+20 行資料)   ← 批次寫入
3) kdoc.et.formula.set(sheet_id, "D2", "=C2*0.1")            ← 提成列
4) kdoc.office.convert(file_id, "pdf")                       ← 匯出 PDF
5) kdoc.notification.send(channel="wecom", content="復盤已生成")

場景 B：合同 OCR → 線上文件（免金鑰本地優先）

1) kdoc.local.ocr.extract("contract.jpg")        ← 本地 Tesseract，無需 Key
2) kdoc.local.docx.generate(content=<ocr_text>, template="contract")
3) kdoc.file.upload(file_path="output.docx")     ← 上傳為線上文件

場景 C：專案規劃腦圖 + 流程圖（本地渲染）

1) kdoc.local.mindmap.generate(code="graph TD; 目標-->階段1; 階段1-->任務A")
2) kdoc.local.flowchart.generate(code="flowchart TD; 開始([開始])-->稽核{通過?}")
3) 分別 kdoc.file.upload 兩個 SVG → 線上視覺化

場景 D：誤刪恢復（金山獨有）

1) kdoc.trash.list(limit=20)
2) kdoc.trash.recover(file_id)        ← 救回，不丟資料

場景 E：大批次匯入（硬體自適應）

1) kdoc.local.hardware.profile → 取得 workers/batch_chunk
2) 按 batch_chunk 分塊呼叫 kdoc.batch.create
3) kdoc.batch.query 輪詢直至完成（併發不超過 workers，不卡機）

場景 F：多人協作衝突解決（v3.3.0 新增）

1) kdoc.version.list(file_id) → 獲取最近 3 個版本（基準版 + A修改 + B修改）
2) kdoc.conflict.detect(base, a, b) → 檢測衝突塊
3) kdoc.conflict.merge(base, a, b) → 自動合併無衝突段 + 標註衝突段
4) kdoc.conflict.diff(a, b) → Git 風格視覺化
5) 使用者選擇保留A/保留B/手動合併 → kdoc.conflict.resolve(strategy="keep_a")
6) ⚠️ 強制確認 → kdoc.file.upload 覆蓋回雲端

場景 G：政企文件合規檢查（v3.4.0 新增）

1) kdoc.file.content(file_id) → 取全文
2) kdoc.compliance.sensitive(text) → 掃描敏感詞（命中"反動"、"毒品"等）
3) kdoc.compliance.leak(text) → 檢測資料洩露（手機號/身份證號脫敏）
4) kdoc.compliance.classify(text) → 建議密級（如"秘密"）
5) kdoc.compliance.format(file_path) → 格式規範檢查（字型/字號/行距）
6) 生成合規報告 → 使用者確認 → 修復不合規項

場景 H：即時協同編輯（v3.5.0 新增）

1) kdoc.realtime.create("alice") → Alice 建立協同文件
2) kdoc.realtime.insert("alice", 0, "專案計劃：") → Alice 插入文本
3) kdoc.realtime.insert("bob", 5, "第一階段") → Bob 同時插入
4) kdoc.realtime.get_text("alice") → Alice 看到合併後的文本
5) kdoc.realtime.stats("alice") → 檢視協同統計

場景 I：文件對比（v3.5.0 新增）

1) kdoc.file.content(file_id) → 獲取當前版本
2) kdoc.version.list(file_id) → 獲取歷史版本
3) kdoc.compare.diff(current, history) → 差異高亮
4) kdoc.compare.summary(current, history) → 變更摘要
5) kdoc.compare.export(current, history, format="html") → 匯出 HTML 報告

場景 J：7 品類智慧路由（v3.6.0 更新）

1) 使用者說"幫我寫一份智慧文件" → kdoc.category_resolve("智慧文件")
   → {category: "doc", sub_type: "smart_note", edit_method: "local_generate_upload"}
2) 使用者說"畫一個思維導圖" → kdoc.category_resolve("思維導圖")
   → {category: "visualization", sub_command: "mindmap", edit_method: "local_render_upload"}
3) 使用者說"畫一個流程圖" → kdoc.category_resolve("流程圖")
   → {category: "visualization", sub_command: "flowchart", edit_method: "local_render_upload"}
4) kdoc.category_list() → 列出全部 7 品類

場景 K：WPS AI 段落改寫（v3.6.0 新增）

1) 使用者在編輯器中選中段落
2) kdoc.wps_ai.rewrite(paragraph="這個方案很好，值得推廣。", style="formal")
   → 返回改寫後的段落（本地降級佔位，API 開放後升級為原生）
3) 使用者確認 → 替換原段落

場景 L：模板市場一鍵生成（v3.6.0 新增）

1) kdoc.template.list() → 列出所有可用模板
2) kdoc.template.search("週報") → 搜尋週報模板
3) kdoc.template.use("weekly-report", {"title": "週報", "author": "張三"})
   → 變數替換 → 生成 Markdown → 儲存到 output/
4) kdoc.file.upload(output_path) → 上傳為線上文件

12. 核心規則（鐵律）

1. 🚨 品類隔離：先 kdoc.file.info 識別品類再路由，嚴禁跨品類操作。
2. 📦 批次優先：電子表格/多維表格連續 3+ 寫入必須用批次介面。
3. 🔒 許可權前置：所有寫入前必須校驗許可權。
4. 🔄 非同步輪詢：批次/轉換/剪藏必須子會話輪詢，主會話保持響應。
5. 🗑️ 軟刪除：刪除必須走回收站 API，不物理刪除。
6. 📝 審計日誌：所有寫操作必須記錄本地審計日誌。
7. ⚡ 限流退避：收到 429 必須自動指數退避（最多 5 次）。
8. 🔀 版本防衝突：寫入前獲取 version，衝突時提示合併。
9. ✅ 危險操作強制確認（v3.0.0）：見第 6 節，未確認不執行。
10. 🧠 效能不拖累：批次/渲染併發不得超過 kdoc.local.hardware.profile 給出的 workers。

13. 能力邊界與失敗場景（v3.0.0 新增，務必看清）

明確不支援：本地直接修改已上傳 DOCX/PPTX 的某一段（需整檔案重生成）； 對加密/損壞檔案 OCR；超過配額的非付費批次操作。

14. 風險項與限制

15. 深度繫結線上文件（v3.0.0 強化）

KingDoc 直連金山文件（WPS）開放平臺原生 API（https://developer.kdocs.cn/api/v1/openapi）， 而非簡單橋接：

• 原生能力全覆蓋：檔案/資料夾/回收站/版本/許可權/空間/通知/使用者均呼叫官方端點。
• 精細編輯：電子表格走 et API（單元格/公式），多維表格走 dbt API（記錄/欄位/檢視）。
• 本地增強：文字/演示/腦圖/流程圖用本地庫生成原生格式（DOCX/PPTX/SVG）後上傳覆蓋， 既保真又免去服務端複雜排版。
• 政企可用：國內網路直連、文件全中文、許可權模型對齊企業協作。

16. 四大 MCP 服務（v3.0.0 架構）

4 個 MCP 服務共享同一 Token，可獨立限流、獨立降級。

17. 效能與硬體自適應（v3.0.0 新增，絕不拖累電腦）

engine/hardware.py 在首次執行時自動採集本機 CPU 核數/記憶體並計算出安全併發：

• 畫像快取到 .kingdoc_hardware_profile.json（30 分鐘複用），不頻繁探測。
• 批次寫表、腦圖/流程圖並行渲染不得超過 workers，保證使用者電腦流暢。
• AI 在執行批次/渲染任務前應呼叫 kdoc.local.hardware.profile 讀取引數。

python -m engine.hardware          # 檢視本機畫像與推薦引數

18. 🚫 禁止上傳的檔案型別（v3.0.0 強化）

為安全，使用者「上傳附件」預設攔截以下全部型別（來源：產品安全規範）：

1. Windows 可執行/批處理：.bat .cmd .ps1 .vbs .exe .dll .lnk .msi
2. Office 二進位制文件：.docx .xlsx .pptx .doc .xls .ppt .xlsm .docm .pptm
3. 二進位制映象/安裝包：.iso .dmg .zip .rar .7z .tar .gz .apk .jar
4. 系統快取/隱藏檔案：.DS_Store .git（目錄） .env .log .tmp
5. 其他風險指令碼：.sh .com .scr .hta .reg

內部豁免：技能「本地生成→上傳覆蓋」產物（.docx/.pptx/.xlsx/.pdf/.svg/.png/.txt/.md 等）經 internal=True 通道上傳，僅限技能自身生成，使用者無法借道上傳任意同類檔案。 命中攔截將丟擲 KD009。詳見 references/security.md。

19. 錯誤碼

20. 🔄 自動更新提示與反饋

每天首次使用自動檢查更新（本地快取，每天僅查一次，離線不打擾）。 發現新版本時 AI 會主動提示升級，不會自動安裝：

# 手動檢查 / 僅看提醒文案
python -m engine.update_check --version 3.0.0 --reminder

📮 有更好建議：njskills@agent.qq.com

更新日誌

| v3.6.0 | 2026-08-16 | 增加：文件模板市場引擎 engine/template_marketplace.py（git 倉庫管理模板，支援 list/search/use/refresh，變數替換一鍵生成）；增加：WPS AI 深度整合（段落級 AI 操作：rewrite/summarize/continue，本地降級佔位，API 開放後升級為原生）；增加：視覺化品類合併 engine/categories.py（8→7 品類，合併 mindmap+flowchart→visualization，共享 mermaid 渲染管線）；增加：MCP 工具 7 個（kdoc.template. 4 個、kdoc.wps_ai. 3 個）；增加：視覺化品類合併/WPS AI 深度整合/模板市場場景案例；最佳化：品類路由表從 8→7，引擎邏輯不變 | | v3.5.0 | 2026-08-08 | 增加：即時協同編輯引擎 engine/realtime_collab.py（序列 CRDT 自研實現，零第三方依賴）；增加：文件對比模組 engine/doc_comparator.py（複用 difflib，差異高亮+變更摘要+匯出）；增加：品類後設資料 engine/categories.py（9 品類精簡為 8 品類，合併 doc+smart_note，子型別自動識別）；增加：MCP 工具 12 個（kdoc.realtime. 5 個、kdoc.compare. 3 個、kdoc.category. 2 個、kdoc.file. 品類路由更新）；增加：即時協同+文件對比+8 品類智慧路由場景案例；最佳化：品類路由表從 9→8，引擎邏輯不變 | | v3.4.0 | 2026-07-30 | 增加：文件內容合規檢查模組 engine/compliance_check.py（自研正則+規則引擎，零第三方依賴）；增加：敏感詞掃描 kdoc.compliance.sensitive（內建詞庫+使用者黑白名單）、資料洩露檢測 kdoc.compliance.leak（手機號/身份證號/銀行卡號/郵箱，Luhn+校驗碼驗證）、格式規範檢查 kdoc.compliance.format（DOCX/PPTX/TXT/MD）、密級自動標註 kdoc.compliance.classify（公開/內部/秘密/機密）；增加：合規檢查 MCP 工具 4 個；增加：敏感詞庫 references/sensitive_words.txt、格式規範 references/format_spec.md、使用者黑白名單模板；增加：政企文件合規檢查場景案例 | | v3.3.0 | 2026-07-21 | 增加：協同編輯衝突解決模組 engine/conflict_resolver.py（自研 difflib 實現，零第三方依賴）；增加：衝突檢測 kdoc.conflict.detect、智慧合併 kdoc.conflict.merge（自動合併無衝突段 + 標註衝突段）、Git diff 視覺化 kdoc.conflict.diff、解決模板 kdoc.conflict.resolve（keep_a/keep_b/manual/auto_merge）；增加：衝突解決 MCP 工具 4 個；增加：大文件 diff 分塊硬體自適應處理；增加：多人協作衝突解決場景案例；最佳化：衝突段強制使用者確認，絕不自動覆蓋 | | v3.2.0 | 2026-07-17 | 增加：WPS AI 能力適配層（寫作輔助/資料分析/PPT 生成/閱讀助手），本地降級優先、自研邏輯實現、零金鑰可用；增加：WPS AI 介面卡 engine/wps_ai/adapter.py；增加：本地降級後端 engine/wps_ai/backends/local_fallback.py；增加：能力定義與意圖對映 engine/wps_ai/capabilities.py；增加：WPS AI API 調研記錄 engine/wps_ai/research_notes.md；最佳化：MCP Server 註冊 5 個 WPS AI 工具；最佳化：版本號 3.0.0→3.2.0 | | v3.1.0 | 2026-07-15 | 增加：wps-office-suite 互通方案調研（已廢棄，因平臺合規不允許雙 skill 互通） | | v3.0.0 | 2026-07-12 | 增加：危險操作強制確認鐵律與確認清單（刪除/徹底刪除/覆蓋/批次/許可權/清空回收站/版本回滾/Webhook）；增加：禁止檔案型別擴充套件至完整 35 類（執行指令碼/Office 二進位制/歸檔映象/系統檔案/風險指令碼）；增加：使用者上傳攔截與技能內部生成豁免白名單；增加：engine/hardware.py 硬體自適應效能排程（自動採集 CPU/記憶體，自動分配併發子程序數與批次分塊）；增加：本地 OCR 模組 engine/local/ocr.py（優先本地 Tesseract，降級雲端，給安裝指引）；增加：能力邊界與失敗場景專章；增加：自然語言觸發示例專章；增加：完整場景案例專章（5 個端到端場景）；增加：FAQ 專章（8 個高頻問題）；補齊：缺失參考文件 et_references.md/office_references.md/rate_limit.md；補齊：技能圖示 assets/icon.png；補齊：engine/__init__.py 與 engine/api/mcp_server.py（真實 MCP Server 入口）；最佳化：MCP Server 深度直連金山文件開放平臺原生 API；最佳化：每日更新提醒 + 反饋郵箱 njskills@agent.qq.com | | v2.3.0 | 2026-07-05 | 增加：智慧文件/思維導圖/流程圖 3 品類，品類總數 6→9；增加：本地 Tesseract OCR；增加：網頁剪藏；增加：HTML 一鍵上雲；最佳化：MCP 服務拆分 1→4，獨立限流/降級 | | v2.1.0 | 2026-07-02 | 增加：每日自動更新檢查；增加：純文本提取 API；增加：多維表 Webhook 事件監聽；增加：批次非同步任務；增加：SKILL.md 首次使用必讀引導 | | v2.0.0 | 2026-07-02 | 初始版本釋出：6 品類 + 40+ MCP 工具 + 5 層安全防禦 |

22. 詳細文件參考

23. 安裝說明

前置要求：Python 3.10+；雲端功能需金山開放平臺 App（免費）；OCR 可選裝 Tesseract。

# Linux / macOS
bash setup.sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File setup.ps1

安裝後重啟 WorkBuddy 生效。本地生成/OCR/硬體畫像無需任何配置即可用。

24. 📮 反饋與建議

本技能持續迭代。有任何功能建議、問題或更好的實現思路，歡迎反饋：

📧 有更好建議：njskills@agent.qq.com

也可在每日更新提醒中一鍵檢視新版本。

25. ❓ FAQ（v3.0.0 新增）

Q1：沒有金山 App Key 能用嗎？ 能。本地生成 DOCX/PPTX、思維導圖/流程圖 SVG、本地 OCR、硬體畫像均零金鑰可用； 僅「上傳雲端/多人協作/回收站/版本」等聯網能力需 Key。

Q2：為什麼刪除前要確認？ 防止誤操作。刪除進回收站可恢復；「徹底刪除」「清空回收站」為不可逆操作，需二次確認（見第 6 節）。

Q3：OCR 一定要裝 Tesseract 嗎？ 首選本地 Tesseract（免費、離線、無 key）。未裝時自動降級雲端 OCR（需 Key），都無則給出安裝指引，不崩潰。

Q4：大檔案傳不上去？ 超過閾值（預設 100MB，低端機 50MB）會自動轉非同步上傳 + 輪詢；仍失敗請壓縮或分卷。

Q5：會不會把我的電腦拖卡？ 不會。技能自動按本機硬體分配併發子程序數（見第 17 節），批次/渲染均受限。

Q6：報 KD009 檔案被攔截？ 你上傳的檔案屬於禁止型別（見第 18 節）。技能自身生成的 docx/pptx/pdf/svg 等不受影響。

Q7：如何升級？ 每天首次使用會自動提醒；也可 python -m engine.update_check --version 3.0.0 --reminder。

Q8：文字/演示文件能改其中一段嗎？ 當前為整檔案替換模式：本地改原始檔→重新上傳覆蓋。逐段精細編輯需金山線上編輯器。

最後更新：2026-07-12 | v3.0.0

這個 Skill 做得相當專業，文件詳細、功能齊全、操作安全。它對檔案上傳有嚴格的安全檢查，危險操作會強制確認，不會誤刪資料，還能根據電腦配置自動調整效能，不容易卡死。不過首次配置稍顯複雜，部分功能的實際效果可能不如描述的那麼強大，細節打磨上還有提升空間。總體質量良好，適合需要深度管理金山文件的使用者。