briefloop 0.31.0__tar.gz → 0.31.3__tar.gz

{briefloop-0.31.0 → briefloop-0.31.3}/CHANGELOG.md

@@ -1,5 +1,62 @@
 # 变更记录
 
+## 0.31.3
+
+- 修复导出后重开滚到页尾时右栏被顶栏遮挡：任务记录随正文列共同延长右栏的滚动边界；大纲、无稿件和窄屏保留原位置。
+- 新报告默认自主直写，研究与写稿由同一作者完成；普通入口收起流程选择，标准流程保留在高级选项。选定连接器资料时自动使用已有授权的标准流程。
+- 修复所选连接器资源未进入作者材料的问题：按本轮授权读取并保存来源回执，复用预算和已读材料。不支持的参数工具组合在任务开始前明确拒绝。
+- 修复直写 WikiSkill 未送达：作者实际应用候选与已启用方法，比较及采用前核验送达。保存保留正文粗体和作者日期记录。
+- 简化面向审阅者的声明与重复免责，把核查状态写成有依据的事实。
+- 修复报告向下滚动时右栏标签被顶栏遮挡，操作栏换行后自动避让，右栏内容独立滚动。
+- 内置 BriefLoop Agent 升级至 Pi 1.1.0，保留工具隔离、会话恢复和取消。
+- Windows 初始窗口在欢迎页加载完成后显示，修复首次绘制延迟；跨平台发行使用同一冻结后端。
+
+
+## 0.31.3rc1
+
+- 修复已导出报告重开后滚到底部时右栏再次被遮挡：桌面编辑视图把尾部任务记录纳入正文列，延长右栏所属行；大纲、无稿件和窄屏保留原任务记录位置。
+- 基于 0.31.2 冻结候选继续验收，不覆盖其原工件。
+
+## 0.31.2（未发布，验收中止）
+
+- 新报告默认自主直写，研究与写稿由同一作者完成；普通入口收起流程选择，标准流程保留在高级选项。选定连接器资料时自动使用已有授权的标准流程。
+- 修复所选连接器资源未进入作者材料的问题：按本轮授权读取并保存来源回执，复用预算和已读材料。不支持的参数工具组合在任务开始前明确拒绝。
+- 修复直写 WikiSkill 未送达：作者实际应用候选与已启用方法，比较及采用前核验送达。保存保留正文粗体和作者日期记录。
+- 简化面向审阅者的声明与重复免责，把核查状态写成有依据的事实。
+- 修复报告向下滚动时右栏标签被顶栏遮挡，操作栏换行后自动避让，右栏内容独立滚动。
+- 内置 BriefLoop Agent 升级至 Pi 1.1.0，保留工具隔离、会话恢复和取消。
+- Windows 初始窗口在欢迎页加载完成后显示，修复首次绘制延迟；跨平台发行使用同一冻结后端。
+
+## 0.31.2rc5
+
+- 修复报告滚动时右栏标签被顶栏遮挡：按实际顶栏和可用窗口高度定位，右栏内容独立滚动，键盘定位不再带走标签。
+- 发行验收候选，包含0.31.1的自主直写默认、WikiSkill送达、日期/粗体保存和Pi1.1改动。
+- Windows预发行验收同时核对PE基号与包内实际版本，保留校验失败输出。
+- Windows初始窗口在欢迎页加载完成后显示，减少首次绘制等待；原生界面验收仍待完成。
+- 在作者输入编译前按冻结授权读取所选资源，复用读取回执和预算；离线Codex不支持的参数工具组合在任务开始前明确拒绝。
+- 已选择连接器资料而未指定生成方式时，自动使用已支持连接器授权的标准流程。显式直写与实时连接器组合在开始前明确拒绝；不支持该授权提交的聊天工具也不再静默忽略选择。
+- 可显式启用桌面启动时序日志，记录页面加载、环境就绪、IPC状态与首次绘制阶段，用于Windows普通窗口启动延迟的原生排查；不记录材料、路径或凭据。
+
+
+## 0.31.2rc4
+
+- 发行验收候选，包含0.31.1的自主直写默认、WikiSkill送达、日期/粗体保存和Pi1.1改动。
+- Windows预发行验收同时核对PE基号与包内实际版本，保留校验失败输出。
+- Windows初始窗口在欢迎页加载完成后显示，减少首次绘制等待；原生界面验收仍待完成。
+- 在作者输入编译前按冻结授权读取所选资源，复用读取回执和预算；离线Codex不支持的参数工具组合在任务开始前明确拒绝。
+- 已选择连接器资料而未指定生成方式时，自动使用已支持连接器授权的标准流程。显式直写与实时连接器组合在开始前明确拒绝；不支持该授权提交的聊天工具也不再静默忽略选择。
+- 可显式启用桌面启动时序日志，记录页面加载、环境就绪、IPC状态与首次绘制阶段，用于Windows普通窗口启动延迟的原生排查；不记录材料、路径或凭据。
+
+## 0.31.1
+
+- 新报告默认自主直写，由同一作者完成研究与成稿，保存后继续补充依据、评价和修订；普通入口收起生成方式选择，标准流程保留在高级选项。未指定方式的企业内部报告、独立风格参考、行业季报和外部 Pi 沿用既有标准流程，显式选择及历史任务的执行方式不变。
+
+- 报告写作把核查状态写成有依据的事实，减少面向审阅者的声明、过程叙述和重复免责；保留影响判断的真实缺口与限制（#920）。
+- 修复直写模式未把已选 WikiSkill 送达作者的问题；学习比较与采用前核对宿主保存的实际输入，缺少送达证据时保留候选并拒绝采用。比较使用同一冻结作者代码。
+- 直写保存保留正文粗体与作者提供的日期依据；证据补充沿用已保存日期信息，来源抓取日期由来源记录提供，未提供的字段不补造。
+- 内置 BriefLoop Agent 升级至 Pi 1.1.0，保留角色工具隔离、会话恢复、取消、压缩与图片处理，长子任务的隐式缓存预热保持关闭。
+- 修复宿主直写检索入口未指定受控 provider 的示例；沿用冻结首选与缺口补查策略，显式选择已允许渠道，不自动切换搜索服务。
+
 ## 0.31.0
 
 - 修复 OpenCode v2 默认推理档被错误拒绝，显式模型与其他推理档仍按冻结配置校验。

{briefloop-0.31.0 → briefloop-0.31.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.31.0
+Version: 0.31.3
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT
@@ -177,11 +177,13 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 - **对话工作台**：发消息、上传材料、选择模型、排队或中途补充要求，查看公开工具和子 Agent 活动。
 - **工作区管理**：打开已有目录或新建空工作区，各自保存对话、来源、稿件、评分与 Wiki。
 - **对话整理**：归档、移到回收站、恢复，或批量归档已结束对话；报告、来源与 Wiki 不跟随对话清理删除。
-- **从公开资料写简报**：不强制上传。开启联网后，由 Scout 查找并筛选资料；Analyst 写稿，Evaluator 独立评分。
+- **从公开资料写简报**：不强制上传。通用新报告默认由同一作者研究并成稿，保存后补充依据、独立评价和修订。
 - **从 MCP 取得报告材料**：在设置中连接 HTTP 或本机 stdio 服务，再在新报告中明确选择资源、工具和预算。实际读取结果保存为来源与回执，供正文引用和离线核查。
 - **直接改稿与学习**：编辑正文或留下反馈；Wiki Maintainer 整理经验，Skill Proposer 提出技能，Evaluator 比较实际产物后决定是否采用。
 - **明确的预算与篇幅**：整次报告共享检索额度；正文目标字数和上限可直接修改。
 
+未指定生成方式时，实时连接器资料、企业内部报告、独立风格参考、行业季报和外部 Pi 沿用既有标准流程，保留企业维护、数据工具及宿主兼容能力。高级选项中的显式选择与历史任务保持原行为。
+
 ## 第一次使用
 
 1. 在“材料与需求”填写目的、读者、时间范围和字数要求。可上传材料、开启联网，或在“本轮连接器材料”中明确选择 MCP 材料。
@@ -194,7 +196,7 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 
 在“设置 → 数据连接器”保存连接配置，测试目录并启用；保存配置本身不会连接 HTTP 或启动本机程序。HTTP 可选择 Bearer 令牌或服务要求的原样 Authorization 值；stdio 使用已安装程序的绝对路径和逐项参数。凭据保存在工作区的独立受保护文件中，页面只显示是否已保存及认证类型。
 
-在新报告的“本轮连接器材料”勾选具体资源或工具，并确认调用次数、材料总量上限。启用连接器不会自动授权每份报告，公开搜索的联网开关与此选择分开。任务启动前冻结选择与预算；未选资源和工具不能通过该任务的材料接口读取。工具声明“只读”不代表已经验证无副作用，请按其实际用途选择。
+在新报告的“本轮连接器材料”勾选具体资源或工具，并确认调用次数、材料总量上限。启用连接器不会自动授权每份报告，公开搜索的联网开关与此选择分开。任务启动前冻结选择与预算；未选资源和工具不能通过该任务的材料接口读取。工具声明“只读”不代表已经验证无副作用，请按其实际用途选择。明确选定的资源会在写作前按冻结授权读取并保存；参数工具仍由作者按需调用。离线 Codex 暂不支持参数工具，可选择资源或先导入工具结果。
 
 已选择、已接纳为来源、已被正文引用是三个不同结果。接纳会保存读取回执、原件哈希和来源 ID，材料仍须核查；Reviewer 使用已保存的核查包，不携实时连接器访问凭据。MCP 请求参数会发送给所选服务，取得的材料也可能进入所选模型的上下文。停止任务会撤销实时访问，保留已经保存的来源；未知结果不会自动重发，已撤销的任务需重新明确选择材料。
 

{briefloop-0.31.0 → briefloop-0.31.3}/README.md

@@ -137,11 +137,13 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 - **对话工作台**：发消息、上传材料、选择模型、排队或中途补充要求，查看公开工具和子 Agent 活动。
 - **工作区管理**：打开已有目录或新建空工作区，各自保存对话、来源、稿件、评分与 Wiki。
 - **对话整理**：归档、移到回收站、恢复，或批量归档已结束对话；报告、来源与 Wiki 不跟随对话清理删除。
-- **从公开资料写简报**：不强制上传。开启联网后，由 Scout 查找并筛选资料；Analyst 写稿，Evaluator 独立评分。
+- **从公开资料写简报**：不强制上传。通用新报告默认由同一作者研究并成稿，保存后补充依据、独立评价和修订。
 - **从 MCP 取得报告材料**：在设置中连接 HTTP 或本机 stdio 服务，再在新报告中明确选择资源、工具和预算。实际读取结果保存为来源与回执，供正文引用和离线核查。
 - **直接改稿与学习**：编辑正文或留下反馈；Wiki Maintainer 整理经验，Skill Proposer 提出技能，Evaluator 比较实际产物后决定是否采用。
 - **明确的预算与篇幅**：整次报告共享检索额度；正文目标字数和上限可直接修改。
 
+未指定生成方式时，实时连接器资料、企业内部报告、独立风格参考、行业季报和外部 Pi 沿用既有标准流程，保留企业维护、数据工具及宿主兼容能力。高级选项中的显式选择与历史任务保持原行为。
+
 ## 第一次使用
 
 1. 在“材料与需求”填写目的、读者、时间范围和字数要求。可上传材料、开启联网，或在“本轮连接器材料”中明确选择 MCP 材料。
@@ -154,7 +156,7 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 
 在“设置 → 数据连接器”保存连接配置，测试目录并启用；保存配置本身不会连接 HTTP 或启动本机程序。HTTP 可选择 Bearer 令牌或服务要求的原样 Authorization 值；stdio 使用已安装程序的绝对路径和逐项参数。凭据保存在工作区的独立受保护文件中，页面只显示是否已保存及认证类型。
 
-在新报告的“本轮连接器材料”勾选具体资源或工具，并确认调用次数、材料总量上限。启用连接器不会自动授权每份报告，公开搜索的联网开关与此选择分开。任务启动前冻结选择与预算；未选资源和工具不能通过该任务的材料接口读取。工具声明“只读”不代表已经验证无副作用，请按其实际用途选择。
+在新报告的“本轮连接器材料”勾选具体资源或工具，并确认调用次数、材料总量上限。启用连接器不会自动授权每份报告，公开搜索的联网开关与此选择分开。任务启动前冻结选择与预算；未选资源和工具不能通过该任务的材料接口读取。工具声明“只读”不代表已经验证无副作用，请按其实际用途选择。明确选定的资源会在写作前按冻结授权读取并保存；参数工具仍由作者按需调用。离线 Codex 暂不支持参数工具，可选择资源或先导入工具结果。
 
 已选择、已接纳为来源、已被正文引用是三个不同结果。接纳会保存读取回执、原件哈希和来源 ID，材料仍须核查；Reviewer 使用已保存的核查包，不携实时连接器访问凭据。MCP 请求参数会发送给所选服务，取得的材料也可能进入所选模型的上下文。停止任务会撤销实时访问，保留已经保存的来源；未知结果不会自动重发，已撤销的任务需重新明确选择材料。
 

briefloop-0.31.3/VERSION

@@ -0,0 +1 @@
+0.31.3

{briefloop-0.31.0 → briefloop-0.31.3}/desktop/electron/package-lock.json

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

{briefloop-0.31.0 → briefloop-0.31.3}/desktop/electron/package.json

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

{briefloop-0.31.0 → briefloop-0.31.3}/docs/direct-mode.md

@@ -1,4 +1,4 @@
-# 直写模式（试用）
+# 自主直写（默认）
 
 `completion_mode=direct`：一个作者在同一上下文中检索、阅读并写完整份报告；保存后再做原文定位、确定性检查、独立评价/审阅和最多一次自动修订。
 
@@ -16,10 +16,21 @@
 ## 做了什么
 
 - 写作回合带计量工具：`web-search`、`add-url`、`read-source`，共享本任务预算；来源经 `add-url` 自动登记，正文用 `[@source_id]` 引用。
-- 提示只给任务、完成标准思路、引用和日期规则、篇幅空间，不加载完整研究协议、Scout 合同或写前对照。
+- 作者只负责研究判断、可读正文、重要日期与来源标记。抓取时间、引用定位和结构化时间记录由保存后的依据补全承担；作者已生成的时间文件也会接收入库。
 - 保存后复用快速稿的后台链路：只对作者实际引用的来源做原文定位，随后评价；与快速稿不同，保留独立审阅和一次自动修订。
 - 未登记的引用标记被移除并写入研究记录，不让虚构来源进入正文。
 
+## WikiSkill 与试写
+
+直写作者同时承担 Scout 的阅读和 Analyst 的写作，接收这两类角色绑定的方法内容一次，不加载整个 Wiki。
+显式 `skill_override` 优先于本报告已启用技能；值为 `null` 的基线不加载技能。
+比较前核对实际完成的作者消息与宿主的输出回执，确认候选方法已经送达；没有回执、方法未送达或角色不适用时保留原件并停止比较。
+恢复采用前再检查实际试写，旧的无送达证据结果不能被当作学习有效。
+送达只证明模型收到了输入，质量和是否落实仍由成对比较判断。
+
+学习试写仍装配证据和时间，但不排队做普通单稿评价或自动修订，唯一语义评价是既有成对比较。
+Markdown 中文粗体标签（如 `**本周发生：**10月7日`）以富文档粗体保存，代码示例中的星号保留。
+
 ## 覆盖记录
 
 作者在正文后附一个 `briefloop-coverage` 代码块，逐题写明状态（已回答/部分/查过未找到/读取失败/未检查）、所用来源和查过的查询词或网址。系统把代码块从正文移除，再对照本任务的计量检索记录和来源表核对：对上的标为检索或抓取回执，对不上的标为“自述”；作者漏答的题补成“未检查”。这只说明查了什么，不是事实核验。任务卡在没有目标契约时显示这份记录。
@@ -30,5 +41,6 @@
 
 ## 边界
 
-- 支持 Codex、OpenCode、bridge 和内置引擎（作者回合挂 `web-search`/`add-url`/`read-source` 等计量工具，使用直写专用系统提示）；pi 宿主暂不支持。
-- 不派 Scout。现有标准、快速流程不变，可随时选回。是否成为默认，需在冻结材料上与纯 agent 基线及标准流程再比较，并验证较小模型。
+- 支持 Codex、OpenCode、bridge 和内置引擎（作者回合挂 `web-search`/`add-url`/`read-source` 等计量工具，使用直写专用系统提示）；外部 pi 宿主暂不支持直写，其未指定方式的新报告沿用标准流程；内置 BriefLoop Agent 仍默认直写。
+- 新报告默认自主直写，不派 Scout；普通入口只需填写任务与来源。标准、快速流程保留在高级选项，显式 API/CLI 请求继续尊重。旧任务及旧定时配置缺省执行方式仍按标准流程恢复。
+- 新请求未指定生成方式时，实时连接器资料、企业内部报告、独立风格参考与行业季报沿用既有标准流程，保留连接器授权、企业维护、风格读取及状态变化表能力；显式直写带实时连接器或风格参考时明确拒绝。现有实验支持本次默认选择，尚未验证所有模型、主题和报告类型。

briefloop-0.31.3/docs/release-0.31.1.md

@@ -0,0 +1,25 @@
+# BriefLoop 0.31.1
+
+本页说明本轮变更；渠道发布与安装状态以正式发行清单为准。
+
+## 主要变化
+
+**新报告默认自主直写。** 同一作者在同一上下文中完成研究与成稿，保存后继续补充依据、评价和修订。普通入口收起生成方式选择；标准流程在高级选项中提供，未指定生成方式的企业内部报告、独立风格参考、行业季报和外部 Pi 自动沿用其既有标准流程。
+
+**少一些声明，多写清事实。** 报告作者把核查状态写成有依据的事实，减少面向审阅者的声明、过程叙述和重复免责。影响判断的证据缺口、范围与条件仍保留。这项写作改动来自 #920。
+
+**直写收到实际选用的经验。** 修复直写模式未把已选 WikiSkill 送达作者的问题。任务保存选用方法与宿主实际输入的绑定；学习比较和采用前核对送达证据，缺少证据时保留候选并拒绝采用。比较使用同一冻结作者代码。送达核对不代表作者已遵循方法或报告质量已经提升。见 [直写模式](direct-mode.md)。
+
+**保存正文与日期依据。** 直写稿件保存保留正文粗体与作者提供的日期依据。证据补充沿用已保存日期信息，来源抓取日期从来源记录取得；缺少的字段保持空缺。
+
+**内置引擎更新。** BriefLoop Agent 使用 Pi 1.1.0，保留既有角色工具隔离、会话恢复、取消、上下文压缩和图片处理。长子任务期间的隐式缓存预热保持关闭。本轮升级没有开启 Pi 的 MCP、codemode 或个人技能加载。
+
+**检索入口沿用冻结策略。** 修复宿主直写命令示例没有指定受控搜索 provider 的问题。作者按冻结首选与缺口补查规则检索，受控请求明确选择已允许渠道，共用本轮预算；入口不会自动改选其他搜索服务。
+
+## 升级说明
+
+本版延续现有工作区、稿件与会话数据，新报告默认自主直写；显式生成方式、历史任务和旧定时配置缺省标准流程的语义保持原样。更新前结束正在执行的任务，再按正式渠道更新；新任务使用本版写作和检索入口。已有稿件与冻结记录保持其原有版本和输入。
+
+Mac、Windows、Python/CLI 从同一冻结提交复用一份后端 wheel。各平台实际启动、保存、导出和升级核验分别记录，正式发布状态以发行清单为准。
+
+详细变化见 [变更记录](../CHANGELOG.md)。

{briefloop-0.31.0 → briefloop-0.31.3}/frontend/app.js

@@ -20,6 +20,10 @@ import {evidenceReviewDialogsUI} from './evidence-review-dialogs.js';
 import {renderVersionDiff} from './version-diff.js';
 import {DOMSerializer} from '@tiptap/pm/model';
 import {beginPanel,updatePanel} from './report-panels.js';
+import {createReportStickyLayout} from './report-sticky-layout.js';
+createReportStickyLayout({report:$('report'),header:document.querySelector('.report-topbar'),scroller:document.querySelector('main'),
+ panel:$('report-panel'),grid:$('report-grid'),column:document.querySelector('.report-main-column'),
+ documentArea:$('document-area'),jobs:$('jobs')});
 import {jobExecutionLabel,jobResumeLabel,createLocalFileProgress,isLocalFileJob} from './job-presentation.js';
 import {taskProgressCard} from './task-progress.js';
 import {researchProcessHTML,processDisclosureKey} from './research-process.js';
@@ -661,7 +665,7 @@ async function previewReportTime(){
 }
 for(const key of ['period','period_start','period_end','report_timezone'])$('requirements').elements[key].addEventListener('change',previewReportTime);
 $('requirements').onsubmit=e=>{e.preventDefault();
-  action(async()=>{const f=new FormData(e.target),req=Object.fromEntries(f.entries());if(!['fast','fast_web'].includes(req.completion_mode)&&req.writing_mode==='internal_report'&&state.settings.company_context_enabled==null){$('company-choice-dialog').showModal();return}req.allow_web=f.has('allow_web');req.fact_check=f.has('fact_check');req.target_words=Number(req.target_words);req.max_words=Number(req.max_words);Object.assign(req,lengthControls.read(),quickReport.read());req.research_budget=readResearchBudget();reportFormDefaults.prepare(req);reportMarket.prepare(req);req.search_policy=readSearchPolicy();Object.assign(req,readWorkflowChoice());req.reference_source_ids=[...referenceSelected];req.template_id=req.template_id||null;req.sections=readTemplateSections();req.key_questions=(req.key_questions_text||'').split('\n').map(x=>x.trim()).filter(Boolean);delete req.key_questions_text;req.manual_sections=(req.manual_sections_text||'').split('\n').map(x=>x.trim()).filter(Boolean);for(const title of req.manual_sections){const found=req.sections.find(s=>s.title===title);if(found){found.mode='manual';found.placeholder='待填充'}}delete req.manual_sections_text;preserveWritingPreferences(req,state.requirements,writingPreferencesOverride);if(!req.reader_id)delete req.reader_id;req.raw_input=req.objective;delete req.runtime_model;delete req.runtime_effort;await saveModel();if(current)await savedVersion();const connector_selection=reportMcpSelection.selection();const job=await api('generate',{...(connector_selection?{connector_selection}:{}),requirements:req,session_id:chat.id||undefined,source_ids:[...selected].filter(id=>!req.reference_source_ids.includes(id))});nextReport.clear();showPendingReport(parse(job.payload).run_id);page('report');notice('任务已排队，后台会生成简报')})};
+  action(async()=>{const f=new FormData(e.target),req=Object.fromEntries(f.entries());if((!req.completion_mode||req.completion_mode==='standard')&&req.writing_mode==='internal_report'&&state.settings.company_context_enabled==null){$('company-choice-dialog').showModal();return}req.allow_web=f.has('allow_web');req.fact_check=f.has('fact_check');req.target_words=Number(req.target_words);req.max_words=Number(req.max_words);Object.assign(req,lengthControls.read(),quickReport.read());req.research_budget=readResearchBudget();reportFormDefaults.prepare(req);reportMarket.prepare(req);req.search_policy=readSearchPolicy();Object.assign(req,readWorkflowChoice());req.reference_source_ids=[...referenceSelected];req.template_id=req.template_id||null;req.sections=readTemplateSections();req.key_questions=(req.key_questions_text||'').split('\n').map(x=>x.trim()).filter(Boolean);delete req.key_questions_text;req.manual_sections=(req.manual_sections_text||'').split('\n').map(x=>x.trim()).filter(Boolean);for(const title of req.manual_sections){const found=req.sections.find(s=>s.title===title);if(found){found.mode='manual';found.placeholder='待填充'}}delete req.manual_sections_text;preserveWritingPreferences(req,state.requirements,writingPreferencesOverride);if(!req.reader_id)delete req.reader_id;req.raw_input=req.objective;delete req.runtime_model;delete req.runtime_effort;await saveModel();if(current)await savedVersion();const connector_selection=reportMcpSelection.selection();const job=await api('generate',{...(connector_selection?{connector_selection}:{}),requirements:req,session_id:chat.id||undefined,source_ids:[...selected].filter(id=>!req.reference_source_ids.includes(id))});nextReport.clear();showPendingReport(parse(job.payload).run_id);page('report');notice('任务已排队，后台会生成简报')})};
 $('upload').onchange=e=>action(async()=>{preflightSources(e.target.files,getUploadLimits());for(const f of e.target.files){const s=await uploadSource(f);if(s.status==='ready')selected.add(s.id)}e.target.value=''},'来源已保存');
 $('add-url').onclick=()=>action(async()=>{const s=await api('source-url',{url:$('source-url').value});if(s.status==='ready')selected.add(s.id);$('source-url').value='';notice(s.status==='ready'?'网页已读取':'来源已保存，但读取失败：'+s.error,s.status!=='ready')});
 $('rescore').onclick=()=>action(async()=>{await savedVersion();await api('assess',{version_id:current.id,session_id:chat.id||undefined})},'已提交评分');

{briefloop-0.31.0 → briefloop-0.31.3}/frontend/composer-options.js

@@ -4,7 +4,7 @@ export function createComposerOptions({$,getChat,getState,availability,rememberD
  let panel=null,root=null;
  function read(){
   const saved=getChat().reportOptions||{},state=getState();
-  return {completion_mode:saved.completion_mode||'standard',research_tier:saved.research_tier||state?.settings?.research_tier||'standard',research_strategy:saved.research_strategy||'guided',fact_check:saved.fact_check??!!state?.settings?.fact_checker};
+  return {completion_mode:saved.completion_mode||'',research_tier:saved.research_tier||state?.settings?.research_tier||'standard',research_strategy:saved.research_strategy||'guided',fact_check:saved.fact_check??!!state?.settings?.fact_checker};
  }
  function sync(){
   if(!root||!getState()?.settings)return;
@@ -12,16 +12,16 @@ export function createComposerOptions({$,getChat,getState,availability,rememberD
   root.querySelectorAll('[data-report-source]').forEach(button=>button.setAttribute('aria-pressed',String((button.dataset.reportSource==='web')===web.checked)));
   root.querySelector('[data-completion]').value=choice.completion_mode;
   root.querySelector('[data-research-tier]').value=choice.research_tier;
-  const strategy=root.querySelector('[data-research-strategy]');strategy.value=choice.research_strategy;strategy.disabled=['fast','direct'].includes(choice.completion_mode);
+  const strategy=root.querySelector('[data-research-strategy]');strategy.value=choice.research_strategy;strategy.disabled=!choice.completion_mode||['fast','direct'].includes(choice.completion_mode);
   const fact=root.querySelector('[data-report-fact]');fact.checked=choice.fact_check&&allowed.enabled;fact.disabled=!allowed.enabled;
   const note=root.querySelector('[data-fact-link]');note.hidden=allowed.enabled;note.textContent=allowed.target==='standard'?'标准模式可开启':allowed.target==='review'?'选择审阅连接':allowed.target==='network'?'配置联网核查':'查看核查设置';note.title=allowed.reason||'';
-  root.querySelector('[data-report-mode-note]').textContent=choice.completion_mode==='fast'?'先保存可编辑初稿，再补充依据与评价。':choice.completion_mode==='direct'?'一个作者在同一上下文中检索和写作，保存后再定位依据、独立评价和修订。':'按研究、写作和检查流程完成报告。';
+  root.querySelector('[data-report-mode-note]').textContent=choice.completion_mode==='fast'?'先保存可编辑初稿，再补充依据与评价。':!choice.completion_mode||choice.completion_mode==='direct'?'一个作者在同一上下文中检索和写作，保存后再定位依据、独立评价和修订。':'按研究、写作和检查流程完成报告。';
  }
  function instruction(){
   const choice=read();choice.fact_check=choice.completion_mode!=='fast'&&choice.fact_check&&availability().enabled;
   // Fast web is a separate product mode; existing material mode never silently searches.
   if(choice.completion_mode==='fast'&&$('chat-allow-web').checked)choice.completion_mode='fast_web';
-  return `\n\n本轮报告选项（仅当用户要求生成报告时使用，不因此自动生成）：completion_mode=${choice.completion_mode}，research_tier=${choice.research_tier}，research_strategy=${choice.research_strategy}，fact_check=${choice.fact_check}。生成时传入 requirements；用户正文另有明确选择则按正文。`;
+  return `\n\n本轮报告选项（仅当用户要求生成报告时使用，不因此自动生成）：${choice.completion_mode?`completion_mode=${choice.completion_mode}，`:''}research_tier=${choice.research_tier}，research_strategy=${choice.research_strategy}，fact_check=${choice.fact_check}。生成时传入 requirements；用户正文另有明确选择则按正文。`;
  }
  function mount(target){
   panel=target;panel.classList.add('composer-research-panel');$('composer-params').textContent='研究选项';
@@ -33,7 +33,7 @@ export function createComposerOptions({$,getChat,getState,availability,rememberD
   if(runtimeGrid)carriers.append(runtimeGrid);$('chat-form').append(carriers);
   const permission=$('chat-permissions-open');if(permission)$('composer-params').parentElement.before(permission);
   root=doc.createElement('section');root.className='composer-report-settings';
-  root.innerHTML='<h3>本次报告</h3><div class="composer-report-field"><span>来源范围</span><div class="composer-choice-group"><button type="button" data-report-source="existing">已有来源</button><button type="button" data-report-source="web">允许补搜</button></div></div><label class="composer-report-field"><span>生成方式</span><select data-completion aria-label="本次报告生成方式"><option value="fast">快速</option><option value="standard">标准</option><option value="direct">直写（试用）</option></select></label><p class="help" data-report-mode-note></p><label class="composer-report-field"><span>研究方法</span><select data-research-strategy aria-label="本次报告研究方法"><option value="guided">分轮研究</option><option value="goal_driven">按目标补证（试用）</option></select></label><p class="help">按目标补证由重要问题和证据缺口决定下一步；预算与权限不变。用于标准生成，尚未证明质量优于分轮研究。</p><details class="composer-report-advanced"><summary>高级选项</summary><label class="composer-report-field"><span>研究深度</span><select data-research-tier aria-label="本次报告研究深度"><option value="quick">快速</option><option value="standard">标准</option><option value="deep">深入</option></select></label><div class="composer-report-fact"><label><input type="checkbox" data-report-fact>事实核查</label><button type="button" class="subtle-button" data-fact-link></button></div></details><p class="composer-report-scope">仅用于本次报告，不改动工作区默认设置。</p>';
+  root.innerHTML='<h3>本次报告</h3><div class="composer-report-field"><span>来源范围</span><div class="composer-choice-group"><button type="button" data-report-source="existing">已有来源</button><button type="button" data-report-source="web">允许补搜</button></div></div><p class="help">BriefLoop 自主研究并成稿，保存后继续核查。</p><details class="composer-report-advanced"><summary>高级选项</summary><label class="composer-report-field"><span>生成方式</span><select data-completion aria-label="本次报告生成方式"><option value="fast">快速</option><option value="standard">标准</option><option value="">自主成稿（默认）</option><option value="direct">自主直写</option></select></label><p class="help" data-report-mode-note></p><label class="composer-report-field"><span>研究方法</span><select data-research-strategy aria-label="本次报告研究方法"><option value="guided">分轮研究</option><option value="goal_driven">按目标补证（试用）</option></select></label><p class="help">按目标补证由重要问题和证据缺口决定下一步；预算与权限不变。用于标准生成，尚未证明质量优于分轮研究。</p><label class="composer-report-field"><span>研究深度</span><select data-research-tier aria-label="本次报告研究深度"><option value="quick">快速</option><option value="standard">标准</option><option value="deep">深入</option></select></label><div class="composer-report-fact"><label><input type="checkbox" data-report-fact>事实核查</label><button type="button" class="subtle-button" data-fact-link></button></div></details><p class="composer-report-scope">仅用于本次报告，不改动工作区默认设置。</p>';
   panel.append(root);if(actions)root.append(actions);
   root.querySelectorAll('[data-report-source]').forEach(button=>{button.onclick=()=>{webChange(button.dataset.reportSource==='web');sync()}});
   root.querySelector('[data-completion]').onchange=event=>change('completion_mode',event.target.value);

{briefloop-0.31.0 → briefloop-0.31.3}/frontend/next-report.js

@@ -28,7 +28,7 @@ export function nextReportUI({$,api,savedVersion,getCurrent,applyRequirements,cl
    }
    if(openConversation){await openConversation(data);return}
    contract=candidate;
-   set('completion_mode','standard');
+   set('completion_mode','');
    set('template_id',contract.template_id||'');
    applyRequirements(JSON.stringify(contract));
    for(const key of ['organization','industry','report_date','reader_id','previous_report_version_id','previous_report_hash'])set(key,contract[key]);

{briefloop-0.31.0 → briefloop-0.31.3}/frontend/quick-report.js

@@ -7,6 +7,7 @@ export function createQuickReport({$,api,action,notice,savedVersion,getCurrent,e
  let ticket=0,busy=false;
  function sync(){
   const mode=$('completion-mode')?.value,enabled=['draft_first','fast','fast_web'].includes(mode),fast=['fast','fast_web'].includes(mode);
+  if($('research-strategy'))$('research-strategy').disabled=!mode||mode==='direct';
   if($('draft-target-label'))$('draft-target-label').hidden=!enabled;
   if($('draft-target'))$('draft-target').disabled=!enabled;
   for(const node of $('requirements')?.querySelectorAll?.('[name="allow_web"], [name="fact_check"], [name="research_tier"], [name="research_strategy"], #auto-revision, #company-mode')||[]){
@@ -30,6 +31,8 @@ export function createQuickReport({$,api,action,notice,savedVersion,getCurrent,e
    ?'一轮聚焦检索，最多 3 次搜索、读取 6 篇原文，随后直接出稿。无需先上传材料；可在搜索设置选择渠道。保存后在后台补依据和评价，不自动改写正文；十分钟是目标，非保证或截止。'
    :mode==='fast'
    ?'已有文本材料直接出稿，保存后自动在后台补充依据和评价；可立即编辑、下载。此模式不联网补搜、不维护企业背景、不自动改写正文。材料较多时可能需要更久，不保证固定时限。'
+   :!mode||mode==='direct'
+   ?'BriefLoop 在同一上下文中完成研究与写作；稿件保存后继续补充依据、独立评价和修订。'
    :'完整流程按所选研究深度检索、写作和检查。先交研究初稿的旧任务仍可手动继续完整检查。';
   if(fast&&$('completion-mode-help')&&!GUARDED_FAST_BACKENDS.includes(getBackend()))$('completion-mode-help').textContent+=' 当前执行引擎的自带工具无法由 BriefLoop 关闭：仍可出稿，任务记录会写明写作期间的工具使用，找不到原文依据的结论会单独列出。';
   if(fast&&$('review-capability-note'))$('review-capability-note').hidden=true;
@@ -44,7 +47,7 @@ export function createQuickReport({$,api,action,notice,savedVersion,getCurrent,e
   const mode=$('completion-mode')?.value;
   return ['draft_first','fast','fast_web'].includes(mode)
    ?{completion_mode:mode,target_minutes:Number($('draft-target').value),...(['fast','fast_web'].includes(mode)?{research_tier:'quick',allow_web:mode==='fast_web',fact_check:false}:{})}
-   :{completion_mode:'standard'};
+   :mode?{completion_mode:mode}:{};
  }
  async function render(){
   sync();

briefloop-0.31.3/frontend/report-sticky-layout.js

@@ -0,0 +1,33 @@
+// The report header wraps as the title, actions and viewport change.
+// Keep the rail below its actual height and let the pane use the remaining viewport.
+export function createReportStickyLayout({report,header,scroller,panel,grid,column,documentArea,jobs,window:win=globalThis.window,
+ ResizeObserver:Observer=globalThis.ResizeObserver,MutationObserver:VisibilityObserver=globalThis.MutationObserver}){
+ if(!report||!header||!Observer)return;
+ const originalParent=jobs?.parentNode;
+ // A sticky grid item is bounded by its row. Include trailing jobs in the
+ // document column so they cannot push the rail above the report header.
+ // Keep the existing full-width jobs outside hidden/outline and narrow layouts.
+ const placeJobs=()=>{
+  if(!jobs||!originalParent||!column||!grid||!documentArea||!panel)return;
+  const sideBySide=!grid.hidden&&!documentArea.hidden&&win.getComputedStyle(panel).position==='sticky';
+  const target=sideBySide?column:originalParent;
+  if(jobs.parentNode!==target)target.append(jobs);
+ };
+ const update=()=>{
+  placeJobs();
+  const height=header.getBoundingClientRect().height;
+  if(height>0)report.style.setProperty('--report-header-height',`${Math.ceil(height)}px`);
+  if(scroller){
+   const style=win.getComputedStyle(scroller);
+   const available=scroller.clientHeight-parseFloat(style.paddingTop)-parseFloat(style.paddingBottom);
+   if(available>0)report.style.setProperty('--report-viewport-height',`${Math.floor(available)}px`);
+  }
+ };
+ const observer=new Observer(update);
+ observer.observe(header);
+ if(scroller)observer.observe(scroller);
+ const visibility=VisibilityObserver?new VisibilityObserver(update):null;
+ for(const element of [grid,documentArea])if(element)visibility?.observe(element,{attributes:true,attributeFilter:['hidden']});
+ update();
+ return {disconnect:()=>{observer.disconnect();visibility?.disconnect()}};
+}

{briefloop-0.31.0 → briefloop-0.31.3}/frontend/schedules.js

@@ -14,7 +14,8 @@ export function scheduleUI({api,getState,refresh,notice,openReport}){ const disp
  }
  function open(id){
   const state=getState(),row=(state.schedules||[]).find(s=>s.id===id);editing=row||null;
-  requirements=structuredClone(row?.config.requirements||state.requirements||{});
+  requirements=structuredClone(row?.config.requirements||{...state.requirements,completion_mode:undefined});
+  if(row)requirements.completion_mode??='standard';
   const config=row?.config||{},later=new Date(Date.now()+3600000);later.setSeconds(0,0);
   const local=new Date(later.getTime()-later.getTimezoneOffset()*60000).toISOString().slice(0,16);
   $('schedule-name').value=row?.name||requirements.title||'';$('schedule-title').value=requirements.title||'';$('schedule-objective').value=requirements.objective||'';
@@ -24,7 +25,7 @@ export function scheduleUI({api,getState,refresh,notice,openReport}){ const disp
   $('schedule-preview').textContent='';$('schedule-error').textContent='';custom();$('schedule-dialog').showModal();
  }
  function custom(){$('schedule-custom').hidden=$('schedule-frequency').value!=='custom';}
- function body(){return {id:editing?.id,name:$('schedule-name').value,enabled:editing?.enabled??true,config:{frequency:$('schedule-frequency').value,start:$('schedule-start').value,timezone:$('schedule-timezone').value,every:Number($('schedule-every').value),unit:$('schedule-unit').value,requirements:{...requirements,title:$('schedule-title').value,objective:$('schedule-objective').value,allow_web:$('schedule-web').checked},source_ids:[...$('schedule-sources').querySelectorAll('input:checked')].map(n=>n.value)}};}
+ function body(){return {id:editing?.id,name:$('schedule-name').value,enabled:editing?.enabled??true,config:{automatic_completion_mode:editing?!!editing.config.automatic_completion_mode:!requirements.completion_mode,frequency:$('schedule-frequency').value,start:$('schedule-start').value,timezone:$('schedule-timezone').value,every:Number($('schedule-every').value),unit:$('schedule-unit').value,requirements:{...requirements,title:$('schedule-title').value,objective:$('schedule-objective').value,allow_web:$('schedule-web').checked},source_ids:[...$('schedule-sources').querySelectorAll('input:checked')].map(n=>n.value)}};}
  $('schedule-new').onclick=()=>open();$('schedule-cancel').onclick=()=>$('schedule-dialog').close();$('schedule-frequency').onchange=custom;
  $('schedule-preview-button').onclick=async()=>{try{const data=body(),result=await api('schedules/preview',data);$('schedule-preview').textContent='下次执行：'+display(result.next_at,data.config.timezone);$('schedule-error').textContent='';}catch(e){$('schedule-error').textContent=e.message;}};
  $('schedule-form').onsubmit=async e=>{e.preventDefault();const submit=e.submitter;submit.disabled=true;try{await api('schedules/save',body());$('schedule-dialog').close();await refresh();notice('定时报告已保存');}catch(err){$('schedule-error').textContent=err.message;}finally{submit.disabled=false;}};

{briefloop-0.31.0 → briefloop-0.31.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "briefloop"
-version = "0.31.0"
+version = "0.31.3"
 description = "Local multi-runtime agent workbench for sourced briefings, independent review and skill learning"
 readme = "README.md"
 requires-python = ">=3.11"

{briefloop-0.31.0 → briefloop-0.31.3}/scripts/check_versions.py

@@ -104,11 +104,21 @@ def check(args):
             if os.name != 'nt':
                 raise ValueError('Windows EXE version must be inspected on Windows')
             exe = args.windows_app.resolve()
-            # Literal path and no executable invocation: inspect PE version metadata.
+            # PE metadata strips prerelease qualifiers; read the packaged JSON as well for candidates.
             literal = str(exe).replace("'", "''")
             command = f"[Console]::OutputEncoding=[Text.Encoding]::UTF8; (Get-Item -LiteralPath '{literal}').VersionInfo.ProductVersion"
             version = subprocess.check_output(['powershell.exe', '-NoProfile', '-Command', command], text=True, encoding='utf-8').strip()
             raw_windows_version = version
+            if expected != re.match(r'\d+\.\d+\.\d+', expected)[0]:
+                env = {key: value for key, value in os.environ.items() if key not in ('NODE_OPTIONS', 'NODE_PATH')}
+                env['ELECTRON_RUN_AS_NODE'] = '1'
+                script = 'process.stdout.write(JSON.stringify(JSON.parse(require("node:fs").readFileSync(process.argv[1],"utf8")).version))'
+                package_path = exe.parent / 'resources' / 'app.asar' / 'package.json'
+                packaged = json.loads(subprocess.check_output([str(exe), '-e', script, str(package_path)],
+                                      env=env, text=True, stderr=subprocess.PIPE, timeout=15).strip())
+                if not isinstance(packaged, str) or normalize_windows_version(version) != packaged.split('-')[0]:
+                    raise ValueError('Windows PE identity differs from the packaged application version')
+                version = packaged
             return {'app': normalize_windows_version(version), **backend_versions(exe.parent / 'resources', release_hash)}
         capture('windows', windows)
         if raw_windows_version is not None:results['windows']['raw_product_version']=raw_windows_version

briefloop-0.31.3/src/briefloop/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.31.3"

{briefloop-0.31.0 → briefloop-0.31.3}/src/briefloop/analyst.py

@@ -19,13 +19,13 @@ WRITING_GUIDE = '''你是本报告的 Analyst，直接完成可读的中文报
 先读 input.json.task_context 的目的与证据导航，再读 writing.md、plan.json、research.json，按需要核对 source-index.json 中的原文。source-context.json 给出各来源的条件/更新候选行段与短逐字原文；先核对所用来源的这些原文，再写采用建议，必要时回读完整相关段落。它是导航，不是条件已满足的判断；truncated 或 omitted 表示尚未完整展示，无匹配仍须自行检查相关章节。
 本阶段不联网、不新增研究来源；研究摘要是线索，不代替原文。不同口径、预测与实际、期内与期后不能混写。
 结论须由所引段落支持；分析与行动建议可由你提出，但交代有依据的业务联系，不伪装成来源已经说过的话。
-遵循读者用途、重点、篇幅和人工填写章节。正文直接面向读者，具体缺口和核查过程放 research_notes/gaps，不反复写免责声明。
+遵循读者用途、重点、篇幅和人工填写章节。正文直接面向读者，状态与限制按 writing.md 的写法写在受影响的句子里；具体缺口和核查过程放 research_notes/gaps。
 先按用户原话安排重点章节；结构化 period/辅助指标与原话或原件冲突时，回查后在 research_notes 记录依据，不静默照抄，也不改写冻结输入。
 政策的条件、例外与生效时间分开核对；同表比较对齐期间、单位、分母和实际/预测状态。摘要中的压缩表述仍须完整保留决定结论的条件。
-复合句中的事实分别挂到真正支持它的来源；引用存在不等于支持该句。数值与事件同时发生不足以确认因果，结论本身保留适当强度，不靠末尾免责声明抵消。
+复合句中的事实分别挂到真正支持它的来源。数值与事件同时发生只说明相关；因果判断要有机制或原文依据，结论强度与证据相称。
 重要数字用 number_bindings 绑定原始 value/unit、label/entity/period、source_id/locator、逐字 source_excerpt，以及正文唯一 report_quote 和其中的 number_text；匹配只证明数值定位，含义仍须核对。
 数字定位用 line 12-14、page 3 或证据定位 JSON，不用章节名称代替定位；源摘录必须逐字来自该位置。单独查看 document-guide.json 的数字绑定规则，不把不支持的单位或未定位结果写成核验成功。
-先按重点分配篇幅，标题、表格和摘要都计入正文。分章保存回执给出累计长度；默认 soft 中 target_words/max_words 都是建议，完整且切题的必要内容可以直接提交，不为消除超出提示反复改稿。只有 length_mode=strict 且有用户要求来源时才按明确上限检查；冲突时保留事实、引用和采用条件并说明差距。低于目标也不为凑字数扩写。提交前核对具体重复、离题及引用定位问题，不反复整篇重抄。修订时逐项处理 input.feedback，保留有效内容、必要条件及未解决问题，不仅添加免责段。
+先按重点分配篇幅，标题、表格和摘要都计入正文。分章保存回执给出累计长度；默认 soft 中 target_words/max_words 都是建议，完整且切题的必要内容可以直接提交，不为消除超出提示反复改稿。只有 length_mode=strict 且有用户要求来源时才按明确上限检查；冲突时保留事实、引用和采用条件并说明差距。低于目标也不为凑字数扩写。提交前核对具体重复、离题及引用定位问题，不反复整篇重抄。修订时逐项处理 input.feedback，改正文本身；保留有效内容、必要条件及未解决问题。
 输出完整 BriefDraft，使用 editor_document 富文档正文，结构见 draft.schema.json 与 document-guide.json。
 配色遵循 input.json.chart_presentation：涨跌色只用于真实变化数字、箭头和变化系列；营收、余额、利润率等任意正负值不自动着色。已登记图像保持原样，改变图像配色须重新生成并登记。
 图表只复用任务包中实际登记的 figure_id；需要比较表时复用 document-guide.json 的 table_example：表头和单元格都先放 paragraph，再放 text/citation。表内事实的引用放在相应单元格，不能只登记在 draft.citations 而正文不标引用。结构化指标可交给 prepare_report_data 计算，最终 report_data 保留原始 records。

{briefloop-0.31.0 → briefloop-0.31.3}/src/briefloop/chat_tools.py

@@ -208,8 +208,10 @@ def workspace_action(store, request):
         from .external_client import Client
         return Client(store.root).stop_job(job_id)
     if action=='generate':
+        if 'connector_selection' in request:
+            raise ValueError('聊天生成工具暂不接纳实时连接器选择；请在新报告入口选择连接器，或先导入材料后用 source_ids 生成。')
         from .next_report import generation_requirements
-        requirements=Requirements.model_validate(generation_requirements(store,request['requirements'],_notify_owner(request)))
+        raw_requirements=generation_requirements(store,request['requirements'],_notify_owner(request))
         source_ids=request.get('source_ids',[])
         if not isinstance(source_ids,list) or not all(isinstance(x,str) for x in source_ids):raise ValueError('source_ids 必须是来源 ID 数组')
         runtime_payload={}
@@ -223,6 +225,8 @@ def workspace_action(store, request):
             backend=validate_backend(backend)
             settings=Settings.model_validate({**store.settings(),**request['runtime'],'agent_backend':backend})
             runtime_payload={'runtime':runtime_fields(settings.model_dump(),backend),'agent_backend':backend}
+        backend=runtime_payload.get('agent_backend') or store.settings().get('agent_backend','codex')
+        requirements=Requirements.new_request(raw_requirements, backend=backend)
         run=store.create_run(requirements.model_dump(),source_ids,research_protocol="quality_v1",
                              **({'agent_backend':runtime_payload['agent_backend']} if runtime_payload else {}))
         payload={'run_id':run['id'],**runtime_payload}
@@ -355,7 +359,7 @@ def chat_instructions(store, runtime, *, internal=False, allow_web=False, backen
 - {{"action":"templates"}}：读取可选模板。用户要求上传材料用作主模板时用 {{"action":"template_import","source_id":"DOCX来源ID"}} 启动一次准备；准备完成后 generate.requirements.template_id 选择具体版本。需要重新准备已有模板版式时，用 {{"action":"template_rebuild","template_id":"已有模板ID"}} 从保留原件创建新模板版本；原模板和已绑定稿件保持不变，新任务选择返回的新模板ID。
 - {{"action":"read_report","version_id":"稿件ID"}}：读取富文档 JSON、引用和已存正文的 length_stats；revise_document 回执也给出保存后的确定性计数。按 count/rule 核对原始要求、读者约定及当前反馈，不估算字数；over_limit 只比较结构化 max_words，不表示已满足全部篇幅要求。用户明确要求修改内容/章节/图表时，将修改后的 JSON 保存到工作区文件，再用 {{"action":"revise_document","base_version":"刚读取版本ID","document_file":"工作区内JSON绝对路径"}} 保存新版本，不覆盖用户并发编辑。可选 citations 完整替换引用列表（source_id/locator/excerpt，schema 见 capabilities），省略则保留；只修改引用也保存新版本，定位描述不表示已独立核验。
 - {{"action":"import_word_revision","base_version":"用户指定基础版本","source_id":"DOCX来源ID"}}：导入用户修改的 Word。返回 needs_alignment 时先核对原件和基础版本，向用户说明对齐问题；仅按用户明确选择提供 accept_unaligned=true。用户希望更新模板时另用 template_import 并提供 parent_id。
-- {{"action":"generate","requirements":{{"title":"标题","objective":"用户目的","audience":"读者","language":"zh|en","extent":"compact|balanced|detailed","research_tier":"quick|standard|deep","allow_web":{str(bool(allow_web)).lower()},"period":"时间范围"}},"source_ids":["真实来源ID"],"runtime":{runtime_json}}}：正式生成可在页面编辑的简报。language 是报告正文语言（默认 zh）；用户要英文报告时写 en，不传 target_words 时篇幅按英文词数默认。research_strategy 是本轮研究方法：guided 沿用分轮建议，goal_driven 按重要问题和证据缺口选择下一步，不改变授权预算与最大轮数；只有用户选择时传入，默认 guided。research_tier 是研究深度档位（默认 standard）：quick 单轮检索，deep 最多 4 轮迭代研究；按用户明确要求选，用户未提就不写该字段。scout_limit 是本报告最多可同时派发的 Scout 数（1–16），在提交前按信息量决定：一周左右约 4，月报约 8，跨多个行业或市场的大型报告可到 12–16；不写时系统按期间自动设定（月报 8，其余沿用工作区设置）。
+- {{"action":"generate","requirements":{{"title":"标题","objective":"用户目的","audience":"读者","language":"zh|en","extent":"compact|balanced|detailed","research_tier":"quick|standard|deep","allow_web":{str(bool(allow_web)).lower()},"period":"时间范围"}},"source_ids":["真实来源ID"],"runtime":{runtime_json}}}：正式生成可在页面编辑的简报。language 是报告正文语言（默认 zh）；用户要英文报告时写 en，不传 target_words 时篇幅按英文词数默认。默认由同一作者自主研究并成稿，保存后继续补充依据、评价和修订。独立风格参考与行业季报由系统采用其既有标准流程；保留参考与用途要求，不需用户另选生成方式。research_strategy 仅用于标准流程：guided 沿用分轮建议，goal_driven 按重要问题和证据缺口选择下一步，不改变授权预算与最大轮数；只有用户选择时传入，默认 guided。research_tier 是研究深度档位（默认 standard）：quick 单轮检索，deep 最多 4 轮迭代研究；按用户明确要求选，用户未提就不写该字段。scout_limit 是本报告最多可同时派发的 Scout 数（1–16），在提交前按信息量决定：一周左右约 4，月报约 8，跨多个行业或市场的大型报告可到 12–16；不写时系统按期间自动设定（月报 8，其余沿用工作区设置）。
 联网完整报告的 fact_check 沿用工作区默认（新工作区开启）；用户选择关闭时显式传 false，选择开启时传 true。离线或快速模式不自动开启，也不为核查偷偷开启联网。
 提交 generate 时，必须把本轮已经确认的 key_questions、writing_preferences、章节、期间和篇幅完整写进 requirements，不能只传标题摘要。用户给出的执行约束同样在提交前冻结：target_minutes 是软目标；hard_timeout_minutes=0 表示不设硬截止；research_budget 包含 search_requests、candidate_urls、source_pages；search_policy 沿用已授权设置。不得说“后台稍后配置”而遗漏已指定的额度。并行数要求写入 writing_preferences，供主 Agent 冻结研究计划时选择 structure.parallel；不改变共享预算。提交回执中的实际冻结值与用户要求不一致时明确说明，不宣称已应用。
 - {{"action":"stop_job","job_id":"真实任务ID"}}：用户要求停止任务时，先通过 inspect 确认具体任务，再停止该任务及其子任务，已保存稿件保留。用户要求“停掉旧任务再重新生成”时先取得停止回执，再提交新任务；停止失败时如实说明，不启动重复任务。目标不明确时先问，不猜 ID，不停止整个服务。以回执的实际 status 为准，已经完成的任务不会变成 cancelled。

{briefloop-0.31.0 → briefloop-0.31.3}/src/briefloop/connectors/MATERIALS.md

@@ -187,12 +187,24 @@ binding commit together using Store.enqueue's host-only before_commit callback.
 Its payload records `connector_materials: true`, no credentials. Other creation
 paths retain the existing requirement for sources or allowed web search.
 
-The server attaches TaskMaterials to Worker. Around the main generation execute
-call only, `generation_access` writes a unique 0600 process capability file and
-adds a stdlib tool-client command and frozen selection to generation instructions.
-The token itself is absent from prompts and job payloads. On exit the file is
-removed and access invalidated; assessment/reviewer calls are outside this scope.
-The actual tool still rechecks the generating job and grant on every request.
+A selected connector defaults to the standard generation path when the request
+omits `completion_mode`. Explicit direct/fast modes with live selection are refused
+before generation rather than ignoring the selection.
+
+The server attaches TaskMaterials to Worker. Before compiling the author input,
+`prepare_resources` reads only the explicitly selected resource URIs through the
+frozen grant, budget and admission checks. Admitted sources enter the normal source
+index and Analyst packet; acquisition receipts enter `input.json.connector_resources`.
+Repeated preparation reuses earlier receipts without sending the request again,
+including uncertain results. Parameterized tools are not executed by preparation.
+
+Around the main generation execute call, `generation_access` exposes selected tools.
+The native backend uses its trusted `connector_material` handler. CLI hosts use the
+existing scoped client with a unique 0600 capability file, removed on exit. Offline
+Codex cannot reach that live client and rejects tool selections before enqueue;
+selected resources remain supported through controller preparation. Tokens stay
+out of prompts and job payloads. Assessment/reviewer calls are outside this scope.
+The actual tool rechecks the generating job and grant on every request.
 Worker cancellation revokes the grant before signalling the running transport,
 therefore in-flight material admission is rejected after cancellation. A cancelled
 MCP grant does not silently regain authority on resume; a new user-selected task
@@ -207,10 +219,12 @@ describe use. These states must not be conflated with fact verification. Source
 and citation views use the existing report UI; enabling a connector alone does
 not select or admit its materials.
 
-A real local application HTTP test creates a source-empty/offline task, invokes the
-same scoped CLI client provided to generation, checks source admission, then stops
-the task through Worker and verifies revocation. This proves the HTTP/tool path,
-not that a language model actually chooses the tool or produces a suitable report.
+Real local HTTP/MCP behavior checks create a source-empty/offline task and verify
+that the author reads the selected resource from its normal input, the Analyst
+packet contains the same original, and the saved draft cites its source. Repeating
+preparation causes only one MCP read. The unsupported offline tool combination is
+refused without executing it. These checks use a deterministic author; an installed
+model run is a separate validation of actual writing and citation use.
 
 This boundary constrains these application APIs; it is not OS isolation against a
 host process with arbitrary access to the workspace/database or browser session.

{briefloop-0.31.0 → briefloop-0.31.3}/src/briefloop/connectors/runtime_tools.py

@@ -14,6 +14,16 @@ def generation_access(worker, job):
     if tasks is None or not tasks.has_binding(job['id']):
         yield ''
         return
+    grant = tasks.status(job['id'])['grant']['data']
+    selection = [{'connector_id': item['id'], 'tools': item['tools']} for item in grant['connectors'] if item['tools']]
+    if not selection:
+        yield ''
+        return
+    summary = '\n本轮用户已选择的连接器工具：' + json.dumps(selection, ensure_ascii=False) + '\n'
+    summary += '已接纳资源见本轮来源索引，未接纳资源见 input.json.connector_resources 的回执；工具由作者按需要确定参数。\n'
+    if json.loads(job['payload']).get('agent_backend', 'codex') == 'briefloop-native':
+        yield summary + '使用本阶段的 connector_material 工具调用所选工具；实际接纳的 source_id 才能读取和引用。\n'
+        return
     access = tasks.access(job['id'])
     token = access['access_token']
     directory = worker.store.root / '.connector-access'
@@ -24,12 +34,9 @@ def generation_access(worker, job):
         with os.fdopen(descriptor, 'w') as stream:
             json.dump({'access_token': token, 'url': worker.connector_tool_url}, stream)
         command = shlex.join([sys.executable, str(Path(__file__).with_name('task_client.py')), '--access-file', str(path), '--request', 'request.json'])
-        grant = tasks.status(job['id'])['grant']['data']
-        selection = [{'connector_id': item['id'], 'resources': item['resources'], 'tools': item['tools']} for item in grant['connectors']]
-        yield '\n本轮用户已选择的连接器材料：' + json.dumps(selection, ensure_ascii=False) + '\n' + (
-            '使用已授权材料工具读取这些来源；这不依赖是否允许网页搜索。写 JSON 请求到 request.json，再执行：' + command + '\n'
-            '请求格式：{"action":"read","connector_id":"...","uri":"...","request_id":"稳定唯一ID"}；'
-            '或 {"action":"call","connector_id":"...","name":"...","arguments":{},"request_id":"稳定唯一ID"}。'
+        yield summary + (
+            '需要调用所选工具时，写 JSON 请求到 request.json，再执行：' + command + '\n'
+            '请求格式：{"action":"call","connector_id":"...","name":"...","arguments":{},"request_id":"稳定唯一ID"}。'
             '状态用 {"action":"status"}，回执用 {"action":"receipt","receipt_id":"..."}。'
             '按已选目录和冻结预算执行；不要读取、复制或输出 access-file 内容。返回 admitted 后用 source_id 读取、引用和核查正文；'
             '未接纳的回执不能当事实。不要自行授权、提额、改宿主连接配置或把凭据传给审阅者。\n')