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 個值得優先安裝的外掛，涵蓋各個分類。