deepseek-flow

<h1 align="center">DeepSeek Flow</h1> <p align="center"><strong>See the workflow. Keep Markdown portable. Review only real canvas edits.</strong></p> <p align="center">A visual, Markdown-first workflow editor built for the DeepSeek Harness Web UI.</p> <p align="center"><a href="https://deepseekflow.kanghelyu.org/">🌐 Official website — deepseekflow.kanghelyu.org</a></p> <p align="center"><strong>English</strong> · <a href="README.zh-CN.md">简体中文</a></p>

DeepSeek Flow turns a WORKFLOW.md and its step-level STEP.md files into an editable diagram inside DeepSeek Harness. The bundled Skill lets the current Session create and maintain workflows through tools, while the diagram and Markdown remain synchronized and portable.

It is intentionally an editor—not a workflow runtime. DeepSeek Flow helps you design, inspect, and improve a workflow; execution remains in the current Session.

What it gives you

• Markdown as the source of truth — one master WORKFLOW.md, plus one STEP.md workspace for each step.
• A real visual editor — create, move, connect, reconnect, label, and delete nodes and arrows.
• Two-way synchronization — edits made on the canvas and in the Markdown editor are written back to the workflow files.
• Source-aware topology transactions — human canvas edits receive a full current-Session review; topology produced by direct Session file edits can use an invisible deterministic finalize path instead of being sent back to the same Session.
• Executable gate semantics — the exported contract includes formulas, operands, predicates, and deterministic Boolean results without running Agent steps.
• Per-session isolation — each Harness session keeps its own workflows, with optional shared templates; the canvas toolbar can delete the current workflow or shared template behind a guarded confirm (managed workspaces move to a trash area and can be recovered).
• Comfortable large-flow navigation — collapsible and resizable side panels, pan and zoom, fit-to-view, animated node focus, and independent scrolling regions; node drags commit once on pointer release and background sync polls lightweight revisions, so large graphs stay smooth.
• Native theme support — the interface follows Harness light and dark themes and the active WebUI language.
• Manual AI assistance — run logic validation, optimize one document with review, or optimize the complete workflow.
• Background AI jobs — switching documents, views, or sessions does not interrupt accepted jobs; document proposals are restored when you return.
• Persistent results and drafts — logic-validation findings, AI proposals, and unapplied canvas drafts are persisted to disk: view switches, session switches, and dsh web restarts lose nothing; they are cleared only by an explicit discard or a successful commit. Markdown edits inside the 650 ms autosave window are flushed immediately when you leave the view.
• I/O and memory safeguards — unchanged documents are never rewritten (autosaves no longer grind the SSD), assist history and drafts live in separate files, result polling uses single-key queries with failure and duration caps, every background poll is cancellable with no leaks, and subagents get a 10-minute default timeout.
• A bundled Agent Skill — installs with the plugin, documents every workflow tool, and includes executable IF/ELSE and Boolean-gate examples.

Quick start

Install from GitHub into the Web profile:

…