docs(stack): 命令执行环境描述改为引导查看 stack 命令,不再硬编码模式列表

This commit is contained in:
augushong
2026-05-27 21:42:43 +08:00
parent f49ca8d9cf
commit 20dc1b944c
2 changed files with 4 additions and 4 deletions

View File

@@ -29,8 +29,8 @@ description: "指导 AI agent 协助开发者使用 php think admin:update 同
php think admin:stack:mode current
```
- 如果返回 `docker-dev`,后续所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`
- 其他模式default/full/base-build直接执行 `php think`,不做转换
- 如果返回 Docker 模式(具体哪些模式属于 Docker 模式见 `php think admin:stack:mode list``source/stack/stack.json`,后续所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`
- 非 Docker 模式直接执行 `php think`,不做转换
### 3.2 确认代码已提交
@@ -251,6 +251,6 @@ php think admin:version
- **更新前务必确保代码已提交**:未提交的改动可能在更新过程中丢失
- **不自动执行 composer 或数据库操作**:这些操作影响面大,需开发者确认
- **大版本跳跃风险更高**:跨越多个 tag 时变更量大,建议格外谨慎,仔细审查 dry-run 输出
- **Docker 模式注意**如果是 `docker-dev` 模式所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`
- **Docker 模式注意**Docker 模式所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`(具体哪些模式属于 Docker 模式见 `php think admin:stack:mode list``source/stack/stack.json`
- **更新会临时占用磁盘**:命令会在 `runtime/update/` 下克隆上游仓库进行对比,完成后自动清理
- **版本更新说明**:更新完成后,命令会输出跨版本的更新说明(来自 `adminUpdateData/tips.php`),提醒开发者关注

View File

@@ -46,7 +46,7 @@
- 主工程之外的配套内容统一放在 `source/`:包括多端代码、子项目工程(可为 PHP 或其他技术栈)、项目资料、附件与部署配套文件;不影响当前主工程运行与发布;目录约定与安全要求见 `source/README.md`(禁止提交构建产物、依赖目录等)
- `source/` 下各子目录(客户端、大屏端、各类子项目等):若目录下存在 `AGENTS.md`,则该子工程规则以该文件为准
- 部署栈模式:`source/stack/` 为模式文件统一目录(含 `default/` 与各模式目录);`default/` 必须与代码库默认行为一致;默认行为相关文件变更时需同步更新 `source/stack/default/` 对应文件
- 命令执行环境:执行 `php think` 命令前,通过 `php think admin:stack:mode current` 检测当前模式;若为 `docker-dev`所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`(如 `docker compose exec ulthon_admin php think tools:http:call`其他模式default/full/base-build直接在宿主机执行 `php think`,不做转换
- 命令执行环境:执行 `php think` 命令前,通过 `php think admin:stack:mode current` 检测当前模式;Docker 模式下所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`(如 `docker compose exec ulthon_admin php think tools:http:call`具体哪些模式属于 Docker 模式见 `php think admin:stack:mode list``source/stack/stack.json`;非 Docker 模式直接在宿主机执行
- 权限:基于 `auth` 注解生成节点与鉴权;以角色为中心管理(角色、角色权限、用户角色);命令行使用见技能:[ulthon-permission-cli](./.agents/skills/ulthon-permission-cli/SKILL.md)
- 临时文件:智能体在任务中产生的临时文件(脚本、日志、缓存、产物等)统一输出到 `runtime/agents/`(可按智能体/任务再分子目录),不要放在仓库根目录;除非任务明确要求或框架约定位置属于根目录
- 调试与验证优先使用框架内置命令行工具tools:http:call、tools:db:*、tools:log:*、admin:menu:*、admin:permission:*),不需要借助外部数据库 MCP 或临时脚本