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 进行本地文件操作的开发者使用。