diff --git a/AGENTS.md b/AGENTS.md index 22d1aa3..4ec7e6c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,6 +12,7 @@ - 开发任务结束前必须执行并汇报 `git status -sb` - 功能、修复、规则或部署元数据变更完成后,必须创建人工语义 commit;`auto-save` 只算安全快照 - 默认先在本地 Docker 完整验证:`./scripts/start-local-docker.sh` 后运行 `./scripts/verify-local-docker.sh`;用户明确确认“可以推送 / 上推 / 部署”前,不要 `git push`,也不要运行生产部署脚本。 +- 涉及模型接入、API Key、图片生成或视频生成链路修复时,如果用户已经提供本地可用的 base/key 且没有明确禁止真实调用,Agent 必须直接触发一次最小真实生成做端到端验证,不能只停在配置检查、dry-run 或让用户手动点测;汇报时说明实际触发的模型、入口、任务 ID/生成 URL 或失败原因,以及是否产生了真实调用消耗。 - Gitea 是主远端,`origin` 必须指向 Gitea;只有在用户明确确认推送后,才把已验证的人工语义 commit 推送到 Gitea。 - 当前主分支为 `main`,Gitea 仓库为 `https://git.kang-kang.com/kangwan/20260512-skg-tk` - `.memory/worklog.json` 是辅助日志,不代替人工语义 commit 和 Gitea 远端记录 diff --git a/RULES.md b/RULES.md index 6cb31fd..475a614 100644 --- a/RULES.md +++ b/RULES.md @@ -3,6 +3,7 @@ ## 启动 - 本地 Docker 启动:`./scripts/start-local-docker.sh`(默认 Web `http://localhost:4390`、API `http://localhost:4391`、Postgres 数据在 `data-local/postgres`;首次会从 `deploy/.env.local.example` 生成 gitignored 的 `deploy/.env.local`) - 本地 Docker 验证:`./scripts/verify-local-docker.sh`(检查容器、`/login/`、未登录 `/api/health`、容器内 `/health` + Postgres) +- 本地真实生成验收:涉及模型接入、API Key、图片生成或视频生成链路修复时,已配置可用 base/key 且用户未明确禁止真实调用,就必须由 Agent 在本地 Docker / 当前画布中直接触发一次最小真实生成,记录模型、入口、任务 ID/生成 URL 或失败原因;不要只让用户自己手动点测。 - 本地 Docker 停止:`./scripts/stop-local-docker.sh` - 后台启动(不弹 Terminal):`./scripts/start-dev-background.sh`(通过 macOS launchd 后台托管;前端 4290 + 后端 4291,日志写入 `.logs/`) - 后台停止:`./scripts/stop-dev-background.sh`