lexiang-knowledge-base

# 乐享知识库 Skill

## MCP 接入

依赖乐享 MCP 服务：
- 服务地址：`https://mcp.lexiang-app.com/mcp`
- 推荐模式：`preset=meta`
- 配置文件：`mcp.json`
- 初始化脚本：`setup.sh`

**调用通道**：优先使用当前环境已提供的原生乐享 MCP；若原生不可用，则通过 MCPorter 调用。

**核心原则**：以 MCP 服务返回的最新 schema 为准，按需读取 reference。若当前环境只显示元工具，视为 `preset=meta` 的正常行为。

## Meta 模式工作流

标准执行顺序：

1. 判断任务类型：搜索、读取、写入、结构整理、附件上传
2. 如果任务目标不清楚，先澄清平台、对象和动作（见"任务识别规则"）
3. 根据用户意图，调用合适的工具。如果有需要，则可以通过 `search_tools` 或 `list_tool_categories` 进行业务工具的查找。
4. 使用 `get_tool_schema` 获取目标工具的最新参数定义
5. 使用 `call_tool(tool_name, arguments)` 执行业务工具
6. 使用 `_mcp_fields` 收窄返回字段，减少噪音

**约束**：先发现工具 → 读 schema → 执行。不硬编码参数表，不混淆元工具和业务工具。

**脚本使用**：仅在文件上传、目录同步或程序化构造复杂 Block 参数时使用脚本，其他任务优先直接调用 MCP 工具。

## 任务识别与权限规则

### 目标澄清优先级

优先确认三要素：
- **平台**：是否在乐享操作（避免因"知识库""文档"等泛词误触发）
- **对象**：团队、知识库、页面、文件（要求链接、ID 或精确名称）
- **动作**：搜索、读取、创建、更新、删除、上传

### 写入操作安全规则

**写入操作包括**：创建页面/文件夹、导入内容、更新 Block、删除/移动、上传附件。

**允许写入的条件**（满足其一）：
- 用户提供明确 URL
- 用户提供明确 ID
- 用户提供精确名称，且查询后由用户确认目标

**严格禁止**：
- 遍历后自行挑选目标写入
- 根据名称"看起来合适"直接决定
- 目标不明确时执行创建、覆盖、删除、移动

**目标不明确时**：说明缺少目标，要求用户提供链接、ID 或精确名称。

**读取操作**：不受上述限制，可先搜索、浏览和查看。

## 核心数据模型

### 最小概念

| 概念 | 说明 | 层级关系 |
|------|------|----------|
| `team` | 顶级组织单元 | `team → space → entry (page/folder/file)` |
| `space` | 知识库，包含 `root_entry_id` | |
| `entry` | 页面、文件夹或文件 | |

### URL 解析

从用户提供的乐享链接提取 ID（忽略查询参数）：

| URL 形态...

# 乐享 MCP - ClawHub 版本

> 适用于外部 ClawHub / mcporter 用户

## 认证方式

需要用户自行配置：
- `COMPANY_FROM`：企业标识（从 https://lexiangla.com/mcp 获取）
- `LEXIANG_TOKEN`：访问令牌（格式 `lxmcp_xxx`）

## 配置方式

### 方式1：环境变量（推荐）

```bash
export COMPANY_FROM="your_company"
export LEXIANG_TOKEN="lxmcp_YOUR_TOKEN_HERE"
```

### 方式2：直接修改 mcp.json

将 `${COMPANY_FROM}` 和 `${LEXIANG_TOKEN}` 替换为实际值。

## 快速配置

运行 setup.sh 进行交互式配置：

```bash
bash setup.sh
```

## 使用说明

详细工具文档请参考 `SKILL.md`