跳到主内容

dsh-deepseek-flow 使用指南

为 DeepSeek Harness 提供 Markdown 优先的可视化工作流编辑器,画布与文档双向同步,并支持可计算的布尔逻辑门判定。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-deepseek-flow

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add deepseek-flow

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Markdown 是唯一事实来源——一份总控 WORKFLOW.md,每个步骤拥有独立的 STEP.md 工作区。
  • 真正可编辑的流程图——新建、移动、连接、重连、标注和删除流程框与箭头。
  • 双向同步——在画布和 Markdown 编辑器中的修改都会写回工作流文件。
  • 区分来源的拓扑事务——用户在画布上的结构修改走完整的当前 Session 审查;主 Session 直接修改文件产生的拓扑可走不可见的确定性定稿通道,不再把同一修改发回原 Session。
  • 可计算逻辑语义——导出契约包含公式、操作数、谓词和确定性布尔结果,无需运行 Agent 步骤。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是工作流运行器吗?

不是。它只负责编辑、保存与确定性布尔门求值;Agent 步骤与完整工作流执行仍在当前 Session 里进行。

安装后看不到 DeepSeek Flow 标签怎么办?

用 dsh web --dump-config | grep deepseek-flow 确认挂载;不显示则需要完全停止再重启 dsh web(仅刷新浏览器不够)。

AI 整工作流优化写不进去是什么原因?

可能是 Agent 工作期间原文发生变化,或者 Agent 没有返回全部必需文档;请基于最新文件重试。

删除的工作流能找回吗?

插件托管的工作区会移入 ~/.dsh/deepseek-flow/trash/<日期>/ 目录,把目录复制回 workspaces/ 即可恢复文档,flow 定义可用 flow_put 重新导入。

条件框为什么必须用 truthy/falsy/nonEmpty 而不能写自然语言?

逻辑门只做确定性布尔运算;语义判断必须先让上游 Agent 输出 JSON 布尔值,再连到条件框。

什么是有限反馈边?

反馈边是带 maxIterations 与 exitCondition 的回退箭头,用于表达有限重试,不参与单次布尔门求值,也不自动执行步骤。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则