dsh-plugin-namecards

Plugin Namecards

插件名片：给插件换图标、中文名和说明，按文件夹/收藏整理，支持拖拽排序、列表/铺陈视图与启停开关；只改显示，不动插件本身。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-namecards@0.6.6

兼容性与来源证明

Plugin Namecards 以 dsh-plugin-namecards 发布，当前版本为 0.6.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: npm
Registry 更新时间: 2026/11/1

版本

0.6.6stable

2026/11/1

0.6.2stable

2026/10/19

0.5.1stable

2026/10/19

查看其余 3 个版本收起版本

0.4.4stable

2026/10/18

0.3.14stable

2026/10/18

0.3.4stable

2026/10/18

README

插件名片（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

README

插件名片（dsh-plugin-namecards）

两个页签

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

插件管理

工具栏：搜索 · 列表/铺陈 · ＋新建文件夹 · 按备注名排序 · 启用名片覆盖 · 导入 · 导出 · 刷新；
列表：收藏 → 自定义文件夹 → 未分组；组合包行可展开子行；行上可收藏、开关、更多操作；
按备注名排序：对所有文件夹与文件夹弹窗生效（备注名拼音）；关闭后回到拖拽顺序；
铺陈：图标网格（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

Plugin Namecards

兼容性与来源证明

版本

相关插件

Plugin Namecards

README

插件名片（dsh-plugin-namecards）

两个页签

插件管理

更新记录

安装

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

本地目录安装（开发）

从 npm 安装

兼容性与安全

数据

已知限制

自测

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

插件名片（dsh-plugin-namecards）

两个页签

插件管理

更新记录

安装

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

本地目录安装（开发）

从 npm 安装

兼容性与安全

数据

已知限制

自测