前言¶
DeepSeek Harness（dsh）裏，插件在「已安裝」列表裏顯示什麼名字，通常來自包內 locale/*.json 的 meta.title。第三方插件多了以後，包名、英文標題往往不好掃一眼區分。社區插件 dsh-plugin-namer（維護者 otm1998，目錄分類爲趣味換裝）提供一塊統一的「改名臺」：名字不是記在本機小賬本里自娛自樂，而是寫進目標插件自己的語言元數據，列表裏刷新後就是你起的名。
下面介紹它做什麼、怎麼裝、怎麼用，以及改磁盤時具體動哪些文件。
這是什麼¶
dsh-plugin-namer 是 dsh 插件，中英雙語界面。它列出當前 profile 下已安裝的第三方插件（一行：顯示名、包名、版本、作者自我介紹），你在輸入框裏起名並保存後，會把 meta.title 寫進該包自己的 locale/*.json；「插件 → 已安裝」讀到的就是新標題。支持一鍵「清除」，按備份逐字還原。
許可證：MIT（© YG）。GitHub 倉庫：https://github.com/otm1998/dsh-plugin-namer ；社區目錄頁：https://www.skillhub.cn/plugins/otm1998/dsh-plugin-namer 。
核心功能¶
經 README 與 package.json 覈實，能力邊界如下。
- 列出第三方插件：默認不顯示隨 dsh 安裝自帶的官方包（
availability: installation）；排查時可在本插件行配置showBundled: true顯示它們。 - 改名寫入元數據：修改目標包
locale/*.json中的meta.title；每個被改文件旁留<文件名>.plugin-namer.bak，備份只寫一次，不覆蓋最初原件。 - 無語言資源的包：新建
locale/zh.json、locale/en.json，並在該包package.json的exports裏補"./locale/*.json": "./locale/*.json"（package.json備份爲package.json.plugin-namer.bak）。這類情況界面上會標「待重啓生效」，需重啓 dsh 後列表才顯示新名。 - 只讀包：在
app.asar內、磁盤不可寫的包（多爲官方內置）標「只讀包 · 僅記賬」，改名賬本仍記在<DSH_HOME>/plugin-namer/names.json，但列表顯示名改不了。 - 本地賬本：
<DSH_HOME>/plugin-namer/names.json記錄你起的名；重裝/升級目標插件會覆蓋包內改動，賬本還在，對同一行再保存一次可批量找回。
不改任何代碼文件、不改插件業務配置、不聯網。
安裝與啓用¶
要求 dsh >= 0.2.1-rc.3（README 安裝說明寫 dsh 0.2.1+）。Node 引擎 >= 20.11。不依賴第三方運行時包。
從 GitHub 直接安裝（不必走 npm）：
dsh plugin --profile <你的 profile> add github:otm1998/dsh-plugin-namer
也可下載 Release 中的 dsh-plugin-namer-1.0.0.tgz 後本地安裝：
dsh plugin --profile <你的 profile> add <解壓或存放的路徑>/dsh-plugin-namer-1.0.0.tgz
桌面端也可把倉庫地址填進 插件 → 安裝 輸入框。
裝好後打開 插件 → 命名 標籤。客戶端掛在「插件」頁的 plugins.tab / settings.plugins.tab 兩個 slot，新舊兩套插件頁都能掛上。
典型用法¶
- 在「命名」頁輸入框裏給某個插件起名，回車保存。
- 刷新頁面；若該包本來就有
locale/*.json，界面標「已寫入元數據」，「已安裝」裏即爲新名字。 - 想改回去點「清除」，按
.plugin-namer.bak還原。
README 中的示意：把「插件市場」改成「市場臺」後，列表裏顯示的就是「市場臺」，而不是包名 dshmarket 等默認標題。
| 標記 | 含義 | 什麼時候出現 |
|---|---|---|
| 已寫入元數據 | 宿主已能讀到新名字 | 該包本來就有 locale/*.json |
| 待重啓生效 | 文件已寫好，但 exports 結構變更需啓動時加載 |
該包原本沒有語言資源，插件補了 locale 與 exports |
| 只讀包 · 僅記賬 | 包在 app.asar 內，磁盤不可寫 |
主要是 dsh 自帶官方包（默認不顯示） |
適用場景與注意¶
適合誰：裝了很多第三方 dsh 插件、希望在「已安裝」裏用統一、好記的中文或自定義標題掃列表的開發者。
務必知曉：
- 本插件會修改已安裝插件目錄下的文件（locale、必要時
package.json的 exports）。安裝前應閱讀源碼與 MIT 許可證，並理解它以當前 dsh 進程權限寫磁盤。 - 官方內置包在 asar 內只讀，無法改顯示名。
- 改完需刷新頁面；無 locale 的包改名後還需重啓 dsh。
- 重裝或升級某個插件會丟掉包內改名；賬本仍在，再保存即可恢復記錄。
兼容性：dsh >= 0.2.1-rc.3；倉庫當前版本 1.0.0（見 package.json）。
結尾¶
dsh-plugin-namer 把「給第三方插件起自己的名」做成可逆、可賬本找回的操作：寫進各包 meta.title，列表裏當真名顯示，而不是隻在筆記裏記一筆。需要安裝命令與邊界說明時，以 GitHub README 爲準。
- 社區目錄：https://www.skillhub.cn/plugins/otm1998/dsh-plugin-namer
- 源碼與文檔：https://github.com/otm1998/dsh-plugin-namer
