mytianyi0712/my-dpsk-harness-tui ↗★ 8
my-dpsk-harness-tui
opencode v2 风格的 DeepSeek Harness(dsh)终端界面
설치
$
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、Responseopenai-responses、Messageanthropic-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 也会进入命令提示和补全。