本文基于官方 README_CN.md 快速开始与 .env.example（main 分支，2026-09 核对）整理，
并按本机实测环境做了定制：已完成的步骤给出复核命令，待执行的步骤给出本机实值。
全程不使用表格；所有 <尖括号> 都是需要自行替换的占位符，本机对应的真实值见第十五节。

---

一、本机环境实况（2026-09-25 实测）

硬件

你有没有过这样的时刻：想找一个几个月前记下的结论，明知它就躺在某个笔记文件夹里，却怎么也想不起文件名；或者同一个概念在三四个目录里都写过笔记，彼此的说法早就对不上了。

关键词搜索只能帮你定位文件，不能帮你回答问题。个人知识管理的下一步，是让积累的文档变成一个可以直接提问的知识库——你问"X 和 Y 是什么关系"，它基于你自己的笔记给出有出处的回答。

这正是 OpenWiki personal 模式要做的事：把你散落各处的本地目录接入为数据源，由 AI 把原始素材合成为结构化的"个人大脑"，然后你就可以和它对话了。对重度笔记用户来说，本地目录恰恰是个人知识资产的主体——云端工具再方便，也替代不了硬盘里那几个攒了多年的文件夹。能否把本地目录可靠地接进来，决定了个人知识库工具的真实价值。