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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则