dsh-session-surgeon 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-session-surgeon 兼容性怎么样？

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-session-surgeon 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-session-surgeon 还在维护吗？

GitHub 13 星。最近一次上游提交在 2026/10/25。

会话修复器 xiaoshenming/dsh-session-surgeon

DeepSeek Harness

xiaoshenming9 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

修复打不开的 DeepSeek Harness 会话。

41.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/26 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add xiaoshenming/dsh-session-surgeon

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么

dsh 原生插件 · chat

装得上吗

实装验证未通过（unknown），装前请到仓库确认最近更新与 issue

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 9 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

⚠︎ 实装验证未通过（unknown · 2026/10/21） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-session-surgeon（未发布到 npm，仅可源码安装）

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/1 00:46:18

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 31 处，展示前 30 条）

发起网络请求
plugin/client.js:376
fetch(API + "/ui.css").then((res) => res.text()).then((css) => { tag.textContent = css; }).catch(() => {});
发起网络请求
plugin/client.js:386
const res = await fetch(path, opts);
写入剪贴板
plugin/client.js:675
navigator.clipboard?.writeText(id).then(() => toast(T("toast.copied") + id), () => toast(id));
写入剪贴板
plugin/client.js:843
try { await navigator.clipboard.writeText(id); toast(T("toast.copied") + id); } catch { toast(id); }
读取本地文件
bin/dsh-session-surgeon.mjs:121
const decoded = decodeSessionBuffer(await readFile(entry.file));
读取本地文件
bin/dsh-session-surgeon.mjs:145
const decoded = decodeSessionBuffer(await readFile(entry.file));
读取本地文件
bin/dsh-session-surgeon.mjs:162
const decoded = decodeSessionBuffer(await readFile(entry.file));
读取本地文件
src/scan.mjs:27
const st = await stat(entry.file);
读取本地文件
src/scan.mjs:34
const buf = await readFile(entry.file);
读取本地文件
src/inspect.mjs:52
const buf = await readFile(entry.file);
读取本地文件
src/repair.mjs:443
const plan = planRepair(decoded ?? decodeSessionBuffer(await readFile(file)), { steps });
读取本地文件
src/repair.mjs:452
const after = decodeSessionBuffer(await readFile(file));
读取本地文件
src/repair.mjs:460
const decoded = decodeSessionBuffer(await readFile(file));
读取本地文件
src/find.mjs:25
await stat(path);
读取本地文件
src/find.mjs:52
projects = await readdir(root, { withFileTypes: true });
读取本地文件
src/find.mjs:61
entries = await readdir(join(root, project.name), { withFileTypes: true });
读取本地文件
src/find.mjs:99
entries = await readdir(home, { withFileTypes: true });
读取本地文件
src/find.mjs:131
projects = await readdir(root, { withFileTypes: true });
读取本地文件
src/find.mjs:141
sessions = await readdir(projectDir, { withFileTypes: true });
读取本地文件
src/runtime.mjs:53
if (existsSync(candidate)) {
读取本地文件
plugin/routes.mjs:175
const decoded = decodeSessionBuffer(await readFile(entry.file));
读取本地文件
plugin/routes.mjs:200
const decoded = decodeSessionBuffer(await readFile(entry.file));
读取本地文件
plugin/routes.mjs:216
const css = await readFile(UI_CSS, "utf8");
读取本地文件
src/compact.mjs:221
const src = decoded ?? decodeSessionBuffer(await readFile(file));
读取本地文件
src/compact.mjs:228
const after = decodeSessionBuffer(await readFile(file));
写入本地文件
src/export.mjs:24
await writeFile(outPath, text, "utf8");
读取本地文件
src/verify.mjs:81
const parsed = JSON.parse(await readFile(manifest, "utf8"));
读取本地文件
src/verify.mjs:107
decoded = decodeSessionBuffer(await readFile(entry.file));
写入本地文件
src/encode.mjs:84
await rename(tmp, dest);
写入本地文件
src/encode.mjs:97
await copyFile(dest, bak);

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh@deepseek-ai/dsh-tools

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

修复无法加载的会话
修复打不开的会话文件

README

由 DeepSeek 最新模型翻译生成

dsh-session-surgeon 左侧会话 ⋯ → 复制会话 ID，贴进新对话，让新会话接着学旧会话。这是 Codex 那种「拿线程 ID 继续聊」的用法；官方菜单只有重命名 / 分叉 / 归档，没有复制 ID。同时能修好打不开的 DeepSeek Harness 会话（seq gap / torn zstd / 末帧之后整段 0 字节的崩溃残渣 #9372：崩溃落在 write() 与 fsync() 之间，文件长度落盘而帧数据没落盘，官方扫描器在第一个零字节处判坏魔数、整条拒载，其实已提交的帧帧完好 —— 我们点出边界并丢掉那串 0 / 同一条 policy 链里的 llm/retry 没有逐次 +1 或一条链用了多个 retryId #9163：官方校验器报 llm/retry skips its policy attempt sequence、整份 stored session is corrupt，而且写入时静默、要等下次打开才暴露 —— 次数按链内顺序、id 取该链第一个，两个值都从日志本身还原 / 孤立代理字符 / 消息缺 ID）。崩溃恢复插进来的短闭包如果撞上还活着的写者（#1586），会丢掉那几条合成闭包、保住后面的真内容，而不是一刀切到第一个缺口。packed 行只重叠已经提交的前缀、后面连续时（#5151），会接上尚未提交的后缀。

展开完整文档（README 剩余 1 节）

dsh-session-surgeon

左侧会话 ⋯ → 复制会话 ID，贴进新对话，让新会话接着学旧会话。这是 Codex 那种「拿线程 ID 继续聊」的用法；官方菜单只有重命名 / 分叉 / 归档，没有复制 ID。

同时能修好打不开的 DeepSeek Harness 会话（seq gap / torn zstd / 末帧之后整段 0 字节的崩溃残渣 #9372：崩溃落在 write() 与 fsync() 之间，文件长度落盘而帧数据没落盘，官方扫描器在第一个零字节处判坏魔数、整条拒载，其实已提交的帧帧完好 —— 我们点出边界并丢掉那串 0 / 同一条 policy 链里的 llm/retry 没有逐次 +1 或一条链用了多个 retryId #9163：官方校验器报 llm/retry skips its policy attempt sequence、整份 stored session is corrupt，而且写入时静默、要等下次打开才暴露 —— 次数按链内顺序、id 取该链第一个，两个值都从日志本身还原 / 孤立代理字符 / 消息缺 ID）。崩溃恢复插进来的短闭包如果撞上还活着的写者（#1586），会丢掉那几条合成闭包、保住后面的真内容，而不是一刀切到第一个缺口。packed 行只重叠已经提交的前缀、后面连续时（#5151），会接上尚未提交的后缀。文件已经 seq gap 时 compact 会拒绝，先停写者再 repair。Alpha 把 sourceEventSeqs 压成区间（#5160）时：0.1.2-rc.1 起官方读盘就会展开，surgeon 不再改文件；更旧的 rc.2 仍打不开，repair 才会把 [start,end] 无损展开成密集整数。Alpha 写入、rc.2 不认识的 model/selection 会在结构校验通过后保留原事件，只补 ignorable: true；任意未知插件事件绝不套用。inspect 还会警告悬空 tool/call（没有对应 tool/result，下次模型请求永久 400；0.1.7 上 v3→v4 的 restore 与读一份已存的 v4 日志都会因此拒收整条会话，而结果只能补在还开着的 step 里）以及空的 tool_calls[].id（#5182，下次请求 id cannot be empty），但不会编假结果或假 callId。inspect 也会报告「turn/end 之后同一回合的 step 还在继续」这类失衡（#7824）：官方关系校验（v1→v2 对转换后的工件跑 v0→v1 的 assertReleasedArtifactRelationships）会整份拒读，报 <类型> does not match an open turn and step；合并还是拆分这个回合在工件里没有唯一答案，拆分还要重编号后面所有 seq，所以只报告、不改文件。同一步里重复通告的 callId（#5909）在 0.1.3 的 v0→v1 迁移会拒读；本机已是 v1+ 时 repair 只给后面的 id 加 #n。0.1.3 起还会扫 session.vN.jsonl.zstd；本机装 0.1.7-rc.2（或 rc.1）时格式已是 v4（桌面端内置的 0.2.0-rc.2 同代际、同 SESSION_FORMAT_VERSION = 4，本文引用的闸门在两版发布包里逐行一致），v0–v4 各代 header 都能 inspect / repair（改代际的迁移仍由官方负责）。升级到 0.1.5 后老会话打不开（#6151/#6175/#6189/#6194：权限事件多 origin、子代理描述 version 2、插件消息来源 summary/form 不配、分块溯源断档）时，本机已是 v1+ 的 repair 会按官方冻结清单无损归一这些形状，已用官方 0.1.5-rc.1 转换器逐条验证；未知类型（如 session/imported）迁移连 ignorable 都拒，我们只报告不删。官方以后修加载器，也救不回已经坏掉的日志文件。#6559 里那两类「官方自己写过、迁移不认」的形状在 0.1.7-rc.1 / rc.2 上依然存在，处理方式相同：退役的 source.kind（instruction-hint，已不在 v2→v3 SOURCE_KINDS 里）只改名成键集相同的 plugin；agent/inbox/spliced 的 inserted[] 消息缺 id/role 时补 id 与官方校验器自己写死的 user 角色。成员超出 released 形状的一律只报告、不猜。

最常用：复制会话 ID

1. 左侧某条会话点 ⋯ → 复制会话 ID
2. 开一个新聊天，把 ID 贴进去，例如：

接着 session-1e66cda9-a046-4893-8f4b-b817080acbea 继续。
需要旧上下文时去读那份会话。

如果新会话已经装了本插件的 agent 工具：

session_inspect id=session-1e66cda9-a046-4893-8f4b-b817080acbea
从上次停的地方继续。

有 session- 前缀和没有前缀是同一种会话，只是 ID 写法不同。分叉会复制一份文件；复制 ID 是让新会话引用旧会话。

安装

DSH 桌面端（2026-09-29 起本仓库的对齐目标）：打开「插件」页，添加 git 包 github:xiaoshenming/dsh-session-surgeon#main。profile 在 ~/.dsh/profiles/desktop，pnpm 会把 #main 解析成某个 commit 的 tarball。

CLI 装法等价：

dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"

装好后：

- 会话 ⋯ 菜单：复制会话 ID（日常就用这个）/ 检查 / 预览修复
- 左侧「会话医生」：看对话、复制 ID、预览修复、应用修复、导出

更新＝在「插件」页对这个插件点更新（pnpm 重新解析 #main 到新 commit），或在 profile 里：

cd ~/.dsh/profiles/desktop && pnpm update dsh-session-surgeon

不用重启 dsh web，也不用重新 add：装出来的是 pnpm 解出的一份普通拷贝，本身没有 .git，所以先推到 main，再更新。

本地开发请使用项目锁定的 dsh 版本和 pnpm 锁文件（Node.js 24）：

pnpm install --frozen-lockfile
export DSH_HOME="$HOME/.dsh-surgeon-dev"
./node_modules/.bin/dsh plugin --profile web add "link:$(pwd)"
./node_modules/.bin/dsh web

DSH_HOME 将开发会话与日常会话隔离；面板和 CLI 按 $DSH_SESSION_ROOT → $DSH_HOME/sessions → ~/.dsh/sessions 找会话，面板的「会话根」下拉会自动列出机器上所有 DSH home（按 home 形态识别，也可手输任意路径），另一个 home 里的会话一步就能切过去。不要用 npm 重装此开发环境：当前 DSH 的工具调度器依赖单一 @deepseek-ai/dsh-tools 模块实例，npm 的重复实体副本可能让工具调用报 reading 'prepare'。

在能加载本仓库技能的对话里，说一句 更新（或 更新插件）即可：扫官方 Discussions、吸收对口反馈、改代码、写 CHANGELOG、回复、用 px 推 main。技能正文：skills/dsh-session-surgeon-update/SKILL.md。如果 agent 的技能目录里没列出它，就直接让它读这份文件 —— 纯 markdown 流程，不需要注册。

DSH 的技能索引只扫 <project>/.dsh/skills、<project>/.agents/skills、$DSH_HOME/skills、~/.agents/skills，不扫已装插件包内的 skills/。想让桌面端的技能目录列出它，把它链进用户技能根（以后插件更新会自动跟着）:

mkdir -p ~/.dsh/skills
ln -sfn ~/.dsh/profiles/desktop/node_modules/dsh-session-surgeon/skills/dsh-session-surgeon-update \
~/.dsh/skills/dsh-session-surgeon-update

命令行

npx --yes github:xiaoshenming/dsh-session-surgeon scan
npx --yes github:xiaoshenming/dsh-session-surgeon inspect <id>
npx --yes github:xiaoshenming/dsh-session-surgeon repair <id> # 默认 dry-run
npx --yes github:xiaoshenming/dsh-session-surgeon repair <id> --apply # 先写 .bak.<utc>（Windows 上备份文件只读 fsync 的 EPERM 不再中止 apply）

DSH 没有 Codex 那种任务 ID。能 resume 的是 session。复制会话 ID 是日常最接近的做法。详见 docs/LEARNING-TASKS.md。