前言¶
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
