Repository navigation
Releases: Authentic3096/zotero-kb
Release list
v2.0.8
优化项目下载使用方式
完整对比：v2.0.7...v2.0.8
v2.0.7
v2.0.6
优化了面板显示细节。
安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.6.xpi。往 profile 的extensions\丢 xpi 无效，必须走这个入口。
- 运行环境页八行改成七列对齐（来源、状态、浏览、恢复自动各占一列）
- 修复若干已知问题
完整对比：v2.0.5...v2.0.6
v2.0.5
这一版清掉了上一代「本机服务」架构的全部遗留，并把插件设置与可选组件安装都收进管理面板；
知识库数据格式没有变化，直接覆盖安装即可。
安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.5.xpi。往 profile 的extensions\丢 xpi 无效，必须走这个入口。
- 左侧导航重排：知识库结构 → PDF 解析 → 分节纲要 → 经验库 → 元数据 → 分类建议 →
损坏查询 → 运行环境 → 偏好设置 → 高级 → 提示词 - 可选组件的安装入口：「偏好设置 → 可选组件安装引导」里现在能直接装 ——
Ollama（打开下载页 / 拉取推荐模型）、MinerU（开始安装 / 重新安装）。
安装是后台任务，输出逐行显示；失败会保留原因，不会"点完没反应" - 正文字号：改成直接填数值（px，10–20），改完已打开的侧栏立刻生效；
侧栏不再有档位选择 - 运行环境页去掉了一句多余的小字
- 上一代的本机 HTTP 服务整条链移除：回退启动、开机自启、任务队列、通行证文件都不再存在；
引擎与面板只走 Zotero 插件自己的无端口通道 - 修复若干已知问题
完整对比：v2.0.4...v2.0.5
v2.0.4
这一版把插件设置收进管理面板，并整理了面板的显示细节；知识库数据格式没有变化，直接覆盖安装即可。
安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.4.xpi。往 profile 的extensions\丢 xpi 无效，必须走这个入口。
- Zotero「设置 → 文献知识库」那一栏下线：所有开关搬进管理面板的新页「偏好设置」——
知识库行为、侧栏「知识库」的层级与字号、知识库同步、知识库位置、可选组件安装引导、
任务通道（排查用） - 模型选择并入「运行环境 → 模型配置」，沿用原来更好用的规则：本机 Ollama 时只列名字带
上下文大小后缀的模型（例如qwen3:4b-instruct-24k），当前在用的模型永远留在列表里 - 模型配置的权威来源统一为一处，老设置启动时自动并入（只补缺、不覆盖）
- 「运行环境」页八行改为定宽网格：路径用等宽字体、过长时中段省略（悬停可看全路径），
来源 / 状态 / 按钮各列对齐 - 「重启引擎」现在会真的停掉引擎进程，下一次请求自动拉起；有任务在跑时不会硬停
- 修复若干已知问题
完整对比：v2.0.3...v2.0.4
v2.0.3
这一版只改插件与文档，配置项与知识库数据格式没有变化，直接覆盖安装即可。
安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.3.xpi。往 profile 的extensions\丢 xpi 无效，必须走这个入口。
- 「高级」页新增「索引重建」：增量更新只处理有变化的文献；全部重建会把全库
重新切片、重算向量（危险动作，点了会二次确认）。两者都在后台跑，进度写在下方的运行日志里，
可以直接关掉面板等它跑完。 - 「高级」页新增「维护动作」：环境自检（Python / MinerU / Ollama 与磁盘体检）、
备份索引、对账巡检（只读，列出知识库与 Zotero 之间对不上的地方）。 - 修复「知识库结构」页的「刷新」按钮点了没有反应。其余带"刷新"字样的按钮本来就各自有真实
的刷新路径，这次一并核对过。 - 提示文案修正：原先有几处让用户去点并不存在的按钮（例如"手动更新"、"启动 Ollama"），
现在都改成照着做能成的说法；同一个动作在不同地方出现的按钮名也统一了。 - 合并掉重复的文档：设计与用法全部并入
ARCHITECTURE.md，知识库层级与目录树并入
INSTALL.md。仓库现在只剩README.md、INSTALL.md、ARCHITECTURE.md与本说明。 - 通读校对了一遍，修正了与现在实现不符的说法（面板上有什么按钮与页签、右键菜单项、
设置项、本地模型相关数字等）。 INSTALL.md补上分节纲要与模型窗口的两个关键数字：每节正文上限 9000 字、
提示词约 800 字，并明确推荐本地模型的上下文开到 16384。
与 2.0.0 相同：- DSH 侧直读
index.db只能读到原始字段值；权重这类算出来的字段要走引擎，不要在前端
复刻一遍算法。 - 与早期那个常驻的本地服务相比，少了"从别的程序随时 curl 一下"这条路 —— 这是有意去掉的。
- MinerU 相关的全量测试没有跑（会长时间占满机器）。
v2.0.2...v2.0.3
完整对比：v2.0.2...v2.0.3
v2.0.2
这一版只改插件与文档，配置项与知识库数据格式没有变化，直接覆盖安装即可。
升级之后已有的纲要不会自动重建：想让旧文献用上新的"跳过参考文献、每节上限更大"，
在管理面板「分节纲要」页对要更新的文献重新生成一次即可。
安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.2.xpi。往 profile 的extensions\丢 xpi 无效，必须走这个入口。
- 去掉「本地服务地址」与「访问 token」两个输入框。它们对应的是早期版本用过的本地服务，
那个服务早已停用、插件也不再依赖它；留着只会让人以为要启动什么。 - 「知识库位置」不再经由那个服务读取，改由插件自己的引擎回答 —— 服务停着也能正常显示，
旁边的「打开这个目录」「迁移到 Zotero 数据目录」同样如此；迁移完成的提示改成
"重启 Zotero 后生效"。 - 删掉「内容窗格『本地模型』」那一块（一个勾选项、一个上下文窗口输入框和一段说明）：
它描述的内容窗格聊天早已下线，对应的配置项也不存在了，改它不会有效果。 - 「用哪个本地模型」的列表改由引擎读取，不再依赖那个本地服务；失败提示改成可以照着做的
说法（先确认 Ollama 在跑、给出地址与安装入口）。 - 列表默认只列名字带上下文后缀的模型（如
-4k/-16k/-24k），并在下面写清后缀
对应的窗口大小；有一个勾选项可以关掉这个过滤。没有后缀的模型看不出窗口多大，容易挑错。 - 去掉了「自动选」这一项：只有一个模型时直接用它；有多个时按"推荐的那一系优先、同系里
窗口大的在前"排好，默认选中第一个并标注推荐，也可以自己选别的。 - 跳过参考文献类小节：这类小节常常是全文最长的几节，问模型纯属浪费。判据补上了中文字
之间的空格与两种词序（实际来自论文的标题经常写成参 考 文 献或"文献参考"），另外也认
bibliography、works cited这类写法。按本机库统计，这类小节约占十分之一。 - 每节正文上限从 5000 字提到 9000 字，模型窗口从 8192 提到 16384。切节器本身就在
9000 字处切，两处对齐之后，长节基本不再被截断（此前约 14% 的节会被截掉尾部）。
这两个值是绑在一起的，代码与仓库侧检查里都写了断言：只改一个会让检查失败。
INSTALL.md新增「本地模型与上下文（建议用派生模型）」一节：为什么建议用ollama create
把上下文做进模型、Modelfile 与命令示例、命名约定，以及推荐值 —— 并说明插件发请求时会带上
自己的窗口设置（会覆盖模型里的值），所以模型名后缀主要是给不显式设置窗口的客户端看的。
与 2.0.0 相同： - DSH 侧直读
index.db只能读原始字段值，权重这类算出来的字段要看就得走引擎，
不要在前端复刻一遍算法。 - 有几条写入成功路径没有在真机上验过（只验过出错路径，没有往真库里写测试数据）：
分类建议、阅读器侧栏保存、运行环境保存。 - 有两处交互没有在真机验过：经验库编辑弹窗里再叠一层对话框、下拉替代控件的实际展开。
- 与早期那个常驻的本地服务相比，少了"从别的程序随时 curl 一下"这条路，这是有意去掉的。
- MinerU 相关的全量测试没有跑（会长时间占满机器）。
v2.0.1...v2.0.2
完整对比：v2.0.1...v2.0.2
v2.0.1
这一版只改文案：设置页里有几处说明把 Markdown 的强调标记原样写进了界面，
另有几句提示还在讲已经停用的旧通道。功能、配置与知识库数据格式都没有变化，
直接覆盖安装即可。
安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.1.xpi。往 profile 的extensions\丢 xpi 无效，必须走这个入口。
Zotero 的偏好页不解析 Markdown，所以那些写成**这样**的说明，在界面上会显示成
一对星号。这一版把它们改成正常的加粗显示，一共六处，分布在：
- 「知识库位置」里关于迁移的那句说明；
- 「跨机同步」说明里的"不能"；
- 「从 DSH 导入文献」的两处说明；
- 「本地模型」那一段里的两处说明。
「本地服务地址」下面那句提示也重写了。它原来还在讲插件早期用过的本地服务与某个内部阶段的
编号，现在改成：这个地址对应的是早期版本的本地服务，已经停用、插件不依赖它，
确实需要时手动运行scripts\4-service.vbs。
与 2.0.0 相同：Zotero 7 ~ 11（9 和 10 都装得上），配置项与知识库数据格式不变，
升级不需要额外动作。
与 2.0.0 相同： - DSH 侧直读
index.db只能读原始字段值，权重这类算出来的字段要看就得走引擎，
不要在前端复刻一遍算法。 - 有几条写入成功路径没有在真机上验过（只验过出错路径，没有往真库里写测试数据）：
分类建议、阅读器侧栏保存、运行环境保存。 - 有两处交互没有在真机验过：经验库编辑弹窗里再叠一层对话框、下拉替代控件的实际展开。
- 与早期那个常驻的本地服务相比，少了"从别的程序随时 curl 一下"这条路，这是有意去掉的。
- MinerU 相关的全量测试没有跑（会长时间占满机器）。
v2.0.0...v2.0.1
完整对比：v2.0.0...v2.0.1
v2.0.0
知识库插件 2.0.0（架构换代）
这次不是小修补：管理面板从"另开一个 Python/Tk 程序"改成住在 Zotero 里，
配套把常驻的本地 HTTP 服务（127.0.0.1:8765）整个下掉。业务代码一行没重写，
换的是"界面跑在哪、用什么跟你说"。安装：Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File… → 选本页的
zotero-kb-2.0.0.xpi。⚠ 往 profile 的extensions\丢 xpi 无效，必须走这个入口。
这一版换掉了什么
| 2.0 之前 | 2.0 之后 | |
|---|---|---|
| 管理面板 | 独立的 Python 程序（tools\gui.py + Tkinter，八个页签），从 Zotero 里"拉起来" |
Zotero 自己的窗口（工具菜单 →「知识库管理…」），10 页：知识库结构 / 经验库 / 分类建议 / 分节纲要 / 运行环境 / PDF 解析 / 损坏查询 / 元数据 / 高级 / 提示词 |
| 面板与知识库之间 | 常驻 HTTP 服务 127.0.0.1:8765（带 token） |
插件按需拉起的子进程，父子进程 stdin/stdout 上的 JSON-RPC（NDJSON）。没有监听端口、没有 token、不常驻、不自启，随 Zotero 退出 |
| 跨程序派活（如"让 Zotero 抓一篇文献"） | HTTP 队列 | 文件信箱 <知识库>\mailbox\{requests,claimed,results}（HTTP 那条留着、默认关，开关 zotero-kb.taskPollHttp） |
| DSH 侧取数 | HTTP /item-info /weights /col-status |
直读 index.db（Node 24 的 node:sqlite，readOnly） |
| 界面 | Tkinter/ttk | 无框架的纯 HTML/CSS/JS（resource://zotero-kb/content/admin.html），令牌与旧面板同一套语义 |
面板 UI（这一版统一过一遍的口径）
- 吸顶：页里那条操作行与表头
position: sticky都贴在滚动容器顶边（top要用
calc(-1 * var(--sp-l))抵消内容盒 padding，否则顶上会透出一条缝）。 - 表头排序：能排的只有有明确大小关系的列（key / 标题 / 年份 / 得分 / 权重 / 重点）；
自由长文本不给排序（"命中片段""备注"）。客户端分页的表，点表头先对全量排、回到第 1 页重画
（只排当前页会看着像"排错了"）。 - 分类多选筛选：经验库「选择关联文献」与分类建议页共用同一个共享零件
KBAdmin.multiSelect，一次可选一个或几个分类。 - 切页不摘挂 DOM、只切
hidden，并用 promise 去重（避免"像又读了一遍"和重复取数）。 - ⚠ Zotero 的
<browser>里原生<select>的弹层打不开，所以页面里一律不用它：
≤4 个选项用并排按钮组，长列表用自绘下拉。
顺手的清理（不改变行为）
- 死代码：一批"只服务过一次迁移/补丁/实验"的脚本、旧面板专用的截图工具、
已删模块残留的.pyc与.pytest_cache。 - 重复实现合并：
now_iso（原先 5 处各写一遍）、dir_size（3 处）、human_size（3 处）、
table_columns（2 处）收进offline\schemas.py的公开小工具。唯一的可观察差异：
索引文件大小在 ≥1 GB 时显示成2.00 GB（原来2048.0 MB），MB 统一保留一位小数。
已知限制（照实写）
node:sqlite直读是只读的：DSH 侧只能读items等表的原始值。weight这类算出来的字段
直读不出来（那是引擎里算的），要显示必须走引擎的advanced.weightList，别在 JS 里复刻一遍。- 有几条"成功路径"没在真机上验过（只验了坏输入，按"不写真实数据"的纪律）：
分类建议classify.item、阅读器侧栏doc.save、运行环境env.save的写入成功分支；
healthCheck迁移后只做过只读对照。 - 有两处交互没在真机验过：经验库编辑弹窗里再嵌一层
<dialog>；<select>替代控件
（并排按钮组 / 自绘下拉）的实际展开。 - 与旧 HTTP 通道相比，少了"从别的程序随时 curl 一下"这条路（这正是下掉 8765 的目的）。
要临时用它就按下面的回退路径起回来。 - MinerU 相关的全量测试没有在本版跑（会真拉起 MinerU 占满机器）。
回退路径
- 想把 8765 服务起回来（插件与 DSH 侧本来就不依赖它，所以不起也不影响功能）：
双击scripts\4-service.vbs（或python online\localserver.py）；
想让插件自动拉起就再跑一次Zotero.Prefs.set("zotero-kb.autoStartService", true)
（短名，别写全名）。 - ⚠ 别点
scripts\install-autostart.ps1/autostart-service.vbs—— 那是登录自启入口，
会把"服务已停"这个状态破坏掉。 - 装回旧版插件：用 GitHub Release 上的
zotero-kb-1.12.0.xpi，
在 Zotero 里直接覆盖安装即可；updates.json指向的是最新版，回退后不会自动"升"回来。
还是老规矩的地方（没变）
只读 Zotero、绝不写回 zotero.sqlite；正文修订层是唯一的正文写路径；
知识库目录里的 edits\ 是用户资产、绝不能删；改 zotero-plugin\src\*.js 之后必须跑
python tools\build_bootstrap.py。
完整对比
v1.12.0
知识库插件 1.12.0。
这一版让你能在 PDF 上直接修正公式：右键那一块公式，改好、确认，正文立刻跟着更新。
右键公式，就地改
- 在 Zotero 里打开 PDF，右键那一块公式（不需要先画标注；用区域标注框选也行），
菜单里会多一项「知识库：修正公式」。 - 点它，右侧「知识库」一栏弹出编辑区：左边是这块公式的原文图（对着它核对），
右边是这一条的 LaTeX，可以改，下面实时预览排版结果。 - 一页里有多条公式时，可以从下拉里挑要改的那一条。
- 点「应用」只改这一条公式，保存后这一页立刻重切重向量 —— 和「改这一页」走的是同一条路，
检索、切片、向量一起更新；「恢复原版」仍能一键回到机器解析稿。
想用 MathType 排版也可以 - 编辑区里有「用 MathType 编辑」：点一下会把当前 LaTeX 放进剪贴板并打开 MathType，
在 MathType 里对着原文排好版、复制，回编辑区粘进框里即可。 - 已经会用 MathType 的同学零学习成本；没装 MathType 时这个按钮是灰的，不影响手改。
- MathType 是外部可选工具：本项目不捆绑、也不要求安装。
安装引导的两处修正 - 引导窗口在「体检」期间，安装与下载按钮不再可点（体检结果出来之前不该让你点）。
- MinerU 引导：已经装了 basic 档时，勾上「额外装 VLM 档」现在可以补装 VLM 档了
（之前按钮是灰的，装不上）。
升级 - Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File…，选本页的
zotero-kb-1.12.0.xpi。 - 装完请重启 Zotero。
- ⚠ 如果你之前改过正文或公式，「知识库\edits\」里那些修订稿不要删。
完整对比：v1.11.1...v1.12.0
完整对比：v1.11.1...v1.12.0