MIT 协议的 Go 终端编码 agent：精准 hashline 编辑、隔离的子 agent、权限闸门，以及低 token 消耗的 MCP。与 DeepSeek 模型搭配良好；约 12 MB，无需 Node/Python 运行时。
DSH 适配
生态相关
作者声明
安全审计
未审计
最后核验
2026-08-24
许可证
MIT
01它能帮你完成什么？
在终端里跑一个编码 agent：用 hashline 锚点改文件、并派发隔离的子 agent
由 TUI 驱动的 agent 循环，配合精准编辑、~/.phi/session 下的持久化会话，以及把子 agent 任务摘要回传给父上下文
想要轻量、便宜、本地优先的终端编码 agent 的开发者，可搭配任意 OpenAI 兼容或 Anthropic 模型
在 CI 或基准测试里无头驱动编码任务
不带 TUI 的单次 agent 循环，向 stdout 输出 JSONL 事件（--jsonl），并给出明确的退出码（0/1/2/3）
在流水线里自动化编码任务的团队，需要机器可读的输出和严格的权限闸门
02如何接入 DeepSeek Harness？
前置条件
- 准备一个 OpenAI 兼容或 Anthropic 端点的模型 API key（设置 PHI_API_KEY / PHI_MODEL / PHI_BASE_URL，或运行 `phi config`）
- 源码编译需要 Go 1.26.3+（见 go.mod）
安装步骤
- 01
macOS / Linux —— 安装最新版：`curl -fsSL https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.sh | bash`
$ curl -fsSL https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.sh | bash
- 02
Windows（PowerShell 5.1+）：`irm https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.ps1 | iex`
- 03
或从源码编译：`make build`（生成 ./phi），再 `make install`（装到 $GOBIN）
验证接入成功
- 不安装地查询最新版本：`phi update --check`
- 检查已配置的 MCP 服务：`phi mcp doctor`
03DSH 适配与能力边界
终端编码 agent 工具，与 DeepSeek 模型配合良好（用 PHI_MODEL / PHI_API_KEY / PHI_BASE_URL 环境变量，官方推荐 DeepSeek Flash）；并非 dsh 原生运行时绑定
Hashline 编辑
整文件 `@file path#TAG` 加上行 `LINE#HASH` 锚点→精准编辑；过期的 tag/hash 会被拒绝，杜绝过度编辑与静默损坏
写入磁盘上的文件，受权限策略约束（workspace_only_writes 默认 true）子 agent
agent_spawn 指定角色（explore | review | worker）→隔离的任务；只把简短的 wait/任务摘要回传给父上下文
子 agent 的完整记录存于 ~/.phi/jobs/<id>/，不会注入父上下文权限闸门
模式 interactive | readonly | autopilot | headless-strict；按工具设置 bash.allow / bash.deny 规则→在破坏性工具触发前 Gate / Ask；无头 `phi run` 把 ask 折叠为 deny
可拒绝或放行 shell 命令；dangerously_allow_all 默认为 false不撑爆上下文的 MCP
配置任意数量的 MCP 服务；元工具 mcp_list / mcp_inspect / mcp_call→服务工具 schema 永不进入模型提示词——只列出服务名；首次使用时才惰性启动子进程
会拉起 MCP 子进程；调用仍走 PreHooks → Gate / Ask → Run → PostHooks
04适合谁？何时不该用？
适合
- 想要轻量、便宜、本地优先的终端编码 agent 的开发者，可搭配任意 OpenAI 兼容或 Anthropic 模型
- 在流水线里自动化编码任务的团队，需要机器可读的输出和严格的权限闸门
不适合
- phi 会读写你的工作目录：`write`/`edit` 受权限策略约束，workspace_only_writes 默认为 true。用 readonly / headless-strict 模式可拒绝写入。
05兼容性、维护与安全提示
- 源码编译需要 Go 1.26.3 或更新（见 go.mod）；安装脚本拉取的是预编译版本，因此二进制安装不需要本地 Go。
- phi 需要联网以通过 base_url 访问模型服务商（OpenAI 兼容或 Anthropic）；首次缺少时还会在后台把搜索工具 `fd`/`rg` 下载到 ~/.phi/bin。
- phi 会读写你的工作目录：`write`/`edit` 受权限策略约束，workspace_only_writes 默认为 true。用 readonly / headless-strict 模式可拒绝写入。
MIT · 活跃维护中（最新发布 v0.16.0，2026-08-22）
06常见问题
怎么安装 phi 并接入 DeepSeek 模型？
macOS/Linux 运行 `curl -fsSL https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.sh | bash`；Windows 运行 PowerShell 安装脚本。然后设置 `PHI_MODEL`/`PHI_API_KEY`（例如某个 DeepSeek 端点）或运行 `phi config` 写入 ~/.phi/config.yaml。按 README 推荐，DeepSeek Flash 是首选模型。
phi 的编辑比普通 agent 整体重写安全在哪？
phi 使用 hashline 编辑：模型指向整文件 `@file path#TAG` 锚点加上 `LINE#HASH` 行锚点，而不是整体重写文件。过期的 tag/hash 会被拒绝，从而在落地前就阻止过度编辑和静默文件损坏。
子 agent 怎么避免撑爆父上下文？
子 agent 工具（agent_spawn、agent_wait 等）默认开启。它们的完整记录存在 `~/.phi/jobs/<id>/`，永不注入父上下文——只会把一条简短的 wait/任务摘要回传给父 agent。
phi 怎么防止 MCP 吃掉上下文窗口？
phi 在系统提示词里只列出已配置的 MCP 服务名，并给 agent 三个元工具（mcp_list / mcp_inspect / mcp_call）。工具 schema 永不进入提示词，服务子进程在首次使用时才惰性启动，所以在真正调用工具前几乎不消耗 schema token。
能在 CI 里无人值守跑 phi 吗？权限怎么表现？
可以——`phi run -p "…"` 无头跑单次 agent 循环，向 stdout 输出 JSONL，退出码 0/1/2/3。无头模式下 ask 决策会被拒绝（headless-strict 安全策略），因此表现为 readonly 风格；只有基准测试/CI 需要任意 shell 时才加 `--yolo`。
07相关的 DSH 工作流
deepseek-reasonix
作者 esengine
专为 DeepSeek 打造的终端 AI 编程智能体，围绕前缀缓存稳定性设计，可常驻运行。
mnemon
作者 mnemon-dev
LLM 监督的持久记忆系统，基于图结构召回、跨会话知识共享，单个二进制文件，兼容 DeepSeek Harness 等运行时。
sivtr
作者 ariestar
A unified agent memory workspace for human and agent | 一个统一的agent记忆工作空间
caliper
作者 edonadei
轻量评估工具，追踪 Claude Code、Codex、Pi 等智能体上技能的成功率，验证技能是否真正有效。
08数据与来源
phi + DeepSeek Flash — the best pairing: grounded, low hallucination, cache hit rates near 100%.
export PHI_MODEL=gpt-4o export PHI_API_KEY=sk-...
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-24。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。