dsh-flowtext

dsh-flowtext

English

dsh-flowtext 为 DeepSeek Harness 注册唯一的 flowtext-direct 路由。DSH 只接收用户指令，显示脱敏的精简执行轨迹并记录最终答案；分类、规划、查找、读取、写入、工具执行、追问、审批及收尾全部由 Obsidian FlowText Agent 完成。

本插件不注册 SubagentProvider，不提供 subagent_flowtext，也不安装 tool-subagent-flowtext。

环境要求

• Node.js ^22.19.0 或 >=24
• DeepSeek Harness
• Obsidian 桌面端已启用 FlowText Agent Gateway

安装

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

安装包自带 cordis.patch.yml，只创建一个 Cordis 条目：

- id: flowtext-direct
  name: dsh-flowtext

无需环境变量、复制 Token 或手工编辑 Profile。FlowText 会自动注册每个已打开的仓库；首次向某个仓库提交任务时，FlowText 会显示本机连接确认。允许一次后，DSH 会按仓库分别保存凭据并自动复用。

从 dsh-subagent-flowtext 升级时，请先删除旧包，再安装 dsh-flowtext。旧版按仓库保存的配对凭据会自动迁移，无需重新复制 Token。

运行方式

• 插件固定把 DSH Agent 请求路由到 flowtext-direct。
• 只打开一个 FlowText 仓库时自动选中；同时打开多个仓库时，DSH 模型列表会显示 FlowText Agent · 仓库名，用户在提交前选择目标仓库。
• 每次任务都会携带 Obsidian 官方维护的稳定仓库 ID；FlowText 执行前再次校验，不会因动态端口变化误投到其他仓库。
• 第一个 Gateway 优先使用 127.0.0.1:27124；其他同时打开的仓库自动使用空闲动态端口，无需用户配置。
• 只发送最新一条真实用户消息和 DSH sessionId。
• 不向 FlowText 发送 DSH 系统提示、工具目录、助手历史或插件上下文。
• 相同 DSH sessionId 复用同一个 FlowText 会话；不同 DSH 会话仍独立保存，但会优先复用已打开的空闲 Agent 面板。
• FlowText UI 显示完整执行过程；DSH 通过可折叠的 reasoning 区域实时显示脱敏执行摘要。
• 轨迹不会生成 DSH 工具调用，DSH 不会重复执行 FlowText 工具。
• FlowText 追问通过 DSH 原生问题卡片显示；单选、多选和自由文本回答会结构化回传给原 FlowText 任务。
• FlowText 危险操作使用 DSH 原生审批卡片；远程通道只支持“允许一次”和“拒绝”，不扩大为整个任务授权。
• DSH 追问/审批期间 FlowText UI 保留完整过程与待处理内容，但回答控件为只读，避免两个界面竞态作答。
• 人工等待时间不计入 FlowText Agent 执行超时。
• 适配器禁用 DSH 模型重试，避免包含写操作的任务被重复执行。

配置

安全边界

Gateway 只接受回环地址。仓库发现记录仅包含仓库标识、显示名、路径和动态端口，使用仅当前用户可读的本地文件，不包含 Token。自动配对拒绝浏览器来源并要求用户在 Obsidian 明确允许。凭据按仓库隔离，不会写入 Profile、Obsidian 仓库、Shell 历史或模型上下文。追问和审批直接使用 DSH 的 Agent-scoped 交互通道，不会生成新的 DSH 模型轮次，回答也不会发给 DSH 模型。父请求取消或 DSH 关闭 Run 时，插件会取消对应的 FlowText 任务。

目前只支持文本指令和文本最终答案；图片及结构化输出不会从 DSH 转发。