briefloop 0.20.1__tar.gz → 0.20.3__tar.gz

{briefloop-0.20.1 → briefloop-0.20.3}/CHANGELOG.md

@@ -1,5 +1,37 @@
 # 变更记录
 
+## 0.20.3 — 发布准备中
+
+本节记录待发行的修复；安装包、PyPI 和更新入口以实际渠道提供的版本为准。尚未完成本版各平台安装与更新验收，不表示已统一发布。
+
+- 统一发行检查要求桌面后端与同一份发行 wheel 的 SHA-256 一致；导入的跨平台检查失败不会被相同版本号覆盖成通过。
+- 纳入下方 0.20.2 的运行时卡片改进，并接入 DeepSeek Harness、Antigravity 和 Pi 的原生会话；聊天中可选择宿主实际支持的权限。模型、账户可用性及受限审阅能力仍以实际宿主为准。
+- 修复桌面主进程异常退出后的后台归属清理；停止时先保存已接纳的本地修改，再取消外部 MCP 调用。工作区切换先检查目标，启动失败时提供恢复路径；桌面一次管理一个活动工作区。
+- OpenCode 服务绑定启动它的 Python 进程；macOS/Linux 上父进程被强制结束后回收所属服务及进程组，Windows 沿用所属 Job 清理。不按程序名称清理用户的其他 CLI。
+- OpenCode 与 Codex 后台按需启动，无活动回合、子任务或在途配置请求时空闲 30 秒回收；保留已保存的原生会话供下一回合恢复。OpenCode 模型列表缓存命中时不重新启动服务。
+- 通用 CLI Bridge 空闲 30 秒释放，活动调用和会话事件订阅保留连接；退出时清理它启动的模型目录探测与执行子进程。网页空闲/隐藏时降低轮询频率，回到前台立即刷新，慢请求不重叠。
+- 后台任务队列空闲时逐步降低查库频率，同服务入队后立即唤醒；其他进程提交保留最多 5 秒的发现间隔。独立 CLI 服务不会因为关闭网页或长时间无操作而自动停止。
+- 修复运行时发送背压、进程死亡后会话不结束，以及子任务同名工具的新调用被进度去重遗漏的问题；无变化的心跳不重复写成进展。
+- 相同 Word 输入的并发导出共用一个任务，文件缺失或损坏可重新制作。修复富文档行业报告的重复首标题、图表来源遗漏与非法图片导致保存状态无法恢复的问题。
+- Markdown 导入需要明确确认转换；普通保存保留富文档的颜色、表格、图片和引用，历史版本仍可查看。上传前显示文件大小限制，超限不先读入整份附件。
+- 修复软性要求的条款 ID 被误当成硬性要求；事实矛盾继续按事实问题处理。审阅发现可引用本次固定包内的来源陈述，来源陈述不会因此自动成为正文已核实的主张。
+- 学习比较核对冻结的内容方法与评价条件；初始化中断可恢复，过滤后没有可用材料的案例说明原因，不记为候选技能收益。
+- 损坏 PDF/XLSX 的已知解析错误定位到对应材料；连接器配置损坏时保留原文件和诊断，历史稿件仍可查看。任务结束释放所属连接器资源。
+- 研究轮次变更、企业背景事实与冲突登记采用原子提交，避免并发覆盖和中断留下无法处理的记录。
+- 补齐日志凭据遮蔽、连接器动态加载环境变量限制，以及私有 GET 接口的跨站来源检查；正常网页下载和本地外部客户端沿现有接口使用。
+- 连接测试保留独立历史入口，错误和取消结果可查看；普通最近会话不再混入连接测试。统一聊天工具栏文字样式。
+- 尚未选择模型时仍可查看和下载已有报告、读取来源及打开设置；开始新对话或新报告时再确认执行模型。
+
+## 0.20.2 — 源码改动，未独立发行
+
+以下改动已合并源码，将随 0.20.3 一同发行；没有单独的 0.20.2 PyPI 包或桌面安装包。
+
+- 运行时卡片加入本地品牌图标、简介、检测版本和当前模型；图标随应用分发，离线可见。未安装运行时展开为双列卡片，窄屏自动变成单列。
+- 去掉首页聊天框重复的“当前：runtime”，保留可操作的宿主选择器和回合执行记录。
+- 修复 Kilo、Kiro、Vibe 已有 ACP 适配却被可选宿主名单阻挡的问题；安装检测、协议适配和实际调用结果分别呈现，不把模型目录当作账号调用成功。
+- 更新失败分别显示检查失败、下载未完成、安装未完成；检查失败不附带旧版本目标，重试按失败阶段执行，保留具体错误与限流恢复时间。
+
+
 ## 0.20.1 — 2026-09-13
 
 本次发布 Python / CLI / Web 包；桌面源码版本同步，未重新发行 Mac / Windows 安装包。
@@ -2253,4 +2285,3 @@ First public release. The following entries document the development iterations
 - Markdown / JSON / DOCX output.
 - Claude Code / Codex agent configurations.
 - Open-source release safety scanning tools.
-

{briefloop-0.20.1 → briefloop-0.20.3}/CONTRIBUTING.md

@@ -21,7 +21,7 @@ node runtime-bridge/build.mjs
 npm run build
 npm test
 node --test runtime-bridge/bridge.test.mjs
-.venv/bin/python -m pytest -q
+.venv/bin/python -m pytest tests -q
 .venv/bin/python -m build
 .venv/bin/python tests/check_distribution.py dist/*.whl dist/*.tar.gz
 ```

{briefloop-0.20.1 → briefloop-0.20.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.20.1
+Version: 0.20.3
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT
@@ -36,7 +36,7 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
 Dynamic: license-file
 
-# BriefLoop 0.20.1
+# BriefLoop 0.20.2
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
@@ -44,9 +44,11 @@ Dynamic: license-file
 
 新建报告可选择通用报告，或商业报告下的行业周报／月报、工作进展周报与决策分析。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式可继续使用，其余文档类型的专门内容流程将分批接入。
 
+0.20.2 的运行时设置新增本地图标、简介、实际版本与模型信息；未安装工具按卡片浏览。首页仅保留宿主选择器，更新失败会区分检查、下载和安装阶段。见 [运行时选择与检测](docs/运行时选择与检测.md)。
+
 ## 桌面 App
 
-桌面安装包以发行页实际提供的版本为准；本次先发布 Python/CLI/Web 0.20.1，既有桌面包仍为 0.20.0。
+桌面安装包以发行页实际提供的版本为准；App、CLI 与 PyPI 使用同一产品版本和冻结后端 wheel，各渠道是否发布以版本核验结果为准。
 
 从 [GitHub Releases](https://github.com/Stahl-G/briefloop/releases) 选择与系统匹配的安装包。macOS Apple Silicon 使用 DMG；Windows x64 使用 EXE。桌面版与 WebUI 共用报告、材料和设置。
 
@@ -97,15 +99,26 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 
 也可直接运行 `python -X utf8 bootstrap.py --no-open`。启动器打印本机网页地址；模型认证仍由所选宿主提供。详情见 [Windows 验证边界](docs/windows.md)。
 
-## 数据会去哪里
+## 隐私提示：文件和内容会去哪里
+
+**BriefLoop 将工作区保存在本机；使用云端模型处理材料时，相关内容会经所选宿主发送到其配置的服务。关闭“联网检索”并不等于停止向模型发送内容。**
+
+| 你执行的操作 | 文件或内容的去向 |
+|---|---|
+| 上传、解析和查看文件 | 文件先保存到本机工作区，内置解析在本机执行。仅上传或本地预览不会自动把整份文件发送给模型。 |
+| 对话、研究、写稿、审阅、修订或学习 | 任务要求、对话，以及 Agent 读取的材料内容、图片、稿件、反馈等，会进入相应模型的上下文。具体可能是摘录、全文或图片，取决于实际读取和附件方式。主链、Evaluator、Wiki Maintainer、Skill Proposer 可分别使用不同提供方。 |
+| 搜索和读取网页 | 搜索词发送给所选搜索服务，网页请求发送到目标网站；使用 Tavily 提取时，目标 URL 也会发送给 Tavily。Agent 生成的搜索词可能包含任务中的公司名称、主题或其他信息。 |
+| 使用 MCP 连接器 | 资源地址、工具参数和必要的认证信息发送给配置的连接器服务。本地 stdio 程序也可能自行联网；连接器返回的材料保存为来源后，还可能被读取并发送给模型。连接器的逐报告授权与公开检索开关分开管理。 |
+| 保存、生成和下载 Word | 稿件版本、审阅记录和导出文件保存在工作区；普通 Word 导出由本机程序完成，不额外调用模型。下载到同步盘、用第三方办公软件打开或主动分享后，后续去向由这些软件和你的操作决定。 |
+| 由 WorkBuddy 等外部 Agent 调用 | 外部 Agent 可通过本地接口读取其请求的来源、稿件和结果；这些内容可能随后进入外部 Agent 自己的模型服务。由它提交的生成任务，仍使用 BriefLoop 工作区配置的宿主。 |
+
+**实际接收方以宿主配置为准。** 自定义 Base URL、代理或模型网关可能先接收请求，再转发给模型厂商；仅凭模型名称不能判断文件内容最终经过哪些服务。第三方的保存期限、日志和训练使用规则取决于其服务与账户配置，BriefLoop 不统一控制这些规则。
 
-BriefLoop 在本机运行，但它不是离线工具。开始用之前请先分清三件事：
+工作区中的数据库、来源原件、稿件、Wiki、日志和审计包均可能包含敏感信息。删除本地文件不会自动删除第三方已经接收的内容；分享工作区、日志或审计包前，请检查其中的材料与个人信息。凭据保存在本机相应宿主或连接器配置中，不要把凭据文件随工作区或代码一起分享。
 
-- **会离开本机**：你上传的材料，以及生成的稿件与图片，**会发送给你所选宿主所连接的模型提供方**，用于生成、评价与修订。开启联网检索时，请求会发送给所选搜索服务；使用 Tavily 时由 Tavily 处理，也可能使用宿主自带的搜索工具。
-- **留在本机**：工作区目录、数据库、来源原件、稿件版本、评分与审计包。模型与搜索凭据保存在本机相应配置中。日志和模型生成内容可能带有敏感信息，分享前仍需检查。
-- **不对外提供访问**：本地服务只监听本机地址，不向局域网或互联网暴露。
+本地服务默认只监听 `127.0.0.1`，不直接开放公网访问。Agent 能读取哪些文件、执行哪些命令，由当前宿主实际支持的权限控制决定；“只读”不代表读取到的内容不会发送给云端模型，检索开关也不等同于所有宿主的网络隔离。
 
-所以，请按材料本身的敏感程度选择宿主与模型，并遵守你所在机构关于材料外发的规定。**把内部材料交给本地工具，和把内部材料交给某家模型厂商，是两件事。**
+安装依赖、检查版本和下载更新还会访问相应的软件分发服务，这些请求与报告材料处理分开。使用内部或保密材料前，请确认所选宿主、模型、代理、搜索和连接器符合你的材料外发要求。
 
 模型的可用性和计费由所选宿主及提供方决定；BriefLoop 的本地服务不提供模型额度。
 
@@ -234,7 +247,7 @@ Word 按按钮制作，完成后下载；不实时更新 Word，不提供网页
 
 ## 升级、边界与文档
 
-0.20.1 新增本地外部任务入口：WorkBuddy 等可执行本机命令的 Agent 可连接已有工作区，提交报告、查询进度、保存指定版本的修订和下载 Word。使用说明见 [WorkBuddy 外部入口](docs/WorkBuddy外部入口.md)；可使用 `pip install --upgrade briefloop==0.20.1` 安装；既有 0.20.0 桌面安装包不包含此入口。
+0.20.1 新增本地外部任务入口：WorkBuddy 等可执行本机命令的 Agent 可连接已有工作区，提交报告、查询进度、保存指定版本的修订和下载 Word。使用说明见 [WorkBuddy 外部入口](docs/WorkBuddy外部入口.md)；可使用 `pip install --upgrade briefloop==0.20.2` 安装；既有 0.20.0 桌面安装包不包含此入口。
 
 会议纪要内容方法也在后续源码中接入：选择内置纪要模板即可建议相应用途，输入本次会议转写或笔记，整理决议、待办和未定事项。见 [会议纪要说明与合成材料](docs/会议纪要.md)。
 

{briefloop-0.20.1 → briefloop-0.20.3}/README.md

@@ -1,4 +1,4 @@
-# BriefLoop 0.20.1
+# BriefLoop 0.20.2
 
 面向行业研究、战略与 IR 使用者的本地报告工作台：把分散材料整理成可编辑简报，逐项查看重要结论的依据、处理审阅问题，并保留原稿与修订版本。适合需要定期写报告、核数字和核口径的单人工作。
 
@@ -6,9 +6,11 @@
 
 新建报告可选择通用报告，或商业报告下的行业周报／月报、工作进展周报与决策分析。内容方法贯穿规划、写作、修订与评价，并随报告保存实际版本；Word 模板单独控制版式。八类内置版式可继续使用，其余文档类型的专门内容流程将分批接入。
 
+0.20.2 的运行时设置新增本地图标、简介、实际版本与模型信息；未安装工具按卡片浏览。首页仅保留宿主选择器，更新失败会区分检查、下载和安装阶段。见 [运行时选择与检测](docs/运行时选择与检测.md)。
+
 ## 桌面 App
 
-桌面安装包以发行页实际提供的版本为准；本次先发布 Python/CLI/Web 0.20.1，既有桌面包仍为 0.20.0。
+桌面安装包以发行页实际提供的版本为准；App、CLI 与 PyPI 使用同一产品版本和冻结后端 wheel，各渠道是否发布以版本核验结果为准。
 
 从 [GitHub Releases](https://github.com/Stahl-G/briefloop/releases) 选择与系统匹配的安装包。macOS Apple Silicon 使用 DMG；Windows x64 使用 EXE。桌面版与 WebUI 共用报告、材料和设置。
 
@@ -59,15 +61,26 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 
 也可直接运行 `python -X utf8 bootstrap.py --no-open`。启动器打印本机网页地址；模型认证仍由所选宿主提供。详情见 [Windows 验证边界](docs/windows.md)。
 
-## 数据会去哪里
+## 隐私提示：文件和内容会去哪里
+
+**BriefLoop 将工作区保存在本机；使用云端模型处理材料时，相关内容会经所选宿主发送到其配置的服务。关闭“联网检索”并不等于停止向模型发送内容。**
+
+| 你执行的操作 | 文件或内容的去向 |
+|---|---|
+| 上传、解析和查看文件 | 文件先保存到本机工作区，内置解析在本机执行。仅上传或本地预览不会自动把整份文件发送给模型。 |
+| 对话、研究、写稿、审阅、修订或学习 | 任务要求、对话，以及 Agent 读取的材料内容、图片、稿件、反馈等，会进入相应模型的上下文。具体可能是摘录、全文或图片，取决于实际读取和附件方式。主链、Evaluator、Wiki Maintainer、Skill Proposer 可分别使用不同提供方。 |
+| 搜索和读取网页 | 搜索词发送给所选搜索服务，网页请求发送到目标网站；使用 Tavily 提取时，目标 URL 也会发送给 Tavily。Agent 生成的搜索词可能包含任务中的公司名称、主题或其他信息。 |
+| 使用 MCP 连接器 | 资源地址、工具参数和必要的认证信息发送给配置的连接器服务。本地 stdio 程序也可能自行联网；连接器返回的材料保存为来源后，还可能被读取并发送给模型。连接器的逐报告授权与公开检索开关分开管理。 |
+| 保存、生成和下载 Word | 稿件版本、审阅记录和导出文件保存在工作区；普通 Word 导出由本机程序完成，不额外调用模型。下载到同步盘、用第三方办公软件打开或主动分享后，后续去向由这些软件和你的操作决定。 |
+| 由 WorkBuddy 等外部 Agent 调用 | 外部 Agent 可通过本地接口读取其请求的来源、稿件和结果；这些内容可能随后进入外部 Agent 自己的模型服务。由它提交的生成任务，仍使用 BriefLoop 工作区配置的宿主。 |
+
+**实际接收方以宿主配置为准。** 自定义 Base URL、代理或模型网关可能先接收请求，再转发给模型厂商；仅凭模型名称不能判断文件内容最终经过哪些服务。第三方的保存期限、日志和训练使用规则取决于其服务与账户配置，BriefLoop 不统一控制这些规则。
 
-BriefLoop 在本机运行，但它不是离线工具。开始用之前请先分清三件事：
+工作区中的数据库、来源原件、稿件、Wiki、日志和审计包均可能包含敏感信息。删除本地文件不会自动删除第三方已经接收的内容；分享工作区、日志或审计包前，请检查其中的材料与个人信息。凭据保存在本机相应宿主或连接器配置中，不要把凭据文件随工作区或代码一起分享。
 
-- **会离开本机**：你上传的材料，以及生成的稿件与图片，**会发送给你所选宿主所连接的模型提供方**，用于生成、评价与修订。开启联网检索时，请求会发送给所选搜索服务；使用 Tavily 时由 Tavily 处理，也可能使用宿主自带的搜索工具。
-- **留在本机**：工作区目录、数据库、来源原件、稿件版本、评分与审计包。模型与搜索凭据保存在本机相应配置中。日志和模型生成内容可能带有敏感信息，分享前仍需检查。
-- **不对外提供访问**：本地服务只监听本机地址，不向局域网或互联网暴露。
+本地服务默认只监听 `127.0.0.1`，不直接开放公网访问。Agent 能读取哪些文件、执行哪些命令，由当前宿主实际支持的权限控制决定；“只读”不代表读取到的内容不会发送给云端模型，检索开关也不等同于所有宿主的网络隔离。
 
-所以，请按材料本身的敏感程度选择宿主与模型，并遵守你所在机构关于材料外发的规定。**把内部材料交给本地工具，和把内部材料交给某家模型厂商，是两件事。**
+安装依赖、检查版本和下载更新还会访问相应的软件分发服务，这些请求与报告材料处理分开。使用内部或保密材料前，请确认所选宿主、模型、代理、搜索和连接器符合你的材料外发要求。
 
 模型的可用性和计费由所选宿主及提供方决定；BriefLoop 的本地服务不提供模型额度。
 
@@ -196,7 +209,7 @@ Word 按按钮制作，完成后下载；不实时更新 Word，不提供网页
 
 ## 升级、边界与文档
 
-0.20.1 新增本地外部任务入口：WorkBuddy 等可执行本机命令的 Agent 可连接已有工作区，提交报告、查询进度、保存指定版本的修订和下载 Word。使用说明见 [WorkBuddy 外部入口](docs/WorkBuddy外部入口.md)；可使用 `pip install --upgrade briefloop==0.20.1` 安装；既有 0.20.0 桌面安装包不包含此入口。
+0.20.1 新增本地外部任务入口：WorkBuddy 等可执行本机命令的 Agent 可连接已有工作区，提交报告、查询进度、保存指定版本的修订和下载 Word。使用说明见 [WorkBuddy 外部入口](docs/WorkBuddy外部入口.md)；可使用 `pip install --upgrade briefloop==0.20.2` 安装；既有 0.20.0 桌面安装包不包含此入口。
 
 会议纪要内容方法也在后续源码中接入：选择内置纪要模板即可建议相应用途，输入本次会议转写或笔记，整理决议、待办和未定事项。见 [会议纪要说明与合成材料](docs/会议纪要.md)。
 

{briefloop-0.20.1 → briefloop-0.20.3}/THIRD_PARTY_NOTICES.md

@@ -10,3 +10,8 @@
 - pypdfium2 / PDFium：用于本地 PDF 页面渲染，通过 Python 依赖安装。pypdfium2 包声明 BSD-3-Clause、Apache-2.0 及其依赖许可，完整许可随依赖包保留。
 
 - OpenDesign（be0887b39273993d939e83c4768922115f104bed）：Apache-2.0。复用原生运行时协议和模型目录辅助代码，来源与本地改动见 third_party/open-design/NOTICE.md；许可证同时随打包后的 runtime bridge 分发。
+
+### Runtime identification icons
+
+Runtime SVG/PNG assets (listed in the NOTICE) come unmodified from [Open Design](https://github.com/nexu-io/open-design/tree/be0887b39273993d939e83c4768922115f104bed/apps/web/public/agent-icons), Apache-2.0; see `third_party/open-design/LICENSE` and `NOTICE.md`.
+`static/runtime-codebuddy.svg` is the unmodified site icon from [CodeBuddy](https://www.codebuddy.cn), retrieved 2026-09-13 from https://download.codebuddy.cn/web/website/93a7cd0d70556625552d16b09c6a9cf8c2e089b9/assets/logo.svg. Brand artwork belongs to its respective owner and is used only to identify the corresponding runtime.

briefloop-0.20.3/VERSION

@@ -0,0 +1 @@
+0.20.3

{briefloop-0.20.1 → briefloop-0.20.3}/desktop/electron/package-lock.json

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

{briefloop-0.20.1 → briefloop-0.20.3}/desktop/electron/package.json

@@ -1,6 +1,6 @@
 {
   "name": "briefloop-desktop",
-  "version": "0.20.1",
+  "version": "0.20.3",
   "private": true,
   "description": "BriefLoop local desktop workspace",
   "author": "Stahl-G",
@@ -11,7 +11,9 @@
     "test": "node --test test/*.test.cjs",
     "pack": "electron-builder --mac dir --arm64 --publish never",
     "dist": "electron-builder --mac dmg zip --arm64 --publish never",
-    "postinstall": "node node_modules/electron/install.js"
+    "postinstall": "node node_modules/electron/install.js",
+    "dist:signed": "node scripts/build-mac-signed.cjs",
+    "signing:check": "node scripts/build-mac-signed.cjs --check"
   },
   "devDependencies": {
     "electron": "44.3.0",

{briefloop-0.20.1 → briefloop-0.20.3}/docs/WorkBuddy/345/244/226/351/203/250/345/205/245/345/217/243.md

@@ -23,6 +23,10 @@
 
 ## 服务范围
 
-接口只连接已验证身份的本机工作区服务，复用 Host 校验、会话 Token 和退出停止接收请求的逻辑。CLI 不打印 Token，不读取模型凭据。服务端每次请求再次检查 workspace_id；工作区更换或服务未就绪会明确失败。
+接口只连接已验证身份的本机工作区服务，复用 Host 校验、会话 Token 和退出停止接收请求的逻辑。CLI 不打印 Token，不读取模型凭据。外部 action 和客户端文件下载再次检查 workspace_id；工作区更换或服务未就绪会明确失败。
+
+私有 GET（包括握手、材料、稿件和所有下载接口）拒绝明确的外站 Origin，以及 Fetch Metadata 中的跨源请求；同机不同端口也属于跨源。根页和静态界面仍可从外部链接打开，再从工作区内下载。正常同源链接、地址栏导航和不带这些浏览器头的本机 CLI 保持可用，不在下载 URL 中放 Token。
+
+会话 Token 用于 JSON POST 的浏览器请求防护；下载 GET 不要求自定义 Token 头。外部客户端先通过带 Token 的 action/query 校验产物，再流式下载并核对哈希。这不是同机用户或进程之间的权限隔离：能访问本机服务的原生进程可以请求握手 Token；Origin/Fetch Metadata 也不是原生进程的身份证明。
 
 接口细节和可复制的请求示例以随包的 [Skill](../src/briefloop/skill_assets/briefloop-external/SKILL.md) 为准。`inspect` 默认返回最近 100 个来源和 20 个稿件；已知历史 ID 仍可精确读取。

{briefloop-0.20.1 → briefloop-0.20.3}/docs/architecture.md

@@ -81,7 +81,7 @@ flowchart TB
 
 ## 分层说明
 
-1. **界面层**：界面源码在 `frontend/`（app.js、rich-document.js），由 esbuild 打包（`npm run build`，`package.json`）输出到 `src/briefloop/static/app.js`，Python 服务只发布 `static/`（原生无框架运行时 + 打包后的 bundle，含 tiptap 富文档依赖）。浏览器用带 `X-BriefLoop-Token` 的 JSON 请求访问 `/api/*`，token 过期时自动重新握手（`frontend/app.js:40` 的 `api()`）。
+1. **界面层**：界面源码在 `frontend/`（app.js、rich-document.js），由 esbuild 打包（`npm run build`，`package.json`）输出到 `src/briefloop/static/app.js`，Python 服务只发布 `static/`（原生无框架运行时 + 打包后的 bundle，含 tiptap 富文档依赖）。浏览器的 JSON POST 带 `X-BriefLoop-Token`，token 过期时自动重新握手（`frontend/app.js:40` 的 `api()`）。
 
 2. **服务层**：`cli.py` 的 `serve/start` 进入 `server.py:make_server()`。服务先取得 `platform_support.WorkspaceLock`，再初始化 Store；POSIX 使用 `flock`，Windows 使用排他字节锁。启动时组装各 Harness 管理器和 `Worker`，并一次性恢复中断的会话状态（`harness.chat.recover_stale()`）。`GET /api/state` 返回整个工作区快照，写操作走 `POST /api/<命令>`。
 
@@ -99,3 +99,5 @@ flowchart TB
 - 一个工作区同时只允许一个服务实例（`platform_support.WorkspaceLock` 的操作系统锁）。Windows 所属宿主进程树由 Job Object 回收；它不提供文件或网络隔离。
 - runtime-bridge 需要本机 Node 20+，构建产物为 `src/briefloop/static/runtime-bridge.mjs`（`runtime-bridge/build.mjs`）。
 - 后端可选：`codex/opencode/claude/kimi/hermes/reasonix/mimo`（`cli.py:21`），ACP 类宿主经 Node 桥。
+
+私有 GET 统一检查 Origin 与 Fetch Metadata，拒绝明确的跨源浏览器请求（包括同机不同端口）。同源链接、地址栏导航及无浏览器来源头的本机客户端仍可下载，不在 URL 中携带会话 Token。服务仅监听 127.0.0.1 并严格校验 Host；这些机制不隔离同机进程，握手 Token 也不构成 OS 用户级认证。

{briefloop-0.20.1 → briefloop-0.20.3}/docs/windows.md

@@ -14,6 +14,10 @@ Windows 桌面应用使用 Electron，复用同一套 Python 服务、WebUI、SQ
 
 ## 启动与退出
 
+桌面应用一次管理一个工作区。切换前先预检目标目录和运行环境，目标无效时保留当前工作区。完成保存和任务停止后，若目标启动失败，会在确认目标服务退出后尝试恢复原工作区；恢复以暂停状态启动，不自动重新提交中断任务。恢复失败会明确提示，已保存内容仍留在原目录。需要同时运行独立服务时使用 CLI/WebUI，其进程不由这个桌面窗口接管。
+
+桌面主进程持有专用 stdin 管道的唯一写端，服务通过 `BRIEFLOOP_DESKTOP_OWNER_PIPE=1` 和本次启动标识启用所有者监测。主进程异常退出后，管道 EOF 让配套 Python 后端受控取消任务并清理所属后代，释放工作区；独立 CLI 不受影响。强制结束不能保证未保存编辑落盘。此行为需配套后端合约和对应产物验收，不属于下文旧安装基线的既有验证结论。
+
 安装后的桌面应用从快捷方式启动，环境就绪后新建或打开工作区。开发者仍可在 PowerShell 使用 `start.ps1 -Python <python.exe 的路径>` 指定解释器，或运行 `python -X utf8 bootstrap.py`；这条源码启动路径的 bridge 需要单独的 Node.js 20+。启动器、CLI 和 agent 工具使用 UTF-8。
 
 每个工作区先取得排他锁，再打开数据库。Windows 桌面服务直接启动已验证的基础 Python，并仅向该子进程传入 venv 启动标识，保留专属 venv 的模块路径，使应用持有的子进程 PID 与实际服务 PID 一致。就绪校验仍要求本次启动标识、确切 PID 和本机地址匹配；第二实例不能改变原服务设置。

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

@@ -6,7 +6,7 @@
 
 工作区是一个本地目录，保存数据库、来源、稿件、对话和 Wiki。空目录也能使用：先描述目标，或在“材料与需求”设置正式报告要求。打开目录不意味着模型已经开始工作。
 
-侧栏可以切换最近工作区、打开目录或新建目录。切换不会停止其他工作区中的任务。打开尚未运行的已有工作区时，旧排队任务保留供手动恢复，自动学习暂不启动；需要时在设置中明确开启。
+侧栏可以切换最近工作区、打开目录或新建目录。WebUI 切换不停止其他独立后台的任务；桌面 App 一次管理一个活动工作区，切换前保存并停止当前后台，运行中的任务会先请你确认停止。目标打开失败时尝试恢复原工作区，中断任务不会自动重发。打开尚未运行的已有工作区时，旧排队任务保留供手动恢复，自动学习暂不启动；需要时在设置中明确开启。
 
 对话输入区支持文件附件、联网、模型、推理档位、provider 和权限。空闲时发送开始一轮；运行中可以排队，或选择“立即补充”。“已送达”表示执行端接受输入，不等于已经执行要求。页面展示公开消息、工具活动和宿主返回的思考内容（折叠的“思考”条，仅本地查看）；思考内容不进入报告、通知或审计包。
 
@@ -73,3 +73,7 @@ K 控制一次反馈学习最多尝试多少轮；轮数越多消耗的 Token
 .venv/bin/briefloop status --workspace /path/to/workspace
 .venv/bin/briefloop doctor --workspace /path/to/workspace
 ```
+
+### 上传大小
+
+网页上传原件、Word 模板或 Word 修订时，单文件上限为 18 MiB；每个请求含 Base64 与 JSON 后须小于 25 MiB。多选文件逐个上传，先检查整批文件的大小，超限时显示文件名和本批总量，不先上传一部分。请压缩或拆分过大的文件后重试。来源文件是否可由模型读取，还取决于解析结果和所选宿主能力。

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

@@ -42,7 +42,7 @@ Word 保留所选模板的版式和支持的局部格式。正文长度改变时
 
 ## 开发接口
 
-- `POST /api/save` 接收 `base_version` 与 `editor_document`；旧 Markdown 保存仍可兼容。新报告以富文档内容为准，纯格式变化也产生版本。
+- `POST /api/save` 接收 `base_version` 与 `editor_document`；纯 Markdown 原稿仍可按 Markdown 保存。对富文档，仅提交相同 Markdown 投影不改变原版本；不同正文必须提交完整富文档，或显式设置 `allow_markdown_conversion: true` 进行替换，转换后的内容仍保存为富文档并记录基础版本。新报告以富文档内容为准，纯格式变化也产生版本。网页导入 Markdown 前会提示颜色、表格样式和图片布局可能丢失；取消不会修改正文，确认后原版本仍保留。
 - `POST /api/template-import` 接收 DOCX 的 `name`、base64 `data`，可提供更新来源 `parent_id`。
 - `POST /api/export` 接收 `version_id`，返回 `export_docx` 文件任务；完成后使用任务结果里的 `download_url`。
 - `GET /api/research-notes?version=...` 返回该版本的核查、待补与来源信息。

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

@@ -36,6 +36,10 @@ Electron 已包含运行桥接需要的 Node。无需另外为 BriefLoop 桌面
 
 WebUI 的行为有所不同：关闭浏览器标签页不会停止独立启动的后台服务。
 
+后台采用按需运行：Codex、OpenCode 和通用 CLI Bridge 没有活动回合、子任务、事件订阅或在途请求时，空闲 30 秒回收进程；后续使用按需重新启动。原生会话 ID 保存在工作区，支持续接的宿主可恢复原会话。任务队列空闲时降低查库频率，同服务提交会唤醒队列，其他进程提交最多等待 5 秒被发现。正在执行的报告不受这些空闲间隔限制。网页可见且无任务时每 15 秒检查状态，隐藏时每 60 秒检查；回到前台立即刷新，有活动任务时恢复原来的快速轮询。
+
+BriefLoop 不会仅因长时间没有鼠标或键盘操作就自动退出。未保存的编辑、正在执行的任务和外部 Agent 的调用仍需保留；要结束桌面后台，请正常退出应用。主动启动的 CLI `serve` 持续提供服务，直到用户停止它。
+
 ## 更新版本
 
 打开“设置 → 版本更新”：

briefloop-0.20.3/docs//350/277/220/350/241/214/346/227/266/351/200/211/346/213/251/344/270/216/346/243/200/346/265/213.md

@@ -0,0 +1,15 @@
+# 运行时选择与检测
+
+在“设置 → 模型与提供商 → 本机 CLI”查看运行时。每张卡片展示本地图标、简介、实际检测版本；选中项显示模型，其他项不会沿用当前宿主的模型名称。展开“安装与能力”可以查看路径、连接方式与已接入能力。
+
+未安装工具放在折叠列表里，展开后用双列卡片浏览，窄屏使用单列。没有品牌图片的工具使用中性的终端图形。
+
+- **已检测到**：找到可执行文件，可以选择宿主；账号和模型是否能调用，请使用卡片中的“测试”。
+- **已有适配 · 安装后可测试**：BriefLoop 有相应协议适配，本机还没检测到 CLI。安装后点击“重新检测”，再选择模型并测试。
+- **尚无协议适配**：目录能够识别工具，但该版本没有接通其执行协议；仅安装工具不能开启执行。
+
+ACP 是共用连接协议，但每个 CLI 仍有自己的启动命令、登录方式与能力协商。Kilo、Kiro、Vibe 复用现有 ACP Bridge；本轮接通了设置和执行入口，尚未安装的运行时不会显示为真实测试通过。受限审阅等能力仍由宿主实际权限决定。
+
+模型列表来自该宿主返回的目录、本机配置或明确标出的内置建议，也可输入模型 ID。选择目录中的模型不表示已验证账号权限。点击“测试”后会打开普通对话，显示回复、错误或停止状态；真实请求可能消耗所配置提供商的额度。
+
+首页的宿主选择器用于下一回合；已经开始或排队的回合保留冻结配置。运行时名称仍可在该回合的执行信息中查看。