Tencent Yunzhi

腾讯云知 / 乐享知识库 一站式操作

仅服务于腾讯乐享（lexiangla.com）知识库的搜索、创建、上传、编辑、下载、配置；自动识别 v1（团队文档）和 v2（知识库）。

⛔ 适用范围（必须最先判断，命中失败立刻退出）

本 Skill 仅适用于腾讯乐享（lexiangla.com / csig.lexiangla.com）知识库的操作。

✅ 触发条件（满足任一）

1. 用户消息含 lexiangla.com URL
2. 用户明确提及 "乐享 / 云知 / Lexiang / 知识库"，且上下文指向乐享平台
3. 用户已配置 LEXIANG_TOKEN，并明确要求 "上传到知识库 / 写入乐享 / 存到云知"

❌ 不适用场景（命中即立刻退出 Skill 上下文）

退出话术（统一模板）

这看起来不是乐享（云知）相关的请求。当前 Skill 仅处理 lexiangla.com 知识库操作。我会以普通对话模式继续帮你处理这个问题。

关键约束

• 判断为不适用后，禁止读取 modules/*.md 与 references/*.md（避免无意义 token 消耗）
• 禁止在不适用场景下调用任何乐享 MCP 工具或 1.0 REST API
• 退出后以模型本身能力继续对话，不再尝试触发本 Skill

🔧 环境与认证

MCP 连接（2.0）

配置文件模板见 mcp.json，写入 ~/.workbuddy/mcp.json 或 ~/.mcporter/mcporter.json。

REST API（1.0）

API_HOST = https://lxapi.lexiangla.com

Token 通用规则

lxmcp_ 前缀的 MCP Token 同时适用于 2.0 MCP 协议和 1.0 REST API：

• MCP：通过 mcp.json 中 headers.Authorization: Bearer lxmcp_xxx 传递
• REST：直接放 Authorization: Bearer lxmcp_xxx HTTP 头

⚠️ 乐享使用 Bearer Token 静态鉴权，不涉及 OAuth。Token 缺失/过期时引导用户访问 https://lexiangla.com/mcp?company_from=CSIG 获取或续期。

🔒 COMPANY_FROM 默认规则（永久约定，禁止改动）

• 默认值固定为 CSIG，所有 URL / 链接 / 配置场景都默认拼接 ?company_from=CSIG
• 仅当用户明确指定其他企业时才替换为对应值
• 涉及位置：mcp.json URL、Token 获取链接、401 续期链接、诊断报告默认值

若用户尚未绑定 Token，标准提示语：

你尚未绑定乐享（云知）MCP，无法检索知识库。 请打开下方链接获取你的 LEXIANG_TOKEN（lxmcp_ 开头）： https://lexiangla.com/mcp?company_from=CSIG 拿到 Token 后告诉我，我会帮你完成绑定（默认 COMPANY_FROM=CSIG）。

⚠️ 绝对禁止：引导用户在对话中直接粘贴完整 Token 明文。Token 必须由用户自行写入 mcp.json，或由 Skill 写入文件，不在对话流中传递。

🚥 操作前置门禁（强制）

任何调用 MCP 工具或 1.0 REST API 的操作之前，按下面顺序执行：

1. 当前 session 是否已通过健康检查？
   ├─ 已通过（缓存了 company_domain）→ 直接执行业务
   └─ 未通过 → Step 2

2. 调用 MCP whoami() （只读，无副作用）
   ├─ ✅ 成功 → 缓存 user.name + company.company_domain，本 session 后续不再检查
   ├─ ❌ 401 → 走「Token 已过期」分支，禁止重试业务
   ├─ ❌ 工具不存在 / 连接超时 → 走「连接故障诊断」分支（见 modules/setup.md Step 5）
   └─ ❌ 其他错误 → 输出错误码 + 建议，不重试

3. 健康检查未通过时：不要执行任何写入操作；读取类操作仅在用户明确允许"先看看再说"时尝试

🚦 路由规则

第零步：先过 Scope 守门（见上方"适用范围"），通过后才进入路由

第一步：URL 版本判断

当用户消息中包含 lexiangla.com 链接时，优先按 URL 路径判断版本：

一句话规则：/teams/ → v1，/t/ + /spaces/ + /pages/ → v2。

第二步：路由决策图

USER MESSAGE
    │
    ├─ Scope 守门未通过? ─── YES ──→ ❌ 退出 Skill
    │
    ├─ 含 lexiangla.com URL? ──── YES ──→ 健康检查 → 按 URL 模式路由
    │                                       /teams/.../docs/{doc_id}
    │                                         ├─ 获取正文 → GET /cgi-bin/v1/docs/{doc_id}/parsed-content
    │                                         ├─ 上传/编辑/删除 → modules/v1-docs.md
    │                                         └─ 上传图片 → modules/v1-assets.md
    │                                       /t/{id}/spaces 或 /spaces/{id}
    │                                         ├─ 上传文件 → modules/files.md
    │                                         ├─ 创建/导入 → modules/writer.md
    │                                         └─ 浏览/搜索 → modules/search.md
    │                                       /pages/{entry_id}
    │                                         ├─ 修改/编辑 → modules/blocks.md
    │                                         ├─ 上传文件 → modules/files.md
    │                                         ├─ 追加内容 → modules/writer.md（import_to_entry）
    │                                         ├─ 获取正文 → MCP entry_describe_ai_parse_content(entry_id)
    │                                         └─ 阅读/查看 → modules/search.md
    │
    └─ 不含 URL 但通过 Scope 守门 ──→ 健康检查 → 按意图关键词路由（见下表）

不含 URL 时的意图 → 模块映射

无法判断时：反问用户目标。禁止猜测目标知识库或目录。

⚠️ 通用规则

团队 ID 转换

1.0 REST API 的 team_id 参数需要 UUID 格式，不能直接用 URL 中的 code（如 k100684）。 转换方法：调用 MCP team_describe_team(team_id="k100684") → 返回 team.id（UUID）。

URL 中 node 参数

/teams/{code}/docs?node={node_id} 中的 node 是目标文件夹 ID，上传时作为 directory.data.id 传入。

结果链接生成

• v2 页面：https://{domain}/pages/{entry_id}
• v1 文档：https://{domain}/teams/{team_code}/docs/{doc_id}
• {domain} 从健康检查缓存的 company.company_domain 获取，默认 csig.lexiangla.com

写入安全约束

• 写入操作必须基于用户明确提供的目标信息
• 不要自行猜测目标知识库 / 目录
• 删除操作需二次确认
• 写入失败必须落本地降级文件（详见 modules/writer.md「写入降级方案」）

批量内容获取：合并执行策略

当需要批量获取多篇文档内容时（如遍历目录、生成报告/大纲等），必须将多步操作合并到尽可能少的命令中执行：

1. 一次性脚本优先：把「获取列表 → 判断类型 → 下载文件 → 解析内容」串联到一个 shell/python 脚本中一次执行
2. 循环合并：用 for 循环批量处理同类操作
3. 减少交互次数：目标整个流程 不超过 2~3 次命令执行
4. requires_approval: false：对读取类操作（curl GET、markitdown 解析等）设置不需要审批；写入/删除仍需审批

参考可直接执行脚本：scripts/batch-fetch.py（v1.3.0 新增）。

跨版本内容获取降级策略（文档内容获取规则）

当用户提到「获取文档详细内容 / 解析内容 / 查看正文 / 读取文档」时，按 URL 类型路由：

┌────────────────────────────────────────────────────────────────────┐
│ 1. URL 含 /teams/.../docs/{doc_id} → 1.0 文档                      │
│    必用：GET /cgi-bin/v1/docs/{doc_id}/parsed-content              │
│    → 直接返回 data.attributes.parsed_content（已解析 Markdown）    │
│    → 富文本 / PPTX / DOCX / PDF 全支持，含图片描述 + OCR 结果      │
│    → 一次调用搞定，无需下载 + 本地解析                             │
│    → 详见 references/api-get-doc-parsed-content.md                 │
│                                                                    │
│ 2. URL 含 /pages/{entry_id} → 2.0 文档                             │
│    必用：MCP entry_describe_ai_parse_content(entry_id)             │
│    → 返回 AI 解析后的 HTML / Markdown / OCR 内容                   │
│                                                                    │
│ 3. 兜底（仅以下场景才用旧的 GET /cgi-bin/v1/docs/{doc_id}）：      │
│    ├─ 需要原始 HTML 结构（保留 block 标签等）                      │
│    ├─ 需要下载原始文件二进制（pptx / pdf 本身）                    │
│    └─ parsed-content 接口异常时降级使用                            │
└────────────────────────────────────────────────────────────────────┘

⚠️ v1 的 doc_id 与 v2 的 entry_id 不通用。从 /teams/ URL 取到的 ID 必须走 v1 接口；从 /pages/ URL 取到的 ID 必须走 v2 MCP。

常见错误速查

✍️ 输出风格约束

内容生成场景（写文章 / 整理资料 / 创建文档）

禁止：

• 模板化开头："好的，我来帮你..." / "以下是为你整理的..." / "希望对你有帮助..."
• 模板化结尾："希望对你有帮助" / "如有需要请告诉我" / "下一步可以..."
• 主动添加未要求的章节（"延伸阅读" / "作者后记" / "免责声明" 等）
• 在用户没要求的情况下加 emoji 装饰
• 把用户的第一人称改成第三人称，或反之

必须：

• 直接产出核心内容，让用户能直接复制使用
• 保留用户提供的格式、语气、人称
• 用户没指定结构时，镜像参考材料的结构而非另起炉灶
• 数字、专有名词、产品名按用户原样保留

工具操作场景（搜索 / 上传 / 编辑）

禁止：

• 在工具调用前后加大段解释（"现在我将调用 xxx 工具，它的作用是..."）
• 把工具返回的原始 JSON 直接贴给用户

必须：

• 工具调用前最多一句话说明，工具返回后只展示用户关心的字段
• 多步操作用编号列表汇总最终结果，不复述每一步

📦 模块索引

路由判定完成后，读取对应模块文件获取详细操作指南：

模块间协作

参考文档

辅助资源

变更记录

• v1.3.0（2026-05-28）
  • 新增「适用范围」章节（Scope 守门），未命中乐享上下文立刻退出
  • 收紧 frontmatter description（加否定式约束）
  • 新增「操作前置门禁」：所有 MCP/REST 操作前强制健康检查
  • 新增「输出风格约束」节，禁止模板化开头/结尾、AI 味装饰
  • setup.md 加 Step 5 结构化诊断报告，替代反复重试
  • writer.md / files.md 加写入/上传降级方案（落本地文件）
  • 路由规则改为 ASCII 决策图
  • version 号合规化（去掉 V 前缀）
  • 新增 scripts/batch-fetch.py
  • 全文强化 COMPANY_FROM=CSIG 默认约定