前言¶
在 DeepSeek Harness（DSH）裏排查日誌、寫腳本、提 Issue 或執行 dsh 命令時，經常需要當前會話的 session id。界面默認只顯示對話標題，沒有提供複製 id 的入口，開發者往往要開 DevTools、翻日誌或從 URL 裏手敲。下面介紹的客戶端插件在標題右側增加一個六位短標識，點一下即可把完整 session id 寫入剪貼板。
這是什麼¶
dsh-session-id-copy 由維護者 prgrmrwy 發佈，分類爲客戶端插件。它在當前會話標題旁註入一個小徽章，展示 session id 去掉 session- 前綴後的前六個字符；單擊徽章複製完整 session id，並在下方短暫顯示已複製提示。數據只來自 DSH 官方的 sessions 列表與標題區域 DOM，不讀對話內容、不髮網絡請求、不寫本地存儲。
核心功能¶
- 標題旁六位徽章：例如
session-9af69be9-…在徽章上顯示爲9af69b；真實 id 以官方 sessions 列表裏的current爲準，切換會話或改標題會即時更新。 - 單擊複製完整 id：懸停時指針樣式、背景高亮，tooltip 顯示完整 id；複製成功後約 1.2 秒內顯示提示（中英文隨界面語言），再 200 ms 淡出。
- 不改動官方標題行爲：標題仍爲官方控件（不可點複製）；麪包屑繼續負責導航。自 0.1.1 起交互集中在獨立徽章上，避免與麪包屑導航衝突。
- 無配置項：插件行無
config字段，也不讀環境變量。 - 邊界與安全：Host 側入口爲空加載器，僅用於讓瀏覽器 bundle 可達；剪貼板失敗或找不到官方 DOM 時靜默降級，不拋錯、不上傳數據。
安裝與啓用¶
需要 DeepSeek Harness 0.2.0-rc.2 與 Node.js >=22.19。
npm 預構建包（無需本地構建審批）：
dsh plugin --profile web add dsh-session-id-copy
或從源碼安裝（本地構建，按提示批准構建）：
dsh plugin --profile web add prgrmrwy/dsh-session-id-copy
安裝後重啓 DSH 並刷新 Web 頁面。無額外配置步驟。
卸載：
dsh plugin --profile web remove dsh-session-id-copy
同樣重啓 DSH 並刷新頁面，徽章消失，不會留下插件自有設置或數據。
典型用法¶
- 在 Web 客戶端打開任意已有標題的會話，在標題文字右側查看六位徽章（空白會話或 hero 視圖無標題區，不會出現徽章）。
- 將鼠標移到徽章上，確認 tooltip 中的完整 session id。
- 單擊徽章，等待標題下方短暫出現的「已複製」類提示，即可在日誌、腳本或 Issue 中粘貼完整 id。
插件通過 sessions 訂閱與 MutationObserver（含 subtree 與 class 變化）配合 rAF 防抖，在標題區域重建時更新或移除徽章；DSH 升級後若官方 DOM 結構變化，維護者預期主要調整 title-locator.ts 一類定位邏輯。
適用場景與注意¶
適合：經常在 DSH Web 端做運維、自動化或問題上報、需要快速拿到當前 session id 的開發者。
注意：
- 插件隨當前 DSH 進程與 Web 客戶端注入運行；安裝前建議在 GitHub 倉庫 查看源碼與 MIT 許可證，確認符合你的安全策略。
- 依賴與運行中 DSH 版本對齊的
@deepseek-ai/cordis、@deepseek-ai/dsh-api-session-controller、@deepseek-ai/dsh-client-locale等 peer 包；clipboard API 不可用時會靜默失敗。 - DSH 社區插件目錄爲獨立站點 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係；本文事實以倉庫 README 與發佈包爲準。
結尾¶
若你希望少一步 DevTools 或日誌檢索，dsh-session-id-copy 把 session id 放到標題旁：看六位、點一下、拿完整 id。目錄頁：https://www.skillhub.cn/plugins/prgrmrwy/dsh-session-id-copy；源碼與 Issue：https://github.com/prgrmrwy/dsh-session-id-copy。
