r
9c9a51263c
汇总未提交工作区：Servers 列表 site_url 链接、终端页与选机器 UI、SSH 连通性与 Telegram 通知、agent/offline/unset_path 后台调度与 gate_ai_review 门控；更新 AGENTS 与 agent-exploration 规则（仅本机 commit）；同步 web/app 构建产物与相关文档。
45 lines
1.6 KiB
Plaintext
45 lines
1.6 KiB
Plaintext
---
|
||
description: 减少盲目搜文件、控制 Read 次数与 token 消耗
|
||
alwaysApply: true
|
||
---
|
||
|
||
# Agent 探索约束（省 token）
|
||
|
||
## 开始前
|
||
|
||
1. 读根目录 `AGENTS.md` 的「代码地图」与「问题 → 文件」表
|
||
2. 架构/API 全览只读 `docs/project/nexus-functional-development-guide.md`（或用户指定的 §），禁止为找结构全库 Grep
|
||
3. 用户已给出路径/文件名时，只读该路径，禁止扩大范围
|
||
|
||
## 搜索顺序
|
||
|
||
```
|
||
AGENTS.md / 功能指南 § → Grep（带 path）→ Read（≤3 个文件）→ 仍不够再扩一圈
|
||
```
|
||
|
||
- **禁止**无 `path` 的全仓库 `Grep` / `Glob`（除非用户明确要求全库）
|
||
- **Grep 优先于 Read**；Glob 只用于定位文件名，不逐个 Read 全部匹配
|
||
- 同一任务 **Read 不超过 5 个文件**；找到答案后立即停止
|
||
- 不要重复 Read 已在本对话出现过的文件
|
||
|
||
## 分层定位（禁止跨层乱搜）
|
||
|
||
| 层 | 路径 |
|
||
|----|------|
|
||
| HTTP 路由 | `server/api/<module>.py` |
|
||
| 业务 | `server/application/services/` |
|
||
| 数据访问 | `server/infrastructure/` |
|
||
| 模型 | `server/domain/models/` |
|
||
| 前端页 | `frontend/src/pages/` |
|
||
| 前端路由 | `frontend/src/router/index.ts` |
|
||
| 前端 API 客户端 | `frontend/src/api/` |
|
||
|
||
真实前端源码在 `frontend/src/`，不是 `web/app/*.html`（那是构建产物）。
|
||
|
||
## 文档索引
|
||
|
||
- 功能 SSOT：`docs/project/nexus-functional-development-guide.md`
|
||
- 文档导航：`docs/README.md`
|
||
- 本地路径/MCP：`docs/project/linux-dev-paths.md`
|
||
- 运维（连机/exec）：用户 Skill `Nexus平台` 或 `docs/project/nexus-1panel-operations-knowledge.md`
|