腾讯乐享知识库-私有化版本

SKILL.md

---
name: lexiang-knowledge-private
version: 1.0.0
description: "乐享知识库 MCP 全功能 Skill（私有化部署版）。当用户提到「乐享」「知识库」「个人知识库」「我的知识库」「lexiang」，或提供乐享链接，或涉及知识库的搜索/写入/编辑/文件/配置等操作时使用。"
---

# 乐享知识库 MCP Skill（私有化部署版）

当用户提到「**乐享**」「**知识库**」「**个人知识库**」「**我的知识库**」「**lexiang**」，或提供乐享链接，或给出 `space_id`、`entry_id`、`/spaces/`、`/pages/` 等乐享标识时，读取本 Skill。

> **私有化说明**：本 Skill 适用于私有化部署的乐享实例。用户访问域名为企业自定义私有域名（如 `https://lexiang.mycompany.com`），与 SaaS 版不同，**链接直接使用私有化域名，无需判断域名结构**。

---

## ⛔ MANDATORY RULES — 必须遵守

1. **遇到 401 / 连接断开**：立即停止重试，读取 `references/setup.md`；引导用户重新获取 token
2. **写入操作**：必须基于用户明确提供的目标（URL/ID/名称确认），**禁止**自行遍历或猜测目标
3. **链接生成**：必须使用 `whoami()` 返回的 `company.company_domain` 作为域名，**禁止**使用 MCP endpoint 拼接用户链接
4. **company_from**：私有化域名已指向对应企业，链接中**不需要拼接 `company_from` 参数**
5. **强制检索**：当用户消息同时包含「乐享/知识库」等平台词 + 「文档/论文/文章/内容/资料/笔记/之前写的/上次的/风格」等内容词时，**必须先调用 `search_kb_search` 或 `search_kb_embedding_search` 获取实际内容**，不得凭空分析或直接生成回答
6. **大批量保护**：文件/条目数量 > 20 个时，**必须分批执行**（每批 ≤ 20 个）；操作前告知用户数量和策略，禁止一次性提交导致 token 超限，详见 `references/files.md`

---

## 🔗 链接生成规则（全局通用）

私有化版本链接生成规则：

**`{domain}` = `whoami()` 返回的 `company.company_domain`（即企业私有化域名）**

链接格式：`{domain}/pages/{entry_id}`

> **私有化域名已指向对应企业，无需拼接 `company_from` 参数。**
> 如 `whoami()` 返回 `company_domain` 为 `https://lexiang.mycompany.com`，则链接为：
> `https://lexiang.mycompany.com/pages/{entry_id}`

**禁止**使用 MCP 端点域名拼接用户访问链接。

---

## 🛡️ 写入安全红线（全局通用）

- 🚫 禁止遍历团队/知识库列表后自行选择写入目标
- 🚫 禁止根据名称"看起来合适"就决定写入
- 🚫 禁止在未确认时执行写入

> 完整安全规则（允许写入的条件、工具分类）见 `references/base.md`

---

## 📋 意图路由表

根据用户意图，Read 对应参考文件：

| 用户意图 | 读取文件 | 典型触发词 |
|---------|---------|-----------|
| 配置乐享 / 401 错误 / Token 过期 | `references/setup.md` | 「配置乐享」「token 过期」「连不上」「401」 |
| 搜索 / 查找 / 阅读 / 浏览 | `references/search.md` | 「找一下」「搜索」「读一下这个页面」「打开链接」 |
| 创建文档 / 写入 / 保存 / 导入 | `references/writer.md` | 「写到乐享」「创建文档」「保存到知识库」「存到我的知识库」「保存到个人知识库」「导入」 |
| 编辑已有页面 / Block 操作 | `references/blocks.md` | 「修改这个页面」「加个标题」「删掉这段」「在 /pages/xxx 里…」 |
| 上传/下载文件（PDF/Word/图片等） | `references/files.md` | 「传个 PDF」「上传文件」「下载这个文件」 |
| 导入腾讯会议 | `references/connectors.md` | 「把会议录制导入」「导入会议录制」 |
| 数据模型 / URL 规则 / 完整安全规则 | `references/base.md` | 由上述模块内部引用 |

### ⚠️ 易混淆场景

| 场景 | 正确模块 | 说明 |
|------|---------|------|
| 用户提供 `/pages/xxx` 链接 + 要求「加内容/修改」 | `references/blocks.md` | 操作**已有页面** |
| 用户提供 `/spaces/xxx` 链接 + 要求「写入/创建」 | `references/writer.md` | 在知识库下**新建文档** |
| 用户提供 `/pages/xxx` 链接 + 仅要求「读/总结」 | `references/search.md` | **只读**操作 |
| 上传 PDF/Word/图片 | `references/files.md` | 二进制文件，非文本文档 |
| 创建 Markdown 文本文档 | `references/writer.md` | 文本内容，非二进制 |
| 「乐享里有一篇关于 X 的文档」 | `references/search.md` → 先搜索 | **必须先检索**，不能直接回答 |
| 「看看乐享里 XX 的写作风格」 | `references/search.md` → 先读取 | **必须先读取内容**，不能凭空分析 |
| 「分析一下我知识库里关于 X 的内容」 | `references/search.md` → 先搜索 | **必须先检索**，不能凭空生成 |

### ⚠️ 跨模块任务

需要同时读取多个文件时，按流程顺序读取：

- **搜索后写入**：先 `references/search.md` → 再 `references/writer.md`
- **读取后编辑**：先 `references/search.md` → 再 `references/blocks.md`
- **上传后记录**：先 `references/files.md` → 再 `references/writer.md`
- **生成内容+保存**：用户要求「帮我写一篇 X 并保存到知识库/个人知识库」→ 先生成内容，再读取 `references/writer.md` 执行保存；若未指定目标，默认写入个人知识库（见 writer.md 中「未指定知识库时写入个人知识库」）

---

## 🔑 凭证检查

执行任何乐享操作前，确认 MCP 已连接。通过 `whoami()` 检查：

```
MCP Tool: whoami
 → 成功：返回用户信息，继续执行
 → 401：读取 references/setup.md，引导用户重新获取 token 或续期
 → 连接失败：读取 references/setup.md，引导完成初始配置
```

---

## 📚 参考文件索引

> **按需加载**：根据意图路由表，只 Read 对应文件，无需一次性加载全部。

| 文件 | 职责 |
|------|------|
| `references/setup.md` | Token 配置、续期、故障排查 |
| `references/search.md` | 关键词/语义搜索、内容读取、目录浏览 |
| `references/writer.md` | 新建文档、导入内容、公众号收藏 |
| `references/blocks.md` | 已有页面的 Block 级增删改移 |
| `references/files.md` | 二进制文件上传/下载（三步流程） |
| `references/connectors.md` | 腾讯会议录制导入 |
| `references/base.md` | 数据模型、完整安全规则、Block 结构、工具发现 |
| `references/index.md` | 完整索引 + 按场景推荐加载顺序 |

### 补充参考文档

| 文档 | 说明 |
|------|------|
| `references/block-schema.md` | Block 类型完整字段定义 |
| `references/mcp-examples.md` | 复杂 Block 结构示例 |
| `references/markdown-to-block.md` | Markdown 转 Block 指南 |
| `references/block-update.md` | 批量更新 Block 方法 |
| `references/content-reorganize.md` | 文档结构重组方案 |
| `references/folder-sync.md` | 文件夹同步方案 |
| `references/markdown-import.md` | Markdown 导入详解 |
| `references/common-errors.md` | 常见错误排查（高频错误速查表） |
| `references/doc-templates.md` | 文档类型与大纲模板 |
| `references/theme-config.md` | 主题配色配置 |
| `references/skill-maintenance.md` | Skill 维护指南 |

---

> Skill version: **1.0.0**