Releases: iduoduo1002/zotero-AI-Butler
Release list
AI Butler v4.1.0-beta.9
AI Butler 4.1.0-beta.9
修复 Codex AI 总结与 AI 精读的两个现场阻断问题。
- Sol 规划、Luna 执行与 Sol 验收固定使用队列已选中的同一个 Codex 端点；瞬时过载、限流及连接故障在同一端点内退避重试，不再轮换到其他供应商。
- 供应商传输故障与内容验收分离。
server_overloaded等运行故障不再写成 SolBLOCKED，失败代码与重试属性保留到任务诊断和审计账本。 - 同时识别 Codex App Server 的 camelCase 与 snake_case 错误变体，例如
serverOverloaded和server_overloaded。 - 完整来源上限从 100,000 字符提高到 200,000 字符；已验证的 119,773 字符论文不再被误报为索引或哈希不完整。
- 超过边界的完整来源使用
codex-source-over-limit明确阻断，不再误报codex-source-incomplete，也不会静默截断后进入验收。 - AI 总结在且仅在 Sol 的 PARTIAL 只涉及可修复的事实溯源问题时，允许 Luna 进行一次受限返工，并再次执行候选探测与 Sol 验收。
- AI 精读采用同样的一次性事实溯源返工，但 Luna 只返回 1–8 个结构化最小替换补丁；插件确定性应用补丁并验证全部深读槽位标记，避免重写整篇长笔记造成超时。
- 真实长文精读已验证初验
PARTIAL、Luna 返工、Sol 复验PASS、写入与精确回读的完整闭环；诊断脚本可分别识别带原生输出 schema 的 Sol 规划与验收回合。 - 最小替换补丁已使用同一份 TidyMass2 PDF（SHA-256
6955d8b58167b771cf7bd56da576d3fdf5cdbc6ed479880cb01fb2444ca1bc0d）进行独立真实 Codex 验证：119,829 字符完整源文本、11.255 秒完成，无依据断言被移除，深读槽位标记顺序保持不变，且未写入正式 Zotero 资料库。
安全边界保持不变：来源、附件或 SHA-256 无法验证，候选探测失败，或 Sol 内容验收不是 PASS 时，均不写入 Zotero 笔记。
发布门禁：确定性回归、类型检查、代码格式、生产构建、XPI 完整性、隔离环境真实 Codex 总结与精读、写入后回读均需通过。本文档中的通过项以对应发布提交的验证记录为准。
AI Butler v4.1.0-beta.7
AI Butler 4.1.0-beta.7
修复 Codex 已登录、生成内容后却在保存笔记前出现 PARTIAL 的证据链问题。
- Sol 验收获得与 Luna 相同、绑定指定附件及散列的完整来源文本；内容证据和运行条件分开验收。
- 摘要要求论点与来源证据明确对应；验收失败保留具体原因，不再误标为 API 故障。
- 严格核验 Zotero PDF 全文索引及页数，拒绝部分、未知或超限来源；不完整来源不触发供应商回退。
- 保留“不通过不保存”规则，不以跳过科学验收换取成功状态。
验证：327 项确定性回归通过；45 项可选联网冒烟未运行。真实 Codex 正负例 2 项通过：正常 PDF 总结保存并读回成功，不受原文支持的结论被拒绝且不写笔记。类型、格式及生产构建检查通过。
使用：先执行 codex login，在模型平台选择“Codex App Server（本机登录）”，填写 Codex 可执行文件绝对路径，保持 PDF“文本提取”。无需在插件中填写 Codex API Key。本机登录不等于离线模型，提取文本仍发送至 Codex 模型服务。
范围：本次完整来源验收针对单篇 AI 总结；精读保留旧路径。来源上限 100,000 字符、候选上限 12,000 字符；Codex 显式附件模式暂不支持 MinerU。请先验证一篇文献，再批量运行。
AI Butler v4.1.0-beta.6
修复
- 修复长候选验收摘要只保留前 4000 字符导致
## Evidence丢失的问题；现在采用首尾有界摘要并标注截断状态。 - 增加 Summary 候选的
## Summary/## Evidence结构探测，并将队列写入边界、候选探测结果显式交给 Sol 验收。 - Luna 总结要求严格输出有界 Markdown 结构，避免验收输入缺少必需证据。
- Sol 验收 PARTIAL/BLOCKED 现在透传可读原因、标准计数和“未写入 Zotero”诊断，不再显示笼统的“未知错误”。
验证：macOS Zotero harness 358 passed；lint、TypeScript build、i18n build checks passed。
AI Butler v4.1.0-beta.5
修复 Luna 长文任务超时
- 修复队列中 Luna worker 使用
max推理导致长文持续生成、最终触发Codex app-server turn timed out after 300000ms。 - Sol 规划与验收仍使用
gpt-5.6-sol+high。 - 队列中的 Luna summary/deep-read 回合实际固定为
gpt-5.6-luna+high，并且账本记录与实际参数一致。 - 设置页直接调用仍保留用户选择的模型和推理强度；限制只作用于 Sol/Luna 队列执行。
验证
npm run lint:checknpx tsc --noEmitnpm run build- 配置本机 Zotero 的完整 harness：357 项通过。
- 合成协议探针：33,050 字符输入使用 Luna/high 约 69 秒完成；Luna/max 在 120 秒仍未完成。
尚未代替用户执行真实文献重试；安装 beta5 后请在任务队列对失败任务点击“重试”。
AI Butler v4.1.0-beta.4
修复
- 修复 macOS Zotero GUI 启动 Codex App Server 时
env: node: No such file or directory。 - 启动时为 Subprocess 注入
/usr/local/bin与/opt/homebrew/bin，保留原有 PATH，并通过environmentAppend: true保留 HOME/CODEX_HOME 等继承环境。 - 非 macOS 行为保持不变；绝对路径与 bare command 的安全边界保持不变。
验证
npm run lint:checknpx tsc --noEmitnpm run build- 配置
/Applications/Zotero.app/Contents/MacOS/zotero后完整 harness：357 项通过。
尚未使用真实供应商凭据执行在线 smoke；安装后请在 AI Butler 的 Codex 供应商卡片中点击“测试连接”。