pi-codegraph-fix

能正常工作的 CodeGraph pi 插件。

English

---

特性

• 跨项目不失效 — 用 ctx.cwd 而非 process.cwd()，切项目不丢 codegraph 工具
• 零僵尸进程 — 会话关闭/进程退出/终止信号三路清理，不留后患
• 懒加载启动 — 首次调用工具时才启动 codegraph 进程，不拖慢会话启动
• 多项目支持 — 每个项目独立 MCP 连接，跨项目会话自动切换
• 智能提示注入 — 工具就绪后才注入使用说明，无索引不误导

快速安装

pi install npm:pi-codegraph-fix

需要 CodeGraph CLI（npm install -g @colbymchenry/codegraph）和项目索引（codegraph init）。

---

它解决了什么

1. 切换项目后 codegraph 工具就消失了

你用 pi session=<其他项目> 或者从 ~ 目录启动 pi，codegraph 工具就没了。没有报错，就是不存在。

原因： 原版用 process.cwd() 找 .codegraph/codegraph.db。这个路径永远指向 pi 第一次启动的目录，而不是你当前 session 的项目目录。找错目录 → 找不到 DB → 工具消失 → 静默失败。

2. 僵尸进程越堆越多

每次关闭 pi，codegraph serve --mcp 子进程都不会自己死掉。几次 session 下来就堆了十几个，互相抢 socket 锁——每次调用 codegraph 工具都可能弹 "server disconnected"。

真实案例：12 个僵尸进程，跨越 6 个 session，累积 9 小时以上。每次 codegraph 调用都在赌运气看哪个僵尸抢到了锁。

---

怎么修的

相比原版（codegraph-pi、pi-codegraph），改了两处：

ctx.cwd 替代 process.cwd() — 从 pi 获取当前 session 的工作目录，不管你怎么启动、在哪启动都能找到正确项目。

三路径清理 — 正常退出、进程崩溃、终端关闭都会杀掉 MCP 子进程：

路径	触发时机
session_shutdown	pi 正常退出
process.once("exit")	Node 进程结束
SIGTERM / SIGHUP	终端关闭、被 kill

没有僵尸，没有断连报错。

---

特性一览

特性	来源
ctx.cwd 替代 process.cwd()	pi-codegraph-fix
spawn 指定 cwd	pi-codegraph-fix
多项目 MCP 客户端（每项目独立连接）	SeanPedersen/pi-codegraph
动态工具发现（MCP 协议）	SeanPedersen/pi-codegraph
进程退出/终止信号时自动清理	SeanPedersen/pi-codegraph
单一文件，无外部依赖	SeanPedersen/pi-codegraph
智能注入 system prompt	colbymchenry/codegraph-pi
检查 codegraph DB 是否存在后才启动	colbymchenry/codegraph-pi

工作原理

1. 会话启动时检查当前项目是否存在 codegraph 索引（仅一次文件检查）
2. 首次调用 codegraph 工具时后台启动 codegraph serve --mcp（懒加载，不阻塞）
3. 工具就绪后动态注册为 pi 原生工具
4. 注册完成后注入使用说明到系统提示
5. 会话关闭或进程退出时清理所有 MCP 客户端

致谢

• colbymchenry/codegraph-pi — 原始 pi 扩展
• SeanPedersen/pi-codegraph — 多客户端架构