deepseekplugins

DeepSeek Harness 插件

dsh-tui-plugin-ohmypi

OMP-styled interactive terminal profile bundle for DeepSeek Harness（英文原文）

插件开发工具
跳到安装方式

来源信息

GitHub 仓库
mytianyi0712/dsh-tui-plugin-OhMyPi
最近更新
2026年8月21日
分类
插件开发工具
GitHub stars
6
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/mytianyi0712/dsh-tui-plugin-OhMyPi
插件名：dsh-tui-plugin-ohmypi
作者：mytianyi0712

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-omp-tui

变更记录

完整版本历史见 [CHANGELOG.md](CHANGELOG.md)。

重要提示

  • 因为 DeepSeek 的大幅涨价，连带 opencode go 的可用额度也大幅减少，在找到合适的替代之前 DeepSeek 的性价比已经降低到一个相对较低的水准；本人已不打算继续大规模使用 DeepSeek，因此本项目开发将进入缓慢阶段，将在完成一些最后的收尾工作后暂时停止继续更新。如有 bug 可通过 issue 反馈，看到后会酌情考虑修复。
  • 本项目目前已可以作为一个 TUI 工具使用，必要功能均已测试正常。
  • wechat-claw 通道的远程控制能力已开发完成。
  • 更多开发约定见 [CONTRIBUTING.md](CONTRIBUTING.md)。

---

OMP 风格的 DeepSeek Harness（dsh）终端界面。它是一个独立的 profile bundle（插件），负责终端呈现、输入交互与会话相关的 TUI 能力；agent、模型、工具、持久化和沙箱仍由 dsh harness 提供。

目录

  • [变更记录](#变更记录)
  • [重要提示](#重要提示)
  • [界面预览](#界面预览)
  • [功能概览](#功能概览)
  • [安装](#安装)
  • [启动与日常使用](#启动与日常使用)
  • [配置](#配置)
  • [开发](#开发)
  • [项目结构](#项目结构)
  • [相关文档](#相关文档)
  • [许可](#许可)

界面预览

截图来自本机 WezTerm 中实际启动的 dsh --profile tui。演示实例未配置 API key，因此截图聚焦于启动页、状态栏和内置帮助面板，不代表模型响应效果。

<p align="center"> <img src="docs/assets/tui-welcome.png" alt="dsh-omp-tui 欢迎页" width="900"> </p>

欢迎页

<p align="center"> <img src="docs/assets/tui-help.png" alt="dsh-omp-tui 帮助面板" width="900"> </p>

输入 /help 可查看快捷键和命令。工具卡支持折叠、展开和隐藏；助手正文、思考块、上下文卡和 Output 分隔栏使用独立的视觉层级。

功能概览

  • OMP 风格 TUI：默认 Catppuccin 动态深浅主题、truecolor、Nerd Font 图标和 Powerline 状态栏。
  • 响应式布局：窄终端优先保留模式、工作目录、Git 与 ctx，空间不足时逐级压缩或隐藏低优先级字段。
  • 会话管理：支持新建、命名、恢复和进程内切换持久化会话。
  • 插话队列：生成中按 Enter 会把消息加入插话队列，在下一步（通常在工具调用完成后）送达模型；Alt+Up 可编辑尚未生效的插话并取消其排队状态。
  • 模型与思考等级：通过 /model、/think 选择 provider、model 和 reasoning effort。
  • 工作模式：支持 dsh 官方 standard、minimal、code、cordis 预设，也能发现本地安装的 agent preset。
  • 权限模式：通过 /permission 在 read-only、workspace-write、full-access 等部署可用预设间切换。
  • 主题与本地化：移植本机 OMP 的全部 98 个具体主题（dark-* / light-* / 中性主题），支持“动态”（深色/浅色槽位独立选择）与“选定”（单一主题）两种模式；支持逐角色 RGB 覆盖；内置 zh-CN 与 en。
  • 命令与补全：支持斜杠命令、@ 会话/文件引用、路径补全和参数补全。

安装

运行要求

项目要求
Node.js^22.19.0 或 >=24.0.0
pnpm11.7.0 或兼容的 pnpm 11
dsh0.1.0-rc.8
终端推荐支持 truecolor；Nerd Font 可获得完整图标显示

当前 dsh 仍处于 developer preview。首次安装建议固定 dsh 版本和插件 release tag。

安装 GitHub Release

没有 pnpm 时先安装固定版本：

npm install --global pnpm@11.7.0

然后安装当前 release tarball：

npx --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile tui add \
  https://github.com/mytianyi0712/dsh-tui-plugin-OhMyPi/releases/download/v0.2.4/dsh-omp-tui-0.2.4.tgz

tarball 已包含构建后的 lib/，用户机器无需编译本项目。

从 GitHub tag 安装

Git 安装会执行本项目的 prepare 构建。pnpm 11 默认阻止依赖构建脚本，因此必须显式允许本包：

npx --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile tui add \
  --allow-build=dsh-omp-tui \
  github:mytianyi0712/dsh-tui-plugin-OhMyPi#v0.2.4

固定 tag 比直接使用 #main 更容易复现。完整的升级、卸载和安装排障说明见 [docs/INSTALL.md](docs/INSTALL.md)。

如果希望直接使用 omdsh 启动器，也可以全局安装本地 tarball；包内的 dsh 宿主 peer 依赖为 optional，npm 11 不会因 peer 图触发 Arborist 的 null.children 崩溃：

npm install --global ./dsh-omp-tui-0.2.4.tgz
npm install --global @deepseek-ai/dsh@0.1.0-rc.8
omdsh

omdsh 只负责调用 PATH 中的官方 dsh；若未安装官方 dsh，会显示 dsh is not recognized。

启动与日常使用

启动会话

# 使用 npx
npx --yes @deepseek-ai/dsh@0.1.0-rc.8 --profile tui
npx --yes @deepseek-ai/dsh@0.1.0-rc.8 --profile tui --session my-id
npx --yes @deepseek-ai/dsh@0.1.0-rc.8 --profile tui --resume <session-id>

# 已安装 dsh launcher 后
dsh --profile tui
dsh --profile tui --session my-id
dsh --profile tui --resume <session-id>

--resume 与 --session 互斥。新会话只有在首次产生用户消息、助手消息或工具调用后才会落库；空白会话不会出现在 /resume 列表中。

快捷键

快捷键作用
Esc中断当前回合
Enter空闲时发送；生成中把当前消息加入插话队列
Ctrl+C空闲时清屏 / 运行中中断；2 秒内再次按下退出程序
Ctrl+D编辑器为空时退出程序
Ctrl+T显示 / 隐藏思考块
Ctrl+O展开 / 折叠工具输出
Ctrl+Shift+O显示 / 隐藏工具活动卡
Alt+L重置终端显示
Alt+Up编辑下一条尚未生效的插话（自动取消排队）
Ctrl+P / Shift+Ctrl+P循环切换模型（Shift 反向）
Alt+M打开模型选择器
Ctrl+Q / Ctrl+Enter提交当前草稿（生成中为插话）
PageUp / PageDown翻页滚动 transcript
Tab补全当前斜杠命令、参数或路径
@开始会话或文件引用补全

常用命令

| 命令 | 作用 | |---|---| | /help | 查看快捷键和完整命令列表 | | /model | 选择 provider、model 和 reasoning effort，并持久化设置 | | /think [level] | 切换当前模型的思考等级；无参时循环切换 | | /new | 在当前项目、模型和权限模式下新建会话 | | /resume [id] | 列出或切换当前项目的持久化会话 | | /details | 查看会话标题、目录、模型、agent、tokens 和 context | | /mode [preset] | 切换 dsh agent 组合；无参时循环切换 | | /permission [preset] | 切换沙箱和审批策略 | | /theme [mode|dark|light|theme id] | 查看或切换主题模式与主题 | | /palette | 查看当前主题实际使用的颜色角色 | | /settings | 打开可视化设置 | | /skills | 列出可用技能 |

@[label](dsh-session:…) 会把目标会话的模型可见快照注入当前会话；具体 URI 由输入 @ 触发补全生成。更多命令以运行中的 /help 为准。

微信远程桥接（WeChat iLink）

本 bundle 内置了从 OMP 迁移来的微信桥插件：通过腾讯官方 ClawBot / iLink 通道， 把 dsh 会话连接到微信，支持扫码登录、白名单/配对码、远程 @dsh 命令、自动进度 汇报与结果推送、wechat_send / wechat_status 工具，以及 ask 提问同步推送到微信。

# 在 dsh TUI 中扫码登录
/wechat-login

# 陌生微信用户会收到 6 位配对码，在 dsh 中批准
/wechat-pair 123456

# 查看桥状态
/wechat-status

微信里以 @dsh 开头的消息会被当作远程命令，不会进入会话（例如 @dsh status、 @dsh models、@dsh think max、@dsh notify on）。普通微信消息会直接注入当前 dsh 会话；模型可用 wechat_send 工具回复。

状态目录：~/.dsh/wechat-ilink/（可用环境变量 DSH_WECHAT_ILINK_STATE 覆盖）。 登录二维码同时写入 ~/.dsh/wechat-ilink/login-qr.txt，方便无界面场景查看。

#### 微信推送

微信桥支持把任务进度与结果自动推送到微信：

  • 微信消息触发的任务：默认开启进度汇报。模型回合每达到配置的间隔轮数时，会向微信推送一次进度；任务完成后自动推送结果。
  • 终端任务也推送：默认关闭。使用 /wechat-notify on 开启后，终端发起的任务也会在进度/完成时推送到微信；/wechat-notify off 关闭。
  • 可视化配置：在 /settings 的 微信claw 标签页中可配置：

- 进度汇报：开 / 关 - 进度汇报间隔（轮） - 终端任务推送微信：开 / 关

配置保存在 ~/.dsh/wechat-ilink/config.json，可通过环境变量 DSH_WECHAT_ILINK_STATE 改变状态目录。

使用 omdsh 启动 TUI

项目提供 omdsh 启动器（scripts/omdsh.js 为跨平台 bin，另有 scripts/omdsh 与 scripts/omdsh.cmd）。omdsh 会调用系统 PATH 中的官方 dsh 并启动 --profile tui；本项目不下载、不缓存 dsh。首次运行时，omdsh 会自动把 dsh-omp-tui 安装到 tui profile；之后若 profile 内版本低于启动器版本，也会自动更新（可用 OMDSH_NO_BOOTSTRAP=1 跳过）。官方 dsh 命令（web、plugin、显式 --profile 等）请直接使用 dsh。

# 开发环境：把仓库 scripts 目录加入 PATH
export PATH="$HOME/dsh-omp-tui/scripts:$PATH"   # Git Bash / zsh
omdsh                         # 等价于 dsh --profile tui
omdsh --resume <session-id>   # 透传给 tui profile

# Windows cmd / PowerShell
# 将 <仓库>\scripts 加入 PATH，或直接运行 <仓库>\scripts\omdsh.cmd

安装发布包后，omdsh 会由 bin 入口安装到 profile 的 .bin 目录（例如 ~/.dsh/profiles/tui/node_modules/.bin/omdsh），把该目录加入 PATH 即可直接使用。

需要指定真实 dsh 可执行文件时设置 DSH_REAL；设置 DSH_DEBUG=1 可以只打印启动器解析出的命令，不启动 dsh。

配置

模型连接

官方 DeepSeek API：

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

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

本地 OpenAI-compatible 网关：

# Git Bash / zsh
export DEEPSEEK_BASE_URL='http://localhost:3000/v1'

# PowerShell
$env:DEEPSEEK_BASE_URL = 'http://localhost:3000/v1'

环境变量必须在启动 dsh 的同一个 shell 中可见。启动后可用 /model 选择并持久化 provider、model 和思考等级。

TUI profile 配置

在 profile 的 cordis.patch.yml 中配置 id: tui 行，或使用 dsh settings 注入同一配置：

- 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 # selected 模式的单一主题
      custom:
        accent: [255, 100, 100]
        userMessageBg: [24, 24, 37]
  • mode 只对空白会话生效；切换结果会写入会话日志，恢复会话时沿用。
  • /theme 和 /settings 的选择在存在官方 settings provider 时写入 $DSH_HOME/settings.yaml。
  • /settings 分为“常规 / 模型与供应商 / 高级 / 微信claw”四页；模型与供应商页支持新增/编辑供应商、模型探测与手动模型列表。接口类型使用 dsh-llm-pi-ai 官方值：OAI 兼容 openai-completions、Response openai-responses、Message anthropic-messages。
  • 默认模式会读取 dsh settings 中保存的 agent-presets.default：设置页修改后，新会话启动会使用该默认模式，而不是固定回退到 standard。
  • theme.custom 只接受 RGB 三元组；未知角色和非法值会被忽略。
  • theme.mode 可选 dynamic（动态，按终端明暗在 theme.dark / theme.light 之间切换）或 selected（选定，固定使用 theme.selected）。三个主题槽位均填写具体 OMP 主题 id，不校验主题自身明暗，可任意搭配。
  • /permission 的可用选项以当前部署的权限预设为准，自定义 preset 也会进入命令提示和补全。

开发

pnpm install
pnpm run typecheck
pnpm run test
pnpm run prepare

常用辅助命令：

pnpm run check
node --experimental-transform-types scripts/perf-probe.ts

测试使用 Node 原生 node:test 运行 .ts 文件，不依赖兄弟 harness checkout。修改源码后重新运行 pnpm run prepare，再使用 link: profile 验证：

npx --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile tui add link:.

dsh 仍处于 rc 阶段。上游接口变更时，先更新 [docs/contracts.md](docs/contracts.md)，再同步代码、依赖版本，并运行测试与 dsh --profile tui 实机 smoke。

项目结构

src/                    TUI、主题、提示、会话和设置实现
src/components/         状态栏、消息、工具卡和转录组件
tests/                  node:test 行为测试
cordis.patch.yml        将本 bundle 组合进 dsh profile 的配置
scripts/omdsh*           omdsh TUI 启动器（调用系统 PATH 中的 dsh）
patches/                pi-tui 的 vendored pnpm patch 与声明
docs/                   安装、发布和 harness 合约文档
docs/assets/            README 使用的实机截图

架构边界保持简单：dsh harness 负责 agent、模型、工具、持久化与沙箱；本仓库负责终端呈现和输入。渲染层使用 @earendil-works/pi-tui@0.80.7，并通过 vendored patch 打入发布包，消费者无需单独安装 pi-tui。

相关文档

  • [docs/INSTALL.md](docs/INSTALL.md)：安装、升级、卸载、本地开发和常见问题
  • [docs/contracts.md](docs/contracts.md)：dsh harness 合约唯一真相源
  • [docs/PUBLISHING.md](docs/PUBLISHING.md)：GitHub release、tarball 和 CI 发布流程
  • [CHANGELOG.md](CHANGELOG.md)：版本变更记录
  • [CONTRIBUTING.md](CONTRIBUTING.md)：开发与 PR 约定
  • [SECURITY.md](SECURITY.md)：安全策略与漏洞上报

许可

BSD-3-Clause。patches/@earendil-works__pi-tui@0.80.7.patch vendored from turtle1999/turtle-ui（BSD-3），完整声明见 [patches/NOTICE.md](patches/NOTICE.md)。

返回搜索打开 GitHub 仓库

更多相关插件

查看分类

mirage#dsh

strukto-ai/mirage#dsh

把文件系统与 bash 提供者换成 mirage 虚拟工作区：文件工具与 shell 命令作用于挂载的资源（RAM、S3、Redis、Slack、Gmail、Notion、Postgres）而非宿主磁盘，支持按挂载点设置读/写/执行模式、按命令选择沙箱（进程内 monty、pyodide、quickjs；远程 docker、e2b、daytona），并可在虚拟终端中安装 CLI（git、gh、slack、linear、ntn、gws，或自行注册的程序树）作为命令头词。

2026年8月15日 3546