文件快速扫描 - 减少token消耗
v0.1.1文件快速扫描，减少token消耗。AI 无需读取文件就能知道内容，避免重复读取浪费 token。
by 运行时依赖
安装命令
点击复制技能文档
项目解剖技能（Project Anatomy Skill）受 OpenWolf 启发。生成一个紧凑的文件索引，以便 AI 决定是否打开文件而不必读取它。
命令：
完整扫描：python3 /scripts/anatomy_scan.py [options]
选项：
--format compact|table|summary（默认：compact）
--incremental / -i — 重用缓存的描述以减少对未更改文件的扫描
--max-depth N — 限制目录遍历深度
--exclude pattern [...] — 额外排除模式
--output path — 自定义输出路径（默认：/.anatomy.md）
自动注入（用于会话启动）：
python3 /scripts/anatomy_inject.py [--max-age-hours 24] [--quiet]
检查新鲜度，如果过时（>24小时），则重新扫描并输出解剖内容。
输出格式：
compact（默认，体积最小）：
+ src/index.ts（~180t）— 主入口点
+ src/server.ts（~520t）— Express HTTP 服务器
summary（按目录分组）：
+ ## src/（5 个文件，~2,400t）
- index.ts（~180t）— 主入口点
- server.ts（~520t）— Express HTTP 服务器
table（最详细）：
| 文件 | 令牌 | 描述 | 修改时间 |
|------|--------|-------------|----------|
| src/index.ts | ~180 | 主入口点 | 2026-05-12 |
配置：
可选的 .anatomy.yaml 文件在项目根目录中：
exclude:
- my_custom_dir
- "*.generated.ts"
max_depth: 5
max_file_size_kb: 500
description_max_chars: 120
使用方法：
扫描您的项目：python3 .../anatomy_scan.py /path/to/project
在读取文件之前，请先检查 .anatomy.md 文件
仅当一行描述不足时才打开文件
定期重新扫描或使用 --incremental 选项以获得快速更新
令牌节省： 在真实目录中测试： 47 个文件：索引 ~1,058t vs 所有文件 ~29,533t → 96% 节省 最适合您反复访问的项目。