dsh-session-bundle

DSH PLUGIN工具与能力

仓库 zhyunran/dsh-session-bundle · npm dsh-session-bundle

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 插件:一条 /bundle 命令把可读对话、原始日志、附件和本会话产出的文件打包成 ZIP 写入磁盘,方便备份与分享。

一句话选型结论

按资料字段整理

dsh-session-bundle 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-11-04 创建于 2026-11-04
README 9.2 KB 正文体量,越大说明说明书写得越细

安装

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

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=22.19.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求>=22.19.0来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/dsh-tools@>=0.2.0-rc.1 <0.3.0需要同时安装的同级依赖
npm 包名dsh-session-bundle可用 npm view 查看包信息

能做什么

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

dsh-session-bundle:把 DeepSeek Harness 会话连同产出文件打包成 ZIP

  • 一条命令导出完整会话 ZIP
  • 生成可读的对话 Markdown
  • 附带原始 JSONL 日志与附件
  • 收集会话产出的工作区文件
  • ZIP 直接落盘无需浏览器下载

适用场景

存储文件读写

上游标签

backupconversationdeepseek-harnessdshdsh-plugindsh-pluginssession-exportzip

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-10): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

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

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-bundle当前 L5 · 运行验证通过 低风险 1 0.2.2-rc.1 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

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

README 全文

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

dsh-session-bundle

一条命令,一个 ZIP:可读对话 + 本会话真正产出的文件 + 全部附件。 在 DSH 里输入 /bundle,或让 agent 调用 export_session_bundle。

English


先确认:DSH 已有什么(做之前已核查)

DSH 自带 @deepseek-ai/dsh-session-log-export,入口是 /export 命令和会话头部菜单里的 「下载 Session 日志」。它下载的 ZIP 包含:

  • 根会话的原始 session.vN.jsonl 日志(以及子会话);
  • 日志里引用到的全部附件(media/…、files/…)。

它不生成可读文字稿,也不复制本会话在工作区里写入/修改/交付的文件。present 的文档甚至明确说明:Session ZIP 只包含声明,不包含文件内容。

社区已有若干可读 Markdown/HTML/PDF 导出插件;按它们公开的描述,重点都在对话本身,而不是会话同期在工作区产出的文件。

这个插件补的就是这一层:对话 + 产出文件 + 附件,一个 ZIP,直接落到 Host 磁盘。

用法

人用:/bundle

在想导出的会话里输入:

/bundle

不接受参数。ZIP 默认写到 Windows 的 桌面/DSH-Exports/(其他系统 /DSH-Exports/),命令结果会显示完整路径。

AI 用:export_session_bundle

对 agent 说「把这个对话和它产出的文件导出成一个包」,它调用:

{
&quot;include_workspace&quot;: true,   // 可选:强制做一次修改文件扫描
&quot;include_raw_log&quot;: true,     // 可选
&quot;output_dir&quot;: &quot;D:/exports&quot;   // 可选
}

没有浏览器下载、没有文件选择框:ZIP 直接落盘。

ZIP 结构

README.txt
conversation.md        可读对话文字稿
session.v4.jsonl       原始持久事件日志(JSON Lines)
manifest.json          机器可读的文件索引、计数、跳过原因
files/
attachments/         对话里每个文件/图片附件的字节
produced/            present / write / edit / str_replace_editor 产出的文件(保留工作区相对路径)
external/            工作目录之外被修改的文件
workspace/             本会话在工作目录内改动过的文件副本

conversation.md 包含:

  • 头部:会话 id、工作目录、创建/导出时间、模型、回合数、消息/工具调用数;
  • 每个回合 ## Turn N;
  • 用户消息及其来源(user、agent message from、schedule 等);
  • assistant 正文;
  • 可折叠的工具调用/结果(参数与截断后的输出);
  • 指向 files/attachments/ 的附件链接;
  • Presented files 和每回合变更文件,带包内链接;
  • 末尾完整文件清单表。

conversation.md 不含 system prompt、developer 消息、请求头、reasoning 和注入型运行时上下文(后两者可配置打开);session.v4.jsonl 保留原始全量。

“本会话产出的文件”是怎么找的

按顺序取并集,按绝对路径去重:

  1. 附件:user / assistant / tool-result 内容里的 file/image 块;字节从附件存储读取。
  2. present 交付文件:规范的 deliverables/presented 事件(present 工具调用作兜底)。
  3. 文件工具写入:write、edit、str_replace_editor 调用,相对路径按会话工作目录解析。
  4. workspace/changes 摘要:workspace/changes 事件 + ctx.workspaceChanges.summary(),即 Host 的 git 工作树 / 文件工具快照,按回合列出改动文件。它同时覆盖文件工具编辑和(在 git 仓库里)shell 创建的产物。这些摘要只在 Host 内存里,重启后可能没有。
  5. 修改文件扫描:includeWorkspace: auto 且没有摘要时(或 always 时)扫描工作目录中 mtime ≥ 会话开始的文件,跳过 .git、node_modules、各种缓存/虚拟环境等。

被删除的文件会在 manifest.json 里标为跳过(missing (deleted or moved))——磁盘上已经没有内容,只能保留文件名/计数。

所有文件都有大小上限,并在 manifest 里带 SHA-256。

配置

在自己的 profile 层覆盖:

# /profiles//cordis.patch.yml
- id: dsh-session-bundle
config:
outputDir: &#x27;D:/exports&#x27;     # 默认:桌面/DSH-Exports 或 /DSH-Exports
includeWorkspace: auto      # auto | always | never
includeAttachments: true
includeRawLog: true
includeReasoning: false
includeInjectedContext: false
maxFileBytes: 52428800          # 单文件 50 MiB
maxTotalBytes: 314572800        # 整包 300 MiB
maxWorkspaceFiles: 300
maxWorkspaceBytes: 209715200    # workspace 副本 200 MiB
maxToolChars: 4000              # conversation.md 中每个工具块
maxMessageChars: 20000          # conversation.md 中每条消息
maxRawLogBytes: 52428800
ignoreNames: [&#x27;.git&#x27;, &#x27;node_modules&#x27;, &#x27;__pycache__&#x27;, &#x27;.venv&#x27;, &#x27;venv&#x27;, &#x27;.next&#x27;, &#x27;.cache&#x27;]
字段 默认 含义
outputDir &#x27;&#x27; Host 输出目录;空则优先 桌面/DSH-Exports,其次 /DSH-Exports。
includeWorkspace auto auto=有摘要用摘要,否则扫描;always=摘要+扫描;never=不复制工作区变更(显式 produced 仍保留)。
includeAttachments true 复制附件字节。
includeRawLog true 包含 session.v4.jsonl。
includeReasoning false 在 conversation.md 中包含 reasoning。
includeInjectedContext false 在 conversation.md 中包含注入型 user 上下文(agent 指令、运行时上下文、审批、任务通知)。
maxFileBytes 50 MiB 单文件上限。
maxTotalBytes 300 MiB 附件+产出的总上限。
maxWorkspaceFiles 300 扫描文件数上限。
maxWorkspaceBytes 200 MiB workspace 副本总上限。
maxToolChars / maxMessageChars 4000 / 20000 可读稿截断。
maxRawLogBytes 50 MiB 原始日志上限,超了就不放。
ignoreNames 合理默认 扫描时跳过的目录/文件名。

配置写错会记录错误并使用默认值,不会阻止 DSH 启动。

安装

需要 DSH 0.2.x,无构建步骤、无运行时依赖。

# 本地 tarball(绝对路径)
dsh plugin --profile  add C:\path\to\dsh-session-bundle-0.1.2.tgz

# GitHub tarball(不需要 git)
dsh plugin --profile  add https://codeload.github.com//dsh-session-bundle/tar.gz/&lt;40位commit&gt;

# 或 npm(如果发布)
dsh plugin --profile  add dsh-session-bundle

装完重启一次 DSH。输入 /,命令列表里应出现 bundle。

状态

  • 22 个单元测试全过(node --test test/*.test.mjs):ZIP 结构/CRC、配置、Markdown、文件收集/去重/预算、完整导出、工具与命令 handler。
  • 工具声明用真实 dsh-tools schema 编译器编译通过。
  • 在 DSH 0.2.0-rc.2 上做了真机 E2E:通过工具导出真实会话,检查了 conversation.md、session.v4.jsonl、manifest.json、附件与 workspace 副本,变更文件与会话自身的 workspace/changes 摘要一致。

与现有导出的差异

能力 核心 /export 可读文字稿插件 dsh-session-bundle
原始会话日志 ✅ 不一 ✅ session.v4.jsonl
可读 Markdown 文字稿 ❌ ✅ ✅ conversation.md
附件字节 ✅ 不一 ✅ files/attachments/
会话写入/present 的文件 ❌ ❌ ✅ files/produced/
工作目录内变更文件 ❌ ❌ ✅ workspace/
直接落 Host 磁盘(无浏览器选择框) ❌ 不一 ✅
一条命令 / 一次工具调用 /export 不一 /bundle · export_session_bundle

已知限制

  • 只导出当前会话,不含子会话树;原始日志是根会话自己的日志。
  • workspace/changes 摘要只在 Host 内存:DSH 重启后 auto 会退回修改文件扫描,可能更宽(非 git 目录也可能漏掉 shell 改动)。
  • STORE-only ZIP:最大兼容、零依赖,代价是纯文本包偏大。
  • 不做 PDF/HTML 渲染、不上传云端、不做增量/差分导出。
  • 一回合里用户自己也改过的文件会被计入;这个包是快照,不是“谁改了什么”的归属证明。

开发

node --test test/*.test.mjs
npm pack --pack-destination dist

目录:

lib/index.js      插件入口(name / inject / apply)
lib/command.js    /bundle handler
lib/tool.js       export_session_bundle 工具
lib/bundle.js     快照 → 收集 → 渲染 → 打包
lib/collect.js    附件 / present / 写入 / 变更 / 扫描
lib/markdown.js   可读文字稿
lib/zip.js        零依赖 STORE ZIP writer
lib/config.js     配置与输出目录
lib/session.js    快照与元数据
lib/render.js     工具/命令文本
lib/util.js

发布

git init
git add .
git commit -m &quot;dsh-session-bundle 0.1.2&quot;
git branch -M main
git remote add origin https://github.com//dsh-session-bundle.git
git push -u origin main

把 dist/dsh-session-bundle-0.1.2.tgz 挂到 v0.1.2 release。发 npm 用 npm publish --access public。

许可

MIT,见 LICENSE。


为 DeepSeek Harness 而写。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:zhyunran/dsh-session-bundle#v0.1.2` 即可。对应的 npm 包名是 `dsh-session-bundle`。

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

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-session-bundle 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

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

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

dsh-session-bundle 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

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

Node.js >=22.19.0;需要同时安装 @deepseek-ai/dsh-tools@>=0.2.0-rc.1 <0.3.0。环境不满足时安装会失败,建议先确认本机版本。

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

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

dsh-session-bundle 有哪些功能?

一条命令导出完整会话 ZIP、生成可读的对话 Markdown、附带原始 JSONL 日志与附件、收集会话产出的工作区文件、ZIP 直接落盘无需浏览器下载。

这条记录的数据可靠吗?

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

工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

zhyunran 的其它插件

3 个

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