前言¶

在 DeepSeek Harness（DSH）裏讓 Agent 執行多步任務時，工作流往往散落在對話記錄或零散文件裏：步驟邊界不清、分支條件難以覈對、改一處要翻多處 Markdown。純文本能版本管理，但拓撲關係不直觀；純畫布又容易和源文件脫節。

DeepSeek Flow（kanghelyu/dsh-deepseek-flow）是面向 DSH Web UI 的可視化、Markdown 優先的工作流編輯器。它以 WORKFLOW.md 與各步驟 STEP.md 爲單一事實來源，在 Harness 裏提供可編輯的流程圖，並與 Markdown 雙向同步。插件有意只做編輯器，不做工作流運行時；設計、檢查、改進流程在 Studio 完成，實際執行仍由當前 Session 的 Agent 承擔。

這是什麼¶

DeepSeek Flow 由 kanghelyu 維護，MIT 許可證，npm 包名 deepseek-flow，當前版本 0.4.2。項目在 GitHub 約有 50 stars、4 forks。官方站點：deepseekflow.kanghelyu.org。

一句話定位：把 WORKFLOW.md 及步驟級 STEP.md 轉成 Harness 內可編輯的流程圖；內置 Skill 讓當前 Session 通過工具創建和維護工作流，畫布與 Markdown 保持同步且可移植。

核心功能¶

下面按 README 與 package.json 已覈實的能力歸納。

Markdown 爲源、畫布可編輯¶

• 主文檔 WORKFLOW.md，每個步驟一個目錄，內含 STEP.md。
• 在畫布上創建、移動、連接、重連、標註、刪除節點與箭頭。
• 畫布與 Markdown 編輯器雙向同步，修改寫回工作流文件。

典型目錄結構如下：

my-workflow/
├── WORKFLOW.md
├── 01-input/
│   └── STEP.md
├── 02-research/
│   └── STEP.md
├── 03-quality-check/
│   └── STEP.md
└── 04-output/
    └── STEP.md

拓撲變更與審查語義¶

• 人在畫布上改拓撲：校驗圖結構後，由當前 Session Agent 審查，再原子保存新版本。
• Agent 或直接改文件驅動的拓撲：可走確定性 finalize 路徑，避免同一 Session 重複審查；Agent 應調用 flow_finalize_canvas，若未調用，Studio 會檢測無畫布編輯事件並自動執行同等 finalize。

可執行門語義與 Agent 工具¶

導出的契約包含公式、操作數、謂詞及確定性布爾結果，無需運行 Agent 步驟即可評估門邏輯。插件隨附 Agent Skill，文檔覆蓋各工作流工具，並含可執行的 IF/ELSE 與布爾門示例。

Session 隔離、導航與持久化¶

• 每個 Harness Session 維護獨立工作流，可選共享模板；工具欄可刪除當前工作流或共享模板（需確認，託管工作區進回收站可恢復）。
• 側欄可摺疊、可調整大小；支持平移、縮放、適應視圖、節點聚焦動畫；大圖拖拽在指針釋放時提交，後臺輪詢輕量修訂。
• 界面跟隨 Harness 明暗主題與 WebUI 語言。
• 邏輯校驗結果、AI 提案、未應用畫布草稿持久化到磁盤；切換文檔、Session 或重啓 dsh web 不丟失，僅顯式丟棄或成功提交後清除。
• 未變更文檔不重寫；後臺輪詢可取消；子 Agent 默認超時 10 分鐘。

手動與後臺 AI 輔助¶

可在界面觸發邏輯校驗、單文檔優化（帶審查）或完整工作流優化。切換文檔、視圖或 Session 不中斷已接受的後臺任務；返回時恢復文檔提案。

安裝與啓用¶

插件通過 DSH 的 Web profile 從 GitHub 安裝。安裝後需重啓 dsh web，在 Session 中選擇 DeepSeek Flow 標籤頁。

dsh plugin --profile web add "github:kanghelyu/dsh-deepseek-flow#main"

確認插件已掛載：

dsh web --dump-config | grep deepseek-flow

說明：DSH 生態奉行「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。安裝前請自行查看源碼與 MIT 許可證；插件以當前 dsh 進程權限運行。

典型用法¶

第一個工作流¶

1. 在 Session 中讓 Agent build a workflow 或 import a workflow；內置 deepseek-flow Skill 會引導使用 flow_create 或 flow_put。
2. 打開 DeepSeek Flow，插件會腳手架主文檔、步驟文檔與視覺佈局。
3. 讓 Session Agent 改工作流文件，或在 Studio 裏選中文檔直接編輯 Markdown。
4. 經 Session/文件驅動的拓撲更新由 finalize 路徑完成，無需再次主 Session 審查。
5. 若在畫布上增刪改連節點，點擊 Apply changes：校驗 → Agent 審查 → 再校驗 → 原子保存。
6. 需要執行時回到 Session，由 Agent 按工作流運行。

跨 Session 與活動工作流¶

Studio 工具欄下拉列表按來源分組：當前 Session、其他 Session、共享模板。切換到其他 Session 的工作流時，會將該工作區的文檔副本導入當前 Session（外部自定義 docRoot 僅引用不復制）；共享模板切換時也會複製到當前 Session 託管空間，避免污染共享原件。每個 Session 在 sessions/<id>.json 持久化 activeFlowId，重開 Studio 自動選中上次工作流。

適用場景與注意¶

適合誰

• 需要在 DSH 裏設計、審查、迭代多步 Agent 工作流，且希望 Markdown 可版本管理、可移植的開發者。
• 需要可視化覈對分支與布爾門邏輯，又不想把執行引擎綁死在編輯器裏的團隊。
• 已通過對話讓 Agent 建流程，但希望用畫布與文件雙向編輯統一維護的場景。

務必注意

• 這是編輯器，不是運行時；執行仍在當前 Session。
• 人改畫布拓撲會觸發 Agent 審查；改文件則應配合 flow_finalize_canvas 或依賴 Studio 自動 finalize。
• 安裝插件即授予其與 dsh 相同的文件與網絡訪問能力，請從可信源安裝並閱讀源碼。

小結¶

DeepSeek Flow 把 WORKFLOW.md / STEP.md 與 Harness 內可編輯流程圖綁在一起：Markdown 便攜、畫布直觀、拓撲變更有明確審查或 finalize 路徑，並附帶完整 Agent 工具與 Skill。若你已在用 DSH Web UI 編排多步任務，可從目錄頁或 GitHub 查看文檔與示例，按官方命令安裝後在 Session 中創建第一個工作流。

• 目錄頁：https://www.skillhub.cn/plugins/kanghelyu/dsh-deepseek-flow
• GitHub：https://github.com/kanghelyu/dsh-deepseek-flow