Skip to content

Latest commit

 

History

History
27 lines (21 loc) · 2.79 KB

AGENTS.md

File metadata and controls

27 lines (21 loc) · 2.79 KB

aBridge 开发约定

执行

  • 修复可确认的问题,保持最小完整改动;避免过度设计、审查和测试。用户要求的多轮独立评审按任务范围执行。
  • 主 Agent 协调实施与独立验证,明确并行任务的文件归属。验证失败先修复再复验;未通过的范围如实列出。
  • 保留工作树中已有改动。实际服务、账户及已安装客户端的变更按用户任务范围执行。
  • 当前为开发版本。结构冲突直接调整开发数据库,使用当前契约;不增加历史兼容分支或迁移脚本。

实现

  • 产品代码统一使用 strict TypeScript;Swift 只负责 macOS 壳与系统权限 UI。运行、构建和开发命令以根 package.json 为准。
  • 修改模块职责或执行流程前读 架构;安装与打包改动读 部署,浏览器改动读 浏览器客户端。
  • 根目录保留项目入口与工具约定配置;协作说明归 .github/,文档及品牌源归 docs/,测试目标和工具配置归 tools/。
  • 可运行产品归 apps/,共享包归 packages/;运行依赖归所属应用,根目录只声明开发工具。跨 workspace 使用具名 exports,执行 npm run architecture:check 核对依赖职责。
  • 共享能力、消息和工具契约只维护在 packages/protocol/src/。外部输入在入口解析,使用明确类型,不用 any 掩盖不匹配。
  • App 提供 screen/input/shell/files;扩展仅提供 browser,并直接连接 Server。两者独立安装、注册和授权,App 不转发浏览器请求。
  • 操作按 operation_id 去重;未知写操作不重放。暂停、撤销和能力关闭优先,自动重连不解除它们;会话资源分别清理。
  • Server 只依赖服务端运行环境。桌面 SDK 在设备端显式按需加载,以同进程模式运行;设备凭据保持私有权限、原子写入和服务地址绑定,日志不含秘密。
  • 版本单源为根 package.json;构建时生成各分发产物与扩展版本,保持生成文件可再现。

交付

  • 界面依靠布局和层级表达结构,只保留必要状态、字段、操作和错误。视觉修改前读 设计规范,重大方向先给参考。
  • 正式文档描述当前产品契约;私有部署、账号、截图和交付过程保留在忽略的 .local/。可复现测试使用虚构身份和自有 fixture,CI 不连接真实账号、桌面或服务。
  • 按改动完成必要检查,交付前执行 npm run check。通过后只因新变化、失败或未决问题扩大验证;协议替身不能代替系统权限和真实输入验收。
  • 提交按 贡献指南 使用 Conventional Commits;每个提交表达一个清晰的逻辑变化。