用途
codesight 用于为 AI 编程助手生成项目上下文，避免 AI 在每次对话中花费大量 token 去探索代码库结构。它通过静态扫描代码，提取路由、数据库模型、组件、依赖图和环境变量等信息，输出为结构化 markdown 文件，供 AI 一次性读取。
主要能力
- 多语言与框架支持：支持 TypeScript、JavaScript、Python、Go、Ruby、Elixir、Java、Kotlin、Rust、PHP、Dart、Swift、C# 以及 Roku 的 BrightScript/BrighterScript。内置 30+ 框架检测器、14 个 ORM 解析器。
- AST 精度：当项目中安装了 TypeScript 时，自动使用 TypeScript 编译器 API 进行结构化解析；其他语言使用正则检测。
- 路由提取：识别路由方法、URL 参数、所涉及的功能（认证、数据库、缓存、支付、AI、邮件、队列）以及处理器位置。
- Schema 解析：从 ORM 定义中解析模型、字段、类型、主键、外键、唯一约束和关系。
- 依赖图与影响范围：找出被导入最多的文件，并通过 BFS 遍历 import 图计算修改某文件时受影响的文件、路由、模型和中间件（blast radius）。
- 环境变量审计：列出代码库中所有环境变量，标注是否必需或有无默认值，并指出引用文件。
- Wiki 知识库（v1.6.2）：生成 .codesight/wiki/ 持久化知识库，由 AST 编译而非 LLM，零 API 调用，约 200ms 完成。支持 --watch 自动更新和 --hook 在每次提交时重新生成。
- Knowledge Mode（v1.9.3）：--mode knowledge 可映射决策记录、会议笔记、ADR、回顾文档等，自动检测 Obsidian vault、Notion 导出、ADR 工具和任意 markdown 文件夹，输出 .codesight/KNOWLEDGE.md。
- MCP 服务器：提供 14 个 MCP 工具，Claude Code 和 Cursor 可直接调用按需获取项目上下文，含会话缓存。
- 内置插件：三个第一方插件在每次扫描时运行，扫描 .github/、.husky/、.claude/ 等点文件目录；Terraform 插件为选择性启用。
- AI 配置文件生成：为各主流 AI 编程工具生成预填项目栈、架构、高影响文件和环境变量的指令文件。
- 交互式 HTML 仪表盘：展示路由表、Schema 卡片、依赖热点、环境变量审计和 token 节省明细。
- CI 集成、Watch 模式、Git Hook：可在 CI 管道中保持上下文最新，watch 模式在源码或配置文件变化时自动重新扫描，git hook 在每次提交时重新生成上下文。
- 原生 AST WASM 插件（可选）：通过 --native-ast 启用 WebAssembly 插件，为非 TypeScript 文件提供完整 AST 精度；插件非内置，需从 GitHub release 下载放入 ~/.codesight/plugins/ 或指定 --plugin-dir。
使用方式
在任意项目根目录运行一次 npx 命令即可，无需配置、无需 API 密钥。具体安装与运行命令官方资料中未提供完整指令，暂未提供。支持 npm、yarn、pnpm（含 strict 模式）。可通过 --watch 保持 wiki 更新，--hook 在提交时重新生成，--mode knowledge 处理知识文档，--native-ast 启用 WASM 插件。
适用场景
- 使用 Claude Code、Cursor、GitHub Copilot、OpenAI Codex、Windsurf、Cline、Aider 等 AI 编程工具的开发者，希望减少每次对话的 token 消耗。
- 需要快速理解大型代码库的项目 onboarding。
- 在 CI 中自动维护项目上下文。
- Roku 频道开发（含单频道、多频道 monorepo 布局）。
限制
- 静态分析无法解析请求处理器内动态的 url.match(/pattern/) 模式，可能漏检部分路由。
- 非 TypeScript 项目或未提供 AST 支持的框架使用正则检测，精度低于 AST。
- 原生 AST WASM 插件需额外下载和配置，且需自行承担校验和验证。
- 具体支持的全部框架和 ORM 列表、MCP 工具的完整清单、各 AI 工具 profile 的详细内容，官方资料中未逐项列出，暂未提供。
- 收费、价格、平台等信息未提供。
