| name | anyshare-mcp-skills |
| description | AnyShare 企业云盘技能。支持：搜索文件、上传/下载文件、分享链接读取、全文写作（生成大纲→确认→写正文）、Bot 智能问答。触发词：AnyShare、asmcp、文档库、文件管理、知识库、anyshare.aishu.cn 分享链接。 |
| homepage | https://anyshare.aishu.cn |
| metadata | {"openclaw":{"category":"productivity","emoji":"📁","requires":{"bins":["agent-browser","mcporter"]},"openclawSkillsEntryFile":"openclaw.skill-entry.json"}} |
AnyShare MCP 技能
首次使用本技能时，配置步骤的权威来源是 setup.md。
SKILL.md 只做摘要+跳转，配置细节以 setup.md 为准（避免两处表述漂移）。
⚠️ 执行前必读
强制前置阅读（按需必读，否则跳过）
| 操作 | 必须先读 | 为何 |
|---|
| 首次使用本技能（配置 asmcp.url） | setup.md 全章 | 配置步骤唯一权威来源；包含 mcporter.json 写入、daemon 重启、openclaw.json 合并、企业地址确认话术 |
| 执行任何认证 / auth_login 前 | references/auth.md 第 1~5 步 | 认证流程步骤编号、Cookie 提取方式、状态文件路径均以此为准 |
| 调用任何业务工具（file_search / upload / download 等）前 | references/tool-params.md 对应工具节 | 参数格式（key=value）、固定字段、禁止传参、不传参；与此处示例保持一致 |
| 进入场景四（全文写作）前 | 本 SKILL.md → 场景四 → C8 进门卡点 | 必须持 docid；未持则先走 file_search 或场景五 获取，禁止绕过（C8 违规） |
| 排障 / 401 / 认证失败 | references/troubleshooting.md | 错误码含义、常见现象与处理方式均在此 |
硬卡点表
| # | 规则 | 关联场景 |
|---|
| C1 | 搜索文件只用 file_search，禁止 RAG 类工具或目录树展开 | 场景一 |
| C2 | 展示搜索/列目录结果前，必须先调 file_convert_path 再输出（禁止跳过） | 场景一、场景五 |
| C3 | 上传/下载前，必须用户明确回复"是"确认 docid，禁止代选 | 场景二、场景三 |
| C4 | 大纲未确认前禁止调用 __大纲写作__1（大纲门闩） | 场景四 |
| C5 | source_ranges[].id 必须传 id（docid 最后一段），禁止传完整 docid | 场景四 |
| C6 | 禁止用 screenshot 解析分享链接的 item_id，以 agent-browser get url 为准 | 场景五 |
| C7 | item_id 禁止臆造，须从实际访问后的 URL 中解析 | 场景五 |
| C8 | 进入 chat_send（全文写作）前必须持有 docid。若尚无 docid，须先通过场景一（关键词搜索）或场景五（解析分享链接）获取，禁止自行判断"docid 不可用"而绕过本文档处理流程另起炉灶。 | 场景四 |
| C9 | 在场原则（System-Internal-Only）：持有 docid 后，所有后续操作（阅读、摘要、写作、导出）必须通过 AnyShare 工具完成，禁止下载到本地后跳出系统处理。C8 管"进入"，C9 管"离开"。 | 所有含 docid 的场景 |
🔄 完整执行流程
用户输入
│
▼
① 首次使用？── 是 ──→ 阅读 setup.md，执行 Step 1~4
│ → 向用户汇报 asmcp.url + 连通性
│ → 确认是否为**本企业**正式端点
否
▼
② 认证检查（自动）── 失败 ──→ 认证恢复（references/auth.md 第 1~6 步）──→ 重试验证
│ │
│ 通过 ◀────────────────────────────────────┘
▼
③ 意图识别
│
├─ 分享链接？── 是 ──→ 场景五（读取链接 → 获取 docid）
│
├─ 书写类诉求？（生成/撰写/改写/续写/润色/文章/报告/文案/大纲/材料）── 是 ──→ 确认全文写作？
│ │
│ 是 ◀─────────────────┘
│ ▼
│ ⚠️ C8 强制预检：
│ "是否已持有本次写作所需的 docid？"
│ 否 ──→ 场景一（关键词搜索）获取 docid
│ │ 或场景五（解析分享链接）获取 docid
│ │ 获取后返回此节点重新判断
│ 是
│ ▼
│ 场景四：全文写作
│ ① docid/id → ② 大纲 → ③ 确认 → ④ 正文
│
│ 否 ──→ chat_send 简化问答
│
├─ 搜索 / 查看文件 ──→ 场景一
│
├─ 上传文件 ──→ 场景二
│
└─ 下载文件 ──→ 场景三
📌 核心概念速查
| 术语 | 说明 | 传参规则 |
|---|
| docid | 完整路径，gns:// 开头，是文档在 AnyShare 系统内的唯一标识 | 传给 folder_sub_objects、file_upload、file_osdownload、file_convert_path（均须完整 gns://…） |
| id | docid 的最后一段 | 传给 chat_send 的 source_ranges[].id（不传完整 docid，见 C5） |
| namepath | 云盘展示用路径，由 file_convert_path 返回 | 仅供阅读，不作 docid 传参 |
| sharedlink | https://anyshare.aishu.cn/link/AR... | 用 agent-browser get url 解析 item_id |
完整说明：references/concepts.md
🏛️ AnyShare 在场原则（System-Internal-Only Principle）
这是本技能最根本的运行假设，所有场景均以此为前提。
原则内容
一旦通过 AnyShare 系统获取到 docid，该文档的所有后续操作都必须通过 AnyShare 工具完成，禁止跳出系统处理。
换言之：
- ✅ 持有 docid → 用
chat_send（全文写作 / 摘要 / 问答）
- ✅ 持有 docid → 用
file_convert_path（查看路径）
- ✅ 持有 docid → 用
file_osdownload（下载，但下载后仍须回到 AnyShare 工具链处理）
- ❌ 持有 docid，却去下载文件到本地后用外部工具（markitdown、LLM 直接总结等）"替代" AnyShare 工具链 → 在场原则违规
为什么这条原则重要
docid 是文档在 AnyShare 系统内的"在场证明"。AI 一旦持有 docid，意味着文档已经在 AnyShare 的管理范围内。跳出系统去处理，等于放弃了 AnyShare 已有的权限管控、操作审计、内容安全策略，是系统性风险。
典型失控模式（供自检）
| 失控模式 | 为什么会发生 | 正确做法 |
|---|
| "已有 docid，但还是下载了 PPTX 用 markitdown 提取内容" | AI 认为"外部工具效果更好" | 用 chat_send + source_ranges 替代 |
| "已有 docid，但决定直接帮用户总结内容" | AI 认为"用 LLM 总结更快" | 用 chat_send 简化问答替代 |
| "已有 docid，但去查本地文件" | AI 遗忘了 docid 的存在 | 回到 docid，用 AnyShare 工具继续 |
在场原则与 C8 的关系
C8 约束的是"进入 chat_send 前必须持有 docid"，在场原则约束的是"持有 docid 后不得离开 AnyShare 系统"。两者共同构成了完整的边界控制：C8 管入口，在场原则管出口。
📂 场景一：文件/关键词搜索
前置阅读：tool-params.md → file_search 节（参数格式+固定字段说明）
步骤
第 1 步：file_search
{
"name": "file_search",
"arguments": {
"keyword": "<用户关键词>",
"type": "doc",
"start": 0,
"rows": 25,
"range": [],
"dimension": ["basename"],
"model": "phrase"
}
}
⚠️ dimension: ["basename"] + model: "phrase" 必须固定，不随关键词变化。省略会导致正文/多字段命中，而非按名匹配。
第 2 步：展示结果（必须含三要素）
对每条结果：先调 file_convert_path → 再展示：
- 名称：
basename
- 大小：
size = -1 → 目录；size ≥ 0 → 实际字节数
- 云盘路径：
namepath（来自 file_convert_path 返回）
⚠️ C1 + C2：禁止跳过 file_convert_path；禁止用 docid/序号代替 namepath 展示。
第 3 步：用户确认 docid（如需操作）
分页提示（hits ≥ 25 时强制显示）：
找到 X 条（已展示前 25 条），是否：
- 查看更多（翻页） 2. 更换关键词 3. 缩小范围（加 range）
按文件夹名查看子文件：
- 搜索结果中找
size = -1 且 basename 一致的项
- 对该 docid 先调
file_convert_path 展示目录 namepath（C2）
- 再调
folder_sub_objects 列出子文件
📂 场景二：上传文件
步骤
第 1 步：搜索目标目录（file_search + file_convert_path，必须 C3）
展示确认模板：
即将上传到：
- 文件名：
<本地文件名>
- 云盘路径：
file_convert_path 返回的 namepath
- docid：
gns://...
确认继续？回复"是"，或提供其他目标路径。
第 2 步：用户回复"是"后锁定 docid（C3）
第 3 步：file_upload
{
"name": "file_upload",
"arguments": {
"docid": "<用户确认的 docid（完整）>",
"file_path": "<本地真实路径>"
}
}
第 4 步：汇报
- docid 必须展示为
gns:// 开头完整路径（禁止只展示 id/十六进制串）
- 对新文件 docid 调
file_convert_path，一并展示 namepath
📂 场景三：下载文件
步骤
第 1 步：搜索目标文件（file_search + file_convert_path，必须 C3）
展示确认模板：
即将下载：
- 文件名：
<basename>
- 大小：
<size> 字节
- 云盘路径：
file_convert_path 返回的 namepath
- docid：
gns://...
确认继续？回复"是"，或选择其他文件。
第 2 步：用户回复"是"后锁定 docid（C3）
第 3 步：file_osdownload
{
"name": "file_osdownload",
"arguments": {
"docid": "<用户确认的 docid（完整）>"
}
}
📂 场景四：全文写作
前置阅读：tool-params.md → chat_send 节（参数格式、source_ranges 传参规则）
入口：用户已确认走全文写作流程。
⚠️ C8 进门卡点（C-gate 0）：进入前必须持有 docid
这是本场景的第一道门。任何时候未持有 docid，都必须先出去获取，不得绕过。
进门前自问：
"我是否已为本次写作任务持有至少一个可用的 docid？"
- 是 → 进入步骤 1
- 否（docid 尚未获取） → 必须先执行以下之一：
- 路径 A：
file_search（关键词搜索）→ 获取 docid → 返回本场景
- 路径 B：场景五（解析分享链接）→ 获取 docid → 返回本场景
- 路径 C：若用户直接提供了文件 docid → 直接进入步骤 1
- 禁止：自行判断"docid 拿不到"而改用本地写作、摘要总结等绕过手段（违者属 C8 违规）
C8 违规示例（摘录本次失控案例，供自检）：
- "这些是本地 PPTX 文件，不是知识库文档，source_ranges 用不了，所以我直接自己写"→ C8 违规，正确做法是先把文件上传 AnyShare 或找到云端对应 docid 再调用 chat_send
- "这个文档没法获取 docid，直接帮用户总结好了" → C8 违规
⚠️ 大纲门闩（C4）
禁止跳过"生成大纲 → 用户确认"直接生成正文。
步骤
第 1 步：确认文档 id（已在 C8 获取）
- 分享链接 → 场景五解析出 id
- 关键词 →
file_search 确认文档 id
第 2 步：生成大纲（__全文写作__2）
{
"name": "chat_send",
"arguments": {
"query": "<用户写作任务描述>",
"selection": "",
"times": 1,
"skill_name": "__全文写作__2",
"web_search_mode": "off",
"datasource": [],
"source_ranges": [{ "id": "<文档的 id>", "type": "doc" }],
"template_id": 1,
"interrupted_parent_qa_id": ""
}
}
→ 展示大纲 → 等待用户确认（C4）
第 3 步：生成正文（__大纲写作__1）
仅在大纲确认后调用（用第 2 步返回的 conversation_id）：
{
"name": "chat_send",
"arguments": {
"query": "基于大纲生成文档",
"selection": "<已确认的大纲全文>",
"conversation_id": "<步骤2返回的 conversation_id>",
"times": 1,
"skill_name": "__大纲写作__1",
"web_search_mode": "off",
"datasource": [],
"source_ranges": [{ "id": "<文档的 id>", "type": "doc" }],
"interrupted_parent_qa_id": ""
}
}
第 4 步：导出（保存本地 / 上传至 AnyShare 复用场景二）
⚠️ C5：source_ranges[].id 传 id（docid 最后一段），不传完整 docid。
📂 场景五：分享链接读取
前置阅读：auth.md → 登录填表步骤（账号密码索取+snapshot -i 用法）
触发：用户提供 https://anyshare.aishu.cn/link/AR...
⚠️ C6 + C7：item_id 只能从 agent-browser get url 解析，禁止 screenshot，禁止臆造。
步骤
第 1 步：无头浏览器跟随重定向
agent-browser open "https://anyshare.aishu.cn/link/<分享ID>"
agent-browser wait --load networkidle
agent-browser get url ← 获取含 item_id 的落地 URL
第 1.5 步：遇登录页 → 填入账号密码
- 向用户当面索取账号 + 密码（禁止从文件读取）
agent-browser snapshot -i 获取无障碍树 refsfill 账号/密码 → click 登录 → wait --load networkidle- 再次
get url 获取登录后落地 URL
第 2 步：解析 URL 中的 item_id
- 从 URL 提取
item_id（已 URL 编码）
- 解码 → 完整 docid
- 取最后一段 → id
- 根据
item_type 分流：
folder → 第 3 步Afile / 其他 → 第 3 步B
第 3 步A：文件夹
file_convert_path → 展示目录 namepath（C2）folder_sub_objects → 列出子文件
第 3 步B：文件
- 走场景四（全文写作）：id 传给场景四第 1 步
- 或简化问答：
chat_send + source_ranges
🎯 意图模糊时的确认模板
当用户意图不清晰、无法判断是否在 AnyShare 操作或做哪类操作时，使用以下模板（仅一次，不叠套）：
请确认：
1. 目标系统：是否在 AnyShare 操作？
1) 是
2) 其他系统
2. 具体操作：
1) 搜索 / 查看文件
2) 上传或下载文件
3) 智能问答 / 全文写作
4) 其他（文档库浏览、换账号等）
回复示例：「1 2」表示在 AnyShare 上传或下载。
回复 → 执行路径：
| 回复 | 场景 |
|---|
1 + 1 | 场景一 |
1 + 2（上传） | 场景二 |
1 + 2（下载） | 场景三 |
1 + 3 | 场景四 |
1 + 4 | 澄清子意图 |
2 | 不走本技能 |
📖 补充资料（权威来源）
