From cbf0ba30e7e469a63d017ecbc8a85bbe7a750761 Mon Sep 17 00:00:00 2001 From: CieanYau Date: Sat, 7 Nov 2026 09:37:25 +0800 Subject: [PATCH] =?UTF-8?q?=E6=98=8E=E7=A1=AEV0=E4=BB=85=E4=BF=9D=E7=95=99?= =?UTF-8?q?=E5=89=8D=E7=AB=AF=E5=B9=B6=E9=9A=94=E7=A6=BBV1=E5=90=8E?= =?UTF-8?q?=E7=AB=AF=E9=A1=B9=E7=9B=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..e2761f2 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,26 @@ +# V0 项目边界 + +本仓库属于 V0：Nuxt、Vue、OpenVue 和 Deni 会员前端。V0 只保留前端，不承载后端项目。 + +## 仓库隔离 + +- 本仓库远端为 `https://git.crash.work/cieanyau/console-dev.git`。 +- V1 位于 `/Users/cieanyau/Documents/ChatGPT/V1`；其中 Next.js、React 和 Shadcn 前端使用 `https://git.crash.work/cieanyau/console-new.git`，PHP 后端在其 `backend/` 子目录保持独立 Git 仓库。 +- V0 任务只修改本前端；V1 的前端、后端、依赖、分支和构建产物需要在各自任务范围处理，不互相合并或作为彼此的发布源。 +- 推送前核对工作树、分支和远端；只暂存本任务明确涉及的文件。 +- 提交说明使用中文，新增解释性代码注释使用中文。 + +## 发布隔离 + +- V0 正式站为 `console.crash.work`，发布根目录为 `/www/wwwroot/crashwork-console`，会员前端进程为 PM2 的 `crashwork-console`。 +- V1 开发站为 `console-dev.crash.work`，发布根目录为 `/www/wwwroot/console-dev.crash.work`，使用独立的 `console-dev.service`；这些目标不属于 V0 发布范围。 +- V0 发布只操作已经核实的 V0 目标，保留旧版本及回滚点；不得重启全部 PM2 进程或 V1 服务。 +- 构建、依赖目录、发布归档、运行配置及验收记录分别归属各自项目，不跨项目复用。 + +## 共享后端边界 + +- `/console/v1` 是 V10 业务系统的 API 前缀，与名为 V1 的前端项目不是同一个概念。 +- 两个前端目前共用该后端；前端仓库独立不代表 API 或数据库独立。 +- V0 前端发布不自动授权修改共享后端契约、执行数据库迁移或复制生产数据。影响共享后端的变更必须另行核对全部使用方，并按用户确认的后端范围发布。 +- 后端主仓库已经迁至 `/Users/cieanyau/Documents/ChatGPT/V1/backend`；关联工作树在 `V1/backend-worktrees/`，交付包在 `V1/backend-deliveries/`。不得在 V0 重建后端目录，也不得将完整后端源码或配置推送至本仓库。 +- 目录迁移不改变生产 API 或数据库。共享后端契约尚未配套发布时，不发布依赖该新契约的 V0 前端产物。