前言¶
在 DeepSeek Harness（DSH）里跑 workflow 时，阶段推进、子代理派生与完成往往分散在会话与引擎事件里。会话顶层卡片能反映一部分运行，但嵌套 workflow（例如在 PTC 或工具链深处发起的）不一定出现在卡片上。若需要一条可回看、可点击子代理的视图，就要额外借助专门的面板插件。
下面介绍社区插件 dsh-workflow-timeline（维护者 ruaruaTon，分类：工作流）：以 ZCode 形态把工作流阶段推进与子代理状态聚合为时间线，并支持历史持久化。
这是什么¶
dsh-workflow-timeline 是面向 DSH 的纯 JS 双文件插件（index.js / client.js），零依赖、无构建步骤。它在宿主侧半订阅 workflow/* 引擎事件，在客户端从 API 快照渲染时间线，把 workflow 的阶段站点、子代理药丸与运行表情集中展示。
许可证为 MIT，当前包版本为 1.0.0（以仓库 package.json 为准）。
核心功能¶
阶段站点时间线¶
宽屏下为横向站点推进，窄屏（宽度小于 640px）切换为纵向列表。站点间连接线随进度由虚变实，并带有 march 行进动画。
表情状态机小脸¶
界面使用 ZCode 风格小脸：间歇眨眼、扫视、跳动，并按运行状态切换表情。
药丸与子代理会话¶
子代理以药丸形式展示；点击可直达其会话（右栏 subagentchat，主会话作兜底）。完成态默认折叠，可点击展开。
入口与阶段配置¶
可通过侧边栏图标、中心面板、右栏页签（guide 菜单条目）进入。每个阶段旁有 ⚙，可配置该阶段使用的模型与并发（继承宿主模型目录）。
历史持久化与嵌套 workflow¶
运行记录写入磁盘，重启 DSH 后仍可回看，包含嵌套 workflow 的运行——这类记录在会话卡片层面往往不可见，但引擎事件会到达本面板，这是与官方会话卡片的一处关键差异。
工作原理（简述）¶
host 半订阅 workflow/start、workflow/phase、workflow/agent-start、workflow/agent-end、workflow/end 等事件，在内存中聚合运行状态并防抖持久化到 ~/.dsh/workflow-timeline-runs.json。client 半从 /api/workflow-timeline/runs 读取快照并渲染时间线。
安装与启用¶
环境要求：DeepSeek Harness >= 0.2.1-rc.2（README 记载在 0.2.1-rc.5 与 0.2.2-rc.1、Windows Desktop 上实测过）。
通过插件市场或 npm 安装时，使用仓库 README 中的命令（请将 <你的profile> 换成实际 profile 名）：
dsh plugin --profile <你的profile> add dsh-workflow-timeline
也可在 DSH 界面选择「插件 → 添加插件」，搜索 dsh-workflow-timeline 安装。安装后重启一次 DSH；侧边栏出现时间线图标即表示加载成功。
典型用法¶
- 按上文完成安装并重启 DSH。
- 从侧边栏时间线图标、中心面板或右栏 guide 页签打开面板。
- 在 DSH 中正常运行 workflow；面板随引擎事件更新阶段与子代理状态。
- 需要调整某阶段模型或并发时，在该阶段点击 ⚙ 进行配置。
- 点击子代理药丸跳转到对应会话；完成后可在时间线中展开已折叠的药丸回看。
若时间线空白，先确认是否已有 workflow 运行记录——可先跑一个 workflow 再查看面板。
适用场景与注意¶
适合谁：经常编排多阶段 workflow、需要观察子代理派生/完成关系，或要回看包含嵌套 workflow 历史的 DSH 用户。
运行权限：插件在当前 DSH 进程权限下运行，会读写用户目录下的持久化文件（如 ~/.dsh/workflow-timeline-runs.json）。安装前建议在社区目录页或 GitHub 查看源码与 MIT 许可证，自行判断是否符合环境策略。
故障排除（来自 README）
- 启动失败弹窗：仅点「Exit」，将 Windows 下
%APPDATA%\@deepseek-ai\dsh-desktop\logs\crash-*.log提交到仓库 issue。 - 修改过
client.js后界面无变化：需再重启一次 DSH（之后可刷新客户端）。 - 时间线仍为空：确认已产生 workflow 运行记录。
社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；生态上 DSH 强调「一切皆插件」，本插件属于其中的工作流可视化类扩展。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/ruaruaTon/dsh-workflow-timeline
- GitHub：https://github.com/ruaruaTon/dsh-workflow-timeline
经过上面的步骤，你可以在 DSH 里用一条时间线对齐 workflow 阶段与子代理状态，并在重启后继续使用历史记录，弥补会话卡片对嵌套 workflow 可见性不足的问题。
