openvscode-server 中的 AI 自定义管理编辑器:AI Customization Management Editor 架构与实战指南
openvscode-server 中的 AI 自定义管理编辑器:AI Customization Management Editor 架构与实战指南
导读
AI Customization Management Editor(AI 自定义管理编辑器)是 openvscode-server 仓库中面向 AI 定制的全局管理面板:它把 Agents(智能体)、Skills(技能)、Instructions(指令)、Prompts(提示词)、Hooks(钩子)、MCP Servers(MCP 服务器)与 Models(模型)统一收纳进一个分栏导航 + 内容区的编辑器界面,并针对 Agent 会话场景做了 Worktree/User/Extension 三种存储来源的集中发现与管理。阅读本文后,你将掌握该编辑器的组件层次、七个分区各自的职责、搜索/分组/徽章机制、嵌入式编辑器与 AI 引导创建流程,以及它如何复用 VS Code 既有服务来实现"管理而不重复造轮子"的设计原则。
本文以 SPEC.md 为核心骨架,结合仓库内实现源码展开讲解;所有路径均以仓库根目录为基准。
一、功能定位:面向 Agent 会话的全局管理面
SPEC 开篇即明确了编辑器的定位:A global management surface for AI customizations(AI 定制的全局管理表面),它提供分节式导航(sectioned navigation)和一个在提示词列表、MCP 服务器、模型与嵌入式编辑器之间切换的内容区。其核心目标写得很清楚:
Centralized discovery and management across worktree, user, and extension sources, optimized for agent sessions.
即:在 Worktree(工作树)、User(用户)与 Extension(扩展)三类来源之间做集中式发现与管理,并且为 Agent 会话做了专门优化。实现位于 src/vs/sessions/contrib/aiCustomizationManagement/browser/ 目录下,下文所有源码引用均指向这一目录。
"为 Agent 会话优化"在代码中体现为对 ISessionsManagementService 的依赖:活动会话(active session)的 worktree 与 repository 信息成为自定义项归属判断的"事实来源",这在后文"活动会话作用域"小节会详细展开。
二、整体架构:EditorPane + SplitView 组件层次
2.1 组件层次结构
SPEC 给出了官方组件树:
AICustomizationManagementEditor (EditorPane)
├── SplitView (Horizontal orientation)
│ ├── Sidebar Panel (Left)
│ │ └── WorkbenchList (sections)
│ └── Content Panel (Right)
│ ├── PromptsContent (AICustomizationListWidget)
│ ├── MCP Content (McpListWidget)
│ ├── Models Content (ChatModelsWidget)
│ └── Embedded Editor (CodeEditorWidget)
这与 aiCustomizationManagementEditor.ts 中的实现完全吻合:AICustomizationManagementEditor 继承 EditorPane,在构造器中注入 ITelemetryService、IThemeService、IStorageService、IInstantiationService、IContextKeyService、IOpenerService、ITextModelService、IConfigurationService、ILayoutService、ICommandService、ISessionsManagementService 与 IWorkingCopyService,并构建出七个侧边栏分区项。
2.2 文件结构
SPEC 列出的目录结构对应仓库中的实际文件(已确认全部存在):
src/vs/sessions/contrib/aiCustomizationManagement/browser/
├── aiCustomizationManagement.ts # IDs + context keys
├── aiCustomizationManagement.contribution.ts # Commands + context menus
├── aiCustomizationManagementEditor.ts # SplitView list/editor
├── aiCustomizationManagementEditorInput.ts # Singleton input
├── aiCustomizationListWidget.ts # Search + grouped list
├── customizationCreatorService.ts # AI-guided creation flow
├── mcpListWidget.ts # MCP servers list
├── aiCustomizationOverviewView.ts # Overview view
└── media/
└── aiCustomizationManagement.css
各文件职责与 SPEC 注释一一对应,下文将逐个深入。
2.3 SplitView 布局与状态持久化
在 createSplitView() 中,编辑器使用水平方向(Orientation.HORIZONTAL)的 SplitView:
- 侧边栏视图:最小宽度
SIDEBAR_MIN_WIDTH = 150、最大宽度SIDEBAR_MAX_WIDTH = 350、默认宽度SIDEBAR_DEFAULT_WIDTH = 200; - 内容视图:最小宽度
CONTENT_MIN_WIDTH = 400,最大宽度不限。
这些常量定义在 aiCustomizationManagement.ts。此外布局还带有两个易用性细节:
- 宽度持久化:拖动分隔条(sash)后触发
onDidSashChange,把侧边栏宽度写入 profile storage(键名aiCustomizationManagement.sidebarWidth); - 双击重置:双击分隔条触发
onDidSashReset,将侧边栏恢复为默认 200px 宽度。
三、注册与命令:从命令面板打开的入口
3.1 编辑器 Pane 注册
aiCustomizationManagement.contribution.ts 通过 IEditorPaneRegistry 把 AICustomizationManagementEditor 注册为名为 "AI Customizations Editor" 的编辑器 Pane,ID 为 workbench.editor.aiCustomizationManagement(常量 AI_CUSTOMIZATION_MANAGEMENT_EDITOR_ID)。同时注册了同名的 IEditorSerializer,用于会话恢复。
3.2 打开命令与可见性门控
命令 aiCustomization.openManagementEditor(AICustomizationManagementCommands.OpenEditor)在 Actions 贡献 中注册,标题为 "Open AI Customizations",分类为 Chat,并设置了:
precondition: ChatContextKeys.enabled—— 命令可用性受 Chat 上下文键门控;f1: true—— 可被命令面板搜索到;- 执行逻辑:通过
AICustomizationManagementEditorInput.getOrCreate()获取单例输入,然后在活动编辑器组中以{ pinned: true }打开。
SPEC 中列出的其他命令 ID(aiCustomization.createNewAgent、createNewSkill、createNewInstructions、createNewPrompt)同样定义在 aiCustomizationManagement.ts。
3.3 单例 EditorInput
aiCustomizationManagementEditorInput.ts 实现了一个无文件资源(resource = undefined)的单例输入:getOrCreate() 在实例不存在或已释放时新建,否则复用。它的独特之处在于动态 Tab 标题:setSectionLabel() 会把当前分区标签拼进标题,例如 "Customizations: Prompts",并在变更时触发 _onDidChangeLabel 事件,从而让编辑器 Tab 名称随分区切换实时更新。图标固定为 Codicon.settingsGear。
四、编辑器主体:分区导航与内容切换
4.1 七个分区
AICustomizationManagementEditor 在构造器中构建侧边栏分区列表,顺序与图标如下:
| Section ID | 显示名 | 图标 |
|---|---|---|
agents |
Agents | agentIcon |
skills |
Skills | skillIcon |
instructions |
Instructions | instructionsIcon |
prompts |
Prompts | promptIcon |
hooks |
Hooks | hookIcon |
mcpServers |
MCP Servers | Codicon.server |
models |
Models | Codicon.vm |
其中 Agents / Skills / Instructions / Prompts / Hooks 五个分区属于"基于提示词文件"的分区(isPromptsSection() 判定),统一由 AICustomizationListWidget 渲染;MCP Servers 由 McpListWidget 渲染;Models 由 ChatModelsWidget 渲染。内容区在 updateContentVisibility() 中按当前分区与视图模式(list/editor)切换显示。
4.2 分区状态持久化与 Context Keys
编辑器把"上次选中的分区"持久化到 profile storage(键 aiCustomizationManagement.selectedSection),打开时会先尝试恢复(构造器),因此符合 SPEC 描述的"编辑器打开时回到上次的分区"。
两个上下文键定义在 aiCustomizationManagement.ts:
aiCustomizationManagementEditorFocused—— 编辑器是否聚焦;aiCustomizationManagementSection—— 当前选中分区(默认agents)。
在 setInput 时二者会被设置为 true / 当前分区,clearInput 时重置。
4.3 Overview 视图
AICustomizationOverviewView 是一个紧凑的 ViewPane,对 Agents / Skills / Instructions / Prompts 四个分区展示数量快照,每个分区都是一个可点击的卡片(支持鼠标点击、Enter/空格键盘操作与 hover 提示)。点击后通过 openSection() 打开单例编辑器输入,并调用 AICustomizationManagementEditor.selectSectionById() 实现"深链"到对应分区。数量在提示词服务变化、工作区文件夹变化或活动会话变化时自动刷新。
五、AICustomizationListWidget:搜索、分组与徽章
AICustomizationListWidget 是五个"提示词类"分区的核心列表控件,SPEC 描述的能力在源码中均有对应实现。
5.1 分区到提示词类型的映射
sectionToPromptType()(L273-L287)将分区映射为 PromptsType 枚举:Agents → agent,Skills → skill,Instructions → instructions,Hooks → hook,Prompts → prompt。该枚举定义在 promptTypes.ts,共五类。
5.2 三种存储来源与分组
PromptsStorage 枚举(promptsService.ts)定义了三个存储来源:
local—— Worktree(工作树);user—— User(用户级);extension—— Extension(扩展提供)。
列表在 filterItems()(L849-L927)中按此三分组,每组渲染一个可折叠的组头(含 chevron 箭头、组图标、组名与数量),并带有"非首组加分隔线"的视觉处理(常量 GROUP_HEADER_HEIGHT / GROUP_HEADER_HEIGHT_WITH_SEPARATOR)。折叠状态保存在内存 collapsedGroups 集合中,点击组头即可展开/收起。
每个列表项(IAICustomizationListItem,L57-L68)携带存储徽章(Storage Badge)与 Git 状态徽章(Git Status Badge):
- 存储徽章:Worktree 用 workspaceIcon、User 用 userIcon、Extension 用 extensionIcon,通过
title提示来源; - Git 状态徽章:
updateGitStatus()(L809-L825)通过ISCMService的资源组(resource groups)构建"未提交 URI 集合",工作树项若在集合中则标记为未提交(uncommitted,徽章隐藏),否则显示对勾并标注 "Committed"。SCM 仓库的onDidChangeResources事件会触发徽章刷新,因此提交文件后列表会即时更新。
5.3 搜索行为
SPEC 强调两个搜索行为,源码逐一印证:
- 模糊匹配:
filterItems()使用matchesFuzzy(query, item.name/description/filename, true)对名称、描述和文件名三字段做模糊匹配,匹配到的子串还会通过HighlightedLabel高亮显示; - 防抖过滤:搜索框
onDidChange触发Delayer(200)(this.delayedFilter = new Delayer<void>(200)),即 200ms 防抖后才执行filterItems()。
空状态(Empty State)也分两种:搜索无结果时显示 "No items match '{query}'" + "Try a different search term";分区本身为空时按分区展示图标、标题与描述(如 "No agents yet" / "Create your first custom agent to get started")。
5.4 活动会话作用域
SPEC 明确:"The active worktree comes from IActiveSessionService and is the source of truth for scoping"。当前仓库中该服务实现为 sessionsManagementService.ts(ISessionsManagementService),提供 activeSession 可观察对象与 getActiveSession()。助手函数 getActiveSessionRoot()(aiCustomizationManagement.ts)返回:
export function getActiveSessionRoot(activeSessionService: ISessionsManagementService): URI | undefined {
const session = activeSessionService.getActiveSession();
return session?.worktree ?? session?.repository;
}
即优先取 worktree,其次取 repository。该根路径被用于:
- 列表加载时确定活动仓库(
loadItems()中的activeRepo); - "Copy Relative Path" 时计算相对路径基准(L509-L519);
- Add 按钮判断是否存在活动工作树;
- 创建时解析目标目录。
同时列表通过 autorun 订阅 activeSessionService.activeSession,活动会话变化时自动刷新计数与过滤结果。
5.5 上下文菜单动作
右键列表项触发 onContextMenu()(L480-L526),菜单由两部分组成:
- 菜单注册动作(来自
AICustomizationManagementItemMenuId,注册于 contribution 文件):- Open(
aiCustomizationManagement.openFile)—— 在普通编辑器中打开该文件; - Run Prompt(
aiCustomizationManagement.runPrompt)—— 仅当项类型为prompt时显示,执行workbench.action.chat.run.prompt.current运行该提示词; - Reveal in OS —— 标题按平台本地化(Windows 为 "Reveal in File Explorer",macOS 为 "Reveal in Finder",其他为 "Open Containing Folder"),且仅在 URI scheme 为
file:或vscode-userdata:时显示; - Delete —— 删除动作(详见 5.6)。
- Open(
- 复制路径动作(内联构建):Copy Full Path 写入
uri.fsPath;Copy Relative Path 优先基于活动会话根计算相对路径,失败时回退到ILabelService.getUriLabel(uri, { relative: true })的工作区相对路径。
5.6 删除动作与扩展文件护栏
删除动作在 contribution 文件 L180-L218 中实现,SPEC 提到的"extension-file guardrails"体现在两处:
- 扩展文件不可删:若存储来源为
extension,直接弹出IDialogService.info对话框说明 "Files provided by extensions cannot be deleted. You can disable the extension...",不执行删除; - 确认对话框:删除前用
dialogService.confirm做警告型确认("Are you sure you want to delete '{name}'?" / "This action cannot be undone."),确认后通过IFileService.del(uri, { useTrash: true })删除(进回收站)。
5.7 分区页脚
每个分区列表底部有页脚,含描述文字与文档链接,通过 IOpenerService.open() 打开外部文档。源码 updateSectionHeader() 为五个分区分别配置了描述与链接:
| 分区 | 页脚描述(翻译) | 链接文案 |
|---|---|---|
| Agents | 配置 AI 针对特定开发任务采用不同人格,每个 Agent 有独立指令、工具与行为 | Learn more about custom agents |
| Skills | 提示词、脚本与资源的文件夹,Copilot 在相关时加载以执行专项任务 | Learn more about agent skills |
| Instructions | 定义影响 AI 生成代码与处理任务方式的通用准则 | Learn more about custom instructions |
| Hooks | 在 Agent 生命周期特定节点执行的提示词 | Learn more about hooks |
| Prompts | 面向代码生成、评审、脚手架等常见任务的可复用提示词 | Learn more about prompt files |
SPEC 的 Known Gaps 明确指出 Hooks 的文档链接目前是占位符,需在可用后更新——这与源码一致(docsUrl 指向 hooks 文档)。
六、创建流程:手动创建与 AI 引导创建
SPEC 强调 "This is the only UI surface for creating new customizations"(这是创建新自定义项的唯一 UI 入口),因此 Add 按钮是本编辑器的关键功能。
6.1 Add 按钮行为
updateAddButton()(L581-L603)按上下文动态调整按钮:
- 主按钮目标:存在活动 worktree 时主按钮为 "New {Type} (Worktree)",否则为 "New {Type} (User)";
- 下拉菜单(
getDropdownActions(),L608-L626):- 有 worktree 且类型非 hook 时,提供 "New {Type} (User)"(用户级创建);
- 始终提供 "Generate {Type}"(AI 引导创建,带 sparkle 图标);
- Hooks 特例:Hooks 分区使用内置的 "Configure Hooks" 流程(
showConfigureHooksQuickPick),不提供用户级创建;并且按钮仅在存在 worktree 时可用,否则禁用并提示 "Open a session with a worktree to configure hooks."。
6.2 手动创建:带模板的 newPromptFileActions
手动创建走 createNewItemManual()(aiCustomizationManagementEditor.ts L640-L687),根据分区类型映射到四个既有命令(定义于 newPromptFileActions.ts 导入处):
| PromptsType | 命令 ID |
|---|---|
prompt |
NEW_PROMPT_COMMAND_ID |
instructions |
NEW_INSTRUCTIONS_COMMAND_ID |
agent |
NEW_AGENT_COMMAND_ID |
skill |
NEW_SKILL_COMMAND_ID |
目标目录由 CustomizationCreatorService 解析(worktree 模式用 resolveTargetDirectory,user 模式用 resolveUserDirectory),文件创建完成后通过 openFile 回调直接进入嵌入式编辑器,最后 refresh() 刷新列表让新项出现。这里有一个值得注意的已知限制(源码 TODO 注释):工作树中新创建的文件当前没有 git 暂存/提交机制,因此不会立即出现在工作树的 Changes 差异视图中。
6.3 AI 引导创建:隐藏系统指令的聊天
CustomizationCreatorService.createWithAI()(customizationCreatorService.ts)是 AI 引导创建的实现,SPEC 描述的 "opens a new chat with hidden system instructions" 可完整对应:
- 先用
IQuickInputService.input询问新项名称(校验非空,占位符如e.g., my-agent); - 解析目标目录(
resolveTargetDirectory基于活动会话根 +getPromptFileDefaultLocations的默认位置); - 构建用户不可见的系统指令
buildAgentInstructions()与可见的用户消息buildUserMessage(); - 执行
workbench.action.chat.newChat开启新聊天,再通过chatService.sendRequest()以 Agent 模式(ChatModeKind.Agent、modeId: 'custom')发送请求,其中modeInstructions携带隐藏指令(name: 'customization-creator')。
隐藏系统指令的 CRITICAL WORKFLOW 非常具体:要求 AI 在第一条回复中就立即用占位内容把文件写到磁盘(先写文件以出现在 diff 视图,再询问用户如何定制),后续每条用户消息都更新同一文件,并且"总是写完整文件内容而非部分 diff"。不同类型还规定了目标文件命名:{name}.agent.md、SKILL.md 目录、{name}.instructions.md、{name}.prompt.md 等。
源码 TODO 同时指出已知限制:'Generate X' 流程打开的聊天尚未绑定活动 worktree,后台 Agent 需要支持 worktree 参数才能把文件写入正确的会话工作树目录。此外,打开聊天前会先关闭管理编辑器(group.closeEditor(input)),确保聊天窗口获得焦点。
七、嵌入式编辑器:CodeEditorWidget 与自动提交
7.1 完整编辑器体验
SPEC 说明嵌入式编辑器使用 CodeEditorWidget 提供完整编辑体验。createEmbeddedEditor()(aiCustomizationManagementEditor.ts L471-L528)配置的选项包括:
- 基于
getSimpleEditorOptions的简单编辑器基础选项; minimap关闭、行号开启、wordWrap: 'on'、scrollBeyondLastLine: false、folding: true、整行高亮(renderLineHighlight: 'all');- 不标记为 simple widget,从而保留默认的完整贡献(IntelliSense、补全、lint 等);
- 溢出控件(hover、suggest 等)挂到工作台根容器,避免被
overflow: hidden父容器裁剪。
编辑区顶部是带返回按钮的头部:左侧显示项名称与文件名,右侧是保存指示器——内容变更时显示旋转加载图标("Saving..."),工作副本保存事件(IWorkingCopyService.onDidSave)触发后切换为对勾("Saved")。
7.2 编辑/返回与自动提交
showEmbeddedEditor()(L533-L583)通过 ITextModelService.createModelReference(uri) 获取文本模型并挂载到编辑器;扩展来源的项会以只读方式打开(updateOptions({ readOnly: true }))。
点击返回按钮或切换分区时触发 goBackToList()(L588-L620):若正在编辑的是 worktree 文件,则调用 commitWorktreeFile()——它委托 activeSessionService.commitWorktreeFiles(session, [fileUri])(实现于 sessionsManagementService.ts 的接口契约)提交文件,并刷新列表;随后释放模型引用、清空编辑器模型、切回列表视图并聚焦搜索框。clearInput() 时若仍处于编辑模式也会先执行回退逻辑,保证状态一致。
八、McpListWidget:MCP 服务器管理
McpListWidget 负责 MCP 分区:
- 数据源:
IMcpWorkbenchService.local(本地 MCP 服务器)+IMcpService.servers(连接状态),两者变化时自动刷新(onChange与autorun); - 行渲染:每行高 60px,展示服务器图标、名称、描述与实时连接状态——通过
autorun订阅server.connectionState,按McpConnectionState.Kind渲染 Running(运行中)/ Starting(启动中)/ Error(错误)/ Stopped(已停止)四种状态徽章; - 搜索:与列表控件一致的 200ms 防抖搜索框,按 label 与 description 子串过滤(注意这里用的是
includes简单子串匹配而非模糊匹配); - 添加服务器:"Add Server" 按钮执行
McpCommandIds.AddConfiguration命令; - 空状态:无任何服务器时显示 "No MCP servers configured" + "Add an MCP server configuration to get started";搜索无结果时显示 "No servers match '{query}'";
- 上下文菜单:复用 MCP 模块的
getContextMenuActions(),保持与既有 MCP 管理界面行为一致; - 单击打开:
onDidOpen调用mcpWorkbenchService.open(element); - 页脚:描述 "An open standard that lets AI use external tools and services..." 并链接到 MCP 文档。
九、Models 分区:复用 ChatModelsWidget
Models 分区直接托管工作台的 ChatModelsWidget(AICustomizationManagementEditor 中 createInstance(ChatModelsWidget)),仅在切换到该分区时才 render(),并预留页脚高度参与布局。页脚文案为 "Browse and manage language models from different providers. Select models for use in chat, code completion, and other AI features.",链接指向语言模型文档。这一设计正是 SPEC "Service Alignment" 原则的体现:模型管理完全复用既有组件,本编辑器不重复实现。
十、服务对齐原则与浏览器兼容约束
SPEC 的 "Service Alignment (Required)" 是设计层面的硬性要求,值得单独理解:
AI customizations must lean on existing VS Code services with well-defined interfaces. The management surface should not reimplement discovery, storage rules, or MCP lifecycle behavior.
即管理界面不得重新实现发现、存储规则或 MCP 生命周期行为,而应依赖既有服务。SPEC 列出的五个必备服务(均已转换为仓库根相对路径,全部存在):
- 提示词发现与元数据:promptsService.ts(
IPromptsService,含listPromptFiles、getCustomAgents、getPromptSlashCommands、findAgentSkills等发现 API,PromptsStorage枚举亦在其中); - 活动会话作用域(worktree):sessionsManagementService.ts(
ISessionsManagementService,提供activeSession可观察对象、getActiveSession()、commitWorktreeFiles()); - MCP 服务器与连接:mcpService.ts(
IMcpService,提供服务器列表与连接状态); - MCP 管理与图库:mcpManagement.ts(
IMcpWorkbenchService相关接口); - 聊天模型:chatService.ts(
IChatService,被CustomizationCreatorService用于发送 AI 引导创建的请求)。
结合源码可以补充两条 SPEC 未展开但对实践很关键的约束:
- 浏览器兼容:SPEC 明确 "Do not use Node.js APIs; rely on VS Code services that work in browser contexts"。这与 openvscode-server 的浏览器访问定位一致——整个 AI 定制管理模块只使用
ITextModelService、IFileService、IOpenerService等跨平台服务,未出现任何 Node 专属 API(文件 I/O 全部走IFileService抽象)。 - 事件驱动的实时刷新:列表、MCP 列表与 Overview 视图都订阅了底层服务的变更事件(
onDidChangeSlashCommands、onDidChangeCustomAgents、onDidChangeWorkspaceFolders、SCM 资源变化、活动会话变化等),保证在外部修改文件或切换会话时界面自动同步,无需手动刷新。
十一、集成点一览
SPEC 的 Integration Points 小节汇总了编辑器的外部依赖,对照源码整理如下:
| 服务 | 用途 | 对应源码位置 |
|---|---|---|
IPromptsService |
agent/skill/prompt/instructions 发现 | aiCustomizationListWidget.ts |
parseAllHookFiles |
hooks 解析 | aiCustomizationListWidget.ts |
ISessionsManagementService |
worktree 过滤 / 自动提交 | aiCustomizationManagementEditor.ts |
ISCMService |
git 状态徽章 | aiCustomizationListWidget.ts |
ITextModelService / IFileService |
嵌入式编辑器 I/O 与删除 | aiCustomizationManagementEditor.ts、contribution 文件 |
IDialogService |
删除确认与扩展文件护栏 | contribution 文件 |
IOpenerService |
文档链接与外部导航 | aiCustomizationListWidget.ts |
十二、已知局限(Known Gaps)
SPEC 诚实列出了三项已知局限,源码均可以印证:
- 无批量操作与排序:列表仅支持单选、折叠分组与按名称排序(
localeCompare),没有多选批量删除/移动,也没有自定义排序; - 搜索词不跨会话持久化:尽管 aiCustomizationManagement.ts 定义了
AI_CUSTOMIZATION_MANAGEMENT_SEARCH_KEY存储键,但搜索框的值目前没有读写该键(setSearchQuery/clearSearch仅操作内存中的 InputBox 值); - Hooks 文档链接是占位符:Hooks 分区页脚的文档链接需在官方文档可用后更新。
此外,结合源码还可以补充两个实现层面已知的 TODO(上文已分别提及):手动创建的工作树文件暂无法自动 git 暂存/提交;AI 引导创建的新聊天暂未绑定活动 worktree 参数。这些限制说明该功能正处于快速演进中,集成前建议核对当前仓库的最新实现。
结语
AI Customization Management Editor 是 openvscode-server 中"以既有服务为骨架、以会话为作用域"的 AI 定制管理实现范本:七个分区、三类存储来源、模糊搜索 + 分组 + 徽章、嵌入式 CodeEditorWidget、AI 引导创建与自动提交构成了完整闭环,而"不重复实现发现/存储/MCP 生命周期"的对齐原则让它保持了可维护性与浏览器兼容性。对于希望在浏览器环境中集中管理 AI 提示词类资产的开发者,直接阅读 SPEC.md 与 aiCustomizationManagementEditor.ts 是理解该模块最直接的入口。