核心用法
金山文档CLI Skill是WPS官方推出的云文档操作工具，通过kdocs-cli命令行与金山文档API交互。核心能力包括：
文档全生命周期管理：支持智能文档(.otl)、Word(.docx)、Excel(.xlsx)、PDF(.pdf)、PPT(.pptx)、智能表格(.ksheet)、多维表格(.dbt)等主流格式的创建、读取、编辑、搜索、分享、移动和删除操作。
智能办公场景：集成AI生成演示文稿(aippt)、网页剪藏保存、接龙文本自动转表格、信息收集表单生成、文档智能总结与内容改写、多语言翻译等高级功能。
知识库管理：支持个人知识库的空间管理、内容导入、智能分类整理和碎片笔记归档。
命令规范：采用kdocs-cli <service> <action>格式，支持key=value、JSON字符串、--file文件输入、stdin管道等多种参数传递方式，中文及复杂内容必须使用JSON文件或stdin避免编码问题。
显著优点
- 官方原生集成：WPS官方出品，与金山文档云服务深度整合，API稳定性有保障
- 多模态文档支持：覆盖办公场景全部文档类型，从传统Office到智能文档、多维表格、表单等新型格式
- AI能力内置：无需额外配置即可调用AI生成PPT、文档总结、内容改写、翻译等能力
- 安全机制完善：Token强制走系统密钥链管理，禁止明文暴露；不可逆操作强制确认；写操作强制回读验证
- 版本自更新：内置CLI和Skill版本自检机制，支持自动升级和故障回滚
- 幂等性标注：每个工具明确标注幂等性，指导安全重试策略
潜在缺点与局限性
- 网络依赖严格：所有操作依赖云端API，无离线能力
- 限频熔断机制：高频操作易触发429001/429002限频，需严格遵循恢复时间等待
- Windows编码陷阱：PowerShell环境下中文参数必须使用JSON文件输入，直接传参必现编码错误
- 超时敏感：大文件上传、AI生成、格式转换等操作需手动调高超时参数（默认30秒常不足）
- 索引延迟：新创建文件搜索可见存在3-5秒延迟
- 版本兼容风险：CLI与Skill版本需严格匹配，版本漂移会导致
unknown action错误
适合人群
- 需要批量处理云文档的自动化办公用户
- 构建文档工作流的技术团队（周报自动生成、合同批量处理等）
- 重度金山文档/WPS用户，需突破网页端功能限制
- 需要将网页内容、聊天记录等外部信息结构化入库的知识管理者
常规风险
| 风险类型 | 说明 | 规避建议 |
|---------|------|---------|
| 数据误删 | delete/close类操作不可逆 | 强制二次确认，关键操作先备份 |
| Token泄露 | 凭证管理不当导致账号风险 | 绝对禁止日志/对话中打印Token，仅用密钥链 |
| 重复创建 | 非幂等工具重试导致脏数据 | 写操作后先查询确认状态再决定是否重试 |
| 编码损坏 | Windows PowerShell中文参数乱码 | 复杂参数一律走--file或stdin |
| 服务熔断 | 高频请求触发限流 | 429错误立即停止，等待指定恢复时间 |