前言¶
DeepSeek Harness(DSH)的「插件」页会列出已安装的 bundle,卡片标题通常是包名(例如 dsh-memory-evolve)。包名便于唯一标识,但在本地管理很多插件时,纯英文包名并不总是最好记。你可以在脑子里记映射关系,也可以改 profile 或 fork 插件——前者容易忘,后者成本偏高。社区维护者 doudoudouhuahua 提供的 dsh-plugin-alias 走另一条路:不改插件包、不写 profile,只在浏览器里给已安装插件设别名,并把卡片标题显示成「别名(原包名)」。
这是什么¶
dsh-plugin-alias 是面向 DeepSeek Harness 的客户端插件(当前版本 0.1.0,许可证 MIT)。它在 DSH 插件页增加「别名」标签页,用来编辑别名;保存后,已安装列表里对应卡片的标题会变成类似 记忆进化(dsh-memory-evolve) 的形式。SkillHub 目录将其归类为「趣味换装」——本质是界面展示层的个性化,不改变插件行为。
维护者与源码仓库:doudoudouhuahua/dsh-plugin-alias。目录页:SkillHub 插件页。
核心功能¶
下面这些是 README 中明确描述的能力,均可在源码与自测中对应:
- 扩展点
plugins.tab:在插件页新增「别名」标签,集中编辑别名。 - 就地改写卡片标题:监听
li[data-plugin-package]节点,把标题文本改成「别名(原包名)」。 - 本地持久化:别名存在浏览器
localStorage,键名为dsh-plugin-alias:aliases;不写入 profile,不修改被别名的插件包。 - 卸载即恢复:卸掉本插件后,卡片标题立即恢复为原名;
localStorage里的别名数据仍可留在本机(可忽略)。
主机端 lib/index.js 仅为可加载 bundle 的空壳;逻辑在 lib/client.js(web 平台)。
安装与启用¶
在 DSH 会话里执行官方 README 给出的安装方式:
plugin_manager(action: "install_bundle", target: "github:doudoudouhuahua/dsh-plugin-alias")
也可以在 desktop profile 里用手动方式安装(link: + dsh.profile.bundles),然后重启 DSH。
安装完成后刷新页面(Ctrl+R)。若顶部没有出现「别名」标签,完全退出 DSH 再重新打开一次。
安全与权限说明:插件以当前 DSH 进程及其在浏览器中的权限运行;安装前建议通读仓库源码与 MIT 许可证,确认只接受本地 localStorage 读写与 DOM 改写这类行为。
典型用法¶
按 README 的可复现步骤操作:
- 打开侧栏「插件」页。
- 点击「别名」标签。
- 若列表为空,先切回「已安装」标签停留一两秒(插件名会自动收录),或在下方「手动添加」里输入包名。
- 在对应行输入别名;回车或失焦即保存,「清除」可恢复原名。
- 切回「已安装」标签,卡片标题应显示为「别名(原包名)」。
仓库提供无浏览器自测,需 Node 24:
node tests/headless-client.test.cjs
自测覆盖别名渲染、幂等、改名、清除恢复、收录、不误伤其他文本等 9 项。
适用场景与限制¶
适合谁:经常在 DSH 里装多个社区插件、希望插件页一眼能认出「这是哪个工具」的开发者;接受别名只在本机浏览器生效、不随 profile 同步到其他机器。
限制与注意(来自 README):
- 只改卡片标题,不影响插件功能。
- 仅当卡片标题显示为「原包名」时才会改写;若某插件自带本地化标题且文本中不含包名,则不会被改写。
- 依赖当前插件页 DOM 结构;DSH 大版本改版后可能需要维护。
- DSH 升级一般会保留以
link:安装在 profile 依赖里的本插件,升级后建议确认仍在。
卸载:从 profile 的 package.json 删除依赖与 bundles 项并重启 DSH;页面标题恢复原名,别名配置仍可能在 localStorage 中。
结尾¶
dsh-plugin-alias 用最小侵入的方式解决「插件页标题不好记」的问题:一个标签页编辑别名,卡片上统一成「别名(原包名)」格式。需要安装命令、用法细节或 issue 反馈,请以 GitHub 仓库为准;社区目录见 SkillHub,源码见 GitHub。