前言¶
在 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