前言¶

DSH 的側邊欄左下角是賬號行，顯示當前賬號的暱稱和頭像。很多時候我們只是想讓這臺機器上看起來是自己——比如演示、錄屏、或者多人共用同一賬號時區分不同機器——但賬號行跟着賬號走，改起來要麼改賬號資料，要麼乾脆不去動它。

dsh-plugin-custom-profile 就是把這一行改成本地值：只改本機顯示，不動賬號，也不上傳任何東西。下面是對這個插件的說明。

這是什麼¶

dsh-plugin-custom-profile 是一個 DSH 客戶端插件，維護者是 JonyFang，分類屬於「趣味換裝」。它的定位很窄：把側邊欄賬號行的暱稱和頭像替換成本地、按設備保存的值。

包名是 dsh-plugin-custom-profile，插件 id 是 plugin-custom-profile，當前版本 0.2.2-rc.1，許可證 MIT。寫成的客戶端基線是 0.2.2-rc.1；如果賬號行的 DOM 結構變了，插件會停止繪製而不是把頁面搞壞。

需要注意的是，這個插件做的是純本機顯示替換：賬號本身沒有被編輯，值也不會上傳。因此它換的是「你在自己機器上看到的名字和頭像」，不是賬號資料。

在 Settings → Profile 裏設置暱稱和頭像，保存後賬號行同步顯示。
支持的圖片格式：PNG、JPG、WebP、GIF、AVIF，單張上限 10 MB；會被裁成正方形，轉成 128×128 的 WebP（失敗時退回 PNG），GIF 只保留第一幀。
暱稱最多 32 個字符；留空則繼續顯示賬號名。
Reset 後保存，可以把賬號名和頭像還原；Cancel 丟棄未保存的編輯。
值跟着設備走，不跟賬號走：清站點數據或換設備後自定義會消失。
未登錄時不動賬號行；側邊欄摺疊時只顯示頭像。

一句話概括：它是在不碰賬號的前提下，給當前設備加一層顯示覆蓋。

推薦的兩種方式都來自官方 README。

方式一，直接在應用內操作。打開 Settings → Plugins → Install → Local directory，選擇這個倉庫的 checkout 目錄。等包發佈後，也可以直接搜索 dsh-plugin-custom-profile 安裝。

方式二，停掉應用後用命令行：

dsh plugin --profile desktop add /absolute/path/to/dsh-plugin-custom-profile

換成其他 profile 用 dsh plugin --profile <profile> add dsh-plugin-custom-profile，或用 github:<your-account>/dsh-plugin-custom-profile。這個插件不需要構建。

想手工接線，就把目錄軟鏈到該 profile 的 node_modules，並在 cordis.patch.yml 末尾追加：

- insert:
    - id: plugin-custom-profile
      name: dsh-plugin-custom-profile

如果 Profile 沒有出現，重啓應用。

安裝完後打開 Settings → Profile，填一個暱稱，選一張頭像，點 Save。賬號行左下角就會顯示同樣的值。想恢復原樣，點 Reset 再 Save；中途不想改，點 Cancel。

一個實際場景：同一賬號在多臺機器上跑 DSH，用這個插件給每臺機器設不同暱稱，只在本地生效，不影響賬號在別的機器和別的端的顯示。

適合想讓本機賬號行顯示個性化暱稱或頭像、又不願改動賬號資料的開發者，尤其適合演示、錄屏和多人共用賬號的場合。它只改顯示，不涉及賬號數據上傳。

幾點需要注意：

插件以當前 dsh 進程的權限運行，安裝前應先讀一遍源碼，確認行爲符合預期。許可證是 MIT。
如果已經裝了另一個繪製同一賬號行的插件，二者會衝突；這個插件不會導入對方保存的值。
客戶端版本變化是主要風險點。README 寫明基線是 0.2.2-rc.1，客戶端結構變更時插件會停止繪製；倉庫裏有每日 GitHub Action 盯着 Harness 頁面，客戶端更新後會爲 dsh-compat agent 開 issue。
運行環境要求 Node ^22.19.0 || >=24.0.0，DSH 客戶端 >=0.2.1-rc.5。倉庫當前 57 個測試，用 npm test 運行。

這個插件的價值在於把「改賬號行」拆成了「改本機顯示」：不碰賬號、不上傳、隨設備生效，需要還原時一鍵重置。如果只是想讓手邊這臺機器的側邊欄看起來像自己，它是很小但夠用的一個選擇。

目錄頁：https://www.skillhub.cn/plugins/JonyFang/dsh-plugin-custom-profile

GitHub：https://github.com/JonyFang/dsh-plugin-custom-profile