dsh-copy-session-id
给 DeepSeek Harness（DSH）的会话标题栏加一个「复制会话 ID」按钮。
点一下，当前会话 ID 的原文就进剪贴板——没有前缀、没有后缀、没有换行，粘到别处直接可用。
┌─ 会话标题栏 ──────────────────────────┐
│ 修复登录超时问题 [团队] [📋] │ ← 点这个
└───────────────────────────────────────┘
↓
图标变 ✓ +「已复制」，1.5 秒后还原
为什么需要它
跨会话协作时经常要把一个会话 ID 交给另一个会话：转交上下文、让子代理接着干、记进任务清单、贴给同事。DSH 本身不在界面上暴露当前会话 ID——要拿到它得翻目录或读存储文件。
这个插件把它变成一个按钮。
特性
| |
|---|
| 复制的是纯 ID | 剪贴板里就是会话 ID 本体，没有任何包装文本 |
| 不占地方 | 平时只有一个图标按钮，不常驻显示 ID 文本。悬停可看到完整 ID，方便核对复制对不对 |
| 失败看得见 | 复制失败会显式显示「复制失败」，不会静默吞掉 |
| 三级降级 | navigator.clipboard.writeText → 隐藏 textarea + execCommand('copy') → 显式失败提示 |
| 零依赖零构建 | 只 require('react')，不引任何 DSH 包，源码即运行物 |
| 不拖垮页面 | 槽位注册失败只会让按钮不出现，DSH 本身照常工作 |
安装
git clone https://github.com/zws20070309/dsh-copy-session-id.git
cd dsh-copy-session-id
powershell -ExecutionPolicy Bypass -File .\tools\install-link.ps1
然后完全退出并重启 DSH。
脚本做了什么（点击展开）
三件事，全部可回滚（改 profile 配置前会先备份）：
| # | 动作 | 落点 |
|---|
| 1 | 建目录联接（junction）指向源码目录 | <DSH_HOME>\plugins\dsh-copy-session-id |
| 2 | dependencies 加一条 link: 依赖、dsh.profile.bundles 加一项 | <DSH_HOME>\profiles\desktop\package.json |
| 3 | 建 node_modules 联接 | <DSH_HOME>\profiles\desktop\node_modules\@zws\dsh-copy-session-id |
用的是联接而不是复制文件，所以在源码目录里改代码，重启即生效，不用重装。
可选参数与卸载（点击展开）
# 自定义路径 / 装到别的 profile
.\tools\install-link.ps1 -DshHome D:\dsh -ProfileName web -Source C:\path\to\this\repo
# 卸载（保留源码目录）
.\tools\install-link.ps1 -Uninstall
<DSH_HOME> 默认是 %USERPROFILE%\.dsh。插件放在 plugins\<name>，profile 在 profiles\<profileName>（桌面端是 desktop）。
也可以不走脚本：DSH 界面里「插件 → 已安装 → 添加插件」，填本仓库目录的绝对路径。
两个注意事项
一、必须重启才生效。 DSH 的 HMR 只对 profile 配置生效，源码模块要显式加进监听列表才会热重载，默认不监听插件目录（见官方 dsh-base/cordis.patch.yml:27-32，dsh-hmr 的 config.root 默认是空数组，注释写明 "module roots are opt-in"）。
二、不要手改 profiles\<profileName>\cordis.yml 来注册插件。 那个文件只是个空列表占位，文件头写着 Edit cordis.patch.yml, not this file——插件的树是运行时由各 bundle 层的 patch 拼出来的。要手写注册请改 profile 自己的 cordis.patch.yml。
它是怎么挂上去的
挂在 DSH 官方的 UI 槽位 conversation.session.header.actions 上——会话标题栏右侧的操作区，官方的「智能体团队」等按钮也在这个容器里。
sessionId ──► 组件 props（session 作用域的标准 props）
└─ dsh-client-ui-session → dsh-client-ui-renderer
apply(ctx) ──► slots.inject('conversation.session.header.actions', …)
└─ 注册本组件，order: 100
槽位的 order 是升序（数值越小越靠左）。本插件取 100，所以排在容器最右端——同槽位的官方条目实测 order 为 -30 / -20 / -10 / 20。
客户端 bundle 的形态是硬约束：DSH 会把所有插件的客户端代码拼成一个脚本执行，所以顶层不能有任何声明（和其他插件撞名会让整个应用起不来）。注册必须内联成单条 window.__ModuleLoader__.load({...}) 语句。
目录结构
lib/client.js 浏览器半。全部行为在这里：注册槽位 + 按钮组件 + 复制降级链
lib/index.js 宿主半。空壳，但必须存在（见下）
cordis.patch.yml 三行，把本包作为一行插件配置新建进 profile
locale/*.json 插件页的标题与描述
icon.svg 插件页图标
tools/install-link.ps1 安装 / 卸载脚本
tools/selftest.cjs 离线自测
tools/review-*.cjs 契约审查脚本
为什么 lib/index.js 是空的还要有？
浏览器半的发现机制跟着 cordis 的 fiber 走：一个包只有在 profile 的 cordis 配置里出现过、被真的 import 过，才会有 fiber，浏览器才会加载它的客户端代码。
至于 host 半做什么，官方只校验 exports["./client"] 存在，不看 host 半导出什么。所以它是个空壳，但删了插件就不会被加载。
开发
离线自测——不需要 DSH、不需要网络、不装任何包：
node tools\selftest.cjs
它在假全局（假 window.__ModuleLoader__、假 react、假 clipboard、假 document）里真跑一遍 lib/client.js，断言注册形态、槽位参数、点击后剪贴板收到的是全文相等的纯会话 ID，以及降级链与失败提示。
契约审查——读本机 DSH 的官方包源码，校验依赖的槽位契约没变：
node tools\review-01-toplevel.cjs # 顶层零声明（含与全部官方 bundle 拼合测试）
node tools\review-05-official-slots.cjs # 用官方真实 SlotCore 验证注册与排序
没装 DSH 也能跑：相关检查会自动跳过并说明原因，退出码仍是 0。
排错
| 症状 | 看哪里 |
|---|
| 标题栏没有按钮 | DevTools Console 搜 copy-session-id，插件会 console.warn('[copy-session-id] ...')。一条都没有 = 注册没跑（多数是没重启 DSH） |
Console 有 [copy-session-id] slot register: | 官方槽位形状变了。页面不会崩，只是按钮不出现 |
| 按钮灰的、点不动 | 当前会话还没有 sessionId |
| 点了显示「复制失败」 | 浏览器不是安全上下文，且 execCommand('copy') 也被拒。DSH 本体在 127.0.0.1 上，正常不会走到这里 |
兼容性
- DSH 44.x（在 44.0.0 上开发与验证）
- 依赖宿主提供的
@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-plugin-manager（>=0.2.0-rc.1 <0.3.0）
- Windows：安装脚本用目录联接（junction）。Linux/macOS 改用符号链接即可，把脚本里的
New-Item -ItemType Junction 换成 ln -s
许可
MIT
