bwndlct/dsh-session-export

简体中文 | English

dsh-session-export

将 DeepSeek Harness（DSH）会话导出为可移植、人类可读的 Markdown 和结构化 JSON 文件。

dsh-session-export 是 DeepSeek Harness 的社区插件。它读取当前会话的事件溯源日志，输出自包含的对话记录文件——可阅读、归档、分享、diff，或喂给另一个 agent——导出格式采用稳定、带版本号的 schema，与 DSH 内部实现解耦。

特性

• 两种入口
  • session_export() 工具 — 随时让模型执行导出
  • /session-export [markdown|json|all] 斜杠命令 — Web UI 中一键触发，零模型 token 消耗
• 忠实还原执行顺序 — 用户消息、助手消息（含推理过程）、工具调用（含解析后的参数）、工具结果（含失败）严格按发生顺序排列
• 稳定的导出 schema — 每个 JSON 文档都带 schemaVersion，为后续演进留出空间
• 健壮设计 — 未知的未来事件类型、缺失元数据、恶意代码围栏、超大工具结果、非文本块均不会导致导出崩溃
• 跨平台安全的文件名 — 处理 Windows 保留名称/字符；已有文件绝不覆盖
• 零运行时依赖 — 仅 TypeScript + Node 内置模块

安装

需要 dsh >= 0.1.0-rc.6。

dsh plugin --profile web add dsh-session-export

然后将包加入 profile 的 package.json 中的 bundles 列表（插件自带 dsh.bundle patch manifest）：

// ~/.dsh/profiles/web/package.json
"dsh": {
  "profile": {
    "bundles": [
      // ...,
      "dsh-session-export"
    ]
  }
}

完成后重启 dsh。如果要从 GitHub 而非 npm 安装：

dsh plugin --profile web add github:<your-org>/dsh-session-export

用法

直接让模型执行：

把当前会话导出成 Markdown
Export this session, json only

或在 Web UI 中直接输入斜杠命令：

/session-export            # 两种格式（默认）
/session-export markdown   # 仅 .md
/session-export json       # 仅 .json
/session-export all        # 两种格式

不想带参数？固定格式别名一个词搞定（UI 命令输入框没有枚举补全，别名最方便）：

/export-md       # 仅 Markdown
/export-json     # 仅 JSON

命令在 UI 命令平面中执行——其输出不会进入模型对话历史。

导出格式

Markdown

可读的对话记录：元数据头部 + 按执行顺序排列的会话内容。工具调用将其（解析后的）参数渲染为 JSON；工具结果渲染为围栏 text 代码块——围栏会自动加宽，确保含 ``` 的结果内容不会撑破代码块。超过 8,000 字符的结果会被截断并标记。

JSON

由本插件定义的稳定文档格式（非 DSH 内部结构转储）：

{
  "schemaVersion": "1.0",
  "session": {
    "id": "session-e6bb6821-…",
    "createdAt": "2026-08-14T09:52:59.798Z",
    "exportedAt": "2026-08-14T09:53:24.300Z",
    "model": "glm-5.3",
    "provider": "zai-coding-cn",
    "cwd": "/private/tmp/dsh-export-verify",
    "asOfSeq": 137,
    "eventCount": 6,
    "omitted": { "contextMessages": 2 }
  },
  "events": [
    { "type": "user_message", "seq": 6, "timestamp": "…", "content": "…" },
    { "type": "assistant_message", "seq": 9, "timestamp": "…", "content": "…", "reasoning": "…", "provider": "…", "model": "…" },
    { "type": "tool_call", "seq": 10, "timestamp": "…", "callId": "…", "tool": "bash", "arguments": { "command": "echo hi" } },
    { "type": "tool_result", "seq": 11, "timestamp": "…", "callId": "…", "tool": "bash", "success": true, "content": "hi\n" },
    { "type": "unknown_event", "seq": 99, "timestamp": "…", "eventType": "future/thing" }
  ]
}

关于保真度的说明：

• tool_call.arguments 在模型输出的原始字符串不是合法 JSON 时保留原样。
• tool_result.error 携带失败调用的内部 { name, code } 标识。
• 推理过程在 DSH 将其记录到助手消息上时才会导出；不会反射或提取任何私密信息。
• 仅用于日志记录的簿记事件（轮次/步骤边界、流式块、todo 快照、请求头、权限预设等）有意跳过；注入的上下文消息（指令、技能、通知）默认省略，计入 session.omitted。
• 压缩替换节点被跳过（按 DSH 对话记录约定，面向人类的记录只投影追加来源事件）；数量记录在 session.omitted.replacedEvents 中。
• 未知的未来事件类型以 unknown_event 条目呈现——绝不崩溃。

示例

Markdown 输出（截短）：

# DSH Session Export

## Metadata

- Session ID: session-e6bb6821-2a4c-40a3-a178-13ea25ccfe4e
- Model: zai-coding-cn / glm-5.3
- Working Directory: /private/tmp/dsh-export-verify
- Exported Events: 6

---

## User

先用 bash 运行 echo verify-2 …

## Assistant

_zai-coding-cn / glm-5.3_

> The user wants me to: …

### Tool Call: `bash`

```json
{
  "command": "echo verify-2"
}
```

### Tool Result — `bash` (ok)

```text
verify-2
```

输出目录

导出文件位于 <会话工作目录>/.dsh/exports/：

.dsh/exports/session-<session-id>-<UTC 时间戳>.md
.dsh/exports/session-<session-id>-<UTC 时间戳>.json

目录自动创建，文件名经 Windows/macOS/Linux 安全处理，重名时追加 -1、-2……而非覆盖。

隐私

**导出文件可能包含敏感数据。**对话记录可能含有你的源代码、工具读取的文件内容、工具参数（路径、命令、查询）、工具结果、API 响应以及绝对文件系统路径。分享前请务必检查——本插件不做任何脱敏处理。

开发

pnpm install
pnpm run typecheck
pnpm run build
pnpm test          # node:test，无额外依赖

代码布局：

src/
  index.ts            # 插件入口：工具 + 斜杠命令
  session-adapter.ts  # DSH 会话 -> 导出 schema（唯一含 DSH 类型的模块）
  schema.ts           # 插件自有导出 schema 类型定义
  markdown.ts         # Markdown 渲染器（纯函数）
  json.ts             # JSON 渲染器（纯函数）
  exporter.ts         # 文件名生成 + 文件写入
test/                 # node:test 套件，覆盖 markdown / json / 文件名

渲染器和 schema 不依赖 DSH，因此导出格式可独立于 DSH Developer Preview API 进行单元测试和演进。

兼容性

• 基于 @deepseek-ai/dsh 0.1.0-rc.6（DSH Developer Preview）构建和验证。
• 使用公开插件接口：@deepseek-ai/dsh-tools 的 ctx.tools.register() / defineTool、@deepseek-ai/dsh-commands 的可选 ctx.commands 服务，以及 @deepseek-ai/dsh-session 的公开 Session 事件日志。不触及任何私有字段，不做核心修改。
• 斜杠命令仅在挂载了 commands 服务的 profile（如 web）中注册；工具在所有 profile 下均可使用，包括 headless。

许可证

MIT