常见问题
点击问题展开答案。没有覆盖到的情况可以到仓库提 issue。
费用与账号
PeopleLib 本身要钱吗
不要。项目以 MIT 许可开源，没有付费版、订阅或功能解锁。
AI 助手要不要花钱
取决于你自己接的服务。应用不内置任何厂商的 AI 服务，也不代收任何费用。 你在设置里填自己的接口地址与 API Key，费用由你和那家服务商结算，账单也在他们那边看。
如果你接的是本地跑的模型，或者某个免费额度内的接口，那就不花钱。 不填 AI 配置的话，检索、书库与阅读功能都能正常使用，AI 是可选的。
需要注册账号吗
PeopleLib 自己没有账号体系，不需要注册也不需要登录。 个别数据源（例如需要登录才能取下载直链的站点）要用你自己在那个站点的凭据，凭据保存在本地。
数据与隐私
我的数据存在哪里
全部在本机。书库条目、下载的文件、封面缓存、笔记、批注与阅读进度都写在本地数据目录里，没有云端副本。
- Windows
- 程序目录同级的
data/ - macOS
~/Library/Application Support/PeopleLib
备份就是复制这个目录。彻底删除就是删掉它，不需要在任何地方注销。
我的书和笔记会被上传吗
不会。应用没有服务端，也没有遥测上报。唯一会把正文内容发出去的情况是你主动使用 AI 助手并确认发送， 目标是你自己填写的那个接口地址。详见隐私与安全。
AI 会不会把整本书悄悄发出去
不会。上下文范围由你选，选「全文」时无论文档多短都强制弹确认框，并显示确切字数。 界面上显示的字数就是真正外发的字数，应用不在本地偷偷截断，也不会在你没确认时发送。
我的 API Key 安全吗
Key 经操作系统提供的 safeStorage 加密后落盘，不是明文配置文件，也不会进入界面进程， 日志与错误信息里也不会出现。请求由主进程直接发往你填写的地址，中间没有第三方转发。
能完全离线使用吗
可以。已经下载进书库的文件，阅读、批注与笔记都不需要网络。封面已经缓存在本地，离线也能正常显示。 需要联网的只有检索、下载、AI 请求与检查更新这四件事。
格式与阅读
支持哪些格式
内置阅读支持四类：
- PDF：页面批注、书签、选文与笔记，渲染画质可调
- EPUB：目录、重排、书签、选文与笔记
- MOBI / AZW / AZW3：无 DRM 的 MOBI、KF7 与 KF8 内容
- TXT / Markdown：自动识别编码，Markdown 渲染标题、列表、代码块与表格
DJVU、FB2、CBZ、CBR 可以入库与整理，但没有内置阅读器，阅读要调用系统关联应用。 完整对照表在首页。
Kindle 买的书能读吗
带 DRM 的文件不能。PeopleLib 不解除 DRM，遇到受保护的 MOBI、AZW、AZW3、KFX 或 Topaz 文件会明确拒绝， 并提示改用系统关联的应用打开。无 DRM 的 MOBI、KF7 与 KF8 可以正常阅读。
几百兆的 PDF 会不会卡死
超大 PDF 走分段读取，不会把整个文件读进内存，所以打开一本很大的书不会一次性吃掉几百兆内存。 如果渲染感觉吃力，可以在底栏把画质档位调低。
TXT 打开是乱码怎么办
应用会自动探测 UTF-8、带 BOM 与不带 BOM 的 UTF-16，以及 GB18030。 如果仍然乱码，说明文件用了这几种之外的编码，可以先用文本编辑器另存为 UTF-8 再导入。
笔记能导出吗
可以。摘录与笔记支持导出，方便带到别的工具里继续整理。
安装与运行
macOS 提示无法验证开发者，或者说文件已损坏
这是未公证应用的标准提示，不是文件损坏，也不是病毒。macOS 版用的是 ad-hoc 签名， 没有付费开发者账号，也没有走 Apple 的公证流程，所以系统首次会拦下来。
- 先把 PeopleLib 拖进「应用程序」文件夹。
- 按住 Control 点击（或右键）应用图标，选择「打开」，在弹出的对话框里再点一次「打开」。直接双击不行，必须走右键菜单，只有这条路径会给出确认选项。
- 如果仍被拦，打开「系统设置」，进入「隐私与安全性」，在页面下方找到被阻止的 PeopleLib，点击「仍要打开」。
成功打开一次之后系统会记住这个选择，之后正常双击即可。
Windows 版怎么安装
没有安装程序。下载压缩包后完整解压到一个固定目录，双击里面的 PeopleLib.exe 就能用。
不要在压缩包里直接双击运行，也不要把 exe 单独移出来，程序需要同目录下的资源文件。
更新版本会不会丢数据
不会，但要注意操作顺序。Windows 上先完全退出正在运行的 PeopleLib.exe，再用新文件覆盖程序目录，
data/ 目录保持原样不要替换。macOS 上数据在 ~/Library/Application Support/PeopleLib，
直接覆盖「应用程序」里的旧版本即可。
能换程序目录或者搬到别的电脑吗
Windows 版是便携布局，把整个程序目录连同 data/ 一起复制走就行，
不要只搬 exe，也不要把 data/ 落在旧目录里。
搜不到结果或者下载失败
数据源的可用性取决于站点自身状态。有的站点启用了人机验证，有的接口只提供最新列表而不支持关键词搜索， 有的下载需要该站点的账号。应用遇到这些情况会给出明确提示。
如果所有源都不通，先检查设置里的代理配置，它对所有数据源与封面请求统一生效。
有 Linux 版、移动端或浏览器插件吗
目前发布的是 Windows x64 免安装版与 macOS arm64 DMG。没有移动端应用，也没有浏览器插件。 项目源码开放，其他平台可自行尝试从源码运行。