前言¶
在 DeepSeek Harness（DSH）里排障、写脚本或对接外部工具时，经常需要准确的会话标识，而不是会话标题。会话 ID 形如 session-e7797998-430a-4d2c-aba6-6d7f441f4f70，手工从日志或网络里抠既慢也容易错。社区插件 dsh-plugin-copy-session-id（维护者 kjx-talesofai）在桌面端界面里增加两个入口，一次点击把完整 ID 写入剪贴板，并由宿主顶部的 Toast 提示结果。下面介绍它的定位、能力与安装方式。
这是什么¶
dsh-plugin-copy-session-id 是 DSH 生态下的客户端（纯界面）插件：Host 侧 apply 为空，不写文件、不发请求；会话 ID 本就存在于浏览器侧，插件只在侧边栏会话菜单和当前会话标题栏挂载控件。分类上属于「客户端」类插件；仓库当前在 GitHub 上星标为 0，许可证为 MIT（© 2026 Jiaxin Kou）。
目录页：SkillHub - dsh-plugin-copy-session-id
源码：github.com/kjx-talesofai/dsh-plugin-copy-session-id
核心功能¶
插件在两个位置提供同一个动作——复制会话 ID（不是标题）：
-
侧边栏会话行的
⋯菜单
在内置项之后多出一行「复制会话 ID」。实现上使用宿主提供的MenuItemButton与Toast，样式、悬停、以及 ↑/↓/Tab/Esc 键盘行走与焦点归位与内置菜单项一致。 -
当前打开会话的标题栏右侧
在工具条里、标题栏自带⋯左侧增加复制图标，复制的是当前正在查看的会话的 ID。
第二个入口针对子代理（subagent）会话：sidebar.workspaces 会把带 origin: 'subagent' 的行隐藏，子代理在侧边栏没有对应行，只能通过标题栏拿到 ID。标题栏的 ⋯ 下拉由其他插件（如 session-log-export）写死选项且无插槽，因此本插件以同级控件形式出现在其旁边。
复制成功时，宿主在页面顶部居中显示 Toast；若浏览器拒绝剪贴板写入，会提示「复制失败，请手动复制会话 ID」，而不是成功态的绿色提示。
技术实现上，插件注册两个插槽：sidebar.workspaces.session.menu.item（order 500，在 archive 之后）与 conversation.session.header.utilities（order -5，位于 open-in-app 与标题栏 ⋯ 之间）；反馈统一走 shell.overlay 上的宿主 Toast。产物为无需构建的 client.js，依赖 @deepseek-ai/dsh-client-ui-primitives 中的按钮、Toast、writeClipboard 等。
安装与启用¶
要求 DSH Desktop ≥ 0.2.0-rc.1（package.json 中 peerDependencies / dsh.engines 均为 >=0.2.0-rc.1 <0.3.0-0）。README 记载在 macOS（Apple Silicon）上于 DSH Desktop 0.2.0-rc.2、0.2.1-rc.2 手测通过。
在 DSH 中选择「添加插件」，填入下列标识（当前资料对应版本 v0.2.1）：
github:kjx-talesofai/dsh-plugin-copy-session-id#v0.2.1
或使用 CLI（desktop 配置）：
dsh plugin --profile desktop add github:kjx-talesofai/dsh-plugin-copy-session-id#v0.2.1
若使用本地检出目录安装，路径须为绝对路径。安装完成后重启 DSH 桌面端，插件行才会让 Harness 把浏览器侧代码注入页面。升级策略为先卸载再安装；卸载即在插件列表移除后同样重启。
典型用法¶
- 打开 DSH Desktop，确保插件已安装并已重启。
- 对普通会话：在侧边栏目标会话行打开
⋯，选择「复制会话 ID」；或先打开该会话，点标题栏右侧复制图标。 - 对子代理会话：在侧边栏不可见时，仅能通过当前会话标题栏的复制图标获取 ID。
- 在需要 ID 的工具（脚本参数、工单、日志关联等）中粘贴剪贴板内容，应为以
session-开头的完整 UUID 字符串。
适用场景与注意¶
适合需要在 DSH 内频繁引用精确会话 ID 的开发者与智能体调试场景；不适合只想复制会话标题或导出整段对话内容的用途（后者应使用日志导出等其它插件）。
DSH 插件随当前 Harness 进程与页面上下文运行，安装前建议自行审阅 仓库源码 与 MIT 许可证。本插件不访问网络、不写本地文件，风险面主要集中在剪贴板 API 是否可用（权限或浏览器策略）。
社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件列表与 github: 安装源以维护者仓库与目录页为准。
结尾¶
dsh-plugin-copy-session-id 用两个 UI 入口补齐「复制会话 ID」这一小步，并覆盖侧边栏看不到的子代理会话。若你已在用 DSH Desktop 0.2.x，可按上文命令安装 v0.2.1 并重启验证。
- 目录页：https://www.skillhub.cn/plugins/kjx-talesofai/dsh-plugin-copy-session-id
- GitHub：https://github.com/kjx-talesofai/dsh-plugin-copy-session-id
