前言¶
在 DSH / DeepSeek Harness 的智能体开发中,一个常见问题是:任务散落在 Linear、GitHub Issues、Jira Cloud、Asana、GitLab,或本机任务清单里,而 Harness Web 侧更擅长承载 Agent 运行环境。
dsh-dashboard 是面向 DeepSeek Harness 的 Symphony-compatible 插件,把这些任务源中的任务转换为 Harness Agent 可执行、可跟踪的运行对象。它保留 native Harness 的会话与权限体系,并在 sidebar 中提供 Dashboard 入口。
这是什么¶
dsh-dashboard 是 Uddoo 维护的 multi-provider task orchestrator and dashboard,当前可安装版本为 0.7.0。
它主要做几件事:
- 读取
WORKFLOW.md中定义的工作流 - 从多个任务源读取任务
- 应用调度约束和并发限制
- 为每个任务创建持久工作区
- 通过 native Harness Agents 运行任务
- 对失败运行进行有限次数的指数退避重试
- 在 native Harness sidebar 中增加 Dashboard 入口
核心能力¶
工作流定义¶
插件读取 WORKFLOW.md。该文件包含 YAML frontmatter 和 Liquid prompt。
一个 WORKFLOW.md 只启用一个任务源。
任务源¶
插件支持以下任务来源:
- Linear
- GitHub Issues
- Jira Cloud
- Asana projects
- GitLab project issues
- credential-free local tasks
调度与重试¶
插件应用以下调度约束:
- deterministic priority ordering
- required labels
- global concurrency
- per-state concurrency limits
每次 dispatch 前,插件会重新检查 source state。失败运行使用 bounded exponential backoff 重试。
工作区与会话¶
每个任务拥有一个 persistent workspace。插件会运行可配置的 lifecycle hooks:
after_create
before_run
after_run
before_remove
任务通过 native Harness Agents 运行,并延续同一个 Harness session,直到配置好的 turn limit。
项目目录¶
插件在 Harness storage 中维护 durable Project Catalog。
它将 Project 与 Git Repository 分开建模,避免把“项目”和“代码仓库”混成同一层概念。
本地任务¶
Local source 提供 Linear-style + controls,用于操作本地任务。Local tasks 不需要外部凭证。
凭证边界¶
外部凭证保留在 trusted Host 上。credential values 不会进入 Dashboard RPC payloads,也不会进入 browser state。
安装与启用¶
环境要求¶
安装前确认满足以下条件:
- Node.js
22.19+或24+ - 源码构建需要 pnpm
11.19+ - DeepSeek Harness Web profile
0.1.0-rc.6 - 已有 Harness permission preset;bundled row 使用
workspace-write - 所选远程 provider 需要凭证;Local tasks 不需要凭证
使用 CLI 安装¶
先添加插件,并查看 Web 配置:
dsh plugin --profile web add dsh-dashboard@0.7.0
dsh web --dump-config
然后启动 Web:
dsh web
打开 dsh web 输出的地址,在 native Harness sidebar 中选择 Dashboard。
不使用全局 CLI¶
如果没有安装全局 dsh CLI,可以使用 npx:
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add dsh-dashboard@0.7.0
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web --dump-config
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web
移除插件¶
dsh plugin --profile web remove dsh-dashboard
典型用法¶
一个基本流程如下:
1、确认本地环境满足 Node.js 22.19+ 或 24+。
2、确认 DeepSeek Harness Web profile 为 0.1.0-rc.6。
3、添加 dsh-dashboard@0.7.0。
4、准备所选远程 provider 需要的凭证;如果使用 Local tasks,可以不配置远程凭证。
5、准备 WORKFLOW.md,确保其中包含 YAML frontmatter 和 Liquid prompt。
6、运行以下命令检查配置:
dsh web --dump-config
7、启动 Web:
dsh web
8、打开 dsh web 输出的地址,在 native Harness sidebar 中选择 Dashboard。
经过上面的步骤,插件会按 WORKFLOW.md 启用的任务源读取任务,并通过 native Harness Agents 执行。
适用场景与注意¶
适合以下场景:
- 任务来自 Linear、GitHub Issues、Jira Cloud、Asana 或 GitLab
- 你希望在 DeepSeek Harness 中运行 Agent 任务
- 你需要为每个任务维护持久工作区
- 你需要配置
after_create、before_run、after_run、before_removehooks - 你希望外部凭证不进入浏览器状态或 Dashboard RPC payloads
注意:
- 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
- 当前已核实资料中列出了
LICENSE文件,但未显示许可证名称,使用前应自行确认。 - 一个
WORKFLOW.md只启用一个任务源。 - 远程 provider 需要对应凭证;Local tasks 不需要凭证。
- 插件需要已有 Harness permission preset,bundled row 使用
workspace-write。 - 该仓库在已核实资料中标注为针对 published Harness
0.1.0-rc.6packages 进行编译和测试。
结尾¶
dsh-dashboard 的价值在于把外部任务源、工作区、生命周期 hooks、Agent 会话和 Dashboard 入口放到同一个 DeepSeek Harness 使用场景里。它适合需要把真实任务流接入 DSH 智能体运行环境的开发者。
目录页:
https://www.skillhub.cn/plugins/Uddoo/dsh-dashboard
GitHub:
https://github.com/Uddoo/dsh-dashboard