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
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-wiki skill 获取完整参数和示例；如未安装，可通过 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 追加