@chiro2001/dsh-oc
DSH 插件 @chiro2001/dsh-oc
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:chiro2001/dsh-oc#d2c4c7ce6d8125dc0a2ce6ea53cfe406662c9f7b
DSH 插件 @chiro2001/dsh-oc
Oc 以 @chiro2001/dsh-oc 发布，当前版本为 0.2.0-rc.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（dsh）的 OpenCode TUI 前端：使用官方 OpenCode 终端界面， 由 dsh 提供 Agent、会话、工具、模型、权限和提问能力。
opencode attach TUI，只负责终端渲染、键盘交互和生命周期。dsh (Node) ── dsh-oc bundle ── oc-bridge (HTTP/SSE) <── opencode TUI (attach)
│
└─ DSH Agent/Session/Tools/LLM/Approval/Questions
当前兼容基线：dsh >=0.1.5-rc.2、官方 opencode 1.18.18。
main 当前指向 GitHub prerelease v0.2.0-rc.4，
不是无标记的稳定版；npm registry 暂未发布，安装和更新走 GitHub 源。
dsh plugin --profile oc add chiro2001/dsh-oc
dsh --profile oc
这里的 profile 名称是 oc，不是 dsh-oc。更新同一来源时重复执行上面的安装命令即可。
需要固定当前 prerelease 时使用 tag；验证集成线时显式选择 develop：
dsh plugin --profile oc add 'github:chiro2001/dsh-oc#v0.2.0-rc.4'
dsh plugin --profile oc add 'github:chiro2001/dsh-oc#develop'
固定某个 tag 或完整 commit SHA 时使用相应 GitHub spec。npm 包名是
@chiro2001/dsh-oc，但目前未发布到 npm registry。
本地开发可用 dsh plugin --profile oc add . 链接工作树；修改 TypeScript 后执行
pnpm build 即可让 profile 使用新构建。
安装后也可使用 dsh-oc 简写。将 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 宿主在
运行时提供。
启动后可以直接输入普通任务，例如“只回复 OK”。常用的控制命令如下：
| 输入 | 作用 |
|---|---|
!，再输入 shell 命令 | 在完整 OpenCode TUI 中执行用户指定的 shell 命令 |
/preset | 列出可用的 dsh agent preset |
/preset minimal | 切换到 minimal preset，不触发模型回合 |
/goal <目标> | 创建或查看 goal，状态会同步到侧栏 |
/help | 在 TUI 中显示能力摘要 |
! shell mode在完整 TUI 输入框输入 !，再输入例如 printf DSH_OC_SHELL_OK 并回车。命令经
dsh-oc 以当前 OS 用户身份启动精确的 shell 子进程（POSIX 仅使用绝对路径的
$SHELL -c，否则回退 /bin/sh；Windows 使用 ComSpec，缺失时回退
cmd.exe）。! 本身就是用户授权边界；它不经过 dsh 的模型工具、approval 或
sandbox waterfall。TUI 显示一张 shell tool card、输出和退出结果，但不会触发模型
回复；命令完成后会以明确标注“用户手动执行”的非唤醒 context 注入下一次真实 prompt，
让模型能看到命令和输出。注入本身不会开启新的 turn，session 被清理时不会迟到注入。
stdout/stderr 各自最多保留 1 MiB；超过后继续 drain 子进程，但在卡片中追加截断标记，
不会因为输出超过阈值而 kill 命令。发送给模型的 context 有独立预算：命令最多 16 KiB、
stdout/stderr 各最多 64 KiB、完整文本最多约 144 KiB，并带明确截断标记。
命令和输出会发送给当前配置的模型，可能包含 token、密码或个人数据；使用 ! 前请
确认不会泄露敏感信息。
--dir <path> 会设置 bridge cwd；已记录的 session cwd 优先，只有冷启动时才用它作
shell cwd fallback。shell 卡片属于 bridge 的短期投影，不伪造 dsh agent-loop 事件；
完成后的输出在当前 bridge 生命周期内可通过历史重新加载。
/preset空白会话中使用 /preset <name> 或 Tab 选择 agent 后，当前会话和之后新建的会话会
使用该 preset。/preset 的结果卡片在命令完成后立即结束，不需要再发送一条消息来
清除 QUEUED 状态。
会话已经产生回复后，dsh 会锁定 agent preset；此时切换会显示一次
Agent switch locked，请新建会话后再切换。
完整矩阵见 docs/FEATURES.md，协议细节见 docs/PROTOCOL.md；
dsh --profile oc --help展示离线能力摘要。
| 能力 | 状态 |
|---|---|
| 会话列表/新建/续聊/fork/compact、SSE 流式消息 | ✅ |
| 会话标题、历史恢复和目录过滤 | ✅ |
| 模型目录、reasoning effort、agent preset 切换 | ✅ |
! shell mode（用户授权的 OS shell、固定 bash tool card） | ✅ |
| 工具卡片（bash/read/write/edit）、参数流、diff 与 Modified Files | ✅ |
| 权限/提问流、子代理会话树与后台子代理 | ✅ |
| Goal 创建/查看/暂停/恢复/完成 | ✅ |
| 文本/图片附件 | ✅（PDF 等二进制暂不支持） |
Allow always 权限 | 🟡（仅当前会话内存记忆） |
| MCP / LSP / formatter / integration / reference 等外围路由 | ❌（schema-valid stub） |
真实录制：品牌启动画面 → 真实模型运行 pnpm test → 全部单测通过 → 退出提示。
支持透传给 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
其它参数会显式打印 ignored unsupported arg 警告，不会静默丢弃。
$DSH_HOME/opencode；模型和凭据由 dsh
后端管理，dsh-oc 不向 OpenCode 注入 provider/key。1.18.18；自动更新、远程模型目录抓取和 LSP 下载均关闭。! 授权，继承当前 OS 用户权限与 session cwd；不宣称
dsh approval/sandbox 保护。取消只针对当前 bridge/session 登记的精确子进程/进程组，
不按进程名结束其它进程；POSIX 使用自有 process group，Windows 使用自有 PID
的 taskkill /T 树。Windows 使用 ComSpec（不是 dsh 的 pwsh sandbox），这项
平台差异应在 Windows 主机上单独验收。agent/inbox/spliced pending context 供下一次 prompt 使用，claim 后
如发生 compaction 不保证逐字长期保留。Allow always 只在当前会话内记忆，重启后清空。DSH_OC_DISABLE_EXIT_NOTE=1 关闭。--mini 不加载 TUI branding 插件，因此入口仍可能显示官方 OpenCode 字符画；
dsh-oc 会在启动前打印 DSH OC 品牌。--mini 都需要连按两次 Esc 打断；dsh-oc 会转为
session.cancel。dsh-oc 只在 dsh --profile oc 的 dsh 进程中加载。它的 bridge、OpenCode 配置和
兼容 shim 都是该进程的本地状态，不会跨进程修改其它 profile；不要把 dsh-oc 安装
到 dsh-tui 所用的 profile 来修复 dsh-tui。
dsh-tui launcher 当前固定使用 dsh --profile dsh-tui，不是泛称的 tui。两者可以
同时存在；只读查看实际组合树：
dsh --profile oc --dump-config
dsh --profile tui --dump-config
dsh --profile dsh-tui --dump-config
如果你明确希望 profile 名称就是 tui，可以考虑安装 dsh-tui bundle 并直接使用该
profile（以下只是建议命令，本轮没有替用户 profile 执行）：
dsh plugin --profile tui add '@deepseek-harness-tui/dsh-tui@0.10.0-beta.5'
dsh --profile tui
该安装路径不要再添加旧版 dsh-dcp；全局 dsh-tui 命令仍会查找 dsh-tui profile，
不会自动转向 tui。
如果 dsh-tui 显示 turn error · events is not iterable，优先检查其 dsh-dcp 版本和
peer ABI。旧版 dsh-dcp 仍读取 dsh 0.1.2 已移除的 session.events，而新接口是
session.snapshotEvents()；这不是 dsh-oc 与 dsh-tui 的冲突。应升级到与当前 dsh
ABI 匹配的 dsh-dcp，或仅在 dsh-tui 自己的 profile patch/诊断 overlay 中暂时禁用
dcp（- id: dcp / disabled: true），再向 dsh-dcp/dsh-tui 上游反馈。
稳定版本、候选版本和完整发布门禁见 docs/RELEASE.md；变更记录见 docs/CHANGELOG.md。开发环境、分支策略和自测门槛见 AGENTS.md 与 CONTRIBUTING.md。手动回归步骤见 docs/MANUAL-TEST.md，下一阶段计划见 docs/ROADMAP.md。
快速自测：
pnpm run e2e:api # 快速 API 回归
pnpm run e2e # 全量 e2e（真实 opencode TUI）