从装好到用顺

一、安装与启动

1. 解压

   把下载的 zip 解压到一个固定位置，例如 D:\磐知。不要放在「下载」文件夹里随手删掉。

2. 双击「磐知知识库.bat」

   这是唯一入口。首次启动会初始化数据库，约 2–5 分钟，完成后浏览器自动打开首页。

3. 关闭程序

   在那个黑窗口里按 Ctrl+C，本地数据库会随进程一起正常关闭。直接关窗口也可以，但不建议在写入时强杀。

二、激活买断版

免费版可以长期使用本地知识库。要解锁「知识脉络 / 智能搜索 / AI 智能体」三项正式版功能，需要购买本地买断版（¥29.90 一次性）并激活。

1. 在客户端左侧导航点「启核」；
2. 按页面提示复制本机的设备标识发给客服；
3. 客服核对订单后，给你一枚激活码（一段文本）；
4. 把激活码粘回「启核」页面，点激活。激活码与本机设备绑定，换机器需要重新申请。

激活码由服务端私钥签发，客户端用内置公钥验签。所以激活不需要联网，也不会把你的数据传出去。

三、订阅与每日额度

订阅是怎么生效的

在客户端「按订阅 · 平台域」区块选择要订阅的域，付款确认后由客服在后台为你开通。开通后， 首页会出现当天的推荐内容；「云端」相关入口在未订阅状态下显示为锁定态。

每天能得到什么

• 推荐 1 篇：从你订阅的域里挑当天的一篇，当天不会重复；
• 自选下载 1 篇：你自己在云端挑一篇下载到本地，永久留存；
• 在线浏览：订阅域的全部历史内容可以不分篇数在线阅读。

四、数据在哪，怎么备份

所有数据都在程序目录下的 pgdata\ 文件夹里。

• 备份：先在黑窗口按 Ctrl+C 停掉服务，然后把整个 pgdata\ 文件夹拷到别处；
• 迁移到新电脑：把整个程序文件夹（含 pgdata\）拷过去，双击启动即可；
• 恢复：停掉服务，用备份的 pgdata\ 覆盖回去，再启动。

五、更新与回滚

程序每 30 分钟自动检查一次更新，只下载变化的文件，在凌晨 2:00–4:00 之间换上；换之前自动备份，换完自检，失败自动回滚。你也可以手动点「检查更新」。

想确认当前跑的是哪一版：浏览器打开

http://127.0.0.1:8100/api/instance/identity

看返回里的 release 一段：installed_release / commit / last_check_at / rollback_to。

需要手动退回上一版时，在程序目录下执行：

runtime\python\python.exe client-src\launcher\start_edge.py --rollback

回滚只回退程序代码；如果数据库结构已经升级到新版，需要联系客服协助降级。

六、常见问题

双击后窗口一闪就没了

大概率是包没解压完整（比如直接在压缩包里双击运行）。请先完整解压到硬盘上再双击。

提示「总部地址未配置」

说明这台机器是本机模式：知识库一切正常，但不上行数据、也收不到自动更新。 要开通云端能力，请联系客服获取配置方式。

首页打开了，但云端内容是锁定的

未订阅时的正常状态。云内容可以免费试读 3 篇，试读完后需要按域订阅才能继续。

AI 功能点了没反应

需要在「设置」里填一个你自己的模型 API Key。我们不代付、也不经手你的 Key。

换了电脑，激活码还能用吗

激活码与本机设备绑定，换机器需要联系客服重新签发一枚。请提供新的设备标识与购买订单号。

知识库会越用越慢吗

本地库到几千页仍然流畅。如果明显变慢，通常是同时开着其它占内存的程序，可先关掉再试。

以上都没解决？联系客服，附上你的版本号与错误截图。