Windows x64 免安装版
没有安装程序，不写注册表，解压就能用。
-
在 Releases 页面下载 Windows x64 的压缩包。
-
完整解压到一个固定目录。不要在压缩包里直接双击运行，那样程序找不到自己的资源文件。
-
双击目录中的
PeopleLib.exe启动。 -
保留整个程序目录，不要只把 exe 移到别处。用户数据保存在程序同级的
data/目录里。
更新到新版本
先完全退出正在运行的 PeopleLib.exe，再用新版本的文件覆盖程序目录。
data/ 目录不要替换，书库、笔记与批注都在里面。想换目录的话，把整个目录连 data/ 一起搬走。
Windows 可能对下载来的可执行文件提示来源不明，这是未购买代码签名证书的常见表现。 如果你不确定，可以先在 Releases 页面核对文件来源。
macOS arm64 DMG
适用于 Apple Silicon 机型。安装包为 ad-hoc 签名，没有经过 Apple 公证。
首次打开会被系统拦下，这是正常的
应用用的是 ad-hoc 签名，没有付费开发者账号，也没有走 Apple 的公证流程。 所以 macOS 首次会提示无法验证开发者，或者说文件已损坏。这不是病毒，而是未公证应用的标准提示， 按下面的步骤打开一次之后就不会再出现。
-
在 Releases 页面下载 macOS arm64 的
.dmg文件。 -
双击挂载 DMG，把 PeopleLib 拖进「应用程序」文件夹。
-
在「应用程序」里 按住 Control 点击（或右键）PeopleLib 图标，选择「打开」， 然后在弹出的对话框里再点一次「打开」。直接双击是不行的，必须走右键菜单这条路径， 因为只有它会给出确认打开的选项。
-
如果仍然被拦，打开「系统设置」，进入「隐私与安全性」，在页面下方找到刚被阻止的 PeopleLib， 点击「仍要打开」。
macOS 版的用户数据在 ~/Library/Application Support/PeopleLib，不在应用包里。
升级时直接覆盖「应用程序」里的旧版本，数据不受影响。
Intel 机型目前没有提供构建版本。
第一次启动之后做什么
- 需要代理就先配代理。设置里配一次，对所有数据源与封面请求同时生效。
- 试一次检索。可以先只选一个数据源，确认网络通畅，再切到聚合搜索。
- 导入已有的书。本地已有的 PDF、EPUB 等文件可以直接导入书库，不必来自检索结果。
- 想用 AI 就填自己的接口。填接口地址与 API Key，选择协议类型。不填也能正常阅读，AI 是可选的。
从源码运行
源码运行、打包发布、代理与账号配置、数据位置、项目结构与测试说明都在源码仓库的 BUILD.md 里。
公开仓库只发布二进制与使用说明。
运行环境要求 Node.js 22.19.0 或更高版本。