金山文档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

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

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

Xiaoye