SuperAPI AI 工具集

sessions

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:这是 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>。限制:资料未提供具体收费、价格、平台支持范围与使用步骤。