dsh-session-id

dsh-session-id

Session ID footer for DeepSeek Harness (DSH): shows the current session id under the composer, click to copy.

DeepSeek Harness 会话 ID 显示插件：在输入框（composer）下方的 footer 位置以小字显示当前会话 ID，点击一键复制。

仓库 / 目录名是 dsh-session-id；内部 bundle 包名沿用既有安装名 dsh-session-id-footer（与 ~/.dsh/profiles/web/cordis.patch.yml 中的注册名一致，dsh plugin 从本仓库安装后即与现网安装完全同名）。这与官方惯例一致——教程示例仓库 hello-plugin 的包名即为 dsh-hello-plugin（仓库名 ≠ 包名，包名带 dsh- 前缀）。

Why

DSH 的会话 ID 是排查、归档、跨会话协作时的关键标识，但 GUI 默认不展示当前会话 ID——只能靠开发者工具或归档面板间接获取。本插件补上最后一步：在 composer 下方的 dock 内以小字常驻显示当前会话 ID，点击即复制，并给出「✓ 已复制」反馈。

• 纯 UI 插件：不碰 host 状态、不注册 HTTP 端点，零风险、零权限。
• 即时复制：优先 navigator.clipboard，降级 execCommand('copy') 兼容旧浏览器。
• 贴近官方插件机制：走 window.__ModuleLoader__.load 标准 bundle 格式 + slots.inject("conversation.composer.dock") 官方插槽。

Features

• 🆔 当前会话 ID 以 11px 小字常驻 composer 底部 dock
• 📋 点击复制会话 ID（1.6s「✓ 已复制」反馈 + 绿色高亮）
• 🖱️ hover 提亮、user-select: text 可手动框选
• 🎯 无会话时自动隐藏（sessionId 为空不渲染）

Install

标准 DSH profile bundle（官方外部插件分发路径，见 docs/user/develop/basic/publish.md）：仓库根目录即 bundle 包（package.json 声明 dsh.bundle.patch），dsh plugin 安装后由 bundle 的 cordis.patch.yml 自动插入插件行。无需构建步骤——纯 JS，git 安装不需要 prepare 脚本或 allowBuilds。

Option A — official dsh plugin (recommended)

# From a directory that contains this checkout (the repo root IS the package):
dsh plugin --profile web add ./dsh-session-id
# or straight from GitHub (plain JS, no build permission needed):
dsh plugin --profile web add github:realpkuasule/dsh-session-id

# Verify the composed layer without booting:
dsh --profile web --dump-config | grep -A2 dsh-session-id-footer

dsh plugin links the package, records it in the profile's dependencies, and the bundle layer inserts the session-id-footer plugin row.

Discoverability

Add the dsh-plugin topic to your plugin repository for discoverability — the official DeepSeek Harness README recommends it, and dsh-plugin is the shared topic under which the community finds DSH plugins (both mirrors of this repo, realpkuasule/dsh-session-id and xiaozhiaixue/dsh-session-id, carry it).

Option B — manual (no CLI)

# 1. Copy the package (repo root) into your profile's node_modules
DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
mkdir -p "$DSH_HOME/profiles/node_modules/dsh-session-id-footer"
cp -R . "$DSH_HOME/profiles/node_modules/dsh-session-id-footer/"

# 2. Add the bundle layer to $DSH_HOME/profiles/web/cordis.patch.yml
#    (an `- insert:` list entry — same shape as the bundle's own patch file)
    - id: session-id-footer
      name: dsh-session-id-footer

# 3. Restart `dsh web`

Open the GUI: the composer dock now shows the current session ID in small text. Click it to copy.

Architecture

Browser (client.js, __ModuleLoader__ bundle)
 └─ slots.inject("conversation.composer.dock", order 10) ──▶ <span> session id
      • props.sessionId / props.session.id → display string
      • click → navigator.clipboard → fallback execCommand('copy')
      • 1.6s "✓ 已复制" feedback via ctx.timeout
Node (index.js, profile Cordis plugin)
 └─ empty apply(): pure UI plugin, exists only so the package
    registers in the host cordis.yml / Loader; the browser half
    ships via exports["./client"] + the package.json dsh.client declaration

• 数据来源：composer dock 插槽注入的 props.sessionId（官方 dsh-client-ui-* 渲染链自带），无需额外数据层。
• 渲染位置：conversation.composer.dock 插槽 order: 10，位于 composer 卡片下方的 dock 条内。
• 隐藏逻辑：无会话（sessionId 为空）时不渲染任何元素，不占位。

Repository layout

The repository root is the bundle package, following the official bundle layout from publish.md:

dsh-session-id/
├── package.json          # bundle manifest: dsh.bundle.patch + dsh.client.platform: web
├── cordis.patch.yml      # the bundle's patch layer (inserts the plugin row)
├── lib/
│   ├── index.js          # host half (empty apply)
│   └── client.js         # browser half (__ModuleLoader__ bundle)
├── README.md
├── DESIGN.md             # full design doc: decisions, risks, verification
└── LICENSE               # MIT

License

MIT