# LLM Wiki Lark

> LLM Wiki：在飞书云盘或知识库中构建三层 LLM 知识库，支持 init/import/ingest/query/lint。触发词：llm wiki, 知识库, wiki ingest, wiki query, wiki lint, wiki init, wiki import, 添加素材, 导入素材

- Skill: `harryzhz/llm-wiki-lark` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add harryzhz/llm-wiki-lark`
- Raw SKILL.md: https://api.skillmd.com/api/skills/harryzhz/llm-wiki-lark/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: harryzhz (https://skillmd.com/u/harryzhz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/harryzhz/llm-wiki-lark

---


# LLM Wiki on Lark

在飞书云盘或知识库中构建和维护一个 LLM 驱动的结构化知识库。支持**云盘模式**（个人云盘文件夹）和**知识库模式**（飞书知识库节点树）两种存储后端。严格遵循三层架构：**Schema**（行为规范）、**Raw**（原始素材）、**Wiki**（LLM 知识层）。

知识编译一次、持续更新，而非每次查询从零推导。LLM 负责所有维护工作 — 摘要、交叉引用、归类、一致性检查。

## 前置检查

在执行 init/import/ingest/query/lint 之前，**必须先运行以下检查**，缺失项自动安装：

```
Step 1: 检查 lark-cli
  命令: which lark-cli
  如果不存在:
    npm install -g @larksuite/cli

Step 2: 检查认证
  命令: lark-cli auth status
  如果未认证:
    提示用户运行: ! lark-cli auth login
```

## 快速决策树

| 用户意图 | 操作 |
|---------|------|
| "初始化知识库" / "创建新的 wiki" | **init** |
| "把这篇论文存到 raw" / "添加这个 URL" / "上传这个文件" / "先把素材收进来" | **import** |
| "摄入这篇文章" / "分析这个素材" / "把这个加到知识库" | **ingest** |
| "关于 X 我们知道什么" / "从知识库回答" | **query** |
| "检查知识库健康" / "有没有孤立页面" | **lint** |

## 五大操作

- 除 init 外，执行其他操作前先 fetch AGENTS 文档查看规范
- **Wiki 选择规则**（按优先级）：
  1. 用户在本次请求中指定了 wiki 名称 → 从本地配置的 wikis 数组按 `wiki_name` 匹配
  2. 当前对话上下文已确定 wiki → 沿用
  3. 读取 `~/.llm_wiki.setting.json`：仅 1 个 wiki → 自动使用；多个 wiki → 列出所有 wiki（名称 + 创建时间），请用户选择
  4. 用户直接提供 INDEX `doc_id` → 直接使用

| 操作 | 说明 | 详细步骤 |
|------|------|---------|
| **init** | 创建完整目录树 + AGENTS.md + INDEX + LOG | [init.md](references/workflows/init.md) |
| **import** | 将素材（飞书文档/本地文件/外部链接）归档到 raw/ 对应子目录 | [import.md](references/workflows/import.md) |
| **ingest** | 从 raw/ 读取素材 → 创建 Source/Entity/Concept 页面 → 维护交叉引用 | [ingest.md](references/workflows/ingest.md) |
| **query** | 从 INDEX 定位 → fetch 相关页面 → 综合回答 → 有价值的回答归档回流 | [query.md](references/workflows/query.md) |
| **lint** | 检查矛盾、孤立页、断链等 → 生成报告 → 用户确认后修复 | [lint.md](references/workflows/lint.md) |


## 命令参考

- 云盘模式命令见 [Drive Adapter](references/adapter/drive.md)
- 知识库模式命令见 [Wiki Adapter](references/adapter/wiki.md)
- 读取、更新、搜索文档使用 `docs +fetch/+update/+search`（当前 CLI 默认走 v2，正文用 `--doc-format markdown`）
- 命令报错时，使用 `lark-doc` / `lark-drive` / `lark-wiki` skill 获取完整参数和示例；如未安装，可通过 `npx skills add larksuite/cli -y -g` 安装。

## 其他参考文档

- [Wiki Schema](references/wiki-schema.md): 三层架构、页面类型、元数据格式、INDEX/LOG 格式
- [Drive Adapter](references/adapter/drive.md): 云盘模式命令参考
- [Wiki Adapter](references/adapter/wiki.md): 知识库模式命令参考
- [Init Templates](references/templates/init.md): AGENTS.md、INDEX、LOG 初始模板
- [Page Templates](references/templates/pages.md): Source 摘要、Entity/Concept/Comparison/Overview/LOG 模板

## 关键约束

- **文档中引用其他飞书文档禁止使用原始 URL（外部链接除外）** — 统一使用 v2 XML 文档引用：`<cite type="doc" doc-id="<DOC_ID>"></cite>`；上传文件附件使用 `<source token="<FILE_TOKEN>" name="<FILENAME>"></source>`
- **文档中写入流程图、架构图、时序图必须用飞书画板的 DSL 格式**
- **新文档必须放入对应子目录**
- **飞书文档增量更新优先，避免 `overwrite`，默认使用分段写入**: `docs +create --content '<title>标题</title>'` 仅写标题骨架拿到 doc_id，正文再用 `docs +update --command append --doc-format markdown` 追加