Skip to main content

dsh-deepseek-flow

49Stars4Forks1Issues1Watchers

Provides a Markdown-first visual workflow editor for DeepSeek Harness, with bidirectional sync between canvas and document, and supports computable boolean logic gate evaluation.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
MIT
Branch
main
ai-workflowdark-modedeepseek-harnessdeveloper-toolsdsh-pluginflow-editormarkdownvisual-workflow

Install

cmdweb profile
$ dsh plugin --profile web add deepseek-flow

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin kanghelyu/dsh-deepseek-flow for me: review the repository at https://github.com/kanghelyu/dsh-deepseek-flow first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Summary

DeepSeek Flow is a visual workflow editor for the DeepSeek Harness web client that transforms a single WORKFLOW.md and individual STEP.md files into editable flowcharts, with bidirectional sync between canvas and Markdown. The plugin handles editing, saving, and deterministic boolean gate evaluation only—it does not execute Agent steps, which are still completed within the current Session.

Core Features

  • Render WORKFLOW.md control documents and each step's STEP.md workspace as editable visual flowcharts
  • Bidirectional sync between canvas and Markdown—adding, moving, connecting, or deleting nodes or arrows writes back to workflow files
  • Provide eight types of logic gates (IF/ELSE, AND, OR, NOT, NAND, NOR, XOR, XNOR) with deterministic boolean evaluation; results don't depend on running Agents
  • Create, import, read, and delete workflows through Agent tools: flow_create / flow_put / flow_list / flow_read / flow_evaluate / flow_finalize_canvas / flow_delete
  • Isolate workflows by Session; switching Sessions copies as an independent copy of the current Session; support shared templates
  • Manual logic validation, single-document AI optimization, and full workflow AI optimization; results and unapplied drafts are persisted to disk; switching views or restarting won't lose data

Technical Implementation

  • Language: JavaScript (ES Module, TypeScript style), client uses React 18 + native SVG canvas
  • Key Dependencies: @deepseek-ai/dsh-typert-protocol, @deepseek-ai/dsh-tools (peer), zod; dev dependencies include @deepseek-ai/cordis and several internal @deepseek-ai/dsh-* packages
  • Architecture Pattern: Host/Client separation; Host registers Remote services dflow/* and Cordis tools in apply(ctx, config), Client injects conversation.view slot to render the editor; package includes SKILL.md for runtime reactive Skill registration
  • Entry Points: Host entry lib/index.js, Client entry src/client/entry.js (build output is lib/client.js), dispatcher entry cordis.patch.yml

Use Cases

Use this plugin when users want to organize multi-step tasks (e.g., "Find papers → Read papers → Generate summary → Define terms") as visual flowcharts and have the Agent execute them node by node within the Harness Session. It's also suitable for scenarios where existing Markdown workflow structures need to be structured, branch conditions or finite retries added, and the Agent maintains bidirectional synchronization between canvas and documents.

Prerequisites & Compatibility

DependencyMin VersionDescription
DSH0.1.0-rc.6All dsh-* packages in peerDependencies and devDependencies are ^0.1.0-rc.6
@deepseek-ai/dsh-typert-protocol^0.1.0-rc.6Runtime dependency for Remote services
@deepseek-ai/dsh-tools^0.1.0-rc.6Peer dependency for Agent tool registration
PlatformCross-platformPlugin itself is OS-agnostic; DSH Web profile runs on macOS/Windows/Linux
Native ModulesNoneNo native dependencies declared; only uses Node built-ins like node:fs/promises, node:os, node:crypto

Installation

dsh plugin --profile web add github:kanghelyu/dsh-deepseek-flow

Configuration Options

This plugin exposes the following fields through injection configuration in cordis.patch.yml; descriptions are in plain language:

ConfigTypeDescriptionDefault
dataDirStringPlugin data directory for workflow files, UI state, AI Assist results, and trashDefaults to $DSH_HOME/deepseek-flow when unset, or ~/.dsh/deepseek-flow if DSH_HOME is not set
assistantProviderStringModel provider identifier for AI Assistant; empty follows SessionUnset (follows Session)
assistantModelStringModel used by AI Assistant; empty follows SessionUnset (follows Session)
assistantTimeoutMsNumber (ms)Assistant sub-agent timeout, valid range 10000–600000; truncates if > 600000600000 (10 minutes)
assistResultTtlMsNumber (ms)AI Assistant result retention duration; permanent until explicitly discarded if not setUnset (permanent retention)

FAQ

Q: Is this plugin a workflow runner?

A: No. DeepSeek Flow only handles editing, saving, and deterministic boolean gate evaluation; Agent steps and full workflow execution are still completed by the Agent within the current Harness Session.

Q: What to do if DeepSeek Flow tab doesn't appear after installation?

A: First confirm the plugin is mounted with dsh web --dump-config | grep deepseek-flow. If already mounted but dropdown is empty, fully stop and restart dsh web (refreshing the browser alone is insufficient because the Typert routing table is snapshot at process startup).

Q: Why can't AI full workflow optimization write in?

A: Usually the original text changed during Agent execution, or the Agent didn't return all required documents. The optimizer compares against the original revision and refuses to overwrite if changes are detected; have the Agent regenerate based on the latest files.

Q: Can deleted workflows be recovered?

A: Yes. The plugin's managed workspace is moved to ~/.dsh/deepseek-flow/trash/<date>/ directory; copy the entire workspace directory back to workspaces/ to recover documents; the flow definition itself can be re-imported via flow_put using exported JSON.

Q: Why must condition boxes use truthy/falsy/nonEmpty instead of natural language?

A: Logic gates only perform deterministic boolean operations and don't understand semantics. For semantic judgments, add an Agent step upstream of the condition box that outputs JSON boolean true or false, then connect to a condition box with predicate: "truthy".

Q: What are finite feedback edges? When to use them?

A: Feedback edges are fallback arrows with maxIterations (positive integer 1–1000) and non-empty exitCondition, used to express finite retries; they don't participate in single boolean gate evaluation and don't auto-execute steps. Regular execution arrows must be acyclic; retries require feedback edges.

Q: Studio keeps showing "Apply Changes" after directly editing files?

A: Wait a few seconds for Studio to automatically press the hidden finalize action via file source fallback, or have the Agent call flow_finalize_canvas (passing workflow id and current revision) to explicitly trigger deterministic finalization, bypassing main Session re-review.

Getting Started Difficulty

Beginner — After installation, just have the Agent say "build a workflow" in natural language to generate the first flowchart; regular users can use it without reading the README; advanced configuration (finite feedback edges, cross-Session switching, AI optimization) requires consulting documentation.

Known Issues & Limitations

  • Modifying Host code or adding new Remote methods requires a full restart of dsh web; refreshing the browser or hard refresh won't make new /api/dflow/* endpoints effective (CHANGELOG.md:5-45, README.md:230)
  • Version 0.3.21 had a critical issue where duplicate @deepseek-ai/dsh-tools副本 caused all DSH tool calls to fail; current version fixes this by moving it to peerDependencies and bridging TOOL_RUNTIME_SCHEDULER at runtime (CHANGELOG.md:78-82, lib/index.js:967-978)
  • Orphaned flows in old harness-flow data directory are automatically migrated as shared templates on first startup (excluding starter-flow example); migration is one-time and doesn't rewrite (lib/index.js:1054-1073)
  • applyChanges only accepts loops with explicit finite feedback edges; cyclic regular execution arrows are rejected by validation; IF/ELSE outgoing lines must each have only one, NOT allows only one (lib/flow-validation.js:78-85, lib/graph-analysis.js:76-96)
  • flow_finalize_canvas expires if not consumed by Studio within 30 minutes of queuing; needs re-calling (lib/index.js:44, lib/index.js:914-923)
  • Plugin doesn't handle workflow execution, API Key / credential management, scheduled tasks, webhooks, or execution history; this is a product boundary, see README.zh-CN.md Feature Boundary chapter for details

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/kanghelyu/dsh-deepseek-flow)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory