金山文档

金山文档 是什么

金山文档是官方 kdocs-cli Skill，覆盖 WPS 云文档的创建、读取、编辑、搜索、分享、移动和整理。它支持智能文档、Word、Excel、PDF、PPT、智能表格、多维表格、表单与个人知识库，并提供网页剪藏、接龙转表格、AI PPT、翻译和批量汇报等工作流。

适用场景与不适用场景

适合周报、合同与发票处理、信息收集、文档总结、表格美化和知识库整理。当前发布说明表示仅支持个人账号，不再支持企业账号。高频批量写入、复杂权限和不可逆删除必须按参考文档执行。

核心能力与工作机制

kdocs-cli 以 service/action 调用。可创建空白或带内容文件、上传本地文件、按链接或 ID 读取、管理分享权限、评论、标签、版本与回收站；多维表覆盖字段、记录、视图、表单、权限和 webhook。写入后必须独立回读验证，并展示可访问链接。

实际工作流与产物

首次或超过 24 小时先检查 CLI 与 Skill 版本。根据文件类型路由到对应 references，未知类型先定位。中文、多行或复杂 JSON 使用 UTF-8 文件或 stdin，不能用易破坏编码的 key=value。创建或写入后查询结果，删除和关闭类操作先确认。

安装、依赖与权限

需要 kdocs-cli 和个人金山文档 Token。Token 只能通过登录或 set-token 进入系统密钥链，不得出现在对话、日志、代码或文件。大体积 base64 必须由脚本生成，不能在对话中展开。

限制、风险与使用建议

429001 要等到恢复时间，429002 熔断期内必须零请求；非幂等创建超时后先查询再重试，避免重复。并发写同一资源可能冲突，应指数退避并串行。接口很多，必须读对应 reference，不能凭概要猜参数。

上手建议

先用 auth status 与版本检查确认环境，再从读取或新建测试文档开始。给出明确文件链接、目标区域和预期结果；修改前保存版本，修改后回读并打开链接核验。权限、分享与删除要最小化范围。

来源、版本与许可

依据 SkillHub 2.5.29 详情、完整 17KB Skill 与文件清单整理。平台标记 community、非 verified，未声明许可证；安全报告为扫描信号。

常见问题

1. 支持哪些账号？

当前 2.5.29 发布信息说明仅支持个人账号，不再支持企业账号。企业组织空间、权限或专属域名场景不要假设可用。

2. Token 应如何保存？

只能通过 kdocs-cli auth login 或 auth set-token 写入系统密钥链，禁止放进对话、日志、命令输出、代码注释、临时 JSON 或版本库。

3. 写操作成功后还要做什么？

必须用独立读取请求回查实际内容，不能只相信 code 0；创建文件还要返回可访问链接，没有 link_url 时调用 get_file_link。

4. 中文长文本如何传参？

使用 UTF-8 JSON 文件或 stdin，避免 PowerShell key=value 破坏编码。复杂对象要传完整参数对象，完成后清理临时文件。

5. 遇到限频怎么办？

429001 立即停到响应给出的恢复时间；429002 在整个熔断期保持零请求。不能连续换参数重试，否则会延长故障。

6. 超时后可以直接重试创建吗？

不可以先假设失败。创建和写入可能已经在服务端完成，应先搜索或读取确认，再按工具幂等性决定是否重试，避免重复文件。

7. 可以删除文件或权限吗？

可以，但 delete、close、取消分享和批量删除等不可逆操作必须先向用户确认目标与范围，并在完成后查询验证结果。

8. 为什么必须阅读 references？

主指南只负责路由，具体类型、枚举、约束和幂等性位于 91 个文件中的对应参考。凭概要拼命令容易写错资源或权限。