What makes 腾讯乐享知识库 Lexiang Knowledge Base notable?

2.1K downloads. Trust evidence available

How should 腾讯乐享知识库 Lexiang Knowledge Base be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

腾讯乐享知识库 Lexiang Knowledge Base

乐享知识库 MCP 全功能 Skill。当用户提到「乐享」「知识库」「个人知识库」「我的知识库」「lexiang」，或提供 lexiangla.com 链接，或涉及知识库的搜索/写入/编辑/文件/配置/评论/草稿/智能表格等操作时使用。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.1k

Updated

Oct 9, 2026

Version

2.2.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.1K downloadsadoption · observed Oct 9, 2026
Latest release: 2.2.1release · observed Oct 9, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1786rt68jz3shqts3q6e64w4h83nfyz:lexiang-mcp-skill

Install using `clawhub skill install s1786rt68jz3shqts3q6e64w4h83nfyz:lexiang-mcp-skill` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/lexiang/lexiang-mcp-skill before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-lexiang-lexiang-mcp-skill/snapshot"

Documentation

CLAWHUB

156,383 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: lexiang-knowledge-base
version: 2.2.0
description: "乐享知识库 MCP 全功能 Skill。当用户提到「乐享」「知识库」「个人知识库」「我的知识库」「lexiang」，或提供 lexiangla.com 链接，或涉及知识库的搜索/写入/编辑/文件/配置/评论/草稿/智能表格等操作时使用。"
---

# 乐享知识库 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.company_domain` 类型 | 链接格式 | 示例 |
|------------------------------|----------|------|
| 包含三级域名（如 `csig.lexiangla.com`） | `{domain}/pages/{entry_id}` | `https://csig.lexiangla.com/pages/abc` |
| 顶级域名（如 `lexiangla.com`） | `{domain}/pages/{entry_id}?company_from={company_from}` | `https://lexiangla.com/pages/abc?company_from=csig` |

**`{company_from}` 获取优先级：**
1. mcp.json `url` 字段中的 `company_from` 参数
2. 若无，使用 `whoami().company.code`

---

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

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

> 完整安全规则（允许写入的条件、工具分类）见 `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` | 「把会议录制导入」「导入会议录制」 |
| 智能表格 / 结构化数据 | `references/smartsheet.md` | 「智能表格」「乐享表格」「表格里的数据」「新增一行」「查询记录」 |
| 草稿 / 存草稿 / 发布 | `references/draft.md` | 「先存草稿」「保存为草稿」「发布草稿」「查看草稿」 |
| 查看评论 | `references/comment.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 的内容」 | `ref

README.md

# lexiang-skills

**乐享知识库 MCP Skill（v2.1.0）**

为 AI Agent 提供乐享知识库的全功能操作能力，包括搜索阅读、文档写入、Block 编辑、文件上传、外部导入等。

---

## 快速开始

### WorkBuddy 用户

WorkBuddy 已内置乐享连接器，**无需手动配置**：

1. 在 WorkBuddy「集成」页面找到「乐享」连接器
2. 点击「授权」完成 OAuth 登录，连接器自动激活

### 其他平台（OpenClaw、Claude 等）

访问 [https://lexiangla.com/mcp](https://lexiangla.com/mcp) 获取 `COMPANY_FROM` 和 `LEXIANG_TOKEN`，填入 `mcp.json`：

```json
{
  "mcpServers": {
    "lexiang": {
      "enabled": true,
      "url": "https://mcp.lexiang-app.com/mcp?company_from=你的COMPANY_FROM",
      "transportType": "streamable-http",
      "headers": {
        "Authorization": "Bearer 你的LEXIANG_TOKEN"
      }
    }
  }
}
```

---

## 目录结构

```
lexiang-skills/
├── SKILL.md                  # 顶层路由入口（意图识别 → 参考文件）
├── mcp.json                  # MCP 配置模板
├── README.md                 # 本文件
├── assets/                   # 静态资源
├── references/               # 参考文档（19 份）
│   ├── base.md               # 数据模型、URL 规则、完整安全规则、工具发现
│   ├── setup.md              # Token 配置、续期、WorkBuddy OAuth、故障排查
│   ├── search.md             # 关键词/语义搜索、内容读取、目录浏览
│   ├── writer.md             # 新建文档、导入内容、公众号收藏
│   ├── blocks.md             # 已有页面的 Block 级增删改移
│   ├── files.md              # 二进制文件上传/下载（三步流程）
│   ├── connectors.md         # 腾讯会议录制导入、iWiki 文档迁移
│   ├── index.md              # 完整索引 + 按场景推荐加载顺序
│   ├── block-schema.md       # Block 类型完整字段定义
│   ├── block-update.md       # 批量更新 Block 方法
│   ├── common-errors.md      # 常见错误排查（高频错误速查表）
│   ├── content-reorganize.md # 文档结构重组方案
│   ├── doc-templates.md      # 文档类型与大纲模板
│   ├── folder-sync.md        # 文件夹同步方案
│   ├── markdown-import.md    # Markdown 导入详解
│   ├── markdown-to-block.md  # Markdown 转 Block 指南
│   ├── mcp-examples.md       # 复杂 Block 结构示例
│   ├── skill-maintenance.md  # Skill 维护指南
│   └── theme-config.md       # 主题配色配置
└── scripts/                  # 辅助脚本
    ├── upload-files.py       # 批量文件上传（支持单文件/文件夹/并行/dry-run）
    ├── sync-folder.ts        # 文件夹增量同步到乐享知识库
    └── test_upload_files.py  # 上传脚本测试
```

---

## 模块说明

根据用户意图，Agent 读取 `references/` 下对应的参考文件：

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

> 完整路由规则和易混淆场景见 `SKILL.md`

---

## 核心规则

- **写入安全**：必须基于用户明确提供的目标（URL/ID/确认），禁止自行遍历或猜测
- **链接生成**：使用 `whoami().company.company_domain` 作为域名；顶级域名需追加 `?company_from=`
- **401 处理**：不重试，引导用户续期（点续期按钮即可恢复，无需重新配置）
- **强制检索**：用户提到「乐享里的文档/内容」时，必须先搜索再回答，禁止凭空生成

> 完整规则详见 `SKILL.md` 和 `references/base.md`

---

## 辅助脚本

| 脚本 | 说明 |
|------|------|
| `scripts/upload-files.py` | 批量文件上传（支持单文件/文件夹/并行/dry-run） |
| `scr

scripts/README.md

# Lexiang Scripts

乐享文档写入辅助脚本集合。

## 安装依赖

### TypeScript 脚本

```bash
npm install -g ts-node typescript
npm install @types/node
```

### Python 脚本

```bash
pip install aiohttp requests
```

## 脚本列表

### sync-folder.ts

本地文件夹增量同步到乐享知识库。

```bash
# Dry run 模式（仅生成计划）
npx ts-node sync-folder.ts --local ./docs --entry-id abc123 --dry-run

# 完整参数
npx ts-node sync-folder.ts \
  --local ./docs \
  --entry-id <parent_entry_id> \
  --space-id <space_id> \
  --state-file .sync-state.json \
  --dry-run
```

### upload-files.py

并行上传文件到乐享。

```bash
# 单文件上传
python upload-files.py --files doc1.md doc2.pdf --entry-id abc123

# 文件夹批量上传
python upload-files.py --folder ./docs --entry-id abc123 --parallel 5

# 输出上传计划到 JSON
python upload-files.py --folder ./docs --entry-id abc123 --output plan.json --dry-run
```



## 工作流示例

### 1. 项目文档同步

```bash
# 1. 首次同步（dry run 检查）
npx ts-node sync-folder.ts --local ./project-docs --entry-id root123 --dry-run

# 2. 执行同步
# 将生成的 MCP 调用序列提供给 AI 助手执行

# 3. 后续增量同步
# 脚本会自动检测变更，只同步修改的文件
```

### 2. Markdown 文档导入

```bash
# 1. 生成上传计划
python upload-files.py --folder ./markdown-docs --entry-id target123 --output plan.json

# 2. 查看计划
cat plan.json

# 3. 执行上传（通过 AI 助手）
# 将 plan.json 中的 MCP 调用提供给 AI 助手
```

## 注意事项

1. **MCP 调用需要通过 AI 助手执行**：脚本生成 MCP 调用参数，实际执行需要 AI 助手的 MCP 能力
2. **文件上传是 3 步流程**：apply_upload → HTTP PUT → commit_upload
3. **同步状态文件**：`.lexiang-sync-state.json` 记录同步状态，请勿删除
4. **大文件建议分批**：单次 MCP 调用的数据量有限制
5. **Block 写入使用 MCP 工具**：直接调用 `block_convert_content_to_blocks` 将 Markdown/HTML 转换为块结构，无需手动构建

_meta.json

{
  "ownerId": "kn721jbsqc97byg79gg835yt4n81rzya",
  "slug": "lexiang-mcp-skill",
  "version": "2.2.1",
  "publishedAt": 1791513134247
}

references/base.md

# 乐享 MCP 基础知识

> 本文件为所有功能模块的共享基础层，包含数据模型、URL 规则、安全约束、工具发现等通用知识。
> **核心规则（URL 生成 + 写入安全红线）已在 SKILL.md 中内联，本文件为详细参考。**

---

## ⛔ 必读（调用前必须理解）

1. 本服务**直接暴露所有业务工具**（如 `team_list_teams`、`search_kb_search` 等），可直接调用
2. 调用前先确认工具参数定义，**以 MCP 返回的 schema 为准**
3. 不确定参数时，使用 `get_tool_schema(tool_name="xxx")` 获取最新定义

---

## 📊 数据模型

### 核心概念

| 概念 | 说明 |
|------|------|
| **Team（团队）** | 顶级组织单元，一个团队下可以有多个知识库(Space) |
| **Space（知识库）** | 知识的容器，属于某个团队，包含多个条目(Entry)，有 `root_entry_id` 作为根节点 |
| **Entry（条目）** | 知识库中的内容单元，可以是页面(page)、文件夹(folder)或文件(file)，支持树形结构(parent_id) |
| **File（文件）** | 附件类型的条目，如 PDF、Word、图片等 |

### 层级关系

```
Team → Space → Entry（树形结构，root_entry_id 为根）
                  ├── page（页面）
                  ├── folder（文件夹）
                  └── file（文件）
```

### URL 规则

`{domain}` = `whoami()` 返回的 `company.company_domain`（如 `https://csig.lexiangla.com` 或 `https://lexiangla.com`）

> **⛔ 严禁使用 MCP endpoint 拼接任何用户可访问的链接！** MCP 域名仅用于接口调用，不是用户访问地址。
> **⛔ 严禁将 `company_from` 拼接为子域名！** `company_from` 只能作为 URL 查询参数（`?company_from=xxx`）。

| 资源 | URL 格式 |
|------|----------|
| 团队首页 | `{domain}/t/{team_id}/spaces` |
| 知识库 | `{domain}/spaces/{space_id}` |
| 知识条目 | `{domain}/pages/{entry_id}` |

**链接生成步骤（所有操作通用）：**

1. 取 `whoami()` 返回的 `company.company_domain` 作为 `{domain}`
2. 判断 `{domain}` 是否为顶级域名（不含三级前缀，如 `lexiangla.com`）：
   - **是**：使用 `{domain}/pages/{entry_id}?company_from={company_from}`
     - `{company_from}` 优先取 mcp.json `url` 中的 `company_from` 参数
     - 若无，取 `whoami()` 返回的 `company.code` ← **此时已调用过 whoami，直接取该值，不能省略**
   - **否**（如 `csig.lexiangla.com`）：使用 `{domain}/pages/{entry_id}`，无需追加参数

| `{domain}` 类型 | 链接格式 | 示例 |
|----------------|----------|------|
| 包含三级域名（如 `csig.lexiangla.com`） | `{domain}/pages/{entry_id}` | `https://csig.lexiangla.com/pages/abc` |
| 顶级域名（如 `lexiangla.com`） | `{domain}/pages/{entry_id}?company_from={company_from}` | `https://lexiangla.com/pages/abc?company_from=csig` |

### URL 解析规则

当用户提供链接时，从 URL 路径中提取 ID（**忽略查询参数**）：

| URL 路径 | 提取方式 |
|----------|----------|
| `/spaces/{space_id}` | 取 `spaces/` 后面的部分作为 `space_id` |
| `/pages/{entry_id}` | 取 `pages/` 后面的部分作为 `entry_id` |
| `/t/{team_id}/spaces` | 取 `t/` 后面的部分作为 `team_id` |

---

## 🛡️ 写入操作安全规则

> **核心原则**：写入、修改、删除操作 **必须基于用户明确提供的目标信息**，禁止 Agent 自行选择或猜测目标。

### 🚫 绝对禁止

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

### ✅ 允许写入的条件（满足之一即可）

| 条件 | 示例 |
|------|------|
| 用户提供了明确 URL | `"写到这里：https://lexiangla.com/spaces/xxx"` |
| 用户提供了明确 ID | `"写入 space_id 为 xxx 的知识库"` |
| 用户指定名称 + Agent 回显确认 | Agent 搜到后展示详情，用户确认 |
| 用户要求保存到个人知识库且 `whoami` 返回了个人知识库 | `"保存到我的知识库"` → 自动写入个人知识库 |

### 写入 vs 读取工具分类

**写入操作**（需满足安全规则）：
`entry_create_entry`、`entry_import_content`、`entry_import_content_to_entry`、`entry_rename_entry`、`entry_move_entry`、`entry_set_entry_validity`、`block_update_block`、`block_update_blocks`、`block_update_page`、`block_create_block_descendant`、`block_delete_block`、`block_delete_block_children`、`block_move_blocks`、`file_apply_upload`、`file_commit_upload`、`file

Github ReposUpdated 7h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.