VS Code 主题画廊 zxbc/dsh-vscode-themes2

DeepSeek Harness 的 VS Code 主题

浏览、搜索、安装 VS Code 配色主题，并应用到 DeepSeek Harness（DSH）Web UI —— 一键即可实时换肤整个界面，用的还是主题自己的配色。

分类： UI 与体验 · 协议： MIT · 适用： DSH 0.2.1-alpha.1（web 配置档）

它能做什么

- 在 Harness Web UI 的 Settings 里加一个 「VS Code Themes」 区块。
- 内置一份精选目录，收录 14 款热门 VS Code 主题（One Dark Pro、Dracula、GitHub Light、Nord、Catppuccin Mocha、Tokyo Gogh Alt、Monokai Classic、Solarized、Kanagawa、Palenight Italic、Kimbie Dark……），每款都带实时色板预览，用主题自己的颜色渲染。
- 一个搜索框同时过滤本地主题（已安装 + 内置）并查询官方 VS Code Marketplace。Marketplace 的结果单独成区，带实时色板和 Install 按钮。
- 一键安装会下载主题的 .vsix，提取配色，再映射到 DSW 设计 token 上。装好的主题重启后依然保留，并排到最前面（最新的在前）。
- 点任意卡片就立刻应用主题 —— 整个 UI 实时换肤。你的选择重启后依然保留（浏览器 localStorage）。
- 主题如果下载、解析或映射失败（比如格式不兼容），会显示可见的错误，其余部分不受影响 —— 绝不会弄坏插件或界面其他部分。
- 每张卡片 —— 表面、预览、胶囊、描边，以及按钮（含悬停态）—— 都用主题自己的配色上色，所以无论当前应用的是哪款主题，这个画廊看起来都是忠实的预览。

截图

真实浏览器里的面板，已安装 marketplace 主题（上方显示已安装 30 款）。每张卡片实时预览自己的主题（示例文字、语义标签、强调色按钮）；已应用的那张卡片带着 Active 描边 + 胶囊，用的是它自己的强调色：

主题画廊

安装

在 DSH 配置档下（比如默认的 web 配置档）：

dsh plugin --profile web add github:zxbc/dsh-vscode-themes2

或者从本地克隆安装：

dsh plugin install /path/to/dsh-vscode-themes2

包名是 @local/dsh-vscode-themes2 —— 结尾的 2 是历史遗留（开发时有个早期标识符在运行中的 harness 进程里被缓存成了失败状态），它是安装名的一部分；敲命令时别去「修」它。

工作原理

这是个两半结构的 DSH 插件：浏览器侧网络受限，所以一切跟 VS Code Marketplace 通信的事都跑在宿主那一半，再通过一个名为 vscodeThemes 的 TypertRemoteService 暴露给浏览器（客户端用 ctx.remote.$mount 自行挂载）。

- 浏览器那一半（client.js） —— 渲染设置区块，用 ctx.theme.register({ id, colorScheme, tokens }) 注册主题，启动时应用持久化的选择加载，并把状态持久化到 localStorage（dsh.vscodeThemes.selected、 dsh.vscodeThemes.installed —— JSON 数组，最近的排在最前）。
- 宿主端（index.js + marketplace.js） —— 在远程服务上暴露 search(query) 和
fetchTheme(ext)，实际逻辑委托给 marketplace.js 里纯函数式的、可单元测试的实现
（不涉及 Cordis 接线）。

搜索会查询官方 VS Code Marketplace gallery API（仅限 themes 分类）；安装会从发布者的 gallery.vsassets.io CDN 下载主题的 .vsix，在进程内解析 ZIP，并读取主题的 JSONC 颜色定义（解析前会先去掉注释和尾随逗号）。完整的协议细节和边界情况见 PROGRESS.md。

权限与外部服务

- 出站网络（仅宿主端）：
- POST https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery ——主题搜索，只在你输入查询（2 个字符以上）时触发。
- GET https://{publisher}.gallery.vsassets.io/…vspackage —— .vsix 下载，只在你明确点击 Install 时触发。
- 没有遥测，没有其他网络调用。 所有解析和 token 映射都在宿主进程本地完成。
- 浏览器状态： 仅 localStorage（dsh.vscodeThemes.*）。不会上传任何东西。

兼容性

- DSH 0.2.1-alpha.1，web 配置档（客户端部分注入到 Web UI）。
- 宿主端：Node 18+（用 DecompressionStream 解压 .vsix 文件）。
- 已知限制：marketplace 主题如果没有可解析的 editor.background / editor.foreground，会被跳过并显示错误信息。

面向开发者

PROGRESS.md 是项目的开发日志：架构说明、 marketplace 协议细节、关键契约与坑，以及会话记录。
它由智能体维护 —— 改动 client.js 或 marketplace.js 之前先读它。

文件

| 文件 | 用途 |
| index.js | 宿主端：VscodeThemes 远程服务（search / fetchTheme）。 |
| client.js | 浏览器端：主题目录、marketplace 搜索 UI、安装、持久化、设置 UI。 |
| marketplace.js | 纯宿主逻辑：marketplace 搜索、vsix 获取/解析、token 映射。 |
| cordis.patch.yml | 把 vscode-themes2 条目插入配置档树。 |
| locale/en.json | Plugin Manager 显示用的标题/描述。 |
| icon.svg | 插件图标。 |
| screenshots/ | 本 README 中嵌入的图库截图。 |
| PROGRESS.md | 开发日志与会话记录。 |

许可证

MIT —— 见 LICENSE 文件。