在 DeepSeek Harness (DSH) 中開發智能體時,管理 JevLoop 服務網關狀態及 API 密鑰通常需要直接操作服務或配置文件。moqi-jev-loop 提供了一個基於 TUI 的控制面板,使這些操作可以在 moqi 的圖形界面內完成。
插件定位¶
這是一個位於 dsh-jev-loop 服務之上的薄適配器。它利用 moqi 的 tuiHost 裝縫,將 jevLoop 服務的狀態呈現爲行和操作,而無需修改 moqi 核心代碼。
核心功能¶
該插件註冊了一個 tuiHost 面板,在 moqi 的命令面板中註冊爲 /JevLoop。面板顯示以下內容:
- API 密鑰狀態:列出 API 密鑰的來源(
config、credential:file、env:TYPESAFE_APIKEY),但不會顯示密鑰的實際值。 - 網關狀態:顯示四個網關的實時狀態。
- 交互:按下
enter鍵即可切換網關狀態,更改立即生效。
密鑰解析遵循特定順序:顯式 apiKey 配置 > Harness 憑據存儲 > 環境變量(TYPESAFE_API_KEY 或 TYPESAFE_APIKEY)。
安裝與啓用¶
安裝需要兩個插件:核心服務插件和此適配器插件。
dsh plugin --profile <profile> add dsh-jev-loop
dsh plugin --profile <profile> add moqi-jev-loop
安裝後,確保 moqi 正在運行,/JevLoop 將出現在命令面板中。
典型用法¶
- 啓動 Harness,通過
TYPESAFE_APIKEY=… dsh --profile <profile>設置環境變量,或通過配置文件設置。 - 啓動 moqi。
- 在 moqi 中調用
/JevLoop。 - 使用
enter鍵切換網關。 - 更改會立即寫入 Harness 憑據存儲(
ctx.credentials),並持久化到$DSH_HOME/jev-loop.(具體格式取決於實現,但存儲路徑已固定)。
注意事項¶
- 依賴關係:該插件判斷不自身邏輯,僅在兩個服務都存在時應用。
- 安全性:輸入 API 密鑰時,草稿文本永遠不會被渲染,也不會觸及編輯器、記錄器或 shell 歷史記錄。
- 許可證:MIT 許可證。
總結¶
moqi-jev-loop 通過 moqi TUI 提供了 JevLoop 網關和 API 密鑰的即時可視化管理。它是一個輕量級插件,適合希望在保持 DSH 進程上下文的同時直接控制服務流量的開發者。
- 作者:JWE24-code
- 目錄:moqi-jev-loop - SkillHub
- 源碼:moqi-jev-loop - GitHub