腾讯乐享知识库 Lexiang Knowledge Base

乐享知识库 MCP Skill

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

---

⛔ MANDATORY RULES — 必须遵守

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

---

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

所有操作完成后返回链接时，统一遵循：

{company_from} 获取优先级：

1. mcp.json url 字段中的 company_from 参数
2. 若无，使用 whoami().company.code

---

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

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

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

---

📋 意图路由表

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

⚠️ 易混淆场景

⚠️ 跨模块任务

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

• 搜索后写入：先 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，引导续期（点续期按钮，无需重新配置）
 → 连接失败：读取 references/setup.md，引导完成初始配置

---

📚 参考文件索引

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

补充参考文档

---

Skill version: 2.1.0