在 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