suntianc/dsh-ui-settings-icons

DSH 兼容性： 0.1.3-rc.2 以 DSH 0.2.0-rc.1 为最低且已测试的开发基线；旧版 DSH 请使用兼容的插件版本。见验证说明。

English | 中文

发布版本：v0.1.3-rc.2（npm 标签：rc）。

这是一个自包含的 DeepSeek Harness 界面扩展插件。它为 DSH 的设置导航侧边栏增加了自定义图标能力，开放了全新的 keyed 图标槽位（settings.section.icon）供第三方插件使用，并为常见的扩展包内置了精美矢量图标预设。

0.1.3-rc.2：适配 DSH 0.2.0-rc.1

此版本更新 DSH 依赖图，并跟随 0.2 版设置外壳的 Config Forms、共享快捷键、launcher 槽、模态层、引导状态、桌面更新提示与通用设置行。替代 Host 条目沿用 ui-settings-general ID，使内置欢迎说明继续保存确认状态；keyed 图标槽仍可使用。完整包检查与固定源码检查已通过，尚未验证真实 Web/Desktop profile。

0.1.3-rc.1：DSH 0.1.5-rc.1 适配

适配 DSH 0.1.5-rc.1，同步上游设置按钮的本地化无障碍名称，包括仅显示图标的紧凑模式；中英文回归测试覆盖打开对话框与焦点恢复。

开发基线升级到 DSH 0.1.5-rc.1，中英文自动重连文案与上游设置外壳对齐。图标槽位、对话框快捷键、焦点恢复与手动重连行为继续保留。

功能

Keyed 图标槽位 (settings.section.icon)

• 在设置面板外壳下声明了全新的 keyed 子槽位 settings.section.icon。
• 任何通过 settings.section 注册设置分区的第三方插件，均可通过匹配自身分区的 id 注入自定义 SVG 或 React 图标组件。
• 响应式动态联动：图标更新深度绑定 SlotCore 账本，无需重启界面即可动态响应变化。

内置图标预设与优雅回退

• 为以下常见功能分区内置了精美的 16x16 矢量图标：
  • codex-auth / GPT Auth（OpenAI / ChatGPT 官方徽标）
  • antigravity-auth（Google Antigravity / Gemini 星芒徽标）
  • DSH 原生分区：models、agent-presets、plugins
• 当某个分区未提供自定义图标且不匹配任何预设时，自动回退到 DSH 标准齿轮图标（IconSettingsOutline16）。

完整的交互与无障碍对齐

• 与 DSH 官方默认设置面板保持 100% 的视觉风格和交互体验对齐。
• 完整支持键盘快捷操作（Escape 键关闭并将焦点还原到触发按钮）、ARIA 对话框无障碍属性（aria-modal、aria-labelledby、aria-current）、侧边栏宽/窄展开自适应、当前连接恢复/重连反馈，以及原生配置文件打开操作（settings.action / open-document）。

零冲突的 Cordis 插件组合

• 通过 cordis.patch.yml 替换官方默认的 ui-settings-general，彻底避免子槽位重复声明冲突。
• 严格遵循 DSH 的生命周期模型：所有子槽位、字典注册与状态订阅在插件卸载时均会干净释放。

接入第三方插件图标

如果你正在开发 DSH 插件，并希望为自己的设置分区提供专属导航图标：

import type { Context } from '@deepseek-ai/cordis'
import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
import type {} from 'dsh-ui-settings-icons/client'
import { MyPluginIcon } from './MyPluginIcon.tsx'
import { MySettingsPanel } from './MySettingsPanel.tsx'

export function apply(ctx: Context): void {
  // 1. 注册设置分区主体内容
  ctx.slots.inject('settings.section', () => ctx.slots.register({
    name: 'settings.section',
    id: 'my-plugin',
    order: 50,
    label: () => 'My Plugin',
  }, MySettingsPanel))

  // 2. 注册导航图标（key 对应 settings.section 的 id）
  ctx.slots.inject('settings.section.icon', () => ctx.slots.register({
    name: 'settings.section.icon',
    key: 'my-plugin',
  }, MyPluginIcon))
}

环境要求

• DeepSeek Harness 0.2.0-rc.1（统一依赖图）。
• Node.js ^22.19.0 或 >=24.0.0。

插件 0.1.2 及更早版本面向已退役的 DSH 0.1.1-rc.1 客户端拓扑，无法在 0.1.2-alpha.5 上加载。

安装

先停止 dsh web，确认目标 Host 使用统一的 DSH 0.2.0-rc.1 依赖图，再将此准确预发布版本安装到目标 profile：

dsh --version
dsh plugin --profile web add dsh-ui-settings-icons@0.1.3-rc.2
dsh plugin --profile web list

核对条目后重启 dsh web 并刷新浏览器。此版本通过 npm 的 rc 标签发布；不指定版本或标签会使用 latest，它不包含本次 DSH 0.2 适配。旧 DSH Host 应保留兼容的旧插件版本。

Host 配置

能力包 patch 替换了原版的 ui-settings-general 行：

行	Export	作用
ui-settings-general（禁用）	@deepseek-ai/dsh-client-ui-settings-general	禁用以避免子槽位重复声明冲突
ui-settings-icons	dsh-ui-settings-icons	增强版设置面板外壳，提供图标槽位与预设

开发

pnpm install
pnpm run check

pnpm run build 生成：

• lib/index.js：Host 插件入口；
• lib/invariant.js：Slot 常量伴侣模块；
• lib/client.cjs：兼容 Loader、内联 CSS Modules 的浏览器插件；
• lib/types/**：类型声明。

友情链接

• L 站