前言¶
在 Agent 里处理在线文档，常见做法是整文件下载、本地改完再上传，或只调用少数开放接口。段落级修改、多维表格字段自动化、合规扫描与 Webhook 联动往往要你自己拼脚本。若团队文档落在金山文档（WPS）上，又希望 Agent 能按品类走不同编辑策略，就需要一套对齐 WPS 开放平台、并把本地能力与云端 API 分开封装的 Skill。
下面介绍 SkillHub 社区 Skill「金山文档 KingDoc」（坐标 @user_1a470ba8/kingdoc，当前版本 4.3.5），它面向 9 类在线文档的全生命周期管理，并声明在腾讯文档同类能力之上提供 21 项金山侧增强。
这是什么¶
金山文档 KingDoc 是发布在 SkillHub 上的 office-efficiency 类 Skill，来源为 community，维护者为 user_1a470ba8。
一句话定位：金山文档 AI 协作助手，深度直连金山文档（WPS）开放平台原生 API，覆盖文档、智能画布、电子表格、演示文稿、多维表格、收集表、可视化、历史管理、全文搜索、附件等品类。
Skill 页标注 requires_api_key=true，即调用 WPS 开放平台等云端能力通常需要配置密钥；同时官方说明中列出大量「零密钥可用」能力（本地生成、OCR、硬件画像、WPS AI、全文搜索、块级编辑、配额管理、桥接、AirScript、视图渲染、CRDT、数据 I/O、Webhook、知识中枢、政企合规、主题生成、跨品类对比、合规门面、行业分包、周扫定时化、配额告警等）。实际使用时以 Skill 内文档为准：涉及云文档读写、空间级操作前应先完成 API 配置。
核心功能¶
以下均来自 SkillHub 官方简介，按品类与版本能力归纳。
九品类与编辑策略¶
| 品类 | 管理方式（官方描述） |
|---|---|
| 文档 / 演示 / 可视化 | 本地生成 → 上传覆盖 |
| 电子表格 / 多维表格 | 开放平台 API 精细编辑 |
| 智能画布 | 元素级 CRUD + Markdown 增量追加 |
| 块级编辑 | 段落级在线编辑，替代整文件替换 |
其余品类（收集表、历史管理、全文搜索、附件等）纳入同一套全生命周期管理叙事中。
金山侧增强（21 项，节选）¶
官方列举包括但不限于：回收站、版本历史、格式转换（覆盖 jpg/png/txt 等）、纯文本提取、本地 OCR（优先桥接 wps-office-suite，未安装则用 Tesseract 兜底，数据不出域）、通知推送、Webhook、批量任务、政企合规、硬件自适应性能、WPS AI、协同冲突解决、文档合规检查、实时协同编辑、文档对比、模板市场、多维表格视图增强、手写/公式识别、智能画布元素级编辑、全文搜索、块级编辑、演示页替换、配额管理器、wps-office-suite 双向桥接、zwjh 记忆库打通、表单答卷收集统计、AirScript 在线自动化、多维表格字段自动化、看板/甘特图视图渲染、CRDT 表格扩展（单元格级无冲突协作）、Excel/CSV 双向导入导出（date/link/select/person 四类字段序列化）、Webhook 与通知中心（三通道分发 + 签名校验 + SQLite 去重）。
v4.1：多维表格与在线自动化¶
- AirScript：自然语言 → 脚本生成 → 预检 → 确认 → 在线执行。
- 字段自动化：公式、关联、汇总字段。
- 视图渲染：matplotlib 看板柱图、mermaid 甘特时间线。
- CRDT 表格扩展：单元格级操作日志 + 向量时钟冲突标记。
- Excel/CSV 双向 I/O：四类字段序列化。
- Webhook 通知中心：新增/修改/删除事件订阅，金山协作 / 企微 / 钉钉三通道。
v4.2：知识中枢与政企合规¶
- 团队知识库：空间级倒排检索 + 权限矩阵过滤（先鉴权后检索）。
- 政企合规中心：密级标注落库、敏感词与数据泄露全量扫描报告、数据不出域声明。
- 主题一键生成：WPS AI 适配层 generate（大纲 → 智能文档/PPT/表格初稿，本地降级可切换真源）。
- 跨品类对比与时间线：版本历史轮询得到 who/when/what，表格支持单元格级 diff。
- OCR 收敛：单一入口，优先 wps-office-suite，否则 Tesseract。
v4.3：合规中心 v2 与运维告警¶
- 合规套件门面：单入口
quick_scan/full_scan，合并 v4.2 政企合规与 v3.4 内容合规检查，敏感词加载逻辑统一。 - 行业敏感词分包：base 通用 + 教培 / 医疗 / 金融 / 政务，各 200+ 词条，多包叠加；报告按高/中/低风险分级并定位段落与责任人字段。
- 全域扫描定时化：
schtasks周扫空间，新检出项经 webhook 三通道签名推送，跨周去重只推新增。 - 配额管理器阈值告警：用量 80% / 95% 两级经 webhook 三通道推送，按天 + 级别幂等。
安装与启用¶
Skill 基于通用 SKILL.md 格式。官方页面给出的安装方式为：让 Agent 按 SkillHub 安装文档操作，并安装坐标 @user_1a470ba8/kingdoc。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文：https://skillhub.cn/install/skillhub.md。
2、安装 KingDoc 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。
skillhub install @user_1a470ba8/kingdoc --dir <skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中直接发送官方提示词：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_1a470ba8/kingdoc`。
3、API 密钥与零密钥能力¶
Skill 标签为 requires_api_key=true。连接 WPS 开放平台、在云空间创建或修改文档等操作，需在 Skill 说明或环境变量中配置相应密钥（具体字段名以安装后的 SKILL.md 为准）。
本地生成、OCR、合规扫描门面、Webhook 配置、配额告警等官方列出的能力可在无密钥场景下使用部分路径；若任务涉及云文档 ID、空间权限或在线协同，应提前完成开放平台授权。
典型用法¶
官方页面未提供独立 CLI 示例命令，典型用法是通过已安装 Skill 的 Agent 用自然语言编排下列能力（表述需与 SKILL.md 中的工具名一致）。
- 写文档 / 做 PPT / 可视化：描述大纲或修改意图 → Skill 本地生成内容 → 上传覆盖对应金山文档。
- 改表格 / 多维表格：说明单元格、字段或视图需求 → 走 API 精细编辑；需要自动化时可走 AirScript（生成脚本 → 预检 → 确认 → 在线执行）。
- 智能画布：对画布元素增删改，或以 Markdown 增量追加内容。
- 块级编辑：指定段落级修改，避免整份文件替换。
- 合规：调用合规门面
quick_scan或full_scan；政企场景可叠加行业敏感词包；需要持续治理时可配置schtasks周扫与 webhook 推送。 - 运维与集成：订阅文档变更事件，经金山协作 / 企微 / 钉钉推送；配额接近 80% / 95% 时接收告警。
经过上面的步骤，Agent 会把「品类差异 + 本地/云端分工」封装在 Skill 内，你主要描述业务目标而非手写开放平台请求。
适用场景与注意¶
适合谁
- 文档主阵地是金山文档 / WPS，希望 Agent 统一处理多品类文档与附件。
- 需要多维表格自动化、CRDT 协作、Excel/CSV 往返、看板/甘特视图渲染等增强，而不只想做简单上传下载。
- 政企或内网场景关注合规扫描、密级标注、数据不出域 OCR，以及定时扫描 + Webhook 告警。
限制与注意
- 云端能力依赖 WPS 开放平台密钥与账号权限；未配置时只能使用官方列出的零密钥子集。
- OCR 优先依赖 wps-office-suite 桥接；无桥接时回退 Tesseract，识别效果与环境有关。
- 周扫、webhook、配额告警涉及本机
schtasks与三通道配置，需在目标环境实测签名与去重逻辑。 - SkillHub 页面统计（截至资料抓取）：评分 100000，下载 4750；版本以页面标注的 4.3.5 为准。
结尾¶
金山文档 KingDoc 把 WPS 九品类文档管理、21 项增强能力以及 v4.1–v4.3 的自动化与合规能力收敛为一个 Agent Skill，并区分「本地生成上传」与「表格 API 精编」两条主路径。若你正在 SkillHub 上选型办公效率类 Skill，可从官方页查看完整能力列表并安装 @user_1a470ba8/kingdoc。
