docs(agents): 修正对已退役 AdminInitServiceBase 与 AGENTS.md 旧章节名的失效引用

This commit is contained in:
augushong
2026-09-14 12:28:59 +00:00
parent 1c5c284492
commit 885b00e2d2
3 changed files with 6 additions and 6 deletions

View File

@@ -63,7 +63,7 @@ Ulthon Admin 在"类继承覆盖"之外,还提供"文件级覆盖"能力:业
下列路径与机制都不走 app/base 覆盖,业务侧在 `app/` 下放同名文件**不会**生效:
- `AdminInitServiceBase::requireData()`(`extend/base/admin/service/AdminInitServiceBase.php:139`):用 `__DIR__` 直接定位 `extend/base/admin/service/adminInitData/`,不支持 app 覆盖
- `InitDataAlignServiceBase` / `MenuAlignServiceBase` 的快照定位:用 `__DIR__` 直接定位 `extend/base/admin/service/adminInitData/`,不支持 app 覆盖
- 命令注册(`config/console.php`):空 `commands` 数组,命令通过 SPI 自动扫描 `app/common/command/`,不走覆盖
- 语言包(`config/lang.php`):标准 ThinkPHP 机制,不支持 app/base 覆盖
- 路由(`route/app.php`):空文件,无覆盖机制

View File

@@ -101,7 +101,7 @@ description: "详细说明了 Base/App 双层架构的设计理念、三层结
- 模板内 `{include}` 标签(与视图同源的三级查找)
- `app_file_path()` 辅助函数显式加载的文件(两级回退:`app/<相对路径>` → `extend/base/<相对路径>`)
注意:文件级覆盖只对**特定类型**的文件生效。命令、语言包、路由、`config/*`、`public/static/*`、`AdminInitServiceBase::requireData()` 等均**不支持**——业务侧在 `app/` 下放同名文件不会生效。
注意:文件级覆盖只对**特定类型**的文件生效。命令、语言包、路由、`config/*`、`public/static/*`、初始化数据快照对齐服务的 `__DIR__` 定位(`InitDataAlignServiceBase`、`MenuAlignServiceBase`)等均**不支持**——业务侧在 `app/` 下放同名文件不会生效。
完整的机制说明、7 处已知调用点清单与反例,见规则:[ulthon-file-override-mechanism](../../rules/ulthon-file-override-mechanism.md)。

View File

@@ -131,7 +131,7 @@ Rules 可包含以下类型的内容:
新增规则后,更新一处索引(根 `AGENTS.md`):
- `ulthon-` 前缀的规则:在「零散规则」章节的「框架内置规则索引」表中新增一行。
- `ulthon-` 前缀的规则:在「规则与技能」章节的「框架规则速览」表中新增一行。
- `project-` 前缀的规则:在「项目信息」节的规则索引清单中新增一行。
若「项目信息」节尚无规则索引清单,提醒开发者建立(索引是建议项,非硬性要求)。索引缺失时,`.agents/rules/` 目录的 `project-` 前缀约定仍可被发现,作为兜底。
@@ -144,7 +144,7 @@ Rules 可包含以下类型的内容:
智能体在以下场景应主动查阅 `.agents/rules/`:
1. 首次接触项目时,先看 `AGENTS.md` 的「框架内置规则索引」了解框架规则,再看根 `AGENTS.md` 的「项目信息」节中的规则索引(如有)了解项目业务规则
1. 首次接触项目时,先看 `AGENTS.md` 「规则与技能」章节的「框架规则速览」表了解框架规则,再看根 `AGENTS.md` 的「项目信息」节中的规则索引(如有)了解项目业务规则
2. 涉及特定模块开发时,查找该模块是否有对应的规则文件
3. 用户提到某个模块有特殊约束时,查找对应规则
@@ -152,8 +152,8 @@ Rules 可包含以下类型的内容:
- 规则内容变更时,同步更新文件内容和索引中的说明列
- 规则过期时,标记为"已废弃"或直接删除,并从索引中移除
- 框架更新时,只操作 `ulthon-` 前缀的规则文件与 AGENTS.md 的「框架内置规则索引」,不动 `project-` 前缀的文件
- 项目业务规则维护时,只操作 `project-` 前缀的规则文件与 AGENTS.md 项目信息节的规则索引,不动 `ulthon-` 前缀的文件与「框架内置规则索引」
- 框架更新时,只操作 `ulthon-` 前缀的规则文件与 AGENTS.md 的「框架规则速览」表,不动 `project-` 前缀的文件
- 项目业务规则维护时,只操作 `project-` 前缀的规则文件与 AGENTS.md 项目信息节的规则索引,不动 `ulthon-` 前缀的文件与「框架规则速览」表
## 索引格式