核心用法
金山文档 CLI Skill 是通过 kdocs-cli 命令行工具与金山文档云服务交互的官方解决方案，支持完整的在线文档操作链路。核心能力涵盖：
文档全生命周期管理：创建智能文档(.otl)、Word(.docx)、Excel(.xlsx)、PPT(.pptx)、PDF、智能表格(.ksheet)、多维表格(.dbt)、智能表单(.form)等 8 大类型；支持云端新建、读取、编辑、搜索、分享、移动、标签归档、回收站还原等操作。
AI 能力集成：内置 AI PPT 生成（全文/单页模式）、文档总结、内容生成、改写仿写、翻译、网页剪藏等智能功能，可直接将接龙文本转为结构化表格，或基于需求自动生成信息收集表单。
知识库管理：支持个人知识库的空间管理、内容导入、智能整理与一键存入，实现碎片笔记的结构化重组。
工作流自动化：提供 15+ 标准化高频流程，包括搜索-读取-汇报撰写、定期读取播报、智能分类整理、精准搜索风险排查、表格美化与数据规范等。
调用采用 kdocs-cli <service> <action> [参数] 格式，支持 key=value、JSON 字符串、--file 文件及 stdin 四种传参方式；中文/多行/超长内容强制使用 --file 或 stdin 以避免编码问题。
显著优点
1. 官方原生能力：由金山办公官方提供，API 稳定性与数据安全性有保障，Token 由系统密钥链托管，Skill 无状态不缓存敏感数据。
2. 格式覆盖全面：从传统 Office 三件套到智能文档/表格/多维表格/表单等创新形态，再到 PDF 专业处理，满足多元场景。
3. AI 深度融合：AI PPT 生成支持 HTML 布局与经典简约双模式；文档总结、改写、翻译等能力直接嵌入工作流。
4. 协作场景优化：接龙转表格、信息收集表单、网页剪藏等功能精准解决中文办公痛点。
5. 工程化设计：严格的版本自检机制（24h 周期/错误触发）、幂等性约束、不可逆操作确认、写后验证等机制保障操作可靠性。
潜在缺点与局限性
1. 网络依赖强：所有操作依赖云服务，离线不可用；大文件上传/导出/AI 生成易出现 Client.Timeout 需手动重调超时参数。
2. 平台兼容性限制：Windows/PowerShell 环境下中文参数传递存在 UTF-8 编码陷阱，强制要求使用 --file 或 stdin 规避。
3. 限流与熔断机制：高频操作触发 429001/429002 错误后需等待恢复时间，批量任务需自行编排速率。
4. 格式转换边界：部分复杂排版（如 PPT 动画、Excel 宏）在跨格式操作中可能丢失或降级。
5. Token 管理成本：用户需自行完成 OAuth 登录或手动配置 Token，多设备切换时需重复认证。
适合人群
- 职场办公人群：需高频撰写周报日报、处理合同发票、制作培训课件的项目经理、行政、市场、HR。
- 知识管理爱好者：依赖网页剪藏、碎片整理、标签归档构建第二大脑的个人用户。
- 团队协作组织者：需要快速发起信息收集、报名表、登记表并进行数据汇总的小团队负责人。
- 自动化进阶用户：希望通过 CLI 将文档操作集成到脚本流水线、CI/CD 或定时任务的技术人员。
常规风险
1. 误删除风险：delete/close 类操作不可逆，虽强制确认但仍需用户仔细核对目标。
2. 数据覆盖风险：写操作后需独立读取验证，网络异常可能导致"成功响应但实际未写入"。
3. Token 泄露风险：虽禁止明文出现在对话/日志中，但用户若违规复制粘贴仍可能造成凭证暴露。
4. 版本不兼容风险：CLI 与 Skill 版本不匹配会导致 unknown action 或接口异常，需严格遵循自检升级流程。
5. 服务连续性风险：依赖金山文档云服务可用性，极端情况下（服务熔断、区域故障）可能影响业务连续性。