llm-wiki-team

llm-wiki-team 是一个最小、可发 GitHub 的命令行项目，用来把前面研究收敛出的多人 LLM Wiki 方案落成可运行骨架。

它实现的是一个非常克制的 v1：

• 个人 wiki 继续保持 Karpathy 风格的 raw/ + wiki/ + AGENTS.md
• 公司 wiki 通过 nightly compile 从多个人 wiki 导入“可发布页面”
• review drafts 和 review-queue.jsonl 构成最小 reviewer 工作流
• 已批准公司页面不会被 nightly job 静默改写

GitHub Metadata

• Short description:
  • Minimal CLI for compiling personal LLM wikis into a reviewed company wiki.
• License:
  • MIT
• More release copy:
  • see RELEASE.md

Terminal Demo

Raw transcript:

• assets/terminal-demo.txt

当前范围

这个项目故意只做最小闭环，不追求“大而全”。

已实现：

• personal-init
  • 初始化个人或团队风格的 wiki 骨架
• company-init
  • 初始化公司 wiki、review 队列和同步清单
• compile-nightly
  • 从多个个人 wiki 读取可发布页面
  • 同步到 company/raw/people/<owner>/...
  • 记录 sync-manifest.jsonl
  • 基于“同一 topic、至少 2 个 owner”的规则创建 review draft
• review queue/show/claim/approve/reject/stale/reopen/supersede
  • 提供最小 review CLI
  • 以 markdown draft 为主，review-queue.jsonl 为镜像

暂不做：

• 联邦搜索本体
• repeated-demand 触发器
• 语义冲突检测
• 浏览器 reviewer UI
• 自动覆盖已批准公司页

安装

在项目根目录执行：

python3 -m pip install -e .

或者直接用模块方式运行：

PYTHONPATH=src python3 -m llm_wiki_hub.cli --help

快速开始

1. 初始化两个个人 wiki

llm-wiki-team personal-init /path/to/alice-wiki --title "Alice Wiki" --profile research
llm-wiki-team personal-init /path/to/bob-wiki --title "Bob Wiki" --profile research

2. 初始化公司 wiki

llm-wiki-team company-init /path/to/company-wiki --title "Company LLM Wiki"

3. 准备 source config

参考 examples/company-sources.json：

[
  { "owner": "alice", "root": "/absolute/path/to/alice-wiki" },
  { "owner": "bob", "root": "/absolute/path/to/bob-wiki" }
]

4. 在个人 wiki 中准备可发布页面

最稳的 v1 方式是用 frontmatter 明示：

---
title: LLM Wiki vs RAG
page_type: synthesis
publish: true
visibility: team
canonical_topic: llm-knowledge-bases
confidence: high
---

# LLM Wiki vs RAG
...

共享页也可以放在显式共享路径下，例如：

• wiki/syntheses/team/
• wiki/decisions/team/

5. 运行 nightly compile

llm-wiki-team compile-nightly \
  --company-root /path/to/company-wiki \
  --source-config /path/to/company-sources.json

输出会做三件事：

1. 导入 publishable pages 到 company/raw/people/...
2. 追加同步记录到 system/sync-manifest.jsonl
3. 如果同一 canonical_topic 在本次运行中来自至少 2 个 owner，则创建 review draft

6. review 工作流

llm-wiki-team review queue --company-root /path/to/company-wiki
llm-wiki-team review show review-2026-04-11-llm-knowledge-bases --company-root /path/to/company-wiki
llm-wiki-team review claim review-2026-04-11-llm-knowledge-bases --company-root /path/to/company-wiki --by alice
llm-wiki-team review approve review-2026-04-11-llm-knowledge-bases \
  --company-root /path/to/company-wiki \
  --to wiki/syntheses/llm-knowledge-bases.md \
  --by alice

approve 时如果目标正式页面已存在，会先把旧版本快照到：

company-wiki/wiki/history/<canonical_topic>/<revision>.md

然后再写入新的 approved page。

目录约定

个人 wiki

<personal-root>/
  AGENTS.md
  raw/
  wiki/
    index.md
    log.md
    ...

公司 wiki

<company-root>/
  AGENTS.md
  raw/
    people/
  wiki/
    review/
    syntheses/
    history/
    index.md
    log.md
  system/
    review-queue.jsonl
    sync-manifest.jsonl

v1 设计原则

• markdown 页面是主知识载体
• review draft 才是夜间自动化的边界
• canonical_topic 是共享知识的稳定 join key
• 已批准公司页只能通过 review 流程变更

当前代码骨架

• cli.py
  • 入口面，负责参数解析和命令分发
• runtime.py
  • 显式路径与运行时装配
• state.py
  • review-queue.jsonl 与 sync-manifest.jsonl 的状态访问层
• policy.py
  • publish 判定、page type 推断、canonical_topic 约束
• compile_flow.py
  • nightly compile 工作流
• review.py
  • review draft 生命周期

本地验证

项目自带 unittest：

PYTHONPATH=src python3 -m unittest discover -s tests