使用
macOS arm64
需要先準備
- 執行環境:
python>=3.10
透過 uv tool install git+https://github.com/d3layd/agent-history 安裝
uv tool install git+https://github.com/d3layd/agent-history
確認能用
agent-history --version 2>&1; echo ---; agent-history --help 2>&1輸出應包含「agent-history 0.16.0」。
先試試這個
agent-history inject status 2>&1; echo "---TOGGLE---"; agent-history inject toggle 2>&1; agent-history inject status 2>&1; agent-history inject toggle 2>&1執行 agent-history inject status 查看是否已開啟過往工作階段注入。
Linux x86_64
需要先準備
- 執行環境:
python>=3.10
透過 uv tool install git+https://github.com/d3layd/agent-history 安裝
uv tool install git+https://github.com/d3layd/agent-history
確認能用
agent-history inject --help 2>&1
agent-history inject status 2>&1; echo ---; agent-history inject off 2>&1; agent-history inject on 2>&1輸出應包含「inject: on」。
執行 agent-history inject status 查看是否已開啟過往工作階段注入。
Windows x86_64
需要先準備
- 執行環境:
python>=3.10
透過 uv tool 從 git 安裝 agent-history
uv tool install git+https://github.com/d3layd/agent-history
確認能用
agent-history --version輸出應包含「agent-history 0.16.0」。
先試試這個
New-Item -ItemType Directory -Force -Path docs-sample | Out-Null && Set-Content -Path docs-sample/runbook.md -Value "# Gateway Restart Runbook`nTo restart the gateway, run restart script and check auth middleware split reason.`nThe session refresh needs to run before auth check.`n" && Get-Content docs-sample/runbook.mdagent-history docs add ./docs-sampleagent-history sources執行 agent-history inject status 查看是否已開啟過往工作階段注入。
它能做什麼
- 依語意搜尋過往代理對話紀錄未測試
- 結合語意搜尋與全文搜尋未測試
- 檢視搜尋結果前後的對話未測試
- 將相關的過往工作階段加入提示沒有看到它可用
pickfit 測到哪一步
macOS arm64
- 可以安裝
- 可以啟動
- 4 項功能中 0 項可用
- 可離線使用
Linux x86_64
- 可以安裝
- 可以啟動
- 4 項功能中 0 項可用
- 可離線使用
Windows x86_64
- 可以安裝
- 可以啟動
- 主要功能可用
- 可離線使用
其他系統
適合用來
- 依語意搜尋過往 agent 討論內容
- 顯示搜尋結果周圍的對話
- 透過本機網頁檢視器瀏覽搜尋
- 為文件樹建立搜尋索引
- 向量與全文混合搜尋
可替代 claude-mem。
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
macOS arm64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月1日
- 版本 0.16.0
測試機器遇到的差異
- README: agent-history index works with Ollama HTTP endpoint, --mode text needs no Ollama
測試中: 即使是純文字文件內容,index 也需要 Ollama;必須在 11434 上執行假的 Ollama 伺服器回傳 768 維測試嵌入,建立索引後 search/show 才能運作 - README: prerequisites python>=3.10
測試中: Homebrew python 3.15.2 可正常運作(sqlite 擴充可載入),因此不需鎖定 3.10
Linux x86_64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月31日
- 版本 0.16.0
測試機器遇到的差異
- README: agent-history index embeds everything; search --mode text needs no Ollama
測試中: index 一律需要 Ollama 嵌入端點(/api/embeddings 與 /api/tags);此沙箱在 127.0.0.1:11434 啟動了回傳固定 16 維嵌入的假 Ollama 伺服器以便建立索引,之後 --mode text 搜尋可在無向量下運作 - README: uv tool install git+https://github.com/d3layd/agent-history
測試中: 已驗證先決條件 python>=3.10 與 sqlite-vec 可載入擴充;doctor 回報在此 Python 3.12 上 sqlite-vec: loadable
Windows x86_64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月31日
- 版本 0.16.0
測試機器遇到的差異
- README: README says `--mode text` (BM25 full-text) works without Ollama and hybrid degrades gracefully
測試中: Ollama 未執行時,`agent-history index` 會以 `error: cannot reach Ollama at http://localhost:11434` 拒絕,因此無法建立索引;沒有 Ollama 與嵌入模型時,即使使用 --mode text,`agent-history search "query"` 也無法執行(exit 1,`error: no index ... Run: agent-history index`) - README: README lists `agent-history doctor` to diagnose installation without documenting exit code
測試中: `agent-history doctor` 以 exit 1 結束,但仍印出完整診斷(data home、ollama up: NO、sqlite-vec: loadable、adapter/index 狀態);exit 1 代表發現問題,而非當機 - README: (Windows steps)
測試中: pickfit 以一般使用者身分在 PowerShell 7(pwsh 7.6.9)中執行這些步驟;內建的 Windows PowerShell 5.1 未經驗證,且不支援 `&&`。