briefloop 0.28.4__tar.gz → 0.30.0__tar.gz

{briefloop-0.28.4 → briefloop-0.30.0}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # 变更记录
 
+## 0.30.0
+
+- 目标驱动研究按用户关键问题保存覆盖判断、原文依据和未答范围；旧冻结任务按原契约恢复。
+- 任务的研究过程展示「有依据／部分有依据／尚待回答」，可打开保存的来源；这些状态不是独立核查结论。
+- 目标驱动允许集中问题由主 Agent 直接研究，不再因零初始材料强制创建 Scout；独立支线仍可按需委派。
+- 修复 DuckDuckGo 忽略每次查询结果数，导致并行查询抢占其他关键问题候选额度；完整原始回执继续保留。
+- 快速检索按实际搜索渠道校验查询，不再把智谱的70字符限制套用到其他渠道。
+- 网页读取识别 gzip 压缩响应并限量解压，保留原始响应与解压内容校验值；损坏或解压超限记为失败，不再把压缩乱码记作正文。
+- 识别返回 CAPTCHA 的“Request Access”网页，保留拦截原件并显示读取失败。
+- 默认仍为分轮研究；公开联网小样本对照未证明目标驱动稳定更快或质量不退步，继续提供试用选择。
+
+## 0.29.1
+
+- 0.29.0 草稿未公开发行；本版包含其已合并的新建报告、下一期、写作约定与经验反馈改动。
+- 标准报告增加可回退的「按目标补证（试用）」研究方法；由问题和证据决定下一步，保留预算、轮次与交付控制。
+- 各执行端的主 Agent、Scout、Analyst、Evaluator 使用按角色组织的目的、证据入口、方法和边界导航；保留原始要求与历史快照。
+- 没有据此宣称质量、速度或 Token 收益，默认仍沿用分轮研究。
+
+## 0.29.0 — 2026-10-09
+
+- 新建报告优先进入普通对话；首页可导入旧报告，完整表单仍可直接使用。报告页可开始下一期，沿用已保存的读者与结构，不自动复用旧事实和授权。
+- 明确写作要求可在报告页直接保存为约定，限定当前报告系列或主动扩展到工作区；支持撤销和本期跳过。生成前核对往期版本，避免把无关报告挂入旧系列。
+- “留下经验”与“下期沿用”共用输入框：前者进入原有 WikiSkill 验证链，后者直接保存约定。学习进度和真实采用结果保留在报告页，持平不宣称改善；修复试写预算继承及失败收尾。
+- 接纳本地图文文章包，保留正文、原图对应、缺图和重复图片记录；普通 Markdown/HTML 仍按文本处理，不因远程 logo 要求视觉读取。图片可用不代表已读图或已核实。
+- Codex 会话历史独立存放，减少 BriefLoop 后台任务出现在个人 Codex 列表中的干扰；来源库新增可恢复归档、报告范围浏览和最新优先排序。
+- HTML/PDF 导出与报告来源、版本、检查和审阅状态一致，引用可回查；修复聊天布局、Scout 状态、推理选项保存和来源预览切换。
+- SQLite 日志模式按实际环境显示并检查兼容性；旧桌面环境仅在确认未使用时清理。评价研究工具和候选规则保留验证边界，不承诺已证明稳定质量提升。
+
 ## 0.28.4 — 2026-10-02
 
 - 对话 Agent 可以通过正在运行的服务停止指定任务及子任务，保留已保存稿件，并返回实际停止状态。

{briefloop-0.28.4 → briefloop-0.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.28.4
+Version: 0.30.0
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT

briefloop-0.30.0/VERSION

@@ -0,0 +1 @@
+0.30.0

{briefloop-0.28.4 → briefloop-0.30.0}/desktop/electron/package-lock.json

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

{briefloop-0.28.4 → briefloop-0.30.0}/desktop/electron/package.json

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

briefloop-0.30.0/docs/article-materials.md

@@ -0,0 +1,28 @@
+# 图文资料与下一期报告
+
+开发中的 0.29.0 能力，尚不表示已发行。
+
+## 从现有入口开始
+
+“新建报告”打开普通对话，可以直接说需求、添加材料。首页“导入旧报告”沿用现有 Word/Markdown/TXT 导入，保留 Word 修订记录；“自己填写要求”仍可打开完整表单。
+
+报告页的“开始下一期”准备一条未发送的对话，显示所选报告。只需补本期时间、重点变化或材料；约定从该报告的已保存版本读取，当前回合使用自己的模型、材料、联网和费用选择。点击入口不会启动任务。可以取消关联；刷新会恢复尚未发送的关联草稿。
+
+## 本地图文资料
+
+直接用附件或数据源的文件入口上传：
+
+- 含一篇 Markdown 或 HTML 正文及其图片的 ZIP。图片按正文里的相对链接对应，无需编写清单。目录关系应保留。
+- Link2Context 0.1 的 `context.json`。如已有图文资料包，可连同包内图片及对应关系一起上传 ZIP。
+
+一次 ZIP 对应一篇正文，多篇请分别上传。当前沿用来源上传的文件大小上限；不在线下载缺图、不执行包内脚本、不自动运行 OCR。原始 ZIP/JSON 会保留。
+
+来源面板展示正文、发布信息、每张原图的原始图号和读取状态。展开一项才加载其预览。相同字节的图片会提示核对用途，不据此认定其内容真假。缺图、损坏及不支持的图像格式明确列出；图片可解码不代表模型已经查看或理解。PNG、JPEG、WebP 使用现有媒体校验；其他格式保留在原件内。
+
+Link2Context 的远端图片 URL 本身不能证明本地缓存对应关系。包内的 `local_path` 必须是相对路径；已有按文章标题索引的 `media-map.json` 可对应 `doc<ID>-image<图号>-<hash>` 缓存文件。找不到对应关系时保留缺口，不根据目录里相似的图片名猜配。独立上传 context.json 不会读取其中的外部本机路径。
+
+## 方法和学习
+
+经营复盘及决策分析沿用既有文档方法快照。新方法强调期间与口径可比、分项归因不重复、差额与总数冲突保留，以及投入/合同额/利润等 ROI 口径区分。旧任务继续使用其冻结方法。
+
+保存改稿、模型整理反馈、候选技能启用和下期效果是不同结果。学习仍遵守当前工作区预算授权；事实纠错不能变成通用写作规则。真实效果对照尚待完成，不以静态检查或方法文本变化宣称报告质量已提高。

briefloop-0.30.0/docs/codex-history-isolation.md

@@ -0,0 +1,29 @@
+# Codex 会话历史隔离
+
+BriefLoop 的 Codex app-server 使用独立、持久化的 `CODEX_HOME`。默认位置是用户目录下的 `.config/briefloop/codex-homes/<原 Codex 目录摘要>`，不在报告工作区内。SQLite 状态和日志也指向该目录，避免原配置里的 `sqlite_home` 将新会话写回个人历史。
+
+这是历史存储隔离，不是权限沙箱：原有审批策略、文件访问和联网边界不变。没有使用 ephemeral 会话，也没有关闭恢复记录。
+
+## 登录与配置
+
+文件登录模式通过符号链接沿用原 Codex 的 `auth.json`；不复制密钥到工作区，也不将凭据写进日志。用户配置、独立配置档及常用规则/技能目录也使用链接。目录内只复制明确需要恢复的旧会话文件，不复制整套个人历史、记忆或数据库。
+
+密钥链、auto、ephemeral 登录不能据此假设可跨 home 复用。无法建立文件链接的系统（例如未启用符号链接权限的 Windows）也不会静默回到共享历史。可用 `BRIEFLOOP_CODEX_HOME` 指向一份**已经独立配置和登录**的 Codex home；此时 BriefLoop 不覆盖或链接其中的配置/凭据。先使用该目录作为 `CODEX_HOME` 完成正常 `codex login`，再启动 BriefLoop。原个人登录不退出、不覆盖。
+
+具有额外相对路径的自定义配置必须在独立目录中验证，或改为明确的绝对路径。自定义目录应位于报告工作区之外。独立目录不能与原 Codex home 相同或位于其内部。
+
+## 原有会话
+
+继续旧对话时，仅按 BriefLoop 保存的 thread ID 定位旧 rollout，复制到独立目录后交给 Codex 恢复。原件保留；已有独立副本不会被覆盖。检测到复制期间原文件仍有写入会中止迁移，而不是带着已知不完整记录继续。请勿在两个客户端同时推进同一个旧会话。
+
+本改动不会批量删除或归档个人列表中的旧条目。它们需要依据 BriefLoop 的确切会话绑定另行整理，不能按标题相似就删除。新产生的线程不再写入原目录。
+
+## 验证范围
+
+2026-10-09 在 macOS、Codex CLI 0.159.2 上使用本地合成 Responses SSE 服务验证：新私有线程不出现在原 home 的 thread/list 中；关闭 app-server 后可重新恢复并继续；已绑定旧线程可导入继续，原 home 的文件保留。响应由本机模拟服务返回，没有调用真实模型或消耗额度。
+
+另外验证了本机现有 ChatGPT 文件登录在独立目录中仍被 `account/read` 识别，仅记录认证状态，不记录凭据。使用临时目录和虚构 API Key 验证 CLI 保存登录时保持 auth.json 链接；没有改动真实登录。
+
+实际浏览器验收使用独立合成工作区、现有 Codex 文件登录及宿主默认模型：通过页面选择模型、发送消息，停止并重启预览服务后重新打开同一对话，第二轮正确返回首轮测试代号。两轮均完成且 thread ID 不变；专用目录有该线程，个人 sessions/archived_sessions 与 SQLite 中没有，官方近期线程列表也未列出。Codex 原生窗口不允许电脑操作工具访问，因此未声称完成其侧栏的视觉验收。
+
+Windows 实机、密钥链独立登录、真实 OAuth 过期刷新以及发行 App 更新路径尚未验收；Windows 单元 CI 不等于完整登录验收。非文件登录或缺少符号链接权限的安装需先按上述独立 home 流程配置；升级前必须说明这一兼容性要求。代码合并不代表正式安装已升级或所有平台已就绪，剩余验收继续由 #906 跟踪。

{briefloop-0.28.4 → briefloop-0.30.0}/docs/quality-reading-context.md

@@ -13,3 +13,19 @@ Native 主 Agent 的 `write_report` 在 `quality_v1` 下先检查已冻结计划
 open/partial 缺口、预算耗尽、深度计划中尚未开启的 pending 轮次均不阻止明确收轮后写稿。旧 closed outcome 没有新增 closeout 字段或 summary 为空，仍按原收轮记录兼容；legacy 协议沿用旧路径。这个检查证明主 Agent 留下了收尾记录，不证明候选覆盖完整、二手消息已核实或报告事实正确。
 
 本次行为检查覆盖实际阅读输入、任务包篡改拒绝、旧软篇幅快照兼容、研究收尾冻结与来源导出。它们证明信息传递和版本绑定，不证明模型已降低误报、完整补查或提升阅读质量；相关真实模型与人工验收仍需单独记录。已发布版本及旧实验不作追溯修改。
+
+## 保存时的缺口与本次核查的研究状态
+
+评分、修订和新建的审阅包现在同时保留两组记录：`research_context.saved_report` 是被处理稿件保存时的 gaps/gap_records；`current_research` 是该任务包生成时，应用依据显式 gap_updates 和可定位依据投影出的当前 open/partial/resolved 记录。两者绑定原稿 ID/hash，并保留当前研究状态的内容哈希。审阅包另存 `research-context.json`，纳入已有文件指纹校验。
+
+此改动修复评分只看到旧“未取得”提示、没有取得最新解决记录的问题。它不覆盖旧稿 gaps，不将后来材料伪装为写稿时已知，也不自动更改评分、审阅或正式交付状态。resolved 仍然是研究 Agent 的带依据判断，Evaluator/Reviewer 要回读来源判断支持范围；没有显式更新、来源仅仅入库或当前记录为空，都不能证明缺口已解决。依据失效会重新显示 open。
+
+修订继续检查摘要、正文、表格和影响段的同因残留，保留主体、期间、计划/生效、公测/正式可用等条件。新上下文只提供核查信息，不增加评分维度、机械语义规则、联网权限或修订轮次。旧冻结包保持原样。
+
+验证是隔离合成材料上的真实任务包生成、版本不变及定位校验；尚未新增真实模型对照，不能宣称语义错误检出率或实际报告质量改善，#816 保持开放。
+
+## 检查记录与剩余发现一致
+
+新评分保存时，明确通过 `check_ids` 关联到剩余发现的检查不能同时显示“全部通过”或“不适用”，包括旧格式的 `result` 字段。应用保留原始结果，另记为需要处理，不改变总评分或发现严重程度。若本次提供了检查清单，但发现关联的 ID 未返回，额外显示一条“尚未复核”记录；不按名称或文字猜测应关联哪个检查，也不修改无关检查的通过状态。
+
+这些规则仅检验模型自己提供的结构关系，不推断无关联发现的语义，也不自动启动额外修订。既有已保存记录不迁移或覆盖；验证使用隔离合成评分的保存与重读，不代表真实报告语义验收。

briefloop-0.30.0/docs/release-0.29.0.md

@@ -0,0 +1,9 @@
+# BriefLoop 0.29.0
+
+本版将新建、旧报告导入、下一期复用、明确写作约定和经验反馈串成直接可操作的路径。已合并的 HTML/PDF 导出、来源归档、Codex 历史隔离和状态修复一并发行，具体变化见 CHANGELOG。
+
+写作约定是用户要求，WikiSkill 是需要试写比较的方法候选；两者分开保存。当前合成对照中的一次学习比较持平，候选未采用，不能据此宣称写作质量稳定提高。图文包入库、原图可用和模型实际读图同样是不同状态。
+
+发行复用一个冻结提交和一份共享 wheel，Mac、Windows 与 PyPI 不分别重建后端。正式渠道就绪前不把冻结验收包替换日常安装；各平台实际验收与哈希记录随 release 工件提供。公开下载页和更新索引在发布后同步，用户工作区保留。签名/公证与未测项以实际随包记录为准。
+
+开发验证包括实际浏览器入口、反馈保存和下一期操作，以及服务端作用范围/冻结/失败恢复测试。模型质量试点不代替桌面发行验收；CI 构建的临时包不是正式共享工件。

briefloop-0.30.0/docs/release-0.29.1.md

@@ -0,0 +1,7 @@
+# BriefLoop 0.29.1
+
+包含未公开发行的 0.29.0 FDE 改动，以及按角色组织的任务上下文和可回退的目标驱动研究试用。操作说明见 [研究目的、上下文与方法](research-context.md)。0.29.0 未成为公开稳定发行，本次不复用其旧工件。
+
+新建/往期导入/下一期、明确写作约定与「留下经验」入口分别保留。约定不是事实，WikiSkill 方法候选仍需真实反馈和试写比较。
+
+发行按同一提交冻结，共享后端只构建一次，Mac/Windows/PyPI 复用同一 wheel；以各平台实际验收、工件哈希和渠道记录为准，候选不替换正式安装。小型合成验收不是质量收益对照。

briefloop-0.30.0/docs/release-0.30.0.md

@@ -0,0 +1,25 @@
+# BriefLoop 0.30.0
+
+本页说明本轮变更；渠道发布与安装状态以正式发行清单为准，开发分支上的文档不表示已经发布。
+
+## 本轮改进
+
+标准生成中的「按目标补证（试用）」现在围绕本轮关键问题保存研究判断、原文定位、未答部分和收束理由。在任务的研究过程中直接查看，点击来源回读保存的正文。材料不足时仍可交出明确受限的工作稿；“有依据”不等于已经独立核查。
+
+主 Agent 可以直接研究集中问题，也可以按需要委派独立支线。不再仅因为初始来源为空就强制创建 Scout。任务的预算、允许渠道、停止和恢复以及既有独立评价、修订和正式交付规则继续有效。
+
+本轮修复三个会妨碍检索或读取的问题：DuckDuckGo 单次返回过多候选挤占其他查询额度；把特定搜索渠道的查询长度限制套用到其他渠道；gzip 压缩网页和部分访问验证页被错误当作可用正文。压缩网页保留原始响应和校验值，损坏或解压过大时显示失败。
+
+本版同时包含0.29未公开发行阶段已合并的新建报告、下一期约定、经验反馈和图文包导入等改进；详细变化见[变更记录](../CHANGELOG.md)。
+
+## 默认设置与边界
+
+默认仍为分轮研究。公开联网对照结果随题目变化，小样本没有证明目标驱动稳定更快或质量更高，因此不将试用模式自动改成默认。研究状态帮助解释过程，不能替代阅读实际稿件和证据。
+
+联网快速模式仍是一轮有限检索、初稿保存、补依据与评价，不能保证复杂报告的必答问题全部覆盖，也不使用标准流程的研究策略开关。本轮真实复测保留了检索失败及未运行样本，没有用补跑成功稿掩盖失败。详细使用说明见[按目标补证](目标驱动研究.md)。
+
+原文读取成功也不保证内容完整：动态网站可能不返回所需表格，来源引用和时间、口径仍需核对。检索失败时不会凭搜索摘要生成没有原文支撑的报告。
+
+## 发行一致性
+
+Mac、Windows、Python/CLI 必须复用同一冻结提交构建的一份后端 wheel；各平台独立完成实际启动、保存、导出和升级核验，再统一公开。发布后沿正常升级流程替换日常安装，不把开发候选安装成多个正式 App。

briefloop-0.30.0/docs/research-context.md

@@ -0,0 +1,22 @@
+# 研究目的、上下文与方法
+
+标准报告的「研究选项 → 研究方法」和新建报告表单提供两种选择：
+
+- **分轮研究**（默认，`guided`）：沿用现有侦察、聚焦与补缺建议。
+- **按目标补证**（试用，`goal_driven`）：从读者问题与现有证据出发，决定继续、集中处理一个冲突、换已授权来源或停止。材料充分时无需额外检索；不按周报/月报凑 Scout 数，不强制第一批查询数或执行三轮。
+
+选择只对本报告生效，创建任务后保存在 requirements；恢复沿用原选择，旧任务缺少此字段仍走原策略。快速模式有自己的生命周期，本选项不改变快速模式行为。试用不是质量优势的承诺，也不会自动切换现有报告。
+
+## 给角色的上下文
+
+`task_context` 是对既有任务包的阅读导航：purpose（目的）、knowledge（证据和未知的入口）、method（方法建议）、boundaries（实际边界）。它不创建新的事实摘要、知识库、权限或评分结果。
+
+主 Agent 看读者目标、来源索引、当前研究交接和实际预算；Scout 只拿分配的问题、当前交接、来源入口和对应检索技能；Analyst 看当前证据/缺口、读者要求与写作技能；Evaluator 独立看实际正文、原文及保存时/当前研究状态，不接收检索技能，也不把作者的解释当事实证明。CLI 通过文件读取，内置引擎通过任务包读取，语义一致。
+
+原始用户要求、来源快照和版本仍是权威。研究中的新认识可以通过原有研究交接和缺口更新推进；不会改写旧稿保存的研究状态。Wiki/历史稿属于经验和背景，不充当本期证据。
+
+## 保留的控制
+
+共享预算、最大轮数、并发和渠道权限保持不变。深度目标研究不预分配未用 Scout/轮次，但仍受所选深度最大轮数约束。收轮必须在既有 summary（或 early_stop_reason）说明继续/停止依据；程序检查记录存在，不替模型判定证据充分。已承诺的 Scout 仍须有结果或失败/跳过原因。写前交接与收轮、来源定位、稿件版本、独立评价/审阅、最多一次自动修订和正式交付门禁不变。
+
+本轮没有做质量对照；小型合成闭环用于验证真实运行，不能证明报告更好、减少 Token 或加快执行。以后可在冻结材料和同一模型下分开比较上下文与策略的效果。

briefloop-0.30.0/docs/source-library.md

@@ -0,0 +1,11 @@
+# 数据源库的归档与筛选
+
+数据源库默认显示日常来源，最新入库的在前；可切换已归档/全部、报告、来源类型、发现渠道和读取状态。每次显示 50 条，继续加载只增加列表呈现数。正文搜索另行按有限候选分批扫描，显示扫描进度；“继续搜索”不等于“显示更多已有结果”。
+
+归档是可恢复的资料库整理动作，不删除文件、不修改提取状态、不释放磁盘空间。单条菜单或多选操作均可归档和恢复，每次最多 200 条。旧报告、冻结任务、引文和原文快照继续使用原 source_id；归档不使旧证据失效，也不把它认证为新一期事实。
+
+新页面初始化时，新报告的默认选材排除已归档来源。已经选择的来源保持选择，并显示归档标记；用户仍可显式选择已归档材料。归档不静默修改进行中的表单和任务。
+
+按报告筛选使用该报告实际登记的 source_ids（包括后续研究取得的来源），不依赖首页最近几份报告的截断清单。报告选择器分批读取历史报告，当前热状态中的待成稿报告也可选；来源范围独立生效，查看某份旧报告的完整资料时可切换“全部来源”。
+
+本次只限制 DOM 中呈现的行数；现有 state 中的来源元数据仍完整返回。没有自动归档、按日期删除、磁盘回收或新的模型调用。

{briefloop-0.28.4 → briefloop-0.30.0}/docs/sqlite-benchmark.md

@@ -2,7 +2,11 @@
 
 本页仅针对 BriefLoop `Store` 使用的 **`briefloop.db`**。内置 Agent SDK 可以有自己的数据库和 journal 配置，本测量不代表整个 App 的所有 SQLite 数据库都采用同一模式。
 
-目前没有根据这些有限结果修改生产事务或启用 WAL。没有预先复现数据库损坏事故，也不应把没有启用 WAL 本身描述为错误。工作区原数据、模型任务、网络服务均不参与下面的合成基准。
+当前 `Store` 已随 #854 加入有条件 WAL：SQLite 3.51.3+、3.50.7–3.50.x、3.44.6–3.44.x 通过现有版本门槛时，在初始化后尝试启用 WAL，并报告实际模式。其他运行库不会主动启用 WAL；文件系统不支持或锁占用使切换失败时，保留原模式。下面 2026-09-28 的 DELETE 基准是实现前的历史结果，不是当前所有工作区的默认模式。
+
+WAL 是数据库的持久设置，换用另一 Python 解释器不会自动恢复 DELETE。未通过上述门槛的运行库在已有 WAL 工作区上初始化或写入时，会在事务内、应用写入之前报兼容错误；请使用含 WAL 修补的 Python 运行库重新打开。产品不自动降级日志模式，也不删除 `-wal` / `-shm`。已有已提交数据保留，受支持运行库仍可打开和写入。
+
+这些门槛沿用 [SQLite 官方 WAL-reset 说明](https://sqlite.org/wal.html#walreset)的修复版本范围，不代表所有文件系统、发行环境或掉电场景已经验证。本次合成回归没有复现数据损坏，不能将兼容缺口描述成用户数据库已损坏。工作区原数据、模型任务、网络服务均不参与下面的合成基准。
 
 ## 运行便携基准
 
@@ -75,4 +79,4 @@ python scripts/benchmark_store_sqlite.py diagnose --database /path/to/workspace/
 
 当前便携入口另以每进程 5 次、1/4 进程作一次小验证：25 次新稿及25次重放，来源/事件/内容、异常退出恢复及静止备份还原均通过，无锁错误。这只说明新入口可运行，不用于证明稳定性能改善。
 
-仍未验证 Windows 发行运行库、网络文件系统、WAL 对照及持续写入下的多文件热备份。没有真实模型调用，也没有模型吞吐或用户报告质量结论；当前证据不足以建议为了提速直接启用 WAL。
+上述历史基准没有覆盖 Windows 发行运行库、网络文件系统、WAL 对照及持续写入下的多文件热备份。#854 后续有条件 WAL 和长读期间写入/备份行为已有实现与回归（`tests/test_store_wal.py`），不将它们混入上述历史测量；网络文件系统与掉电仍未验证。没有真实模型调用，也没有模型吞吐或用户报告质量结论，不建议手工绕过运行库门槛启用 WAL。

briefloop-0.30.0/docs/writing-agreements.md

@@ -0,0 +1,19 @@
+# 写作约定与报告反馈
+
+报告页右侧使用同一个输入框。点「发送」与 BriefLoop 讨论或修改本稿；想留下供 WikiSkill 验证的意见，点「留下经验」进入原有反馈表，遵循已设置的自动学习及预算；明确希望以后沿用的写法，点「下期沿用」直接保存。保存约定不启动模型学习任务，也不需要等待试写比较。
+
+默认只适用于这份报告及通过「开始下一期」关联的后续报告；可以主动选择「本工作区所有新报告」。系统不根据标题相似猜测报告系列。已保存的约定可以展开查看并撤销；下一期草稿也可以取消勾选某条，只跳过本期。
+
+约定在新任务创建时从本地记录重新读取，进入冻结的写作要求和评价契约。不会改变已有稿件、运行、评分或正式交付的版本绑定。撤销只影响此后的新任务。若草稿引用的约定已变化，重新打开下一期入口核对。既有学习试写仍使用原任务的冻结条件，不读取后来添加的约定。
+
+普通对话可以读取约定、保存普通经验反馈，但不能直接保存或撤销长期约定。目前各宿主没有统一的可信用户动作身份，不能把模型提供的会话 ID 当作隔离边界。请在报告页点「下期沿用」或「撤销」。
+
+下一期草稿的勾选结果按消息保存在服务端，生成时先核对请求明确指定的往期版本 ID 和哈希，两者均与关联一致才带入跳过项；缺失或不一致会报错，不替请求指定报告系列。模型不需要转抄排除列表。尚在排队的下一条消息不会覆盖当前回合。发消息后约定卡保留，便于补充期间等信息；取消关联后下一条消息清除其绑定。若执行回合缺失必要会话绑定，明确报错，不静默重新启用跳过项。其他会话或终端的无关新报告不受这一关联影响；无会话标识且明确指向正在关联的同一往期版本时，要求补全关联以避免漏掉跳过项。会话关联用于状态传递，不是进程安全隔离。
+
+相同关联已实际发送后，后续消息只附简短版本定位与跳过项，不再重复整份要求。主 Agent 可通过只读 next_report 动作重新读取可沿用约定；宿主切换后也可使用此入口，不依赖隐藏提示词随历史迁移。首次、关联变化和未实际发送的情形仍携带完整约定。
+
+写作约定是用户对写法的要求，不是来源证据，也不扩大联网、工具或费用权限。数字纠错通过本稿编辑与核对处理；用户更正不自动等于事实核验通过。复杂方法改进仍使用现有反馈与学习流程，调用模型前沿用现有授权及预算规则。
+
+报告上会保留最近一次相关方法验证的状态，包括失败、未见足够改善或采用；可以查看依据与详情。轮数和自动学习放在「改进方法与运行详情」里。没有比较记录时不会写成「验证通过」或「已采用」。
+
+本轮验证覆盖本地保存、刷新恢复、范围隔离、冻结、撤销、下一期排除和报告内结果展示。未新增真实模型调用；写作约定已进入输入不等于模型一定遵守，也不代表报告质量已提升。

briefloop-0.30.0/docs//347/233/256/346/240/207/351/251/261/345/212/250/347/240/224/347/251/266.md

@@ -0,0 +1,33 @@
+# 按目标补证
+
+在对话输入框的「研究选项」中，选择「标准」生成，再将「研究方法」设为「按目标补证（试用）」。也可在新建报告要求中选择该研究方法。它目前仍是可选模式，尚未证明全面优于分轮研究。
+
+这个模式从读者的问题出发决定下一步：集中问题可以由主 Agent 直接研究，互不依赖的支线按需交给 Scout。不会因为没有初始材料就强制创建子任务。查询、来源、预算和权限仍使用本次任务已经允许的范围；它不等于无限研究，也不会自动提高模型推理档位。
+
+## 看懂进度
+
+打开报告任务的研究过程，可以看到关键问题：
+
+- **待研究**：尚未提交该问题的覆盖判断。
+- **有依据**：主 Agent 提交了回答理由和可回查的原文位置；这不表示已通过独立核查。
+- **部分有依据**：部分内容有依据，仍有明确未答部分。
+- **尚待回答**：当前没有充分依据，保留未知及其影响。
+
+点击问题下的来源可查看已保存原文。研究轮次记录继续或停止的理由。没有解决所有问题也可以保存工作稿；未知不能被改成没有发生。正式交付仍受既有独立审阅和确定性检查约束。
+
+任务停止与恢复使用原来的任务按钮，保留已收轮的覆盖判断和来源快照。旧版本已经冻结的任务按原契约继续，不要求补填新字段。独立评价仍核对实际稿件和来源，不接受主 Agent 的覆盖自评作为事实证明。
+
+## 与快速模式的区别
+
+联网快速模式只做一轮聚焦检索，先保存初稿，再补依据和评价；它目前不使用研究策略开关，也不自动改写正文。按目标补证属于标准生成流程，可在授权范围内按需要补搜，并沿用最多一次自动修订。
+
+速度与质量需要同时比较：首次保存、完成评价的总用时、关键事实错误、重要问题覆盖和可读性分别记录。快速出稿不等于检查完成，来源较多也不等于研究更完整。
+
+
+## 0.30 的实测边界
+
+开发中的公开联网对照没有支持切换默认。旧分轮与目标驱动的12次比较中，目标驱动6个配对有4个更快、2个更慢；不能据此宣称稳定提速。新增问题覆盖与按需委派的四次候选诊断也有分化：数据中心题候选总耗时约少11%，Python迁移题约多10.7%，每个场景每臂仅一份。
+
+候选确实提交了问题状态、定位和停止理由，但两题均仍选择两个Scout，没有真实少派Scout提速的证据。部分“有依据”只挂了一段局部证据，不能据标签认定整个问题答全；最终质量仍需对照完整稿件与来源核查。
+
+联网快速模式的修复复测计划三例，因首波一例检索失败，实际一份成稿、一份失败、一例未派发。成稿仍有重要覆盖不足。所有失败和未运行样本单列，未挑选最佳稿件；这些是非盲、小样本、跨时段公开检索的开发诊断，没有统计显著性、人工改稿耗时或账单成本收益结论。