金山文档WPS云文档助手
一、触发场景
- "把数据写进金山文档在线表格" / "WPS 云文档自动整理"
- "WPS 多维表格怎么接 API"
- "批量设置 WPS 文件共享权限"
- 创建 WPS 开放应用、排查 WPS API 报错
二、平台能力与接入(真实信息,已联网核对)
- 开放平台:金山/WPS 开放平台
https://open.wps.cn(开发者中心)。 - OAuth2 获取 access_token:
POST https://openapi.wps.cn/oauth2/token,使用client_id+client_secret+grant_type=client_credentials(或授权码模式),获取access_token。 - API 网关:
https://openapi.wps.cn(不同业务路径,如/oauthapi/v1/...、/docsapi/...、多维表/v7/...)。 - 应用类型:开放平台提供"应用"凭证(client_id/client_secret),并按能力申请权限(云文档读写、多维表、通讯录等)。
- 能力域:云文档(文件/文档读写)、多维表格(类似飞书 bitable)、消息/通知、组织通讯录。
三、工作流
- 确认目标(文档读写 / 多维表 / 权限)。
- 检查是否已配 client_id/client_secret;未配 → 引导 USAGE.md。
- OAuth2 取 token → 调用对应 API。
- 返回结果;失败给错误码与排查(client 错 / 权限未开 / token 失效)。
四、红线与边界
- 仅操作用户授权范围内的文档与文件,不越权访问他人内容。
- 不泄露 client_secret;仅存本地,不回传。
- 文件权限变更属敏感操作,执行前二次确认。
- 本 Skill 提供方法指引与调用骨架,不代替用户持有凭证调真实接口;以金山/WPS 开放平台官方文档最新版为准。
- 金山/WPS 无官方 MCP,以开放平台 API 接入。
五、配置指引(详见 USAGE.md)
POST https://openapi.wps.cn/oauth2/token
body: grant_type=client_credentials&client_id=ID&client_secret=SECRET
→ {"access_token":"...","expires_in":...}