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

快速上手

dsh_workflow

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:icetomoyo/dsh_workflow

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

— 源: plugins.install

关键要点

• id: dsh-external-workflow
• workflow_list：发现 built-in、pattern、项目和个人 workflow；无效条目会报告但不会执行。
• run_workflow：运行命名 workflow、从自然语言 scout-then-author，或执行受限 inline workflow。
• workflow_manage：查看、暂停、恢复、停止、重跑、续跑、保存、改名、修订、删除和清理。
• 版本化 dsh.workflow v1 capsule：manifest、source、intent、inputs、requires、provenance。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件和 DSH 自带的 workflow 工具有什么区别？

原生 workflow 工具适合一次性的前台并行任务；本插件是更高一层的流程产品层，支持命名保存、复用、暂停/恢复、按快照重跑、续跑、审计证据与成本记录。它通过 Cordis bundle patch 注入，与原生工具共存而不替换。

安装后需要手动配置吗？

可开箱即用。所有配置都有默认值（见 CONFIGURATION.md），常见调整是改审批模式、并发上限、模型层路由或扩展只读工具白名单。

生成的脚本能访问宿主机吗？

默认不能。生成型脚本跑在 QuickJS WebAssembly 隔离堆中，只通过 JSON 能力桥调用宿主；导入、process、文件、shell、网络、计时器与非 JSON 值会被静态 policy 拒绝。可信本地 .ts 仍具有宿主权限，需显式 approvalMode 控制。

如何运行内置的代码评审？

在会话中输入 /workflow review 即可自动捕获当前 Git 范围（默认对比 main/master/develop，缺省回退未提交变更），并启动 scoped-review 内置流程；可用 --risk、--requirement、--test-evidence、--wait 等参数控制行为。

workflow 会暴露给模型调用吗？

是。插件注册了三个 DSH 工具：workflow_list（发现）、run_workflow（运行/生成/内联）、workflow_manage（生命周期管理）。模型在合适场景会自动调用，而不是仅靠用户手动 /workflow 命令。

持久化数据存在哪里？

默认写入 .dsh/workflow-runs/<run-id>/ 目录，包含 run.json、events.jsonl、不可变 workflow.workflow.json 快照、results/（effect cache）与 artifacts/。保存的命名 workflow 在项目的 .dsh/workflows/ 或个人 $DSH_HOME/workflows/。

卸载会不会留下数据？

命令与工具会停止注册，但已经写入项目的 .dsh/workflow-runs/ 与 .dsh/workflows/ 目录仍保留。可用 /workflow prune 或直接删除目录清理。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.0.1-rc.2
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则