核心功能
金山文档 CLI Skill 是 WPS 云文档官方命令行工具，提供完整的在线文档生命周期管理能力。核心功能覆盖：
- 文档创建与写入：支持智能文档(.otl)、Word(.docx)、Excel(.xlsx)、PPT(.pptx)、PDF、智能表格(.ksheet)、多维表格(.dbt)、智能表单(.form)等 8 大类型
- 内容操作：读取、编辑、批量更新、格式转换、AI 生成内容、翻译、总结改写
- 文件管理：搜索定位、移动重命名、标签分类、收藏归档、回收站管理、分享协作
- 高级能力：网页剪藏、接龙转表格、AI PPT 生成、知识库管理、Webhook 集成
显著优点
1. 官方原生：金山办公官方出品，API 稳定性与文档格式兼容性最佳
2. 类型全面：唯一同时支持传统 Office 格式与新一代智能文档/多维表格的云端方案
3. AI 深度融合：内置 AI 写作、AI PPT、内容总结、智能翻译等生成能力
4. 协作原生：所有文档实时云端同步，天然支持多人协作与权限管理
5. 自动化友好：CLI 工具支持脚本集成、stdin/JSON 参数传递，适合批量处理
潜在局限
- 网络依赖：纯云端服务，离线无法使用
- Token 管理：需手动配置或登录获取 Token，企业场景需额外权限申请
- 限频熔断：高并发场景存在 429 限频/熔断机制，需合理规划调用频率
- 格式限制：部分复杂本地 Office 特性（如宏、复杂样式）云端不完全支持
- 验证延迟：写入后需独立读取验证，存在秒级延迟
适合人群
- 需要批量处理文档的自动化办公用户
- 追求AI 辅助创作（PPT/写作/总结）的知识工作者
- 团队协作场景下的文档管理员与信息架构师
- 需将云文档能力集成到工作流的开发者与效率极客
- 使用金山文档/WPS 云文档作为主要办公套件的企业用户
常规风险
| 风险类型 | 说明 | 防护建议 |
|---------|------|---------|
| 凭据泄露 | Token 明文暴露在日志/代码中 | 严格使用 `kdocs-cli auth` 命令，禁止硬编码 |
| 误删数据 | 不可逆操作未确认 | 所有 delete/close 类操作强制二次确认 |
| 重复创建 | 非幂等工具重试导致重复文档 | 重试前先查询验证状态 |
| 大文件超时 | 上传/AI 生成超时失败 | 显式设置 `--timeout` 参数，确认幂等后重试 |
| 版本不兼容 | CLI 与 Skill 版本不匹配 | 首次使用及报错时执行「保持最新版本」流程 |