跳到主内容

ui-codepilot-theme 使用指南

为 DSH Web/Desktop 客户端换上 CodePilot 视觉皮肤的纯表现层主题包,不改交互逻辑与模型上下文。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

pilot-harness (ui-codepilot-theme)

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:op7418/pilot-harness#path:packages/client/ui-codepilot-theme

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 真正的桌面客户端——Electron 将本地 Harness 运行时打包到 macOS、Windows 与 Linux,负责原生窗口行为,并在启动异常时提供恢复页面。
  • 更安静的 CodePilot 风格界面——统一 Token、圆角、菜单、Hover、设置卡片、Markdown、对话/轨迹切换与平台化标题栏。
  • 服务商与模型管理——连接受支持的服务商,声明 OpenAI 兼容接口,将凭证和普通设置分开管理,浏览实时模型目录,并识别支持图片输入的模型。
  • 不杂乱的工作区上下文——对话列表可展示分支、状态、提醒摘要、模式与模型,Files 则作为真正的右侧栏打开。
  • 插件优先的扩展方式——主题、Worktree 侧栏、Schedule 摘要与 Session 日志导出仍是 Cordis/DeepSeek Harness 配置行,而不是写死在桌面端的业务逻辑。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后怎么确认生效?

重启 Web profile 后执行 dsh --profile web --dump-config,能看到 codepilot-theme 节点即表示加载成功;也可以直接打开客户端看侧边栏/空会话页是否已经换上 CodePilot 视觉。

怎么卸载回到原主题?

执行 dsh plugin --profile web remove @deepseek-ai/dsh-client-ui-codepilot-theme,重启 profile 即可。插件卸载时会自动清除 data-codepilot-theme 标记并还原你之前的状态。

装上之后会不会改变模型回答、对话内容或工具行为?

不会。源码与 README 都明确说明它不注册任何面向模型的上下文、工具、事件或请求内容,纯属客户端表现层替换。

桌面端和浏览器端都能用吗?

都能。浏览器端只应用同一份 CSS;桌面端多走一步:把当前主题(system/light/dark)通过 Electron preload 桥同步给原生窗口,让标题栏、材质、窗口背板跟随切换。

装这个主题会让我之前的 KV 缓存失效吗?

不会。README 写明 Model Experience 与 KV Cache 影响均为"无",加载或卸载只影响客户端显示,不动模型输入。

跟我已经装的别的样式/主题插件会冲突吗?

浅色和深色两边都覆盖了同一组 Pilot 与 Harness 语义 token,加载顺序靠后的插件样式不会留下浅色文字、侧栏材质等错位值;卸载则干净还原,不互相污染。

如果产品图标文件改了,主题会自己更新吗?

不会自动更新。每次改动 apps/desktop/assets/icon-master.png 后,需要在仓库根目录手动跑一次 pnpm --filter @deepseek-ai/dsh-desktop run icons 来重新生成 bundle 里的品牌样式表。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.7+
  • Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则