briefloop 0.31.3__tar.gz → 0.31.6__tar.gz

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

@@ -1,5 +1,25 @@
 # 变更记录
 
+## 0.31.6
+
+- 收敛新报告入口：按任务自动选择所需流程，保留材料范围、研究投入和篇幅；原有任务配置不改。
+- BriefLoop Agent 升级至 Pi 1.2.0，修复思考档位传递，减少 Native 修订包的重复材料。
+- 改稿与实际会话、消息和稿件版本绑定，引用单独修改也待复查；检查重试复用证据子稿，核查预算按版本接纳。
+- 新工作区默认选择学习意图，首次确认预算后才启动；旧关闭选择保留，候选方法仍须验证后采用。
+- 复用现有 Jev Decision API 核查数字语义，保留输入预览、来源与版本绑定；作者上下文不能作为独立证据。
+- 设置页返回原页面和滚动位置；Windows Codex 配置兼容 UTF-8 BOM。
+
+- 自动事实核查拒绝未确认公开的失败来源，即使正文为空也不外发其 URL；保留正文完整性校验。
+- 核查取消或中断后重试先接纳本任务已抓取的来源，并沿明确的重试链恢复回执。
+
+## 0.31.5（未发布，验收中止）
+
+- 更新说明生成文件未同步，构建一致性检查失败；未进入正式更新渠道。
+
+## 0.31.4（未发布，验收中止）
+
+- 冻结候选在发布前发现失败来源许可及取消恢复问题，由 0.31.6 替代，未进入正式更新渠道。
+
 ## 0.31.3
 
 - 修复导出后重开滚到页尾时右栏被顶栏遮挡：任务记录随正文列共同延长右栏的滚动边界；大纲、无稿件和窄屏保留原位置。

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.31.3
+Version: 0.31.6
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT
@@ -42,7 +42,7 @@ Dynamic: license-file
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
-界面与文档为中文，报告正文可选中文或英文；英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
+界面与文档为中文，报告正文可选中文或英文；英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，使用本次报告的共享预算。新报告统一自动安排流程，可选择轻量、常规或深入的研究投入，以及独立事实核查；安装版可用功能以实际发行版本为准。见 [研究投入与事实核查](docs/深度研究与事实核查.md)。
 
 新建报告可选择通用报告、商业报告（行业周报／月报／季报、工作进展周报与决策分析）、证券研究（事件点评、公司研究与行业跟踪）或会议纪要。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式均可使用；学术论文、上市公司年报、政府公文和合同的专门内容流程将分批接入。
 
@@ -58,6 +58,10 @@ Dynamic: license-file
 
 报告开始前可预览系统日期、时间范围和时区；任务开始后冻结。我的报告显示研究、已保存材料、审阅与修订的实际进展，原稿生成后即可查看。见 [使用指南](docs/使用指南.md)。
 
+## 联系
+
+欢迎交流使用反馈与合作：[Stahl Guo 个人主页](https://stahlguo.com/) · [LinkedIn](https://www.linkedin.com/in/stahl-guo-488a8021b/) · [contact@briefloop.ai](mailto:contact@briefloop.ai)
+
 ## 桌面 App
 
 桌面安装包以发行页实际提供的版本为准；App、CLI 与 PyPI 使用同一产品版本和冻结后端 wheel，各渠道是否发布以版本核验结果为准。
@@ -182,7 +186,7 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 - **直接改稿与学习**：编辑正文或留下反馈；Wiki Maintainer 整理经验，Skill Proposer 提出技能，Evaluator 比较实际产物后决定是否采用。
 - **明确的预算与篇幅**：整次报告共享检索额度；正文目标字数和上限可直接修改。
 
-未指定生成方式时，实时连接器资料、企业内部报告、独立风格参考、行业季报和外部 Pi 沿用既有标准流程，保留企业维护、数据工具及宿主兼容能力。高级选项中的显式选择与历史任务保持原行为。
+新报告不再选择生成方式或研究策略。普通报告由同一作者研究成稿；实时连接器资料、企业内部报告、独立风格参考、行业季报和外部 Pi 自动使用适配流程，保留专用工具与兼容能力。旧任务恢复及已有外部 API 的显式调用保留原行为。
 
 ## 第一次使用
 
@@ -190,7 +194,8 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 2. 在「设置 → 运行与搜索」选择首选渠道、允许补充的渠道及覆盖策略。Tavily、博查、智谱搜索的 Key 可在同页保存，保存不会自动调用搜索。
 3. 在“设置”确认执行宿主、主模型及角色模型。模型 ID 可自行填写；Codex 的 provider 填本机已配置的 Responses provider 名称，其它宿主用它自己的配置；需要接第三方 API 时在“API 提供商”里登记协议、Base URL、Key 和模型。
 4. 点击生成。草稿保存后即可查看，评分独立完成；低分或评分失败不会隐藏原稿。
-5. 按需修改正文、保存反馈或明确启动学习。保存反馈不调用模型；自动学习默认关闭，开启前会显示并要求确认调用上限，确认后编辑静默约 30 秒会合并反馈并启动模型任务。
+5. 按需修改正文、保存反馈或明确启动学习。保存反馈不调用模型；新工作区首次选择模型时默认勾选自动学习，点击开始时确认调用预算后才开启。
+   可取消勾选，既有明确关闭的选择保持关闭；确认开启后，编辑静默约 30 秒会合并反馈并启动模型任务。
 
 ### MCP 连接器材料
 

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

@@ -2,7 +2,7 @@
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
-界面与文档为中文，报告正文可选中文或英文；英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
+界面与文档为中文，报告正文可选中文或英文；英文报告有独立写作规范、按词计的篇幅和英文版式，核查记录仍为中文。研究在所选本机宿主中执行，使用本次报告的共享预算。新报告统一自动安排流程，可选择轻量、常规或深入的研究投入，以及独立事实核查；安装版可用功能以实际发行版本为准。见 [研究投入与事实核查](docs/深度研究与事实核查.md)。
 
 新建报告可选择通用报告、商业报告（行业周报／月报／季报、工作进展周报与决策分析）、证券研究（事件点评、公司研究与行业跟踪）或会议纪要。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式均可使用；学术论文、上市公司年报、政府公文和合同的专门内容流程将分批接入。
 
@@ -18,6 +18,10 @@
 
 报告开始前可预览系统日期、时间范围和时区；任务开始后冻结。我的报告显示研究、已保存材料、审阅与修订的实际进展，原稿生成后即可查看。见 [使用指南](docs/使用指南.md)。
 
+## 联系
+
+欢迎交流使用反馈与合作：[Stahl Guo 个人主页](https://stahlguo.com/) · [LinkedIn](https://www.linkedin.com/in/stahl-guo-488a8021b/) · [contact@briefloop.ai](mailto:contact@briefloop.ai)
+
 ## 桌面 App
 
 桌面安装包以发行页实际提供的版本为准；App、CLI 与 PyPI 使用同一产品版本和冻结后端 wheel，各渠道是否发布以版本核验结果为准。
@@ -142,7 +146,7 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 - **直接改稿与学习**：编辑正文或留下反馈；Wiki Maintainer 整理经验，Skill Proposer 提出技能，Evaluator 比较实际产物后决定是否采用。
 - **明确的预算与篇幅**：整次报告共享检索额度；正文目标字数和上限可直接修改。
 
-未指定生成方式时，实时连接器资料、企业内部报告、独立风格参考、行业季报和外部 Pi 沿用既有标准流程，保留企业维护、数据工具及宿主兼容能力。高级选项中的显式选择与历史任务保持原行为。
+新报告不再选择生成方式或研究策略。普通报告由同一作者研究成稿；实时连接器资料、企业内部报告、独立风格参考、行业季报和外部 Pi 自动使用适配流程，保留专用工具与兼容能力。旧任务恢复及已有外部 API 的显式调用保留原行为。
 
 ## 第一次使用
 
@@ -150,7 +154,8 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 2. 在「设置 → 运行与搜索」选择首选渠道、允许补充的渠道及覆盖策略。Tavily、博查、智谱搜索的 Key 可在同页保存，保存不会自动调用搜索。
 3. 在“设置”确认执行宿主、主模型及角色模型。模型 ID 可自行填写；Codex 的 provider 填本机已配置的 Responses provider 名称，其它宿主用它自己的配置；需要接第三方 API 时在“API 提供商”里登记协议、Base URL、Key 和模型。
 4. 点击生成。草稿保存后即可查看，评分独立完成；低分或评分失败不会隐藏原稿。
-5. 按需修改正文、保存反馈或明确启动学习。保存反馈不调用模型；自动学习默认关闭，开启前会显示并要求确认调用上限，确认后编辑静默约 30 秒会合并反馈并启动模型任务。
+5. 按需修改正文、保存反馈或明确启动学习。保存反馈不调用模型；新工作区首次选择模型时默认勾选自动学习，点击开始时确认调用预算后才开启。
+   可取消勾选，既有明确关闭的选择保持关闭；确认开启后，编辑静默约 30 秒会合并反馈并启动模型任务。
 
 ### MCP 连接器材料
 

briefloop-0.31.6/VERSION

@@ -0,0 +1 @@
+0.31.6

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

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

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

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

briefloop-0.31.6/docs/default-behavior.md

@@ -0,0 +1,71 @@
+# 默认行为与可选能力
+
+日常报告统一自动安排流程，普通任务默认自主直写。新建界面移除生成方式和研究策略选择，只保留材料范围、研究投入、篇幅及核查等有实际作用的设置。
+轻量、常规、深入表示研究投入，实际预算可以调整。特殊任务自动采用所需工具和流程。
+本轮没有更换产品版本、发布渠道或安装程序。
+
+## 补齐已有默认路径
+
+| 能力 | 行为 | 限制与验证范围 |
+|---|---|---|
+| 人工改稿后的自动学习 | 新工作区首次选择模型时默认勾选，开始使用时确认真实调用预算；既有关闭选择保留 | K 默认 1，候选经过分类和比较才能采用。已有合成闭环证明采用及下期送达，尚不证明连续真实周报的稳定收益 |
+| 报告反馈继续补查 | Native 报告聊天与其他宿主一样，在该消息获准联网后提供实际搜索、网页读取工具 | 绑定本消息、原稿版本与剩余预算；普通聊天、只读讨论、离线反馈不会取得该权限，完成或中断后失效 |
+| 直写稿独立事实核查 | 已有依据补全调用选择最多 12 条公开事实候选，定位到正文与原件后进入默认核查流程 | 候选不是正确性判定；联网核查及独立审阅仍各自执行。只处理可确认的匿名公开 HTTP 原件，混有未确认材料时不自动提取 |
+| 核查缺口显示 | 检查栏显示当前版本未进入核查的原因 | 旧稿原因不覆盖新稿，真实结果和正在执行的阶段优先；不往报告正文追加流程声明 |
+| 失败检查恢复 | 绑定原稿的检查可按当前模型新建重试，保留失败记录 | 只重做检查，正文不变；实际模型和思考档位单独记录 |
+
+公开原件准入当前不包含上传文件、连接器或通用提供方响应，也不接受含凭据、查询参数或片段的地址。
+空内容的失败公开抓取不会阻断同报告其他有效原件，但不能作为候选依据。已有标准流程及手动登记的主张维持原有行为。
+候选选择仍会遗漏事实；没有候选、搜索额度不足或检查未完成都不能显示为整稿核实。
+自动派发和实际执行前会复核公开资料范围，失效的旧稿绑定不进入新版核查。
+事实核查查询可以查历史背景，不被本期新闻窗口覆盖；普通 Tavily 研究按 UTC 日期扩大到覆盖边界，报告自身时间范围保持原值。
+
+## 已有默认功能
+
+| 范围 | 默认或按内容显示的能力 |
+|---|---|
+| 报告入口 | 对话创建报告、普通新请求自主直写；连接器、企业内部报告、独立风格参考、行业季报及外部 Pi 按既有适配走标准流程 |
+| 任务参数 | 允许联网、任务时间冻结、按期间建议篇幅与预算；手工指定的值优先 |
+| 保存与资料 | 自动保存编辑、历史版本、来源快照、引用定位、来源检索与归档、发布与收录日期区分 |
+| 检查 | 普通评价、数值和日期的确定性检查、具备能力时的独立事实核查、生成流程的一次自动修订 |
+| 修订 | 版本绑定的反馈、保留原稿、正文修改后移除失效依据、直写聊天改稿后的依据重建与评价；该收尾不重复改写正文 |
+| 阅读与输出 | 编辑器、表格和粗体、引用与来源侧栏、重大问题标记、大纲、Word 下载及其他格式菜单；未完成检查不封锁普通工作稿下载 |
+| 后续报告 | 用户启动下一期后沿用结构与已采用方法、明确保存的写作约定；当期事实重新获取 |
+| 引擎 | 作者角色上下文压缩、过程记录、受控重试、中断保留与恢复；Pi SDK 已整合至 1.2.0 |
+
+来源图片与 PDF 页面按需加载。右栏、技术详情、检查记录和历史记录依据现有内容显示，空态不占位。
+计划报告在用户创建后默认启用；产品不会替用户新建计划。旧任务没有生成方式字段时仍按旧标准流程恢复。
+
+## 保留可选的功能
+
+| 能力 | 继续保留选择的理由 |
+|---|---|
+| OfficeCLI 检查与 Excel 增强 | 本地实测能发现除零、无效工作表引用与非法字号，但干净 Word 的普通署名段也收到缩进建议；单次额外约 4–5 秒。一个开关同时控制检查和 Excel 增强，未证明整组默认开启的净收益 |
+| 深入研究、严格字数 | 分别调整研究投入和内容取舍，按本次任务选择 |
+| 建议句黄色标记 | 属于阅读显示偏好，可能增加噪声；重大问题标红已经开启 |
+| 附加搜索渠道、更多学习轮数、额外核查额度 | 影响外发范围、调用量及费用，使用既有明确选择与预算流程 |
+| Jev 语义预检 | 独立服务，旧实验不足以证明判断收益；不会自动增加服务调用 |
+| 企业背景、读者档案、模板与风格参考 | 需要知道本报告用途和材料范围；不存在适合所有报告的默认企业或读者 |
+| 来源更新、下一期、定时任务 | 明确任务后执行，来源新披露与旧稿事实错误分别处理 |
+| MCP 材料与外部工具 | 只使用选定连接器与材料，不因 SDK 支持而自动扩大权限 |
+| 正式交付与审计包 | 用户按需触发，正式交付仍绑定独立审阅与来源版本；普通下载继续可用 |
+| 桌面自动下载、退出安装、诊断、系统拼写检查 | 属于安装、系统或个人偏好，保持已有选择；不改变研究默认 |
+| 隐式缓存预热、Pi 任意 Shell、自动加载个人扩展 | 会增加调用或工具范围；现有角色隔离、指定工具和加载边界保持 |
+| Reviewer / Evaluator 自动压缩 | 检查角色使用固定证据包，不默认用摘要替换待核对材料 |
+
+读者专属技能的跨读者适用性和完整留出验证尚未完成，不能通过翻转开关视为完成。
+深色主题等缺少完整实现的界面能力也不属于“已做好却关闭”。
+
+## 退出新建入口的模式
+
+“自主成稿”和“自主直写”合为一个自动入口。“标准”流程留作连接器、季报等任务的内部适配，不再要求用户挑选。
+快速出稿、快速联网、先交初稿和目标补证从新建界面移除，也不再由旧聊天草稿或新定时报告的预填值隐式带入。
+目标补证的既有实验有覆盖退步；快速路径尚无充分的通用质量收益证据。其已发布协议保留，供旧任务恢复及已有外部调用使用。
+
+## 如何判断下一项该默认开启
+
+先确认用户主路径是否实际调用该能力，再以一份真实产物验证它减少了什么错误或返工，同时记录新增耗时、调用和误报。
+与已启用功能重叠的检查先合并入口；权限范围或交付行为不同的能力保留明确选择。
+模型分数、候选采用或工具成功各有范围，不能单独代替正文质量、事实正确性或长期学习收益。
+
+相关说明：[报告修订](report-revisions.md)、[学习闭环](revision-learning.md)、[内置引擎](内置引擎.md)。

{briefloop-0.31.3 → briefloop-0.31.6}/docs/draft-first.md

@@ -1,8 +1,11 @@
-# 先交初稿与继续检查
+# 历史生成协议与继续检查
+
+新建报告界面已统一为自动安排流程。本文记录已发布的快速、快速联网和先交初稿协议，供旧任务恢复及已有外部调用使用。
+这些模式不再作为新建界面的选择；已有稿件的继续检查、恢复和下载入口保留。
 
 ## 快速模式：已有材料直接写作
 
-新增 `completion_mode=fast`，在新建报告的“完成方式”中选择“快速模式 · 已有材料直接出稿”。它与旧 `draft_first` 的“研究照常、手动续检”不同：直接将完整文本材料交给一次写作会话，没有主控分工、Scout、写前研究轮次，也不要求模型填写稿件 JSON。写作、检索规划和依据补全都是“纯文本回合”，按执行引擎分两档（`src/briefloop/plain_isolation.py`）：
+`completion_mode=fast` 直接将完整文本材料交给一次写作会话，没有主控分工、Scout、写前研究轮次，也不要求模型填写稿件 JSON。它与 `draft_first` 的“研究照常、手动续检”不同。写作、检索规划和依据补全都是“纯文本回合”，按执行引擎分两档（`src/briefloop/plain_isolation.py`）：
 
 - **无工具配置**：内置引擎注册零个工具，Pi 用其关闭全部工具的模式；仍记录宿主报告的工具活动，不以配置代替正文依据核查。
 - **只读限制**：Codex、OpenCode 使用宿主只读权限，仍可能读取所选材料之外的信息；记录实际工具活动，不宣称全部工具关闭或材料隔离。
@@ -38,7 +41,7 @@
 
 下文记录旧 `draft_first` 的行为，旧任务仍可继续。
 
-报告需求中的 `completion_mode` 默认为 `standard`，保留原来的写作、检查及自动修订流程。选择 `draft_first` 才启用“先交初稿”；旧任务的 `research_tier=quick` 不会因此改变行为。研究深度、预算、篇幅与完成方式分别选择，不把“短报告”或“单轮研究”当作核验已经完成。
+历史保存的报告需求缺少 `completion_mode` 时按 `standard` 恢复。当前普通新请求默认自主直写，详见 [默认行为](default-behavior.md)。选择 `draft_first` 才启用旧“先交初稿”流程；旧任务的 `research_tier=quick` 不会因此改变行为。研究深度、预算、篇幅与完成方式分别选择，不把“短报告”或“单轮研究”当作核验已经完成。
 
 先交初稿未明确填写时间时，目标为约 10 分钟；明确填写的目标优先。这是软目标，超过目标仍继续正常写作，不中断作者、不删减必要内容。原有显式硬截止设置仍按用户配置执行。
 
@@ -77,3 +80,6 @@ PYTHONPATH=src python probes/fast_report_smoke.py --out /path/to/new-output \
 ```
 
 该入口不会调用 Jev、联网搜索或读取个人报告。`tests/test_fast_qualifier_checks.py` 另验证 fast 和 fast_web 的冻结核查范围、缺失检查与矛盾回执；这些离线检查只证明程序行为。实际语义质量仍须回读保存的稿件与来源，L1/L2 题库的历史分数不能直接算为本版本验收。
+
+已绑定正文和来源的检查任务失败后，可选择“按当前模型重试”。此操作通过现有恢复入口创建关联的新任务，
+保留原失败记录，冻结当前模型与角色配置，重新完成依据和评价，不重新写稿。若原材料变化或报告另有检查在执行，需先处理后再重试。

{briefloop-0.31.3 → briefloop-0.31.6}/docs/jev-precheck.md

@@ -1,13 +1,14 @@
 # Jev 依据预检（可选）
 
-在稿件右侧「检查与评价」展开「Jev 依据预检」。先查看所选稿件中将发送的结论、来源标题、摘录及上下文，再点击开始。快速稿需先完成后台补依据；旧稿如果只有来源链接、没有对应的正文原句，会明确显示未进入预检的引用数量。
+在稿件右侧「检查与评价」展开「Jev 依据预检」。先查看所选稿件中将发送的结论、来源标题、摘录及上下文，再点击开始。数字绑定与普通引用都能进入预检，数字单位或计价分母尚未被程序识别也可以送交Jev。快速稿需先完成后台补依据；只有来源链接、没有可定位正文或摘录的内容会列为未进入预检。
 
 Jev 使用独立的 TypeSafe API Key，与写作模型、OpenCode Go 或其他宿主额度无关。可在面板中保存本机密钥，或给服务配置 `TYPESAFE_API_KEY`；环境变量优先。保存密钥不调用服务。密钥不放入工作区、请求材料、任务记录或浏览器响应，实际调用由后台 HTTP 客户端发起，不向 Agent 开放主机文件工具。
 
 ## 行为与结果
 
-- 默认不自动执行。用户确认后，只发送页面列出的结论及其完整所选上下文，不发送整份报告、其他工作区、原始运行日志或思考内容。
+- 默认不自动执行。用户确认后，只发送页面列出的结论、所在正文段落及其完整所选来源上下文，不额外发送其他工作区、原始运行日志或思考内容。
 - 同一句依赖多个来源时一起预检。有来源不能定位，不悄悄丢弃后再判断支持；该句保持尚未核查。正文中尚无绑定的其他结论不在覆盖范围内。
+- 数字项目按报告原句和来源上下文作语义判断，不把作者填写的预期数值当作事实。来源位置、原文与版本仍由程序验证，语义结果与原有数值机械匹配分别显示。
 - 返回「候选：证据支持」「候选：证据矛盾」「候选：证据不足」「候选：无法判断」，请求没有有效结果则显示「尚未核查」。摘录不含某事实不等于事实错误。
 - 记录实际模型、公开概率分布、服务返回的输入/输出 token 和请求耗时。概率未经本任务校准，不是真实性概率；缺少 usage 时保持未知，无账单不推算费用。
 - 结果按稿件版本和发送材料指纹保存。来源或协议变化后，旧观察明确标为过期。新稿不继承旧稿的结果。
@@ -21,3 +22,5 @@ Jev 使用独立的 TypeSafe API Key，与写作模型、OpenCode Go 或其他
 相关自动检查使用合成材料验证授权、上下文、版本绑定、重复请求、失败保留与公开字段投影，不代表真实语义准确率或服务已连通。真实 Jev 调用需单独记录；未验证时不把本机配置成功写成模型验收。
 
 `experiments/jev_semantic/` 保留开发/留出、概率和对照研究工具，输出仍是研究观察。它不替代本面板的产品任务，也不能用其分数自动放行报告。
+
+报告上下文只用于理解待核查句子的主体、期间与限定词，不能作为独立证据。按空行切分（含 CRLF），原句前后各最多保留 500 字符；完整待核查原句仍会发送。重复出现的普通引用保留核查但不补任意一处上下文，数字标签无法定位时不计入数字覆盖。

briefloop-0.31.6/docs/release-0.31.4.md

@@ -0,0 +1,14 @@
+# BriefLoop 0.31.4
+
+这次更新收敛报告入口，并补齐改稿、核查和经验学习之间的连接。
+
+- **新报告减少模式选择。** 保留材料范围、研究投入和篇幅；普通报告默认自主直写，季度、连接器等任务自动选择所需流程，已保存任务的配置保持。
+- **BriefLoop Agent 使用 Pi 1.2.0。** Native 思考档位正确传递，修订材料减少重复，原稿、来源及问题记录保留。
+- **改稿后继续检查。** 反馈与实际消息、稿件版本绑定；只改引用也进入待复查。检查失败重试复用同正文的证据子稿，核查预算只能追加到对应版本。
+- **经验学习更容易发现。** 新工作区默认选择学习意图，首次确认调用预算后才执行；旧工作区关闭选择保留，候选方法仍须经过验证才能采用。
+- **数字可通过已有 Jev 接口做语义核查。** 不必先满足 Python 的单位解析；发送前可预览原句及来源，上下文只解释待核查句，不作为证据。仍由用户主动启动，结果与机械核查分别展示。
+- **日常体验修复。** 设置页返回原页面和滚动位置；Windows 接受带 UTF-8 BOM 的 Codex 配置。
+
+保留原有工作区、稿件、来源及评分历史。Jev 判断不等于全稿核验，未知与证据不足保持可见。外部 CLI 未提供可靠消息回执的修订仍需在报告页手动检查。
+
+Mac、Windows 与 Python/CLI 复用同一冻结后端 wheel。正式渠道与实际安装状态以发行验收记录为准。

briefloop-0.31.6/docs/report-revisions.md

@@ -0,0 +1,34 @@
+# 报告反馈与修订
+
+在报告右侧聊天提出反馈时，BriefLoop 先保存编辑稿，再将选中的版本与这条消息关联。
+普通聊天与“开始下一期”沿用各自上下文，不会自动修改刚浏览过的报告。
+
+## 补资料
+
+已允许联网的报告，可在联网消息中继续补查。宿主根据真实用户消息开启修订研究阶段，沿用报告剩余预算。
+初稿的研究轮次与已用额度保持原样；费用、来源和请求归入本次修订阶段。
+阶段随消息完成、停止或中断结束，过期请求的返回结果不能进入下一次修订。
+额度不足时保留已有稿件和材料，显示具体缺口。
+内置引擎在宿主接纳本条报告消息后提供受控搜索与网页读取工具；普通聊天不会继承上次报告消息的补查权限。
+
+## 改稿后的依据
+
+每次修订保存新版本。仅调整颜色或格式时保留已有依据；正文改变后，只继承能定位到原样保留段落的数字、日期和逐句引用。
+原稿仍保留完整历史。新版中失效的逐句绑定移除，来源、原文摘录与定位继续可查。
+
+报告聊天完成一次实质改稿后，默认直写路径自动安排新版依据补全和评价，关闭该检查的自动改稿，避免循环重写。
+补全使用新版实际引用的来源快照，包括本次新取的原文；正文保持不变。
+检查结果区域显示“正在补全”或“待重新检查”。失败时保留新版，可通过既有检查任务恢复。
+Native 检查沿用选中的思考档位；失败检查可选择按当前模型新建重试，保留原失败记录且不改正文。
+
+手动编辑只更新稿件和依据状态，不因每次保存启动模型。
+来源定位、事实判断和用户采用仍分别记录；低分或待检查的工作稿可继续编辑、下载。
+
+启用事实核查时，直写稿的依据补全会从可确认的公开原件中选择少量待核查事实，绑定到原样正文后交给独立核查。
+材料或候选不满足准入时，检查栏说明当前版本尚未核查的原因。候选登记和逐字定位都不表示事实已经正确。
+
+## 后续使用
+
+作者按读者需要检查重要遗漏和篇幅分配，保留关键数字、比较对象及适用条件，研究操作记录放在工作区。
+已核实的反馈通过既有 WikiSkill 方法验证进入学习；“下期沿用”保存用户认可的写作约定。
+下一期沿用方法与约定，重新研究当期事实。

{briefloop-0.31.3 → briefloop-0.31.6}/docs/revision-learning.md

@@ -4,6 +4,10 @@
 
 ## 当前行为
 
+新工作区首次选择模型时默认勾选自动学习，页面显示当前模型与角色的实际调用预算。点击“开始使用并开启自动学习”保存授权后才真正开启；可取消勾选，也可随时在报告选项关闭。
+已有工作区保存的关闭选择不会改变，旧版缺少该设置时仍按关闭处理。更换模型、执行后端或角色配置后沿用原有重新确认门槛。
+默认 K=1；明确长期要求仍可能进入既有的第二轮，页面预算同时列出该上限。
+
 - 按正文块拆分改动，Evaluator 对照来源判断口味、事实纠错、读者特定，保留理由与判断者。事实纠错不进入写作技能。所有不确定改动先隔离；较大改动集中提问，小改动在经验页可选确认。人工确认只作为新的反馈消费一次。
 - 读者档案只记录名称、决策用途与偏好，报告冻结当时档案，刷新保持选择。读者专属反馈保留待学习，不进入全局技能；历史独立读者技能及其派生版本不能全局启用，原记录保留。
 - 离线比较保留的候选仍可按原机制用于报告，但“用于报告”和“证明跨期有效”是两个状态。后续单次模型标记只显示初步线索；交付、空 repeats、跳过及未评估均不证明未复发。不自动标为已采用或没有改善，不编造基线和复发率。

{briefloop-0.31.3 → briefloop-0.31.6}/docs//344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -59,7 +59,10 @@ Tavily、博查和智谱搜索分别需要 Key。优先读取 `TAVILY_API_KEY` /
 
 ## 预算和覆盖
 
-周报预设为 30 次搜索尝试／150 个候选 URL／60 个全文来源 URL；月报为 80／400／150。三个数可修改，0 表示不提供该类新增额度。它们随本次报告保存，由所有 Scout 共享。
+新报告自动安排流程，不需要选择直写、标准或快速模式。研究选项保留“已有资料／允许补搜”、轻量／常规／深入的研究投入和事实核查。
+普通报告由同一作者研究成稿；连接器、季报等特殊任务自动使用所需工具。旧任务恢复继续沿用原配置。
+
+周报预设为 30 次搜索尝试／150 个候选 URL／60 个全文来源 URL；月报为 80／400／150。三个数可修改，0 表示不提供该类新增额度。它们随本次报告保存，由本任务所有研究步骤共享。
 
 工具调用前以数据库事务预留额度，失败的搜索仍计次。并发结果超过候选额度时，未纳入的 URL 会明确列出，完整提供方响应保留在本地 discovery 记录中。已成功取得的同轮 URL 可复用；跨轮不默认用旧快照。同一 URL 的直接失败、Extract 回退和重试只占一个全文 URL，但可能有多个 HTTP 尝试。
 
@@ -73,7 +76,9 @@ Tavily、博查、智谱搜索和 DuckDuckGo 的受控搜索请求与候选共
 
 原稿和修订各自保存，评分绑定具体稿件内容。旧评分不自动套用到改写后的稿件。Evaluator 的四维分数与具体问题可供参考，用户可以不同意；低分不会隐藏正文。
 
-评论和人工改稿都可成为反馈，保存反馈本身不调用模型。自动学习默认关闭：开启或手动启动时会列出本批的调用上限（历史报告数、轮数、试写次数上界、执行后端与模型，费用未知则标为未知），确认后才启动，确认绑定当时那份计划；旧工作区升级后（包括已排队的批次）需要重新确认一次，调高轮数或更换后端、模型后会暂停到再次确认。开启后，服务在编辑静默约 30 秒后合并一批。Wiki Maintainer 整理经验，Skill Proposer 提出技能，再由实际产物比较决定是否采用。Wiki 保留经验，不作为本期事实来源。
+评论和人工改稿都可成为反馈，保存反馈本身不调用模型。新工作区首次选择模型时默认勾选自动学习，点击开始时确认调用预算后才开启；可取消勾选，既有明确关闭的选择保持关闭。
+开启或手动启动时会列出本批的调用上限（历史报告数、轮数、试写次数上界、执行后端与模型，费用未知则标为未知），确认后才启动，确认绑定当时那份计划；旧工作区或已排队批次缺少有效授权时，启用学习前需要确认一次，调高轮数或更换后端、模型后会暂停到再次确认。开启后，服务在编辑静默约 30 秒后合并一批。
+Wiki Maintainer 整理经验，Skill Proposer 提出技能，再由实际产物比较决定是否采用。Wiki 保留经验，不作为本期事实来源。
 
 K 控制一次反馈学习最多尝试多少轮；轮数越多消耗的 Token 和耗时越多，候选越好会提前结束。候选已产生但验证暂停时仍可查看；继续验证会调用模型。恢复会沿用该任务原来的模型与后端；要改用当前设置，请新建任务。
 

{briefloop-0.31.3 → briefloop-0.31.6}/docs//346/267/261/345/272/246/347/240/224/347/251/266/344/270/216/344/272/213/345/256/236/346/240/270/346/237/245.md

@@ -1,16 +1,18 @@
-# 深度研究与事实核查
+# 研究投入与事实核查
 
-0.21.0 的研究选项与 Word 版式相互独立。新建报告时先确定用途、读者和材料，再选择研究深度；选择模板不会自动开启联网或事实核查。
+新报告自动安排研究与写作流程。用户确定用途、读者和材料，再按需要调整研究投入；Word 模板与联网、核查分别设置。
 
-## 研究深度
+## 研究投入
 
-| 档位 | 研究组织 | 页面带入的默认预算：搜索请求 / 候选 URL / 全文来源 |
+| 档位 | 用途 | 页面带入的默认预算：搜索请求 / 候选 URL / 全文来源 |
 | --- | --- | --- |
-| 快速 | 单轮检索 | 6 / 30 / 12 |
-| 标准 | 最多三轮，按缺口补查 | 30 / 150 / 60 |
-| 深度研究 | 预排四轮，逐轮交接发现与追问 | 80 / 400 / 150 |
+| 轻量 | 小范围问题、较少补搜 | 6 / 30 / 12 |
+| 常规 | 日常报告 | 30 / 150 / 60 |
+| 深入 | 较广范围或复杂比较 | 80 / 400 / 150 |
 
-这些数字是起始设置，用户可在研究预算中修改。任务开始后冻结实际档位、预算、宿主与搜索源；恢复已有任务继续使用原配置。多轮不保证一定能找到更多有效材料；达到预算上限会留下当前结果与缺口，不自动加额。
+这些数字是起始设置，期间和用途也会影响默认预算，用户可以修改。任务开始后冻结实际投入、预算、宿主与搜索源；恢复已有任务继续使用原配置。
+普通报告由同一作者检索与写作。需要分工的特殊任务采用内部标准流程，轻量、常规、深入分别提供一、三、四轮的计划上限。
+研究投入不保证实际轮数或质量；达到预算上限会留下当前结果与缺口，不自动加额。
 
 在「设置 → 运行与搜索」选择宿主原生搜索、Tavily 或 DuckDuckGo。DuckDuckGo 无需填写搜索 API Key，但模型调用仍由所选宿主和账号计费，搜索服务也可能限流或失败。Tavily 使用其配置的凭据；原生搜索能否联网由宿主能力和权限决定。受控搜索记录请求与来源用量，原生宿主搜索不宣称精确计量全部搜索次数。