DeepSeek Harness plugin

dsh-oc

DeepSeek Harness × OpenCode TUI 前端:把 dsh 的 Agent、会话、工具接入官方 opencode 终端。OpenCode TUI frontend for the DeepSeek Harness (dsh): agents, sessions and tools in the official opencode terminal.

Jump to install

Source facts

Repository
chiro2001/dsh-oc
Latest update
Aug 21, 2026
Category
Development & Runtime
GitHub stars
4
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/chiro2001/dsh-oc
Plugin: dsh-oc
Author: chiro2001

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-oc

DeepSeek Harness 的 OpenCode TUI 前端:以官方 opencode TUI 为终端前端, dsh 作为后端提供 Agent、会话、工具与模型能力。

![CI](https://github.com/chiro2001/dsh-oc/actions/workflows/ci.yml) ![e2e](https://github.com/chiro2001/dsh-oc/actions/workflows/e2e.yml)

  • 前端:opencode 官方 CLI(attach 模式),直接使用官方二进制,只做 TUI。
  • 后端:DeepSeek Harness(dsh)负责 Agent、Session、工具、模型、权限和用户提问。
  • 连接:dsh-oc 在 dsh 进程内提供 OpenCode 兼容的 HTTP/SSE 桥(oc-bridge),并启动官方 TUI 客户端(oc-tui)。
dsh (Node) ── dsh-oc bundle ── oc-bridge (HTTP/SSE) <── opencode TUI (attach)
                  │
                  └─ DSH Agent/Session/Tools/LLM/Approval/Questions

能力状态

> 完整矩阵见 [docs/FEATURES.md](docs/FEATURES.md),路由细节见 > [docs/PROTOCOL.md](docs/PROTOCOL.md);dsh --profile oc --help 展示同一摘要。

能力状态
会话列表/新建/续聊/fork/compact、SSE 流式消息
会话列表标题渐进补温(投影标题 → 目录名 → id 回退;大目录后台补温)
模型目录、reasoning effort、agent preset 切换
工具卡片(bash/read/write/edit)、diff 与 Modified Files
工具参数流式显示
权限/提问流、子代理会话树与后台子代理
Goal 创建/查看(sidebar + /goal
Esc 打断/取消(全量双按、mini 单按)
文本/图片附件✅(PDF 等二进制暂不支持)
Allow always 权限✅(会话内内存记忆,重启清空)
MCP / LSP / formatter / skills / integration 等外围路由❌(schema-valid stub)

opencode 子进程直接使用官方二进制(锁定 1.18.18)。

演示

<img src="docs/demo/dsh-oc-demo.gif" alt="dsh-oc 核心功能演示(真实 DeepSeek 模型)" width="900">

真实录制:品牌启动画面 → 真实模型运行 pnpm test → 全部单测通过 → 退出提示。

安装使用

dsh plugin --profile oc add chiro2001/dsh-oc
dsh --profile oc

更新到该源最新版本(重复执行安装命令即可):

dsh plugin --profile oc add chiro2001/dsh-oc

固定分支/版本用 pnpm git spec,例如 github:chiro2001/dsh-oc#develop。 npm 包名为 @chiro2001/dsh-oc(未发布 registry,走 GitHub 源安装)。

发布与候选流程见 docs/RELEASE.md(版本 bump → 全套门禁 → full-SHA 安装/回滚演练 → 受保护 tag)。

安装后可用简写命令 dsh-oc(等价于 dsh --profile oc,参数原样透传)。 它由 npm bin 提供:把 profile 的 bin 目录加入 PATH 即可直接使用,例如:

export PATH="$HOME/.dsh/profiles/oc/node_modules/.bin:$PATH"
dsh-oc                        # 等价 dsh --profile oc
dsh-oc --mini                 # 等价 dsh --profile oc --mini
dsh-oc --version              # 同时输出 dsh-oc 与 dsh 的版本

pnpm 提示缺少 @deepseek-ai/cordis 等 peer 属于预期警告,由 dsh-base/宿主在 运行时提供,可忽略。

参数透传

支持透传给 opencode attach 的参数:

  • --continue / -c--session / -s--fork--dir--mini

--print-logs--log-level

示例:

dsh --profile oc --session <session-id>
dsh --profile oc --dir ~/project --mini

--dir 还会写入 bridge 工作目录(路径、新建会话、附件校验以此为基准)。 其它参数会显式打印 ignored unsupported arg 警告,不会静默丢弃。

数据隔离

opencode 的配置、数据、状态与缓存全部隔离在 $DSH_HOME/opencode 下; 模型与凭据由 dsh 后端管理,dsh-oc 不向 opencode 注入 provider/key。

已知限制

  • Allow always:仅会话内内存记忆,重启清空。
  • 退出 splash:官方退出画面无法替换,dsh-oc 在其下方补一行 dsh 恢复说明

DSH_OC_DISABLE_EXIT_NOTE=1 可关)。

  • --mini 入口 logo:官方 mini 界面不加载 TUI 插件,无法替换其内置

OpenCode 字符画;dsh-oc 会在启动前先打印 DSH OC 品牌。

  • Esc 打断:--mini 单按、全量 TUI 连按两次;dsh-oc 会转为 session.cancel
  • 附件:支持文本与图片,PDF 等二进制暂不支持。
  • 工具回合的后续文本在“忙碌中排队第二条消息”时,TUI 即时转录顺序可能

错位(内容完整、无重复;重新进入会话后恢复),官方 opencode 同类场景 甚至不保留该后续文本。

  • 外围路由(MCP/LSP/formatter/skills/integration):schema-valid stub,不伪造结果。
  • 模型与权限:由 dsh 后端管理。

自测

pnpm run e2e:api   # 快速 API 回归
pnpm run e2e       # 全量 e2e(真实 opencode TUI)

完整自测门槛见 [AGENTS.md](AGENTS.md)。

开发者 / Agent

开发环境、常用命令、自测门槛、分支与提交流程、安装/更新与二进制策略见 [AGENTS.md](AGENTS.md);人类贡献流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。 其它文档:[docs/PLAN.md](docs/PLAN.md)、[docs/ROADMAP.md](docs/ROADMAP.md)、 [docs/CHANGELOG.md](docs/CHANGELOG.md)、[docs/MANUAL-TEST.md](docs/MANUAL-TEST.md)。