READMESource: main@ff40facb
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
方式二:本地目录安装
- 下载本项目,解压到本地文件夹
- 打开 dsh → 插件 → 添加插件
- 输入本地文件夹的完整路径,点安装
- 刷新页面生效
使用
安装后:
- 点左下角的「📝 备注」按钮,或按
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
免责声明
- 本软件仅供个人学习、研究和技术交流使用,不得用于任何非法或商业用途。
- 使用本软件时,请遵守您所在地区的相关法律法规,不得利用本软件从事任何违法违规活动。
- 因使用本软件而产生的任何直接或间接后果,由使用者自行承担,软件作者不承担任何责任。
- 本软件按 "现状" 提供,不提供任何明示或暗示的担保。
协议
MIT License
No comments yet. Be the first to write one.