Skip to content

Copilot 设置、持久化与连接诊断 ​

本页负责 ColorVision 内置 Copilot 的配置来源、设置窗口和聊天面板中的配置变更。设置草稿、配置文件、运行期对象、会话中的模型选择和远端连接是不同状态;任何一个“成功”提示都不能代替其它层的完成证据。

配置来源与责任 ​

运行时使用 ConfigHandler 提供的 CopilotConfig,不加载全局或项目 config.toml 来覆盖 ColorVision 的 provider、model、tools 或 approval。仍会发现有作用域的 AGENTS.md / CLAUDE.md,其顺序、预算和权限边界见项目指令;技能来源与调用见 Copilot 技能。选择本机 Codex 时,外部 Codex 进程自行管理账户和默认模型;ColorVision 不读取、复制登录令牌,也不把外部配置导入自己的设置。

CopilotProjectInstructionDiscoveryConfig 提供默认快照、预算上限和项目根标记校验;执行策略判断与 Shell 环境过滤直接消费请求快照。

状态owner 与用途
CopilotConfig.Profilesprovider 协议、模型、地址、API Key、生成参数和模型能力声明;不是会话历史
CopilotConfig.AgentDefaults全局 Agent 预算、压缩、Shell 偏好和 Skill 覆盖;不属于单个模型 Profile,技能开关与生效优先级见 Copilot 技能
CopilotConfig 的 MCP / Web 字段入站 Local MCP、外部 MCP client 配置和 Web Pref64;各入口的联网与落盘不同
CopilotChatState / CopilotConversationRecord活动 Profile ID、各会话选择、回答风格、默认访问模式、消息与恢复状态;由独立的会话状态存储负责。完全访问 作为 Composer 默认值持久保存,直到用户切回 按需确认;临时自动复核仍只绑定当前任务和工作区

配置 JSON 路径、节合并、文件替换和重载导致的旧对象失效见配置持久化与对象所有权。Copilot 设置保存的是其中的 CopilotConfig 节,不另建一个 config.toml 或模型配置数据库。

本地配置与上下文诊断 ​

三个命令各有明确的读取范围,均不调用模型、Agent 工具或外部 MCP,不保存配置,也不把诊断文本加入模型历史。它们预览当前设置与待提交上下文;正在运行的任务继续使用提交时冻结的 Profile、预算、指令及工具配置,不能用诊断中更新后的值反推在途任务已经切换。

入口实际报告范围
/debug-config内置默认、应用配置文件元数据、状态文件加载/恢复来源、当前 Profile、AgentDefaults、会话覆盖和临时权限;显示实际宿主 sandbox/审批/Shell 策略,以及 Local MCP、外部 MCP 数量和 Web Pref64 状态
/context当前输入模式、历史与工具结果预算、压缩状态、持续目标、指令与 Skill 数量、业务扩展及当前策略;Chat 模式保留会话相关信息,省略不参与该模式的 Agent 扩展详情
/memory [open N]个人与项目指令的发现目标、文件顺序、截断与预算;open N 打开对应源文件,发现清单不是当前任务已经注入的回执

Profile 模型与提示主体来自 ColorVision 配置,本机 Codex 的空模型字段表示采用外部运行时默认模型;会话回答风格来自会话状态。/context 的指令预览与 /memory 的发现结果,是否注入还取决于后续请求的本地证据需求、工作区补丁能力与模式。

/debug-config 只探测主配置 JSON 的 CopilotConfig 节、schema、属性存在性及 Profile ID,文件大于 16 MiB 时不解析。文件缺失、节缺失、损坏或不可读取时保留运行期值,标明“当前文件来源未证实”;更高版本 schema 会报告写入被阻止。文件元数据只说明命令执行时的文件状态,不能证明每个运行期键的启动来源。状态来源保留主文件、临时快照、备份、恢复快照和未来版本等区别。

诊断不输出 API Key、MCP token、系统提示或自动复核策略正文、Shell 环境变量值、后台/外部 MCP 地址及 Pref64 前缀。模型端点仅显示 origin,去掉用户信息、路径、查询和 fragment。设置变更后的诊断重新读取当前对象与文件元数据,不更改原配置文件;完整权限与审批执行边界见工具契约。

设置窗口中的草稿与按钮 ​

使用本机 Codex ​

打开模型设置时会异步检测 Windows Codex 桌面版自带的运行时、PATH 中的原生 CLI 和 npm 包内的原生可执行程序。桌面版的版本目录动态发现;不依赖终端已注册 codex 命令,不执行 .cmd / .ps1 包装脚本。仅安装 Store 应用但尚未完成首次启动时,可能需要先打开 Codex,使其释放可执行运行时。

  • “添加供应商”中始终提供“本地 Codex”选项,可以先加入草稿,再在右侧检测运行时和登录。通过 App Server 握手、账户查询及历史接口兼容性检查后才能实际请求;已有 API Key 配置保留,检测本身不会切换当前 Profile。
  • 本地 Codex 和 API 供应商使用同一列表、启用开关和模型编辑入口。没有安装时显示检测结果,仍可配置 API 供应商;页面右上方和本地供应商详情都可重新检测。
  • 未登录时点击“登录 Codex”,通过 Codex 管理的官方浏览器登录完成认证;也可先在桌面版登录,再重新检测。重新检测或登录时先清空上次的账户与模型列表,失败不会留下过期的已登录状态。关闭设置会取消等待,随后到达的结果不再回写或继续发起登录请求。登录只改变 Codex 自己的登录状态,不在 ColorVision 配置中保存密码或 token。
  • 本机 Profile 不需要 API Key 或 Base URL。模型可从 Codex 返回的列表选择,留空使用其默认值;图片能力仍按模型声明。连接测试会发送一条短请求并消耗该账户额度,普通检测不启动模型推理。

该接入使用实验性的 codex app-server stdio 协议,要求运行时支持动态工具及 thread/inject_items。thread/start 和 turn/start 返回的会话、回合标识缺失或为空白时,立即报错并释放连接,不读取后续输出,避免失去通知筛选依据。不兼容、未登录、连接退出或额度不足时明确报错,不自动切换到另一账户或 Key。运行时文件路径和账户凭据不随 Profile 保存;本机 Codex Profile 只保存在本机配置中。

每轮设置检测只扫描一次候选路径,并把本轮结果交给连接工厂;下一次检测和登录仍重新发现。连接初始化已经读取的登录状态仅保存在该连接实例中,聊天与检测复用这个布尔快照,不重复查询或跨连接缓存账户。登录完成后强制重新读取账户。初始化握手、历史接口探测和失败候选回退仍执行,减少查询不代表跳过兼容性检查。

运行时报告 error.willRetry=true 时继续等待同一回合,由 Codex 完成自己的重试。宿主仅在 turn/completed 失败后按结构化 codexErrorInfo 分类,不依据错误正文推断权限、重试或上下文限制,也不透出可能含凭据的附加详情。Agent 路径沿用现有的有界重试及一次上下文压缩恢复;已输出文字、推理或工具请求后不重放原请求。额度、认证和权限失败不会按临时服务错误重试。普通 Chat 路径仍只有现有的不活跃超时保护,没有额外增加自动重试。

ColorVision 在分块读取 stdout 时检查单行协议消息上限:最多 16 × 1024 × 1024 个 UTF-16 字符,换行不计;超限立即报错,不等待完整行或换行。连续消息共用一个读取器保留预读内容,支持 LF、CRLF 和非空的 EOF 末行;RPC 等待期间夹杂的通知按接收顺序保留。取消会阻止交付预读行和已排队通知。适配器在连接、设置请求和通知返回后复查取消;同一完成消息包含多段文本时,每次恢复枚举也复查,不再产生后续文本、工具事件或正常结束标记。stderr 按固定 4 KiB 字节块读取并直接丢弃;进程收尾显式关闭自有读取器,后台读取异常经过观察,不覆盖当前调用的结果。

停止自有进程时,直接关闭启动后、首次写入前取得的 stdin 句柄,不调用可能向满管道同步刷新的 StreamWriter.Close,也不在后台遗留关闭任务。先等待最多 500 毫秒让进程因 EOF 正常退出;未退出时尝试终止自有进程树,再最多等待 2 秒确认根进程退出。重复释放共享同一收尾任务,聊天和设置入口异步等待,避免阻塞 UI;进程控制失败时也不会无限等待或按名称寻找其它 Codex 进程。

CopilotCodexChatClient 将模型输出转换成现有聊天事件,将动态工具调用交回 Agent Framework 和 ColorVision 的权限、审批、预算与执行链;不会调用 Codex 中的工具来代替宿主审批。独立子进程关闭内置 Shell、外部 MCP、插件、Hook 和网页搜索,并使用只读沙箱。收到独立权限申请或非宿主管理的工具事件时停止本次调用。

回复按消息条目的 itemId 累计流式内容,并在 item/completed 到达时补齐尚未显示的文本;同一条目的回合快照不重复输出。完整回复可以只出现在条目完成事件中,不能依赖 turn/completed.items 非空,也不能因先前消息已有增量而遗漏最终结论。条目和回合事件均核对当前 thread/turn 标识;没有条目标识的旧协议保留回合级防重复。完整文本与已显示增量不一致时明确报错,避免拼接出错误答案。协议依据见 App Server 事件。

每次模型请求建立临时 Codex 会话,使用 ColorVision 保存的角色消息和真实工具结果重建历史;不把用户已有的 Codex 任务接管为当前聊天。工具请求发出后先结束该临时会话,再由宿主执行,下一次请求带上实际结果。因此每个工具后续推理有额外启动与历史传输开销。取消、超时和释放只结束本次创建的子进程,不关闭用户的 Codex 桌面应用。

thread/tokenUsage/updated.tokenUsage.total 是该临时会话的累计用量快照。流式预算按进度合并;非流式回答使用最新快照,重复事件不重复计数。Agent 的最终结果和界面用量采用预算中已报告的官方用量:同一次请求只结算一次,不同模型请求及委派调用累加,不把预算估算当作官方账单。非流式调用失败或取消时,已观察到的官方用量随原异常保留,供预算和调用方记账;未报告的用量仍保持未知。

工具交接可能早于 Codex 最终用量事件;这些步骤不伪造服务端 token 数,Agent 预算沿用现有的显式估算补足并显示估算状态。面板中已收到的用量不能当作 Codex 账户完整账单。生成参数以 App Server 支持范围为准:传递模型和推理强度,HTTP Profile 的温度及输出 token 上限不作为 Codex 服务端的限制;宿主仍执行整体时间、累计预算和工具次数门禁。

通用设置操作 ​

聊天面板标题栏的齿轮打开独立 Copilot 设置模块。左侧按模型设置、Agent 与工具、网页与网络、MCP 服务导航;原有 /settings 页面路由保持可用。模型设置页左侧列出供应商,右侧编辑共用的 Base URL、API 格式、API Key 和模型列表;供应商菜单支持重命名与删除。旧 Profile 按原 ID 保持独立连接,不按供应商名称、地址或密钥自动合并。新建供应商的模型以 ConnectionId 关联,保留各自 Profile ID,历史记录继续引用模型 ID。

添加供应商在同一页面内选择卡片后进入详情,可先添加再填写密钥。预设带入模型列表,默认只启用第一个模型;自定义连接从空地址、空模型开始,保存后仍保留自定义类型,不根据模型名称改成内置供应商。只有没有连接分组 ID 的旧 Profile 继续按原规则推断供应商。本地 Codex 不要求 API Key。模型行提供视觉与上下文标记、测试连接、编辑和启用开关;供应商停用会保留其模型开关,但这些模型不能用于聊天选择、命令补全或发送。删除最后一个供应商后允许保存空列表,重新打开不会补回默认连接。

添加或编辑模型使用独立弹窗草稿,取消不会更改模型;弹窗保存只更新设置窗口草稿,最终仍需应用或保存。智能配置按精确模型 ID 填写已确认的视觉、上下文和输出参数,未知字段保留手动入口,不根据模型名前缀猜能力。重复选择相同模型或相同智能配置状态不重置已编辑字段。上下文 0 继承 Agent 默认值;手动输出上限必须小于实际上下文(包括继承值),保存窗口时也重新校验。高级配置的首段内容超时、流式响应间隔接受 15–3600 秒整数,无效输入保留在表单中并阻止保存,不静默沿用旧值。API 模型的输出上限用于请求与历史预算;本地 Codex 实际输出上限由运行时管理,编辑器禁用该项并说明宿主预算预留用途。

/settings [models|agent|web|mcp] 由 Config/CopilotSettingsCommand.cs 路由到同一个 CopilotSettingsWindow;聊天 ViewModel 的 OpenSettings 在 IsBusy 时不打开窗口。窗口创建 CopilotSettingsViewModel,从配置克隆 Profiles,并将其它字段复制为草稿。选择、添加、复制、删除 Profile 或编辑字段,通常只改变这份窗口草稿。

“打开后取消”不是严格的零写入事务:构造函数先对运行期配置执行 EnsureInitialized(),发现需规范化时会调用 Save<CopilotConfig>()。这个初始化保存尝试与之后的按钮保存不同;该便捷方法不向窗口返回保存结果。初始化会处理缺省值、旧 schema 和临时内置 Profile。未来版本的 SchemaVersion 不被当前实现规范化,序列化保存会拒绝覆盖。

入口实际结果
添加供应商 / 添加或编辑模型 / 删除供应商更改草稿,需后续保存;每个供应商至少保留一个模型,删除整个连接使用供应商菜单
Apply调用 Save(),不关窗
Save调用同一个 Save();只有返回 true 才以成功结果关闭
本地 Codex 供应商加入窗口草稿;检测与登录独立于应用或保存
Cancel / Close / 关闭窗口不调用该按钮保存,也不回滚之前 Apply 或初始化已经产生的写入;关闭时取消窗口持有的异步操作

保存校验约束模型预算、MCP 端口、外部 MCP 文本和 Web Pref64 语法,不要求每个 Profile 都能连接。API Profile 的 CopilotProfileConfig.IsConfigured 检查供应商及模型启用状态、API Key、Base URL、Model 和端点规则;本地 Codex 不要求 API 字段,调用时重新验证运行时与登录状态。“已配置”不是网络测试结果。旧模型的视觉声明保持原值;手动模式改变模型、地址或协议仍清除旧声明,智能配置在明确编辑时重填已知模型能力。输入密钥不会重置手动输出额度。部署时用目标供应商和账户单独验收登录和请求。

第三方服务需要 Responses 协议时,选择 OpenAI Compatible 并在 Base URL 填写完整的 /responses 端点,例如 https://api.deepseek.com/responses;路径前缀会原样保留。普通兼容 Base URL 仍选择 Chat Completions,官方 OpenAI 地址仍自动使用 Responses。该选择同时用于普通聊天、Agent 和连接诊断;服务是否支持对应模型、工具和输入类型仍需实际验证,不能只凭 URL 判断。

保存完成的三个层次 ​

CopilotSettingsViewModel.ProfileManagement.cs::Save 的顺序是:解析草稿 → 从配置和草稿构造独立候选 → EnsureInitialized → ConfigHandler.TrySaveAndPublish 先落盘,再通过 CommitPersistenceSnapshot 发布运行期配置 → 属性通知、重建窗口 Profiles、应用 Local MCP 设置和更新选中 Profile。

结果必须怎样解释
NotPersisted本次候选未提交;正常保存失败路径不将候选发布到运行期,保留草稿以便修正或重试
PersistedButPublishFailed文件已保存,但内存发布未完整完成;不能宣称旧文件未变,也不能靠 Cancel 回滚
发布成功后,通知或运行态刷新抛异常文件仍已保存,运行期或窗口可能只完成部分刷新;Save() 同样返回 false,提示已保存但刷新失败
全部完成重新从规范化后的配置克隆窗口列表,清除 HasUnsavedSettings,设置 HasAppliedChanges,返回 true

因此 Save() == false 不等于磁盘没变。先看 SettingsStatusText 区分 “not saved” 与 “saved, but … could not refresh”,再核对实际配置和运行期;不要用反复点击或直接覆盖文件掩盖发布故障。规范化还可能删除失效或不受信的 Profile,成功后应以重建的列表为准,不能继续持有旧草稿对象。

从聊天面板打开设置时,OpenSettings 在窗口关闭后只要发现成功结果或 HasAppliedChanges,就会 ReloadStateFromConfig(window.ActiveProfileId),重绑定 Profile、会话选择并请求会话状态保存;所以 Apply 后再 Cancel 仍会触发重载。Local MCP 的 ApplySettings 则在设置保存的刷新阶段执行,启停监听或变更 token 不是纯文件操作。协议和会话失效条件见Local MCP。

新建 Profile 的模型预设 ​

CopilotVendorCatalog 提供新建和编辑 Profile 的模型候选与各协议默认地址。未列出的模型可手工填写。目录更新保留已保存的模型、地址、凭据、默认 Profile 和“支持图片输入”设置。

能否连接取决于已选端点、模型和账号权限,使用 Profile 的连接测试核对。供应商停用已保存的模型时,在设置中手动选择可用模型。图像输入由 Profile 的能力声明和附件校验决定。

普通聊天、Agent 工具阶段与最终回答阶段共用采样限制:官方 Claude Fable 5.1、Opus/Sonnet/Haiku 5.5 不发送非默认温度,Haiku 4.5 保留温度;MiMo 默认开启思考,因此仅显式关闭思考时发送温度。官方 OpenAI 推理模型使用现有 Responses 路径,避免 Chat Completions 对新模型工具调用的限制。Profile 中保存的温度不因这些发送规则而被改写。

/model 与 /reasoning 不是同一种保存 ​

/model 选择一个已经存在的 Profile,不改写其 provider、模型地址或凭据。SelectModelProfile 通过 SelectedProfile → CopilotConversationSession.SelectProfile 更新运行期选择、ActiveProfileId 和当前会话的 ProfileId,再由 PersistState() 请求保存会话状态。选择先在内存生效,状态保存由 CopilotChatStatePersistenceCoordinator 异步完成;命令的“后续请求将使用”不是耐久化回执,保存故障也没有在此选择方法中回滚。会话保存通知、重试与 Flush 属于状态所有权。

聊天输入框的模型菜单按连接分组;顶部供应商入口展开连接列表和“管理模型”,仅浏览连接不更改当前模型,点击模型或按 Enter 才应用选择。停用的供应商及模型不出现在列表中,旧 Profile 仍按自身 ID 独立分组。模型行仅按能力声明显示“视觉”标记。

模型菜单底部的推理滑杆与 /reasoning(兼容 /effort)都会修改当前 Profile 的 ReasoningMode。滑杆只使用 CopilotReasoningCapabilities 为该 Profile 声明的离散档位,拖动时预览、释放时保存;也可用方向键选择,菜单内 Ctrl+T 循环档位。不支持推理配置的模型不显示滑杆。本机 Codex 返回并显式选择的 GPT 推理模型也使用这些档位,选择值经 Agent Framework 传给 App Server。归一化后通过 TryPersistConfigMutation 克隆候选并使用上述三态提交;NotPersisted 保留原 Profile 并显示“推理模式未更改”,滑杆恢复原档位;PersistedButPublishFailed 显示“已保存,但当前聊天界面未能刷新”。成功后重新绑定发布的 Profile,而不是原地修改旧对象;使用同一个 Profile 的后续请求会读取这个配置,不应描述成仅本会话风格。

官方 api.openai.com 上的 GPT-6 Astra 与 GPT-6.1 Sol 提供 Default/Low/Medium/High/XHigh/Max,不提供 Disabled/Enabled;历史 Disabled 配置或 Codex none/minimal 覆盖发送前收敛为 low,ultra 收敛为 max。本机 Codex 显式选择这两个模型时也不提供关闭档位;动态模型列表仍由本机运行时决定。枚举新增值追加在已有数值之后,避免改变旧 JSON 中 Default/Disabled/Enabled/High/Max 的数字含义。伪装成 OpenAI vendor 的第三方兼容端点不会因此获得官方推理档位。

官方 api.anthropic.com 上的 Claude 按模型提供档位:Fable、Mythos、Opus 5、Opus 4.7/4.8、Sonnet 5、Haiku 5.5 为 Default/Low/Medium/High/XHigh,Opus 4.6、Sonnet 4.6 没有 XHigh,历史值收敛为 High;Haiku 4.5 等旧模型和兼容网关只有 Default,因为这些档位都会发送它们可能拒绝的自适应 thinking。当前模型不能关闭 thinking,共享枚举也没有 max,所以不提供 Disabled/Max。非默认档不发送 temperature。XHigh 建议最大输出 Token 不低于 64000。

SetSelectedProfileReasoningMode 返回是否完成设置(或已是所选值);SelectReasoningMode 只有成功时才回显“已设置/保持”,否则展示同一保存失败或刷新失败说明。已是所选值时不重复保存。

/personality 则修改会话回答风格,不属于 Profile 或 CopilotConfig 的保存;交互入口见本地交互。这三个命令不授权模型执行工具或更改审批策略。

凭据保护与两种 MCP ​

CopilotConfig 实现 IConfigSecure。ConfigHandler 序列化安全配置的克隆,CopilotCredentialProtector 用 Windows DPAPI CurrentUser 保护 Profile API Key 和入站 Local MCP 的 McpBearerToken,不把运行期明文对象改成密文。解密兼容旧格式;Profile 密钥无法恢复时清空并置 CredentialNeedsReentry,Local MCP token 无法恢复时清空,后续初始化可生成新 token。复制配置文件不能保证另一 Windows 用户能解密,也不能把文件保护误认为所有内存、网络或剪贴板数据都已脱敏。

外部 MCP client 的 bearer token 只从配置中指定的环境变量读取,配置保存的是环境变量名称,不是 token 值;其 URL、白名单、默认审批和发现生命周期由外部 MCP负责。入站 Local MCP 的复制按钮可以把 token 或含真实 token 的 PowerShell 命令写入剪贴板;Copy Codex Config / Copy Token Command 只复制,不替用户修改外部客户端配置或执行环境变量命令。Regenerate 先改变草稿,须 Apply / Save 才更新运行态,随后客户端也需更新凭据。

诊断与发现的副作用 ​

以下是入口契约,不是要求为核对文档而执行这些动作。涉及模型或 MCP 的检查需要用户明确选择对应服务;不要使用真实凭据或模型请求做默认文档验证。

入口读取什么、产生什么
Test Model使用当前选中的未保存 Profile 的克隆,固定短提示要求回答 OK,覆盖系统提示、MaxTokens=128(始终 thinking 的 Claude 模型另留 4096,官方端点固定低档)、Temperature=0,经 CopilotChatService 发起真实流式模型请求;可能产生供应商用量和传输重试,不保存设置、不运行 Agent 工具
Local MCP / Test Connection用窗口当前端口和 token 向 loopback 发送 HTTP;不先替用户保存或启用 server,不能据此验证未应用草稿已在运行
External MCP / Refresh Discovery从当前未保存的配置文本构造请求,强制实时连接与工具发现,更新进程内健康/缓存状态并释放本次 lease;不持久保存这份配置,也不调用发现到的业务工具
Refresh Diagnostics、/doctor、/mcp读取本地配置或已有健康快照,不等于执行 Test Model 或实时远端发现;命令范围见本地交互主题

Test Model 的结果记录耗时、可显示字符和重试;“Connected”也可能带“没有可显示文本”或“响应提前结束”的提示。它没有验证答案必须精确等于 OK,更不能证明工具调用、图像输入、业务正确性或账户额度可用。窗口关闭会请求取消诊断,但已经发送的请求和供应商用量不能由取消撤回。

诊断期间仍可切换和编辑 Profile;这些动作会使原诊断失效并请求取消。点击另一模型的测试会等待前一项完成取消清理后启动,始终只运行一项诊断;等待期间再次点击待测试模型、切换或编辑模型、取消或关闭窗口会撤销待启动请求。结果只允许回写到始终未切换、未编辑的原 Profile,切换后再切回或编辑后改回原值也不能沿用旧结果。成功与失败都在 UI 续体中复查 Profile 修订、取消和窗口寿命,避免已经完成的请求在取消或关窗后覆盖状态。

Profile 未变时,模型测试仍将成功或失败写入该模型的诊断区域;全局设置提示只有仍显示本轮测试提示时才被替换。测试期间用户编辑其它设置或保存校验失败产生的较新提示会保留,避免连接成功掩盖“设置尚未保存”或端口错误。

Local MCP 测试由 CopilotMcpConnectionDiagnostic 依次发送 initialize、notifications/initialized 和只读 tools/call get_server_status。初始化响应须匹配请求 ID、协议版本并返回有效 Mcp-Session-Id;后续请求携带该会话和协议头。只有通知得到确认、状态调用返回有效非错误结果时才显示 Connected。整条诊断共享 5 秒取消预算,JSON 响应有大小上限;HTTP、JSON-RPC 或工具错误均不报成功,远端错误正文不会直接回显,避免泄露 token 或会话 ID。此结果不验证其他工具权限、审批或业务执行。

测试绑定开始时的端口、token 和设置修订。修改启用状态、端口数值/文本或 token 会取消本轮测试;编辑后改回原值、输入无效端口或关闭窗口也不能接收旧结果。成功和异常的 UI 续体都会重查窗口、取消及修订状态,同时保留测试期间其他设置操作产生的新提示。取消不会撤回已发送请求,也不关闭已建立的服务端会话。

外部 MCP 刷新绑定开始时的草稿修订;编辑、清空或编辑后还原配置都会取消并使旧刷新失效。成功和失败都在 UI 续体复查修订、取消和窗口寿命,不能用旧服务列表覆盖当前配置,也不覆盖用户后来产生的其他设置提示。已完成的网络检查可能仍更新其服务的进程缓存/健康;取消不撤销这些已发生操作。诊断会逐个核查配置服务,范围和上限见外部 MCP 工具发现。

本地 Refresh Diagnostics、修改 Local MCP 设置、测试连接及构造诊断复制文本也会刷新外部服务的健康展示,但始终重新解析窗口当前的 ExternalMcpServersText,不拿已保存配置替换草稿对应的列表。空草稿显示无服务,无效草稿保留校验错误并清空服务行;有效草稿读取其自身的现有健康快照。这类展示刷新不执行外部发现、HTTP 请求或配置保存。

实现与验证入口 ​

  • Config/CopilotEffectiveConfigDiagnostics.cs、CopilotContextDiagnostics.cs、CopilotProjectInstructionDiagnostics.cs:分别生成配置来源、上下文提交预览和指令发现报告。
  • CopilotSettingsViewModel.ProfileManagement.cs、CopilotSettingsWindow.xaml.cs:按钮保存、Profile 草稿和模型诊断入口;Config/CopilotConfig.cs:规范化、候选发布、schema 与凭据边界。
  • CopilotChatViewModel.ConfigPersistence.cs、Composer.cs、ConversationCommands.cs:聊天中配置变更、三态反馈及命令回显;State/CopilotConversationSession.cs:只选择 Profile 的会话状态变化。
  • CopilotModelConnectionDiagnostic.cs、CopilotMcpConnectionDiagnostic.cs、CopilotSettingsViewModel.ExternalMcp.cs / McpOperations.cs:真实联网入口。 真实供应商、凭据和 MCP 连接需在部署环境验证。

设置窗口交互及本机 HTTP 监听需在实际宿主验证。

基于 MIT License 发布。