mytianyi0712/my-dpsk-harness-tui ↗★ 8

my-dpsk-harness-tui

opencode v2 风格的 DeepSeek Harness(dsh)终端界面

包名
my-dpsk-harness-tui
兼容性
待验证
Harness 依赖范围
>=0.1.2-alpha.2 <0.2.0 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.1 <0.2.2
Cordis 依赖范围
>=4.0.2 <5.0.0
版本
0.5.0
许可证
BSD-3-Clause
最近更新
2026年10月30日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add https://github.com/mytianyi0712/my-dpsk-harness-tui/releases/download/v0.5.0/my-dpsk-harness-tui-0.5.0.tgz

启动与日常使用

启动会话


# 使用 npx
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile tui
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile tui --session my-id
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile tui --resume 

### 使用 `dpsk` 启动 TUI

项目提供 `dpsk` 启动器(`scripts/dpsk.js` 为跨平台 bin,另有 `scripts/dpsk` 与 `scripts/dpsk.cmd`)。`dpsk` 会调用系统 PATH 中的官方 `dsh` 并启动 `--profile tui`;本项目不下载、不缓存 dsh。正常启动不打印日志、不迁移设置、不自动升级,只会做一次新旧包交替的自愈摘除(0.4.0 的 `dsh-omp-tui` 与本包注册同一个 `tui` 服务,留在 profile 里会遮住本包);首次尚无 tui profile 时会静默安装当前启动器包(可用 `DPSK_NO_BOOTSTRAP=1` 跳过)。同版本内容漂移请使用 `dpsk check` 用全局包覆盖 profile。从 GitHub 获取新版本并做适配请使用 `dpsk update`。官方 dsh 命令(`web`、`plugin`、显式 `--profile` 等)请直接使用 `dsh`。

```sh

### 程序配置、费用估算与重启

程序自有配置集中在 `~/.config/.mydpsk`,DSH 的 profile、sessions、attachments 和 settings 仍归 `$DSH_HOME`,不会搬进这里:

```text
~/.config/.mydpsk/
  config.json        # 程序配置(外部编辑,热更新;含 lastSelection)
  price.json         # 程序自带公开价格表(程序初始化/维护)
  custom_price.json  # 用户覆盖表(/price 写入,也可手动编辑)
  backend.json       # dpsk 记住的 dsh 后端(启动时读取)
  runtime/           # /restart 的临时 handoff
  • price.json 是程序自带公开价格表,首次启动从随包表初始化;custom_price.json 初始为空,优先级高于 price.json。
  • TUI 会把上次实际使用的 provider/model、思考强度与 agent mode 写入 config.json 的 lastSelection,下次启动自动恢复;恢复历史 session 时仍以该 session 自己的 request header 为准。
  • /price 无参数时从 price.json 选择一条价格给当前模型;/price 直接按 id/别名匹配。保存后写入 custom_price.json 并立即重算当前会话费用。
  • 手动修改价格时优先编辑 custom_price.json,不要把长期自定义价格写进程序维护的 price.json。
  • 价目表是 USD / 1M tokens,分 input / cacheRead / cacheWrite / output;匹配支持 provider/model 精确值、路径前缀、源模型 id 别名、版本无关 family 匹配,以及 DeepSeek 的时区峰谷规则。
  • custom_price.json 的热更新会即时生效;无效 JSON、schema 错误或半写入文件会保留 last-good 配置,不会把运行中的 TUI 打挂。
  • 侧栏 context 区固定为 CTX(当前上下文)、SUM(累计 tokens,附 cache 命中率)和 $(本地估算 USD 花费)。未匹配到模型价格时显示 $ 未配置模型价格,不会伪造 $0.00。
  • /restart 会通过 dpsk supervisor 重启当前 dsh 子进程,重新加载 DSH 侧配置;保留当前 session、tabs 和草稿。普通退出、Ctrl+C 和崩溃仍按正常语义退出。直接运行 dsh --profile tui 时该命令会提示不可用。
  • dpsk 已记住的 backend 会用文件签名快速验证,命中时跳过 PATH 扫描和 dsh --version;DSH_REAL、路径失效或文件被替换时仍回退完整探测。

配置

模型连接

官方 DeepSeek API:


### TUI profile 配置

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

```yaml
- id: tui
  config:
    mode: standard              # standard | minimal | code | cordis 或本地 preset id
    locale: zh-CN               # zh-CN(默认)| en
    defaultReasoningEffort: max
    themeName: opencode        # opencode | opencode2 | system | 主题文件 id
    themeMode: system          # system | dark | light
    newDesigns: false          # 实验:New designs(提供 opencode2 与新版布局)
  • mode 只对空白会话生效;切换结果会写入会话日志,恢复会话时沿用。
  • /themes 和 /settings 的选择写入 profile 的 patch 层(~/.dsh/profiles/tui/cordis.patch.yml),按行 id 寻址:本 bundle 的设置节在 dpsk-tui 行,标题模型在 dpsk-session-title 行。0.5.0 之前的行 id 是 tui 与 session-title-llm-tui,激活时自动迁移一次。
  • /settings 分为“常规 / 模型与供应商 / 高级 / 微信claw”四页。开关、工具输出行数、并行数和默认思考等级在当前行回车即可切换;模型与供应商页集中默认模型、思考等级和供应商列表,Enter 循环思考等级。供应商表单中接口类型就地循环官方值:OAI 兼容 openai-completions、Response openai-responses、Message anthropic-messages;探测上游会直接合并进模型列表。
  • 默认模式读取 dsh settings 中 agent-presets 行的 selectedDefault(用户选择的默认预设):设置页修改后,新会话启动会使用该默认模式,而不是固定回退到 standard。dsh 0.2 的预设注册表把「部署默认」和「用户选择默认」分开,defaultId 即两者合并后的结果。
  • 主题由渲染器原生 ThemeProvider 拥有:themeName 从内置 opencode 文档、custom 主题文件((DSH_HOME ?? ~/.dsh)/themes 与项目祖先 .deepseek/themes)或 system(由终端调色板生成)中选一个;themeMode: system 跟随终端明暗,dark / light 固定一种,若该主题不支持则拒绝切换。newDesigns 打开后额外提供 opencode2。
  • 0.4.0 的 themeDark / themeLight / themeSelected / themeCustom / themeSchema 只作为迁移输入保留,不再写入新设置节;旧值不会被当成当前主题。
  • /permission 的可用选项以当前部署的权限预设为准,自定义 preset 也会进入命令提示和补全。