From 20dc1b944cd4049fca3354b939a3ac74f77af58a Mon Sep 17 00:00:00 2001 From: augushong Date: Wed, 27 May 2026 21:42:43 +0800 Subject: [PATCH] =?UTF-8?q?docs(stack):=20=E5=91=BD=E4=BB=A4=E6=89=A7?= =?UTF-8?q?=E8=A1=8C=E7=8E=AF=E5=A2=83=E6=8F=8F=E8=BF=B0=E6=94=B9=E4=B8=BA?= =?UTF-8?q?=E5=BC=95=E5=AF=BC=E6=9F=A5=E7=9C=8B=20stack=20=E5=91=BD?= =?UTF-8?q?=E4=BB=A4=EF=BC=8C=E4=B8=8D=E5=86=8D=E7=A1=AC=E7=BC=96=E7=A0=81?= =?UTF-8?q?=E6=A8=A1=E5=BC=8F=E5=88=97=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/ulthon-update-workflow/SKILL.md | 6 +++--- AGENTS.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.agents/skills/ulthon-update-workflow/SKILL.md b/.agents/skills/ulthon-update-workflow/SKILL.md index 552cc1d..6560ff3 100644 --- a/.agents/skills/ulthon-update-workflow/SKILL.md +++ b/.agents/skills/ulthon-update-workflow/SKILL.md @@ -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`），提醒开发者关注 diff --git a/AGENTS.md b/AGENTS.md index e5818d3..44b4d08 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 或临时脚本