凌晨两点我对着空白的周报文档发呆周五晚上 11 点老王发来一张截图“哥我这周要交的周报又忘了写。手头有 7 个项目的进度、3 份会议纪要、还有一堆待办事项。你能不能让 AI 帮我直接生成一份金山的 WPS 文档”他用的是金山文档——对就是那个 5 亿人在用的 WPS 云端版。不是 Notion不是飞书不是腾讯文档是金山。我的第一反应是去搜啊肯定有人做过这种 Skill 吧结果一搜搜出来一堆——tencent-docs、notion-skill、office-cli、doc-assistant……但没有一个是专门为金山文档设计的。直到我遇到了它kdocs-skill。一个由金山办公Kingsoft官方出品的 Skill唯一与金山文档 API 完整对接的 OpenClaw 原生插件。它不是又一个AI 写文档工具。它是那个让你在 OpenClaw 里说一句帮我把刚才那段会议纪要存到金山文档周报文件夹就能完成全部动作的东西。今天这篇文章我想跟你聊一聊这只龙虾是怎么接管你的金山文档的。一、先说清楚金山文档是什么为什么需要专门的 Skill很多人对金山文档还有误解。“哦就是那个网页版 WPS 嘛。”不是的。**金山文档KDocs / 365.kdocs.cn / www.kdocs.cn**是金山办公旗下的在线协作文档平台。它和腾讯文档、飞书文档、Notion 是同一级别的产品——但有一个独特的差异点它背靠 WPS Office 30 年的本地办公软件积累。也就是说你本地 WPS 能做的所有事Word/Excel/PPT/PDF金山文档全都能在浏览器里做并且加入了云端的协作、AI、跨端同步。截至 2026 年 8 月金山文档月活用户已经超过 5 亿。但它有一个致命痛点没有 AI Agent 原生接入。你打开 kdocs.cn看到的是一个网页编辑器。你打开手机 App看到的是协作界面。你打开 OpenClaw/Claude Code/Cursor……什么都没。AI 想要操作你的金山文档抱歉你得自己复制粘贴。kdocs-skill就是为解决这个痛点而生的。二、kdocs-skill 是什么为什么是它2.1 一句话定义kdocs-skill是金山办公官方出品的 OpenClaw 原生 Skill通过配套的kdocs-cli命令行工具让 AI Agent 可以直接调用金山文档的完整 API——创建、读取、编辑、搜索、分享、分类、整理、回收……它是金山文档的AI 外挂神经。2.2 数据背书我从 SkillHub 抓到了一组硬数据2026-08-01 实时榜单榜单维度数据出现榜单hot / trending / recommended 三榜同在综合得分sum_score70,312安装量2,029 次Star 数97最新版本v2.4.0v2.5.13 在用户版本命名空间user_5ea84866/kdocs-skill社区归档 官方分发协议MIT社区归档仓库平台OpenClaw / Claude Code / Cursor / Codex / Hermes 等 50 平台总命令数40 个工具drive/sheet/otl/dbsheet/wpp/aippt/wps/pdf/kwiki 九大服务它是 SkillHub 在线文档类目中除 tencent-docs 之外另一个同时进入热榜和推荐榜的选手。2.3 官方背景不是野鸡这是最关键的点。很多 Skill 是社区开发者自己写 API 包装的比如office-cli、doc-assistant——它们都很强但和金山文档没有官方合作关系。而kdocs-skillREADME 第一句就写明“金山文档官方 Skill”Token 来源是https://www.kdocs.cn不是第三方调用的是api.wps.cn的官方 OpenAPI文档里专门有一个「龙虾专属入口」用于 AI Agent 接入这是金山办公Kingsoft官方下场做的 AI 接入层。这意味着✅ API 不会突然废弃✅ 不会出现第三方破解导致的封号✅ 有问题可以走官方反馈通道kdocs-cli feedback✅ Token 体系是 WPS 账号本身企业用户无缝对接三、它到底能做什么九大服务 40 工具kdocs-skill最大的特点是它不只是一个读写文档工具而是一个完整的金山文档操作系统。3.1 文档类型支持——比 office-cli 还全类型别名后缀用途智能文档ap.otl排版美观、组件丰富首选表格et/Excel.xlsx数据表格PDF 文档pdf.pdfPDF 创建与内容读取文字文档wps/Word.docx传统 Word 格式演示文稿wpp.pptxPPT 操作智能表格as.ksheet多视图、字段管理多维表格db/dbsheet.dbt多数据表、丰富字段类型Notion 级别能力知识库kwiki—个人知识库空间与资料管理AI PPTaippt—主题生成、深度研究、大纲与生成这意味着你可以在 OpenClaw 里写 Word、做 Excel、做 PPT、管理 Notion 级别的多维表格。3.2 核心工具矩阵我把它按使用频率重新整理了一遍 高频每天用drive.search_files— 搜文件按文件名 / 全文 / 类型drive.create_file— 新建文档drive.read_file_content— 读取文档 → Markdowndrive.upload_file— 上传本地文件到云端drive.share_file— 一键生成分享链接 中频每周用otl.insert_content— 往智能文档里插内容sheet.read/write— 读写 Excelwpp.execute— 操作 PPTpdf.split/extract— 拆分和提取 PDFscrape_url— 网页剪藏直接存为智能文档 进阶场景化dbsheet.*— 多维表格全操作建表/字段/视图/记录/权限kwiki.*— 知识库管理aippt.*— AI 一键生成 PPTmove_file / rename_file / batch_add_label_objects— 整理和打标签list_deleted_files / restore_deleted_file— 回收站还原3.3 让我眼前一亮的 5 个能力① 网页剪藏scrape_url看到一篇好文章 → 一句话让 AI 抓取 → 自动存到金山文档智能文档 → 顺手打个待读标签。这不就是 readwise 之类的付费工具做的事吗免费给你。② 接龙转表格微信群里发了一个接龙 → 把文本丢给 AI → 自动生成结构化在线表格 → 直接发到群里收尾。③ AI PPT 一键生成aippt主题生成 PPT 的标准链路澄清需求5W2H研究资料搜索 读取大纲与生成上传AI 真的能帮你从一句话到成品 PPT。④ 多维表格dbsheet这个必须单独说——多维表格 表格 看板 甘特 日历。dbsheet.*提供了完整的 Notion Database 级别能力建表、字段类型、视图、记录、附件、权限、webhook。你可以一句话让 AI 帮你建一个客户跟进表配置 12 个字段、3 个视图、自动提醒。⑤ Token 体系设计这是工程化最让我服气的地方。kdocs-cli auth set-token token一行命令保存到系统密钥链。Token 包含/、、等特殊字符时用 stdin 模式避免 shell 转义问题。echo token | kdocs-cli auth set-token -禁止明文存储、禁止明文回显、禁止写入环境变量。这是其他 Skill 都不太会认真做的事情。四、10 分钟从零开始实操演示4.1 安装Windows 用户# 方式一一行命令推荐 powershell scripts/setup.ps1 # 方式二Node.js 通用 node scripts/setup.cjs # 验证 kdocs-cli versionLinux / macOSbash scripts/setup.sh4.2 登录# 浏览器 OAuth 登录自动保存 Token 到密钥链 kdocs-cli auth login # 或手动设置 Token kdocs-cli auth set-token your-token4.3 第一次调用搜索周报kdocs-cli drive search-files keyword周报 typeall page_size10返回 JSON类似{ code: 0, data: { files: [ {file_id: xxx, name: 2026-08-01 周报.otl, drive_id: ...}, ... ] } }code: 0 即成功。4.4 完整工作流让 AI 帮你写周报# 1. 找到周报模板 kdocs-cli drive search-files keyword周报 typefile_name # 2. 复制模板到目标目录 kdocs-cli drive copy-file file_id模板ID parent_id目标目录ID # 3. 读取今天的会议纪要 kdocs-cli drive read-file-content file_id纪要ID # 4. 整理 写入周报 kdocs-cli otl insert-content file_id新周报ID contentAI 生成的 Markdown posend # 5. 获取分享链接 kdocs-cli drive get-file-link file_id新周报ID从想写周报到周报链接发到群里5 条命令1 分钟。4.5 大段内容怎么传最容易踩的坑kdocs-cli对中文长内容做了专门的工程化处理。❌ 错误做法# PowerShell 进程间参数传递会破坏 UTF-8 → 乱码 kdocs-cli otl insert-content file_idxxx content这是一段超长的中文内容...✅ 正确做法用 file// Node.js 生成 JSON payload const fs require(fs); const payload JSON.stringify({ file_id: xxx, content: fs.readFileSync(article.md, utf8), pos: end }); fs.writeFileSync(payload.json, payload, utf8);kdocs-cli otl insert-content payload.json --silent为什么这很重要因为很多人写 Skill 的时候没考虑 Windows 中文 PowerShell 的组合结果每次都乱码。kdocs-skill把这个坑直接用工程化方式填平了。五、技术架构深度剖析5.1 三层架构┌─────────────────────────────────────────┐ │ Layer 1: AI AgentOpenClaw/Claude Code │ │ - 接收自然语言指令 │ │ - 解析意图并匹配工具 │ │ - 调度多个工具组合完成复杂任务 │ └─────────────────────────────────────────┘ ↓ kdocs-cli (CLI) ┌─────────────────────────────────────────┐ │ Layer 2: kdocs-cli 命令行工具 │ │ - 参数解析keyvalue / JSON / file / stdin│ │ - Token 安全管理系统密钥链 │ │ - 错误码转换400006/400007/... │ │ - 重试与幂等性控制 │ └─────────────────────────────────────────┘ ↓ HTTP API ┌─────────────────────────────────────────┐ │ Layer 3: 金山文档官方 OpenAPIapi.wps.cn │ │ - Drive 文件管理 │ │ - Sheet 表格 │ │ - OTL 智能文档 │ │ - Dbsheet 多维表格 │ │ - Kwiki 知识库 │ │ - AIPPT AI 生成 │ └─────────────────────────────────────────┘5.2 关键的 5 个工程化设计① 四种参数传递方式方式适用场景keyvalue简单参数所有 shell 通用JSON 字符串数组/对象参数bash 单引号 / PowerShell 反斜杠stdin 管道脚本集成、复杂嵌套file超长参数、可复用配置② 幂等性管理操作幂等重试策略所有读取操作✅可安全重试create_file❌重试前 search_files 检查otl.insert_content❌重复调用会重复插入upload_file✅以最后一次为准move_file✅可重试share_file✅可重试dbsheet.delete_records❌删除失败勿盲目重试写入类操作create / insert / execute都不幂等必须前置检查。③ 错误码字典kdocs-skill内置了完整的错误码字典错误码含义处理400006/400007Token 过期重新auth login400008权限不足检查文件夹权限400016API 限流退避重试report_unsupported_feature工具不支持走兜底方案④ 版本自检三步法Step 1: kdocs-cli upgrade --check # 检查 CLI 新版本 Step 2: 对比 SKILL.md frontmatter 的 version 字段 Step 3: kdocs-cli call check_skill_update version当前版本号 # 检查 Skill 包⑤ 安全约束凭据由系统密钥链管理禁止明文回显严格区分了只读和写操作14 个高风险工具都有用户确认约束无状态代理不缓存任何文档内容六、5 大真实场景演示场景 1群接龙自动转表格原始微信群发接龙周六爬山 1. 张三 2. 李四 3. 王五... ↓ kdocs-cli drive create-file name周六爬山接龙表.ksheet file_typefile ↓ kdocs-cli sheet insert-rows file_id新表ID data结构化JSON ↓ kdocs-cli drive get-file-link file_id新表ID5 秒钟完成零人工干预。场景 2网页剪藏 AI 整理把知乎上这篇关于 AI Agent 的文章存到我的知识库 ↓ kdocs-cli drive scrape_url urlhttps://zhuanlan.zhihu.com/p/xxx ↓ kdocs-cli scrape_progress # 查询任务进度 ↓ kdocs-cli drive move_file file_id生成文档ID parent_id知识库目录ID ↓ kdocs-cli kwiki create_knowledge_view nameAI Agent 收藏收藏、分类、入库全自动。场景 3会议纪要 → 周报 → PPT3 份会议纪要多模态Word 录音转写 截图 ↓ kdocs-cli drive read-file-content # 读取所有 ↓ kdocs-cli kwiki kwiki_list_items # 提取所有待办 ↓ kdocs-cli drive create-file name周报.otl # 创建周报 ↓ kdocs-cli otl insert-content # 写入 AI 整理的周报 ↓ kdocs-cli aippt deep_research # 周报自动生成 PPT ↓ kdocs-cli drive get-file-link # 一键分享这是 5 个工具的组合1 分钟完成 4 小时的工作。场景 4多维表格搭建 CRM建一个客户跟进表字段姓名/公司/联系方式/跟进状态/下次联系时间 ↓ kdocs-cli dbsheet create_table schema12字段JSON ↓ kdocs-cli dbsheet create_view view_typekanban # 看板视图 ↓ kdocs-cli dbsheet create_view view_typecalendar # 日历视图 ↓ kdocs-cli dbsheet create_webhook # 跟进状态变更触发提醒从零搭建 CRM 系统3 分钟。场景 5知识库整理我的金山文档知识库里有 200 篇杂文按主题分类整理 ↓ kdocs-cli kwiki list_items # 列出所有 ↓ AI 聚类分析主题 ↓ kdocs-cli kwiki create_knowledge_view nameAI 主题 ↓ kdocs-cli kwiki batch_move_items # 批量移动知识管理从乱糟糟到井井有条。七、同类对比它和 office-cli / tencent-docs 有什么区别这是最常被问到的问题我直接做一张表维度kdocs-skilloffice-clitencent-docsnotion-skill服务对象金山文档本地 Office腾讯文档NotionAPI 来源官方 OpenAPI自实现多协议官方 OpenAPI官方 API生态绑定强必须 WPS 账号弱本地文件强必须腾讯账号强必须 Notion 账号核心能力云端协作 AI本地 Office 自动化智能表格 知识库块级编辑 数据库多维表格✅ dbsheet❌✅ 智能表格✅ DatabaseAI PPT✅ aippt✅❌❌网页剪藏✅ scrape_url❌✅❌知识库✅ kwiki❌✅ 知识空间✅ 块引用CLI 形式✅ kdocs-cli✅ officecli❌❌国内访问✅✅✅⚠️ 需梯子协作能力⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐离线能力⭐⭐⭐⭐⭐⭐⭐⭐一句话总结office-cli本地 Office 自动化之王强在离线、跨平台tencent-docs腾讯生态的 Notion 替代团队协作强notion-skillNotion 原生 AI 集成块级编辑最优雅kdocs-skill金山文档原生 AI 接入国内访问友好5 亿用户基础如果你/你的团队是 WPS 重度用户kdocs-skill是唯一选择。八、优缺点诚实评价✅ 优点1. 官方背景可靠性极高金山办公官方出品不会突然废弃Token 体系安全。2. 工具覆盖最全40 工具9 大服务从智能文档到多维表格到知识库到 AI PPT没有死角。3. 工程化做得好Token 用系统密钥链管理中文长内容用 file 传参幂等性、重试、错误码字典都是教科书级别版本自检三步法实用4. 国内访问友好不需要梯子Token 就是你的 WPS 账号。5. CLI 形态对 AI 友好kdocs-cli drive search-files keywordxxx这种命令AI 调用起来最自然。❌ 缺点1. 必须有金山文档账号门槛存在但 5 亿人都有门槛其实很低。2. Token 体系——目前只支持国内版kdocs.cn / wps.cn不支持国际版wps.comGitHub Issue #73062 已经在跟踪了但还没有合并。这是国际化团队的最大痛点。3. 部分操作有高风险约束14 个高风险工具如delete_records、close_knowledge_view必须用户确认。这是好事但在自动化场景下可能需要先auth set-token --skip-confirm才能跑批处理。4. 写入类操作不幂等create_file、otl.insert_content、wpp.execute重试需要先检查状态对长流程工作流要做断点续传。5. 学习曲线40 工具对新手来说需要花 1-2 小时才能掌握核心用法。九、5 个黄金组合kdocs-skill不是孤岛搭配其他 Skill 威力更大。组合 1周报生成器kdocs-skill agent-browser summarize1. agent-browser 抓取飞书/钉钉的周报源数据 2. summarize 生成 500 字摘要 3. kdocs-skill 写入金山文档周报模板组合 2知识库流水线kdocs-skill tavily-search another-them1. tavily-search 搜索行业最新动态 2. another-them 用芒格思维模式整理 3. kdocs-skill 入库到 kwiki 知识库组合 3客户管理自动化kdocs-skill email-management messaging-integration1. email-management 读取客户邮件 2. messaging-integration 读取微信沟通 3. kdocs-skill dbsheet 自动更新客户跟进表组合 4内容创作全流程kdocs-skill xiaohongshu-mcp summarize1. summarize 提炼爆款内容规律 2. xiaohongshu-mcp 一键发布 3. kdocs-skill 归档到内容运营知识库组合 5AI PPT 一键生成kdocs-skill wechat-clawbot ai-web-automation1. wechat-clawbot 接收微信群发来的做PPT指令 2. kdocs-skill aippt 生成 PPT 3. ai-web-automation 上传到 WPS 演示 4. 把分享链接回发到群里十、写在最后它教会了我什么写完这篇深度报告我最大的感受是AI Agent 的真正革命不是更聪明的模型而是更深的生态连接。kdocs-skill让我重新理解了在线文档。它不只是一个 Skill它是金山办公在 AI 时代给 5 亿用户的一份使用说明书。很多团队花了 30 年建立自己的文档体系AI 想要接入需要 1 个 Token、1 个 CLI、1 套工程化设计。kdocs-skill把这3 个 1做到了极致。它不是那只最强壮的龙虾但它是最懂金山文档的那只。 快速安装清单# 1. 安装 CLI powershell scripts/setup.ps1 # 2. 登录 kdocs-cli auth login # 3. 第一次搜索 kdocs-cli drive search-files keyword周报 typeall # 4. 创建第一个文档 kdocs-cli drive create-file name我的第一个 AI 文档.otl file_typefile # 5. 写点东西 kdocs-cli otl insert-content file_idid contentHello from AI Agent posend5 步10 分钟让你的 OpenClaw 真正接管金山文档。 让 AI 干活从一只会写文档的龙虾开始。字数约 4,500 字
每日热门skill-一只“龙虾“接管你的金山文档：kdocs-skill 让我重新理解了“在线文档“的边界
凌晨两点我对着空白的周报文档发呆周五晚上 11 点老王发来一张截图“哥我这周要交的周报又忘了写。手头有 7 个项目的进度、3 份会议纪要、还有一堆待办事项。你能不能让 AI 帮我直接生成一份金山的 WPS 文档”他用的是金山文档——对就是那个 5 亿人在用的 WPS 云端版。不是 Notion不是飞书不是腾讯文档是金山。我的第一反应是去搜啊肯定有人做过这种 Skill 吧结果一搜搜出来一堆——tencent-docs、notion-skill、office-cli、doc-assistant……但没有一个是专门为金山文档设计的。直到我遇到了它kdocs-skill。一个由金山办公Kingsoft官方出品的 Skill唯一与金山文档 API 完整对接的 OpenClaw 原生插件。它不是又一个AI 写文档工具。它是那个让你在 OpenClaw 里说一句帮我把刚才那段会议纪要存到金山文档周报文件夹就能完成全部动作的东西。今天这篇文章我想跟你聊一聊这只龙虾是怎么接管你的金山文档的。一、先说清楚金山文档是什么为什么需要专门的 Skill很多人对金山文档还有误解。“哦就是那个网页版 WPS 嘛。”不是的。**金山文档KDocs / 365.kdocs.cn / www.kdocs.cn**是金山办公旗下的在线协作文档平台。它和腾讯文档、飞书文档、Notion 是同一级别的产品——但有一个独特的差异点它背靠 WPS Office 30 年的本地办公软件积累。也就是说你本地 WPS 能做的所有事Word/Excel/PPT/PDF金山文档全都能在浏览器里做并且加入了云端的协作、AI、跨端同步。截至 2026 年 8 月金山文档月活用户已经超过 5 亿。但它有一个致命痛点没有 AI Agent 原生接入。你打开 kdocs.cn看到的是一个网页编辑器。你打开手机 App看到的是协作界面。你打开 OpenClaw/Claude Code/Cursor……什么都没。AI 想要操作你的金山文档抱歉你得自己复制粘贴。kdocs-skill就是为解决这个痛点而生的。二、kdocs-skill 是什么为什么是它2.1 一句话定义kdocs-skill是金山办公官方出品的 OpenClaw 原生 Skill通过配套的kdocs-cli命令行工具让 AI Agent 可以直接调用金山文档的完整 API——创建、读取、编辑、搜索、分享、分类、整理、回收……它是金山文档的AI 外挂神经。2.2 数据背书我从 SkillHub 抓到了一组硬数据2026-08-01 实时榜单榜单维度数据出现榜单hot / trending / recommended 三榜同在综合得分sum_score70,312安装量2,029 次Star 数97最新版本v2.4.0v2.5.13 在用户版本命名空间user_5ea84866/kdocs-skill社区归档 官方分发协议MIT社区归档仓库平台OpenClaw / Claude Code / Cursor / Codex / Hermes 等 50 平台总命令数40 个工具drive/sheet/otl/dbsheet/wpp/aippt/wps/pdf/kwiki 九大服务它是 SkillHub 在线文档类目中除 tencent-docs 之外另一个同时进入热榜和推荐榜的选手。2.3 官方背景不是野鸡这是最关键的点。很多 Skill 是社区开发者自己写 API 包装的比如office-cli、doc-assistant——它们都很强但和金山文档没有官方合作关系。而kdocs-skillREADME 第一句就写明“金山文档官方 Skill”Token 来源是https://www.kdocs.cn不是第三方调用的是api.wps.cn的官方 OpenAPI文档里专门有一个「龙虾专属入口」用于 AI Agent 接入这是金山办公Kingsoft官方下场做的 AI 接入层。这意味着✅ API 不会突然废弃✅ 不会出现第三方破解导致的封号✅ 有问题可以走官方反馈通道kdocs-cli feedback✅ Token 体系是 WPS 账号本身企业用户无缝对接三、它到底能做什么九大服务 40 工具kdocs-skill最大的特点是它不只是一个读写文档工具而是一个完整的金山文档操作系统。3.1 文档类型支持——比 office-cli 还全类型别名后缀用途智能文档ap.otl排版美观、组件丰富首选表格et/Excel.xlsx数据表格PDF 文档pdf.pdfPDF 创建与内容读取文字文档wps/Word.docx传统 Word 格式演示文稿wpp.pptxPPT 操作智能表格as.ksheet多视图、字段管理多维表格db/dbsheet.dbt多数据表、丰富字段类型Notion 级别能力知识库kwiki—个人知识库空间与资料管理AI PPTaippt—主题生成、深度研究、大纲与生成这意味着你可以在 OpenClaw 里写 Word、做 Excel、做 PPT、管理 Notion 级别的多维表格。3.2 核心工具矩阵我把它按使用频率重新整理了一遍 高频每天用drive.search_files— 搜文件按文件名 / 全文 / 类型drive.create_file— 新建文档drive.read_file_content— 读取文档 → Markdowndrive.upload_file— 上传本地文件到云端drive.share_file— 一键生成分享链接 中频每周用otl.insert_content— 往智能文档里插内容sheet.read/write— 读写 Excelwpp.execute— 操作 PPTpdf.split/extract— 拆分和提取 PDFscrape_url— 网页剪藏直接存为智能文档 进阶场景化dbsheet.*— 多维表格全操作建表/字段/视图/记录/权限kwiki.*— 知识库管理aippt.*— AI 一键生成 PPTmove_file / rename_file / batch_add_label_objects— 整理和打标签list_deleted_files / restore_deleted_file— 回收站还原3.3 让我眼前一亮的 5 个能力① 网页剪藏scrape_url看到一篇好文章 → 一句话让 AI 抓取 → 自动存到金山文档智能文档 → 顺手打个待读标签。这不就是 readwise 之类的付费工具做的事吗免费给你。② 接龙转表格微信群里发了一个接龙 → 把文本丢给 AI → 自动生成结构化在线表格 → 直接发到群里收尾。③ AI PPT 一键生成aippt主题生成 PPT 的标准链路澄清需求5W2H研究资料搜索 读取大纲与生成上传AI 真的能帮你从一句话到成品 PPT。④ 多维表格dbsheet这个必须单独说——多维表格 表格 看板 甘特 日历。dbsheet.*提供了完整的 Notion Database 级别能力建表、字段类型、视图、记录、附件、权限、webhook。你可以一句话让 AI 帮你建一个客户跟进表配置 12 个字段、3 个视图、自动提醒。⑤ Token 体系设计这是工程化最让我服气的地方。kdocs-cli auth set-token token一行命令保存到系统密钥链。Token 包含/、、等特殊字符时用 stdin 模式避免 shell 转义问题。echo token | kdocs-cli auth set-token -禁止明文存储、禁止明文回显、禁止写入环境变量。这是其他 Skill 都不太会认真做的事情。四、10 分钟从零开始实操演示4.1 安装Windows 用户# 方式一一行命令推荐 powershell scripts/setup.ps1 # 方式二Node.js 通用 node scripts/setup.cjs # 验证 kdocs-cli versionLinux / macOSbash scripts/setup.sh4.2 登录# 浏览器 OAuth 登录自动保存 Token 到密钥链 kdocs-cli auth login # 或手动设置 Token kdocs-cli auth set-token your-token4.3 第一次调用搜索周报kdocs-cli drive search-files keyword周报 typeall page_size10返回 JSON类似{ code: 0, data: { files: [ {file_id: xxx, name: 2026-08-01 周报.otl, drive_id: ...}, ... ] } }code: 0 即成功。4.4 完整工作流让 AI 帮你写周报# 1. 找到周报模板 kdocs-cli drive search-files keyword周报 typefile_name # 2. 复制模板到目标目录 kdocs-cli drive copy-file file_id模板ID parent_id目标目录ID # 3. 读取今天的会议纪要 kdocs-cli drive read-file-content file_id纪要ID # 4. 整理 写入周报 kdocs-cli otl insert-content file_id新周报ID contentAI 生成的 Markdown posend # 5. 获取分享链接 kdocs-cli drive get-file-link file_id新周报ID从想写周报到周报链接发到群里5 条命令1 分钟。4.5 大段内容怎么传最容易踩的坑kdocs-cli对中文长内容做了专门的工程化处理。❌ 错误做法# PowerShell 进程间参数传递会破坏 UTF-8 → 乱码 kdocs-cli otl insert-content file_idxxx content这是一段超长的中文内容...✅ 正确做法用 file// Node.js 生成 JSON payload const fs require(fs); const payload JSON.stringify({ file_id: xxx, content: fs.readFileSync(article.md, utf8), pos: end }); fs.writeFileSync(payload.json, payload, utf8);kdocs-cli otl insert-content payload.json --silent为什么这很重要因为很多人写 Skill 的时候没考虑 Windows 中文 PowerShell 的组合结果每次都乱码。kdocs-skill把这个坑直接用工程化方式填平了。五、技术架构深度剖析5.1 三层架构┌─────────────────────────────────────────┐ │ Layer 1: AI AgentOpenClaw/Claude Code │ │ - 接收自然语言指令 │ │ - 解析意图并匹配工具 │ │ - 调度多个工具组合完成复杂任务 │ └─────────────────────────────────────────┘ ↓ kdocs-cli (CLI) ┌─────────────────────────────────────────┐ │ Layer 2: kdocs-cli 命令行工具 │ │ - 参数解析keyvalue / JSON / file / stdin│ │ - Token 安全管理系统密钥链 │ │ - 错误码转换400006/400007/... │ │ - 重试与幂等性控制 │ └─────────────────────────────────────────┘ ↓ HTTP API ┌─────────────────────────────────────────┐ │ Layer 3: 金山文档官方 OpenAPIapi.wps.cn │ │ - Drive 文件管理 │ │ - Sheet 表格 │ │ - OTL 智能文档 │ │ - Dbsheet 多维表格 │ │ - Kwiki 知识库 │ │ - AIPPT AI 生成 │ └─────────────────────────────────────────┘5.2 关键的 5 个工程化设计① 四种参数传递方式方式适用场景keyvalue简单参数所有 shell 通用JSON 字符串数组/对象参数bash 单引号 / PowerShell 反斜杠stdin 管道脚本集成、复杂嵌套file超长参数、可复用配置② 幂等性管理操作幂等重试策略所有读取操作✅可安全重试create_file❌重试前 search_files 检查otl.insert_content❌重复调用会重复插入upload_file✅以最后一次为准move_file✅可重试share_file✅可重试dbsheet.delete_records❌删除失败勿盲目重试写入类操作create / insert / execute都不幂等必须前置检查。③ 错误码字典kdocs-skill内置了完整的错误码字典错误码含义处理400006/400007Token 过期重新auth login400008权限不足检查文件夹权限400016API 限流退避重试report_unsupported_feature工具不支持走兜底方案④ 版本自检三步法Step 1: kdocs-cli upgrade --check # 检查 CLI 新版本 Step 2: 对比 SKILL.md frontmatter 的 version 字段 Step 3: kdocs-cli call check_skill_update version当前版本号 # 检查 Skill 包⑤ 安全约束凭据由系统密钥链管理禁止明文回显严格区分了只读和写操作14 个高风险工具都有用户确认约束无状态代理不缓存任何文档内容六、5 大真实场景演示场景 1群接龙自动转表格原始微信群发接龙周六爬山 1. 张三 2. 李四 3. 王五... ↓ kdocs-cli drive create-file name周六爬山接龙表.ksheet file_typefile ↓ kdocs-cli sheet insert-rows file_id新表ID data结构化JSON ↓ kdocs-cli drive get-file-link file_id新表ID5 秒钟完成零人工干预。场景 2网页剪藏 AI 整理把知乎上这篇关于 AI Agent 的文章存到我的知识库 ↓ kdocs-cli drive scrape_url urlhttps://zhuanlan.zhihu.com/p/xxx ↓ kdocs-cli scrape_progress # 查询任务进度 ↓ kdocs-cli drive move_file file_id生成文档ID parent_id知识库目录ID ↓ kdocs-cli kwiki create_knowledge_view nameAI Agent 收藏收藏、分类、入库全自动。场景 3会议纪要 → 周报 → PPT3 份会议纪要多模态Word 录音转写 截图 ↓ kdocs-cli drive read-file-content # 读取所有 ↓ kdocs-cli kwiki kwiki_list_items # 提取所有待办 ↓ kdocs-cli drive create-file name周报.otl # 创建周报 ↓ kdocs-cli otl insert-content # 写入 AI 整理的周报 ↓ kdocs-cli aippt deep_research # 周报自动生成 PPT ↓ kdocs-cli drive get-file-link # 一键分享这是 5 个工具的组合1 分钟完成 4 小时的工作。场景 4多维表格搭建 CRM建一个客户跟进表字段姓名/公司/联系方式/跟进状态/下次联系时间 ↓ kdocs-cli dbsheet create_table schema12字段JSON ↓ kdocs-cli dbsheet create_view view_typekanban # 看板视图 ↓ kdocs-cli dbsheet create_view view_typecalendar # 日历视图 ↓ kdocs-cli dbsheet create_webhook # 跟进状态变更触发提醒从零搭建 CRM 系统3 分钟。场景 5知识库整理我的金山文档知识库里有 200 篇杂文按主题分类整理 ↓ kdocs-cli kwiki list_items # 列出所有 ↓ AI 聚类分析主题 ↓ kdocs-cli kwiki create_knowledge_view nameAI 主题 ↓ kdocs-cli kwiki batch_move_items # 批量移动知识管理从乱糟糟到井井有条。七、同类对比它和 office-cli / tencent-docs 有什么区别这是最常被问到的问题我直接做一张表维度kdocs-skilloffice-clitencent-docsnotion-skill服务对象金山文档本地 Office腾讯文档NotionAPI 来源官方 OpenAPI自实现多协议官方 OpenAPI官方 API生态绑定强必须 WPS 账号弱本地文件强必须腾讯账号强必须 Notion 账号核心能力云端协作 AI本地 Office 自动化智能表格 知识库块级编辑 数据库多维表格✅ dbsheet❌✅ 智能表格✅ DatabaseAI PPT✅ aippt✅❌❌网页剪藏✅ scrape_url❌✅❌知识库✅ kwiki❌✅ 知识空间✅ 块引用CLI 形式✅ kdocs-cli✅ officecli❌❌国内访问✅✅✅⚠️ 需梯子协作能力⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐离线能力⭐⭐⭐⭐⭐⭐⭐⭐一句话总结office-cli本地 Office 自动化之王强在离线、跨平台tencent-docs腾讯生态的 Notion 替代团队协作强notion-skillNotion 原生 AI 集成块级编辑最优雅kdocs-skill金山文档原生 AI 接入国内访问友好5 亿用户基础如果你/你的团队是 WPS 重度用户kdocs-skill是唯一选择。八、优缺点诚实评价✅ 优点1. 官方背景可靠性极高金山办公官方出品不会突然废弃Token 体系安全。2. 工具覆盖最全40 工具9 大服务从智能文档到多维表格到知识库到 AI PPT没有死角。3. 工程化做得好Token 用系统密钥链管理中文长内容用 file 传参幂等性、重试、错误码字典都是教科书级别版本自检三步法实用4. 国内访问友好不需要梯子Token 就是你的 WPS 账号。5. CLI 形态对 AI 友好kdocs-cli drive search-files keywordxxx这种命令AI 调用起来最自然。❌ 缺点1. 必须有金山文档账号门槛存在但 5 亿人都有门槛其实很低。2. Token 体系——目前只支持国内版kdocs.cn / wps.cn不支持国际版wps.comGitHub Issue #73062 已经在跟踪了但还没有合并。这是国际化团队的最大痛点。3. 部分操作有高风险约束14 个高风险工具如delete_records、close_knowledge_view必须用户确认。这是好事但在自动化场景下可能需要先auth set-token --skip-confirm才能跑批处理。4. 写入类操作不幂等create_file、otl.insert_content、wpp.execute重试需要先检查状态对长流程工作流要做断点续传。5. 学习曲线40 工具对新手来说需要花 1-2 小时才能掌握核心用法。九、5 个黄金组合kdocs-skill不是孤岛搭配其他 Skill 威力更大。组合 1周报生成器kdocs-skill agent-browser summarize1. agent-browser 抓取飞书/钉钉的周报源数据 2. summarize 生成 500 字摘要 3. kdocs-skill 写入金山文档周报模板组合 2知识库流水线kdocs-skill tavily-search another-them1. tavily-search 搜索行业最新动态 2. another-them 用芒格思维模式整理 3. kdocs-skill 入库到 kwiki 知识库组合 3客户管理自动化kdocs-skill email-management messaging-integration1. email-management 读取客户邮件 2. messaging-integration 读取微信沟通 3. kdocs-skill dbsheet 自动更新客户跟进表组合 4内容创作全流程kdocs-skill xiaohongshu-mcp summarize1. summarize 提炼爆款内容规律 2. xiaohongshu-mcp 一键发布 3. kdocs-skill 归档到内容运营知识库组合 5AI PPT 一键生成kdocs-skill wechat-clawbot ai-web-automation1. wechat-clawbot 接收微信群发来的做PPT指令 2. kdocs-skill aippt 生成 PPT 3. ai-web-automation 上传到 WPS 演示 4. 把分享链接回发到群里十、写在最后它教会了我什么写完这篇深度报告我最大的感受是AI Agent 的真正革命不是更聪明的模型而是更深的生态连接。kdocs-skill让我重新理解了在线文档。它不只是一个 Skill它是金山办公在 AI 时代给 5 亿用户的一份使用说明书。很多团队花了 30 年建立自己的文档体系AI 想要接入需要 1 个 Token、1 个 CLI、1 套工程化设计。kdocs-skill把这3 个 1做到了极致。它不是那只最强壮的龙虾但它是最懂金山文档的那只。 快速安装清单# 1. 安装 CLI powershell scripts/setup.ps1 # 2. 登录 kdocs-cli auth login # 3. 第一次搜索 kdocs-cli drive search-files keyword周报 typeall # 4. 创建第一个文档 kdocs-cli drive create-file name我的第一个 AI 文档.otl file_typefile # 5. 写点东西 kdocs-cli otl insert-content file_idid contentHello from AI Agent posend5 步10 分钟让你的 OpenClaw 真正接管金山文档。 让 AI 干活从一只会写文档的龙虾开始。字数约 4,500 字
