$ loading_
用于理解 Agents 窗口架构，指导功能开发、扩展接入与问题修复。
复制安装指令，让 AI 自动完成配置 · 推荐新手
请帮我安装 askskill 上的 "sessions" 技能： 1. 下载 https://raw.githubusercontent.com/microsoft/vscode/main/.github/skills/sessions/SKILL.md 2. 保存为 ~/.claude/skills/sessions/SKILL.md 3. 装好后重载技能，告诉我可以用了
请根据 Agents window architecture，说明我要新增一个会话侧边栏按钮时，应该修改哪些层、文件夹和入口点，并给出推荐的实现顺序与注意事项。
一份新增功能的架构落点说明，包含相关目录、扩展点、实现步骤与开发规范建议。
我在 Agents 窗口的 chat widget 中遇到菜单事件不触发的问题。请基于该架构说明可能涉及的 contributions、menus、entry points 和排查顺序。
一份结构化的问题排查清单，帮助定位菜单事件失效的可能原因与修复位置。
请把 Agents-first app 的 layering、folder structure 和各模块职责整理成清晰说明，方便新成员快速理解 Sessions 相关开发约定。
一份面向新成员的架构导览，清楚说明分层边界、目录职责和常见开发入口。
MANDATORY: Before writing or modifying any code in src/vs/sessions/, you must read these documents:
.github/instructions/coding-guidelines.instructions.md — Naming conventions, code style, string localization, disposable management, and DI patterns..github/instructions/source-code-organization.instructions.md — Layers, target environments, dependency injection, and folder structure conventions.Then read the relevant spec for the area you are changing (see table below). If you modify the implementation, you must update the corresponding spec to keep it in sync.
| Document | Path | When to read |
|---|---|---|
| Layer rules | src/vs/sessions/LAYERS.md | Before adding any cross-module imports. Defines the internal layer hierarchy (core → services → → ) with ESLint-enforced import restrictions. Key rule: must NOT import from . |
contribproviderscontrib/*contrib/providers/*| Layout spec | src/vs/sessions/LAYOUT.md | Before changing any part, grid structure, titlebar, or CSS. Documents the fixed grid layout (Sidebar | ChatBar | AuxiliaryBar), part positions, the modal editor system, per-session layout state persistence, and the titlebar's three-section design. |
| Layout controller spec | src/vs/sessions/LAYOUT_CONTROLLER.md | Before changing LayoutController or per-session layout state. Details how the auxiliary bar, panel, and editor working sets are captured/restored when switching sessions, multi-session suppression, the auto-reveal-on-changes flow, workspace-folder ordering, and storage/migration. |
| Sessions spec | src/vs/sessions/SESSIONS.md | Before changing session/provider interfaces or data flow. Covers the pluggable provider model (ISessionsProvider → ISessionsProvidersService → ISessionsManagementService), ISession/IChat interfaces, observable state propagation, workspace/folder model, and session type system. |
| Sessions list spec | src/vs/sessions/SESSIONS_LIST.md | Before changing the sessions sidebar list. Covers the tree widget (WorkbenchObjectTree), renderers, grouping (workspace/date), filtering (type/status/archived/read), pinning, read/unread state, workspace capping, mobile adaptations, storage keys, and registered actions. |
| Mobile spec | src/vs/sessions/MOBILE.md | Before adding any phone-specific UI. Covers the mobile part subclass architecture, viewport classification (phone < 640px), MobileTitlebarPart, drawer-based sidebar, MobilePickerSheet, view/action gating with IsPhoneLayoutContext, and the desktop → mobile component mapping. |
| AI Customizations | src/vs/sessions/AI_CUSTOMIZATIONS.md | Before working on the customization editor or tree view. Documents the management editor (in vs/workbench) and the tree view/overview (in vs/sessions/contrib/aiCustomizationTreeView). |
MenuId.* from vs/platform/actions for Agents window UI. Always use Menus.* from browser/menus.ts.IObservable, not Event. Use autorun/derived for reactive UI, not onDid* event listeners.contrib/* code must never import from contrib/providers/*. Extract shared interfaces to services/ or common/.sessions.*.main.ts entry point to be loaded (for example sessions.common.main.ts, sessions.desktop.main.ts, sessions.web.main.ts, or sessions.web.main.internal.ts).…
在线程中中转 AI 与本地编码代理消息，并通过 API 共享文件协作开发。