briefloop 0.21.0__tar.gz → 0.22.0__tar.gz

{briefloop-0.21.0 → briefloop-0.22.0}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # 变更记录
 
+## 0.22.0
+
+- 新工作区默认 Tavily 优先并允许宿主自带搜索补充；新增智谱搜索 Key 与引擎选择，博查和智谱均由用户主动启用。已有任务保持冻结搜索策略。
+- 搜索支持首选、允许的补充渠道和宿主原生搜索；可主动检查跨市场覆盖或仅按缺口补查，策略随报告冻结。
+- 新增博查中国市场网页搜索及本机 Key 设置，与 Tavily、DuckDuckGo 共用搜索预算和 URL 去重。
+- 研究预算可查看渠道、用途、耗时及失败状态；来源页增加发现渠道筛选。移除尚无专门接入的公众号、小红书选项，不将搜索摘要标成全文或事实核实。
+
+- 新建报告从系统时钟冻结截至日期、时间范围与时区，页面可预览并修改；定时报告每期重新计算相对时间。Tavily 检索携带冻结日期范围，写作与审阅区分当期变化与历史背景。
+- 我的报告增加阶段、实际耗时、成功与失败搜索、已保存材料、研究轮次、审阅与修订进展。已有稿件可提前打开；停止、恢复和历史失败记录沿用原任务，不显示虚构完成百分比。
+- Antigravity 无界面报告任务获得明确的长任务超时配置；超时或仅有部分输出时保留实际错误，避免误报成功。
+
+使用方式见 [搜索渠道与来源](docs/使用指南.md#搜索渠道与来源)、[桌面安装与更新](docs/桌面安装与更新.md)。安装包仍未签名或公证；搜索渠道需有相应凭据或宿主能力，服务额度与费用以账号实际情况为准。
+
+## 0.21.1
+
+本节记录源码变更；各渠道发布状态以发行页实际工件和版本核验结果为准。
+
+- Antigravity 支持通过原生 `view_file` 读取对话图片；工具名称、失败详情和无正文错误在对话中可见，公开错误输出统一遮蔽凭据。
+- Antigravity 权限提供默认、全机访问、Turbo 与自定义预设，保留已有终端沙箱及适用的逐工具规则；无界面模式下的拒绝会明确显示，用户可调整规则后重发。
+- 复制消息或来源链接时，浏览器拒绝异步剪贴板 API 后尝试本地回退，并恢复原输入焦点。
+- Mac 应用内更新改用 ZIP 与 blockmap，复用已校验的同格式缓存下载差分；DMG 继续用于首次安装。差分不可用时回退到完整校验下载，首次 ZIP 更新仍可能全量下载。
+- Mac 安装前检查 ZIP 路径、应用身份与目标版本，准备 Finder 中的应用替换目录。当前仍由用户替换应用并重新打开，不宣称静默安装或已签名、公证。
+- 修复 OpenCode 进程退出测试的终态事件竞态，避免后台正常补写终态事件被误判成额外运行。
+
+使用说明见 [模型与权限](docs/使用指南.md#模型与权限)及 [桌面安装与更新](docs/桌面安装与更新.md)。本版不新增事实核查能力；其真实运行的质量结论仍需独立审阅。
+
 ## 0.21.0
 
 - 新增快速、标准和深度研究档位；深度研究预排四轮，逐轮交接发现与追问，保存已登记来源与定位。网页、对话和 external 请求将档位绑定到任务，恢复时不改用当前设置。

{briefloop-0.21.0 → briefloop-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.21.0
+Version: 0.22.0
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT
@@ -41,12 +41,18 @@ Dynamic: license-file
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
-界面与文档为中文，报告正文可选中文或英文。研究在所选本机宿主中执行，使用本次报告的共享预算。0.21.0 源码提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
+界面与文档为中文，报告正文可选中文或英文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
 
 新建报告可选择通用报告，或商业报告下的行业周报／月报、工作进展周报与决策分析。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式可继续使用，其余文档类型的专门内容流程将分批接入。
 
 运行时设置显示本地图标、简介、实际版本与模型信息；未安装工具按卡片浏览。首页仅保留宿主选择器，更新失败会区分检查、下载和安装阶段。见 [运行时选择与检测](docs/运行时选择与检测.md)。
 
+## 0.22：多渠道研究与可见进度
+
+新工作区默认优先 Tavily，同时允许宿主自带搜索补查；可主动启用博查、智谱搜索或 DuckDuckGo，按跨市场覆盖或具体缺口补查。受控渠道共用本轮预算，搜索失败、实际发现渠道与原文分别保留。Tavily 需要 API Key，额度以服务账号为准；宿主自带搜索取决于实际工具与权限。
+
+报告开始前可预览系统日期、时间范围和时区；任务开始后冻结。我的报告显示研究、已保存材料、审阅与修订的实际进展，原稿生成后即可查看。见 [使用指南](docs/使用指南.md)。
+
 ## 桌面 App
 
 桌面安装包以发行页实际提供的版本为准；App、CLI 与 PyPI 使用同一产品版本和冻结后端 wheel，各渠道是否发布以版本核验结果为准。
@@ -80,7 +86,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。
-- 首次安装依赖需要网络。使用 Tavily 时另行配置自己的 Tavily Key。
+- 首次安装依赖需要网络。使用 Tavily、博查或智谱搜索时，另行配置对应服务的 Key。
 
 也可指定目录、端口和后端：
 
@@ -108,7 +114,7 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 |---|---|
 | 上传、解析和查看文件 | 文件先保存到本机工作区，内置解析在本机执行。仅上传或本地预览不会自动把整份文件发送给模型。 |
 | 对话、研究、写稿、审阅、修订或学习 | 任务要求、对话，以及 Agent 读取的材料内容、图片、稿件、反馈等，会进入相应模型的上下文。具体可能是摘录、全文或图片，取决于实际读取和附件方式。主链、Evaluator、Wiki Maintainer、Skill Proposer 可分别使用不同提供方。 |
-| 搜索和读取网页 | 搜索词发送给所选搜索服务，网页请求发送到目标网站；使用 Tavily 提取时，目标 URL 也会发送给 Tavily。Agent 生成的搜索词可能包含任务中的公司名称、主题或其他信息。 |
+| 搜索和读取网页 | 搜索词发送给本轮允许且实际调用的搜索服务（Tavily、博查、智谱搜索、DuckDuckGo 或宿主自带工具），网页请求发送到目标网站；使用 Tavily 提取时，目标 URL 也会发送给 Tavily。Agent 生成的搜索词可能包含任务中的公司名称、主题或其他信息。 |
 | 使用 MCP 连接器 | 资源地址、工具参数和必要的认证信息发送给配置的连接器服务。本地 stdio 程序也可能自行联网；连接器返回的材料保存为来源后，还可能被读取并发送给模型。连接器的逐报告授权与公开检索开关分开管理。 |
 | 保存、生成和下载 Word | 稿件版本、审阅记录和导出文件保存在工作区；普通 Word 导出由本机程序完成，不额外调用模型。下载到同步盘、用第三方办公软件打开或主动分享后，后续去向由这些软件和你的操作决定。 |
 | 由 WorkBuddy 等外部 Agent 调用 | 外部 Agent 可通过本地接口读取其请求的来源、稿件和结果；这些内容可能随后进入外部 Agent 自己的模型服务。由它提交的生成任务，仍使用 BriefLoop 工作区配置的宿主。 |
@@ -167,7 +173,7 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 ## 第一次使用
 
 1. 在“材料与需求”填写目的、读者、时间范围和字数要求。可上传材料、开启联网，或在“本轮连接器材料”中明确选择 MCP 材料。
-2. 选择搜索工具。Tavily 的输入口就在联网开关下；保存 Key 不会自动验证或发起收费搜索。
+2. 在「设置 → 运行与搜索」选择首选渠道、允许补充的渠道及覆盖策略。Tavily、博查、智谱搜索的 Key 可在同页保存，保存不会自动调用搜索。
 3. 在“设置”确认执行宿主、主模型及角色模型。模型 ID 可自行填写；Codex 的 provider 填本机已配置的 Responses provider 名称，其它宿主用它自己的配置；需要接第三方 API 时在“API 提供商”里登记协议、Base URL、Key 和模型。
 4. 点击生成。草稿保存后即可查看，评分独立完成；低分或评分失败不会隐藏原稿。
 5. 按需修改正文、保存反馈或明确启动学习。注意自动学习开关：启用后，编辑静默约 30 秒会合并反馈并启动模型任务。
@@ -196,6 +202,14 @@ BriefLoop 用主链模型，另外三个角色可以在设置里分别指定、
 报告页的「已保存版本检查」分别展示断链引用、数值绑定、版式与导出提示；版式检查覆盖标题层级中断、空标题与缺表头表格，只报告不阻断。数值绑定需要原文摘录、明确来源位置（如 `line 1`、`page 1` 或证据定位 JSON）、正文唯一片段及其中的完整数值；程序按币种、单位和正负号核对，只对成功定位的项目计数。无绑定、单位不支持或改稿使定位失效时显示未检查。主体、期间、财务指标与政策条件由 Evaluator 对照原文评价。草稿可保存、修改和下载；含图表的独立交付请使用 Word 或包含图片的 Markdown 包。
 
 
+## 搜索渠道
+
+新工作区默认优先 Tavily，同时允许宿主自带搜索补充。两者可以在同一报告中使用；宿主仍需实际具备搜索工具及相应权限。Tavily 需要配置 Key，免费额度有上限。博查、智谱搜索和 DuckDuckGo 为可选补充渠道，不默认启用；也可更换首选或选择仅首选。没有强制搜索提供方。
+
+补充策略可选择「检查跨市场覆盖并补缺」「仅遇缺口补查」或「只用首选」。市场与语言用于研究规划；公众号、小红书暂无专门接入。多渠道不保证消除偏差或覆盖全部平台内容。任务开始后冻结选择，修改设置只影响新任务。
+
+搜索记录展示实际调用渠道、用途、错误和候选数量，来源页可按发现渠道筛选。同一网页由多家搜索服务找到仍是一份来源；发现链接、取得正文和事实核实分别记录。详见[使用指南](docs/使用指南.md#搜索渠道与来源)。
+
 ## 研究预算
 
 | 预设 | 搜索调用尝试 | 去重候选 URL | 全文来源 URL |
@@ -203,9 +217,9 @@ BriefLoop 用主链模型，另外三个角色可以在设置里分别指定、
 | 周报 | 30 | 150 | 60 |
 | 月报 | 80 | 400 | 150 |
 
-预算由整次报告中的 Scout 共享，不是每个 Scout 各拿一份，也不要求花完。失败的 Tavily Search 调用仍计次；同一 URL 的直接获取、Extract 回退及重试不重复扣全文 URL。达到额度后保留材料、说明缺口，不自动加额。
+预算由整次报告中的 Scout 共享，不是每个 Scout 各拿一份，也不要求花完。失败的受控搜索调用仍计次；同一 URL 的直接获取、Extract 回退及重试不重复扣全文 URL。达到额度后保留材料、说明缺口，不自动加额。
 
-搜索请求和候选额度适用于受控 Tavily 工具；宿主自带的搜索（Codex、Opencode、各 CLI 的联网工具）无法在此精确计量，页面会明确区分。全文额度统计受控工具处理的不同 URL，不是 PDF 页数、阅读完成数量或所有 HTTP 请求次数。
+搜索请求和候选额度由 Tavily、博查、智谱搜索、DuckDuckGo 共用；宿主自带的搜索（Codex、Opencode、各 CLI 的联网工具）无法在此精确计量，页面会明确区分。全文额度统计受控工具处理的不同 URL，不是 PDF 页数、阅读完成数量或所有 HTTP 请求次数。
 
 ## 正文篇幅
 
@@ -268,6 +282,7 @@ briefloop external --workspace "/absolute/workspace" request --file request.json
 
 检索预算用于控制成本：达到额度后使用已有证据并列出重要缺口，不自动加额。评分与事实核验是两条独立的检查，页面分别显示各自结果。
 
+- [0.21.0 工程技术报告](docs/technical-report-0.21.0/technical-report.md) · [证据索引](docs/technical-report-0.21.0/evidence-index.md)
 - [产品定位与验证边界](docs/产品定位与验证.md)
 - [合成周报示例](examples/internal-weekly-report/README.md)
 - [已知边界与问题反馈](KNOWN_ISSUES.md)

{briefloop-0.21.0 → briefloop-0.22.0}/README.md

@@ -2,12 +2,18 @@
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
-界面与文档为中文，报告正文可选中文或英文。研究在所选本机宿主中执行，使用本次报告的共享预算。0.21.0 源码提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
+界面与文档为中文，报告正文可选中文或英文。研究在所选本机宿主中执行，使用本次报告的共享预算。提供快速、标准和深度研究档位，以及生成后的可选独立事实核查；安装版可用功能以实际发行版本为准。见 [深度研究与事实核查](docs/深度研究与事实核查.md)。
 
 新建报告可选择通用报告，或商业报告下的行业周报／月报、工作进展周报与决策分析。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式可继续使用，其余文档类型的专门内容流程将分批接入。
 
 运行时设置显示本地图标、简介、实际版本与模型信息；未安装工具按卡片浏览。首页仅保留宿主选择器，更新失败会区分检查、下载和安装阶段。见 [运行时选择与检测](docs/运行时选择与检测.md)。
 
+## 0.22：多渠道研究与可见进度
+
+新工作区默认优先 Tavily，同时允许宿主自带搜索补查；可主动启用博查、智谱搜索或 DuckDuckGo，按跨市场覆盖或具体缺口补查。受控渠道共用本轮预算，搜索失败、实际发现渠道与原文分别保留。Tavily 需要 API Key，额度以服务账号为准；宿主自带搜索取决于实际工具与权限。
+
+报告开始前可预览系统日期、时间范围和时区；任务开始后冻结。我的报告显示研究、已保存材料、审阅与修订的实际进展，原稿生成后即可查看。见 [使用指南](docs/使用指南.md)。
+
 ## 桌面 App
 
 桌面安装包以发行页实际提供的版本为准；App、CLI 与 PyPI 使用同一产品版本和冻结后端 wheel，各渠道是否发布以版本核验结果为准。
@@ -41,7 +47,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。
-- 首次安装依赖需要网络。使用 Tavily 时另行配置自己的 Tavily Key。
+- 首次安装依赖需要网络。使用 Tavily、博查或智谱搜索时，另行配置对应服务的 Key。
 
 也可指定目录、端口和后端：
 
@@ -69,7 +75,7 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 |---|---|
 | 上传、解析和查看文件 | 文件先保存到本机工作区，内置解析在本机执行。仅上传或本地预览不会自动把整份文件发送给模型。 |
 | 对话、研究、写稿、审阅、修订或学习 | 任务要求、对话，以及 Agent 读取的材料内容、图片、稿件、反馈等，会进入相应模型的上下文。具体可能是摘录、全文或图片，取决于实际读取和附件方式。主链、Evaluator、Wiki Maintainer、Skill Proposer 可分别使用不同提供方。 |
-| 搜索和读取网页 | 搜索词发送给所选搜索服务，网页请求发送到目标网站；使用 Tavily 提取时，目标 URL 也会发送给 Tavily。Agent 生成的搜索词可能包含任务中的公司名称、主题或其他信息。 |
+| 搜索和读取网页 | 搜索词发送给本轮允许且实际调用的搜索服务（Tavily、博查、智谱搜索、DuckDuckGo 或宿主自带工具），网页请求发送到目标网站；使用 Tavily 提取时，目标 URL 也会发送给 Tavily。Agent 生成的搜索词可能包含任务中的公司名称、主题或其他信息。 |
 | 使用 MCP 连接器 | 资源地址、工具参数和必要的认证信息发送给配置的连接器服务。本地 stdio 程序也可能自行联网；连接器返回的材料保存为来源后，还可能被读取并发送给模型。连接器的逐报告授权与公开检索开关分开管理。 |
 | 保存、生成和下载 Word | 稿件版本、审阅记录和导出文件保存在工作区；普通 Word 导出由本机程序完成，不额外调用模型。下载到同步盘、用第三方办公软件打开或主动分享后，后续去向由这些软件和你的操作决定。 |
 | 由 WorkBuddy 等外部 Agent 调用 | 外部 Agent 可通过本地接口读取其请求的来源、稿件和结果；这些内容可能随后进入外部 Agent 自己的模型服务。由它提交的生成任务，仍使用 BriefLoop 工作区配置的宿主。 |
@@ -128,7 +134,7 @@ Codex 使用官方 OpenAI provider 且配置支持时，输入区与角色配置
 ## 第一次使用
 
 1. 在“材料与需求”填写目的、读者、时间范围和字数要求。可上传材料、开启联网，或在“本轮连接器材料”中明确选择 MCP 材料。
-2. 选择搜索工具。Tavily 的输入口就在联网开关下；保存 Key 不会自动验证或发起收费搜索。
+2. 在「设置 → 运行与搜索」选择首选渠道、允许补充的渠道及覆盖策略。Tavily、博查、智谱搜索的 Key 可在同页保存，保存不会自动调用搜索。
 3. 在“设置”确认执行宿主、主模型及角色模型。模型 ID 可自行填写；Codex 的 provider 填本机已配置的 Responses provider 名称，其它宿主用它自己的配置；需要接第三方 API 时在“API 提供商”里登记协议、Base URL、Key 和模型。
 4. 点击生成。草稿保存后即可查看，评分独立完成；低分或评分失败不会隐藏原稿。
 5. 按需修改正文、保存反馈或明确启动学习。注意自动学习开关：启用后，编辑静默约 30 秒会合并反馈并启动模型任务。
@@ -157,6 +163,14 @@ BriefLoop 用主链模型，另外三个角色可以在设置里分别指定、
 报告页的「已保存版本检查」分别展示断链引用、数值绑定、版式与导出提示；版式检查覆盖标题层级中断、空标题与缺表头表格，只报告不阻断。数值绑定需要原文摘录、明确来源位置（如 `line 1`、`page 1` 或证据定位 JSON）、正文唯一片段及其中的完整数值；程序按币种、单位和正负号核对，只对成功定位的项目计数。无绑定、单位不支持或改稿使定位失效时显示未检查。主体、期间、财务指标与政策条件由 Evaluator 对照原文评价。草稿可保存、修改和下载；含图表的独立交付请使用 Word 或包含图片的 Markdown 包。
 
 
+## 搜索渠道
+
+新工作区默认优先 Tavily，同时允许宿主自带搜索补充。两者可以在同一报告中使用；宿主仍需实际具备搜索工具及相应权限。Tavily 需要配置 Key，免费额度有上限。博查、智谱搜索和 DuckDuckGo 为可选补充渠道，不默认启用；也可更换首选或选择仅首选。没有强制搜索提供方。
+
+补充策略可选择「检查跨市场覆盖并补缺」「仅遇缺口补查」或「只用首选」。市场与语言用于研究规划；公众号、小红书暂无专门接入。多渠道不保证消除偏差或覆盖全部平台内容。任务开始后冻结选择，修改设置只影响新任务。
+
+搜索记录展示实际调用渠道、用途、错误和候选数量，来源页可按发现渠道筛选。同一网页由多家搜索服务找到仍是一份来源；发现链接、取得正文和事实核实分别记录。详见[使用指南](docs/使用指南.md#搜索渠道与来源)。
+
 ## 研究预算
 
 | 预设 | 搜索调用尝试 | 去重候选 URL | 全文来源 URL |
@@ -164,9 +178,9 @@ BriefLoop 用主链模型，另外三个角色可以在设置里分别指定、
 | 周报 | 30 | 150 | 60 |
 | 月报 | 80 | 400 | 150 |
 
-预算由整次报告中的 Scout 共享，不是每个 Scout 各拿一份，也不要求花完。失败的 Tavily Search 调用仍计次；同一 URL 的直接获取、Extract 回退及重试不重复扣全文 URL。达到额度后保留材料、说明缺口，不自动加额。
+预算由整次报告中的 Scout 共享，不是每个 Scout 各拿一份，也不要求花完。失败的受控搜索调用仍计次；同一 URL 的直接获取、Extract 回退及重试不重复扣全文 URL。达到额度后保留材料、说明缺口，不自动加额。
 
-搜索请求和候选额度适用于受控 Tavily 工具；宿主自带的搜索（Codex、Opencode、各 CLI 的联网工具）无法在此精确计量，页面会明确区分。全文额度统计受控工具处理的不同 URL，不是 PDF 页数、阅读完成数量或所有 HTTP 请求次数。
+搜索请求和候选额度由 Tavily、博查、智谱搜索、DuckDuckGo 共用；宿主自带的搜索（Codex、Opencode、各 CLI 的联网工具）无法在此精确计量，页面会明确区分。全文额度统计受控工具处理的不同 URL，不是 PDF 页数、阅读完成数量或所有 HTTP 请求次数。
 
 ## 正文篇幅
 
@@ -229,6 +243,7 @@ briefloop external --workspace "/absolute/workspace" request --file request.json
 
 检索预算用于控制成本：达到额度后使用已有证据并列出重要缺口，不自动加额。评分与事实核验是两条独立的检查，页面分别显示各自结果。
 
+- [0.21.0 工程技术报告](docs/technical-report-0.21.0/technical-report.md) · [证据索引](docs/technical-report-0.21.0/evidence-index.md)
 - [产品定位与验证边界](docs/产品定位与验证.md)
 - [合成周报示例](examples/internal-weekly-report/README.md)
 - [已知边界与问题反馈](KNOWN_ISSUES.md)

briefloop-0.22.0/VERSION

@@ -0,0 +1 @@
+0.22.0

{briefloop-0.21.0 → briefloop-0.22.0}/desktop/electron/package-lock.json

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

{briefloop-0.21.0 → briefloop-0.22.0}/desktop/electron/package.json

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

briefloop-0.22.0/docs/report-time-window.md

@@ -0,0 +1,13 @@
+# 报告时间范围
+
+所有执行宿主共用 Store 创建任务入口。后台在创建报告时读取系统时钟，写入 `requirements.time_context` 的核对时刻、当地日期、时区、起始时间和结束时间（不含结束时刻）。这依赖电脑时钟正确，不把模型记忆或搜索摘要作为当前日期。
+
+新建报告表单提供起止日期与可选 IANA 时区，并通过后台预览范围。明确日期优先于文字周期，结束日期包含当天。今天、本周、本月和近 N 小时/天会转换为具体范围；未指定或“最新动态”默认今天零点至创建时刻。无法解析的文字周期要求填写日期，不自行猜测。历史范围可以指定，不强制当期。
+
+原任务重试不会刷新范围；学习对照复制原范围。定时报告在每次触发时按计划时区建立新范围，旧起止日期不会覆盖新的计划周期。历史任务不补写未经确认的时间范围，界面标明未记录。
+
+研究与写稿契约、评分输入和独立审阅包沿用冻结范围。受控 Tavily 搜索用冻结日期替换模型传入的日期过滤参数；宿主原生搜索依赖宿主接口和研究指令，无法承诺同等参数强制。搜索日期过滤不等于事件日期验证。
+
+稿件可记录 `temporal_claims`：statement、event_date、published_at、fetched_at、source_id、locator、usage（current/background）。程序比较事件日期与范围，日期缺失显示待核实，旧事件不因今天抓取而成为当期动态。范围内仅标记 `in_range_unverified`，独立审阅仍须核对原文，且检查未被作者登记的正文主张。无日期记录不显示已通过。日期检查不会隐藏工作稿，也不是全文事实正确性的保证。
+
+Tavily 日期边界按[官方 Search API 文档](https://docs.tavily.com/documentation/api-reference/endpoint/search)处理：结束日期不含当天，部分结束日向上取整；报告内仍核对精确时间。接口按发布或更新日期过滤，不能证明事件发生于本期。