Windows
- 下载
FULI-Setup-<版本>.exe，双击，点「安装」。 - 提示「Windows 已保护你的电脑」时，点「更多信息」，再点「仍要运行」。
- 不要管理员权限，也不用另装 Node.js、Java 或数据库。
快速上手
装好，接上，照常干活。
写给不用终端的人。按钮都写的是控制台里的原名，照着点就行。
安装
macOS（Apple 芯片）
- 下载
fuli-macos-arm64-<版本>.dmg，把 FULI.app 拖进「应用程序」。 - 从「应用程序」打开 FULI，不要在磁盘映像里打开。
- 第一次被拦下时，到「系统设置 › 隐私与安全性」点「仍要打开」。
需要 macOS 13.5 以上。Intel 芯片的 Mac 请用终端安装。
打开 FULI，它会自己启动，控制台在窗口里打开。没启动时，点「启动 FULI」。
接入你的 AI 客户端
- 第一次打开控制台会出现「开始使用 FULI」：勾选找到的客户端，点「一键接入」。
- 最后回答「FULI 要在哪些项目里记录？」，点「开始使用」。选好之前什么都不记。
- 以后在 设置 › 客户端 里接：点「接入」或「一键接入」；FULI 更新后点「更新接入」。
- 没列出的客户端：点「复制 MCP 配置」，粘贴进它的 MCP 设置。
- 接好后重启客户端。已经打开的会话要重开，才会用上新的 FULI。
- 用 Codex 的话：在 Codex 里输入
/hooks，信任 FULI 的 hooks。
「已接入」只说明配置在，不代表客户端已经连上。
照常干活
- 在项目文件夹里，像平常一样给 AI 提任务，不用特意叫 FULI。
- 每次提问，FULI 都会把相关的偏好和知识交给 AI。
- 值得留下的结论会存下来。回复末尾列出这一轮存了什么，点链接能改。
- 存下的知识在「沉淀 › 知识」，要你确认的在「沉淀 › 知识整理」。
- AI 等你拍板的事，在顶栏的「待决策」里。
- 不知道怎么跟 AI 说？设置 › 常用操作 里有能直接复制的说法。
可选：接一个模型
不接也能用：AI 用当前会话回答，FULI 按字面找知识。
模型按钮
- 在顶栏「设置」旁边。没接时是灰色虚线圈，接上后闪电变金色、轻轻发光。
- 给老知识补算时，外圈会慢慢填满。
- 点它打开「模型与用量」：「用途」里每张卡写着要多强的模型，点「接入」。
按意思找：语义搜索
- 在「语义搜索」点「接入」，模型来源选「本机 Ollama」，模型选或填
qwen3-embedding:0.6b。 - 也可以选「在线服务」，地址可从建议里选（如千问），模型从列表里选。
- 打开「使用下面配置的模型」，保存。在「查看详情」里能点「测试连接」。
用 Ollama 要先在本机装好它，并下载这个模型。
老知识：补检索词
- 先给 Astro 接上模型，在它的设置里打开「允许补老知识的检索词」。
- 选一个项目，先看免费估算：多少条缺检索词、大约多少 tokens。
- 点「先试 20 条」，看补前补后能找回几条，再决定「补剩下 N 条」或「不补」。
补的时候随时可以点「停止」。
遇到问题
- FULI 会自己体检。顶栏出现「有 N 件事需要你」时点「查看」，能修的点「自动修复」。
- Windows 上没启动成功、提示端口被保留时，在托盘菜单选「换一个端口」。
- 顶栏版本号旁出现小圆点就是有新版本：点版本号打开 设置 › 版本，点「更新到 v…」。
- 更新不删知识。更新后，已经打开的 AI 会话要重开。
- 要找开发者：设置 › 系统 › 诊断包，点「生成诊断包」再「导出」。里面没有知识和对话。