🐋 dsh-trio — DeepSeek Harness 全家桶

一条命令装三个超能力:浏览器自动化 + MCP Server + GitHub 集成。

dsh plugin --profile web add dsh-trio

零构建、零配置依赖:src/ 直接是发布产物,不依赖任何 @deepseek-ai 包(版本兼容性最大化),唯一第三方依赖是 playwright-core(复用你系统里已装的 Edge/Chrome,不用下载 Chromium)。

安装

# 1. 安装(会自动通过 pnpm 链接到你的 web profile)
dsh plugin --profile web add dsh-trio

# 2. 重启 dsh
dsh web

不需要某个模块?在 $DSH_HOME/profiles/web/cordis.patch.yml 里删掉对应行 (trio-browser / trio-mcp / trio-github / trio-gitlab / trio-console)即可,或给对应行加 config: { enabled: false }。

Related MCP server: VegaMCP

🧭 浏览器自动化

给 agent 一个共享浏览器会话(多标签页,默认 headless;channel: auto 自动探测 msedge → chrome → chromium,也可 executablePath 指定):

多配置文件:config.profiles 声明命名配置,每个可带独立的 userDataDir (登录态隔离)——工作账号与个人账号互不干扰:

- id: trio-browser
  name: dsh-trio/browser
  config:
    profiles:
      work:     { userDataDir: C:/path/work-profile, channel: msedge }
      personal: { userDataDir: C:/path/personal-profile }

登录态持久化:配置 userDataDir 后,浏览器使用独立的用户数据目录 (launchPersistentContext),Cookie 与 localStorage 跨 DSH 重启保留——登录一次, 重启后 agent 还是登录状态:

- id: trio-browser
  name: dsh-trio/browser
  config:
    userDataDir: C:/path/to/dsh-trio-profile   # 留空 = 临时会话(默认)

| browser_wait / browser_back / browser_reload / browser_status / browser_close | 其余控制 |

实时画面:浏览器打开时访问 http://127.0.0.1:3080/trio/browser,每 2 秒自动 刷新截图,看着 agent 操作你的浏览器。

# 换个端口的话就是 http://127.0.0.1:<你 dsh web 的端口>/trio/browser

首次调用浏览器工具时会自动启动浏览器;启动失败会提示你安装 Chromium (npx playwright install chromium)或配置 executablePath。

浏览器配置

# $DSH_HOME/profiles/web/cordis.patch.yml
- id: trio-browser
  name: dsh-trio/browser
  config:
    channel: auto        # auto | chrome | msedge | chromium | ""(playwright 默认)
    executablePath: ""   # 显式指定浏览器可执行文件(优先于 channel)
    headless: true
    screenshotDir: .dsh-trio/screenshots
    downloadDir: .dsh-trio/downloads
    liveViewPath: /trio/browser
    maxTextChars: 20000
    maxLinks: 50
    timeoutMs: 30000

🔌 MCP Server

把 DSH 变成一台 MCP 服务器。任何支持 Streamable HTTP 的 MCP 客户端都能接:

// Claude Desktop / Cursor / Cline 等客户端的 mcpServers 配置
{
  "mcpServers": {
    "dsh": {
      "url": "http://127.0.0.1:3080/trio/mcp"
    }
  }
}

暴露的工具:

Resources 支持:resources/list 暴露 dsh://sessions/<id> 会话资源, resources/read 读取完整事件摘要(JSON)。tools/list 响应中同时声明资源目录。

OAuth 2.0 鉴权(可选,替代静态 token):启用后提供 client_credentials token 端点(/trio/mcp/oauth/token)与 RFC 8414 授权服务器元数据(/.well-known/oauth-authorization-server):

- id: trio-mcp
  name: dsh-trio/mcp
  config:
    oauthEnabled: true
    oauthClientIdEnv: MCP_CLIENT_ID        # 客户端凭据从环境变量读取
    oauthClientSecretEnv: MCP_CLIENT_SECRET
    oauthTokenTtlMs: 3600000

客户端流程:POST token 端点(grant_type=client_credentials)→ 拿 access_token → 所有 MCP 请求带 Authorization: Bearer <token>。 静态 authTokenEnv 与 OAuth 可并存;均未配置时不鉴权。

安全:设置 authTokenEnv(如 MCP_TOKEN)后,所有请求要求 Authorization: Bearer <token>。协议:零依赖手写实现 MCP Streamable HTTP(2025-03-26),支持 initialize / ping / tools/list / tools/call / resources/list / resources/read / SSE 响应 / GET 事件流 / DELETE 会话 / 服务器主动进度与流式输出通知。

MCP 配置

- id: trio-mcp
  name: dsh-trio/mcp
  config:
    path: /trio/mcp
    authTokenEnv: ""        # 例如 MCP_TOKEN;留空不鉴权
    runAgentTimeoutMs: 300000
    runAgentMaxOutputChars: 120000
    listSessionsLimit: 50

🐙 GitHub 集成

凭证:环境变量或 DSH credentials 里的 GITHUB_TOKEN(细粒度 token 只需 repo 权限)。

Webhook 评审去重:同一 PR 的同一 head commit 只评审一次(reviewDedupe, 默认开启),synchronize 推送新 commit 才会触发新一轮评审。

事件看板:控制台 /trio 的 GitHub 卡片下方实时展示最近 webhook 事件 (时间/类型/仓库/编号/处理结果),数据源 GET /trio/github/events。

Webhook 自动评审

1. 在 GitHub 仓库 Settings → Webhooks 添加:

   • Payload URL:http://<你的机器>:3080/trio/github/webhook

   • Content type:application/json

   • Secret:与 webhookSecretEnv 指向的环境变量一致(如 GITHUB_WEBHOOK_SECRET)

   • Events:勾选 Pull requests

2. 评审模型:默认用 DSH 的默认模型;也可指定:

- id: trio-github
  name: dsh-trio/github
  config:
    tokenEnv: GITHUB_TOKEN
    apiBase: https://api.github.com
    webhookPath: /trio/github/webhook
    webhookSecretEnv: GITHUB_WEBHOOK_SECRET
    reviewModel:
      provider: deepseek
      model: deepseek-chat
    reviewMaxDiffChars: 60000
    autoReviewEvents: [opened, synchronize, reopened]

此后每个非 draft 的 PR 打开/更新时,DSH 会拉取 diff → 调用评审模型 → 以 COMMENT 评审提交到 PR。

Issue 自动修复闭环(webhook → agent 修 → 自动开 PR)

配置 autoFixRepos(仓库 → 本地路径)后,新 issue 会自动触发一个 DSH agent 在本地仓库里修复:fetch → 建 fix/issue-N 分支 → 修复 + 测试 → push → 自动开 PR(Fix #N: 标题,正文 Closes #N)。可选 autoFixLabels 只处理带指定标签的 issue(如 bug):

- id: trio-github
  name: dsh-trio/github
  config:
    ...
    autoFixRepos:
      "owner/repo": C:/path/to/local/repo
    autoFixLabels: [bug, priority-high]   # 空数组 = 所有 issue

前提:仓库 webhook 同时勾选 Issues 事件;本地仓库路径存在且可写; agent 需要能 push(配置好 git 凭据);同一时间只跑一个修复任务。

公网部署提示:webhook 需要能从 GitHub 访问到你的机器,可配合 frp/ngrok/ Cloudflare Tunnel;不要暴露到公网时务必配置 webhook secret。

🦊 GitLab 集成

凭证:环境变量或 DSH credentials 里的 GITLAB_TOKEN(PRIVATE-TOKEN 方式)。

Webhook 自动 MR 评审:仓库 Settings → Webhooks 添加 http://<机器>:3080/trio/gitlab/webhook(Secret Token 与 GITLAB_WEBHOOK_SECRET 一致,事件勾选 Merge Request)。MR 打开/更新时自动 评审并以 note 发布(带 🤖 前缀)。reviewModel 配置与 GitHub 模块相同。

自建 GitLab 实例:改 apiBase(如 https://gitlab.example.com/api/v4)。

🎛️ 控制台

浏览器打开 http://127.0.0.1:3080/trio:

• 浏览器卡:开/关状态、标签数、当前 URL,一键跳转实时画面

• MCP 卡:端点协议版本、工具数量、一键"测试连接"

• GitHub 卡:webhook 端点在线状态 + 配置指引

页面每 5 秒自动刷新,样式与 banner 同源的 anthropic.com 人文简朴风。

开发与测试

npm install          # 安装 playwright-core(本地测试用)
npm test             # 冒烟测试(模块加载 + 工具表 + HMAC 签名)
node test/browser-launch.mjs   # 验证本机浏览器通道可启动

本地热加载调试(无需发布):

dsh --profile web --patch ./e2e.patch.yml --port 3111

发布

npm publish   # 纯 JS 无构建步骤,lib 即源码,无需 prepare 脚本/allowBuilds

发布后记得:

1. 给仓库打 dsh-plugin topic;

2. 给 awesome-dsh-plugin 提 PR 加入精选列表。

路线图

• 浏览器:多标签页、下载、Cookie 登录态、表单自动填充 ✅(0.2.0)

• MCP:dsh_run_agent 流式进度通知 ✅(0.2.0)

• GitHub:PR 行内评论、issue 更新与搜索 ✅(0.2.0)

• /trio 控制台 ✅(0.2.0)

• 浏览器:登录态持久化(userDataDir)、browser_upload 文件上传 ✅(0.3.0)

• MCP:resources/ 支持、dsh_run_agent 模型覆盖参数 ✅(0.3.0)

• GitHub:issue 自动修复闭环(webhook → 子 agent 修 → 开 PR)✅(0.3.0)

• GitLab 支持 ✅(0.3.0)

• 浏览器:多配置文件(工作/个人)、表单保存回放 ✅(0.4.0)

• MCP:OAuth 鉴权(client_credentials + RFC 8414)、流式输出推送 ✅(0.4.0)

• GitHub:webhook 事件看板(控制台内)、评审缓存去重 ✅(0.4.0)

• GitLab:MR 行内评论、webhook 评审 ✅(0.4.0)

• 浏览器:表单值加密存储(敏感字段)、录制回放(动作序列)

• MCP:dsh_run_agent 可取消(progress 上报 + cancel)、会话续跑

• GitHub:webhook 事件持久化(重启保留)、批处理评审队列

• GitLab:issue 自动修复闭环(镜像 GitHub 方案)

License

MIT