核心用法
CodeGraph Assistant 是 npm 工具 codegraph 的自动化封装层，专为 DeepSeek TUI 编程场景设计。它通过 Python 脚本将原本需要多步手动执行的命令（init → index → query）压缩为单一操作，显著降低使用门槛。
主要命令：
setup [path]— 一键初始化并索引项目ask "问题描述"— 将自然语言问题转换为结构化查询上下文query "类名/符号"— 搜索代码库中的符号定义与引用affected file.py— 分析文件修改的级联影响范围inject [path]— 将项目摘要自动写入 MEMORY.md，供 AI 长期记忆status [path]— 查看索引统计信息
显著优点
1. 工作流压缩：将 3-5 步 manual CLI 操作简化为单条命令，特别适合 TUI 交互场景
2. 零依赖设计：仅使用 Python 标准库（argparse/json/os/subprocess/pathlib），无第三方包风险
3. 上下文自动化：ask 命令自动生成 Markdown 格式的任务上下文，含入口点、调用链、相关符号，可直接投喂给 LLM
4. 影响分析前置：affected 命令在重构前预判变更范围，降低回归风险
5. 记忆持久化：inject 实现项目结构向 MEMORY.md 的自动注入，支持跨会话代码理解
潜在局限
1. 外部工具强依赖：核心功能完全依赖全局安装的 @colbymchenry/codegraph，该 npm 包的安全性与版本兼容性不受本 skill 控制
2. 文件操作风险：inject 命令直接覆盖 MEMORY.md 的 CodeGraph 摘要部分，无自动备份机制
3. 错误处理较简：子进程 stderr 未充分捕获，复杂场景下的故障诊断信息有限
4. 输入验证基础：参数仅经过简单 slug 转换，特殊字符可能引发意外行为
5. 社区维护级别：T3 来源可信度，个人开发者维护，长期更新稳定性存疑
适合人群
- 使用 DeepSeek TUI 进行日常开发的工程师
- 需要快速理解陌生代码库（onboarding）的开发者
- 进行大规模重构前需评估影响范围的 Tech Lead
- 希望将项目结构纳入 AI 长期记忆的 Prompt 工程师
常规风险
| 风险类别 | 说明 | 缓释建议 |
|---------|------|---------|
| 供应链风险 | 依赖外部 npm 包 | 锁定 codegraph 版本，定期审计 |
| 数据覆盖风险 | inject 无备份机制 | 手动备份 MEMORY.md 或使用版本控制 |
| 子进程风险 | 调用本地 codegraph CLI | 确保运行环境可信，避免 PATH 污染 |
| 隐私风险 | 项目信息写入 MEMORY.md | 确认无敏感代码后再执行 inject |