插件名片 3Tiga3/dsh-plugin-namecards

插件名片（dsh-plugin-namecards）

给 DSH「插件」页里的插件换图标、中文名（备注）和中文说明，并用文件夹、收藏、拖拽排序、列表/铺陈两种视图来管理。只改显示：不修改插件文件、不写 cordis 配置；唯一的写操作是你在界面里拨动的启用开关（转调官方插件管理器）。

两个页签

| 页签 | 作用 |
| 已安装 | 官方页面；列表里的图标/名称/说明会被名片覆盖 |
| 插件管理 | 编辑名片 + 文件夹 + 收藏 + 排序 + 列表/铺陈 + 启停开关 |

插件管理

- 工具栏：搜索 · 列表/铺陈 · ＋新建文件夹 · 按备注名排序 · 启用名片覆盖 · 导入 · 导出 · 刷新；
- 列表：收藏 → 自定义文件夹 → 未分组；组合包行可展开子行；行上可收藏、开关、更多操作；
- 按备注名排序：对所有文件夹与文件夹弹窗生效（备注名拼音）；关闭后回到拖拽顺序；
- 铺陈：图标网格（72px），图标下是开关和备注名；文件夹是缩略方块，点开后显示其中的插件（毛玻璃遮罩覆盖整个窗口）；
- 点插件行/图标 → 右侧「编辑名片」抽屉：图标、中文说明（支持多行，列表只显示单行省略号）、备注（显示名称）、所在文件夹；点抽屉外空白或 Esc 关闭；
- 文件夹弹窗内：点插件打开编辑名片，名片浮在弹窗之上；点空白处先退出名片、文件夹保留，再点一下才退出文件夹；Esc 同样逐层退出；
- 「恢复预设」：一键清空自定义名片与布局，重新生成默认图标、实验性插件文件夹、子代理插件文件夹与官方中文备注；
- 自动图标：装载后会为所有插件补一个合适的图标（按名称/说明匹配分类；不会覆盖你手动设过的）；插件升级后若新版本带作者内置图标，会自动改用作者图标，没有作者图标则保持原样；未安装条目也一并补齐。

更新记录

- 0.6.6：文件夹弹窗里打开编辑名片后，点空白第一下只退出名片、文件夹保留；再点一下才退出文件夹；Esc 逐层退出。
- 0.6.5：编辑名片改为行内 z-index，稳定浮在文件夹弹窗遮罩之上；开关提示 toast 同样置顶。
- 0.6.3：插件升级后，若新版本带作者内置图标则自动改用作者图标，否则保持原样（新增版本基线，首次运行只记录基线）。
- 0.6.2：文件夹/对话框遮罩改为全屏毛玻璃（覆盖标题栏、侧边栏），点空白关闭。

安装

从 GitHub 安装（推荐，无需 npm）

dsh plugin --profile web add github:3Tiga3/dsh-plugin-namecards

桌面版：插件页 → 添加插件 → 安装第三方插件 → 填 GitHub 地址。

本地目录安装（开发）

插件页 → 添加插件 → 安装第三方插件 → 填本仓库的绝对路径。

从 npm 安装

dsh plugin --profile web add dsh-plugin-namecards

安装后重启一次应用（宿主半边需要重启）；之后只改客户端/样式时刷新页面即可。

兼容性与安全

- 在 DSH 0.2.1-rc.2 / rc.3 上测试通过（桌面端）；声明 engines.dsh: >=0.2.0-rc.1。
- 宿主半边只包装 pluginManager.listBundles() 的返回值，用于替换展示字段；不修改任何插件文件、不写 cordis 配置。
- 本地 HTTP 路由只接受回环地址请求；不联网、不上传任何数据。
- 启用开关转调官方 setBundleEnabled / setPluginEnabled，部分改动需要重启后生效。

数据

- %USERPROFILE%\.dsh\dsh-plugin-namecards\cards.json：名片、文件夹、收藏、顺序、视图
- %USERPROFILE%\.dsh\dsh-plugin-namecards\icons\：上传的图标
- 导入 / 导出：导出 JSON 含图标（内置 id + 上传图 base64）、备注名、中文说明、文件夹名称与内容、排序；导入会连同图标一起恢复。
- 从旧版（dsh-plugin-cards / ~/.dsh/plugin-cards）升级时，数据会自动迁移并保留旧目录。

已知限制

- 官方「已安装」页结构不可改，管理界面都在「插件管理」页；
- 卡片说明只有一行；
- 依赖宿主内部接口做展示替换，DSH 大版本升级后可能需要适配；
- 只在本机可用（路由 loopback）。

自测

node test/run-host.mjs
node test/run-client.mjs