harryzhz 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 选择规则（按优先级）：
- 用户在本次请求中指定了 wiki 名称 → 从本地配置的 wikis 数组按
wiki_name匹配 - 当前对话上下文已确定 wiki → 沿用
- 读取
~/.llm_wiki.setting.json：仅 1 个 wiki → 自动使用；多个 wiki → 列出所有 wiki（名称 + 创建时间），请用户选择 - 用户直接提供 INDEX
doc_id→ 直接使用
- 用户在本次请求中指定了 wiki 名称 → 从本地配置的 wikis 数组按
| 操作 | 说明 | 详细步骤 |
|---|---|---|
| init | 创建完整目录树 + AGENTS.md + INDEX + LOG | init.md |
| import | 将素材（飞书文档/本地文件/外部链接）归档到 raw/ 对应子目录 | import.md |
| ingest | 从 raw/ 读取素材 → 创建 Source/Entity/Concept 页面 → 维护交叉引用 | ingest.md |
| query | 从 INDEX 定位 → fetch 相关页面 → 综合回答 → 有价值的回答归档回流 | query.md |
| lint | 检查矛盾、孤立页、断链等 → 生成报告 → 用户确认后修复 | lint.md |
命令参考
- 云盘模式命令见 Drive Adapter
- 知识库模式命令见 Wiki Adapter
- 读取、更新、搜索文档使用
docs +fetch/+update/+search（当前 CLI 默认走 v2，正文用--doc-format markdown） - 命令报错时，使用
lark-doc/lark-drive/lark-wikiskill 获取完整参数和示例；如未安装，可通过npx skills add larksuite/cli -y -g安装。
其他参考文档
- Wiki Schema: 三层架构、页面类型、元数据格式、INDEX/LOG 格式
- Drive Adapter: 云盘模式命令参考
- Wiki Adapter: 知识库模式命令参考
- Init Templates: AGENTS.md、INDEX、LOG 初始模板
- Page Templates: 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追加