dsh-session-export

DSH PLUGIN记忆与知识

仓库 cnhenaihui/dsh-session-export · npm @cnhenaihui/dsh-session-export

记忆与知识 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件
安装这个插件

DSH 会话导出插件,把会话连同整棵子代理编队冻结成同一快照,导出可读摘要与完整原始存档两份 Markdown。

一句话选型结论

按资料字段整理

dsh-session-export 是记忆与知识类的 DSH 可安装插件,未做沙盒验证,暂无安全审查结论,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-10-29
README 9.4 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:cnhenaihui/dsh-session-export
  1. 1
    确认版本与运行环境

    Node.js 要求 >=20.0.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求>=20.0.0来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名@cnhenaihui/dsh-session-export可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-session-export:DeepSeek Harness 的会话编队 Markdown 导出插件

  • 导出摘要与原始存档两份 Markdown
  • 按编队树合并全局时间线
  • 按钮、工具、命令三种入口
  • 敏感信息脱敏与结果折叠
  • 只读导出,不污染会话日志

上游标签

cordisdeepseek-harnessdshdsh-pluginexportsession

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-export当前 未做沙盒验证 未标注 0 未标注 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方cnhenaihui仓库 dsh-session-export · 默认分支 main
分类记忆与知识memory
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-29 · 2026-11-11最后推送 2026-11-12
本站收录2026-11-11首次进入本站目录的时间

README 全文

9.4 KB
作者原文,中文版优先;只做安全转义,不改内容

会话导出为 Markdown(dsh-session-export)

把一次会话连同它的整个智能体编队导出为两份 Markdown,两份来自同一次冻结快照。

两份产物

文件 定位 内容
*.summary.md 给人读 全局时间线叙事:谁在何时说了什么、做了哪个决定、派了谁、子代理回报了什么。每条都带 [→ raw] 锚点
*.raw.md 给复盘/审计 逐事件完整日志:消息原文、工具参数与结果、失败重试、状态变更、被替换的历史

两份文件共享同一个 export_id,并各自在 frontmatter 声明快照边界。

用法

三种入口,共用同一套导出实现。

作为对话里的按钮(推荐)

输入框下方的 dock 上有一个 导出会话 按钮(文档图标)。点击后:

  1. 先弹目录选择框(Windows 原生「选择文件夹」对话框)——取消就什么都不做
  2. 选好后自动执行导出,进度显示在按钮上(选择位置… → 导出中…)
  3. 失败原因直接显示在按钮旁边,不打断对话

作为工具(Agent 可调用)

export_session_markdown({ sessionId?: string, ... })
参数 默认 说明
sessionId 当前会话 要导出的会话;导出的是它的整棵编队树(向上找到根,向下收集所有子代理)。支持 ID 前缀
includeSystemPrompt false 是否导出 system prompt 原文
includeReasoning true 是否导出思考链(raw 中默认折叠)
redact true key / token / 家目录路径脱敏
toolResultMaxChars 6000 超过该字符数的工具结果在 raw 中折叠(保留首尾并注明原始长度)
outputDir 弹出选择器 输出目录。省略时会先弹出系统目录选择器让你选保存位置;给定则直接使用。可写相对工作区的路径(如 exports),也可写绝对路径(如 D:\会话导出)。目录不存在会自动创建
formats ["summary","raw"] 可只生成其中一个

作为命令

/md-export            # 先问保存位置,选好再导出
/md-export 归档/1029  # 不问,直接导出到工作区下的相对目录
/md-export D:\会话导出 # 不问,直接导出到绝对路径

> 命令名是 md-export 而不是 export:export 已被 DSH 内置命令占用。

选择保存位置的三级策略(三个入口一致)

  1. 按钮:直接调 DSH Desktop 的 __DSH_DESKTOP_PICK_DIRECTORY__ 桥,弹真正的 Windows「选择文件夹」对话框。这个桥存在与否与 Host 侧 directoryPicker 后端无关,所以在 browse 组合下依然可用
  2. 命令 / 工具:先试 native 后端;不可用则改用 DSH 的提问卡片(ctx.userQuestions.ask),给出常用位置并允许直接填写绝对路径
  3. 都不成立 → 回退默认 exports,并在回执里说明原因

指定了 outputDir 就完全不打扰;用户取消则一个文件都不写(询问发生在渲染之前)。

保存位置必须落在会话可写范围内

DSH 的会话文件策略默认是 workspace-write:只有会话工作区(如 …\DSHworkSpace)可写,桌面、文档、其它盘符都会被沙箱拒绝。所以:

  • 「工作区 exports 目录」永远是安全选项;想存到桌面/文档,需要把会话的文件策略切到 danger-full-access
  • 选位置的快捷项会先按当前策略过滤,不会再给出注定失败的选项
  • 即便如此选到了不可写的位置,也不会失败:导出会改存到 <工作区>/exports,回执里明确写「原定位置 X 不在可写范围,已改存到 Y」。渲染发生在写盘之前,判定也提前做,所以不会白跑一遍渲染

> 踩过的坑:会话标题是 本地插件:技能管理插件维护 时,文件名曾原样带上全角冒号 :(NTFS 允许,但 zip/同步/SMB 工具会出问题),现在 slugify 会把半角与全角路径字符一起折叠成 -,并处理 CON/NUL 这类 Windows 保留名。

子代理无法回答提问(DSH 只允许 live runtime root 接收人类回答),所以由子代理触发的导出会直接走默认目录,不会挂住。

路径解析用 path.resolve,不手写前缀判断
Windows 下 /exports 是盘符根(C:\exports)而不是工作区子目录,D: 是盘符相对路径而不是绝对路径。早期手写的正则把这些都判错了,还把 D:\会话导出 拼成了 /D:会话导出。现在统一交给 path.resolve(cwd, raw)。

产物结构

<工作区>/exports/
<标题>_<会话ID前8位>_<时间戳>.summary.md
<标题>_<会话ID前8位>_<时间戳>.raw.md

几个关键设计决定

1. 排序用 (time, sessionId, seq),不是全局序号
DSH 的事件 seq 是会话内递增的,lead 与每个 subagent 各自从 0 开始,跨会话不可比。因此编队时间线必须按实际时间合并,同毫秒时用 sessionId + seq 做 tie-break。

2. 会话 ID 有两种写法,必须归一化
新会话是裸 UUID(cc8a1db3-...),而 parentSession 与老会话带前缀(session-67a8d807-...)。插件在每次查表前都做去/加前缀的双形态尝试,否则编队树会断。

3. raw 不是"摘要的展开",summary 也不是"raw 的删减"
两者都从同一份快照独立投影:raw 走事件流,summary 走叙事节拍(user / assistant / tools / spawn / report / alert)。

4. 系统注入不进叙事
DSH 会把 harness 上下文(runtime context、技能清单、时间采样、委派提示)作为额外的 user/message 事件写入。raw 里保留并标注为「系统注入」,summary 里剔除——否则时间线会被注入内容淹没。

5. 导出器自己的痕迹会被过滤
导出工具的调用会写入 tool/call / tool/result,命令会写入 command/run / command/done。这些在 raw 中默认过滤,避免档案被污染、也避免下一次导出时递归膨胀(因此工具返回值只给路径与统计,绝不返回正文)。

6. 只读
插件从不向会话日志追加事件。

已知限制

  • 改代码后必须重启 DSH 才会加载新的 JS 模块代次(Host 插件没有 HMR)。安装新 bundle 可以热激活,替换已安装的包不行。
  • exports 必须显式暴露 "./package.json":dsh-client-modules 用 require.resolve('<包名>/package.json') 定位清单,而 exports 一旦声明就会封死所有未列出的子路径。漏掉这一条时解析抛 ERR_PACKAGE_PATH_NOT_EXPORTED,locatePkgJson 在 catch 里静默返回 undefined,结果是 Host 正常工作、Client 半边凭空消失且没有任何报错。修好后重新安装即可热生效,无需重启(HMR 会重扫该包)。这个坑排查成本极高,务必保留这一行。
  • remote.commands 是带点号的扁平服务名,不是 remote 的子属性:Client 侧要写 inject: ['slots', 'remote.commands'],取值用 ctx.get('remote.commands')。写成 ctx.get('remote').commands 会报 cannot get property "remote.commands" without inject(不注入时直接属性访问同样报这个)。DSH 自己的 dsh-client-ui-commands / dsh-client-ui-plan 都是这个写法,可直接参照。
  • locale.bind(ns) 返回取词函数,不是字典:形状是 (key, params) => string,查不到时把 key 原样返回。写成 bind(ns).button 会得到 undefined,按钮渲染成空白。
  • 测试桩必须复刻真实语义:以上两个 bug 都因为我的桩「比真实实现宽松」而漏过(bind() 返回 undefined、remote.commands 建成嵌套对象)。桩越宽松,测试越没用。test/regression-guard.mjs 会把已修的 bug 逐个注入回去,断言测试必须失败。
  • 旧格式会话若无法重放(migration-required),会降级为「仅元数据」并在文件中标注,不会中断导出。
  • 无法读取的子代理分支(外部/不可用)会在「导出提示」里列出,不会静默缺失。
  • 超长会话的 raw 会很大(几百 turn 可能几十 MB);可用 formats: ["summary"] 只出摘要。
  • workspace-write 下写不到工作区之外(这是 DSH 的安全边界,不是本插件的限制):选到桌面/文档时不再报错失败,而是改存到 <工作区>/exports 并在回执里说明原定位置。要真的写到别处,把会话的文件策略切到 danger-full-access。

文件构成

index.js              工具与命令注册、导出编排、落盘
client.js             Client 按钮(dock 上的「导出会话」)
lib/collect.js        定位根会话、自建编队树、逐会话冻结快照
lib/render-summary.js 叙事渲染
lib/render-raw.js     原始存档渲染
lib/redact.js         脱敏规则
lib/util.js           会话 ID 归一化、时间格式、转义、截断、可写性判定(`canWriteDir`)
test/render-test.mjs  离线渲染测试(直接读磁盘上的 v4 日志,无需安装)
test/client-test.mjs  Client 半边离线测试(桩 React / ModuleLoader / 严格 ctx)
test/host-test.mjs    路径解析表驱动测试
test/regression-guard.mjs 把已修的 bug 注入回去,断言测试必须失败

离线自测:

node test/render-test.mjs "" "<输出目录>" "<根会话ID>"
node test/client-test.mjs
node test/host-test.mjs
node test/regression-guard.mjs

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-session-export 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:cnhenaihui/dsh-session-export` 即可。对应的 npm 包名是 `@cnhenaihui/dsh-session-export`。

dsh-session-export 的验证等级是什么意思?

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-session-export 安全吗?

未标注。

dsh-session-export 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-session-export 需要什么运行环境?

Node.js >=20.0.0。环境不满足时安装会失败,建议先确认本机版本。

dsh-session-export 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-session-export 有哪些功能?

导出摘要与原始存档两份 Markdown、按编队树合并全局时间线、按钮、工具、命令三种入口、敏感信息脱敏与结果折叠、只读导出,不污染会话日志。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

5 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

cnhenaihui 的其它插件

3 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。