Skip to content

Copilot Agent Runtime ​

ColorVision Copilot 使用 Microsoft Agent Framework 作为唯一 Agent 执行层。模型、工具、审批、任务账本、恢复和会话状态都沿同一条运行路径处理;框架不可用时本轮明确失败,不切换到另一套规划器重放请求。

模型来源可选择 API Profile 或本机 Codex。后者由 CopilotCodexChatClient 适配 App Server:动态工具请求先返回宿主,再沿相同的 Agent Framework 执行与审批链处理;外部 Codex 的独立工具与权限申请不能代替宿主策略。安装探测、登录、临时会话及兼容限制见本机 Codex 接入。

项目指令、按需 Skill、子 Agent、外部 MCP 与 Hook 分别拥有发现、上下文、执行和权限边界;不要因为界面入口相近就把它们合成同一种配置。按下表定位各执行阶段的权威主题。

架构边界 ​

层级主要职责
Agent FrameworkSession、Harness、工具调用、原生审批、任务与模式
ColorVision Runtime能力筛选、预算、并发、恢复、审计和执行契约
业务模块扩展动态上下文和受宿主策略约束的窄业务工具
外部 MCP显式配置的 Streamable HTTP 工具发现与适配
本地 MCP Server向本机客户端提供受限的诊断、导航和确认操作

按任务定位实现 ​

问题/变更知识入口首查符号
设置保存、模型切换、凭据或联网诊断配置与发布CopilotSettingsViewModel、CopilotConfig、ConfigSavePublicationStatus
界面状态串会话、输入丢失、ViewModel 该怎么拆状态所有权CopilotConversationSession、CopilotComposerSession、ICopilotTurnRuntime
工具为什么没调用、委派权限或证据不足执行链CopilotToolRegistry、CopilotAgentExecutionContract
本地命令、回顾、查找、快捷键交互入口CopilotLocalCommandCatalog
Schema、审批、journal、恢复或 Flow 编辑契约工具契约CopilotToolExecutionContracts、CopilotAgentTaskEventJournal
AGENTS.md、压缩或请求预算生命周期CopilotAgentProjectInstructions、CopilotAgentTokenBudget
技能发现、调用、开关或 MCP 依赖Copilot 技能CopilotAgentSkillCatalog、CopilotAgentSkills
检查点、重试、任务 UI 或取消终态会话与工具CopilotAgentSessionCheckpoint、CopilotToolExecution
模块上下文、外部 MCP client 或 Hook扩展边界CopilotAgentExtensionRegistry、CopilotMcpToolProvider
让外部 Codex 读取本机 ColorVision本地 MCP serverCopilotMcpServer

验证 ​

从受影响的实现定位验证。ColorVision 自己管理 provider、model、tools 与 approval,保留 AGENTS.md / CLAUDE.md 指令发现。构建会写本地产物。

powershell
dotnet build ColorVision/ColorVision.csproj -p:Platform=x64

基于 MIT License 发布。