核心用法
Wiki 是一个由 LLM 维护的个人知识库系统,基于 MkDocs 构建可浏览的静态站点。核心操作包括:
1. 知识归档(Filing):将对话中产生的持久知识直接写入 docs/topics/<topic>/<article>.md,并自动更新相关页面的交叉链接、统计数据,确保单条信息触达所有相关页面
2. 原始资料编译(Compiling):从 raw/ 目录或 URL 提取 durable knowledge,过滤 ephemeral 内容,归档源文件后生成结构化文章
3. 每日巡检(Linting):扫描矛盾陈述、过时数据、断链、孤立页面、薄弱条目,静默修复可自动处理的问题,向用户标记需决策的冲突
4. 优质答案归档:主动识别对话中的深度分析、对比评测、决策 rationale,提议固化为 wiki 页面
5. 静态站点生成:通过 build.sh 重建站点并自动提交 git
显著优点
- 知识复利:避免优质答案沉入聊天历史,支持跨时间、跨主题的关联积累
- 主动维护:LLM 不仅写入,还负责更新旧页面、检测冲突、补全链接,降低用户的维护负担
- 结构化检索:MkDocs 生成可浏览站点,支持全文搜索与层级导航
- 可追溯性:
log.md记录所有 ingest/lint/filed 操作,便于审计与回查
潜在缺点与局限性
- 依赖 MkDocs 生态:需 Python 环境与 mkdocs-material,对非技术用户有门槛
- 本地部署限制:静态服务器仅绑定 127.0.0.1:8300,无原生多设备同步(依赖 git remote)
- 一致性校验的边界:lint 可检测字面矛盾,但无法识别深层语义冲突或隐含假设变化
- 信息过载风险:高频对话若全部自动归档,可能导致 wiki 膨胀,需人工判断 durable vs ephemeral
适合人群
- 需要长期积累专业知识的深度研究者、技术决策者
- 频繁进行工具对比、方法论迭代、项目复盘的用户
- 希望将 LLM 对话从"一次性问答"转化为"可检索资产"的重度用户
常规风险
- git 操作风险:
build.sh自动提交并默认 push,若未配置 SSH/HTTPS 凭据或 remote 设置错误可能导致失败 - 本地服务安全:虽仅限 localhost,但若设备被多用户共享,8300 端口内容可被同机其他用户访问
- 数据持久性:
site/目录 gitignored,仅 source markdown 受版本控制,需确保 remote 备份 - 冲突误报/漏报:自动化 lint 可能将有意保留的多视角陈述标记为矛盾,或漏掉 subtly outdated 的隐含前提