Codegraph Assistant

一键代码图谱助手 — 包装 npm codegraph，自动初始化/索引/注入上下文。让 DeepSeek TUI 编程时一句话拿到项目结构、符号索引、影响分析。

npm codegraph 的加速包装器。不需要手动 codegraph init -i → query 三步走。

解决的问题

无此技能	有此技能
手动 codegraph init -i 每项目	setup 一键完成
codegraph context "fix bug" 怕输错格式	ask "你的问题" 自动组命令
不知道改了影响哪些测试	affected file.py 直接出结果
不会注入到 memory	inject 写入 MEMORY.md

命令

python codegraph_assist.py setup [path]     # init + index 项目
python codegraph_assist.py ask "问题描述"    # 生成任务上下文 (markdown)
python codegraph_assist.py query "类名"     # 搜索符号
python codegraph_assist.py affected file.py # 改动影响分析
python codegraph_assist.py inject [path]    # 注入摘要到 MEMORY.md
python codegraph_assist.py status [path]    # 索引统计

依赖

• npm codegraph（@colbymchenry/codegraph）已全局安装
• Python 3.11+

典型工作流

# 新项目
cd myproject
codegraph-assistant setup     # 30s，一次性

# 编程时
codegraph-assistant ask "重构数据库连接层"
# → 输出 markdown 上下文，含入口点、相关符号、调用链

集成

DeepSeek TUI 可通过 exec_shell 直接调用：

> codegraph_assist.py query "ClassName" -j    # 拿 JSON 结果
> codegraph_assist.py affected src/file.py     # 改动前检查