快速判断

安装前先看这几项

配置资料: 配置资料完整
配置难度: 中等
适合新手: 可以尝试
兼容状态: 声明兼容，尚未实测
验证状态: 源码已审阅，未标记运行实测

本页目录（9）

中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 dsh-task-graph 安装与配置教程 →

功能

这个插件能做什么

把单个 DSH 任务的 Turn、Agent、Skill、Tool、子任务、代码改动、测试、失败和重试整理为交互式执行图谱。

适合谁

需要多 Agent、工作流、编排能力的用户。

准备

安装前准备

Node.js 22.15+（必需）：需要内置 zstd 解码支持以读取会话日志。
受保护的 DSH Web（必需）：图谱会显示提示词、工具参数、路径、错误和会话事件。

安装

如何安装 dsh-task-graph

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:KevinZhangNothing/dsh-task-graph#7c230e0fe0af

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:KevinZhangNothing/dsh-task-graph#7c230e0fe0af
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-task-graph或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-task-graph

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

$DSH_HOME/sessions: 默认只读会话来源；不要指向不应由当前 Web 用户查看的 DSH_HOME。

环境变量

DSH_HOME · 可选: 覆盖会话根目录；相对路径按启动目录解析。

Bundle 自动插入的只读图谱行 · yaml。示例中的账号、路径和凭据占位符必须替换，不要提交真实密钥。

复制 Bundle 自动插入的只读图谱行配置

- insert:
    - id: task-graph
      name: dsh-task-graph

核对配置证据（外部链接，在新标签页打开）

重启 DSH Web，确认对话与轨迹旁出现图谱标签。
先用不含敏感输入的测试会话核对任务、节点和详情。

验证

配置检查与成功结果

01
打开测试任务图谱并切换关键节点、时间线与轨迹。
期望结果：节点与会话事件对应，详情只来自当前选择的会话。
02
执行一个含子 Agent 的只读测试任务。
期望结果：主任务可下钻到子任务，失败和重试状态可区分。

使用

第一次使用建议这样验证

让主 Agent 派两个只读子任务，再用图谱查看派发、并行执行和结果汇总。

权限

它可能接触哪些数据和能力

控制浏览器访问外部网络

只读扫描 DSH_HOME 下的完整会话轨迹，向同源 Web 客户端提供任务、事件明细和 SSE；事件可能包含提示词、工具参数、文件路径、输出或错误

数据存储：插件只读 DSH_HOME/sessions 并在进程内缓存最多一部分已解析会话；未发现独立持久化数据库。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

图谱为空: 检查 Node.js 是否支持 zstd、DSH_HOME 是否指向实际会话目录，并确认会话文件存在。
不应展示敏感内容: 立即停止暴露 Web，收紧访问控制；插件会读取完整会话事件，不能靠界面折叠隐藏。

卸载后的清理步骤

从 web Profile 移除插件并重启，确认图谱标签和 /task-graph 路由消失。
无需删除会话日志；它们属于 DSH，而不是本插件。

深入审计：兼容性、数据流与来源

证据

兼容性与审阅记录

兼容性说明

0.1.0 声明 DSH >=0.1.1-rc.1，服务端要求 Node.js >=22.15 解码 zstd；未显式声明 0.1.2-alpha.1，52DSH 未加载 Web 插件或验证真实会话

数据流

DSH_HOME/sessions 中的 zstd 会话日志 → 本机解码、缓存和图谱分析 → /task-graph/api 只读路由与 SSE → 浏览器图谱、详情和轨迹面板。

源码审阅结论

已审阅会话发现、zstd 解码、缓存、只读路由、事件查询和客户端实时请求。路由拒绝非 GET/HEAD 且会话引用由已发现目录匹配，未看到任意文件路径入口；但完整事件接口会把会话中的敏感工具输入输出交给同源页面，使用前应保护 DSH Web 访问边界。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：KevinZhangNothing/dsh-task-graph（外部链接，在新标签页打开）
来源登记表: GitHub dsh-plugin Topic（外部链接，在新标签页打开）
来源快照: GitHub Topic 采集记录
固定提交: 7c230e0fe0af
许可证: MIT
主要语言: JavaScript
中文资料: 有完整中文配置资料

查看开放注册表记录我是插件作者：认领或更新发现错误：提交纠正

dsh-task-graph