核心用法
金山文档 Skill 是基于 kdocs-cli 命令行工具构建的官方云文档操作能力，深度整合金山办公 WPS 生态，覆盖智能文档（.otl）、表格（.xlsx/.ksheet）、多维表格（.dbt）、PDF、Word、PPT 等全格式云端生命周期管理。
高频操作场景：
- 内容创建：对话内容一键落库（
create_file_with_content）、本地文件云端同步（upload_file）、AI 智能生成 PPT（aippt.execute） - 智能处理：网页剪藏自动归档、接龙文本转结构化表格、信息收集表单自动生成、文档内容 AI 总结/改写/翻译
- 协作管理：精细权限分享、标签分类归档、回收站还原、历史版本追溯、知识库空间搭建
- 数据运营：表格美化与条件格式、数据校验规则固化、多维表视图切换（表格/看板/甘特）
调用范式：kdocs-cli <service> <action> [参数]，支持 key=value、JSON 字符串、--file 文件输入、stdin 管道四种参数传递模式，适配简单查询到复杂脚本流水线集成。
显著优点
1. 格式全覆盖，智能文档为核：业内罕见的全格式支持（20+ 文件类型），智能文档（.otl）作为首选格式，排版美观且支持丰富交互组件，替代传统 Word/Excel 成为知识管理新范式
2. AI 原生整合：内置 AI PPT 全文/单页生成、文档智能总结、内容改写仿写、多语言翻译，无需切换工具即可完成"从想法到成品"
3. 企业级协作基建：多维表格支持多视图、字段级权限、Webhook 集成；知识库支持父子记录、高级权限、智能分类整理，满足从个人到团队的规模化协作
4. 安全机制严谨：Token 强制走系统密钥链，禁止明文泄露；所有不可逆操作前必须用户确认；写操作强制回读验证，不信任单一返回码
5. 错误治理体系完善：限频/熔断机制明确（429001/429002）、版本自检测升级、幂等性工具标注、指数退避重试策略，生产环境稳定性有保障
潜在局限
- 网络依赖强：所有操作云端执行，弱网/离线场景不可用；大文件上传/AI 生成偶现超时需手动重试
- Windows 中文编码陷阱：PowerShell 传中文参数必须用
--file或 stdin，key=value 模式易触发 UTF-8 编码破坏 - 版本同步成本：Skill 与 CLI 版本需双向校验，过期版本会导致接口不兼容，需主动执行升级流程
- 冷启动索引延迟：新建文件后搜索定位可能存在 3-5 秒延迟
适合人群
- 职场效率党：周报/日报/汇报文档自动化生成，告别重复排版
- 团队协作者：项目看板、多维表格权限管理、知识库沉淀，替代 Notion/Airtable 国产方案
- 内容创作者：网页剪藏、碎片笔记整理、AI 辅助写作与 PPT 生成
- 数据管理员：表格标准化、接龙数据结构化、表单收集与自动归档
常规风险
- 误操作风险：
delete/close类不可逆操作虽有确认环节，但批量删除仍需警惕 - 并发写入冲突：知识库节点、多维表记录等高频协作场景可能出现锁竞争，需按指数退避重试
- Token 泄露风险：虽有密钥链隔离，但用户手动
set-token时若被录屏/截屏仍存在暴露窗口 - AI 生成内容准确性：AI 总结、改写、PPT 生成结果需人工校验，不可直接作为正式交付物