# 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) | 生成文件约束、例外读取与扫描范围互相引用 |