SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场kdocs

kdocs

办公与效率

查看项目

更新于 10-15 16:25

技能介绍

金山文档 CLI Skill 提供了一套完整的在线文档操作工具，通过 kdocs-cli 命令行工具与金山文档 API 交互，支持创建、查询、读取、编辑、分享、移动多种类型的在线文档。

一、用途 该 Skill 面向需要在金山文档（WPS 云文档 / Kdocs / 365.kdocs.cn / www.kdocs.cn）上进行云文档操作的任务，覆盖云端新建、读取、编辑、搜索、分享、整理在线文档及个人知识库。

二、主要能力

  1. 读写主路径：读用 read_file，写用 create_file_with_content。read_file 支持 url / link_id / file_id 三选一定位；首次请求返回 status=pending 时，携带 task_id 与原读取参数再次请求可获取全量内容。create_file_with_content 用于新建并写入内容，目标目录明确时只传 parent_id，未指定目录时默认个人云盘根。
  2. 支持的文档类型：智能文档（.otl，首选）、表格（.xlsx）、PDF（.pdf）、文字文档（.docx）、演示文稿（.pptx）、智能表格（.ksheet）、多维表格（.dbt）、智能表单（.form）。
  3. 操作域路由：创建/写入、局部更新、类型专属能力（条件格式、导出转换、翻译、PDF 拆分、幻灯片主题、数据校验）、读取、定位文件、文件管理（移动/重命名/分享/标签/收藏/回收站/评论/文档库/历史版本/另存为）、AI 生成（AI 做 PPT）、知识库。
  4. 高频流程：空白文档创建、正文或表格数据写入、自定义列多维表新建、本地 Markdown 新建为办公文档、上传本地文件新建云文档、AI 生成 PPT、搜索定位文档等。
  5. 更多工作流：读取多维表云文档元信息、AI 生成演示文稿（全文/单页）、网页剪藏、搜索-读取-汇报撰写、定期读取与播报、智能分类整理、精准搜索与风险排查、云文档导入幻灯片、接龙转表格、跨表字段回填、表单收集、知识智能整理、知识一键存入、表格美化与数据规范。

三、使用方式

  1. 安装：bash scripts/setup.sh / powershell scripts/setup.ps1 / node scripts/setup.cjs。
  2. 认证：用户已提供 Token 时运行 kdocs-cli auth set-token "<token>"；无 Token 时运行 kdocs-cli auth login。
  3. 调用格式：kdocs-cli <service> <action> [参数]。简单值（无中文）用 key=value；数组/对象、短 JSON 用 JSON 字符串；数组/对象或含中文/换行/>200 字符用 --file；脚本流水线集成用 stdin。
  4. 全局选项：--token、--endpoint、--compact、--silent、--verbose、--timeout。
  5. 帮助：kdocs-cli --help、kdocs-cli <service> --help、kdocs-cli <service> <action> --help。

四、适用场景 适用于涉及金山文档云文档操作的任务，包括新建与写入文档、读取与提取内容、搜索定位文件、文件管理、AI 生成演示文稿、知识库整理，以及各类组合工作流（如搜索-读取-汇报撰写、跨表字段回填、表单收集等）。

五、限制与约束

  1. 严格规则：禁止将 Token 明文出现在对话、日志、命令输出、代码注释或任何文件中；上传写入等接口的 content_base64 可能非常大，禁止在对话中逐 token 生成 Base64 字符串；权限不足时禁止重试或绕过。不可逆操作（delete/close 类）执行前必须向用户确认。创建云文档并验证通过后必须向用户展示可访问链接。
  2. 除 SKILL.md 已给出最小可用示例的主路径工具外，其他工具调用前必须先阅读对应的 references/ 详细参考文档。
  3. 中文/多行参数禁止 key=value（Windows/PowerShell 破坏 UTF-8 编码）；生成 JSON 文件用 Node.js/Python，禁止 ConvertTo-Json。
  4. 错误处理：400006/鉴权失败需重新登录或设置 Token；429001/限频需立即停止调用至恢复时间；429002/熔断需熔断时长内零请求；403/权限不足需停止操作并告知用户；unknown action/service 需先升级 CLI。
  5. 版本维护：首次使用、距上次自检 >24h 或收到 unknown action/service 错误时需自检版本，必要时运行 kdocs-cli upgrade -y 或更新 Skill。
  6. 安全约束：凭据由 kdocs-cli 系统密钥链管理，Skill 自身不存储、不记录；无状态代理，不缓存任何文档内容或业务数据；仅在用户主动发起操作时调用对应 API。

六、问题反馈 满足可界定异常、错误与兜底、用户主动等条件时，必须运行 kdocs-cli feedback 并展示完整反馈链接，遵守防重复规则。