前言¶

DeepSeek Harness（DSH）里插件一多，官方「已安装」页往往只有包名和英文说明，图标也参差不齐。想按项目或习惯分组、给常用插件起中文备注，又不想去改 cordis 或动插件源码。社区插件 dsh-plugin-namecards（维护者 3Tiga3，分类：趣味换装）只做展示层：覆盖图标、中文名（备注）和中文说明，并用文件夹、收藏、拖拽排序和列表/铺陈视图整理；启用开关仍走官方插件管理器，不修改插件文件本身。

这是什么¶

插件名片（npm 包名 dsh-plugin-namecards，当前版本 0.6.2，MIT 许可证）是面向 DSH Web 客户端的插件。宿主侧仅包装 pluginManager.listBundles() 的返回值以替换展示字段；本地 HTTP 路由只接受回环地址，不联网、不上传数据。在 DSH 0.2.1-rc.2 桌面端测试通过，声明 engines.dsh: >=0.2.0-rc.1。

目录页：https://www.skillhub.cn/plugins/3Tiga3/dsh-plugin-namecards
源码：https://github.com/3Tiga3/dsh-plugin-namecards

两个页签分别做什么¶

官方「已安装」页结构不可改，整理与编辑都在「插件管理」页完成。

核心功能¶

名片与自动图标¶

• 为每个插件设置图标、备注（显示名称）、中文说明（支持多行；列表视图只显示单行并省略）。
• 自动图标：装载后为所有插件按名称/说明匹配分类补图标，不覆盖你手动设过的；未安装条目也会补齐。
• 恢复预设：一键清空自定义名片与布局，重新生成默认图标、实验性插件文件夹、子代理插件文件夹与官方中文备注。

插件管理界面¶

工具栏提供：搜索、列表/铺陈切换、＋新建文件夹、按备注名排序、启用名片覆盖、导入、导出、刷新。

• 列表：顺序为收藏 → 自定义文件夹 → 未分组；组合包行可展开子行；行上可收藏、开关、更多操作。
• 按备注名排序：对所有文件夹与文件夹弹窗按备注名拼音排序；关闭后回到拖拽顺序。
• 铺陈：72px 图标网格，图标下为开关和备注名；文件夹为缩略方块，点开后仅显示图标，点弹窗外空白退出。
• 点插件行或图标 → 右侧「编辑名片」抽屉：可改图标、中文说明、备注、所在文件夹；点抽屉外空白或 Esc 关闭。

数据与迁移¶

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

已知限制¶

• 「已安装」页说明在列表里只有一行展示。
• 依赖宿主内部接口做展示替换，DSH 大版本升级后可能需要适配。
• 部分启停改动需要重启后生效；路由仅 loopback，只在本机可用。

安装与启用¶

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

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

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

本地目录安装（开发）¶

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

从 npm 安装¶

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

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

典型用法¶

1. 安装并重启后，打开 插件管理 页，确认工具栏中 启用名片覆盖 已打开。
2. 在列表或铺陈视图中点某插件，在右侧抽屉里改图标、备注名和中文说明，并选择 所在文件夹；需要时用工具栏 ＋新建文件夹 和拖拽调整顺序。
3. 常用插件点行上的收藏；需要按中文备注查找时，可临时开启 按备注名排序。
4. 换机或备份：工具栏 导出 JSON，在新环境 导入 即可恢复名片与图标。
5. 回到官方 已安装 页核对：图标与名称/说明应已与名片一致；启停开关仍调用官方 setBundleEnabled / setPluginEnabled。

适用场景与注意¶

适合插件数量多、希望用中文备注和文件夹管理展示、又不想动各插件仓库的 DSH 用户。插件以当前 DSH 进程权限运行，安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。DSH 社区目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-plugin-namecards 把「插件页像通讯录一样可读、可分组」落在纯展示层：名片数据在本地 JSON，导入导出可备份。需要安装命令与细节时，以仓库 README 为准。

• 目录页：https://www.skillhub.cn/plugins/3Tiga3/dsh-plugin-namecards
• GitHub：https://github.com/3Tiga3/dsh-plugin-namecards