前言¶
在 DeepSeek Harness（DSH）裏，一個 Session 往往對應一長串對話。側欄標題若一直用手動 Rename 或默認佔位名，回溯和區分任務成本會越來越高。社區裏也有靠習慣或外部筆記記標題的做法，但和 Harness 側欄不同步。
下面介紹客戶端插件 dsh-session-auto-rename（維護者 Jason25417）：在 Session 的「…」菜單裏增加 Auto-rename，按會話日誌與「越新越重要」的權重請默認模型生成短標題並直接改名；同時在 Session 行上支持右鍵呼出同一套官方菜單。插件歸屬社區生態，目錄頁在 SkillHub，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」的擴展方式。
這是什麼¶
dsh-session-auto-rename 是 DSH 的 客戶端（web profile） 插件包 @jason25417/dsh-session-auto-rename（當前版本 0.1.1，許可證 MIT）。它不改寫 Harness 自帶的 pin / rename / fork 等邏輯，而是在現有 Session 菜單 surface 上追加一行 Auto-rename，並把右鍵行爲接到官方「…」菜單上；重命名最終仍走 Harness 自帶的 rename RPC。
核心功能¶
Auto-rename 菜單項¶
在側欄某個 Session 的「…」菜單中，Rename 下方會出現 Auto-rename。點擊後會：
- 讀取該 Session 的日誌；
- 對用戶消息按時間做 recency 加權（
w = exp(-age / 3d)，τ = 3 天，較新的輪次更主導主題）； - 在約 6000 字符的 prompt 預算內按權重選取最多 18 條消息，再按時間順序（附帶 age 與 weight）交給模型；
- 使用 Harness 裏 composer 當前默認模型（插件不自帶 key，走
ctx.llm.stream），推理 effort 固定爲最低檔off； - 得到短標題後直接改名，不彈出確認框；幀底狀態行顯示進度，完成後報告新標題與舊標題，失敗則給出原因。
標題寬度預算：10 個 CJK 字寬；ASCII 按半寬計，純拉丁標題最多約 20 字符。系統 prompt 寫明硬上限；若仍超長，會先有一次「縮短表述」的修復輪次，再考慮截斷。
該 LLM 請求 不設超時，會等到模型返回；再次點擊 Auto-rename 會中止上一輪並重新開始；關閉頁面會在 host 側中止調用。
右鍵 Session 行¶
在任意 Session 行 右鍵，會在指針位置打開 該行自己的「…」菜單。菜單內容與官方一致（pin / rename / auto-rename / fork / archive / copy id 等），並非插件重寫一套 UI。實現上依賴側欄行的 data-row-key="session:<id>" 與 span[class*="rowActions"]；若某版 DSH 改了 DOM，右鍵可能靜默失效，菜單裏的 Auto-rename 仍可用。空白 Session 行右鍵無動作。
Agent 工具¶
Host 側註冊同名能力，模型可調用：
session_auto_rename({ sessionId })
與菜單觸發的 Auto-rename 爲同一操作。
環境與依賴¶
- DSH >= 0.2.1-rc.5（插件在共享
/apiFetch 通道註冊 host 入口，Desktop shell 會代理）。 - Harness 中已配置 默認模型；切換 composer 默認模型會改變插件使用的路由。
README 記載在 DSH Desktop 0.2.1-rc.5（macOS） 上做過驗證：host 側對約 2400 條事件的 Session 測過 /api Fetch；client 側確認菜單項位置、右鍵與狀態行到側欄改名的鏈路。
安裝與啓用¶
插件市場 / Plugins 頁： 安裝該 bundle 後 重啓應用一次。Desktop shell 會凍結啓動時的插件列表，不重啓時 client 半端可能不出現。
CLI（web profile）： 使用資料原文命令：
dsh plugin --profile web add @jason25417/dsh-session-auto-rename
從源碼： 用 Harness 插件管理器的 install_bundle 把本倉庫目錄加爲 bundle（資料未給出 git clone 步驟，此處不展開）。
安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，與任何社區插件一樣需自行評估信任邊界。
典型用法¶
- 安裝並 reload 後，在側欄選中目標 Session，點「…」→ Auto-rename，等待幀底狀態行完成。
- 或在 Session 行 右鍵 打開菜單，再選 Auto-rename（或 Rename、Fork 等官方項）。
- 若在 Agent 場景需要程序化改名，由具備工具權限的模型調用
session_auto_rename({ sessionId })。
無需額外配置文件；行爲由上述標題規則與默認模型決定。
適用場景與注意¶
適合： 長對話 Session 較多、希望側欄標題反映 最近幾輪主題 的 Harness 用戶；習慣右鍵操作菜單而非先找「…」的用戶。
注意：
- 改名 無確認對話框，誤點會直接生效，重要 Session 可先 pin 或自行備份標識。
- 右鍵菜單每幀重算錨點，插件用 transform 把 portal 菜單釘在指針處，滾動時菜單會隨錨點移動，而非固定在屏幕座標。
- 已知限制見倉庫 README：DOM 變更影響右鍵；模型路由隨 composer 默認模型變化。
結尾¶
dsh-session-auto-rename 把「讀日誌 → 近期加權 → LLM 短標題 → 官方 rename」收成 Session 菜單裏的一鍵操作，並補上 Session 行右鍵菜單，減少側欄標題維護成本。
