kdocs skill — kdocs 技能

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

严格规则 禁止（NEVER） 禁止将 Token 明文出现在对话、日志、命令输出、代码注释或任何文件中；Token 仅允许通过 kdocs-cli auth set-token 或 kdocs-cli auth login 保存到系统密钥链 上传写入等接口需传入的 content_base64 可能非常大（编码后 >1 MB），禁止在对话中逐 token 生成 Base64 字符串，用脚本完成文件读取、编码和传参 必须（MUST） 不可逆操作（delete/close 类）执行前必须向用户确认 写操作完成后必须用独立读取请求验证实际结果（不信任 code: 0） 创建文档并验证通过后，必须调用 get_file_link 获取链接并展示给用户 通过 --file 或脚本创建的临时 JSON 文件（如 payload.json、temp.json），在整个操作流程结束后必须删除，避免残留在用户工作目录

保持最新版本 何时触发：首次使用 Skill / 距上次自检 >24h / 收到 unknown action 或 unknown service 错误。 CLI 版本：kdocs-cli version — 若命令不存在则按下方「工具安装与认证」安装；若低于本文件 frontmatter version，运行 kdocs-cli upgrade -y（自动备份旧版本，失败可 kdocs-cli upgrade --rollback） Skill 版本：若本文件 version 低于 kdocs-cli version，运行 kdocs-cli call check_skill_update version=<本文件version>，若返回 update_available: true，从 instruction 中提取 zip 下载链接（格式 https://...kdocs.zip），下载解压替换当前 Skill 目录 若 upgrade 和 rollback 均失败，在本 Skill 目录下重新运行安装脚本（bash setup.sh / powershell setup.ps1 / node setup.cjs，脚本位于 scripts/）可从 CDN 重新安装。若仍无法更新，以 kdocs-cli --help 实际支持的工具集为准。

工具安装与认证 操作 命令 安装 bash scripts/setup.sh / powershell scripts/setup.ps1 / node scripts/setup.cjs 认证 用户已提供 Token: kdocs-cli auth set-token "" · 无 Token: kdocs-cli auth login login 失败时的手动获取流程、auth status 诊断、auth logout 退出等详见 references/auth.md。

调用格式 kdocs-cli [参数] 参数传递 参数特征 推荐方式 示例 简单值（无中文） key=value kdocs-cli drive search-files keyword=test type=all 数组/对象，短 JSON JSON 字符串 kdocs-cli sheet query-records '{"file_id":"xxx","filter":{}}' 数组/对象，或含中文/换行/>200 字符 --file kdocs-cli otl insert-content --file payload.json 脚本流水线集成 stdin node gen.js | kdocs-cli otl insert-content - --file 示例：写入大段内容时，用脚本生成 JSON 文件再 --file 传入，操作完成后删除临时文件： const fs = require('fs'); fs.writeFileSync('payload.json', JSON.stringify({ file_id: "", content: fs.readFileSync('article.md', 'utf8'), format: "markdown", mode: "append" }), 'utf8'); kdocs-cli otl insert-content --file payload.json --silent // 操作完成后清理临时文件 fs.unlinkSync('payload.json');

全局选项： 选项 说明 --token 一次性 Token（优先级最高，不持久化） --endpoint 覆盖默认 endpoint --compact 输出紧凑 JSON --silent 仅输出 data 字段 --verbose 输出请求详情到 stderr --timeout

以下工具不可逆，调用前必须向用户确认（详细约束见各工具参考文档的「操作约束」区）： otl.block_delete、dbsheet.delete_sheet、kwiki.close_knowledge_view、sheet.delete_sheets、sheet.delete_range_data、dbsheet.delete_view、dbsheet.delete_fields、cancel_share、kwiki.delete_item、sheet.delete_protection_ranges、dbsheet.delete_records、sheet.delete_data_validations、sheet.delete_conditional_format_rules、sheet.delete_float_images、sheet.delete_filters、dbsheet.sheet_batch_delete、dbsheet.permission_delete_roles_async

能力范围 操作域路由 Agent 首先判定用户请求的操作域： 操作域 触发场景 路由 创建/写入 新建文档/编辑内容/上传文件 必读 references/file-writing-guide.md 读取 读取/提取/导出文档内容 必读 references/file-reading-guide.md 定位文件 搜索/按链接找文件/浏览目录 必读 references/file-locating-guide.md 文件管理 移动/重命名/分享/标签/收藏/回收站 → references/drive.md 文档专项功能 格式/样式/导出/转换/数据校验等 按文档类型查下方表 → 对应 reference AI 生成 AI 做PPT/生成演示文稿 → references/aippt.md 知识库 知识库空间/导入/整理 → references/kwiki.md

支持的文档类型 类型 别名 文件后缀 说明 详细参考 智能文档 首选 ap .otl 排版美观，支持丰富组件 references/otl.md — 页面、文本、标题、待办等元素操作 表格 et / Excel .xlsx 数据表格专用 references/sheet.md — 工作表管理、范围数据获取、批量更新 PDF文档 pdf .pdf PDF 文档专用 references/pdf.md — PDF 创建与内容读取 文字文档 wps / Word .docx 传统格式 references/wps.md — Word 文档创建与内容操作 演示文稿 wpp .pptx PPT 文档专用 references/wpp.md — 幻灯片主题字体和配色设置、下载和导出 智能表格 as .ksheet 结构化表格，支持多视图、字段管理 references/sheet.md — 工作表管理、范围数据获取、批量更新 多维表格 db / dbsheet .dbt 多数据表、丰富字段类型与视图（表格/看板/甘特等） references/dbsheet.md — 支持数据表/视图/字段/记录的完整增删改查，含表单视图、父子记录、分享协作、高级权限与 Webhook 智能表单 form .form 轻量表单草稿创建、题目配置、发布与查询 references/form.md — 草稿创建/更新/发布与表单信息查询

高频流程指引 创建并写入文档 执行顺序： 先按 references/file-locating-guide.md 获取目标目录 drive_id(可选)、parent_id(可选)。 再按 references/file-writing-guide.md 选择文档类型与写入路径。 字段传递：步骤 1 获取 drive_id(可选)、parent_id(可选)，作为步骤 2 的输入，执行“新建写入”流程。 上传本地文件到云盘 执行顺序： 先按 references/file-locating-guide.md 获取目标目录 drive_id(可选)、parent_id(可选)、file_id(可选)。 再按 references/file-writing-guide.md 的“本地文件上传（upload_file）”路径调用上传能力（新建上传或覆盖更新）。 字段传递：新建上传使用步骤 1 的 drive_id(可选)、parent_id(可选) + name；覆盖更新使用步骤 1 的 file_id 。 搜索定位文档 工具说明：search_files(keyword="关键词", type="all", page_size=20)，获取 file_id、drive_id 供后续链路使用。 详细参数与返回结构见 references/drive/search.md。

更多操作流程 流程 说明 详细参考 AI 生成演示文稿（全文） aippt.execute 单接口全文生成链路：两次调用完成需求澄清与生成，支持主题/文档两种来源，固定使用 html 模式 references/workflows/aippt-whole.md 网页剪藏 抓取网页内容并自动保存为智能文档 references/workflows/web-scrape.md 搜索-读取-汇报撰写 搜索多份文档、提取信息、汇总撰写新报告 references/workflows/search-read-report.md 定期读取与播报 定期读取指定文档，提取关键信息生成摘要 references/workflows/periodic-read-summary.md 智能分类整理 列出目录，按内容或指定维度分类创建文件夹并归档