前言¶
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 仓库。
