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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则