docs(deploy): 记录义务补充非默认端口要求

开发者修改了框架模板默认端口(HTTP 8000/MySQL 13306/Redis 16379 等)
时必须记录,否则智能体调试(如 tools:http:call)会用默认端口连接失败
This commit is contained in:
augushong
2026-07-23 22:07:57 +08:00
parent 1620af9ff2
commit 3de1b3c058

View File

@@ -31,10 +31,13 @@
当开发者确定/选择了项目的运行方式(无论是否使用框架预设的 stack 模式),智能体应当确认 `.agents/rules/project-dev-runtime-deploy.md` 中是否已记录该选择。如果未记录或内容仍为模板占位符,提醒开发者补充或协助填写。
记录内容不限定格式,开发者用一两句话写清楚"本项目用 xxx 方式运行"即可,无需详细参数列表。但必须包含个关键信息:**命令执行方式**——即 `php think` 等命令应当在哪里执行。例如:
记录内容不限定格式,开发者用一两句话写清楚"本项目用 xxx 方式运行"即可,无需详细参数列表。但必须包含个关键信息:
1. **命令执行方式**——即 `php think` 等命令应当在哪里执行。例如:
- Docker 模式:命令在容器内执行(`docker compose exec <service> php think ...`),不是宿主机直接 `php think`
- 宿主机模式:命令直接在仓库根目录执行
- 宝塔/其他:按实际环境的执行路径记录
目的是让后续会话中的智能体能从规则文件快速了解项目的实际运行方式和命令执行入口,而不需要重新询问或猜测
2. **非默认端口**——如果修改了框架模板的默认端口(如 HTTP 8000、MySQL 13306、Redis 16379 等),必须记录实际端口。否则智能体调试时(如 `tools:http:call`)会用默认端口连接,导致失败
目的是让后续会话中的智能体能从规则文件快速了解项目的实际运行方式、命令执行入口和访问地址,而不需要重新询问或猜测。