项目简介
dsh-jailbreak-workflow，对应插件包 @xiaoso/dsh-workflow-lite，是 DeepSeek Harness 的软工作流插件。它允许你在画布上安排任务步骤，再将整个流程编译为一份计划提示词，由当前会话中的模型按照计划执行。
它支持顺序、并行、汇合、条件分支、循环与回退。连线可以携带任意条件，因此不仅适合简单的线性任务，也能表达“审查未通过就返回修改”“满足条件后结束”等复杂逻辑。
插件本身没有执行引擎，也不需要额外的调度服务。步骤调度、条件判断和任务执行均由当前会话中的模型完成。
核心工作原理
一次完整的工作流运行分为三个阶段：
- 设计：在画布上添加步骤，为每一步编写提示词，并通过连线描述执行顺序、分支和循环。
- 编译：插件将画布整理为计划提示词，说明步骤顺序、循环条件、输入资源与预期产出。
- 执行：模型读取计划，自行决定直接完成、派发子代理或组织团队，并把进度同步回画布。
这种设计的重点是把流程表达和模型执行分开：画布负责清晰描述计划，模型负责理解并落实计划。
主要功能
- 画布编辑：拖放步骤和连线，创建通过或不通过分支、循环，并可一键整理布局。
- 资源配置：为步骤指定需要读取或写入的文件、文件夹、网址及 Skill。
- 执行前提问：运行前向用户收集必要信息，再把答案随计划提交给模型。
- 模型协作编辑：直接在对话中让模型创建或修改工作流，修改结果会同步到画布。
- 运行状态：在画布上查看实时进度、单步摘要和状态，并可调整状态后通知模型。
- 版本管理：保存版本、补充说明、比较差异并切换到历史版本。
- 导入导出：将工作流、选定版本、文件和 Skill 打包为
.wflite.zip。 - 导出为 Skill：将版本编译成包含
SKILL.md、任务描述及相关资源的 Skill，可下载或安装到~/.agents/skills。 - 工作流中心：集中管理不同会话的执行记录、工作流、版本、记忆和插件设置。
- 双语与主题：支持中文、英文以及多套浅色和深色主题。
安装前准备
该插件适配 DeepSeek Harness 0.2.0 和 0.2.1，包括相应的预览版本，例如 0.2.1-rc.2。如果使用网页版，还需要安装 Node.js 22 或更高版本。
项目仍处于实验阶段，功能和数据格式可能在后续版本中发生不兼容变化。重要工作流建议及时导出并保留版本。
安装网页版插件
打开终端，将插件添加到 DeepSeek Harness 的 Web profile，然后启动网页端：
dsh plugin --profile web add @xiaoso/dsh-workflow-lite
dsh web启动完成后进入会话页面。如果安装成功，页面顶部会出现“工作流”标签页。
安装桌面端插件
- 在 DeepSeek Harness 侧边栏打开“插件”。
- 选择“添加插件”，然后点击“安装第三方插件”。
- 输入
@xiaoso/dsh-workflow-lite并确认安装。 - 重启 DeepSeek Harness。
- 进入会话页面，确认顶部已经显示“工作流”标签页。
基础用法一：让模型创建工作流
最直接的方法是在对话中用自然语言描述任务步骤和判断条件。例如：
建一个工作流：先写代码，再审查，审查不通过就回去修复，最多三轮。模型会据此创建步骤、连接审查分支并设置循环，画布会同步展示生成结果。运行前应检查以下内容：
- 每个步骤的提示词是否明确。
- “通过”和“不通过”分支是否连接到正确节点。
- 循环是否设置了明确的退出条件或最大次数。
- 输入文件和输出位置是否配置正确。
确认无误后，点击右上角的“执行”，也可以继续在对话中要求模型直接执行该工作流。
基础用法二：手动搭建工作流
- 打开“工作流”标签页并新建工作流。
- 从左侧步骤库拖入所需步骤。
- 为每个步骤填写交给模型的提示词。
- 用连线确定执行顺序，并按需添加条件、分支或循环。
- 为步骤绑定要读取或写入的文件、文件夹、网址或 Skill。
- 点击“执行”，或者在对话中请模型运行当前工作流。
示例：带返工循环的内容流程
可以把一个内容任务拆成“收集资料”“生成初稿”“检查质量”和“修改初稿”四步。质量检查通过时结束；不通过时进入修改步骤，再返回质量检查。由于实际判断由模型完成，检查步骤的提示词应清楚写出通过标准。
检查初稿是否满足以下条件：
1. 结论有资料支持；
2. 结构完整；
3. 没有明显重复；
4. 输出“通过”或“不通过”，并说明理由。对于任何循环流程，最好在提示词或流程条件中加入最大轮数，避免模型持续返工。
跟踪执行进度
打开“工作流设置”，启用“记录运行状态”。之后每次执行都会生成独立记录，画布会随执行进度更新。你可以查看每一步的摘要，也可以调整步骤状态并通知模型。
工作流、版本和各会话的执行记录统一放在画布左上角的“工作流中心”中。需要复查历史运行或切换版本时，应优先从这里操作。
正确使用路径变量
资源路径和产出根目录支持两个变量：{workflow} 与 {instance}。合理使用它们可以避免把机器相关的绝对路径写进工作流。
{workflow}：工作流共享资源目录
该变量可以写在资源的文件或文件夹路径中，例如：
{workflow}/refs/notes.md执行时，它会替换为当前工作流自己的目录，默认位置类似：
~/.dsh/workflow-lite/assets/<工作流名>/这个目录不会随执行工作区变化，工作流改名或导出时也会一起处理，因此适合保存参考资料、模板和工作流长期使用的文件。旧版本中的 {assets}/… 仍可使用，打开工作流时会自动转换为 {workflow}/…。
{instance}：单次运行实例目录
该变量用于“工作流设置”中的产出根目录。默认配置示例为：
.workflow-lite/runs/{instance}/out运行时，{instance} 会替换为本次执行的实例 ID，使每次运行的产出分别存放，适合需要保留和比较多轮结果的任务。
导入现成工作流
项目维护者提供了独立的 dsh-workflows 工作流合集。下载其中的 .wflite.zip 文件后，可在“工作流中心”中导入。
导入包可以包含工作流、指定版本、相关文件和 Skill。插件会在导入前列出各项内容的安装位置，建议确认路径后再继续。
README 中提供的“破甲制作”是一个 15 步研究流水线示例，包含探针测试、拒绝模式分析、定制内容生成、API 验证及文件输出。使用任何此类研究工作流时，应确保目标、数据来源和测试行为符合适用法律、平台规则与授权范围。
画布展示与文件预览
实验性的画布展示功能可以将看板、图片、文档、日志、表格和文件夹直接显示在画布上，并在执行期间自动更新。循环任务每一轮产生的结果也可以回看和比较。
实例资源支持预览 Markdown、HTML 页面、图片和文件夹。HTML 页面还可以作为持续更新的看板；文件夹则使用左右两栏浏览。由于该功能仍处于实验阶段，不应依赖其当前数据格式进行长期兼容设计。
工作流记忆
“记忆”是实验性功能，用于把成功做法和遇到的问题整理为 Skill，供后续执行参考。你可以为某个步骤单独启用记忆，也可以从步骤库的“基础”分组拖入“记忆”节点，让整个工作流共用一份。
一条记忆对应一个 Skill 文件夹，其中的“快速路径”用于记录下一次更省事的执行方式。运行过程中，各步骤将经验写入回复；工作流结束后，再由模型统一整理。
记忆功能的限制
- 多个实例同时修改同一条记忆时没有加锁，后写入的内容会覆盖先写入的内容。
- 重新导出并覆盖安装 Skill，会覆盖已安装 Skill 中累积的记忆。
- 早期重复执行试验尚未观察到稳定提速；加入“快速路径”后的实际效果仍需更多工作流验证。
如果需要更复杂、可控的长期经验管理，README 建议使用“资源”配合提示词自行实现。
进阶实践建议
让步骤提示词可验证
不要只写“检查结果”。应列出判断标准、需要读取的输入、输出格式以及通过和不通过时的动作。模型需要根据这些信息完成条件判断。
为循环设置边界
循环连线可以表达返工逻辑，但最好同时设置最大轮数、停止条件和失败后的处理方式。这样能够减少无限循环或反复修改的风险。
区分共享资源与运行产出
模板、参考资料和长期文件放在 {workflow} 下；每次执行生成的报告、日志和中间结果放在包含 {instance} 的目录下。这样既方便导出，也便于比较多次运行。
重要改动前保存版本
在修改提示词、连线条件或资源路径前先保存版本并添加说明。出现问题时，可以比较版本差异或直接切换回之前的版本。
导出为 Skill 提高可移植性
如果目标环境不安装插件，可以把稳定版本编译成 Skill。导出的内容包括 SKILL.md、各步骤任务描述以及打包的文件和 Skill，可作为独立资源使用。
谨慎使用实验性功能
画布展示和工作流记忆的行为及数据格式都可能变化。对于重要项目，应保留导出包、关键文件及版本说明，不要把唯一副本只放在实验性存储结构中。
总结
dsh-jailbreak-workflow 将复杂任务变成可视化画布，再编译为计划提示词交给 DeepSeek Harness 当前会话中的模型执行。你可以从一个简单的“生成—检查—返工”流程开始，逐步加入资源、路径变量、运行记录、版本管理和 Skill 导出。理解“插件负责编译计划、模型负责实际调度”这一原则，是设计稳定工作流的关键。