DSH（DeepSeek Harness）采用插件化架构，社区开发者可以扩展 Web 界面。针对智能体开发中定义可复用工作流的需求，weibaohui/dsh-process 插件将「工艺」（Process，多阶段·多环节的 agent 工作流模板）接入 dsh web。它提供浏览、编辑、校验、导入导出、AI 生成以及可视化表单编辑等功能，并支持 agent 直接调用工具库读取工艺并按阶段推进。
核心功能¶
双库浏览
支持两种工艺库：我的库（默认 ~/.ntd/processes，可写）和内置库（默认 ~/.ntd/bundled/processes，只读）。插件会递归扫描子目录，侧栏入口实时显示「我的 | 内置」计数。根目录配置可通过 dsh settings 服务修改。
详情三视图
工艺详情页提供三个视图：
* 概览：展示元信息、限额、异常触发及诊断清单。
* 结构：以树状展示阶段 → 环节，包含 prompt、执行器、专家、技能、门禁、流转等全字段。
* YAML：带行号和语法着色，支持点击诊断信息跳行高亮。
编辑与校验
* YAML 编辑器：支持行号、300ms 防抖校验。错误阻止保存，警告仅黄标。支持 ⌘/Ctrl+S 保存。
* 乐观锁：若文件被外部修改，保存时会返回 409 冲突，提示「重新加载 / 仍然覆盖」。
* 校验规则：检查语法错误、缺失 name、空 phases、环节 id 重复、无效的 on_gate_fail 或 goto: 引用等；警告未知键、未知专家/技能引用等。
可视化表单编辑
在「✎ 编辑」模式下，可在「表单」和「YAML」视图间切换。表单包含基本信息、限额、阶段、环节、门禁等全字段。修改表单字段会实时同步到 YAML；修改 YAML 也会实时反映到表单。支持级联改名（环节 id 改动自动更新引用）、增删阶段/环节/门禁。
Agent 协作
插件为 agent 提供四个工具：
* process_list：列出我的库工艺。
* process_get：获取工艺详情。
* process_validate：校验工艺。
* process_save：保存工艺。
系统 Prompt 会指导 agent 按工艺分阶段推进，一环节一交付。
按工艺执行
面板顶部切换到「执行」可发起真实运行：
* 驱动：每个环节开启一个全新的 dsh 会话执行指令。
* 门禁：独立评审会话对照分数线打分，未通过可按配置返工或跳过。
* 看板：展示运行列表、阶段分组、环节卡（尝试次数、返工计数、Token 用量、实时输出）。
* Token 统计：宿主按会话上报 usage，累加计算环节消耗。
* 产物收集：记录文件写操作（write/edit）的 diff 变更统计与文本，支持双视图查看。
安装与启用¶
使用官方插件命令安装：
dsh plugin --profile web add @weibaohui/dsh-process
安装完成后，重启 dsh web 并刷新页面。侧栏「新会话」下方会出现「工艺」入口。插件默认读写 ~/.ntd 下的工艺目录，无需额外配置。
典型用法¶
- 浏览：点击侧栏「工艺」打开全屏工艺库，左列选择工艺，右侧在概览、结构、YAML 三个 Tab 间切换查看。
- 编辑：点击「✎ 编辑」，可使用 YAML 编辑器边写边校验，或切换到表单模式进行可视化编辑。内置库条目显示「⧉ 复制到我的库」。
- 管理：使用「+ 新建 ▾」创建空白工艺（带注释骨架）或从内置库复制；使用「⬆ 导入」拖拽多文件，或「⬇ 导出」下载单文件或全库 ZIP。
- AI 生成：在工艺详情页点击「⚡ AI 生成」，输入需求与复杂度，AI 产出 YAML 后校验、预览并写入我的库。
- 执行：在任意会话中，让 agent 执行任务，例如
按工艺 lightweight-task 执行这个需求或用 process_save 把这套流程存成工艺。
数据与安全¶
- 数据源：工艺文件即数据源，无独立数据库。所有写操作仅限我的库，内置库一律 403。
- 路径白名单：拒绝
..、绝对路径及点目录，确保文件操作安全。 - 乐观锁与冲突：外部编辑器修改文件会导致 409 错误，需手动选择重新加载或覆盖。
- 执行隔离：执行时每个环节开启全新 dsh 会话，保证执行环境独立。
适用场景¶
适合需要在 DSH Web 中定义、复用和运行复杂 agent 工作流的开发者。它将 YAML 配置与可视化操作结合，并通过工具接口让 agent 自主调用工艺，降低工作流管理成本。
