dsh-plugin-nickname

dsh插件名称修改

English | 中文

给 DeepSeek Harness (dsh) 插件列表里的插件自定义中文备注名，直接显示在原生插件设置页；支持按备注/标签分组、分组折叠、官方插件保护与自定义标签。

功能

• 自动把插件列表里的英文包名替换成自定义中文备注，悬停显示原来的英文包名
• 可视化编辑面板：左下角「📝 备注」按钮，或按 Ctrl+Shift+N 打开
• 自动扫描当前已安装的所有插件，直接编辑备注；备注保存在浏览器 localStorage 里，永久生效
• 🛡 官方插件默认不可改名：@deepseek-ai/* 与 dsh 内置 bundle 标「官方」且输入框禁用；面板「高级」可开「改官方」开关放开限制
• 🗂 分组显示：可按「是否有备注」或「按标签」分组，分组标题可点击折叠/展开，状态记忆
• 🏷 自定义标签：条目内「+ 标签」新建并打标，可切换/删除；固定分类「官方 / 已修改 / 未修改」自动打标
• 🔍 搜索框、按原名/备注名排序、导出/导入备份、按钮拖动、总开关、一键重置

安装

方式一：GitHub 仓库直接安装（推荐）

桌面端（DSH 0.2.0-rc.2）：在侧栏打开「插件 → 添加插件」，粘贴下面的地址，安装后选择「立即启用」。若应用提示需要重启，按提示操作。

github:sanlisanxun/dsh-plugin-nickname

方式二：本地目录安装

1. 下载本项目，解压到本地文件夹
2. 打开 dsh → 插件 → 添加插件
3. 输入本地文件夹的完整路径，点安装
4. 刷新页面生效

使用

安装后：

• 点左下角的「📝 备注」按钮，或按 Ctrl+Shift+N 打开编辑面板
• 在输入框里直接改中文名字，按 Tab 键保存
• 留空则恢复原来的英文包名

目录结构

dsh-plugin-nickname/
├── lib/
│   ├── index.js      # Host 端插件入口
│   └── client.js     # 客户端脚本（注入到浏览器页面）
├── cordis.patch.yml  # Cordis 挂载补丁
├── package.json      # 包配置
├── README.md         # 项目说明
└── LICENSE           # 开源协议

更新日志

完整更新日志见 CHANGELOG.md。

v0.3.2

• 🏷 新增分组标签：面板「按…分组」新增「按标签分组」（与「按是否有备注分组」并存）；固定分类「官方 / 已修改 / 未修改」自动打标；用户可自建自定义标签并在条目内点选打标，「高级」区可管理/删除

v0.3.1

• 🗂 分组可折叠：分组显示时点击分组标题可展开/收起，折叠状态持久化，标题左侧指示符 ▾ 展开 / ▸ 收起

v0.3.0

• 🛡 官方插件默认不可改名：@deepseek-ai/* 与 dsh 内置 bundle 不再被替换，面板里标「官方」且输入框禁用
• ✨ 新增「改官方」开关：需要时勾上即可解除屏蔽
• ✨ 保存备注前增加官方插件拦截，绕过界面也写不进去

v0.2.9

• 🐛 修复真实浏览器下备注不生效：替换守卫用 childNodes.length <= 2 计数，换行空白文本节点会让它变成 3 而被挡掉；改为只按元素子节点计数，与渲染方式无关
• 🐛 修复插件改写自己界面：编辑面板里的包名标签会被自己的替换逻辑覆盖，导致标签显示成备注名；现在跳过所有 [data-nickname-ui] 内部节点
• ✅ 新增真实浏览器验证 npm run test:browser（Chromium 加载 tests/harness/index.html，7 条断言）

v0.2.8

• 🐛 修复备注完全不生效：dsh 的插件名在 <button class="cardTitle"> 里，外层还有两层 div；「只改写文本节点」后容器里没有直接文本节点，替换被整体跳过。现改为向下定位真正承载文本的叶子节点再写入
• 🐛 修复标题按钮被抹掉：旧版用 textContent 覆盖容器会连 <button>、图标、描述一起清空，列表项点不开
• ✨ 支持 dsh「显示名 (包名)」标题形式，如 dsh-context 的 上下文 (dsh-context)
• ✨ 默认扫描选择器补上 button
• ⚡ 面板列表改以 dsh 卡片上的 data-plugin-package 为准收集已安装插件，不再只靠文本猜测

v0.2.7

• ✨ 支持无 __ModuleLoader__ 的宿主环境（dsh web 版）：检测不到模块加载器时自行启动
• ✨ 存储读写增加内存兜底：localStorage 不可用（隐私模式 / web 版）时不再中断
• ⚡ 取消固定等待 1 秒：改为立即初始化 + 最多约 2 秒重试，按钮与备注即时生效
• ✨ 面板「高级」新增扫描选择器与包名正则配置，dsh 改版导致 DOM 结构变化时无需改代码
• 🐛 dispose 改为按会话标记多轮清扫（0 / 200 / 600ms），清掉宿主在 dispose 之后补渲染的残留
• ✨ 检测不到插件列表时给出「点此刷新页面」提示，面板新增「刷新页面使改动生效」按钮

v0.2.6

• 🐛 修复替换插件名时误伤子元素：改为只改写直接文本节点，不再用 textContent 覆盖整个卡片
• 🐛 修复包名前缀冲突：dsh.plugin 与 dsh.plugin-manager 这类存在包含关系时，改为长包名优先
• 🐛 修复备注名含引号/尖括号时破坏面板结构：包名与备注在渲染前做 HTML 转义
• 🐛 修复重置或导入备注后面板被关闭：修正 openEditPanel 的开关语义
• 🐛 修复反复开关面板在 <head> 累积 <style> 标签，关闭时同步移除样式与外部点击监听
• 🐛 完善 dispose：补充清理 MutationObserver 防抖定时器与 window.__setPluginNickname 等全局挂载
• 🐛 修复导出 JSON 时 URL 回收过快可能中断下载
• ⚡ 优化 MutationObserver：防抖定时器收进闭包，扫描后丢弃自身写入触发的变更记录

v0.2.5

• 🐛 修复编辑面板样式注入变量未声明（style → styleEl）：严格模式下不再抛 ReferenceError，面板可正常打开
• 🐛 修复 dispose 时样式标签无法移除导致的残留

v0.2.4

• ✨ 新增卸载插件按钮：一键清除所有本地数据，并提示在 dsh 插件列表完成卸载

v0.2.3

• 🐛 修复关闭插件后 UI 残留，完善 dispose 清理逻辑

v0.2.2

• ✨ 新增排序功能：支持按原名/备注名排序
• ✨ 新增分组功能：按是否有备注分组显示
• ✨ 优化 UI 样式：更美观的深色主题设计

v0.2.1

• 🎨 优化 UI 样式，和 dsh 深色主题更匹配
• 按钮加了悬停效果和动画

v0.2.0

• ✨ 新增总开关：一键启用/禁用所有备注替换
• ✨ 新增重置按钮：一键清除所有自定义备注
• ✨ 新增按钮拖动：左下角的备注按钮可以拖到任意位置
• ✨ 按钮位置自动保存，刷新后位置不变

v0.1.2

• 🐛 修复 bug：关闭插件后遗留按钮的问题
• 卸载插件时自动清理所有 DOM 元素和事件监听

v0.1.1

• ✨ 新增搜索框：插件多的时候快速查找
• ✨ 新增导出/导入功能：备份你的备注设置
• ✨ 优化交互：点击面板外面自动关闭

v0.1.0

• 🎉 首次发布
• 支持自定义插件中文备注名
• 支持可视化编辑面板
• 支持快捷键 Ctrl+Shift+N 打开面板

技术文档

详见 docs/技术文档.md

免责声明

1. 本软件仅供个人学习、研究和技术交流使用，不得用于任何非法或商业用途。
2. 使用本软件时，请遵守您所在地区的相关法律法规，不得利用本软件从事任何违法违规活动。
3. 因使用本软件而产生的任何直接或间接后果，由使用者自行承担，软件作者不承担任何责任。
4. 本软件按 "现状" 提供，不提供任何明示或暗示的担保。

协议

MIT License