核心用法
金山文档 CLI Skill 是金山办公官方推出的命令行工具，通过 kdocs-cli 与云端 API 交互，实现对 WPS 云文档 / Kdocs 平台的全方位操作。核心能力覆盖：
文档操作：支持智能文档(.otl)、Word(.docx)、Excel(.xlsx)、PDF(.pdf)、PPT(.pptx)、智能表格(.ksheet)、多维表格(.dbt)等主流格式的创建、读取、编辑、导出与分享。提供 create_file_with_content、upload_file、read_file 等原子能力，以及 AI PPT 生成、网页剪藏、接龙转表格等高阶工作流。
知识管理：集成个人知识库(Kwiki)与智能表单，支持碎片笔记整理、标签分类归档、收藏管理及回收站还原。
协作功能：文档分享权限控制、历史版本管理、评论互动、Webhook 集成等。
显著优点
1. 官方原生支持：由金山办公官方维护，API 稳定性与兼容性有保障
2. 全格式覆盖：从传统 Office 文档到新一代智能文档/多维表格，格式支持最完整
3. AI 深度集成：内置 aippt.execute 支持 AI 一键生成演示文稿，覆盖主题创作与内容排版
4. 企业级安全：Token 由系统密钥链管理，Skill 无状态不缓存业务数据
5. 工作流丰富：提供 10+ 官方工作流模板，如网页剪藏、接龙转表格、表格美化等
潜在缺点与局限性
1. 网络依赖性强：所有操作需实时连接云端，离线场景不可用
2. 版本兼容风险：CLI 与 Skill 版本需严格匹配，升级不及时会导致功能异常
3. 中文编码限制：Windows/PowerShell 环境下中文参数需特殊处理（JSON 文件或转义）
4. 速率限制：存在 429001 限频与 429002 熔断机制，高频批量操作需主动控速
5. 大文件处理复杂：Base64 编码后超过 1MB 的内容禁止在对话中生成，需脚本中转
适合人群
- 职场办公族：日报/周报撰写、合同处理、信息收集、PPT 制作
- 团队协作管理员：文档权限管理、知识库建设、表单发布与数据汇总
- 开发者/自动化运维：通过 CLI 实现文档批处理、定时备份、工作流自动化
- 内容创作者：网页剪藏、碎片整理、AI 辅助内容生成
常规风险
- 数据误删风险：
delete类操作不可逆，执行前强制确认机制虽存在，但脚本批量操作时仍需人工复核 - Token 泄露风险：虽明文禁止出现在日志中，但用户手动配置时仍存在误操作可能
- 并发写入冲突：知识库节点、多维表记录等存在锁竞争，需指数退避重试
- 云端服务可用性：依赖金山文档平台稳定性，5xx 错误需重试恢复
安全评估
- 凭据管理：Token 由系统密钥链托管，Skill 不存储
- 数据隐私：无状态设计，不缓存文档内容
- 操作审计：用户主动触发模式，无后台静默行为