用途:这是 Positron 的 Agents 窗口(agents-first 应用)架构开发说明,用于指导在 src/vs/sessions/ 目录下修改或新增代码前的准备工作,保证实现与规范同步。
主要能力(文档覆盖的领域):
- 分层规则:LAYERS.md 定义内部层级 core → services → contrib → providers 及 ESLint 强制导入限制,contrib/* 不得导入 contrib/providers/*。
- 布局:LAYOUT.md 描述固定网格 Sidebar | ChatBar | AuxiliaryBar、部件位置、模态编辑器系统、按会话布局状态持久化与标题栏三段式设计。
- 布局控制器:LAYOUT_CONTROLLER.md 说明辅助栏、面板、编辑器工作集的捕获/还原、多会话抑制、变更自动显示与存储迁移。
- 会话模型:SESSIONS.md 覆盖可插拔 provider 模型(ISessionsProvider → ISessionsProvidersService → ISessionsManagementService)、ISession/IChat 接口、可观察状态传播与工作区模型。
- 会话列表:SESSIONS_LIST.md 说明树控件、渲染器、分组、筛选、置顶、已读状态与移动端适配。
- 移动端:MOBILE.md 说明手机 UI 子类架构、视口判定(phone < 640px)、抽屉侧栏等。
- AI 定制:AI_CUSTOMIZATIONS.md 说明管理编辑器与树视图。
使用方式:改动前必须阅读指定编码规范与源码组织说明,并按改动区域阅读相应 spec;修改实现后须同步更新对应 spec。常见陷阱包括菜单 ID 应使用 browser/menus.ts 的 Menus.、会话状态须用 IObservable 而非 Event、非 provider 的 contrib 代码不得导入 providers、新贡献文件需在对应 sessions..main.ts 入口导入、不要修改共享 workbench 组件、避免用超时或暂存状态做修复。
验证:完成前须运行 npm run compile-check-ts-native、npm run valid-layers-check,以及 scripts/test.sh --grep <pattern>。限制:资料未提供具体收费、价格、平台支持范围与使用步骤。