/
← Back to home@Dax233

dsh-plugins

No description

Stars
1
Language
—
Created
Oct 23, 2026
Updated
Oct 26, 2026
Browser
GitHub repo

Introduction

DSH Plugins

DeepSeek Harness（DSH）插件目录。每个插件维护在独立仓库中；本仓库只做索引、安装说明与设计笔记，不再包含插件源码。

插件

插件说明安装
Outbound Proxy让 DSH 出站 HTTP(S) 走本机代理（Clash / mihomo 等），端口跟随启动环境，插件行可单独覆盖dsh plugin --profile desktop add github:Dax233/dsh-outbound-proxy
Desktop NotifyWindows 原生通知：任务完成 / 需要提问 / 出错时弹 toast 并播放内置 ciallo 提示音dsh plugin --profile desktop add github:Dax233/dsh-desktop-notify
Sidebar Browser Control侧边栏 Agent 浏览器：快照 / 点击 / 输入 / 滚动 / 截图，页面内虚拟光标不碰真实鼠标dsh plugin --profile desktop add github:Dax233/dsh-sidebar-browser-control
Chrome Bridge控制真实 Chrome：后台标签、DSH Agent 标签组 ACL、UIA refs、动作回执、console/network 日志、iframe 观测与点击dsh plugin --profile desktop add github:Dax233/dsh-chrome-bridge
Codex Bridge桥接本机 Codex：线程清单 / 转录取读 / 无头投递任务 / goal 与活性监测（可对停滞线程补"继续"）；仓库另带离线 watch 告警脚本dsh plugin --profile desktop add github:Dax233/dsh-codex-bridge
Delete Guard删除指令守卫：shell 命令里出现删除动词时，必须是唯一且顶层的单条语句；串联、管道、嵌套、cmd /c、iex 一律在执行前拒绝dsh plugin --profile desktop add github:Dax233/dsh-delete-guard
Provider Aliases模型目录别名：一个内置 provider 目录挂多条凭据路由（多 OpenCode Go 套餐等），附「模型别名」设置面板，每条路由独立 Key 与思维档位dsh plugin --profile desktop add github:Dax233/dsh-provider-aliases
Session Bridge (fork)跨工作区会话桥 fork（上游 MIT）：按标题/工作区查找、读取任意会话，新增 session_search_global 全库正文检索；工具面可切换（当前开放建会话/发消息/监控/归档等写操作），bundle patch 开启持久化全文索引dsh plugin --profile desktop add github:Dax233/dsh-session-bridge
Preset Hotswitch会话内热切换 Agent 预设：绕过官方「仅空白会话可切换」限制（agentPresets.recompose + agent-preset/selected），下一请求生效、重启保持dsh plugin --profile desktop add github:Dax233/dsh-preset-hotswitch

安装

前置：DSH Desktop 带插件管理器（0.2.x），Windows 10/11。

dsh plugin --profile desktop add github:Dax233/dsh-outbound-proxy
dsh plugin --profile desktop add github:Dax233/dsh-desktop-notify
dsh plugin --profile desktop add github:Dax233/dsh-sidebar-browser-control
dsh plugin --profile desktop add github:Dax233/dsh-chrome-bridge
dsh plugin --profile desktop add github:Dax233/dsh-codex-bridge
dsh plugin --profile desktop add github:Dax233/dsh-provider-aliases
dsh plugin --profile desktop add github:Dax233/dsh-delete-guard
dsh plugin --profile desktop add github:Dax233/dsh-session-bridge
dsh plugin --profile desktop add github:Dax233/dsh-preset-hotswitch

也可以直接在插件页添加对应 GitHub 地址；安装后重启 DSH Desktop。

Chrome Bridge 额外步骤

下载现成扩展包：chrome-bridge 最新 Release 的 dsh-chrome-bridge-v*.zip，解压后在 chrome://extensions 开启开发者模式并 加载已解压的扩展程序。

.crx 是自签名包，Chrome 稳定版不允许拖入安装（CRX_REQUIRED_PROOF_MISSING），仅用于企业策略/Chromium 开发版；日常安装请用 zip + Load unpacked。

  1. 在 Chrome 打开 chrome://extensions → 开启开发者模式。
  2. 加载已解压的扩展程序 → 选择 dsh-chrome-bridge 仓库的 extensions/chrome-extension 目录。
  3. 打开扩展选项页，确认端口（默认 47835）与 token（默认 dsh-chrome-bridge-local）。

只有 DSH Agent 标签组 内的标签页可以被驱动；newTab 会自动入组，attach 是显式授权（把标签页拖出组即撤销）。

Codex Bridge 说明

需要本机已安装并登录 Codex（桌面版自带 CLI，或 npm i -g @openai/codex；登录态在 CODEX_HOME 下的 auth.json）。

插件只读 Codex home（转录、goal 数据库、写者锁、automation 文件），不修改 Codex 会话、goal 或配置；驱动 turn 走 codex exec / codex exec resume 子进程，子进程不继承凭据类环境变量。无头执行没有人工审批通道，默认 approval_policy=never；codex_liveness 的自动补活默认关闭，需要配置 allowNudge: true 才生效。

仓库另带 scripts/watch.mjs：确定性的 relay 异常检查（rollout heartbeat / goals / automation / liveness），只输出告警，退出码 0 无告警 / 10 有告警 / 2 检查失败。它不持有定时器、不唤醒 DSH，需用 --thread 或 watch.config.json 指定线程（无内置默认值），再配合 DSH schedule_create 或任务计划实现"异常才介入"。

Delete Guard 说明

插件挂在 tools/pre-execute 上：命令中出现删除动词（Remove-Item、rm、del、rd、 [IO.File]::Delete 等）时，只有唯一且顶层的一条语句才放行，其余组合在调用前被拒绝并返回原因。

  • 引号内字面量先掩码，路径里的 a;b 不会被误判成串联；但 iex "..." 这类会求值的场景会回查原文。
  • 分析异常时 fail-open（放行），守卫自身出问题不会把会话卡死。
  • 只管 shell 工具；run_code 里直接调 fs.rmSync 不经过 shell，不在范围内。

Provider Aliases 说明

一个包同时提供两半：同名扩展的内置 @deepseek-ai/dsh-llm-pi-ai 适配器（新增 catalog 别名能力）与「设置 → 模型别名」面板。安装后重启 DSH Desktop：

dsh plugin --profile desktop add github:Dax233/dsh-provider-aliases

它覆盖的适配器编译自 DSH 0.2.1-rc.3；DSH 升级后需要等待仓库更新或按仓库 README 重跑 tools/sync.mjs 重新生成。

Preset Hotswitch 说明

插件注册一个 Host 工具 switch_session_preset：官方切换入口只允许空白会话使用， 已开始的会话会被 registry 以 agent-preset/locked 拒绝；本插件改走公开的 agentPresets.recompose() 并写入 agent-preset/selected 事件，下一请求生效、重启后保持。 只作用于调用该工具的会话，不创建/删除预设；依赖宿主的 agentPresets 服务。 recompose 的契约自述"由调用方负责空白检查"，本插件刻意跳过该检查，属实验性用法， DSH 升级后可能失效。

安全说明

  • 浏览器控制插件的本机桥只监听 127.0.0.1（默认端口 47834 / 47835）。
  • 鉴权：侧栏桥使用 Authorization: Bearer；Chrome 桥使用 WebSocket hello 帧 token；两者都校验 Host/Origin。
  • 默认 token 仅用于本机零配置配对，可在扩展选项 / 环境变量中覆盖；不要把本机桥端口暴露到公网。
  • 本目录仓库不包含密钥、代理凭据或个人路径。

设计笔记

  • research/browser-control-survey.md：同类浏览器控制方案调研。
  • research/browser-control-backlog.md：下载、随机配对 token、逐 frame target 等未做项。
  • research/cross-workspace-session-access.md：跨工作区会话访问调研、上游 fork 决策与全文索引落地记录。

开发

每个插件仓库独立开发与测试：

git clone https://github.com/Dax233/dsh-<plugin>.git
cd dsh-<plugin>
npm test

License

MIT