omdsh

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# omdsh

**为 DeepSeek Harness 带来 OMP 风格、可配置、可远程控制的终端界面。**

独立 TUI profile bundle · 动态深浅主题 · 持久会话 · `/reload` 无感重载 · 微信 iLink 桥

[快速开始](#快速开始) · [功能](#为什么使用它) · [命令](#常用操作) · [配置](#配置) · [开发](#参与开发)

  [图片: @yoke233/omdsh 在 WezTerm 中的欢迎页，展示会话信息、OMP Powerline 状态栏与 DeepSeek 模型状态]

`@yoke233/omdsh` 是 [DeepSeek Harness（dsh）](https://github.com/deepseek-ai/deepseek-harness) 的独立 TUI profile bundle。它负责终端呈现、输入交互、主题、设置与微信桥；agent、模型、工具、会话持久化和沙箱仍由 dsh harness 提供。

> [!IMPORTANT]
> 推荐通过 **`omdsh` 启动器**使用本插件：它自动安装/升级 profile，并作为 `/reload` 的监督进程，让插件更新无需退出终端即可生效。dsh 本身仍处于 developer preview，建议固定宿主版本与插件 release。遇到问题请提交 [Issue](https://github.com/yoke233/omdsh/issues)。

## 为什么使用它

| 能力 | 你会得到什么 |
| --- | --- |
| **OMP 风格界面** | Catppuccin 默认外观、Powerline 状态栏、truecolor 与 Nerd Font 图标 |
| **动态主题** | 98 个 OMP 主题，支持跟随终端明暗、固定主题及逐角色 RGB 覆盖 |
| **完整会话流** | 新建、命名、恢复、切换会话，以及运行中消息 steer |
| **内置控制面板** | 在 TUI 中选择模型、思考等级、agent preset、权限与供应商 |
| **无感重载** | 经 `omdsh` 启动后，`/reload` 原地重启插件运行时并续接当前会话，插件升级与本地代码修改即刻生效 |
| **响应式布局** | 窄终端自动压缩次要信息，优先保留模式、目录、Git 与上下文用量 |
| **微信远程桥** | 通过官方 ClawBot / iLink 通道发送任务、查看进度并接收结果 |

界面支持斜杠命令、路径与参数补全、会话/文件引用、可折叠工具卡、思考块、上下文卡以及审批对话框。`repl` / `run_code` 内部工具通过 dsh 官方 Code Dispatch 事件递归显示；`apply_patch` 与 `edit` 复用标准 diff presentation，不使用 TUI 私有协议。

查看完整帮助面板

  [图片: @yoke233/omdsh 的帮助面板，展示快捷键和斜杠命令]

## 快速开始

### 环境要求

- Node.js `^22.19.0` 或 `>=24.0.0`
- pnpm 11（仓库锁定 `11.7.0`）
- dsh `0.1.1-rc.2`
- 推荐 truecolor 终端；Nerd Font 用于完整图标显示

### 1. 安装（推荐：omdsh）

安装官方 dsh、pnpm 与 `omdsh`（全局安装后命令即在 PATH 中）：

```sh
npm install --global pnpm@11.7.0 @deepseek-ai/dsh@0.1.1-rc.2
npm install --global @yoke233/omdsh
```

之后无需手工初始化 profile：`omdsh` 首次运行会自动安装或迁移 `tui` profile；`omdsh update` 可随时从 GitHub 最新 Release 下载、校验并安装 bundle。release tarball 已包含构建后的 `lib/`，用户机器无需编译。

手工安装到 profile（不经 omdsh）

```sh
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile tui add \
  https://github.com/yoke233/omdsh/releases/download/v0.6.0/yoke233-omdsh-0.6.0.tgz
```

升级、卸载、从 Git tag 安装及常见问题见 [`docs/INSTALL.md`](docs/INSTALL.md)。

### 2. 配置模型

官方 DeepSeek API：

```sh
# Git Bash / zsh
export DEEPSEEK_API_KEY='your-key'

# PowerShell
$env:DEEPSEEK_API_KEY = 'your-key'
```

也可以连接 OpenAI-compatible 本地网关：

```sh
export DEEPSEEK_BASE_URL='http://localhost:3000/v1'       # Git Bash / zsh
$env:DEEPSEEK_BASE_URL = 'http://localhost:3000/v1'      # PowerShell
```

环境变量必须在启动的同一个 shell 中可见。启动后可用 `/model` 添加或切换 provider、model 与 reasoning effort。

### 3. 启动

推荐经 `omdsh` 启动——它是 `/reload` 的监督进程，插件更新可在会话内原地生效：

```sh
omdsh

# 恢复已有会话
omdsh --resume
```

也可以直接用官方 dsh 启动（此时没有监督进程，`/reload` 会提示并拒绝，插件更新需退出重启）：

```sh
dsh --profile tui
```

验证 profile 是否正确组合：

```sh
dsh --profile tui --dump-config
```

输出中应包含 `@yoke233/omdsh` bundle，以及 `@yoke233/omdsh/startup`、`@yoke233/omdsh/prompt` 和 `@yoke233/omdsh`。

## 常用操作

### 快捷键

| 快捷键 | 作用 |
| --- | --- |
| `Esc` | 停止进行中的任务（输入框聚焦时） |
| `Ctrl+C` | 中断当前回合；2 秒内再次按下退出 |
| `Ctrl+O` | 工具卡循环：折叠 → 展开 → 隐藏 |
| `Ctrl+R` | 显示或隐藏思考块 |
| `Alt+V`（Windows）· `Ctrl+V`（Linux/macOS） | 将剪贴板图片附加到输入草稿 |
| `Tab` | 补全命令、参数或路径 |
| `@` | 引用会话或文件 |
| 鼠标拖选 + `Ctrl+Shift+C` | 使用终端原生选择复制文本 |

粘贴图片后，输入框会插入 `[Image #N]` 标记；提交时只附加仍保留标记的图片。当前版本暂不在 TUI 中渲染图片预览。

### 核心命令

| 命令 | 作用 |
| --- | --- |
| `!` | 用 Profile 当前平台 shell 执行命令（Windows PowerShell、POSIX bash）；结果持久显示为 shell 卡，并作为用户消息开启下一轮 agent 会话 |
| `/help` | 查看运行中实例的完整命令与快捷键 |
| `/model` | 选择 provider、model 和思考等级 |
| `/new` · `/resume [id]` | 新建或恢复持久化会话 |
| `/reload` | 重启插件运行时并续接当前会话（需经 `omdsh` 启动；回合运行中会要求先等待结束） |
| `/mode [preset]` | 切换 `standard`、`minimal`、`code`、`cordis` 或本地 preset |
| `/permission [preset]` | 切换沙箱与审批策略 |
| `/theme` · `/palette` | 切换主题并检查实际颜色角色 |
| `/settings` | 打开可视化设置面板 |
| `/skills` · `/skill:` | 浏览或直接调用技能 |

更多命令以运行中的 `/help` 为准。`!` 命令复用 dsh 的 `ctx.shell` executor，不绕过 Profile 的 cwd、环境清理、超时和 sandbox；命令完成后 stdout、stderr 与退出状态会进入持久用户消息，因此 agent 能在随后独立回合看到并回应。`read-only` 与 `workspace-write` 模式下，越权操作仍受 sandbox 限制；`full-access` 不显示审批框。

## 微信远程桥

内置微信桥通过腾讯官方 ClawBot / iLink 通道连接当前前台会话，支持扫码登录、白名单/配对码、远程命令、周期进度、结果推送，以及 `wechat_send` / `wechat_status` 工具。

```text
/wechat-login       # 扫码登录
/wechat-pair 123456 # 批准陌生用户收到的 6 位配对码
/wechat-status      # 查看桥状态
/wechat-notify on   # 将终端发起的任务也推送到微信
```

- 微信消息以 `@dsh` 开头时会作为远程命令，不进入对话，例如 `@dsh status`、`@dsh models`、`@dsh think max`。
- 普通消息会注入当前 TUI 前台会话；完成结果会自动回传。
- 状态与配置默认保存在 `~/.dsh/wechat-ilink/`，可用 `DSH_WECHAT_ILINK_STATE` 覆盖。
- 推送频率和终端任务推送开关可在 `/settings` 的 `微信claw` 页面调整。

## 配置

大多数选项可直接通过 `/settings`、`/theme`、`/model` 和 `/permission` 调整。也可以在 profile 的 `cordis.patch.yml` 中配置 `id: tui`：

```yaml
- id: tui
  config:
    mode: standard              # standard | minimal | code | cordis | 本地 preset id
    locale: zh-CN               # zh-CN | en
    defaultReasoningEffort: max
    theme:
      mode: dynamic             # dynamic | selected
      dark: dark-catppuccin
      light: light-catppuccin
      selected: dark-catppuccin
      custom:
        accent: [255, 100, 100]
        userMessageBg: [24, 24, 37]
```

需要注意：

- `mode` 只对空白会话生效；恢复会话时沿用日志中的模式。
- `dynamic` 根据终端明暗在 `dark` / `light` 槽位间切换；`selected` 固定使用 `selected`。
- `theme.custom` 只接受 RGB 三元组；未知角色或非法值会被忽略。
- 官方 settings provider 存在时，界面选择会写入 `$DSH_HOME/settings.yaml`。
- `/permission` 的选项来自当前部署，用户自定义 preset 也会进入提示与补全。

## `omdsh` 启动器与 `/reload`

`omdsh` 是本插件推荐的启动方式（安装方法见[快速开始](#快速开始)），它做三件事：

1. **引导 profile**：调用系统 `PATH` 中的官方 `dsh`；首次运行自动把本插件安装进 `tui` profile，检测到旧版本时自动升级，然后启动 `--profile tui`。所有参数原样透传（如 `--resume `）。
2. **监督 `/reload` 的世代重启**：TUI 里执行 `/reload` 时，当前 dsh 进程写下交接信息后优雅退出，`omdsh` 在同一终端启动新一代进程并续接当前会话（空白会话原地重建同一身份）。新进程意味着全新模块图——任意插件升级、`link:` 代码变化或依赖变化都随之生效，无需退出终端。
3. **透传退出**：正常退出（如 `Ctrl+C` 双击）时原样传递退出码，不留驻后台。

直接用 `dsh --profile tui` 启动时没有监督进程，`/reload` 会提示并拒绝；插件更新需退出后重新启动。`omdsh` 自身更新后也需要退出重启一次才能换上新启动器。

环境变量：`OMDSH_NO_BOOTSTRAP=1` 跳过自动安装/升级；`DSH_REAL` 指定真实 dsh 可执行文件；`DSH_DEBUG=1` 只打印将要执行的命令。

## 参与开发

```sh
git clone https://github.com/yoke233/omdsh.git
cd omdsh
pnpm install --frozen-lockfile
pnpm run check
pnpm run prepare
```

测试使用 Node 原生 `node:test` 直接运行 TypeScript 源码。本地开发推荐把仓库以 `link:` 安装进 profile，然后经 `omdsh` 启动——每次改完源码只需重建 `lib/` 并在 TUI 里 `/reload`，新代码原地生效、会话不断：

```sh
dsh plugin --profile tui add link:.
omdsh

# 迭代循环：改源码 → 重建 → 在 TUI 里 /reload
pnpm run prepare
```

dsh 上游合约变化时，请先更新 [`docs/contracts.md`](docs/contracts.md)，再同步源码、`cordis.patch.yml`、依赖和测试。

### 项目边界

```text
src/                    TUI、主题、提示、会话、设置与微信桥
src/components/         状态栏、消息、工具卡和转录组件
tests/                  node:test 行为测试
cordis.patch.yml        bundle 与 dsh profile 的组合配置
scripts/omdsh*          跨平台 TUI 启动器
docs/                   安装、发布与 harness 合约文档
```

本仓库不复制 dsh 上游能力：harness 负责 agent、模型、工具、持久化与沙箱，本项目只实现 profile 层的终端体验与桥接。

## 文档

- [`docs/INSTALL.md`](docs/INSTALL.md) — 安装、升级、卸载与排障
- [`docs/contracts.md`](docs/contracts.md) — 当前 dsh 合约的唯一真相源
- [`docs/hooks.md`](docs/hooks.md) — Claude Code 格式 hooks 桥接
- [`docs/orca.md`](docs/orca.md) — 在 Orca pane 里的 agent 状态上报
- [`docs/PUBLISHING.md`](docs/PUBLISHING.md) — release、tarball 与 CI 发布流程
- [`CHANGELOG.md`](CHANGELOG.md) — 完整版本记录

## 许可证

[BSD-3-Clause](LICENSE)。