Releases: SeehowLi/Zotero-localchat
Release list
v0.4.13 · 网络失败恢复
修复网络中断后 Local Chat 一直无法重连的问题。
- 当 ChatGPT App 明确显示网络失败（例如
net::ERR_CONNECTION_CLOSED）时，插件会结束“待确认”状态，恢复原聊天和历史记录。 - 失败的问题会恢复到输入框，需由你确认后手动发送；插件不会自动重发。
- 若请求仍在生成、错误提示与待恢复问题不匹配，或当前 App 页面无法确认，插件仍会保留保护状态，避免重复提交。
升级请下载 Zotero-localchat-0.4.13-windows.zip：停止旧服务，解压到固定目录，运行新目录的 Start-LocalChat.cmd，并在 Zotero 插件管理器安装新版 XPI。仅更新 XPI 不会更新本地服务。
验证：30 项自动测试通过；本机已用真实 net::ERR_CONNECTION_CLOSED 失败状态确认历史、模型控件和失败问题可恢复，未自动发送该问题。
v0.4.12 · 同名论文历史恢复与跨设备续聊
打开论文时自动恢复所选 ChatGPT 项目中唯一同名的云端聊天；后续提问沿用同一个聊天 ID，另一台设备重开或重连后可读取 App 已同步的历史。已有本机关联优先，“新聊天”仍创建独立对话。
- 修复旧聊天的项目身份、模型档位识别，以及后台窗口初始化和窗口识别重试。
- 完整包包含可选的 ChatGPT 开始菜单启动器。
- 27 项本地自动测试通过；实机只读恢复 10 条历史消息及模型控件。尚未在第二台实体设备上完成端到端收发验证。
升级请下载 Zotero-localchat-0.4.12-windows.zip：停止旧服务，解压到固定目录，运行新目录中的 Start-LocalChat.cmd，并安装新版 XPI。仅更新 XPI 不能更新本地服务。保留现有 .zotero-localchat 数据目录，无需复制账号或论文库。
同名结果不唯一时不会自动关联；长历史受 App 懒加载影响，本地缓存最多 80 条消息。
Zotero-localchat 0.4.11 · 随 Zotero 启动与自动恢复
更新记录
0.4.11 · 2026-09-20
- 修复 Windows 应用隔离目录导致 Zotero 看不到连接文件的问题。运行配置移至双方共享的
%USERPROFILE%\.zotero-localchat，迁移旧项目设置与论文关联，不覆盖已有新配置。 - 将中转进程交给 Zotero 管理：启动 Zotero 时检查并启动服务，服务失联或连接文件缺失时可自动恢复，不再依赖临时终端进程。
- 完整包首次启动记录安装位置；多 Zotero 进程共用服务，最后一个关联进程退出后停止中转。
- 已配置项目且 App 本地端口可用时自动连接；App 中途退出后提示手动重连，保留聊天内容，不自动重复发送。
- 插件工具栏新增“重新连接”，在内嵌聊天页无法加载时也能启动服务并恢复页面；用具体的安装或连接提示替代底层文件错误。
- 新增服务生命周期回归，包括配置迁移、连接文件缺失、旧文件对应的进程失效、并发启动、进程归属和退出清理；22 项自动测试通过。
完整包仍需首次运行 Start-LocalChat.cmd 登记位置；ChatGPT 仍需通过 ChatGPT - Local Chat 快捷方式启用本地连接端口。普通启动的 App 不能在运行中补开该端口。
Zotero-localchat 0.4.10 · 首次引导与独立侧栏
更新记录
0.4.10 · 2026-09-20
本次发布汇总自 GitHub 上一个版本 0.4.4 以来的改动，包含本地测试版本 0.4.5–0.4.10。
首次使用与项目选择
- 首次打开侧栏先检查本机 App 是否打开、本地连接是否启用；提供“打开 / 切换到 App”入口。
- 引导用户在 App 的 ChatGPT 聊天中创建或选择
zotero-paper，支持自定义名称，验证唯一名称后记住选择；检查阶段不会发送消息或上传 PDF。 - 已有
Paper论文关联自动沿用原项目；已有对话关联时阻止误切换到其他项目。 - README 补充完整安装顺序、首次引导、日常使用、升级、故障排查及数据保存说明。
阅读与界面
- Local Chat 使用独立的阅读器侧栏面板，不再嵌入论文信息的滚动区域。点击右侧 ChatGPT 图标打开，点击“论文信息”或原生信息/笔记图标返回 Zotero。
- 修正 ChatGPT 图标在侧栏中的尺寸，提供浅色和深色图标；图标归属说明随插件分发。
- 聊天区域随侧栏宽度和窗口高度重新排版，保留用户设置的字号。
- 新增“明亮 / 黑暗 / 跟随 Zotero”主题，自动保存选择；跟随模式通过本机事件连接实时同步。
- 提问使用独立底色、加粗文字、边框和“你的提问 · 编号”，与回答明显区分。
- 新增右侧提问导航：数字快速跳转，展开后显示问题摘要。相同文字的不同提问仍有独立入口。
回复格式、速度与滚动
- 保留 App 已渲染正文的标题、列表、引用、表格、代码、链接及公式结构，替代原先的纯文本转发。
- 公式使用浏览器原生 MathML；文件引用以紧凑卡片显示。转发内容经过允许列表过滤，不执行原页面脚本或任意样式。
- 缓存未变化的历史消息，传输变化的消息并复用已有 DOM 节点，减少重复序列化、传输和绘制。
- 发送后只定位一次到本轮问题，后续回复增长不再自动向下滚动。手动滑到底部或点击“最新回复”不会重新开启自动跟随。
- 点击发送或按回车后立即显示提问并清空输入框，无需等待回答完成；等待期间新写的草稿不会被上一条消息的完成事件清除。
- 发送失败时保留本机备份，输入框为空时恢复原消息，不覆盖新草稿，也不自动重复发送。
验证与贡献
- 18 项自动化测试通过，覆盖首次使用、自定义项目和旧配置迁移，以及格式、公式、内容过滤、增量更新、滚动、导航、主题、草稿恢复、附件及断线恢复。
- 已在指定版本的正式 Zotero 配置中验证安装、独立面板、主题联动、真实回复格式及提问跳转。未将真实论文或聊天记录加入发布包。
- 将 ChatGPT 列为 AI 辅助贡献者，详见 贡献者名单。
升级说明
此更新同时修改了 Zotero 插件和本地中转的前端文件。已有用户请在当前回答完成后运行旧目录的 Stop-LocalChat.cmd，解压新的 Windows 完整包 到固定位置，运行其中的 Start-LocalChat.cmd，并在 Zotero 插件管理器安装包内的 Zotero-localchat-0.4.10.xpi。仅升级 XPI 不能更新旧目录中的聊天前端。
聊天关联与运行配置仍保存在 %LOCALAPPDATA%\ZoteroLocalChat，升级无需删除该目录，也无需重新上传已关联论文。当前仍为 Windows 预览版；已验证版本与性能范围见 验证记录。本地传输优化不等于缩短 ChatGPT 服务端思考、生成或首次 PDF 处理的时间。
Zotero-localchat 0.4.4 · Fast native settings
模型与强度同步改为调用当前 App 原生选择回调并核对真实选中状态，省去菜单开合和完整列表重读。本机实测强度 HTTP 请求从 3385 ms 降至 25–38 ms，模型切换为 54–63 ms；结果仅代表本机指定版本的少量测试。
控件参考官方 App：紧凑模型按钮和强度弹层、更大的档位文字、胶囊滑条与白色滑块。模型菜单在侧栏内渲染；异常响应保留上次确认的名称，修复切换时显示空白。
13 项回归测试通过，覆盖原生选择回调、确认超时不重试、空选中状态、旧版兼容路径及侧栏交互。当前版本适配环境和安装步骤见 README。
Zotero-localchat 0.4.3 · Smoother sidebar
前端流畅度优化：
- 推理滑条连续跟手，松开后吸附实际档位并同步。后台同步时仍可继续拖动；连续滚轮只提交最终选择。
- 串行提交设置，过期响应不会把滑块拉回旧位置；未确认设置不会误用于发送。
- 回复按帧合并、按消息增量更新，保留历史文字选择和阅读位置，新增“最新回复”入口。
- 加宽滑条、显示实际档位刻度，输入框自动增高，并适配窄侧栏、小窗口与大字号。
13 项本地回归测试通过。浏览器实测包含原生鼠标拖拽、慢响应、失败恢复、80 条历史记录以及 320×360 视口与 160% 字号。
下载 Windows ZIP（含 XPI 与本地服务），使用方法见 README。仍使用现有 ChatGPT App 账号，不需要单独网页登录。
Zotero-localchat 0.4.2 · Windows preview
Zotero-localchat Windows 试用版。
修复侧栏自动渲染与工具栏点击同时触发时的重复加载：打开同一论文只建立一次连接，再次打开保留输入。包含 Windows PowerShell UTF-8 兼容修复。
13 项本地自动测试通过；已有真实 App 后台流式问答、模型和 Pro 档位、后续附件、独立 Zotero 侧栏验证。详见 docs/VALIDATION.md。
下载 ZIP（含 XPI 和本地服务），需要 Node.js 22+，按 README 配置。使用现有 App 登录；正常发送不弹窗。首次建立或恢复后台窗口可能短暂显示 App，首字等待仍取决于服务端。
Zotero-localchat 0.4.1 · Windows preview
Zotero-localchat Windows 试用版。
修复 Windows PowerShell 5.1 对中文安装脚本的编码兼容，并保留完整的 ZIP 语言目录标记。12 项本地测试通过，后台流式问答、模型与强度选择、后续附件和独立 Zotero 侧栏均已实测。
下载 ZIP（内含 XPI 和本地中转），需要 Node.js 22+。请阅读 README。复用现有 ChatGPT App 登录；正常发送在后台进行。首次建立或恢复后台窗口可能短暂显示 App，首字等待仍取决于 ChatGPT 服务与模型。
Zotero-localchat 0.4.0 · Windows preview
Zotero-localchat 首个公开试用版，适配 Windows x64、中文 ChatGPT App 26.915.4065 和 Zotero 10。
- 复用已登录 App，在 Zotero 侧栏流式显示正式回答；正常提问不弹出中转窗口。
- 输入框下方切换模型和真实推理档位，支持滑条、滚轮及 Ctrl+滚轮字号调整。
- 每篇论文延续同一聊天，首次提问上传 PDF，支持后续追加附件。
- 修复断线恢复、模型选择、阅读器按钮被拖动区域拦截和安装包语言目录。
下载 Windows ZIP，内含 XPI 和本地服务；需要 Node.js 22+。按照 README 创建 App 本地连接快捷方式。首次建立后台窗口仍可能短暂显示；首字等待取决于 ChatGPT 服务与模型。
12 项本地自动测试通过，并完成真实 App 后台问答、模型切换、追加附件与独立 Zotero 侧栏验证。详见 docs/VALIDATION.md。