dsh-omp-tui
更新日志
v0.2.1 (2026-08-18)
- 移植本机 OMP 的全部 98 个主题
- 新增深色/浅色自适应主题模式
- 浅色 truecolor 终端使用 OMP 浅色主题而非 ANSI 回退
omdsh在 profile 内插件版本落后时自动更新- 缓存转录组件渲染并限流 token/权限读取，修复长会话卡顿
- 工具卡标题仅显示工具名，具体命令/参数显示在 Input 区，超长内容自动折行
str_replace_editor以 Diff 分区展示 old_str/new_str 编辑差异
v0.2.0 (2026-08-18)
- 修复微信入站消息路由：始终跟随 TUI 前台会话，只有成功排队才回复“任务进行中”
@dsh new通过 TUI 创建新会话并切换到前台- 新增
omdsh启动器：使用系统 PATH 中的 dsh，首次运行自动安装、版本落后时自动更新 tui profile - 会话指针始终指向前台会话，进度与结果可见
v0.1.3 (2026-08-17)
- 修复
/resume、/new后微信桥活动会话未同步的问题 - 微信开始回执和最终结果推送与周期进度汇报开关解耦
- 修复
/model和设置中用户新增 provider 的模型读取 - 完善 provider 模型管理：增删改、长 ID/URL 完整显示
- 修复窄终端下模型目录对话框文本裁剪
v0.1.2 (2026-08-16)
- 接入微信 iLink 桥：
/wechat-*命令、@dsh远程命令、wechat_send/wechat_status工具、进度与结果推送、ask 微信双通道 - 设置界面重构为全屏框架，新增 General / Models & Providers / Advanced 标签页
- 新增自定义供应商表单与模型发现/手动录入
- 新增默认模型、思考强度、权限模式等配置
- 新增 skill 快速命令
skill:<name>与补全 - 修复 ANSI/C1 转义与 Tab 导致渲染错乱
- 新增“微信claw”设置标签页
v0.1.1 (2026-08-15)
- 新增
/new进程内创建新会话 - 新增
/think思考强度切换 - 新增
/mode切换本地 agent 预设 - 接入
/permission权限模式 - 优化 OMP 风格状态栏与窄侧边栏
- 强化会话恢复性能与超时保护
v0.1.0 (2026-08-14)
- 初始发布，OMP 风格 Catppuccin 终端界面
- 基础用户、助手、推理、工具渲染
重要提示
- 因为DeepSeek的大幅涨价，连带opencode go的可用额度也大幅减少，在找到合适的替代之前DeepSeek的性价比已经降低到一个相对较低的水准，并且本人已不打算继续大规模使用DeepSeek，因此本项目开发将进入缓慢阶段，将在完成一些最后的收尾工作后暂时停止继续更新，如有bug可通过issue反馈，看到后会酌情考虑修复。
- 本项目目前已可以作为一个tui工作，必要功能均已测试正常。
- wechat-claw通道的远程控制能力已开发完成。
- 目前项目文档由ai完成，后续功能开发完全后会重新编写readme以增强可读性。
OMP 风格的 DeepSeek Harness（dsh）终端界面。它是一个独立的 profile bundle（插件），负责终端呈现、输入交互与会话相关的 TUI 能力；agent、模型、工具、持久化和沙箱仍由 dsh harness 提供。
目录
界面预览
截图来自本机 WezTerm 中实际启动的 dsh --profile tui。演示实例未配置 API key，因此截图聚焦于启动页、状态栏和内置帮助面板，不代表模型响应效果。
欢迎页
输入 /help 可查看快捷键和命令。工具卡支持折叠、展开和隐藏；助手正文、思考块、上下文卡和 Output 分隔栏使用独立的视觉层级。
功能概览
- OMP 风格 TUI：默认 Catppuccin 动态深浅主题、truecolor、Nerd Font 图标和 Powerline 状态栏。
- 响应式布局：窄终端优先保留模式、工作目录、Git 与
ctx，空间不足时逐级压缩或隐藏低优先级字段。 - 会话管理：支持新建、命名、恢复和进程内切换持久化会话。
- 模型与思考等级：通过
/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 |
| pnpm | 11.7.0 或兼容的 pnpm 11 |
| dsh | 0.1.0-rc.6 |
| 终端 | 推荐支持 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.6 plugin --profile tui add \
https://github.com/mytianyi0712/dsh-tui-plugin-OhMyPi/releases/download/v0.1.3/dsh-omp-tui-0.1.3.tgz
tarball 已包含构建后的 lib/，用户机器无需编译本项目。
从 GitHub tag 安装
Git 安装会执行本项目的 prepare 构建。pnpm 11 默认阻止依赖构建脚本，因此必须显式允许本包：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile tui add \
--allow-build=dsh-omp-tui \
github:mytianyi0712/dsh-tui-plugin-OhMyPi#v0.1.3
固定 tag 比直接使用 #main 更容易复现。完整的升级、卸载和安装排障说明见 docs/INSTALL.md。
如果希望直接使用 omdsh 启动器，也可以全局安装本地 tarball；包内的 dsh 宿主 peer 依赖为 optional，npm 11 不会因 peer 图触发 Arborist 的 null.children 崩溃：
npm install --global ./dsh-omp-tui-0.2.1.tgz
npm install --global @deepseek-ai/dsh@0.1.0-rc.6
omdsh
omdsh 只负责调用 PATH 中的官方 dsh；若未安装官方 dsh，会显示 dsh is not recognized。
启动与日常使用
启动会话
# 使用 npx
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 --profile tui
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 --profile tui --session my-id
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 --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 列表中。
快捷键
| 快捷键 | 作用 |
|---|---|
Ctrl+C |
中断当前回合；2 秒内再次按下退出程序 |
Ctrl+O |
工具卡显示循环：折叠 → 展开 → 隐藏 |
Ctrl+R |
显示或隐藏思考块 |
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 |
/palette |
查看当前主题实际使用的颜色角色 |
/settings |
打开可视化设置 |
/skills |
列出可用技能 |
@[label](dsh-session:<id>) 会将目标会话的模型可见快照注入当前会话。更多命令以运行中的 /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分为“常规 / 模型与供应商 / 高级”三页；模型与供应商页支持新增/编辑供应商、模型探测与手动模型列表。接口类型使用 dsh-llm-pi-ai 官方值：OAI 兼容openai-completions、Responseopenai-responses、Messageanthropic-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.6 plugin --profile tui add link:.
dsh 仍处于 rc 阶段。上游接口变更时，先更新 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/contracts.md：dsh harness 合约唯一真相源docs/PUBLISHING.md：GitHub release、tarball 和 CI 发布流程CHANGELOG.md：版本变更记录
许可
BSD-3-Clause。patches/@earendil-works__pi-tui@0.80.7.patch vendored from turtle1999/turtle-ui（BSD-3），完整声明见 patches/NOTICE.md。
还没有评论，来写第一条。