briefloop 0.26.0__tar.gz → 0.26.1__tar.gz

{briefloop-0.26.0 → briefloop-0.26.1}/CHANGELOG.md

@@ -1,6 +1,14 @@
 # 变更记录
 
-## 0.26.0 · 发行候选（未发布）
+## 0.26.1 · 发行准备
+
+- 修复独立审阅评分重大问题未进入正式核查发现时仍被接纳为完成的缺陷；增加显式关联与历史交付防御，原始拒绝结果保留。重大证据问题不能借非强制条款降为普通提示，草稿编辑与下载继续可用。
+- 模型候选改为实时提供方 API / CLI 宿主目录，移除内置静态候选、具体型号自动预选与固定档位回退；保存连接后旧响应不会覆盖新目录。
+- 按用户要求移除依赖预选型号、必须额外强绑模型才能运行的旧测试；新的审阅接纳验证直接回放保存结果，不派发模型。
+
+发行与平台验证见 [0.26.1 记录](docs/release-0.26.1.md)，准备状态不表示现有安装已升级。
+
+## 0.26.0
 
 - 新增已有材料及联网快速报告：先保存可编辑下载的初稿，再后台补依据和评价；不额外限制输入字符数，用户编辑优先，正式交付继续绑定独立审阅。
 - 引用支持正文原句、来源标题与原文上下文；数字检查显示实际可核对范围。快速稿补充事实状态、日期、范围与语义支持检查，未核查保持明确；独立审阅展示逐条结论判断及未核查事项。
@@ -9,7 +17,7 @@
 - 模型目录按需刷新，报告列表与状态查询优化；增加后台原件读取、Word/已有报告模板入口、表格与分页保护，以及导出版本恢复和内部定位清理。
 - 纳入 Windows UTF-8 读取/锁修复、SQLite 测量工具和隔离语义实验。没有把实验指标或单个平台检查当作正式发行验收。
 
-本版本正在集成；渠道与原生安装验收仍按 [发行候选清单](docs/release-0.26.0.md) 推进，不表示现有 App 或 PyPI 已升级。
+0.26.0 已发布至 GitHub Releases 与 PyPI；冻结前的 [候选清单](docs/release-0.26.0.md) 保留为历史过程记录，实际渠道与原生验收边界见正式发行说明。
 
 ## 0.25.0
 

{briefloop-0.26.0 → briefloop-0.26.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.26.0
+Version: 0.26.1
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT
@@ -136,14 +136,16 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 
 ## 执行后端与模型
 
+新工作区不预选具体模型或思考强度。BriefLoop Agent 从已保存提供方的模型 API 实时读取目录；Agent CLI 使用所选宿主公开的目录或本机路由。打开选择器或点击刷新会重新查询，失败不填回静态模型清单。页面区分目录来源、查询时间和错误；目录可见不代表推理调用已通过。提供方不支持列举模型时仍可手输 ID，已有用户选择和在运行任务不被目录刷新改写。
+
 工作区默认使用 Codex（Responses 通道）。执行宿主可在启动时用 `--backend` 指定，或在网页设置页切换；已排队/已开始的任务冻结原后端，不跟随切换。设置页会检测本机已安装的 CLI，并读取各自的模型目录。
 
 | 宿主 | 接入方式 | 模型目录 |
 | --- | --- | --- |
 | Codex | 原生 app-server | 原生 `debug models` |
 | Opencode | 本机原生服务 | 本机 provider/model 配置 |
-| Claude Code | bridge（stream-json） | 本机路由；无路由时给内置建议 |
-| Kimi、Hermes | bridge（ACP） | ACP 模型目录；读取失败给内置建议 |
+| Claude Code | bridge（stream-json） | 本机路由；未公开目录时支持宿主默认或手输 |
+| Kimi、Hermes | bridge（ACP） | ACP 模型目录；读取失败明确显示原因 |
 | Reasonix | bridge（ACP） | 原生 `doctor --json` |
 | MiMo | bridge（JSON 事件流） | 原生 `models --verbose` |
 | CodeBuddy Code | bridge（原生 `--acp`） | ACP 原生模型目录；支持手输模型 ID |

{briefloop-0.26.0 → briefloop-0.26.1}/README.md

@@ -96,14 +96,16 @@ Windows 也可不安装桌面 App，直接启动同一套 Python 服务与网页
 
 ## 执行后端与模型
 
+新工作区不预选具体模型或思考强度。BriefLoop Agent 从已保存提供方的模型 API 实时读取目录；Agent CLI 使用所选宿主公开的目录或本机路由。打开选择器或点击刷新会重新查询，失败不填回静态模型清单。页面区分目录来源、查询时间和错误；目录可见不代表推理调用已通过。提供方不支持列举模型时仍可手输 ID，已有用户选择和在运行任务不被目录刷新改写。
+
 工作区默认使用 Codex（Responses 通道）。执行宿主可在启动时用 `--backend` 指定，或在网页设置页切换；已排队/已开始的任务冻结原后端，不跟随切换。设置页会检测本机已安装的 CLI，并读取各自的模型目录。
 
 | 宿主 | 接入方式 | 模型目录 |
 | --- | --- | --- |
 | Codex | 原生 app-server | 原生 `debug models` |
 | Opencode | 本机原生服务 | 本机 provider/model 配置 |
-| Claude Code | bridge（stream-json） | 本机路由；无路由时给内置建议 |
-| Kimi、Hermes | bridge（ACP） | ACP 模型目录；读取失败给内置建议 |
+| Claude Code | bridge（stream-json） | 本机路由；未公开目录时支持宿主默认或手输 |
+| Kimi、Hermes | bridge（ACP） | ACP 模型目录；读取失败明确显示原因 |
 | Reasonix | bridge（ACP） | 原生 `doctor --json` |
 | MiMo | bridge（JSON 事件流） | 原生 `models --verbose` |
 | CodeBuddy Code | bridge（原生 `--acp`） | ACP 原生模型目录；支持手输模型 ID |

briefloop-0.26.1/VERSION

@@ -0,0 +1 @@
+0.26.1

{briefloop-0.26.0 → briefloop-0.26.1}/desktop/electron/package-lock.json

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

{briefloop-0.26.0 → briefloop-0.26.1}/desktop/electron/package.json

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

briefloop-0.26.1/docs/release-0.26.1.md

@@ -0,0 +1,19 @@
+# BriefLoop 0.26.1
+
+本次为 0.26.0 后的修复版本，当前处于发行准备；渠道状态以正式 Release 与验收记录为准。
+
+## 审阅结果不能丢失重大问题
+
+独立审阅中的评分发现与正式核查发现增加关联检查。模型在评分里指出重大问题，却没有把它纳入正式发现时，产品会要求补全审阅，不再接受为完整结果。错误指出需要处理的条目，原始输出保留，普通草稿仍可编辑与下载。
+
+旧版本已经保存的不一致审阅也会在正式交付前被识别；旧记录和原稿不改写，需要补全或重新完成审阅。程序不根据相似措辞猜测关联、不把评分条目自动转换为已核查事实。明确关联的描述可以不同；未提供关联的旧结果只在描述完全相同时兼容。
+
+## 模型目录来自实际服务
+
+BriefLoop Agent 查询已保存提供方的模型 API；Agent CLI 使用宿主目录或本机路由。不再展示内置静态模型建议，新工作区也不自动选具体模型和 High。页面明确目录来源、查询状态和错误；提供方不支持列举模型时可手动输入 ID。保存连接后迟到的旧请求不能覆盖新目录。
+
+已保存的模型选择与运行任务保持原配置。目录能读取不代表已验证推理、工具调用或账户额度；必要的模型协议兼容信息仍单独保留。
+
+## 验证边界
+
+审阅修复使用原始失败结果的副本回放及无需模型派发的离线接纳/交付检查；未改写实验原件，不将结构通过等同事实正确。模型目录已在提供方 API 与网页验证，连接失败也如实显示。各平台安装、导出和更新结果将在冻结构建后单独记录。0.26.0 的原生验收记录不计为本版通过。

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

@@ -20,7 +20,7 @@
 
 ## 模型与权限
 
-主链和 Evaluator、Wiki Maintainer、Skill Proposer 可以分别配置模型。常用模型只是输入建议，自定义 ID 原样交给所选宿主。Codex 的 provider 填写本机 Codex 中已经配置的名称，留空沿用本机配置；其它宿主使用它自己的账号与模型配置（Opencode 可另外在“API 提供商”登记协议、Base URL、Key 和模型）。“模型默认”不额外传推理档位。
+主链和 Evaluator、Wiki Maintainer、Skill Proposer 可以分别配置模型。模型候选来自实时提供方 API 或所选宿主目录，不使用内置模型建议；自定义 ID 原样交给所选宿主。Codex 的 provider 填写本机 Codex 中已经配置的名称，留空沿用本机配置；其它宿主使用它自己的账号与模型配置（Opencode 可另外在“API 提供商”登记协议、Base URL、Key 和模型）。“模型默认”不额外传推理档位。
 
 执行宿主可在设置页切换，已排队或已开始的任务冻结原宿主。输入区只显示当前宿主真正支持的控件：权限档位来自宿主声明的能力，只有一个档位时不显示该下拉；“立即补充”只在支持运行中追加的宿主出现；不支持读图的宿主会在附图时直接提示。切换宿主会清空不再适用的角色模型，留空即继承主链模型。
 

{briefloop-0.26.0 → briefloop-0.26.1}/docs//345/206/205/347/275/256/345/274/225/346/223/216.md

@@ -4,7 +4,7 @@
 
 ## 使用入口
 
-在“设置 → 模型与提供商”选择“BriefLoop 内置引擎”。在 API 提供商表单选择用于内置引擎，填写 Provider ID、接口地址、API Key、模型 ID，然后保存并选用。支持表单中的 Chat Completions、Responses 和 Anthropic Messages 协议；不同提供商实际支持的接口和工具能力仍需短测试确认。模型格式为 `provider/model`，可从已配置目录选择或直接输入。
+在“设置 → 模型与提供商”选择“BriefLoop 内置引擎”。在 API 提供商表单选择用于内置引擎，填写 Provider ID、接口地址、API Key、模型 ID，然后保存并选用。支持表单中的 Chat Completions、Responses 和 Anthropic Messages 协议；不同提供商实际支持的接口和工具能力仍需短测试确认。模型格式为 `provider/model`，候选实时读取已保存提供方的 API，不合并 Pi 内置清单或实验预设；提供方不提供目录时仍可直接输入。目录读取与推理连通性分别显示。未选择思考强度时沿用 Pi SDK 默认或恢复会话的原档位，不额外指定 Low/High。
 
 密钥保存在本机 `~/.config/briefloop/native-engine/providers.json`，权限为当前用户读写，不进入工作区、Git、报告、核查包或目录返回值。留空密钥可保留该模型已有密钥。同一提供商使用同一接口与密钥。环境需要 Node.js 22.19+；桌面可使用随壳提供的 Node 模式，不需要安装 OpenCode 或其他 Agent CLI。
 

{briefloop-0.26.0 → briefloop-0.26.1}/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

@@ -10,6 +10,6 @@
 
 ACP 是共用连接协议，但每个 CLI 仍有自己的启动命令、登录方式与能力协商。Kilo、Kiro、Vibe 复用现有 ACP Bridge；本轮接通了设置和执行入口，尚未安装的运行时不会显示为真实测试通过。受限审阅等能力仍由宿主实际权限决定。
 
-模型列表来自该宿主返回的目录、本机配置或明确标出的内置建议，也可输入模型 ID。选择目录中的模型不表示已验证账号权限。点击“测试”后会打开普通对话，显示回复、错误或停止状态；真实请求可能消耗所配置提供商的额度。
+BriefLoop Agent 的模型列表来自已保存提供方的 API；Agent CLI 的列表来自宿主目录或本机路由。打开选择器或刷新时重新查询，读取失败会显示原因，不添加内置模型建议；仍可输入模型 ID。选择目录中的模型不表示已验证账号权限。点击“测试”后会打开普通对话，显示回复、错误或停止状态；真实请求可能消耗所配置提供商的额度。
 
 首页的宿主选择器用于下一回合；已经开始或排队的回合保留冻结配置。运行时名称仍可在该回合的执行信息中查看。

{briefloop-0.26.0 → briefloop-0.26.1}/frontend/app.js

@@ -5,6 +5,7 @@ import {api,uploadSource,setToken,getUploadLimits,setSourceUploadHost} from './a
 import {createReportBrowsing} from './report-browsing.js';
 import {createSourceLibrarySearch} from './source-library-search.js';
 import {createProviderCapabilities} from './provider-capabilities.js';
+import {createModelCatalog,createProviderCatalog} from './model-catalog.js';
 const providerCapabilities=createProviderCapabilities({$});
 const reasoning=reasoningControls({api});
 import {createAssessmentPanel} from './assessment-panel.js';
@@ -386,7 +387,7 @@ function render(first){
  renderWorkflowChoices(first);
  if($('review-open'))$('review-open').textContent='审阅与需处理'+(state.conflicts?.length?' · '+state.conflicts.length+' 项来源分歧':'');
  if(first&&$('report-system-clock')&&state.system_clock)$('report-system-clock').textContent=`本机日期：${state.system_clock.today} · ${state.system_clock.timezone}；提交时再次由后台核对。`;
- if(first){$('settings-chat-web-default').checked=state.settings.chat_allow_web!==false;$('chat-allow-web').checked=state.settings.chat_allow_web!==false;$('timeout-minutes').value=state.settings.timeout_minutes;$('hard-timeout-minutes').value=state.settings.hard_timeout_minutes||0;$('company-mode').value=state.settings.company_context_enabled==null?'ask':state.settings.company_context_enabled?'on':'off';$('auto-revision').checked=state.settings.auto_revision!==false;state.sources.filter(s=>s.status==='ready').forEach(s=>selected.add(s.id));$('rounds').value=state.settings.k;$('auto-learn').checked=state.learning_authorization?.state==='authorized';$('model-select').value=state.settings.model_selection_required?'':state.settings.model||'gpt-5.6-luna';assignEffort('effort-select',settingsEffort(state.settings,state.settings.agent_backend||'codex'));$('model-provider').value=state.settings.model_provider||'';$('service-tier').value=state.settings.service_tier||'';$('agent-backend').value=state.settings.agent_backend||'codex';$('model-variant').value=state.settings.agent_backend==='mimo'?(state.settings.runtime_efforts?.mimo||''):(state.settings.model_variant||'');updateModelLabel();renderRoleModels();renderReviewRuntime();renderBackend();loadSearchPolicy();renderSearchProvider();refreshRuntimeDiscovery();office.syncSettingsToggle();if(state.requirements)for(const [k,v] of Object.entries(state.requirements)){const e=$('requirements').elements[k];if(e)e.type==='checkbox'?e.checked=v:e.value=v}$('requirements').elements.key_questions_text.value=(state.requirements?.key_questions||[]).join('\n');$('requirements').elements.manual_sections_text.value=(state.requirements?.manual_sections||[]).join('\n');reportLanguageForm.restore(state.requirements?.language);initializeLengthInputs(state.requirements||{});initializeResearchBudget(state.requirements||{});initializeReportProfile(state.requirements||{});if(!state.requirements||state.requirements.fact_check==null)$('requirements').elements.fact_check.checked=!!state.settings.fact_checker;syncFactCheckControl();quickReport.sync();syncWorkflowProfile(false);previewReportTime()}
+ if(first){$('settings-chat-web-default').checked=state.settings.chat_allow_web!==false;$('chat-allow-web').checked=state.settings.chat_allow_web!==false;$('timeout-minutes').value=state.settings.timeout_minutes;$('hard-timeout-minutes').value=state.settings.hard_timeout_minutes||0;$('company-mode').value=state.settings.company_context_enabled==null?'ask':state.settings.company_context_enabled?'on':'off';$('auto-revision').checked=state.settings.auto_revision!==false;state.sources.filter(s=>s.status==='ready').forEach(s=>selected.add(s.id));$('rounds').value=state.settings.k;$('auto-learn').checked=state.learning_authorization?.state==='authorized';$('model-select').value=state.settings.model_selection_required?'':state.settings.model||'';assignEffort('effort-select',settingsEffort(state.settings,state.settings.agent_backend||'codex'));$('model-provider').value=state.settings.model_provider||'';$('service-tier').value=state.settings.service_tier||'';$('agent-backend').value=state.settings.agent_backend||'codex';$('model-variant').value=state.settings.agent_backend==='mimo'?(state.settings.runtime_efforts?.mimo||''):(state.settings.model_variant||'');updateModelLabel();renderRoleModels();renderReviewRuntime();renderBackend();loadSearchPolicy();renderSearchProvider();refreshRuntimeDiscovery();office.syncSettingsToggle();if(state.requirements)for(const [k,v] of Object.entries(state.requirements)){const e=$('requirements').elements[k];if(e)e.type==='checkbox'?e.checked=v:e.value=v}$('requirements').elements.key_questions_text.value=(state.requirements?.key_questions||[]).join('\n');$('requirements').elements.manual_sections_text.value=(state.requirements?.manual_sections||[]).join('\n');reportLanguageForm.restore(state.requirements?.language);initializeLengthInputs(state.requirements||{});initializeResearchBudget(state.requirements||{});initializeReportProfile(state.requirements||{});if(!state.requirements||state.requirements.fact_check==null)$('requirements').elements.fact_check.checked=!!state.settings.fact_checker;syncFactCheckControl();quickReport.sync();syncWorkflowProfile(false);previewReportTime()}
  $('source-count').textContent=state.sources.length+' 份';$('source-list').innerHTML=state.sources.map(s=>`<div class="source-item"><input type="checkbox" data-check="${s.id}" ${selected.has(s.id)?'checked':''} ${s.status!=='ready'?'disabled':''} aria-label="选择 ${esc(s.name)}"><button data-source="${s.id}">${esc(s.name)}</button><span class="tag ${s.status==='failed'?'error':''}">${esc(sourceStatusLabel(s))}</span>${['failed','cancelled','interrupted'].includes(s.status)?`<button data-retry-source="${s.id}">重试</button>`:''}</div>`).join('');
  document.querySelectorAll('[data-retry-source]').forEach(b=>b.onclick=()=>action(async()=>{const s=await api('retry-source',{source_id:b.dataset.retrySource});selected.delete(b.dataset.retrySource);if(s.status==='ready')selected.add(s.id);notice(sourceStatusLabel(s),['failed','cancelled','interrupted'].includes(s.status))}));
  document.querySelectorAll('[data-check]').forEach(b=>b.onchange=()=>{if(b.checked){selected.add(b.dataset.check);referenceSelected.delete(b.dataset.check);renderReferenceSources()}else selected.delete(b.dataset.check)});renderReferenceSources();
@@ -719,8 +720,8 @@ async function refreshProgress(){
  finally{if(progressRequest===request)progressRequest=null}
 }
 
-function friendlyModel(model){return ({'default':'宿主默认模型','gpt-5.6-luna':'Luna','gpt-5.6-terra':'Terra','gpt-5.6-sol':'Sol','gpt-6-astra':'Astra'}[model]||model)}
-function effortValue(runtime,key){return Object.prototype.hasOwnProperty.call(runtime,key)?(runtime[key]||'none'):'high'}
+function friendlyModel(model){return model==='default'?'宿主默认模型':model}
+function effortValue(runtime,key){return Object.prototype.hasOwnProperty.call(runtime,key)?(runtime[key]||'none'):'none'}
 function assignEffort(id,value){const input=$(id);if(![...input.options].some(o=>o.value===value))input.add(new Option(value,value));input.value=value}
 function activeChatRuntime(){return chat.messages.find(m=>m.role==='user'&&m.turn_id===chat.session?.turn_id&&m.runtime)?.runtime||chat.session?.runtime||{}}
 const fastCapabilities=new Map();
@@ -738,7 +739,7 @@ function renderBackend(){
  $('variant-field').hidden=!variant;document.querySelector('.main-provider-field').style.display=codex?'':'none';
  $('effort-select').hidden=variant;$('effort-select').closest('label').hidden=variant;
  reasoning.configure($(variant?'model-variant':'effort-select'),backend,$('model-select').value.trim(),{variant});
- $('model-select').placeholder=['opencode','briefloop-native'].includes(backend)?'如 opencode-go/gpt-5.6-luna':'输入任意模型 ID';
+ $('model-select').placeholder=['opencode','briefloop-native'].includes(backend)?'输入 provider/model':'输入任意模型 ID';
  document.querySelectorAll('.role-variant-field').forEach(e=>e.hidden=!variant);
  document.querySelectorAll('.role-provider-field').forEach(e=>e.style.display=codex?'':'none');
  document.querySelectorAll('.role-effort-select').forEach(e=>{e.style.display=variant?'none':'';reasoning.configure(variant?$(`role-${e.dataset.roleEffort}-variant`):e,backend,$(`role-${e.dataset.roleEffort}-model`).value.trim()||$('model-select').value.trim(),{variant})});
@@ -796,65 +797,14 @@ async function refreshRuntimeDiscovery(force=false){
  $('runtime-discovery-status').textContent='正在检测执行引擎…';$('runtime-discovery-refresh').disabled=true;
  try{const data=await api('runtimes'+(force?'?refresh=1':''));runtimeCatalog=data.runtimes||[];renderRuntimeDiscovery();if(typeof office!=='undefined'&&data.capabilities?.officecli)office.renderSettingsCapability(data.capabilities.officecli);$('runtime-discovery-status').textContent=`检测到 ${runtimeCatalog.filter(r=>r.installed).length} 个本机 CLI，其中 ${runtimeCatalog.filter(r=>r.available).length} 个可选择；检测未验证账号与模型调用，需另行短测试。`+(data.diagnostic?` ${data.diagnostic}`:'');await refreshModelSuggestions(force)}catch(e){$('runtime-discovery-status').textContent='检测失败：'+e.message}finally{$('runtime-discovery-refresh').disabled=false;runtimeScanned=true;if($('welcome')&&!$('welcome').hidden)renderWelcome()}
 }
-$('agent-backend').onchange=()=>action(async()=>{const backend=backendValue(),dropped=Object.keys(state.settings.role_models||{}).length;await api('settings',{agent_backend:backend,model_selection_required:true,role_models:{}});state.settings.agent_backend=backend;state.settings.model_selection_required=true;state.settings.role_models={};assignEffort('effort-select',settingsEffort(state.settings,backend));$('model-variant').value=backend==='mimo'?(state.settings.runtime_efforts?.mimo||''):(state.settings.model_variant||'');reasoning.refresh();$('model-select').value='';$('chat-model').value='';modelCatalog={backend:null,at:0,models:[]};renderRuntimeDiscovery();renderRoleModels();renderBackend();updateComposer();await refreshModelSuggestions();notice(dropped?'宿主已切换；原宿主的角色模型已清空，留空即继承主链模型':'Runtime 已保存；请选择或输入模型')});$('model-variant').onchange=()=>action(saveModel,'Variant 已保存；下一次启动生效');
-let modelCatalog={backend:null,at:0,models:[]};
-const modelCatalogs=new Map();
-function modelTargetBackend(target){return target==='chat-model'?chatBackendChoice():backendValue()}
-async function fetchModelCatalog(force=false,backend=backendValue()){
- const now=Date.now(),cached=modelCatalogs.get(backend);
- if(!force&&cached&&now-cached.at<3600000){if(backend===backendValue())modelCatalog=cached;return cached.models;}
- let data;
- try{data=await api('models?backend='+encodeURIComponent(backend)+(force?'&refresh=1':''))}
- catch(error){if(force){const failure={backend,at:0,models:[],diagnostic:error.message||'模型目录读取失败'};modelCatalogs.set(backend,failure);if(backend===backendValue())modelCatalog=failure}throw error}
- const catalog={backend,at:now,models:(data.models||[]).map(m=>typeof m==='string'?{id:m,name:friendlyModel(m)}:{...m,name:m.name||m.label||friendlyModel(m.id),provider:m.provider||runtimeName(backend)}),diagnostic:data.diagnostic||data.error||'',source:data.source||'',note:data.note||''};modelCatalogs.set(backend,catalog);if(backend===backendValue())modelCatalog=catalog;refreshRuntimeModelSummaries();return catalog.models;
-}
-async function refreshModelSuggestions(force=false){
- if(force)fastCapabilities.clear();renderFastControls();
- const backend=backendValue();$('model-suggestions').innerHTML='';refreshInlineModelPickers();
- try{const models=await fetchModelCatalog(force);if(backend!==backendValue())return;
- $('model-suggestions').innerHTML=models.map(m=>`<option value="${esc(m.id)}" label="${esc(m.name||m.id)}"></option>`).join('');refreshInlineModelPickers();
- if($('runtime-model-status'))$('runtime-model-status').textContent=modelCatalog.diagnostic||`${runtimeName(backend)}：${models.length} ${modelCatalog.source==='builtin_hints'?'项内置建议':'个模型'}${modelCatalog.source?' · '+({native_config:'本机配置',host:'宿主目录',host_default_only:'宿主未提供目录',builtin_hints:'非实时目录',local_routes:'本机路由'}[modelCatalog.source]||modelCatalog.source):''}。${modelCatalog.note||'可直接输入其他模型 ID。'}`;
- }catch(e){if($('runtime-model-status'))$('runtime-model-status').textContent='模型目录读取失败：'+e.message+'；可手动输入模型 ID。'}
-}
-let modelPickerTarget=null;
-async function openModelPicker(targetId){
-  modelPickerTarget=targetId;
-  $('model-picker-search').value='';
-  $('model-picker').showModal();
-  await refreshCurrentModelPicker();
-}
-function refreshCurrentModelPicker(){return renderModelPicker(true)}
-async function renderModelPicker(force=false){
-  const backend=modelTargetBackend(modelPickerTarget);let models,status,error='';
-  try{
-    models=await fetchModelCatalog(force,backend);refreshInlineModelPickers();
-    const note=modelCatalogs.get(backend)?.note;
-    status=`${runtimeName(backend)} · ${models.length} ${modelCatalogs.get(backend)?.source==='builtin_hints'?'项内置建议':'个模型'}；${note||'可手填模型 ID'}`;
-  }catch(e){models=[];error=e.message||'模型目录读取失败';refreshInlineModelPickers()}
-  const q=$('model-picker-search').value.trim().toLowerCase();
-  const shown=models.filter(m=>!q||m.id.toLowerCase().includes(q)||(m.name||'').toLowerCase().includes(q)||(m.provider||'').toLowerCase().includes(q));
-  $('model-picker-status').textContent=(error?('读取失败：'+error+'；可直接手填模型 ID'):(models.length?status:emptyCatalogLabel(backend,modelCatalogs.get(backend))))+(q?` · 筛出 ${shown.length} 个`:'');
-  let lastProvider=null,html='';
-  for(const m of shown){
-    if(m.provider!==lastProvider){lastProvider=m.provider;html+=`<h3 class="workspace-list-heading">${esc(m.provider)}</h3>`}
-    html+=`<button type="button" class="workspace-choice" data-model-pick="${esc(m.id)}"><span><strong>${esc(m.id)}</strong><small>${esc(m.name||'')}</small></span><em>选用</em></button>`;
-  }
-  const custom=$('model-picker-search').value.trim();
-  const customChoice=custom&&!/\s/.test(custom)&&!shown.some(m=>m.id===custom)?`<button type="button" class="workspace-choice" data-model-pick="${esc(custom)}"><span><strong>${esc(custom)}</strong><small>使用此模型 ID</small></span><em>选用</em></button>`:'';
-  $('model-picker-list').innerHTML=(html||(error?('<p class="help">读取失败：'+esc(error)+'</p>'):(models.length?'<p class="help">没有匹配的模型。可直接输入完整模型 ID 后按回车选用。</p>':'<p class="help">'+esc(emptyCatalogLabel(backend,modelCatalogs.get(backend)))+'</p>')))+customChoice;
-  $('model-picker-list').querySelectorAll('[data-model-pick]').forEach(b=>b.onclick=()=>pickModel(b.dataset.modelPick));
-}
-function pickModel(id){
-  const el=modelPickerTarget&&$(modelPickerTarget);
-  $('model-picker').close();
-  if(!el)return;
-  el.value=id;
-  el.dispatchEvent(new Event('change',{bubbles:true}));
-}
+$('agent-backend').onchange=()=>action(async()=>{const backend=backendValue(),dropped=Object.keys(state.settings.role_models||{}).length;await api('settings',{agent_backend:backend,model_selection_required:true,role_models:{}});state.settings.agent_backend=backend;state.settings.model_selection_required=true;state.settings.role_models={};assignEffort('effort-select',settingsEffort(state.settings,backend));$('model-variant').value=backend==='mimo'?(state.settings.runtime_efforts?.mimo||''):(state.settings.model_variant||'');reasoning.refresh();$('model-select').value='';$('chat-model').value='';renderRuntimeDiscovery();renderRoleModels();renderBackend();updateComposer();await refreshModelSuggestions();notice(dropped?'宿主已切换；原宿主的角色模型已清空，留空即继承主链模型':'Runtime 已保存；请选择或输入模型')});$('model-variant').onchange=()=>action(saveModel,'Variant 已保存；下一次启动生效');
+const modelDirectory=createModelCatalog({api,$,getBackend:backendValue,getChatBackend:chatBackendChoice,runtimeName,onCatalogChange:refreshRuntimeModelSummaries});
+const {catalogs:modelCatalogs,fetchModelCatalog,openModelPicker,refreshCurrentModelPicker,renderModelPicker,pickModel,refreshInlineModelPickers,setupModelPickers}=modelDirectory;
+async function refreshModelSuggestions(force=false){if(force)fastCapabilities.clear();renderFastControls();await modelDirectory.refreshModelSuggestions()}
 $('model-picker-close').onclick=()=>$('model-picker').close();
 $('model-picker-search').oninput=()=>renderModelPicker();
 $('model-picker-search').onkeydown=event=>{if(event.key==='Enter'&&!event.isComposing){event.preventDefault();const id=event.target.value.trim();if(id&&!/\s/.test(id))pickModel(id)}};
-$('model-picker-refresh').onclick=()=>action(refreshCurrentModelPicker,'模型目录已刷新');
+$('model-picker-refresh').onclick=()=>refreshCurrentModelPicker();
 $('model-select').onchange=()=>{reasoning.refresh();renderBackend();return action(saveModel,'模型已保存；下一次启动生效')};$('service-tier').onchange=()=>action(saveModel,'速度已保存；下一次启动生效');$('effort-select').onchange=()=>action(saveModel,'推理档位已保存；下一次启动生效');$('model-provider').onchange=()=>action(saveModel,'Provider 已保存；下一次启动生效');$('model-browse').onclick=()=>openModelPicker('model-select');
 $('model-apply-session').onclick=()=>{
  const session=chat.session;
@@ -933,7 +883,7 @@ function restoreDraft({preserveNewDraft=false}={}){
  const runtime=saved||sessionRuntime||fallback;
  // Searching is the expected default for a fresh chat; a saved draft keeps the user's own choice.
  $('chat-input').value=d?.text||'';chat.attachments=new Set(d?.sources||[]);$('chat-allow-web').checked=d&&('allow_web' in d)?!!d.allow_web:(chat.id?[...(chat.messages||[])].reverse().find(m=>m.role==='user'&&m.purpose!=='runtime_test')?.allow_web??(state.settings.chat_allow_web!==false):state.settings.chat_allow_web!==false);chat.hostOptions=runtime.host_options||{};
- $('chat-model').value=runtime.model||'';assignEffort('chat-effort',Object.hasOwn(runtime,'effort')?effortValue(runtime,'effort'):(backend==='codex'?'high':'none'));if($('chat-variant'))$('chat-variant').value=runtime.variant||(runtime.backend==='mimo'?runtime.effort:'')||'';
+ $('chat-model').value=runtime.model||'';assignEffort('chat-effort',Object.hasOwn(runtime,'effort')?effortValue(runtime,'effort'):'none');if($('chat-variant'))$('chat-variant').value=runtime.variant||(runtime.backend==='mimo'?runtime.effort:'')||'';
  $('chat-model-provider').value=runtime.model_provider||'';$('chat-service-tier').value=runtime.service_tier||'';$('chat-permission').value=runtime.permission||'workspace-write';
  renderAttachments();updateComposer();autoSizeChatInput();refreshInlineModelPickers();
 }
@@ -970,7 +920,7 @@ function renderChatRuntimePermissions(){
  const effortField=document.querySelector('label[for="chat-effort"]');
  if(effortField)effortField.hidden=['opencode','briefloop-native','mimo'].includes(backend);
 }
-function runtimeChoice(){const model=$('chat-model').value.trim();if(!model)throw Error('请输入模型 ID');const backend=chatBackendChoice();if(!['codex','opencode','briefloop-native'].includes(backend)){return {model:reasoningModel(backend,model,$('chat-effort').value),backend,effort:backend==='mimo'?($('chat-variant').value.trim()||null):($('chat-effort').value==='none'?null:$('chat-effort').value),permission:'runtime-native',host_options:chat.hostOptions||{}}}if(['opencode','briefloop-native'].includes(backend)){if(!model.includes('/'))throw Error('Opencode 模型必须是 provider/model 形式，例如 opencode-go/gpt-5.6-luna');return {model,backend,variant:($('chat-variant')?.value||'').trim()||null,permission:$('chat-permission').value}}return {model,backend,model_provider:$('chat-model-provider').value.trim()||null,effort:$('chat-effort').value,service_tier:selectedServiceTier('chat-service-tier',fastControlConfig('chat'),true),permission:$('chat-permission').value}}
+function runtimeChoice(){const model=$('chat-model').value.trim();if(!model)throw Error('请输入模型 ID');const backend=chatBackendChoice();if(!['codex','opencode','briefloop-native'].includes(backend)){return {model:reasoningModel(backend,model,$('chat-effort').value),backend,effort:backend==='mimo'?($('chat-variant').value.trim()||null):($('chat-effort').value==='none'?null:$('chat-effort').value),permission:'runtime-native',host_options:chat.hostOptions||{}}}if(['opencode','briefloop-native'].includes(backend)){if(!model.includes('/'))throw Error('模型必须是 provider/model 形式');return {model,backend,variant:($('chat-variant')?.value||'').trim()||null,permission:$('chat-permission').value}}return {model,backend,model_provider:$('chat-model-provider').value.trim()||null,effort:$('chat-effort').value,service_tier:selectedServiceTier('chat-service-tier',fastControlConfig('chat'),true),permission:$('chat-permission').value}}
 function messageTime(value){return clock(value)}
 function chatError(text=''){$('chat-error').textContent=text;$('chat-error').hidden=!text}
 function sessionMissing(error){return /会话或消息不存在|会话不存在/.test(String(error&&error.message||error||''))}
@@ -1509,7 +1459,7 @@ $('chat-permission').onchange=()=>{rememberDraft();updateComposer()};
 function showSettings(){$('settings-chat-web-default').checked=state.settings.chat_allow_web!==false;$('timeout-minutes').value=state.settings.timeout_minutes;$('hard-timeout-minutes').value=state.settings.hard_timeout_minutes||0;moveSearchSettings('settings');page('settings-dialog');$('settings-dialog').scrollIntoView({block:'start'});refreshRuntimeDiscovery();office.syncSettingsToggle();updateLearningPause().catch(()=>{});refreshTavilySettings().catch(()=>{})}
 $('settings-open').onclick=showSettings;$('settings-close').onclick=()=>page('chat');
 {
- const modelPanel=document.querySelector('.model-settings');const shortcut=document.createElement('div');shortcut.className='setup-settings-shortcut';shortcut.innerHTML='<div><span>生成模型</span><strong id="setup-model-summary">Luna / high</strong></div><button type="button" class="outline">模型与角色设置</button>';shortcut.querySelector('button').onclick=showSettings;modelPanel.before(shortcut);$('settings-model-block').append(modelPanel);
+ const modelPanel=document.querySelector('.model-settings');const shortcut=document.createElement('div');shortcut.className='setup-settings-shortcut';shortcut.innerHTML='<div><span>生成模型</span><strong id="setup-model-summary">未指定模型</strong></div><button type="button" class="outline">模型与角色设置</button>';shortcut.querySelector('button').onclick=showSettings;modelPanel.before(shortcut);$('settings-model-block').append(modelPanel);
  const providerRow=document.querySelector('.chat-provider-row');providerRow.querySelector('label').textContent='当前对话 Provider';providerRow.querySelector('span').textContent='用于当前对话下一次执行';$('settings-model-block').append(providerRow);
  const learningControl=document.querySelector('.learning-control'),learningHelp=learningControl.nextElementSibling,autoLearnLabel=$('auto-learn').closest('label');$('settings-learning-block').append(learningControl,learningHelp,autoLearnLabel);
  const link=document.createElement('button');link.type='button';link.className='outline feedback-settings';link.textContent='学习设置';link.onclick=showSettings;$('learn-now').before(link);
@@ -1879,43 +1829,6 @@ $('report-data-open').onclick=()=>action(async()=>{
 });
 
 
-// An explicit select lists every suggestion; the text input stays unrestricted.
-function emptyCatalogLabel(backend,catalog){const why=String(catalog?.diagnostic||'').trim()||'没有读取到模型列表';return `${runtimeName(backend)}：${why}（可直接输入模型 ID）`}
-function refreshInlineModelPickers(){
- const chatBackend=modelTargetBackend('chat-model');
- if(!modelCatalogs.has(chatBackend))fetchModelCatalog(false,chatBackend).then(()=>refreshInlineModelPickers()).catch(e=>{modelCatalogs.set(chatBackend,{backend:chatBackend,at:0,models:[],diagnostic:e.message||'模型目录读取失败'});refreshInlineModelPickers()});
- document.querySelectorAll('.model-picker-select').forEach(select=>{
-  const input=select.parentElement.querySelector('input');select.replaceChildren(new Option('▾',''));
-  const backend=modelTargetBackend(input?.id),catalog=modelCatalogs.get(backend),models=catalog?.models||[];
-  for(const model of models)select.add(new Option(model.name+' · '+model.id,model.id));
-  if(!models.length){const warn=new Option(emptyCatalogLabel(backend,catalog),'__empty__');warn.disabled=true;select.add(warn)}
-  select.add(new Option('输入其他模型 ID…','__custom__'));
-  select.add(new Option('搜索全部模型…','__browse__'));
-  if(input?.dataset.roleModel)select.add(new Option('继承主链模型','__inherit__'));
- });
-}
-function setupModelPickers(root=document){
- for(const input of root.querySelectorAll('input[list="model-suggestions"]')){
-  input.removeAttribute('list');
-  const wrap=document.createElement('span');wrap.className='model-picker';input.before(wrap);wrap.append(input);
-  const select=document.createElement('select');select.className='model-picker-select';select.setAttribute('aria-label',input.id==='chat-model'?'选择模型':'选择'+(input.getAttribute('aria-label')||'模型'));select.title='常用模型建议；也可直接在左侧输入其他模型 ID';
-  select.add(new Option('▾',''));
-  const models=modelCatalogs.get(modelTargetBackend(input?.id))?.models||[];
-  for(const model of models)select.add(new Option(model.name+' · '+model.id,model.id));
-  select.add(new Option('输入其他模型 ID…','__custom__'));
-  select.add(new Option('搜索全部模型…','__browse__'));
-  if(input.dataset.roleModel)select.add(new Option('继承主链模型','__inherit__'));
-  select.onchange=()=>{
-   const model=select.value;select.value='';if(input.disabled)return;
-   if(model==='__custom__'){input.focus();input.select();return}
-   if(model==='__browse__'){openModelPicker(input.id);return}
-   if(!model)return;input.value=model==='__inherit__'?'':model;
-   input.dispatchEvent(new Event('input',{bubbles:true}));input.dispatchEvent(new Event('change',{bubbles:true}));input.focus();
-  };
-  wrap.append(select);
-  new MutationObserver(()=>{select.disabled=input.disabled}).observe(input,{attributes:true,attributeFilter:['disabled']});select.disabled=input.disabled;
- }
-}
 setupModelPickers();
 
 
@@ -2002,7 +1915,7 @@ $('template-default').onclick=()=>action(()=>api('settings',{default_template_id
 
 let savedProviderConfigurations=[];
 function providerEndpoint(){return $('provider-engine').value==='briefloop-native'?'native':'opencode'}
-$('provider-engine').onchange=()=>{$('custom-api-key').value='';$('custom-provider').value='';$('provider-open').click()};
+$('provider-engine').onchange=()=>{providerDirectory.invalidate();$('custom-api-key').value='';$('custom-provider').value='';$('provider-open').click()};
 $('provider-open').onclick=async()=>{$('provider-result').textContent='';$('custom-supports-images').value='';providerCapabilities.reset(providerEndpoint());$('provider-use').hidden=true;settingsView('models');settingsModelTab('api');
  try{const r=await api(providerEndpoint()+'/providers');savedProviderConfigurations=r.configurations||[];
  $('custom-saved').innerHTML='<option value="">新建配置</option>'+savedProviderConfigurations.map((p,i)=>`<option value="${i}">${esc(p.name)} · ${esc(p.model)}</option>`).join('');
@@ -2025,30 +1938,25 @@ $('provider-close').onclick=()=>{$('custom-api-key').value='';if(welcomeFromProv
 $('provider-dialog').addEventListener('close',()=>{$('custom-api-key').value=''});
 $('provider-form').onsubmit=async event=>{
  event.preventDefault();const button=$('provider-save');button.disabled=true;$('provider-result').textContent='正在保存到本机…';
- const body={protocol:$('custom-protocol').value,name:$('custom-name').value.trim(),context_limit:$('custom-context-limit').value?Number($('custom-context-limit').value):null,output_limit:$('custom-output-limit').value?Number($('custom-output-limit').value):null,provider:$('custom-provider').value.trim(),base_url:$('custom-base-url').value.trim(),model:$('custom-model').value.trim(),api_key:$('custom-api-key').value,supports_images:$('custom-supports-images').value===''?null:$('custom-supports-images').value==='true',...providerCapabilities.read(providerEndpoint())};
+ const engine=providerEndpoint(),backend=engine==='native'?'briefloop-native':'opencode';
+ const body={protocol:$('custom-protocol').value,name:$('custom-name').value.trim(),context_limit:$('custom-context-limit').value?Number($('custom-context-limit').value):null,output_limit:$('custom-output-limit').value?Number($('custom-output-limit').value):null,provider:$('custom-provider').value.trim(),base_url:$('custom-base-url').value.trim(),model:$('custom-model').value.trim(),api_key:$('custom-api-key').value,supports_images:$('custom-supports-images').value===''?null:$('custom-supports-images').value==='true',...providerCapabilities.read(engine)};
  $('custom-api-key').value='';
  try{
-  const result=await api(providerEndpoint()+'/provider',body);body.api_key='';
-  $('provider-use').hidden=false;$('provider-use').dataset.model=result.model;$('provider-use').dataset.backend=$('provider-engine').value;
+  const result=await api(engine+'/provider',body);body.api_key='';
+  modelDirectory.invalidate(backend);providerDirectory.invalidate(engine,body.provider);
+  const refreshed=modelDirectory.fetchModelCatalog(true,backend);
+  if(engine!==providerEndpoint()||body.provider!==$('custom-provider').value.trim()){await refreshed;return}
+  $('provider-use').hidden=false;$('provider-use').dataset.model=result.model;$('provider-use').dataset.backend=backend;
   $('provider-result').textContent='已保存 '+result.model+'。当前模型选择保持原值。';
- await loadProviderCatalog();
+  await Promise.all([refreshed,loadProviderCatalog()]);
  }catch(e){$('provider-result').textContent=e.message}finally{body.api_key='';button.disabled=false}
 };
 
-let providerCatalogRequest=0;
-async function loadProviderCatalog(){
- const provider=$('custom-provider').value.trim();if(!provider)return;
- const engine=providerEndpoint(),request=++providerCatalogRequest;$('provider-model-options').innerHTML='';
- $('provider-result').textContent='正在读取模型目录…';
- try{
-  const r=await api(engine+'/provider-catalog',{provider});
-  if(request!==providerCatalogRequest||engine!==providerEndpoint()||provider!==$('custom-provider').value.trim())return;
-  $('provider-model-options').innerHTML=(r.models||[]).map(id=>`<option value="${esc(id)}"></option>`).join('');
-  const labels={reachable:'目录已更新',auth_failed:'认证失败',insufficient_balance:'余额不足',forbidden:'无权访问',catalog_unavailable:'目录接口不可用，可手填模型',rate_limited:'请求限流',upstream_unavailable:'服务商暂不可用',connection_failed:'连接失败，可手填模型',invalid_catalog:'响应不是可识别的模型目录',http_error:'接口返回错误'};
-  $('provider-result').textContent=(labels[r.status]||r.status)+' · '+(r.models||[]).length+' 个模型。未调用模型。';
- }catch(e){if(request===providerCatalogRequest)$('provider-result').textContent='目录读取失败：'+e.message+'；可手动输入模型 ID。'}
-}
+const providerDirectory=createProviderCatalog({api,$,getEndpoint:providerEndpoint,modelDirectory});
+const loadProviderCatalog=()=>providerDirectory.load();
 $('provider-catalog').onclick=loadProviderCatalog;
+$('custom-model').onfocus=loadProviderCatalog;
+$('custom-provider').oninput=()=>providerDirectory.invalidate();
 $('provider-test-model').onclick=()=>action(async()=>{
  $('provider-result').textContent='正在提交短工具调用…';
  const r=providerEndpoint()==='native'?await api('runtime-test',{backend:'briefloop-native',model:$('custom-provider').value.trim()+'/'+$('custom-model').value.trim()}):await api('opencode/provider-test',{provider:$('custom-provider').value.trim(),model:$('custom-model').value.trim()});
@@ -2069,7 +1977,7 @@ $('custom-protocol').onchange=()=>{
 };
 $('custom-preset').onchange=()=>{
  const presets={deepseek:['DeepSeek','deepseek','chat-completions','https://api.deepseek.com'],openai:['OpenAI','openai-custom','responses','https://api.openai.com/v1'],anthropic:['Anthropic','anthropic-custom','anthropic-messages','https://api.anthropic.com/v1']};
- const p=presets[$('custom-preset').value];if(!p)return;
+ const p=presets[$('custom-preset').value];if(!p)return;providerDirectory.invalidate();
  ['custom-name','custom-provider','custom-protocol','custom-base-url'].forEach((id,i)=>$(id).value=p[i]);
 };
 

briefloop-0.26.1/frontend/model-catalog.js

@@ -0,0 +1,171 @@
+import {esc} from './dom.js';
+
+const sourceNames={provider_api:'提供方 API',host:'宿主目录',host_catalog:'宿主目录',host_session:'宿主会话目录',native_config:'本机配置',local_settings:'本机配置',local_routes:'本机路由',host_default_only:'宿主未提供目录',unsupported:'不支持目录',builtin_hints:'静态建议（已停用）'};
+const statusNames={ok:'目录已读取',reachable:'目录已读取',partial:'部分目录读取失败',error:'目录读取失败',failed:'目录读取失败',unsupported:'不支持列举模型',unavailable:'宿主未提供目录',configured:'已读取本机设置（非实时目录）',unconfigured:'尚未配置提供商',empty:'目录为空',auth_failed:'认证失败',insufficient_balance:'余额不足',forbidden:'无权访问',catalog_unavailable:'目录接口不可用',rate_limited:'请求限流',upstream_unavailable:'提供方暂不可用',connection_failed:'连接失败',invalid_catalog:'目录响应无法识别',http_error:'接口返回错误'};
+const unavailable=new Set(['error','failed','unsupported','unconfigured','auth_failed','insufficient_balance','forbidden','catalog_unavailable','rate_limited','upstream_unavailable','connection_failed','invalid_catalog','http_error']);
+export function catalogSource(source){return sourceNames[source]||source||'来源未说明'}
+export function catalogStatus(catalog){
+ if(catalog?.loading)return '正在查询目录；上次结果尚未刷新';
+ if(!catalog)return '尚未读取目录';
+ return statusNames[catalog.status]||catalog.status||(catalog.models?.length?'目录已读取':'未读取到模型');
+}
+export function catalogDescription(catalog,name=''){
+ const parts=[name,catalogStatus(catalog)];
+ if(catalog){
+  parts.push(catalogSource(catalog.source));
+  if(catalog.models?.length)parts.push(`${catalog.models.length} 个模型`);
+  const checked=catalog.checked_at||catalog.refreshed_at;
+  if(checked)parts.push(`${catalog.loading?'上次查询':'查询时间'}：${checked}`);
+  if(catalog.diagnostic)parts.push(catalog.diagnostic);
+  if(catalog.note)parts.push(catalog.note);
+  const providers=(catalog.providers||[]).map(p=>`${p.name||p.provider||p.id}：${statusNames[p.status]||p.status||'状态未说明'}${p.diagnostic?'（'+p.diagnostic+'）':''}`);
+  if(providers.length)parts.push(providers.join('；'));
+ }
+ return parts.filter(Boolean).join(' · ')+'。可手动输入模型 ID；目录结果不代表模型调用成功。';
+}
+
+// One live source for every model selector. Settled results are only a display
+// snapshot: every open/refresh queries the backend, while concurrent opens share
+// the same request. A response never writes a selected model or selected backend.
+export function createModelCatalog({api,$,getBackend,getChatBackend,runtimeName=id=>id,onCatalogChange=()=>{},document:doc=globalThis.document,Option:OptionClass=globalThis.Option,MutationObserver:Observer=globalThis.MutationObserver}){
+ const catalogs=new Map(),pending=new Map(),generations=new Map();
+ let pickerTarget=null,pickerRevision=0;
+ const targetBackend=target=>{
+  const backendInput=target&&$(target)?.dataset?.modelBackendInput;
+  return backendInput?$(backendInput)?.value||getBackend():target==='chat-model'?getChatBackend():getBackend();
+ };
+ function normalize(data,backend){
+  const disabled=data.source==='builtin_hints'||unavailable.has(data.status);
+  const models=disabled?[]:(data.models||[]).map(m=>typeof m==='string'?{id:m,name:m}:{...m,name:m.name||m.label||m.id}).filter(m=>m.id);
+  return {...data,backend,models,loading:false,diagnostic:data.diagnostic||data.error||'',providers:Array.isArray(data.providers)?data.providers:[]};
+ }
+ function changed(){
+  refreshInlineModelPickers();
+  const status=$('runtime-model-status');if(status)status.textContent=catalogDescription(catalogs.get(getBackend()),runtimeName(getBackend()));
+  const suggestions=$('model-suggestions');if(suggestions)suggestions.innerHTML=(catalogs.get(getBackend())?.models||[]).map(m=>`<option value="${esc(m.id)}" label="${esc(m.name)}"></option>`).join('');
+  if(pickerTarget&&$('model-picker')?.open)renderModelPicker();
+  onCatalogChange();
+ }
+ function fetchModelCatalog(_force=false,backend=getBackend()){
+  if(pending.has(backend))return pending.get(backend);
+  const generation=generations.get(backend)||0;
+  catalogs.set(backend,{...catalogs.get(backend),backend,models:catalogs.get(backend)?.models||[],loading:true});
+  const current=()=>generation===(generations.get(backend)||0)&&pending.get(backend)===request;
+  const request=Promise.resolve().then(()=>api('models?backend='+encodeURIComponent(backend)+'&refresh=1')).then(data=>{
+   if(!current())return [];
+   catalogs.set(backend,normalize(data,backend));return catalogs.get(backend).models;
+  }).catch(error=>{
+   if(!current())return [];
+   catalogs.set(backend,{backend,models:[],status:'error',diagnostic:error.message||'模型目录读取失败',loading:false});return [];
+  }).finally(()=>{if(current()){pending.delete(backend);changed()}});
+  pending.set(backend,request);changed();return request;
+ }
+ function invalidate(backend=getBackend()){
+  generations.set(backend,(generations.get(backend)||0)+1);
+  pending.delete(backend);catalogs.delete(backend);changed();
+ }
+ async function refreshModelSuggestions(){
+  await Promise.all([...new Set([getBackend(),getChatBackend()])].filter(Boolean).map(backend=>fetchModelCatalog(true,backend)));
+ }
+ async function openModelPicker(target){
+  pickerTarget=target;pickerRevision++;
+  $('model-picker-search').value='';$('model-picker').showModal();
+  return refreshCurrentModelPicker();
+ }
+ async function refreshCurrentModelPicker(){
+  const revision=++pickerRevision,backend=targetBackend(pickerTarget);
+  await fetchModelCatalog(true,backend);
+  if(revision===pickerRevision&&backend===targetBackend(pickerTarget))renderModelPicker();
+ }
+ function renderModelPicker(){
+  if(!pickerTarget)return;
+  const backend=targetBackend(pickerTarget),catalog=catalogs.get(backend),models=catalog?.models||[];
+  const q=$('model-picker-search').value.trim().toLowerCase();
+  const shown=models.filter(m=>[m.id,m.name,m.provider].some(value=>String(value||'').toLowerCase().includes(q)));
+  $('model-picker-status').textContent=catalogDescription(catalog,runtimeName(backend))+(q?` · 筛出 ${shown.length} 个`:'');
+  $('model-picker-refresh').disabled=!!catalog?.loading;
+  let lastProvider=null,html='';
+  for(const model of shown){
+   const provider=model.provider||runtimeName(backend);
+   if(provider!==lastProvider){lastProvider=provider;html+=`<h3 class="workspace-list-heading">${esc(provider)}</h3>`}
+   html+=`<button type="button" class="workspace-choice" data-model-pick="${esc(model.id)}"><span><strong>${esc(model.id)}</strong><small>${esc(model.name||'')}</small></span><em>选用</em></button>`;
+  }
+  const custom=$('model-picker-search').value.trim();
+  const customChoice=custom&&!/\s/.test(custom)&&!shown.some(m=>m.id===custom)?`<button type="button" class="workspace-choice" data-model-pick="${esc(custom)}"><span><strong>${esc(custom)}</strong><small>使用此模型 ID</small></span><em>选用</em></button>`:'';
+  $('model-picker-list').innerHTML=(html||`<p class="help">${esc(models.length?'没有匹配的模型。可输入完整模型 ID 后按回车选用。':catalogDescription(catalog,runtimeName(backend)))}</p>`)+customChoice;
+  $('model-picker-list').querySelectorAll('[data-model-pick]').forEach(button=>button.onclick=()=>pickModel(button.dataset.modelPick));
+ }
+ function pickModel(id){
+  const input=pickerTarget&&$(pickerTarget);$('model-picker').close();pickerRevision++;
+  if(!input)return;input.value=id;input.dispatchEvent(new Event('change',{bubbles:true}));
+ }
+ function refreshInlineModelPickers(){
+  doc.querySelectorAll('.model-picker-select').forEach(select=>{
+   const input=select.parentElement.querySelector('input'),backend=targetBackend(input?.id),catalog=catalogs.get(backend);
+   select.replaceChildren(new OptionClass('▾',''));
+   const status=new OptionClass(`${catalogSource(catalog?.source)} · ${catalogStatus(catalog)}${catalog?.diagnostic?'：'+catalog.diagnostic:''}`,'__status__');status.disabled=true;select.add(status);
+   for(const model of catalog?.models||[])select.add(new OptionClass(model.name+' · '+model.id,model.id));
+   select.add(new OptionClass('输入其他模型 ID…','__custom__'));
+   select.add(new OptionClass('搜索 / 刷新模型目录…','__browse__'));
+   if(input?.dataset.roleModel)select.add(new OptionClass('继承主链模型','__inherit__'));
+   select.title=catalogDescription(catalog,runtimeName(backend));
+  });
+ }
+ function setupModelPickers(root=doc){
+  for(const input of root.querySelectorAll('input[list="model-suggestions"]')){
+   input.removeAttribute('list');
+   const wrap=doc.createElement('span');wrap.className='model-picker';input.before(wrap);wrap.append(input);
+   const select=doc.createElement('select');select.className='model-picker-select';select.setAttribute('aria-label',input.id==='chat-model'?'选择模型':'选择'+(input.getAttribute('aria-label')||'模型'));select.dataset.testid='model-catalog-select';
+   // Pointer and keyboard opens refresh equally; a focus event alone does not
+   // double-query the following pointer event.
+   select.onpointerdown=()=>{if(!input.disabled)fetchModelCatalog(true,targetBackend(input.id))};
+   select.onkeydown=event=>{if(['ArrowDown','ArrowUp',' ','Enter','F4'].includes(event.key)&&!input.disabled)fetchModelCatalog(true,targetBackend(input.id))};
+   select.onchange=()=>{
+    const model=select.value;select.value='';if(input.disabled)return;
+    if(model==='__custom__'){input.focus();input.select();return}
+    if(model==='__browse__'){openModelPicker(input.id);return}
+    if(!model||model==='__status__')return;input.value=model==='__inherit__'?'':model;
+    input.dispatchEvent(new Event('input',{bubbles:true}));input.dispatchEvent(new Event('change',{bubbles:true}));input.focus();
+   };
+   wrap.append(select);
+   if(Observer)new Observer(()=>{select.disabled=input.disabled}).observe(input,{attributes:true,attributeFilter:['disabled']});select.disabled=input.disabled;
+  }
+  refreshInlineModelPickers();
+ }
+ return {catalogs,invalidate,fetchModelCatalog,refreshModelSuggestions,openModelPicker,refreshCurrentModelPicker,renderModelPicker,pickModel,refreshInlineModelPickers,setupModelPickers,targetBackend};
+}
+
+// The Native configuration form consumes the same provider response as the
+// execution selectors. OpenCode's configuration probe remains a direct provider
+// API check, distinct from OpenCode's execution-host catalogue.
+export function createProviderCatalog({api,$,getEndpoint,modelDirectory}){
+ const pending=new Map(),generations=new Map();let revision=0;
+ function invalidate(engine,provider){
+  if(engine&&provider){const key=JSON.stringify([engine,provider]);generations.set(key,(generations.get(key)||0)+1);pending.delete(key)}
+  if(!engine||(engine===getEndpoint()&&provider===$('custom-provider').value.trim())){revision++;$('provider-model-options').innerHTML=''}
+ }
+ async function load(){
+  const provider=$('custom-provider').value.trim(),engine=getEndpoint(),request=++revision;
+  $('provider-model-options').innerHTML='';
+  if(!provider){$('provider-result').textContent='先保存提供商配置，再读取目录；也可手动输入模型 ID。';return}
+  $('provider-result').textContent='正在查询提供方模型目录；此操作不调用模型。';
+  const key=JSON.stringify([engine,provider]),generation=generations.get(key)||0;
+  if(!pending.has(key)){
+   const query=engine==='native'?modelDirectory.fetchModelCatalog(true,'briefloop-native').then(()=>{
+    const catalog=modelDirectory.catalogs.get('briefloop-native');
+    const result=catalog?.providers?.find(p=>(p.provider||p.id)===provider);
+    return result?{...result,models:(result.models||[]).map(id=>typeof id==='string'?{id,name:id}:id)}:
+     {...catalog,models:[],diagnostic:catalog?.diagnostic||'此提供商未返回模型目录；请先保存配置。'};
+   }):Promise.resolve().then(()=>api('opencode/provider-catalog',{provider})).then(result=>({...result,source:'provider_api',models:(result.models||[]).map(id=>typeof id==='string'?{id,name:id}:id)}));
+   const active=query.finally(()=>{if(pending.get(key)===active)pending.delete(key)});
+   pending.set(key,active);
+  }
+  let result;
+  try{result=await pending.get(key)}catch(error){result={models:[],status:'error',source:'provider_api',diagnostic:error.message}}
+  if(request!==revision||generation!==(generations.get(key)||0)||engine!==getEndpoint()||provider!==$('custom-provider').value.trim())return;
+  const models=unavailable.has(result.status)?[]:result.models||[];
+  $('provider-model-options').innerHTML=models.map(model=>`<option value="${esc(model.id)}"></option>`).join('');
+  $('provider-result').textContent=catalogDescription({...result,models},provider);
+ }
+ return {load,invalidate};
+}