kdocs skill

价格

以上为公开标价。你的组织可能有协议价，以控制台显示的价格为准。

如何使用

1. 1

   为组织安装

   开通即安装：组织固定使用开通时的版本（当前为 1.0.0）。升级到新版本需要取消后重新开通。

2. 2

   创建凭证

   客户端使用组织凭证读取；绑定到数字人后，数字人使用绑定凭证按需加载。请求中携带：

   Authorization: Bearer $ZGI_MARKET_KEY

3. 3

   读取清单与安装包

   清单列出版本、文件和校验值；安装包是一个 zip 文件。

   curl "https://market-api.zgi.im/v1/market/skills/kdocs-skill/manifest" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY"

   curl "https://market-api.zgi.im/v1/market/skills/kdocs-skill/package" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY" \
     -o kdocs-skill.zip

   读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称

kdocs

说明

操作金山文档（WPS 云文档 / Kdocs / 365.kdocs.cn / www.kdocs.cn）云文档的官方 Skill。核心能力覆盖云端新建、读取、编辑、搜索、分享、整理在线文档（智能文档、Word、Excel、PDF、PPT、演示文稿、智能表格、多维表格）及个人知识库。当用户的任务涉及云文档操作时使用，包括但不限于：写周报/日报/工作汇报、处理合同/发票、创建报名表/登记表、网页剪藏、接龙转表格、信息收集、文档总结与内容生成、改写仿写、翻译、AI PPT生成、PDF拆分导出、标签分类归档、收藏管理、碎片笔记整理、表格美化、回收站还原、知识库管理。

# 金山文档 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`）
- 创建云文档文件并验证通过后，必须向用户展示可访问链接。若响应包含 `data.link_url` 则直接展示；若响应无链接时，调用 `get_file_link` 获取并展示。
- 调用工具前必须先阅读对应的 `references/` 详细参考文档，禁止仅凭指南（guide）的概要说明直接拼装调用；参数细节（类型、可选值、约束）以工具参考文档为准

---

## 保持最新版本
何时触发：**首次使用** Skill / **距上次自检 >24h** / **收到 `unknown action` 或 `unknown service` 错误**。

1. **CLI 版本**：`kdocs-cli version` — 若命令不存在则按下方「工具安装与认证」安装；若低于本文件 frontmatter `version`，运行 `kdocs-cli upgrade -y`（自动备份旧版本，失败可 `kdocs-cli upgrade --rollback`）
2. **Skill 版本**：若本文件 `version` 低于 `kdocs-cli version`，运行 `kdocs-cli call check_skill_update version=2.5.29 skill_name=kdocs`，若返回 `update_available: true`，从 `instruction` 中提取 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>"` · 无 Token: `kdocs-cli auth login` |

login 失败时的手动获取流程、`auth status` 诊断、`auth logout` 退出等详见 `references/auth.md`。

---

## 调用格式

kdocs-cli <service> <action> [参数]

### 参数传递

| 参数特征 | 推荐方式 | 示例 |
|----------|----------|------|
| 简单值（无中文） | 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` / stdin 输入必须是该工具的**完整 JSON 参数对象**
- 中文/多行参数**禁止** key=value（Windows/PowerShell 破坏 UTF-8 编码）
- 生成 JSON 文件用 Node.js/Python；**禁止** ConvertTo-Json（输出带 BOM）
- PowerShell 传 JSON 字符串须反斜杠转义：`'{\"key\":[\"val\"]}'`

> **--file 示例**：写入大段内容时，用脚本生成 JSON 文件再 `--file` 传入，操作完成后删除临时文件：
>
> ```javascript
> const fs = require('fs');
> fs.writeFileSync('payload.json', JSON.stringify({
>   file_id: "<file_id>",
>   content: fs.readFileSync('article.md', 'utf8'),
>   format: "markdown",
>   mode: "append"
> }), 'utf8');
> ```
> ```
> kdocs-cli otl insert-content --file payload.json --silent
> ```
> ```javascript
> // 操作完成后清理临时文件
> fs.unlinkSync('payload.json');
> ```

**全局选项**：

• SKILL.md16.9 KiB
• _meta.json105 B
• references/aippt.md9.1 KiB
• references/auth.md1.7 KiB
• references/dbsheet.md11.6 KiB
• references/dbsheet/dashboard.md1.8 KiB
• references/dbsheet/data_table.md19.3 KiB
• references/dbsheet/field.md28.3 KiB
• references/dbsheet/form.md4.9 KiB
• references/dbsheet/parent_child.md6.9 KiB
• references/dbsheet/permission.md16.0 KiB
• references/dbsheet/record.md37.0 KiB
• references/dbsheet/share.md11.0 KiB
• references/dbsheet/view.md7.7 KiB
• references/dbsheet/webhook.md5.5 KiB
• references/drive.md9.6 KiB
• references/drive/comment.md7.9 KiB
• references/drive/create_and_upload.md22.3 KiB
• references/drive/doclib.md4.2 KiB
• references/drive/label.md9.3 KiB
• references/drive/organize.md6.7 KiB
• references/drive/read_and_download.md17.9 KiB
• references/drive/recent_and_recycle.md2.8 KiB
• references/drive/search.md4.9 KiB
• references/drive/share.md24.5 KiB
• references/drive/star.md2.5 KiB
• references/drive/versions.md3.9 KiB
• references/file-locating-guide.md2.2 KiB
• references/form.md5.6 KiB
• references/form/create_draft.md3.5 KiB
• references/form/get_form_info.md2.0 KiB
• references/form/publish_draft.md2.2 KiB
• references/form/update_draft.md3.7 KiB
• references/kwiki.md11.4 KiB
• references/kwiki/close_knowledge_view.md694 B
• references/kwiki/create_item.md1.5 KiB
• references/kwiki/create_knowledge_view.md1.6 KiB
• references/kwiki/delete_item.md1.3 KiB
• references/kwiki/get_knowledge_view.md2.2 KiB
• references/kwiki/import_cloud_doc.md1.4 KiB
• references/kwiki/list_items.md2.7 KiB
• references/kwiki/list_knowledge_views.md1.6 KiB
• references/kwiki/update_knowledge_view.md1.3 KiB
• references/otl.md4.9 KiB
• references/otl/block_delete.md2.0 KiB
• references/otl/block_insert.md2.1 KiB
• references/otl/block_query.md1.0 KiB
• references/otl/block_update.md7.9 KiB
• references/otl/convert.md1.5 KiB
• references/otl/insert_content.md5.4 KiB
• references/otl/node.md17.1 KiB
• references/pdf.md7.7 KiB
• references/pdf/convert.md5.8 KiB
• references/pdf/inspect.md1.0 KiB
• references/pdf/split_and_merge.md13.0 KiB
• references/pdf/translate.md10.8 KiB
• references/sheet.md16.1 KiB
• references/sheet/conditional_format.md13.0 KiB
• references/sheet/data.md72.7 KiB
• references/sheet/data_validations.md8.2 KiB
• references/sheet/filters.md9.3 KiB
• references/sheet/float_images.md7.3 KiB
• references/sheet/protection_ranges.md10.7 KiB
• references/sheet/worksheet.md9.7 KiB
• references/workflows/aippt-full-text.md6.1 KiB
• references/workflows/aippt-single-page.md1.5 KiB
• references/workflows/form-generator.md1.2 KiB
• references/workflows/import-slides.md2.7 KiB
• references/workflows/jielong-to-table.md1.6 KiB
• references/workflows/knowledge-format.md1.7 KiB
• references/workflows/knowledge-save.md1.6 KiB
• references/workflows/periodic-read-summary.md650 B
• references/workflows/precise-search-analysis.md955 B
• references/workflows/search-read-report.md850 B
• references/workflows/smart-classify.md1.8 KiB
• references/workflows/table-beautify.md7.2 KiB
• references/workflows/web-scrape.md1.3 KiB
• references/wpp.md5.3 KiB
• references/wpp/execute.md4.1 KiB
• references/wpp/export.md4.8 KiB
• references/wpp/jsapi_shape.md2.6 KiB
• references/wpp/jsapi_slide.md2.5 KiB
• references/wpp/slide.md3.8 KiB
• references/wpp/theme.md4.2 KiB
• references/wps.md56.2 KiB
• references/wps/character-format.md2.6 KiB
• references/wps/content.md2.9 KiB
• references/wps/enums.md3.0 KiB
• references/wps/execute.md4.0 KiB
• references/wps/paragraph-format.md3.6 KiB
• scripts/setup.cjs7.6 KiB
• scripts/setup.sh5.9 KiB

来源与审核

审核状态

尚未审核，内容来自上游来源

来源文档

https://api.skillhub.cn/user_5ea84866/kdocs-skill

许可证

未说明

审核状态是平台对上架信息的记录，不构成对上游服务质量或可用性的担保。