前言¶
DeepSeek Harness (DSH) 允許開發者構建智能體，但其默認輸出以日誌流的形式呈現，缺乏交互性。開發者需要一個在終端中直接與智能體交互、處理審批和問題的界面。Talon UI 是一個 DSH 插件，它提供了一個全交互式的終端會話，將流式轉錄、工具審批、用戶問題和斜槓命令集成在終端中。
是什麼¶
Talon 是一個終端 UI 插件，專爲 DeepSeek Harness (dsh) 智能體設計。它將原本的日誌流轉化爲一個交互式終端會話，讓開發者能夠實時查看流式輸出、審批工具執行、回答用戶問題以及管理會話。該插件由 awnlight 維護，採用 MIT 許可證。
核心功能¶
Talon UI 提供了以下核心能力：
- 啓動橫幅：會話打開時顯示版本、活動模型和工作目錄，作爲可滾動的轉錄單元格。
- 流式轉錄：顯示帶有純文本和流式 markdown 的角色標題，支持拖拽選擇複製。包含上下文注入卡片和空白行分隔。
- 語氣層級：使用品牌青色區分模型，使用 dim 值區分引用值，避免單調的灰色牆。
- 審批面板：當工具請求升級權限（例如沙箱拒絕寫入）時，顯示工具詳情、命令預覽和當前目錄，支持
1允許、2拒絕、Esc取消。 - 用戶問題：支持單選、多選、自定義回答和序列問題，通過
ask_user_question工具實現。 - 斜槓命令：支持
/help、/status、/resume、/clear、/exit、/quit，具有模糊自動補全功能。 - 會話恢復：使用
/resume打開選擇器，支持過濾、切換工作區、ISO 時間戳和持久化標記，重播轉錄並繼續對話。 - 乾淨退出：使用
/exit或在空輸入時按Ctrl+C/Ctrl+D退出，並打印會話 ID 以便恢復。
安裝¶
在安裝之前，必須確保 deepseek-harness 已構建。
cd deepseek-harness
pnpm install
pnpm run build:lib:host
構建完成後，安裝插件：
cd deepseek-harness
pnpm dsh plugin --profile talon add talon-ui
用法示例¶
- 解釋功能：輸入 “Explain what this repository does.”，查看流式轉錄。
- 處理多選問題：輸入 “Use ask_user_question to ask me a multi-select question with options Alpha, Bravo, Charlie.”
- 工具審批：輸入 “Run exactly: touch ~/talon-demo”。如果沙箱拒絕寫入，會觸發審批面板。
- 會話恢復：輸入
/exit退出會話，重新啓動 dsh 後輸入/resume並選擇會話。即使工作目錄已更改，轉錄也會重播，智能體會繼續之前的對話。
注意事項¶
- 環境要求：需要 Node.js >= 22.19 和 pnpm。
- 目錄結構：
deepseek-harness必須作爲talon-ui倉庫的兄弟目錄存在。 - 終端類型：需要交互式終端（TTY）。Talon 在非 TTY 環境下會報錯；自動化場景請使用
dsh --profile headless。 - 版本兼容：
talon-ui@0.2.0已針對dsh 0.1.2-alpha.1進行驗證。
總結¶
Talon UI 將 DSH 智能體從單向日誌流轉變爲全交互的終端體驗，解決了在命令行中管理複雜會話的痛點。欲瞭解更多細節，請訪問插件目錄或GitHub 倉庫。
