shaomingbo/dsh-session-reference-copy

dsh-session-reference-copy

一个小型 DeepSeek Harness Web 客户端插件，用于把当前 Session 复制成规范的跨 Session 引用。

用途

Harness 可以通过 @ 引用其他 Session，但在实现与 Review 会话之间切换时，按标题或 ID 搜索特定 Session 并不方便。本插件在当前 Session 标题栏增加复制按钮，把精确的结构化 mention 写入剪贴板：

@可读的会话标题

将它粘贴到另一个 Session 并发送即可。Harness 会解析其中的不透明身份，并沿用现有 session-reference 快照机制捕获源 Session。

行为

- 使用当前 Session 的显示标题作为可读 label。
- 摘要不可用时回退到 Session ID。
- 按 Harness 规范使用 JSON、UTF-8 和 base64url 编码 dsh-session: URI。
- 对 label 中的 ] 和反斜杠做规范转义。
- 剪贴板写入成功后显示一秒勾选状态。
- 剪贴板失败时通过当前会话的 notice 展示错误。
- 不新增 Host RPC、持久化或模型提示词行为。

粘贴后的 mention 目前可能在输入框中保持规范文本，而不会恢复成可视 chip；这不影响发送后的引用语义。

Session 引用是在目标消息进入模型步骤时捕获的快照，并不是跟随源 Session 后续变化的实时链接。

安装

首选——用固定 release tag 配合包自带的无参数安装器：

npx --yes github:shaomingbo/dsh-session-reference-copy#v0.1.1

不带子命令等同 install。安装器只改目标 profile（默认 web）package.json 里的 dependencies.dsh-session-reference-copy 和 dsh.profile.bundles，用临时文件加原子 rename 写入，然后在该 profile 目录运行 pnpm install --ignore-scripts。它不会停止或重启 DSH。

查看安装状态：

npx --yes github:shaomingbo/dsh-session-reference-copy#v0.1.1 status

卸载（幂等——重复执行安全；依赖安装失败时自动恢复原 manifest）：

npx --yes github:shaomingbo/dsh-session-reference-copy#v0.1.1 uninstall

所有命令都支持 --profile （默认 web）、--source 、-h/--help。默认 source 固定在当前 SemVer tag；本地开发可用 link: 指向 checkout：

npx --yes github:shaomingbo/dsh-session-reference-copy#v0.1.1 --source link:/absolute/path/to/dsh-session-reference-copy

安装或卸载后：手动重启 dsh web，然后硬刷新现有浏览器页面。

手动兜底——直接编辑 ~/.dsh/profiles/web/package.json：

{
"dependencies": {
"dsh-session-reference-copy": "github:shaomingbo/dsh-session-reference-copy#v0.1.1"
},
"dsh": {
"profile": {
"bundles": [
"dsh-session-reference-copy"
]
}
}
}

然后在该 profile 目录运行 pnpm install --ignore-scripts 并重启 DSH。

如果你用 dsh plugin 管理 bundle，等价命令是 dsh plugin --profile web add|update|remove dsh-session-reference-copy。

开发

npm run check

客户端模块是一个自包含的 DSH window.__ModuleLoader__ bundle。测试通过轻量 module-loader fixture 验证规范编码、标题回退、slot 注册、复制成功与剪贴板拒绝路径。

License

MIT