DeepSHPlugins
dsh-session-export 项目预览
GITHUB / COMMUNITY PROJECT

dsh-session-export

会话与消息JavaScript

会话导出为 Markdown/JSON,便于复盘、重放与单会话成本汇总。

4 Starsyangyongzhen 更新时间 2026-08-14
访问 GitHub 仓库
dsh-session-export 项目预览

项目介绍

中文

会话导出为 Markdown/JSON,便于复盘、重放与单会话成本汇总。

English

Export sessions to Markdown/JSON for review, replay, and per-session cost summaries.

项目信息与收录信号

快照 2026-09-11
作者 / 组织
yangyongzhen
仓库
yangyongzhen/dsh-session-export
GitHub Stars
4
Forks
0
开发语言
JavaScript
许可证
未记录
最近推送
2026-08-14
Manifest
数据中检测到声明

公开仓库不自动等于可商用;许可证与当前兼容性以原项目文档为准。Manifest 和数据评分不构成安装安全认证。

数据评分

57/ 100
维护活跃
81
文档与实用信息
78
生态关注度
20
安装便捷信号
100
项目声明信号
80

关注度尚低(4);标准命令一键安装。

评分来自已有数据快照的五维模型,仅作浏览参考,不是实际使用评测或安全检测结论。

安装与使用

所有项目资料与许可均以对应 GitHub 仓库为准。

dsh plugin --profile web add github:yangyongzhen/dsh-session-export

复制命令不会自动执行。请先阅读仓库文档,确认环境要求与许可证。

项目截图

仓库 README

GitHub 原文

已保存的仓库文档快照;文档抓取时间未记录,可能与上方目录介绍处于不同版本。安装前请核对当前仓库说明。

dsh-session-export

DeepSeek Harness 会话导出与复盘插件:把 agent 会话自动导出为 Markdown 文件,供复盘、写博客、审计使用。

  • 监听 session/event 事件流,turn 结束并静默 debounceMs 后自动导出
  • 输出 $DSH_HOME/exports/session-<id>.md(默认 ~/.dsh/exports/)
  • 进程退出(含 headless 一次性任务)时同步 flush 未导出的会话,不丢记录
  • 渲染纯函数模块化导出,其他插件可复用

安装

# 本地 checkout 安装(推荐,免构建)
dsh plugin --profile <web|tui|headless> add file:/path/to/dsh-session-export

# 或从 Git 仓库直接安装
dsh plugin --profile <web|tui|headless> add https://gitcode.com/qq8864/dsh-session-export.git

配置

通过 profile 的 cordis.patch.yml 或 --patch overlay 覆盖:

- id: session-export
  config:
    enabled: true            # 总开关,false 关闭自动导出
    outDir: ~/exports        # 导出目录,默认 $DSH_HOME/exports
    debounceMs: 1000         # turn/end 后的静默等待(毫秒)
    maxResultChars: 2000     # 工具参数/结果的截断长度
    includeInjected: false   # true 时包含注入消息(上下文快照、skill 目录等)

导出内容

# 会话导出
- 会话 ID / 创建时间 / 工作目录 / Agent 预设 / 导出时间
- 模型(provider/model)与统计:turn/step/工具调用次数、token 消耗(含缓存读写)、耗时

## Turn N / Step N.t      回合与步骤结构
### 用户 / 目标            直接提示词与目标延续(注入消息默认过滤)
#### 工具调用:name        工具名 + 参数 JSON
#### 工具结果              返回内容(截断)
### 助手                   模型文本 + 该步 token 明细
> Turn N 结束:完成        回合结束原因(完成/出错/被中断/达到上限…)
## 错误记录                全部回合错误汇总

作为库使用

渲染管线独立于运行时,其他插件可直接复用:

import { renderSessionMarkdown, summarizeStats } from 'dsh-session-export';
// 或按包路径导入:dsh-session-export 的 lib/markdown.js

const md = renderSessionMarkdown(session.events, { sessionId: session.id }, 2000, false);

开发

pnpm install
pnpm run build        # tsc -> lib/

验证

  • dsh --profile <name> --dump-config 确认插件进入配置树
  • headless 冒烟:dsh --profile headless "一句话介绍你自己" 后检查 $DSH_HOME/exports/

使用前核对

安装步骤、兼容版本与授权范围以原项目当前文档为准。Stars 和评分是快照中的导航信号。

安装与排错 · 项目问题反馈

同类项目