KingDoc 金山文档 AI 协作助手

要解决什么问题

在 Agent 里写会议纪要、拉销售表、做 PPT，往往还要自己打开金山文档网页：建文件、改权限、找历史版本、从回收站恢复。KingDoc 把这套操作收敛成 金山开放平台 API + MCP 工具集，让模型按意图选工具，而不是让你手工点界面。

未配置开放平台 App（App ID / App Secret）时，所有调用会落在 KD001 鉴权失败；OAuth Scope 需覆盖 user:file:read/write、team:file:read/write 等读写权限。

技能如何工作

技能用 场景路由 把用户话分到四类：文档创建、按品类编辑、纯文件管理、格式转换。

• 创建：doc / ppt 多为本地生成 DOCX/PPTX 后上传覆盖；sheet、smartsheet、form 走 kdoc.et.*、kdoc.dbt.*、kdoc.form.* 等 API 精细写入。
• 编辑前：必须先 kdoc.file.info 识别品类，禁止用 A 品类工具改 B 品类文档。
• 文件侧：搜索、上传下载、分享权限、回收站（kdoc.trash.*）、版本回滚（kdoc.version.*）、批量任务（kdoc.batch.*）。
• 公共能力：kdoc.office.extract 抽纯文本、kdoc.office.convert 做格式转换；v2.1.0 起支持多维表 Webhook（kdoc.dbt.webhook.set）与通知推送。

写入侧强调 权限前置校验、带版本号的冲突检测、删除走回收站、429 指数退避重试；表格连续多次写入要求走批量接口。

适用边界与注意点

• 文字稿与演示文稿无法像在线编辑器那样逐段/逐页远程改，实际是 整文件替换。
• 测试应用约 500 次/天 配额，正式应用才可到更高额度；大文件（>100MB）需异步上传并轮询。
• 图片 OCR 不在能力内；图中文字需先转成可处理的在线文档再提取。
• 批量任务、格式转换等异步操作应在子会话轮询，避免主会话长时间阻塞。