omdsh

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

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

为什么使用它

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

快速开始

环境要求

• 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 中）：

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/，用户机器无需编译。

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。

2. 配置模型

官方 DeepSeek API：

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

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

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

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 的监督进程，插件更新可在会话内原地生效：

omdsh

# 恢复已有会话
omdsh --resume <session-id>

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

dsh --profile tui

验证 profile 是否正确组合：

dsh --profile tui --dump-config

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

常用操作

快捷键

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

核心命令

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

微信远程桥

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

/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：

- 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 <session-id>）。
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 只打印将要执行的命令。

参与开发

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，新代码原地生效、会话不断：

dsh plugin --profile tui add link:.
omdsh

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

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

项目边界

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/contracts.md — 当前 dsh 合约的唯一真相源
• docs/hooks.md — Claude Code 格式 hooks 桥接
• docs/orca.md — 在 Orca pane 里的 agent 状态上报
• docs/PUBLISHING.md — release、tarball 与 CI 发布流程
• CHANGELOG.md — 完整版本记录

许可证

BSD-3-Clause。