lms
fc23b75e95
- 通用框架分类由项目框架改为核心框架 - 模块索引补录第三方插件并校准各模块状态 - 项目规则入口声明核心规则完整定义 - 20/40 规则文档中重复 Git 规则改为链接引用 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
83 lines
3.0 KiB
Markdown
83 lines
3.0 KiB
Markdown
# AI 工具扫描范围
|
||
|
||
> 本文件定义 AI 工具在正常分析项目时应跳过的目录和文件，以节省 token 并避免误读本地缓存/生成噪音。
|
||
>
|
||
> Codex 和 Claude Code 均遵循此规则。
|
||
>
|
||
> 返回主规则索引：[rules/项目规则入口.md](项目规则入口.md)
|
||
|
||
---
|
||
|
||
## 通用跳过模式
|
||
|
||
| 模式 | 原因 |
|
||
|------|------|
|
||
| `.git/` | Git 版本控制元数据 |
|
||
| `.vs/` | Visual Studio 本地缓存 |
|
||
| `obj/` | .NET 编译中间输出目录 |
|
||
| `bin/` | .NET 编译输出目录 |
|
||
| `node_modules/` | Node.js 依赖目录 |
|
||
| `*.log` | 运行时日志 |
|
||
| `*.tmp` / `*.temp` | 临时文件 |
|
||
| `Thumbs.db` / `.DS_Store` | 系统缩略图/缓存 |
|
||
|
||
## Unity 项目跳过模式
|
||
|
||
由于 StrayFog 是 Unity 框架，若知识库关联 Unity 工程，AI 分析时还应跳过：
|
||
|
||
| 模式 | 原因 |
|
||
|------|------|
|
||
| `Library/` | Unity 本地缓存（资源导入、编译缓存、包缓存等），非项目源码 |
|
||
| `Temp/` | Unity 运行时临时文件 |
|
||
| `Logs/` | Unity 运行时日志 |
|
||
| `UserSettings/` | Unity 用户本地偏好设置 |
|
||
| `*.csproj` | 由 Unity 自动生成的项目文件 |
|
||
| `*.sln` | 由 Unity 自动生成的解决方案文件 |
|
||
| `Library/PackageCache/` | Unity Package Manager 缓存的第三方包源码 |
|
||
| `HybridCLRData/` | HybridCLR 构建生成输出（DLL、桥接文件等） |
|
||
|
||
## AI 工具本地状态
|
||
|
||
| 模式 | 原因 |
|
||
|------|------|
|
||
| `.codex/` | Codex 本地 hooks 状态 |
|
||
| `.claude/` | Claude Code 本地命令/技能状态（除 `config` 外） |
|
||
|
||
## 文档仓库跳过模式
|
||
|
||
本仓库本身以 Markdown 文档为主，以下文件通常无需 AI 全文读取：
|
||
|
||
| 模式 | 原因 |
|
||
|------|------|
|
||
| 图片、音频、视频等二进制资源 | 非文本内容 |
|
||
| `.claude/` 中的本地 skill/hook 状态 | 工具私有状态 |
|
||
| `__pycache__/` | Python 缓存 |
|
||
|
||
## 例外情况
|
||
|
||
当任务明确要求分析**构建问题**或**生成流程问题**时，可以按需读取以下目录中的特定文件：
|
||
|
||
- `HybridCLRData/` — 检查 HybridCLR 构建输出、DLL 生成结果或 AOT 桥接错误
|
||
- `Library/PackageCache/` — 检查特定包的版本或源码（仅限调试包相关问题时）
|
||
- `*.csproj` / `*.sln` — 检查项目引用或编译配置问题
|
||
|
||
> 例外读取后，应在分析结论中说明读取了哪些缓存/生成文件以及原因。
|
||
|
||
## 相关规则
|
||
|
||
- [rules/项目规则入口.md](项目规则入口.md) — 项目规则总索引
|
||
- [00-项目概览.md](00-项目概览.md) — 项目概览与重要目录说明
|
||
- [20-开发规则.md](20-开发规则.md) — 开发规则（含生成文件约束）
|
||
|
||
---
|
||
|
||
## 文档关联
|
||
|
||
> 当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
|
||
|
||
| 文档 | 关联原因 |
|
||
|---|---|
|
||
| [rules/项目规则入口.md](项目规则入口.md) | 项目设置是项目规则入口索引的关键规则 |
|
||
| [rules/00-项目概览.md](00-项目概览.md) | 扫描范围中的目录说明与项目概览互相引用 |
|
||
| [rules/20-开发规则.md](20-开发规则.md) | 生成文件约束、例外读取与扫描范围互相引用 |
|