name: kdocs description: "操作金山文件（WPS 雲文件 / Kdocs / 365.kdocs.cn / www.kdocs.cn）雲文件的官方 Skill。核心能力覆蓋雲端新建、讀取、編輯、搜尋、分享、整理線上文件（智慧文件、Word、Excel、PDF、PPT、簡報、智慧表格、多維表格）及個人知識庫。當用戶的任務涉及雲文件操作時使用，包括但不限於：寫週報/日報/工作彙報、處理合同/發票、建立報名表/登記表、網頁剪藏、接龍轉表格、資訊收集、文件總結與內容生成、改寫仿寫、翻譯、AI PPT生成、PDF拆分匯出、標籤分類歸檔、收藏管理、碎片筆記整理、表格美化、回收站還原、知識庫管理。" homepage: https://www.kdocs.cn/latest version: 2.5.29 metadata: {"requires":{"bins":["kdocs-cli"],"cliHelp":"kdocs-cli --help"},"openclaw":{"category":"kdocs","tokenUrl":"https://www.kdocs.cn/latest","emoji":"📝","keywords":["金山文件","金山表格","金山收藏","WPS","WPS文件","雲文件","線上文件","kdocs","WPS雲文件","接龍轉表格","接龍","群接龍","報名表","資訊收集","收集表","登記表","網頁剪藏","剪藏","儲存網頁","網頁儲存到文件","儲存文章","收藏文章","總結","幫我總結","幫我整理","幫我寫","幫我翻譯","幫我做PPT","翻譯文件 - 做PPT - 生成PPT - 培訓課件 - 方案展示 - 專案展示","文件總結","內容生成","改寫","仿寫","翻譯","文件翻譯","PPT","簡報","幻燈片","PDF","拆分PDF","匯出PDF","Word","Excel","表格","Markdown","碎片整理","筆記整理","表格最佳化","文件處理","檔案處理","辦公助手","文件助手","週報","日報","工作彙報","合同","發票"]},"file_types":["pdf","doc","docx","xlsx","xls","pptx","ppt","otl","ksheet","dbt","form","jpg","jpeg","png","bmp","gif","webp","url","md","txt","html"],"category":"productivity"}

金山文件 CLI Skill 使用指南

金山文件 CLI Skill 提供了一套完整的線上文件操作工具，通過 kdocs-cli 命令列工具與金山文件 API 互動。支援建立、查詢、讀取、編輯、分享、移動多種型別的線上文件。

嚴格規則

禁止（NEVER）

• 禁止將 Token 明文出現在對話、日誌、命令輸出、程式碼註釋或任何檔案中；Token 僅允許通過 kdocs-cli auth set-token 或 kdocs-cli auth login 儲存到系統金鑰鏈

  發現更多技能外掛，請訪問7w4.net。

• 上傳寫入等介面需傳入的 content_base64 可能非常大（編碼後 >1 MB），禁止在對話中逐 token 生成 Base64 字串，用指令碼完成檔案讀取、編碼和傳參

必須（MUST）

• 不可逆操作（delete/close 類）執行前必須向用戶確認
• 寫操作完成後必須用獨立讀取請求驗證實際結果（不信任 code: 0）
• 建立雲文件檔案並驗證通過後，必須向用戶展示可訪問連結。若響應包含 data.link_url 則直接展示；若響應無連結時，呼叫 get_file_link 獲取並展示。
• 呼叫工具前必須先閱讀對應的 references/ 詳細參考文件，禁止僅憑指南（guide）的概要說明直接拼裝呼叫；引數細節（型別、可選值、約束）以工具參考文件為準

保持最新版本

何時觸發：首次使用 Skill / 距上次自檢 >24h / 收到 unknown action 或 unknown service 錯誤。

1. CLI 版本：kdocs-cli version — 若命令不存在則按下方「工具安裝與認證」安裝；若低於本檔案 frontmatter version，執行 kdocs-cli upgrade -y（自動備份舊版本，失敗可 kdocs-cli upgrade --rollback）
2. Skill 版本：若本檔案 version 低於 kdocs-cli version，執行 kdocs-cli call check_skill_update version=2.5.29 skill_name=kdocs，若返回 update_available: true，從 instruction 中提取 zip 下載連結，下載解壓替換當前 Skill 目錄

若 upgrade 和 rollback 均失敗，在本 Skill 目錄下重新執行安裝指令碼（bash setup.sh / powershell setup.ps1 / node setup.cjs，指令碼位於 scripts/）可從 CDN 重新安裝。若仍無法更新，以 kdocs-cli --help 實際支援的工具集為準。

工具安裝與認證

login 失敗時的手動獲取流程、auth status 診斷、auth logout 退出等詳見 references/auth.md。

呼叫格式

kdocs-cli [引數]

引數傳遞

• --file / stdin 輸入必須是該工具的完整 JSON 引數物件
• 中文/多行引數禁止 key=value（Windows/PowerShell 破壞 UTF-8 編碼）
• 生成 JSON 檔案用 Node.js/Python；禁止 ConvertTo-Json（輸出帶 BOM）
• PowerShell 傳 JSON 字串須反斜槓轉義：'{\"key\":[\"val\"]}'

--file 示例：寫入大段內容時，用指令碼生成 JSON 檔案再 --file 傳入，操作完成後刪除臨時檔案：

javascript const fs = require('fs'); fs.writeFileSync('payload.json', JSON.stringify({ file_id: "<file_id>", content: fs.readFileSync('article.md', 'utf8'), format: "markdown", mode: "append" }), 'utf8'); kdocs-cli otl insert-content --file payload.json --silent javascript // 操作完成後清理臨時檔案 fs.unlinkSync('payload.json');

全域性選項：

幫助：kdocs-cli --help、kdocs-cli <service> --help、kdocs-cli <service> <action> --help

找不到命令？ 瀏覽 --help 時若發現預期的 service 或 action 不存在，先執行 kdocs-cli upgrade -y 升級到最新版本再重試。CLI 能力隨版本持續擴充套件，未升級是命令缺失的首要原因。詳見上方「保持最新版本」章節。

以下工具不可逆，呼叫前必須向用戶確認（詳細約束見各工具參考文件的「操作約束」區）：

otl.block_delete、dbsheet.delete_sheet、kwiki.close_knowledge_view、sheet.delete_sheets、sheet.delete_range_data、dbsheet.delete_view、dbsheet.delete_fields、cancel_share、kwiki.delete_item、sheet.delete_protection_ranges、dbsheet.delete_records、sheet.delete_data_validations、cancel_collaborator_permissions、sheet.delete_conditional_format_rules、sheet.delete_float_images、sheet.delete_filters、dbsheet.sheet_batch_delete、sheet.delete_pivot_table、dbsheet.permission_delete_roles_async

能力範圍

操作域路由

Agent 首先判定使用者請求的操作域：

進入「區域性更新」「型別專屬能力」且字尾/型別未知時：先按 references/file-locating-guide.md 確認型別，再開啟對應型別 reference；勿猜測呼叫。讀取/建立/檔案管理不必先調。

支援的文件型別

高頻流程指引

建立/寫入

字尾不確定時預設 .otl。指定資料夾時先按 references/file-locating-guide.md 取 drive_id、parent_id。

選定工具後，閱讀 references/drive/create_and_upload.md 對應章節獲取引數約束（aippt.execute 見 references/aippt.md）。

搜尋定位文件

工具說明：search_files(keyword="關鍵詞") 即可搜尋（type 可省略，預設 all）；獲取 file_id、drive_id 供後續鏈路使用。 type 為搜尋維度（file_name/content/all），篩選資料夾/檔案請用 file_type。 詳細引數與返回結構見 references/drive/search.md。

更多操作流程

錯誤速查

安全約束

• 憑據由 kdocs-cli 系統金鑰鏈管理，Skill 自身不儲存、不記錄
• 無狀態代理，不快取任何文件內容或業務資料
• 僅在使用者主動發起操作時呼叫對應 API

金山文件 Skill（kdocs skill）問題反饋

當滿足以下任一條件時，生成反饋連結並提供給使用者：

1. 錯誤速查表中的處理方式（重試、保持最新版本等）均已嘗試但問題仍未解決
2. 使用者主動要求反饋或投訴

執行 kdocs-cli feedback 獲取反饋連結，將完整連結展示給使用者並告知"點選即可開啟反饋頁面"，由使用者決定是否開啟。

這個 Skill 做得相當專業，文件覆蓋了金山文件的幾乎所有功能，操作指引詳細，錯誤處理說明也很完善，普通人照著文件使用基本不會踩坑。不足之處在於文件數量偏多，某些流程說明較長，需要耐心閱讀；部分操作步驟較多，簡化常用場景的呼叫路徑可進一步提升易用性。整體而言是一款質量較高、功能完整的雲文件管理 Skill。