用途与实际影响
这项功能怎样使用
为什么需要它
只把一个模型名字放进菜单，并不能保证完整指令、上下文和工具真的交给它；把旧任务的Provider（服务身份）悄悄改掉还会混淆历史。接入层保留官方执行环境，只负责经过核对的入口、目录和协议适配。
举个实际例子
我可以说：“用本地27B在这个练习项目里改一个函数，照常显示工具、测试和历史。原来那个官方模型任务别动。”我会在新任务里选择本地入口；以后同一Provider内切换模型可以继续，跨Provider则另开任务。
最后我会得到什么
仍在官方 Codex 桌面看到真实任务、工具过程和最后结果；启用或停用这条接入有明确回退。只看到模型菜单还不足以证明这次任务真的由本地模型完成。
正常时
桌面实际启动所选模型并完成一次工具工作，结果可核对。
发现问题时
旧任务属于另一模型服务时保留原历史，换服务开新任务。
入口不可用或证据不足时
模型入口或安装身份无法确认时停相应接入，原有官方入口仍可用。
从哪里开始
在官方 Codex 桌面的新任务里选择已登记本地模型；接入配置的启用、停用使用项目既有受管入口。
需要准备什么
- 当前项目目录
- 要用的本地模型
- 是否要保留旧官方任务
从开始到拿到结果
- 1
先看桌面入口是否已接入
核对受管配置与实际模型服务，不把菜单文字当成模型正在工作。
- 2
在新任务选模型
原官方任务保持原来的服务身份；换到另一家模型服务时另开任务，同一家服务内才按实际能力切模型。
- 3
用真实工具验收
查看本地模型是否完成一次工具工作与测试；配置文件一致或历史截图不足以证明现役进程已切换。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
Owner本地桌面实际任务已验收；七文件安装回读匹配关键规则与设计选择
同Provider内的模型切换与跨Provider新建任务不同；旧会话不会被批量换模型。
官方桌面、命令行、Toolkit各有自己的配置与验收，不能用其中一条成功替代另外两条。
已安装七文件、进程实际加载和用户看到的真实任务分别核对；本轮不重启现有桌面。
本模块用到的名词
- Provider（服务身份）
- 同一模型名字不代表同一服务；已有任务持有自己的Provider，不能靠改菜单篡改历史。
- 内容寻址发行
- 一组已固定字节的桌面接入文件；登记和实际加载都能对应到这一组，而不只看一个版本号。
专业定义
不是多一套界面，而是让原本的桌面任务使用我明确选的模型。
解决什么
防止假菜单、上下文或工具被裁剪、旧会话身份被替换，以及软件升级后只因版本号不同就误判整条路线不可用。
当前怎样实现
- scripts/Set-CodexDesktopLocalModels.ps1管理既有桌面接入；GetDesktopModelPlan.ps1提供模型与配置计划，GetDesktopProviderToken.ps1按需供给目标凭据，ResolveDesktopEngine.ps1选择可信官方引擎。凭据值不进入网页或命令参数。
- 官方debug models与实际模型目录一起提供完整指令、上下文、工具和模型身份；CODEX_CLI_PATH使用PCConfig登记的内容寻址发行，而不是另造聊天执行器。
- 桌面发行由GetDesktopModelPlan.ps1、GetDesktopProviderToken.ps1、ResolveDesktopEngine.ps1及bridge目录内AiCli.CodexDesktopBridge.deps.json、AiCli.CodexDesktopBridge.dll、AiCli.CodexDesktopBridge.exe、AiCli.CodexDesktopBridge.runtimeconfig.json七文件组成；来源 Owner 已登记/安装 562b29bf4a6ac0af，本轮真实 ChatGPT.exe→Bridge→codex.exe 进程路径也指向该发行。旧3b7600a验收仅属9月18日历史。
- 四种本地模型共用既有Broker（显卡协调器）与256K配置；GLM、Qwen、DeepSeek仍保留不同Provider/协议身份。旧配置不会悄悄指向另一模型，跨Provider创建新任务。
- 支持可信官方AppX引擎和官方签名自更新缓存，通过约束路径、签名及实际接口判断；新版本不是永久拒绝名单，也不自动表示兼容。启用/停用比较己方配置前后像，不覆盖别人后改的环境。
- 第三方公开commentary（工作说明）以同一模型的公开摘要呈现，GLM/DeepSeek的最终答复保持原意；隐藏推理不进入公开投影，也不增加另一个模型翻译器。实时与历史用稳定事件身份对应。
- 专用保护判断线程使用官方持久threadSource及既有隐藏集合分类，不混入普通顶层任务列表；保留判断证据。标记不是原生子代理血缘、最高权限主体或批准凭证，普通Astra顶层任务仍可见。
执行流程
- 1
选择原本的官方桌面与已登记模型
- 2
比较并预览接入配置，确需时显式启用
- 3
按Provider关系保留旧任务或新开任务
- 4
核对实际模型、工具和结果
- 5
更新或停用时只处理归属明确的配置并保留回退
边界
- 这不是独立桌面产品、聊天壳或后台守护服务；界面与原生任务仍由官方Codex拥有。
- 9月15日真实本地桌面画面仍按当日身份保存；本轮只读，不生成新GPU任务。
- 七文件一致不证明正在运行的进程已切换，也不证明全部工具、视觉输入或长任务压力场景通过。
失败与恢复
- 原任务属于另一Provider
- 保留原任务与历史，另开需要的目标任务；不把重建伪装为恢复。
- 更新后可信引擎或接入文件无法证明
- 只停止受影响接入并报告实测差异，保留已验证发行；不改动其他Owner正在工作的配置。
真实入口
docs/user/Codex 桌面本地模型.md真实入口、模型切换与恢复边界
scripts/Set-CodexDesktopLocalModels.ps1受管桌面启用停用
src/AiCliProfileManager/Support/ResolveDesktopEngine.ps1可信引擎与更新连续性
src/AiCliProfileManager/Support/DesktopBridge/Program.cs官方桌面协议接入
如何验证
- 9月15日Owner提供原生桌面及CLI（命令行工具）实际任务画面，本页保留五张原图与原日期。
- 2026-09-24T04:59Z diagnose（零写入诊断）回执为 0.3.18、desktop enabled、release 562b29bf4a6ac0af；未提供受保护 registry（登记清单），故 installation_state=registry_not_supplied，工具本身 running_process_loaded=unknown（未验证）。另用 Windows 进程读回主 GUI 的同版 Bridge 可执行路径；仍不证明新父工具 schema（数据结构） 或模型 E2E（端到端验证）。
- 其他Owner的未提交Gemini接入不参与本次来源闭包。
与其他模块的关系
配置档模块负责准确选择，本模块接入现有原生桌面；后台子会话模块说明桌面父任务怎样持续协作。