my-pi 是一个面向编码智能体的本地优先 MCP 运行时，通过官方 Model Context Protocol（MCP）暴露能力。它让具备 MCP 能力的编码智能体以受控方式访问真实工作区，而不必获得通用 shell 权限，也不会静默授予当前工作目录。
主要能力：
- 本地优先：源代码与详细工作区状态保留在主机本地。
- 默认只读：写入与语言服务器进程启动需要显式的受信任提升（trusted elevation）。
- 更安全的变更：写入可要求 SHA-256 内容前置条件，替代盲目覆盖语义。
- 代码感知搜索：基于 Tree-Sitter 的结构化搜索，覆盖 TypeScript、JavaScript、Python、Rust 和 Go。
- 语义导航：在受支持的主机语言服务器上提供 LSP 符号、定义、引用、悬停与诊断。
- Git 感知上下文：有界的状态与差异操作，带密钥过滤与大差异溢出处理。
- 无次级付费 LLM 依赖：核心运行时在本地执行，不选择模型、不派生代理。
使用方式： 需要 Node.js >= 24.0.0（Node 24 LTS 为规范运行时）。服务器以只读方式启动。对于显式信任的工作区，可通过 npm 安装并配置宿主。未提供 --workspace 或 MY_PI_WORKSPACE_ROOT 时启动会失败关闭（fail closed）；仅当有意授予当前目录时才使用 --allow-cwd。已发布的 npm 包是稳定的 MCP 服务器；协调守护进程与本地 UI 属于私有工作区包，用于实验性源码构建，使用前需先构建仓库。可通过命令行生成宿主专用配置片段，也可在不进行全局安装的情况下检查宿主配置。
MCP 能力面： 稳定的公开声明是 13 个工具的 MCP 能力面。仓库还包含两个可选候选，且不会改变默认模式：Production Next（协调、代码状态、变更回执、评估与反馈功能，受其晋升门控约束）和 Visual Plane（对权威本地状态的只读图/剧场投影，以及变更来源与本地准入路径）。
从源码构建： 开发前置条件为 Node.js v24.0.0+（Node 24 LTS 为规范，CI 中验证精确最低 24.0.0），Rust stable 为可选，目前仅与延后的原生后端脚手架相关。CI 矩阵覆盖 Ubuntu、Windows 和 macOS。
工程契约与自托管轨道： 仓库包含针对 MCP stdio 开销、搜索/遍历吞吐、内存采样、运行时边界、协调行为、影响路由、评估反馈与本地可靠性的确定性合成基准。基准输出属于候选证据，性能声明需结合其资格标准与运行器差异解读。自托管计划将实现、测量与晋升作为独立决策，包含 Track A（证据框架）、Track B（强制执行）、Track C（可视化平面）。evidence/ 下的证据文件是候选绑定记录，不是发布或晋升声明；只读晋升验证器为权威依据，除非最终命令报告 promotionEligible: true，否则应保留 PN11 不通过。
实验功能：
- Production Next：可启动本地协调候选，仅在需要评估平面时添加 --evaluation。候选保持源代码与详细代码状态本地，不选择模型、不派生代理，也不要求托管控制平面。
- Visual Plane：可选的只读可视化面，将权威本地状态渲染为有界图，是协调图快照与事件日志的投影，而非 LLM 生成的图，且从不修改源状态。Agent Operations Theater 渲染 Three.js 等距工作图（代理、工作项、意图、依赖），带实时事件提示、回放时间线、证据/追踪/来源检查器，并在 WebGL 不可用时自动回退为 2D SVG。诚实地暴露 degraded、truncated、stale、empty 等数据状态；未知事件类型不驱动动画；自由文本值中嵌入的敏感路径在每次线路出口处被脱敏。门户仅绑定回环地址，并要求每次启动的会话令牌，V1 中为只读。默认 MCP 目录仍恰好为 13 个工具。
- 变更来源与本地准入：观察模式针对已验证的 my-pi 变更回执，将观察到的代码状态转换分类为 managed、unmanaged、stale_lineage、unknown 或 exempt；外部编辑绝不会因观察最终字节而变为 managed。本地准入将 Git 变更集与已验证谱系比较，返回路径级 allowed / rejected / review_required 结果。可移植证明：规范的跨平台准入主体摘要可用 Ed25519 签名（私钥存储在工作区之外），并可在 CI 中验证而无需本地 SQLite 状态。宿主策略包声明各宿主的强制执行成熟度（strict-capable / managed / monitoring），未经植入绕过证据的配置永远不会被标记为 strict-certified。
适用场景与限制： 适合希望智能体编码工具理解并修改代码、但不愿交出通用 shell 或静默授权当前工作目录的开发者，适用于评估与受控的本地开发。当前发布通道为 Alpha；使用受信任模式前应阅读 docs/SECURITY_MODEL.md，搜索忽略行为见 docs/SEARCH_IGNORE.md（属遍历优化，不能替代敏感路径策略）。关于收费、价格与平台支持的具体信息，资料中暂未提供。
