前言¶
很多团队把周报、合同、报名表和知识库都放在金山文档（WPS 云文档 / Kdocs，365.kdocs.cn、www.kdocs.cn）里。Agent 若只能生成一段 Markdown 或本地文件，还要人工上传、改格式、设分享权限，链路会断在「云盘里那一份真文档」上。下面介绍 SkillHub 上的「金山」：把新建、读取、编辑、搜索、分享与整理等能力接到 Agent 侧，让任务尽量在云端文档上闭环。
这是什么¶
「金山」是面向金山文档云端的官方 Skill（坐标 @user_d6510c26/jinshanwenjian，当前版本 1.0.0）。它在 SkillHub 中归类为 office-efficiency，来源为 community，由发布者 user_d6510c26 维护；SkillHub 页面标注作者为「小燕」。
一句话定位：当用户任务涉及云文档操作时，由 Agent 按 Skill 指引调用金山文档相关能力，而不是只产出无法直接落盘的文本。
核心功能¶
以下能力均来自 SkillHub 官方简介，未单独列出的接口或参数不在本文展开。
文档类型与基础操作¶
支持在云端处理多种在线文档形态，包括：
- 智能文档、Word、Excel、PDF、PPT、演示文稿
- 智能表格、多维表格
- 个人知识库
围绕这些对象，Skill 声明覆盖：新建、读取、编辑、搜索、分享、整理。
官方列举的典型任务¶
简介中明确适用于（包括但不限于）：
| 方向 | 示例 |
|---|---|
| 办公写作 | 周报 / 日报 / 工作汇报 |
| 商务与票据 | 合同、发票处理 |
| 表单与收集 | 报名表、登记表、信息收集、接龙转表格 |
| 内容与 AI | 文档总结与内容生成、改写仿写、翻译、AI PPT 生成 |
| 文件处理 | PDF 拆分导出、网页剪藏 |
| 整理与知识 | 标签分类归档、收藏管理、碎片笔记整理、表格美化、回收站还原、知识库管理 |
Skill 标签包含 requires_api_key=true，表示启用前需要配置 API Key；具体环境变量或配置项名称以安装包内 SKILL.md 为准，本文不臆造字段名。
安装与启用¶
1. 准备 SkillHub CLI¶
先确认本机是否已安装 skillhub：
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
说明与命令出处：SkillHub 安装与优先源配置。
2. 安装「金山」Skill¶
SkillHub 技能页给出的安装指引为：根据上述安装文档，安装坐标 @user_d6510c26/jinshanwenjian。
用 CLI 安装时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。通用命令形式如下（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install @user_d6510c26/jinshanwenjian --dir <skills 目录>
SkillHub 文档中列出的常见 skills 目录示例：
| 客户端 | 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安装后按所用 Agent 的要求重启或刷新技能列表，并按要求配置 API Key（标签 requires_api_key=true）。
3. 通过自然语言让 Agent 安装（可选）¶
也可将 SkillHub 页面上的提示词发给 Agent，大意是：请根据 https://skillhub.cn/install/skillhub.md 安装 @user_d6510c26/jinshanwenjian。适合尚未配置 CLI、但希望 Agent 自行拉取技能的场景。
典型用法¶
本 Skill 基于通用 SKILL.md 格式：Agent 读取技能说明后，在用户自然语言意图与金山文档能力之间做路由。下列示例与官方简介中的场景一致，表述方式可按实际对话调整，无需记忆固定 API 名。
-
写周报并落到云文档
「在金山文档里新建一份本周工作汇报，结构包含：本周完成、风险、下周计划；标题用今天的日期。」 -
表格与收集
「把这次接龙里的姓名和手机号整理成智能表格，并保存到我的云文档。」 -
阅读与总结
「打开我云文档里名为『XX 项目纪要』的文档，总结三条结论并写回文档末尾。」 -
分享与整理
「给这份合同 PDF 设置仅指定同事可查看的分享链接，并把文档打上『法务』标签归档。」 -
知识库
「把这几条碎片笔记合并进个人知识库对应文件夹，并删除重复条目。」
经过上面的步骤，Agent 应在 Skill 约束下调用云文档能力；若某一步需要 Key 或账号授权，按 SKILL.md 与 Agent 提示完成配置后再重试。
适用场景与注意¶
适合谁
- 日常重度使用 WPS 云文档 / Kdocs 的团队或个人
- 希望 Agent 直接改「线上那份」文档，而不是只生成本地草稿的开发者或效率用户
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，并愿意通过 SkillHub 管理技能
限制与注意
- 需有效的金山文档账号及 Skill 要求的 API Key；未配置时相关调用会失败。
- 简介中的能力以 Skill 实现为准；复杂排版、企业权限策略等仍以金山文档产品侧规则为上限。
- SkillHub 抓取信息显示：评分 100000，下载 4004（统计随 SkillHub 更新变化）；安装前可在技能页核对版本 v1.0.0 与说明是否仍符合预期。
- 安装目录务必使用
--dir指向当前 Agent 的 skills 路径，避免装错位置。
结尾¶
「金山」把 Agent 的对话能力接到金山文档云端：新建与编辑、搜索分享、表格与知识库整理等，都可在 SkillHub 简介所声明的范围内由技能指引完成。需要查看说明、复制安装提示或核对版本时，请访问官方技能页：
- SkillHub：https://www.skillhub.cn/skills/user_d6510c26/jinshanwenjian
- API 条目：https://api.skillhub.cn/user_d6510c26/jinshanwenjian
