dsh-trajectory

by ciceroyang

0 会话与消息github未核验到 manifest收录于 08-16

将DeepSeek Harness会话日志渲染为可分享的HTML轨迹文档

Render a DeepSeek Harness session log into a shareable HTML trajectory document

安装

dsh plugin --profile web add github:ciceroyang/dsh-trajectory

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

README

目录

把 DeepSeek Harness 会话日志渲染成可分享的 HTML 轨迹文档——官方 Trajectory 视图的离屏、零依赖版本。"运行有迹可循"的具象化。

用法

node trajectory.mjs <session.jsonl.zstd>
node trajectory.mjs <会话目录>          # 自动选最新日志
node trajectory.mjs <会话目录> --all     # 全部会话合并成一本"轨迹合订"(按时间排序)
node trajectory.mjs <日志> --since 2026-08-11 --until 2026-08-17   # 时间窗口切片(单会话与 --all 合订均支持)
node trajectory.mjs <日志> --out 报告.html

输出:单文件 HTML(内联样式,无外部依赖)+ sha256 前 16 位。

文档内容

  • 会话元信息(session / 工作区 / 时间 / 回合数 / Token 账本)
  • 逐回合时间线:用户诉求、工具调用(含参数摘要与错误标记)、助手输出节选
  • 结束原因标注(completed / blocked / error / …)

技术要点

  • 多帧 zstd 帧扫描 + 逐帧解码(一次性解压只出第一帧的坑,算法移植自官方 format.ts)
  • 零依赖、纯 ESM;HTML 渲染为纯函数,全部可单测
  • 所有输出经 HTML 转义,日志里的恶意文本不会变成脚本

场景

  • 交付审计:把会话轨迹发给接手人/老板,附 sha256 可核
  • 事故复盘:工具错误在时间线上的位置一目了然
  • 分享:不需要对方装 DSH,浏览器打开即看

姊妹工具

  • dsh-report-studio:会话 → 日报/周报/交接文档 + 凭据
  • dsh-plugin-starter / dsh-doctor:插件脚手架 / 环境体检

原始 README: https://github.com/ciceroyang/dsh-trajectory/blob/main/README.zh.md ↗