briefloop 0.24.0__tar.gz → 0.25.0__tar.gz

{briefloop-0.24.0 → briefloop-0.25.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 变更记录
 
+## 0.25.0
+
+- 英文报告成为完整写作选项：语言随报告进入规划、写作、修订、评价与审阅，英文篇幅按词显示；新增10套英文版式，Word、HTML/PDF与Excel固定标签跟随报告语言。
+- 新增 Excel 报表导出，可按表分工作表或整份报告单表导出。未安装 OfficeCLI 也可使用基础导出；可选增强失败或产物损坏时保留有效基础文件，支持取消、预览与去重复用。
+- OfficeCLI 质检区分观察与失败，明确外部渲染服务说明；修复并发预览图片与元数据不一致、合并表头、大小写重名工作表，以及以等号开头的文本被误当公式。
+- 同时支持 OpenCode 1.x 与 2.x，按实际宿主使用对应服务、会话、模型目录、推理档位和子任务协议；保留 v1，不自动迁移旧会话或认证。v2 Provider 配置在 OpenCode 中完成，已开始会话的系统约定变化需明确新建对话。
+- 审阅拆分为默认普通模式与严格模式。普通模式支持 Codex、OpenCode 与 BriefLoop Agent；严格模式目前由 BriefLoop Agent 强制限定核查包和工具访问。事实与证据标准一致，实际模式和后端随任务冻结并显示，历史未知记录不冒充严格结果。
+- 修复 Native 中文任务包读取和 Windows 更新缓存定位；英文模板选择、Word 渲染缓存与打包模板清单同步修正。
+- 数值核验新增欧元、英镑、按数量级的股份、质量与电量单位；不同币种、功率/电量和百分比/百分点仍分开处理，未知单位不冒充已核验。
+- 状态刷新始终保留正在排队或执行的旧任务，最近记录增加后不会把它们从任务列表挤掉；已结束历史仍保持有界。
+
+本轮正式发布 macOS Apple Silicon、Python/CLI/PyPI 和 GitHub 源码；Windows 安装包保留既有稳定版，待原生验收后另行发布。Mac 包未做 Developer ID 签名或 Apple 公证。渠道状态及工件哈希以本次发行记录为准。
+
 ## 0.24.0
 
 - 汇合 Windows 与 Native 两条开发线，延续 BriefLoop Agent / Agent CLI 统一入口。Native 的对话、研究、写稿、独立评价与修订继续使用同一份来源和版本记录；支持共用写稿装配工具，减少手动填写富文本结构。

{briefloop-0.24.0 → briefloop-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.24.0
+Version: 0.25.0
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT
@@ -41,17 +41,17 @@ Dynamic: license-file
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
-界面与文档为中文，报告正文可选中文或英文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
+界面与文档为中文，报告正文可选中文或英文；英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
 
 新建报告可选择通用报告、商业报告（行业周报／月报、工作进展周报与决策分析）、证券研究（事件点评、公司研究与行业跟踪）或会议纪要。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式均可使用；学术论文、上市公司年报、政府公文和合同的专门内容流程将分批接入。
 
 运行时设置显示本地图标、简介、实际版本与模型信息；未安装工具按卡片浏览。首页仅保留宿主选择器，更新失败会区分检查、下载和安装阶段。见 [运行时选择与检测](docs/运行时选择与检测.md)。
 
-## 0.23：统一工作台与运行时控制
+## 0.25：英文报告、Excel 与审阅模式
 
-统一首页、报告、模板与设置的视觉和交互，报告可比较历史改动并直接下载 Word。增加 ZCode 原生无界面适配，默认使用构建模式；Opencode 的推理档位会传入实际请求。任务状态、首次定时计划入口与公共显示格式同步修复。
+报告可选中文或英文，英文写作规范、词数和导出版式贯穿写稿与审阅；新增 Excel 报表导出，未安装 OfficeCLI 也能使用。OpenCode 1.x 与 2.x 同时支持，普通审阅和严格审阅分别展示实际能力，重大事实错误与证据缺口仍阻止正式交付。
 
-安装包仍未签名或公证；支持的权限和模型能力取决于宿主，ZCode 无界面运行没有逐项批准通道。完整变更见 [CHANGELOG](CHANGELOG.md)。
+本轮提供 macOS Apple Silicon、Python/CLI/PyPI 与 GitHub 源码；Windows 安装包沿用既有稳定版，待原生验收后单独更新。本轮 Mac 包未做 Developer ID 签名或 Apple 公证，平台验证与工件哈希见发行页。完整变更见 [CHANGELOG](CHANGELOG.md)。
 
 新工作区默认优先 Tavily，同时允许宿主自带搜索补查；可主动启用博查、智谱搜索或 DuckDuckGo，按跨市场覆盖或具体缺口补查。受控渠道共用本轮预算，搜索失败、实际发现渠道与原文分别保留。Tavily 需要 API Key，额度以服务账号为准；宿主自带搜索取决于实际工具与权限。
 
@@ -89,7 +89,7 @@ briefloop start --workspace /path/to/workspace
 实际生成前需要：
 
 - macOS 或 Windows，以及 Python 3.11 或更新版本。
-- 至少一个已安装并完成认证的执行宿主：Codex CLI、Opencode CLI、Claude Code、Kimi、Hermes、DeepSeek Reasonix、MiMo Code 或 CodeBuddy Code。Codex 与 Opencode 走原生通道，其余 CLI 通过本地 bridge 接入；WebUI 安装需要 Node.js 20+，桌面 App 使用 Electron 内置 Node。
+- 配置 BriefLoop Agent 的模型提供商，或至少一个已安装并完成认证的 Agent CLI：Codex CLI、Opencode CLI、Claude Code、Kimi、Hermes、DeepSeek Reasonix、MiMo Code 或 CodeBuddy Code。Codex 与 Opencode 走原生通道，其余 CLI 通过本地 bridge 接入；WebUI 安装需要 Node.js 20+，桌面 App 使用 Electron 内置 Node。
 - 首次安装依赖需要网络。使用 Tavily、博查或智谱搜索时，另行配置对应服务的 Key。
 
 也可指定目录、端口和后端：
@@ -147,7 +147,7 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 | MiMo | bridge（JSON 事件流） | 原生 `models --verbose` |
 | CodeBuddy Code | bridge（原生 `--acp`） | ACP 原生模型目录；支持手输模型 ID |
 
-开发分支还提供 **BriefLoop 内置引擎**（需要 Node.js 22.19+）：在“设置 → 模型与提供商”选择它，在“API 提供商”选择用于内置引擎，保存接口地址、API Key 和模型 ID。它直接执行对话、并行 Scout、Analyst 写稿及独立评价，复用同一套报告任务、来源、稿件、一次自动修订和导出。已完成一次真实模型公开周报的生成、评分、修订及失败恢复，并通过网页验证只读权限、版本保存与 Word 下载。原生桌面验收仍待完成，尚未正式发布；一次流程完成不证明报告事实全部正确。
+开发分支还提供 **BriefLoop 内置引擎**（需要 Node.js 22.19+）：在“设置 → 模型与提供商”选择它，在“API 提供商”选择用于内置引擎，保存接口地址、API Key 和模型 ID。它直接执行对话、并行 Scout、Analyst 写稿及独立评价，复用同一套报告任务、来源、稿件、一次自动修订和导出。已完成一次真实模型公开周报的生成、评分、修订及失败恢复，并通过网页验证只读权限、版本保存与 Word 下载。内置引擎已随 0.24.0 发布；具体平台及新版本验收范围见发行记录，一次流程完成不证明报告事实全部正确。
 
 内置引擎的 API Key 保存在本机 `~/.config/briefloop/native-engine/providers.json`，文件仅当前用户可读写，不放进工作区或核查包。模型请求仍会把本次实际读取的材料发送给所选模型服务商；受控检索遵循本报告已冻结的渠道与共享预算。它没有其他 CLI 的自带搜索或任意 shell，Reviewer 只拥有核查包内的读取工具。详见[内置引擎](docs/内置引擎.md)。
 
@@ -157,6 +157,7 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 
 - Opencode 模型填完整 `provider/model`（如 `opencode-go/gpt-5.6-luna`），以本机 `opencode` 已登录的可选模型为准；BriefLoop 不枚举、不限制 provider。
 - 推理档位在 Opencode 下叫 variant（如 high / max），留空为默认；聊天沿用工作区主模型的 variant。
+- OpenCode 同时支持 1.x 与 2.x，按实际服务选择协议，不强制升级或降级。v2 的 Provider 配置在 OpenCode 中完成；既有对话系统约定变化时需明确新建对话。详见[双版本兼容与审阅模式](docs/OpenCode版本兼容.md)。
 - 限制（以诚实为准）：Codex 之外的宿主没有每轮网络硬开关，关闭联网时靠指令与权限执行，宿主自带的 shell 仍可能联网；只有 Codex 支持运行中追加（Opencode 与 bridge CLI 会明确拒绝）；图片附件只在宿主支持读图时可用。
 - 排查：任务失败先看任务日志；"模型 ID"类错误检查 `provider/model` 拼写与宿主登录状态；bridge 相关报错先确认 Node.js 20+ 与本机 CLI 已认证。可通过 `BRIEFLOOP_NODE=/absolute/path/to/node` 指定 Node；缺少 Node 不阻断 Codex / Opencode 的原生发现。
 
@@ -231,14 +232,14 @@ BriefLoop 用主链模型，另外三个角色可以在设置里分别指定、
 
 ## 正文篇幅
 
-| 预设 | 目标字数 | 字数上限 |
+| 预设 | 中文目标 / 上限（字） | 英文目标 / 上限（词） |
 | --- | ---: | ---: |
-| 速览 | 350 | 500 |
-| 简短 | 800 | 1,000 |
-| 标准 | 1,500 | 2,000 |
-| 详细 | 2,000 | 2,500 |
+| 速览 | 350 / 500 | 250 / 350 |
+| 简短 | 800 / 1,000 | 500 / 650 |
+| 标准 | 1,500 / 2,000 | 1,000 / 1,300 |
+| 详细 | 2,000 / 2,500 | 1,300 / 1,600 |
 
-数字可直接修改。中文汉字每字计 1，连续英文或数字串计 1；格式、URL 和来源引用标记不计。原文摘录与定位放在来源记录中。页面显示保存后的实际计数，旧稿没有设置过数字要求时如实显示“未设置”。
+数字可直接修改。中文汉字每字计 1，连续英文或数字串计 1；格式、URL 和来源引用标记不计。英文报告按词计，预设按相近阅读量缩短（深度研究 6,500 / 8,000 词，行业定期报告 3,200 / 3,600 词）。原文摘录与定位放在来源记录中。页面显示保存后的实际计数，旧稿没有设置过数字要求时如实显示“未设置”。
 
 ## 正文图表与 Excel 复用
 
@@ -255,7 +256,7 @@ BriefLoop 按报告目的和历史参考决定哪里用图、哪里用表。可
 - 已上传历史报告可以单独指定为结构与风格参考，不作为本期事实来源；不上传也能在开启联网后开始研究。
 - 研究角色整理本期指标、前值、日期、单位和来源，调用确定计算工具；关键缺口可在剩余共享预算内定向补查，拿不到的数据列出缺口和影响。
 - “数据与缺口”按钮可查看保存的原始值、变化和来源，不调用模型。
-- Word 由“生成 Word”按钮触发，按固定报告版本制作并显示进度。保留通用模板，也支持上传单节 DOCX 准备工作区用户模板；完成后下载到 Word/WPS 查看；内置 36 套版式（7 类文体各 5 套主题，加 1 套固定公文版式），模板页点颜色即选，开箱可用。
+- Word 由“生成 Word”按钮触发，按固定报告版本制作并显示进度。保留通用模板，也支持上传单节 DOCX 准备工作区用户模板；完成后下载到 Word/WPS 查看；内置 46 套版式（7 类中文文体和 2 类英文文体各 5 套主题，加 1 套固定公文版式），模板页点颜色即选，开箱可用。
 - 网页以富文档保存内容、颜色、简单表格、图片和引用；Markdown 为兼容及导入/导出格式。用户改数后保留原始数据供核对，不把旧数据的核查状态套给新稿。
 
 详细使用与数据接口见 [行业报告](docs/行业报告.md)。本次验证采用合成资料，未据此宣称真实行业覆盖率、事实正确率或成本改善。
@@ -319,7 +320,7 @@ npm test
 
 新路径将重要主张绑定到具体原文行、PDF页、Excel单元格、图像和推断前提；网页可查看依据，正文修改后相应绑定需要复核。原始要求、研究方法、正文内容和写作偏好分别解释，企业报告正文不自动附内部检查清单。
 
-Reviewer 使用本任务固定核查包，返回结构化发现及处理说明的复核结果。当前已实测的受限路径为 Opencode 原生只读文件工具：只开放包内明确文件，拒绝包外读取、shell和写入；如果宿主拒绝权限规则就失败，不降级。Codex同等限制仍需完成能力验证，不能将普通文件只读描述为全面受限审阅。能力由一处声明决定：在未声明的后端上，事实核查在开始前拒绝；企业内部报告仍会生成和评分，但评分标为普通评分，正式交付保持阻断并说明需要改用哪个后端。
+Reviewer 使用本任务固定核查包，在独立会话中返回结构化发现及处理说明的复核结果。设置可选**普通审阅**（默认）或**严格审阅**：普通模式通过 Codex、OpenCode 1.x/2.x 或 BriefLoop Agent 的实际只读通道执行，不承诺宿主自动加载的全局/项目上下文完全隔离；严格模式额外强制包内读取，目前由 BriefLoop Agent 的专用核查工具提供。选择严格模式不会自动降级或更换执行后端。两种模式使用相同的事实、证据及交付检查，新任务冻结实际模式，历史未记录模式的审阅不被补标为严格。
 
 工作稿Word下载保持可用。“正式交付”另行检查当前版本的独立审阅、重要主张及必答内容、核心未核验、重大未决发现和冲突；高分不能抵消阻断项。审计包单独导出，逐来源选择原件、摘录或仅定位，缺省仅定位；离线校验为结构与一致性检查，不是事实真伪自动证明。旧正式件保留，更正或后续更新另建版本。
 

{briefloop-0.24.0 → briefloop-0.25.0}/README.md

@@ -2,17 +2,17 @@
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
-界面与文档为中文，报告正文可选中文或英文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
+界面与文档为中文，报告正文可选中文或英文；英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
 
 新建报告可选择通用报告、商业报告（行业周报／月报、工作进展周报与决策分析）、证券研究（事件点评、公司研究与行业跟踪）或会议纪要。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式均可使用；学术论文、上市公司年报、政府公文和合同的专门内容流程将分批接入。
 
 运行时设置显示本地图标、简介、实际版本与模型信息；未安装工具按卡片浏览。首页仅保留宿主选择器，更新失败会区分检查、下载和安装阶段。见 [运行时选择与检测](docs/运行时选择与检测.md)。
 
-## 0.23：统一工作台与运行时控制
+## 0.25：英文报告、Excel 与审阅模式
 
-统一首页、报告、模板与设置的视觉和交互，报告可比较历史改动并直接下载 Word。增加 ZCode 原生无界面适配，默认使用构建模式；Opencode 的推理档位会传入实际请求。任务状态、首次定时计划入口与公共显示格式同步修复。
+报告可选中文或英文，英文写作规范、词数和导出版式贯穿写稿与审阅；新增 Excel 报表导出，未安装 OfficeCLI 也能使用。OpenCode 1.x 与 2.x 同时支持，普通审阅和严格审阅分别展示实际能力，重大事实错误与证据缺口仍阻止正式交付。
 
-安装包仍未签名或公证；支持的权限和模型能力取决于宿主，ZCode 无界面运行没有逐项批准通道。完整变更见 [CHANGELOG](CHANGELOG.md)。
+本轮提供 macOS Apple Silicon、Python/CLI/PyPI 与 GitHub 源码；Windows 安装包沿用既有稳定版，待原生验收后单独更新。本轮 Mac 包未做 Developer ID 签名或 Apple 公证，平台验证与工件哈希见发行页。完整变更见 [CHANGELOG](CHANGELOG.md)。
 
 新工作区默认优先 Tavily，同时允许宿主自带搜索补查；可主动启用博查、智谱搜索或 DuckDuckGo，按跨市场覆盖或具体缺口补查。受控渠道共用本轮预算，搜索失败、实际发现渠道与原文分别保留。Tavily 需要 API Key，额度以服务账号为准；宿主自带搜索取决于实际工具与权限。
 
@@ -50,7 +50,7 @@ briefloop start --workspace /path/to/workspace
 实际生成前需要：
 
 - macOS 或 Windows，以及 Python 3.11 或更新版本。
-- 至少一个已安装并完成认证的执行宿主：Codex CLI、Opencode CLI、Claude Code、Kimi、Hermes、DeepSeek Reasonix、MiMo Code 或 CodeBuddy Code。Codex 与 Opencode 走原生通道，其余 CLI 通过本地 bridge 接入；WebUI 安装需要 Node.js 20+，桌面 App 使用 Electron 内置 Node。
+- 配置 BriefLoop Agent 的模型提供商，或至少一个已安装并完成认证的 Agent CLI：Codex CLI、Opencode CLI、Claude Code、Kimi、Hermes、DeepSeek Reasonix、MiMo Code 或 CodeBuddy Code。Codex 与 Opencode 走原生通道，其余 CLI 通过本地 bridge 接入；WebUI 安装需要 Node.js 20+，桌面 App 使用 Electron 内置 Node。
 - 首次安装依赖需要网络。使用 Tavily、博查或智谱搜索时，另行配置对应服务的 Key。
 
 也可指定目录、端口和后端：
@@ -108,7 +108,7 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 | MiMo | bridge（JSON 事件流） | 原生 `models --verbose` |
 | CodeBuddy Code | bridge（原生 `--acp`） | ACP 原生模型目录；支持手输模型 ID |
 
-开发分支还提供 **BriefLoop 内置引擎**（需要 Node.js 22.19+）：在“设置 → 模型与提供商”选择它，在“API 提供商”选择用于内置引擎，保存接口地址、API Key 和模型 ID。它直接执行对话、并行 Scout、Analyst 写稿及独立评价，复用同一套报告任务、来源、稿件、一次自动修订和导出。已完成一次真实模型公开周报的生成、评分、修订及失败恢复，并通过网页验证只读权限、版本保存与 Word 下载。原生桌面验收仍待完成，尚未正式发布；一次流程完成不证明报告事实全部正确。
+开发分支还提供 **BriefLoop 内置引擎**（需要 Node.js 22.19+）：在“设置 → 模型与提供商”选择它，在“API 提供商”选择用于内置引擎，保存接口地址、API Key 和模型 ID。它直接执行对话、并行 Scout、Analyst 写稿及独立评价，复用同一套报告任务、来源、稿件、一次自动修订和导出。已完成一次真实模型公开周报的生成、评分、修订及失败恢复，并通过网页验证只读权限、版本保存与 Word 下载。内置引擎已随 0.24.0 发布；具体平台及新版本验收范围见发行记录，一次流程完成不证明报告事实全部正确。
 
 内置引擎的 API Key 保存在本机 `~/.config/briefloop/native-engine/providers.json`，文件仅当前用户可读写，不放进工作区或核查包。模型请求仍会把本次实际读取的材料发送给所选模型服务商；受控检索遵循本报告已冻结的渠道与共享预算。它没有其他 CLI 的自带搜索或任意 shell，Reviewer 只拥有核查包内的读取工具。详见[内置引擎](docs/内置引擎.md)。
 
@@ -118,6 +118,7 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 
 - Opencode 模型填完整 `provider/model`（如 `opencode-go/gpt-5.6-luna`），以本机 `opencode` 已登录的可选模型为准；BriefLoop 不枚举、不限制 provider。
 - 推理档位在 Opencode 下叫 variant（如 high / max），留空为默认；聊天沿用工作区主模型的 variant。
+- OpenCode 同时支持 1.x 与 2.x，按实际服务选择协议，不强制升级或降级。v2 的 Provider 配置在 OpenCode 中完成；既有对话系统约定变化时需明确新建对话。详见[双版本兼容与审阅模式](docs/OpenCode版本兼容.md)。
 - 限制（以诚实为准）：Codex 之外的宿主没有每轮网络硬开关，关闭联网时靠指令与权限执行，宿主自带的 shell 仍可能联网；只有 Codex 支持运行中追加（Opencode 与 bridge CLI 会明确拒绝）；图片附件只在宿主支持读图时可用。
 - 排查：任务失败先看任务日志；"模型 ID"类错误检查 `provider/model` 拼写与宿主登录状态；bridge 相关报错先确认 Node.js 20+ 与本机 CLI 已认证。可通过 `BRIEFLOOP_NODE=/absolute/path/to/node` 指定 Node；缺少 Node 不阻断 Codex / Opencode 的原生发现。
 
@@ -192,14 +193,14 @@ BriefLoop 用主链模型，另外三个角色可以在设置里分别指定、
 
 ## 正文篇幅
 
-| 预设 | 目标字数 | 字数上限 |
+| 预设 | 中文目标 / 上限（字） | 英文目标 / 上限（词） |
 | --- | ---: | ---: |
-| 速览 | 350 | 500 |
-| 简短 | 800 | 1,000 |
-| 标准 | 1,500 | 2,000 |
-| 详细 | 2,000 | 2,500 |
+| 速览 | 350 / 500 | 250 / 350 |
+| 简短 | 800 / 1,000 | 500 / 650 |
+| 标准 | 1,500 / 2,000 | 1,000 / 1,300 |
+| 详细 | 2,000 / 2,500 | 1,300 / 1,600 |
 
-数字可直接修改。中文汉字每字计 1，连续英文或数字串计 1；格式、URL 和来源引用标记不计。原文摘录与定位放在来源记录中。页面显示保存后的实际计数，旧稿没有设置过数字要求时如实显示“未设置”。
+数字可直接修改。中文汉字每字计 1，连续英文或数字串计 1；格式、URL 和来源引用标记不计。英文报告按词计，预设按相近阅读量缩短（深度研究 6,500 / 8,000 词，行业定期报告 3,200 / 3,600 词）。原文摘录与定位放在来源记录中。页面显示保存后的实际计数，旧稿没有设置过数字要求时如实显示“未设置”。
 
 ## 正文图表与 Excel 复用
 
@@ -216,7 +217,7 @@ BriefLoop 按报告目的和历史参考决定哪里用图、哪里用表。可
 - 已上传历史报告可以单独指定为结构与风格参考，不作为本期事实来源；不上传也能在开启联网后开始研究。
 - 研究角色整理本期指标、前值、日期、单位和来源，调用确定计算工具；关键缺口可在剩余共享预算内定向补查，拿不到的数据列出缺口和影响。
 - “数据与缺口”按钮可查看保存的原始值、变化和来源，不调用模型。
-- Word 由“生成 Word”按钮触发，按固定报告版本制作并显示进度。保留通用模板，也支持上传单节 DOCX 准备工作区用户模板；完成后下载到 Word/WPS 查看；内置 36 套版式（7 类文体各 5 套主题，加 1 套固定公文版式），模板页点颜色即选，开箱可用。
+- Word 由“生成 Word”按钮触发，按固定报告版本制作并显示进度。保留通用模板，也支持上传单节 DOCX 准备工作区用户模板；完成后下载到 Word/WPS 查看；内置 46 套版式（7 类中文文体和 2 类英文文体各 5 套主题，加 1 套固定公文版式），模板页点颜色即选，开箱可用。
 - 网页以富文档保存内容、颜色、简单表格、图片和引用；Markdown 为兼容及导入/导出格式。用户改数后保留原始数据供核对，不把旧数据的核查状态套给新稿。
 
 详细使用与数据接口见 [行业报告](docs/行业报告.md)。本次验证采用合成资料，未据此宣称真实行业覆盖率、事实正确率或成本改善。
@@ -280,7 +281,7 @@ npm test
 
 新路径将重要主张绑定到具体原文行、PDF页、Excel单元格、图像和推断前提；网页可查看依据，正文修改后相应绑定需要复核。原始要求、研究方法、正文内容和写作偏好分别解释，企业报告正文不自动附内部检查清单。
 
-Reviewer 使用本任务固定核查包，返回结构化发现及处理说明的复核结果。当前已实测的受限路径为 Opencode 原生只读文件工具：只开放包内明确文件，拒绝包外读取、shell和写入；如果宿主拒绝权限规则就失败，不降级。Codex同等限制仍需完成能力验证，不能将普通文件只读描述为全面受限审阅。能力由一处声明决定：在未声明的后端上，事实核查在开始前拒绝；企业内部报告仍会生成和评分，但评分标为普通评分，正式交付保持阻断并说明需要改用哪个后端。
+Reviewer 使用本任务固定核查包，在独立会话中返回结构化发现及处理说明的复核结果。设置可选**普通审阅**（默认）或**严格审阅**：普通模式通过 Codex、OpenCode 1.x/2.x 或 BriefLoop Agent 的实际只读通道执行，不承诺宿主自动加载的全局/项目上下文完全隔离；严格模式额外强制包内读取，目前由 BriefLoop Agent 的专用核查工具提供。选择严格模式不会自动降级或更换执行后端。两种模式使用相同的事实、证据及交付检查，新任务冻结实际模式，历史未记录模式的审阅不被补标为严格。
 
 工作稿Word下载保持可用。“正式交付”另行检查当前版本的独立审阅、重要主张及必答内容、核心未核验、重大未决发现和冲突；高分不能抵消阻断项。审计包单独导出，逐来源选择原件、摘录或仅定位，缺省仅定位；离线校验为结构与一致性检查，不是事实真伪自动证明。旧正式件保留，更正或后续更新另建版本。
 

briefloop-0.25.0/VERSION

@@ -0,0 +1 @@
+0.25.0

{briefloop-0.24.0 → briefloop-0.25.0}/desktop/electron/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "briefloop-desktop",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "briefloop-desktop",
-      "version": "0.24.0",
+      "version": "0.25.0",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

{briefloop-0.24.0 → briefloop-0.25.0}/desktop/electron/package.json

@@ -1,6 +1,6 @@
 {
   "name": "briefloop-desktop",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "private": true,
   "description": "BriefLoop local desktop workspace",
   "author": "Stahl-G",

briefloop-0.25.0/docs/OpenCode/347/211/210/346/234/254/345/205/274/345/256/271.md

@@ -0,0 +1,58 @@
+# OpenCode v1 / v2 兼容
+
+BriefLoop 保留 OpenCode 1.x 接口，并为 OpenCode 2.x 使用独立适配层。界面仍选择同一个 OpenCode CLI，程序依据实际可执行文件和所启动服务的版本选择协议，不要求卸载 v1，也不自动安装、降级或迁移 OpenCode。
+
+## 两代协议
+
+| 项目 | v1 | v2 |
+|---|---|---|
+| 服务检查 | `/global/health` | `/api/info` |
+| 会话目录 | 请求的 `directory` 查询参数 | 创建时的 `location.directory`，后续核对绑定 |
+| 模型与推理档位 | 会话 ModelRef 和逐次 prompt 的 model/variant | 会话 ModelRef；变更后回读，再发送正文 |
+| 任务系统说明 | prompt 的 `system` 字段 | 首次 instruction entry 进入 system；开始执行后仅允许同值续接，变更要求明确新建对话 |
+| 会话执行 | `prompt_async` 与消息轮询 | `prompt` 与分页消息投影 |
+| 模型目录 | `/config/providers` | `/api/provider` 与 `/api/model` |
+
+v2 删除了 `models --verbose`。产品中的模型选择和推理档位共用 BriefLoop 管理的服务及模型目录，使用所选模型实际公开的 variant；不会猜测固定的 low/high 列表。目录没有该模型、没有公开档位、读取失败是不同状态。
+
+新适配保留目录、模型、推理档位、权限、附件和任务说明；宿主拒绝或未保留这些关键参数时，不删掉参数后重试。旧会话在新宿主里不存在时，返回可解释错误，不静默创建新会话冒充恢复。
+
+## 明确的能力边界
+
+- **普通生成与对话**：v1 保留原路线；v2 接入新的会话协议。
+- **系统约定变更**：真实 v2.0.14 的本地兼容供应方请求显示，后续 instruction entry 的修改/删除以 `user` 角色传出，历史初始 system 内容仍保留，并不等价于 v1 每轮重新提供 system。因此本实现会在已开始会话的约定发生变更时拒绝本轮任务，且先于模型、Agent 或条目修改；不自动替换、重建会话或重发。相同约定可继续，同日同设置的普通连续对话不会必然受阻。模型/推理档位、联网状态、搜索策略、工作区基础资料、系统日期/时区或程序升级导致约定变化时，需要明确新建对话。
+- **独立审阅**：OpenCode v1 / v2 都可执行普通审阅，使用新独立会话、原生只读工具规则和同一套事实与证据检查。两代宿主都可能自动加载全局或祖先目录说明，因此都不宣称核查包完全隔离。严格审阅额外要求强制包内读取，当前通过 BriefLoop Agent 的专用核查工具执行；用户明确选择严格模式时，不自动改为普通模式或更换后端。
+- **提供方配置**：v1 原有配置保存功能保留。已核对的 v2.0.14 没有等价的公开 Provider 写入接口，v2 下须在 OpenCode 中完成配置；BriefLoop 不擅自写宿主私有配置或迁移认证。产品会明确拒绝不支持的保存操作，不返回虚假的成功。
+- **旧数据迁移**：如 OpenCode v2 尚未迁移 v1 会话，应在 OpenCode 内按其流程处理，或者明确新建 BriefLoop 对话。BriefLoop 不自动重发旧任务。
+- **权限含义**：原生工具规则不是操作系统沙箱。v2 的 `shell` 对应 v1 的 `bash`；写入、编辑和补丁由 `edit` 规则约束。外部目录规则以及联网工具限制的范围沿宿主实际实现说明，不宣称禁止一切外部访问。
+- **子任务接口**：v1 使用 `task`；v2 使用 `subagent`，传递 `agent`、`description`、`prompt`，仅在继续已有子任务时传真实 `sessionID`。前台返回 `completed` 后再收取结果；`running` 不算完成。研究分工、材料、预算和默认模型继承策略保持一致。
+
+`briefloop doctor` 返回 `opencode_supported_majors`，表示软件适配范围；检测到命令及版本不等于已经登录、模型可调用或完整报告通过验收。
+
+## 实现与验证依据
+
+协议基于 OpenCode **1.18.31** 的实际服务及 **2.0.14** 的实际服务和同版本官方接口。没有把 SDK 路径中的“v2”与可执行程序的主版本混为一谈。
+
+官方来源：
+
+- [OpenCode v2.0.14](https://github.com/anomalyco/opencode/tree/v2.0.14)
+- [v2 会话接口](https://github.com/anomalyco/opencode/blob/v2.0.14/packages/server/src/handlers/session.ts)
+- [系统说明装配](https://github.com/anomalyco/opencode/blob/v2.0.14/packages/core/src/session/model-request.ts)
+- [原生指令条目](https://github.com/anomalyco/opencode/blob/v2.0.14/packages/core/src/session/instruction-entry.ts)
+- [权限执行](https://github.com/anomalyco/opencode/blob/v2.0.14/packages/core/src/permission.ts)
+
+测试区分协议单元检查、隔离的真实 CLI 服务检查，以及真实模型报告。合成服务或本地模拟供应方用于验证接线，不作为真实模型质量、跨平台桌面或正式交付通过的证据。具体结果随该功能的验收记录补充。
+
+## 普通与严格审阅
+
+设置中的审阅模式与执行后端分开选择，新请求默认普通审阅。普通模式目前接入 Codex CLI、OpenCode CLI 和 BriefLoop Agent；严格模式目前只由 BriefLoop Agent 提供。新增能力以服务返回的实际能力列表为准，界面不通过版本号推测隔离能力。
+
+普通与严格使用相同的原稿、来源、版本绑定和问题接纳规则。重大事实错误、核心证据缺口和未决重要冲突仍阻止正式交付；严格不等于事实必然正确，普通也不是降低质量标准。
+
+新任务冻结模式与实际后端，结果页显示实际记录。后改设置只影响新请求。历史缺字段的记录显示“历史审阅（未记录模式）”，不因引擎名称补写为严格，也不重写旧报告与有效审阅。
+
+## 本次验证边界
+
+在 macOS 上使用真实 OpenCode 1.18.31 和 2.0.14、隔离的自建配置和本地合成供应方，验证了服务认证、会话与模型 High 档位、读取回执、拒绝写入、中文消息、用量投影、空子会话列表、空闲取消及自有进程清理。另跑通 v2 Harness 到 ChatStore 的中文消息保存。没有使用用户凭据或外部付费模型。
+
+这些验证证明协议接通，不是完整报告质量验收。未声称覆盖长任务取消、所有权限逃逸、真实多子 Agent 报告或 Windows 桌面；Windows npm shim 转换另用行为测试检查。后续系统约定拒绝、审阅模式与版本字段恢复由定向行为测试验证，具体集成结果见验收记录。

{briefloop-0.24.0 → briefloop-0.25.0}/docs//346/212/245/345/221/212/347/274/226/350/276/221/344/270/216/346/250/241/346/235/277.md

@@ -6,7 +6,13 @@ BriefLoop 将报告内容保存为结构化富文档。网页可直接修改文
 
 在“材料与需求”选择通用模板，或上传 DOCX 创建“我的模板”。BriefLoop 一次性识别章节、职责与本期可替换字段，程序准备模板底稿；后续选择已准备的模板即可复用。
 
-工作区首次打开即自动注册内置版式矩阵：7 类文体（通用报告、商务报告、学术论文、上市公司年报、合同、会议纪要、券商研报）各 5 套主题（品牌绿/极简蓝/珊瑚红/石墨黑/典雅灰），另加 1 套政府公文，共 36 套——政府公文按 GB/T 9704 固定红头、仿宋与黑体标题，不随主题变化，只出正典一格。文体决定结构与封面（如公文红头、合同甲乙方表、研报评级卡），主题决定主色与字体字号。模板页为画廊布局：每类文体一张卡片（图标、适用说明、配色点），先点卡片选文体、再点配色点选主题，底部「已选」栏确认后点「使用该模板」即设为新建报告的默认版式并跳转新建表单；设置页模板下拉按文体分组。内置模板走与上传模板相同的准备管线，不调用模型，随包分发。
+工作区首次打开即自动注册内置版式矩阵：7 类中文文体（通用报告、商务报告、学术论文、上市公司年报、合同、会议纪要、券商研报）和 2 类英文文体（英文通用报告、英文研报）各 5 套主题（品牌绿/极简蓝/珊瑚红/石墨黑/典雅灰），另加 1 套政府公文，共 46 套——政府公文按 GB/T 9704 固定红头、仿宋与黑体标题，不随主题变化，只出正典一格。文体决定结构与封面（如公文红头、合同甲乙方表、研报评级卡），主题决定主色与字体字号。模板页为画廊布局：每类文体一张卡片（图标、适用说明、配色点），先点卡片选文体、再点配色点选主题，底部「已选」栏确认后点「使用该模板」即设为新建报告的默认版式并跳转新建表单；设置页模板下拉按文体分组。内置模板走与上传模板相同的准备管线，不调用模型，随包分发。
+
+## 英文报告
+
+在“材料与需求”把报告语言设为 English，或选用英文版式（选用内置版式时报告语言随之切换，仍可手动改回）。英文报告的正文、标题、图表与表头用英文，写作和审阅按英文规范（数字与大数换算、币种、日期、中文来源的转述与专名）；research_notes、缺口和核查记录仍用中文，方便在中文界面核对。篇幅按词计，预设按相近阅读量缩短。Word、HTML 和 PDF 的来源列表、目录与页码使用英文标签；来源名称保留原标题。封面上的时间范围和组织名按表单原文显示，英文报告请用英文填写。英文版式的章节标题为英文，章节职责说明仍为中文。
+
+中文专有文体（政府公文、上市公司年报、合同等）不提供英文版；中文模板用于英文报告时，章节标题由写作 Agent 按职责译成英文，Word 仍沿用该模板的版式。
 
 当前模板准备支持单节 DOCX 报告。遇到无法支持的版式会显示具体错误并保留原件，可调整主模板后重新导入；不会自动套用其他模板。当前不提供网页 Word 分页预览。
 

{briefloop-0.24.0 → briefloop-0.25.0}/docs//346/241/214/351/235/242/345/256/211/350/243/205/344/270/216/346/233/264/346/226/260.md

@@ -11,7 +11,7 @@ BriefLoop 桌面 App 与 WebUI 共用报告、材料、模型设置和本地工
 | macOS Apple Silicon | `BriefLoop-<版本>-arm64.dmg` | 打开 DMG，将 BriefLoop 拷入 Applications，运行已安装的 App。 |
 | Windows x64 | `BriefLoop-Setup-<版本>-x64.exe` | 运行安装程序，选择当前用户的安装目录。 |
 
-首批桌面包未做 macOS 签名或公证，也未使用 Windows 代码签名。系统可能显示未识别开发者或发布者；核对下载来源与发行页的 SHA-256 后，使用系统提供的单个应用许可入口。不要关闭整个系统的安全设置。Intel Mac、Windows ARM 和 Linux 桌面包未列入首批发行。
+本轮 0.25.0 macOS 包未做 Developer ID 签名或 Apple 公证；Windows 安装包保留发行页已有稳定版，未将 CI 测试当作 Windows 实机验收。既有 Windows 包也未使用代码签名。系统可能显示未识别开发者或发布者；核对下载来源与发行页的 SHA-256 后，使用系统提供的单个应用许可入口。不要关闭整个系统的安全设置。Intel Mac、Windows ARM 和 Linux 桌面包未列入首批发行。
 
 需要 WebUI 时，可按 [README](../README.md) 使用源码或 PyPI 包，无需安装 Electron App。PyPI 提供 Python 服务，不包含桌面安装包。
 
@@ -30,7 +30,7 @@ Electron 已包含运行桥接需要的 Node。无需另外为 BriefLoop 桌面
 
 ## 保存、Word 与退出
 
-在报告页编辑并保存正文，点击生成 Word；完成后通过原生“另存为”选择位置，再使用 Word 或 WPS 阅读。下载对应已保存的版本，界面上的未保存修改需要先保存。
+在报告页编辑并保存正文，点击 Word 导出，保存后直接下载；通过原生“另存为”选择位置，再使用 Word 或 WPS 阅读。下载对应已保存的版本，界面上的未保存修改需要先保存。
 
 关闭 App 会先请求保存。任务仍在运行时，可选择继续工作，或停止任务并退出。保存或停止失败时窗口保留，显示实际错误。桌面只管理本窗口启动的工作区服务；不会按程序名称批量关闭其他 Python、Node 或模型进程。
 

{briefloop-0.24.0 → briefloop-0.25.0}/docs//347/211/210/346/234/254/344/270/200/350/207/264/346/200/247/346/243/200/346/237/245.md

@@ -27,3 +27,9 @@ python scripts/check_versions.py --platform-report mac.json --platform-report wi
 只有源码和 CLI、Mac、Windows、PyPI 四项实际记录都匹配，`all_platforms_consistent` 才为 `true`。未提供的通道显示 `unverified`；`--require-all` 将未核验也视为失败。异版平台记录不能混入本次报告。不要修改记录中的版本字段来使检查通过。
 
 发布前不要求 PyPI 已有待发布版本。分批发布时允许先上传 Python 包，但发布后的完整核对必须如实报告桌面包滞后；源码版本一致不等于安装包已重新发布，也不代表用户本机已升级。
+
+## PyPI Trusted Publisher
+
+项目维护者在 PyPI 的 `briefloop` 项目发布设置中绑定 GitHub：owner `Stahl-G`，repository `briefloop`，workflow `publish-pypi.yml`，environment `pypi`。工作流通过 GitHub OIDC 获取短期发布身份，不需要把长期 PyPI Token 写入仓库或 Actions secrets。绑定需由拥有该 PyPI 项目权限的维护者完成。
+
+先公开已验收的 GitHub Release，再手动运行 **Publish verified release to PyPI**，填入标签、冻结源提交、wheel 和 sdist 的 SHA-256。工作流检查 release/tag/包元数据和哈希，仅上传已经验证的工件，不重新构建。若先前部分上传成功，仅在 PyPI 同名文件的哈希完全相同且未撤回时跳过该文件；不一致会中止。发布后仍需运行上面的 `--pypi --wheel` 实际渠道核对。

{briefloop-0.24.0 → briefloop-0.25.0}/docs//351/252/214/346/224/266/350/256/260/345/275/225.md

@@ -301,3 +301,55 @@ Scout 在内置引擎上是独立会话：冻结的任务包，联网只经 web_
 这是一组开放检索观察：约束相同，实际检索词、网页、来源覆盖和缓存状态不完全相同；Native 增量接纳与 OpenCode 文件交接仍不同。能确认本轮 Native 不再更慢，不能据单样本宣布稳定优于 OpenCode或完成整个报告闭环。本轮未运行 Analyst、独立 Reviewer、修订或导出，仍需解决 facts 与引文的语义对应及跨来源分歧遗漏。
 
 先前外部终端的一次 Native 请求返回 401、零 token；替换终端进程时已经开始的 OpenCode 部分被中断，单独标为无效记录，不混入本表。正式两臂结束后，实验进程及其 Native/OpenCode 子进程均已退出。私有原始结果为 `~/Developer/briefloop-eval/scout/aligned-pair-20260920-030842.jsonl`，归档含两端产物、来源、哈希、工具记录、用量元数据及抽查说明；不含密钥或隐藏推理正文，不进入 Git。
+
+### 2026-09-25：英文报告小型真实闭环
+
+冻结提交 `9812347f`（`claude/english-reports`）。新工作区；后端为内置引擎，模型 `opencode-go/deepseek-v4.1-flash`，研究档位 quick，DuckDuckGo 独占渠道，未开事实核查，版式为“英文通用报告·品牌绿”，篇幅 500 / 650 词。需求用中文填写，只把报告语言设为英文。题目：2026 年 8 月中国新能源汽车出口。
+
+同一配置先用 OpenCode 后端试跑，启动即失败，报错 `opencode serve 未就绪: Expecting value`（本机 opencode v2.0.14）。失败发生在本分支未改动的 OpenCode 宿主，未继续排查，记为环境问题。
+
+结果：
+
+- **成稿**：生成、评价和一次自动修订共约 21.5 分钟，登记来源 22 份。首稿评价为“建议修改”，列出两处引用挂错来源、一处无来源的盈利判断、一处 CPCA 口径量级未说明。修订稿评价为“达到要求”，剩余三处轻微问题，其中包括 CPCA 缩写首次出现未展开。
+- **写作与记录**：正文、标题、表格和图注均为英文。CAAM 全口径与 CPCA 乘用车口径分开写，“52.6万辆”写作 526,000 units。research_notes 和评价说明仍为中文。
+- **篇幅**：修订稿按词计 649，上限 650。
+- **Word 导出**：来源、目录、页码均为英文标签。导出文件中仍有中文的只有两处：来源原标题（按设计保留），以及封面上按原文打印的时间范围——本次验收填写的是中文“2026 年 8 月”。据此在英文模式下给时间范围输入框加了提示，并更新了文档。
+- **数值检查**：修订稿 16 条数值绑定中机械核对 4 条（百分比），全部一致；其余 12 条是车辆数量。本分支随后加入 units / vehicles / 辆 / 台及其量级，复核这份稿件时发现：正文用不带单位的表格数字引用“68,431 vehicles”时会被误判为“不一致”，而这一项会阻断正式交付。已改为：数值与绑定值相同、单位只在表头或上下文里时，记为“单位未机械核对”；真正的量级换算错误仍判为不一致。
+
+本轮没有运行独立 Reviewer 或正式交付，也没有开事实核查。私有产物保存在 `~/Developer/briefloop-eval/english-report-20260925-9812347f-native/`，不进入 Git。
+
+### 2026-09-26：英文报告合并前修复
+
+修复上传模板没有语言提示、或清除模板选择时把英文改回中文的问题。只有模板明确声明支持的语言时才同步报告语言；保留旧任务 `English` / `中文` 的归一化。普通 Word 与模板 Word 的 renderer 缓存标识均已更新，避免旧英文任务继续下载带中文读者标签的历史导出。
+
+回归检查实际保存了两条路径下完整且哈希有效的旧缓存 Word，再以同一稿件、来源、要求和模板重新导出。两条路径均建立新导出并显示 `Sources`，随后复用新缓存；原稿、保存要求及旧文件字节保持不变。原主干 36 个中文模板及其 spec 共 72 个文件逐一比对，字节完全不变，没有重新生成。
+
+Windows CI 上次失败来自启动验收将模板数写死为 36，新包实际包含 46 个模板。本次改为读取已安装包的内置模板清单，并同时检查名称全集和英文模板的语言提示，避免仅放宽数量而遗漏新模板。
+
+本地验证：英文与导出行为检查 **13 passed**；前端检查 **115 passed / 1 skipped**，跳过项为实际 Electron 剪贴板验收；前端构建、构建一致性和设计约束检查通过。Windows 原生检查须以本提交推送后的 CI 为准，Mac 上没有将跳过项记为通过。
+
+修复提交 `8a8d8081` 的 [Windows 安装包检查](https://github.com/Stahl-G/briefloop/actions/runs/36236929080/job/108390296622) 随后通过。再接入包含 #794 / #800 的主干 `90994ff3`，保留 OfficeCLI 取消处理与原子预览缓存改动；唯一冲突为生成的前端 bundle，按合并后的源码重建。组合检查（英文、Word 导出、OfficeCLI）**33 passed**；前端 **117 passed / 1 skipped**，构建一致性和设计约束仍通过。集成提交的全量 CI 单独执行，不沿用前一个提交的成功状态。
+
+本轮未调用真实模型、未重跑独立 Reviewer、事实核查或正式交付，也未修改旧验收原稿。上一节真实模型结果仍只对应 `9812347f`；其 OpenCode v2 启动失败是后端版本兼容问题的线索，不能仅凭该次报错断言网络或用户环境故障。
+
+
+## 2026-09-26：OpenCode 双版本与审阅模式集成
+
+OpenCode 2.0.14 不再使用 1.x 的健康、会话与模型目录协议。本次保留 v1 传输并增加独立 v2 适配，模型、variant、目录和权限需回读一致才发送任务；不存在的旧会话不自动重建。v2 的 Provider 配置仍在宿主内完成。实际供应方边界显示，v2 后续指令条目修改并不等价于 v1 每轮 system，因此已开始会话的系统约定变更须明确新建对话，不能静默替换或重发。
+
+按用户最新决定，审阅拆分为默认普通模式与显式严格模式。Codex、OpenCode 两代、BriefLoop Agent 可提供普通独立只读审阅；只有当前核查包专用工具已落实的 BriefLoop Agent 声明严格隔离。OpenCode v1 同样自动发现全局/祖先指令，旧文档对其完整上下文隔离的描述已纠正。两种模式沿用同一证据、版本、重大问题及交付门禁，新任务记录实际模式；历史缺字段仍显示未记录，不回写为严格。
+
+集成英文报告与 Excel 主干后，定向 Python 检查 236 通过，前端 125 通过、1 跳过，构建一致性与共享设计检查通过。检查包括模式/后端去重、严格不复用普通结果、旧会话恢复、定时触发时采用当前设置而入队后冻结、相同重大问题两模式均阻断、Codex 内部任务实际出站只读/禁网络参数，以及当前轮最终 JSON 与进度消息分开保存。没有把最终结构化回复接纳当成语义审阅通过。
+
+实际 macOS OpenCode 1.18.31/2.0.14 与自建本地合成供应方验证了认证、High 参数、读取/写入拒绝、中文消息与用量投影、空闲取消和自有服务清理；另有 v2 Harness→ChatStore 闭环。没有读取用户凭据，没有外部模型调用。这些不是完整报告、多子 Agent、长任务取消或 Windows 桌面验收。
+
+在独立、暂停任务派发的合成工作区通过 Chrome 实际验收：普通/严格保存及刷新保持、OpenCode 严格模式明确不可用且不自动换后端、手选 Native 严格模式、Codex 普通模式模型/档位文案与 High 实际保存。工作区任务数为 0，没有触发模型审阅。冷启动的模型目录跨快照异常另行修复并保留初次失败观察。
+
+目录修复后另跑 12 项协议检查通过（含首次不一致恢复与持续不一致拒绝）。真实 v2 冷启动公开目录顺序观测为 0 个 Provider → 494 个模型 → 4 个 Provider → 425 个模型；适配器完整重读一次后返回一致的 4 个 Provider / 425 个模型及公开档位，没有过滤丢模型或臆造 Provider，没有发送模型任务。
+
+## 2026-09-26：0.25.0 Issue 收口与发行准备
+
+- #730 补齐欧元/英镑、数量级股份、质量和电量单位；保留币种、功率/电量及百分比/百分点边界，不做汇率换算。SI 符号保留大小写，mWh/MWh、mW/MW、t/T 不会相互通过；非法或未知单位仍未检查。数值、覆盖、英文报告与软目标用时相关67项通过。
+- #729 修复旧排队/运行任务被最近30条历史挤出；只限制非活跃历史，任务去重与排序保留。相关派发、取消恢复、正文按需、stdin、PDF缓存及导出行为16项通过。Issue中的完整列表分页和100/1000报告基准仍待做，不标全部完成。
+- 前端125项通过、1项跳过；桌面70项通过、4项跳过；前端构建/共享设计及源码版本一致性检查通过。此处是源码候选验证，最终冻结提交、实际安装包、Mac原生运行和公开渠道校验随0.25.0发行记录保存，不将本段当作发行已经成功。
+- #758/#759/#762作为已写成的研究归档和交接备忘结案，后续阈值、对照与独立验证仍在#760/#761/#763。#728/#729/#731/#732/#734/#736/#757/#764仍保留未完成验收或实施项。Windows原生验收不可用，0.25.0 Windows安装包暂缓；Mac本轮没有Developer ID签名或Apple公证。

briefloop-0.25.0/frontend/app-updates.js

@@ -0,0 +1,90 @@
+// App updates: fixed desktop capabilities, with a read-only browser fallback.
+import {$} from './dom.js';
+export function appUpdatesUI({api,notice}){
+ let appUpdateState=null,softwareInfo=null,appUpdatePending=false,appUpdateLastAction='check';
+ function renderAppUpdates(value=appUpdateState){
+  const box=$('settings-view-updates');if(!box)return;
+  const desktop=typeof window.briefloopDesktop?.updateStatus==='function';
+  $('app-update-controls').hidden=false;
+  $('app-update-version').textContent=softwareInfo?`BriefLoop v${softwareInfo.version}${softwareInfo.build?` · 构建 ${softwareInfo.build}`:''}${desktop?` · 桌面 App v${value?.currentAppVersion||'读取中'}`:''}`:'正在读取实际运行版本…';
+  const installations={desktop:'桌面管理的后端 · App 与 CLI 共用',source:'开发源码',pip:'Python 包安装',pipx:'pipx 安装',uv:'uv 工具安装'};
+  $('app-update-installation').textContent=softwareInfo?installations[softwareInfo.installation]||'独立安装':'';
+  $('app-update-command').hidden=!softwareInfo?.update_command;
+  $('app-update-command').textContent=softwareInfo?.update_command||'';
+  $('app-update-source').textContent=value?.source==='local-test'?'本地测试更新源 · 仅验证流程，不代表官方发布':desktop?'官方稳定来源：Stahl-G/briefloop · GitHub Releases':'Python 包稳定来源：PyPI · briefloop';
+  const reinstall=value?.source==='local-test'&&value?.reinstall===true;
+  $('app-update-guidance').textContent=!desktop?(softwareInfo?.guidance||'正在读取安装来源…'):value?.installMode==='zip'?'优先增量下载 ZIP 更新包并校验完整文件。保存并退出后打开 Finder；将 BriefLoop 拖到 Applications 替换，再重新启动。':value?.installMode==='dmg'?`下载后会先保存编辑并处理忙任务，再退出 App、打开 DMG；请在 Finder 中${reinstall?'重新安装当前版本':'手动安装新版本'}。`:'下载后会先保存编辑并处理忙任务，再退出 App 并交给原生安装器更新。';
+  const errorOperation=value?.error?.operation||(value?.error?.code==='open_failed'?'install':appUpdateLastAction);
+  const errorLabel={check:'更新检查失败（当前安装不受影响）',download:'更新包下载未完成',install:'更新安装未完成'}[errorOperation]||'更新检查失败（当前安装不受影响）';
+  const labels={idle:'尚未检查更新',checking:'正在检查更新…',available:'发现可用更新',current:'当前 App 无需更新',downloading:'正在下载更新…',downloaded:'下载完成，等待安装',error:errorLabel};
+  const reinstallLabel=`重新安装当前 App v${value?.currentAppVersion||''}`;
+  $('app-update-status').textContent=desktop?(reinstall&&value?.state==='available'?reinstallLabel:(labels[value?.state]||'正在读取 App 版本…')+(value?.state==='error'&&errorOperation==='check'?'':reinstall?` · ${reinstallLabel}`:value?.releaseVersion?` · v${value.releaseVersion}`:'')):({idle:'尚未检查更新',checking:'正在检查更新…',available:`发现可用后端版本 v${value?.releaseVersion||''}`,current:'当前后端已是 PyPI 最新稳定版',ahead:`当前后端高于 PyPI 已发布版本 v${value?.releaseVersion||''}`,error:'版本检查未完成'}[value?.state||'idle']||'尚未检查更新');
+  $('app-update-download').textContent=reinstall?'下载当前版本安装包':'下载更新';
+  const busy=appUpdatePending||['checking','downloading'].includes(value?.state);
+  $('app-update-check').disabled=busy;
+  $('app-update-download').hidden=!desktop||value?.state!=='available';$('app-update-download').disabled=busy;
+  $('app-update-install').hidden=!desktop||value?.state!=='downloaded';$('app-update-install').disabled=busy;
+  $('app-update-install').textContent=value?.installMode==='zip'?'保存并打开更新文件夹':value?.installMode==='dmg'?'保存并打开 DMG':'保存并安装更新';
+  $('app-update-retry').hidden=value?.state!=='error'||!value?.retryable;$('app-update-retry').disabled=busy;
+  $('app-update-error').hidden=!value?.error;$('app-update-error').textContent=value?.error?.message||'';
+  const progress=value?.progress;
+  $('app-update-progress-box').hidden=!progress;
+  $('app-update-progress').value=progress?.percent||0;
+  $('app-update-progress-text').textContent=progress?`${Math.round(progress.percent||0)}% · ${(Math.max(0,progress.transferred||0)/1048576).toFixed(1)} / ${(Math.max(0,progress.total||0)/1048576).toFixed(1)} MiB`:'';
+  if(progress?.mode==='differential')$('app-update-progress-text').textContent+=` · 增量下载，复用 ${(Math.max(0,progress.reused||0)/1048576).toFixed(1)} MiB`;
+  else if(progress?.mode==='full')$('app-update-progress-text').textContent+=' · '+({
+   no_baseline:'无有效基准缓存，完整下载并建立缓存',
+   little_reuse:'本次可复用内容较少，完整下载',
+   range_unavailable:'下载服务不支持分段传输，完整下载',
+   range_size:'分段响应不完整，重新完整下载',
+   delta_hash:'增量重建校验失败，重新完整下载',
+   differential_unavailable:'增量不可用，已回退完整下载',
+   blockmap_unavailable:'此版本无可用增量信息，完整下载'
+  }[progress.fallback]||'完整下载');
+  $('app-update-notes-box').hidden=!value?.notes;$('app-update-notes').textContent=value?.notes||'';
+ }
+ async function refreshAppUpdates(){
+  renderAppUpdates();
+  try{softwareInfo=await api('software-version');
+  if(typeof window.briefloopDesktop?.updateStatus==='function')appUpdateState=await window.briefloopDesktop.updateStatus();
+  renderAppUpdates()}
+  catch{notice('无法读取 App 更新状态，请重新打开设置。',true)}
+ }
+ async function runAppUpdate(command){
+  if(appUpdatePending)return;
+  const desktop=window.briefloopDesktop;
+  if(typeof desktop?.updateStatus!=='function'){
+   if(command!=='check')return;
+   appUpdatePending=true;appUpdateState={state:'checking'};renderAppUpdates();
+   try{appUpdateState=await api('software-update-check',{});softwareInfo=appUpdateState}
+   catch(error){appUpdateState={state:'error',retryable:true,error:{message:error.message||'版本检查未完成'}}}
+   finally{appUpdatePending=false;renderAppUpdates()}
+   return;
+  }
+  appUpdatePending=true;appUpdateLastAction=command;renderAppUpdates();
+  try{
+   if(command==='install'){
+    const result=await desktop.installUpdate();
+    if(result?.cancelled)notice('已保留当前工作区，更新包仍可稍后安装。');
+    // Successful installation closes this renderer. A cancelled gate keeps it live.
+    if(result?.cancelled)appUpdateState=await desktop.updateStatus();
+   }else appUpdateState=await (command==='download'?desktop.downloadUpdate():desktop.checkForUpdates());
+  }catch(error){
+   notice(error.message||'更新操作未完成，请重试。',true);
+   try{appUpdateState=await desktop.updateStatus()}catch{}
+  }finally{appUpdatePending=false;renderAppUpdates()}
+ }
+ function init(){
+  if($('settings-view-updates')){
+   $('app-update-check').onclick=()=>runAppUpdate('check');
+   $('app-update-download').onclick=()=>runAppUpdate('download');
+   $('app-update-install').onclick=()=>runAppUpdate('install');
+   // A temporary DMG open error can retry the saved asset through the same gate.
+   $('app-update-retry').onclick=()=>runAppUpdate(appUpdateState?.error?.code==='open_failed'?'install':(appUpdateState?.error?.operation||appUpdateLastAction)==='install'?'download':appUpdateState?.error?.operation||appUpdateLastAction);
+   window.briefloopDesktop?.onUpdateStatus?.(value=>{appUpdateState=value;renderAppUpdates()});
+   renderAppUpdates();
+  }
+ }
+ return {init,renderAppUpdates,refreshAppUpdates,runAppUpdate};
+}
+// End App updates.