前言¶
DeepSeek Harness (DSH) 通過插件機制提供了擴展能力，但默認體驗較爲基礎。moqi 作爲一個終端應用被打包爲 dsh 配置文件，解決了在終端環境中理解工具調用上下文、保持對話連續性以及管理多任務的問題。
是什麼¶
moqi 是一個爲 DeepSeek Harness 設計的終端用戶界面（TUI）。它由 JWE24-code 維護，旨在提供一種沉浸式的終端交互方式，無需離開命令行即可處理對話歷史、工具調用和系統狀態。
核心功能¶
- 工具調用內聯渲染：工具調用顯示在文本流中，摺疊爲單行，帶有 spinner 和狀態。按下
ctrl+o可展開查看詳情。 - 審批記憶：通過
/permissions管理。支持會話內或永久（項目或全局）授權規則。例如，bash(git log *)會自動回答匹配的調用。 - 跨會話記憶：通過
/memory訪問。# note將行保存到列表中而不發送它。/memory off關閉記憶功能。 - Git 分支管理：支持
/worktree和在moqi/分支上工作。支持清理未使用的分支。 - 會話模式：通過
shift+tab切換隻讀、工作區寫入或計劃模式。 - 運行中回覆控制：使用
ctrl+c、shift+tab等鍵 steering、queueing 或 interrupting 正在進行的回覆。 - 多會話：支持標籤頁，跨設備 SSH 會話，以及背景會話完成時的提示。
- 使用情況統計：通過
/usage查看提供商的計費限制和 token 使用情況（滾動 5 小時和 7 天窗口）。 - OAuth 登錄：通過本地 OAuth 流程登錄 Claude Pro/Max、ChatGPT/Codex 等提供商。
- 本地語音聽寫：集成 whisper.cpp。使用
ctrl+v進行 push-to-talk；語音數據保留在本地。 - 對話重放與分叉：在任意歷史提示處分支對話。
- 可擴展接口：通過
ctx.tuiHost提供插件接口以註冊快捷鍵、狀態行和命令面板。
安裝與啓用¶
需要滿足先決條件：
1. 在 PATH 中安裝了 dsh（npm install -g @deepseek-ai/dsh）。
2. Node.js 22 或更高版本。
安裝 moqi：
npm install -g moqi-tui
啓動終端：
moqi
典型用法¶
- 查看日誌：
docker logs --tail 50 -f webui
- 管理記憶：
- 打開列表：
/memory - 關閉記憶：
/memory off - 保存備註：在文本中添加
# note
- 打開列表：
- Git 工作樹：
- 創建新工作樹：
/worktree
- 創建新工作樹：
- 控制回覆：
- 查看工具調用詳情：
ctrl+o - 切換會話模式：
shift+tab - 停止當前回覆：
ctrl+c
- 查看工具調用詳情：
- 查看使用情況：
/usage
- 管理權限：
/permissions
適用場景與注意¶
適合需要與 DSH 進行深度交互並管理複雜上下文（Git、日誌、多會話）的開發人員。該插件以當前 dsh 進程的權限運行。安裝前應檢查源代碼和許可證（MIT）。
結語¶
moqi 將 DSH 體驗提升到原生終端應用級別，提供了上下文感知的工具調用、記憶管理和會話控制。更多信息請訪問插件目錄或GitHub 倉庫。
