DeepSeek Harness 插件：dsh-flowtext

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在智能體開發中，開發者常需要將 DSH 的任務調度能力與 FlowText 的本地執行環境結合，以利用其 vault 管理和工具調用能力。dsh-flowtext 插件正是爲了解決這一需求而生，它提供了一個橋接層，允許 DSH 直接在 FlowText Agent UI 中運行任務。

插件定位¶

該插件由 ytmaps 維護，屬於「聯網工具」分類。它通過註冊一個 DeepSeek Harness 路由 flowtext-direct，將 DSH 的請求轉發至 FlowText Agent Gateway。FlowText 負責執行具體的分類、規劃、工具調用和文件讀寫，而 DSH 僅負責接收和展示處理後的執行軌跡和最終答案。

核心功能¶

插件主要提供以下能力：

路由註冊：在 DSH 中註冊名爲 flowtext-direct 的路由。
Vault 自動發現：自動發現並選擇已打開的 FlowText vault。
憑證配對：首次任務時請求本地授權，之後自動配對並複用憑證。
安全隔離：Gateway 僅接受 Loopback 端點；DSH 的系統提示、工具目錄等上下文不會轉發至 FlowText；憑證存儲在 DSH 獨立目錄，不進入 Obsidian vault 或模型上下文。
進度模式：支持配置進度顯示模式，控制是否返回中間推理過程。

安裝與啓用¶

安裝前請確保環境滿足要求：安裝了 DeepSeek Harness，Obsidian 桌面版啓用了 FlowText Agent Gateway，且 Node.js 版本爲 ^22.19.0 或 >=24。

執行以下命令安裝插件：

dsh plugin --profile web add github:ytmaps/dsh-flowtext

安裝後，DSH 會自動註冊路由。FlowText 會在啓動時自動列出所有打開的 vault。當 DSH 發送任務時，如果存在多個 vault，用戶需在 UI 中選擇目標（顯示爲 FlowText Agent · Vault name）。

配置項¶

插件支持通過配置文件調整行爲。以下是關鍵配置項說明：

Field	Default	Meaning
`baseUrl`	unset	默認自動發現所有 vault；若需兼容舊版 FlowText，可設置 Loopback Gateway URL
`registryDir`	`~/.flowtext/agent-gateways`	可選的高級發現目錄覆蓋
`autoPair`	`true`	無憑證時自動請求本地授權
`clientName`	`DeepSeek Harness`	FlowText 配對提示中顯示的名稱
`clientId`	`deepseek-harness`	穩定的客戶端身份標識
`progressMode`	`summary`	`summary` 流式傳輸清理後的軌跡；`off` 僅返回最終答案
`requestTimeoutMs`	`30000`	普通 HTTP 超時時間
`longPollMs`	`25000`	Gateway 事件長輪詢時長
`maxResponseBytes`	`2097152`	Gateway 響應大小限制

升級與注意事項¶

如果從舊版 dsh-subagent-flowtext 升級，必須先移除舊包，再安裝新包。現有 vault 的憑證會自動遷移，無需手動複製 token。

需要注意以下幾點：
* 不註冊 SubagentProvider：插件不註冊 SubagentProvider，也不會安裝 tool-subagent-flowtext。
* 功能限制：當前不支持圖像和結構化輸出。
* Gateway 限制：Gateway 僅接受 Loopback 端點，這限制了其跨機器使用的能力。
* 執行控制：在 FlowText UI 中，DSH 擁有的交互控件爲只讀，防止衝突；DSH 禁用模型重試以防止重複寫入任務。

總結¶

dsh-flowtext 插件通過 flowtext-direct 路由，將 DSH 的任務編排能力與 FlowText 的本地執行能力結合。它提供了安全的憑證管理和自動的 vault 發現機制，適合需要在 Obsidian 環境中利用 FlowText 進行本地文件操作的開發者使用。