金山文檔WPS雲文檔助手:用 Agent Skill 對接 WPS 開放平臺 API

前言

在自動化辦公里,金山文檔、WPS 雲文檔和多維表格往往承擔協同與數據沉澱;若要在腳本或 Agent 裏讀寫文件、改權限、驅動多維表格,通常要對着 WPS 開放平臺文檔查接口、拼鑑權、處理協同與共享規則。手工對接成本高,也容易在權限模型上踩坑。

下面介紹 SkillHub 上的社區 Skill「金山文檔WPS雲文檔助手」(座標 @user_af163eaa/z-wps-cloud-docs,當前版本 v1.0.1)。它把「何時該用 WPS 開放能力」寫進 Skill 觸發條件,並引導通過金山/WPS 開放平臺 API 完成雲文檔讀寫、多維表格協同以及文件權限與共享管理。

這是什麼

「金山文檔WPS雲文檔助手」是面向辦公效率(分類 office-efficiency)的 Agent Skill,來源爲社區(community),由發佈者 user_af163eaa 維護;SkillHub 頁面展示作者爲「大智JiYoo」。

一句話定位:當對話涉及金山文檔或 WPS 雲側能力時,由 Agent 按 Skill 指引調用開放平臺 API,而不是讓用戶自行翻文檔拼請求。

官方入口:

  • Skill 資源地址:https://api.skillhub.cn/user_af163eaa/z-wps-cloud-docs
  • SkillHub 展示頁:https://www.skillhub.cn/skills/user_af163eaa/z-wps-cloud-docs

SkillHub 元數據標註 requires_api_key=true,表示實際調用依賴你在 WPS 開放平臺側申請的應用與 API 憑證;具體環境變量或配置項以安裝後技能目錄內的 SKILL.md 爲準。

核心功能

以下能力均來自 SkillHub 簡介與頁面描述,未單獨展開未公開的接口清單。

  1. 雲文檔自動讀寫
    通過金山/WPS 開放平臺 API,對雲文檔進行程序化的讀取與寫入,用於報表歸檔、內容同步等場景。

  2. WPS 多維表格協同
    圍繞「WPS 多維表格」相關需求,藉助開放 API 參與表格側的協同與數據操作(具體接口以開放平臺文檔及 Skill 內指引爲準)。

  3. 文件權限與共享管理
    處理「WPS 文件權限」、共享與協同編輯相關的開放能力,減少在控制台手工改權限的次數。

  4. 觸發詞覆蓋常見表述
    當用戶提到金山文檔、WPS、WPS 365、WPS 雲文檔、WPS 開放平臺、WPS 多維表格、WPS 文件權限、WPS 協同編輯時,Agent 應優先啓用本 Skill。

安裝與啓用

安裝流程遵循 SkillHub 官方說明文檔 skillhub.md。先做 CLI 檢查,再把技能裝進當前 Agent 的 skills 目錄。

1、安裝 SkillHub CLI(如尚未安裝)

檢查是否已安裝:

command -v skillhub && skillhub --version

未安裝時可執行完整安裝(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

2、安裝本 Skill

SkillHub 頁面給出的安裝提示爲:請根據 https://skillhub.cn/install/skillhub.md,安裝 @user_af163eaa/z-wps-cloud-docs。

命令行方式需使用 --dir 指向當前 Agent 的 skills 目錄,否則默認會裝到 ./skills/ 而可能不被識別:

skillhub install user_af163eaa/z-wps-cloud-docs --dir <你的 Agent skills 目錄>

常用客戶端 skills 路徑(摘自 skillhub.md):

  • Claude Code:~/.claude/skills/
  • Cursor:~/.cursor/skills/
  • Codex:~/.codex/skills/ 或項目下的 .agents/skills/

在 Cursor 中可示例爲:

skillhub install user_af163eaa/z-wps-cloud-docs --dir ~/.cursor/skills/

安裝完成後,按 SkillHub 說明重啓或刷新 Agent,使新 Skill 被加載;再閱讀技能包內 SKILL.md 完成 WPS 開放平臺 API Key 等配置。

也可將下面提示詞直接發給支持 Skill 的 AI,由其按官方安裝文檔完成安裝:

請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_af163eaa/z-wps-cloud-docs`。

典型用法

公開資料未附帶獨立腳本示例,典型用法分兩層:安裝啓用,以及在對話中用已列出的產品關鍵詞描述任務。

安裝啓用:使用上一節的 skillhub install 或安裝提示詞,確保 Agent 已加載 @user_af163eaa/z-wps-cloud-docs。

對話中發起任務(表述需與 Skill 簡介中的場景一致,由 Agent 結合 SKILL.md 與開放平臺 API 執行),例如:

幫我在 WPS 雲文檔裏讀取指定文檔內容,並寫回更新後的段落。
需要通過 WPS 開放平臺調整某文件的共享權限,並說明 WPS 文件權限相關接口該怎麼調。
在 WPS 多維表格裏批量同步一列數據,走開放平臺 API,不要手工在網頁裏改。

具體請求路徑、鑑權方式與參數以 WPS 開放平臺官方文檔及本 Skill 包內說明爲準;Agent 的作用是減少你從零拼裝調用鏈的時間。

適用場景與注意

適合誰

  • 已在用金山文檔 / WPS 365 / WPS 雲文檔做協同,希望用 API 做讀寫、權限或多維表格自動化的人。
  • 使用 Cursor、Claude Code、Codex 等支持 Skill 的客戶端,並願意在 SkillHub 安裝社區技能的開發者。

使用注意

  1. API 憑證:SkillHub 標籤 requires_api_key=true,須先在 WPS 開放平臺創建應用並拿到合法憑證;勿把 Key 寫進公開倉庫。
  2. 社區來源:source: community,行爲與維護節奏取決於發佈者,升級前可在 SkillHub 查看版本(當前 v1.0.1)。
  3. 安裝目錄:務必 --dir 指向當前 Agent 的 skills 目錄,否則技能可能不會被加載。
  4. 數據與權限:文件權限、共享、協同編輯涉及企業數據安全,生產環境調用前應在測試租戶驗證 scope 與審計要求。

SkillHub 統計(以抓取資料爲準):評分 100000,下載 13834 次,分類 office-efficiency。

結尾

「金山文檔WPS雲文檔助手」把 WPS 雲文檔、多維表格、權限與協同等高頻表述收斂成 Skill 觸發條件,並圍繞金山/WPS 開放平臺 API 組織自動化讀寫與管理流程。若你正在把辦公文檔能力接進 Agent 工作流,可從官方地址獲取並安裝:

https://api.skillhub.cn/user_af163eaa/z-wps-cloud-docs

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜