使用

Web

npx @deepseek-ai/dsh web

打开 http://127.0.0.1:3080，进入一个已有执行记录的任务，然后选择“轨迹可视化”。

命令入口

在任何支持 Harness Commands 的交互界面输入：

/visual-trace
/visual-trace markdown
/visual-trace json

Headless

npx @deepseek-ai/dsh --profile headless "检查项目并运行测试"

插件默认把轨迹写入 stderr，不会破坏 headless 原有的 stdout 最终回答。需要单独保存轨迹时可以重定向 stderr：

npx @deepseek-ai/dsh --profile headless "检查项目并运行测试" 2>visual-trace.txt

ACP、SDK、自定义 UI 与 Hooks

安装插件后，Host 侧 Cordis 插件可以直接使用：

const nodes = ctx.visualTrace.build(session.events, 'zh')
const markdown = ctx.visualTrace.render(session.events, 'markdown', 'zh')
const json = ctx.visualTrace.render(session.events, 'json', 'en')

build() 返回与 Web 时间线一致的标准节点（包括 Code Mode 的嵌套子工具）；render() 可用于终端、协议响应、审计文件或外部可视化界面。

配置

插件默认配置如下：

- id: visual-trace
  name: dsh-visual-trace
  config:
    language: system        # system | zh | en
    headlessOutput: auto    # auto | off | stderr | stdout
    headlessFormat: text    # text | markdown | json

auto 只在官方 headlessStartup 服务出现时启用 stderr 输出，Web 服务不会打印会话轨迹。

dsh-visual-trace

AI 分析

安裝

說明文件

使用

Web

命令入口

Headless

ACP、SDK、自定义 UI 与 Hooks

配置