Atris

🗺️ 一次扫描,永久导航 — 代码库智能地图

通过持久化代码库地图节省 80-95% 的 token,一次扫描永久复用,终结重复文件遍历。

收藏
6.4k
安装
2k
版本
1.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Atris — Codebase Intelligence 评估

核心用法

Atris 是一种代码库导航基础设施,通过生成并维护 atris/MAP.md 文件,将代码探索从「每次会话重新扫描」转变为「一次索引、永久复用」。其核心机制包括:首次扫描时提取关键符号(函数、类、路由、入口点)并记录精确的文件路径与行号;后续所有查询优先查阅 MAP.md,未命中时才使用 ripgrep 补充并同步更新索引。

显著优点突出:

  • Token 效率:官方声称节省 80-95% 的代码探索 token,对于大型代码库或长会话尤为关键
  • 累积智能:每次发现都沉淀为持久知识,形成组织化的团队资产
  • 双维索引:同时提供「按功能」和「按关注点」两种视图,兼顾业务逻辑与技术横切
  • 精确导航file:line 格式支持直接跳转,消除猜测路径
  • 轻量依赖:仅需 ripgrep,无复杂运行时

潜在局限需正视:

  • 维护成本:代码变动时需「外科手术式」更新,否则索引漂移导致误导;全自动同步机制缺失
  • 初始投入:首次扫描与结构化撰写需要人工判断「重要符号」的取舍标准
  • 语言覆盖:示例偏向 TS/JS/Python,对 Rust/Go/C++ 等语言的符号提取模式可能需要扩展
  • 规模上限:超大型单体仓库的 MAP.md 可能膨胀,检索体验下降

适合人群明确:AI 辅助开发场景下的开发者、频繁切换代码库的工程师、以及需要降低 onboarding 成本的团队技术负责人。常规风险包括索引过期导致的错误定位、敏感信息过滤不彻底(虽明确排除 secrets,但依赖执行者自律)、以及过度依赖 MAP 而放弃理解代码结构的「导航依赖症」。

Atris 内容

手动下载zip · 3.1 kB
skill-card.mdtext/markdown
请选择文件