主题与会话头 MikeTheWiTness/dsh-profile-plugins

dsh-profile-plugins

给 DeepSeek Harness 的 profile 用的两个插件：

| 插件 | 做什么 |
| dsh-claude-theme | 把整个界面换成 Claude（Anthropic）风格配色：奶油纸感浅色 + 暖深灰深色，珊瑚强调色 |
| dsh-opencode-session | 给每个出站推理请求打上稳定的、按会话区分的 session id 头（OpenCode Go） |

两个都是纯 profile 插件：harness 本体一个字节都不改，删掉即完全恢复。

每个插件就是一个包，零依赖、自包含：宿主半侧（以及客户端半侧）和它自己的组合包 patch（dsh.bundle.patch → cordis.patch.yml）在同一个包里，所以每个包都能单独安装、单独启停，也能直接放进 profile 的 node_modules 手工挂载——不需要第二个“组合包”包。

调色板

安装

需要先有一个已经启动过一次的 profile（默认 ~/.dsh/profiles/desktop， Windows 上是 %USERPROFILE%\.dsh\profiles\desktop）。

Windows

git clone https://github.com/MikeTheWiTness/dsh-profile-plugins.git
cd dsh-profile-plugins
.\install.ps1 # 默认装进 ~\.dsh\profiles\desktop .\install.ps1 -ProfileDir "$HOME\.dsh\profiles\web" # 或指定 profile .\install.ps1 -DryRun # 只看会改什么

macOS / Linux

git clone https://github.com/MikeTheWiTness/dsh-profile-plugins.git
cd dsh-profile-plugins
./install.sh # 默认装进 ~/.dsh/profiles/desktop ./install.sh ~/.dsh/profiles/web # 或指定 profile 目录 ./install.sh --dry-run # 只看会改什么

两个脚本都做三件事，且都是幂等的：

1. 把 plugins/ 复制到 /plugins/；
2. 在 /node_modules/ 下建链接——Windows 用 NTFS junction（不需要管理员）， macOS / Linux 用符号链接；
3. 把两个 file: 依赖与两个组合包写进 /package.json （改前备份成 package.json.bak-，写后校验，坏了自动回滚）。

然后重启 DeepSeek Harness。 dsh.profile.bundles 是启动时组合的，不重启不会生效。

手工安装

不想跑脚本的话，等价于：

/package.json
{
"dependencies": {
"dsh-claude-theme": "file:plugins/claude-theme",
"dsh-opencode-session": "file:plugins/opencode-session"
},
"dsh": { "profile": { "bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-opencode-session",
"dsh-claude-theme"
] } }
}

再把 plugins/ 放进 profile，并让 /node_modules/ 指向它。
注意同一个包名同时出现在 dependencies（包从哪来）和 dsh.profile.bundles （要不要挂它的 patch）里。

也可以让 harness 自己装：图形界面的「插件」页 → 安装 → 本地路径，分别安装 /plugins/claude-theme 与 /plugins/opencode-session；两个包都声明了 dsh.bundle，装完默认启用。用 harness 自带的 pnpm （/resources/runtime/pnpm）最稳，系统 PATH 里不一定有。

不要用仓库 URL（github:MikeTheWiTness/dsh-profile-plugins）安装。
仓库根目录是个容器，本身不是包；而 DSH 只检查被装进来的那个包有没有 dsh.bundle，根包没有 → 报 not-bundle 并把 profile 的 package.json / pnpm-lock.yaml 回滚。要让仓库 URL 一键安装成立，得把这两个包发布到 npm，再让根目录自己成为一个依赖它们的组合包。

dsh-claude-theme

DSH 的全部颜色都走 --dsw- 设计令牌。这个插件向官方的第三方扩展点
ctx.theme.overrideTokens() 叠加一层 111 个令牌的覆盖，由 ui-layout 的
presenter 以内联样式落到 body 上——内联样式一定压过主题样式表，所以必然生效，卸载即整层还原。

- 浅色：奶油画布 #FAF9F5、白卡片、暖米色描边 #E8E6DC、墨色文字 #141413 （刻意避开原主题的冷蓝灰 bluish 系列）
- 深色：暖深灰 #262624（不是近黑）、#30302E 浮起面、暖白文字 #F5F4EF
- 强调色：整条 deepseek 蓝梯度换成珊瑚梯度，于是链接、信息按钮、业务状态色、焦点环、选中态一起跟随；主按钮改珊瑚实心 + 白字，品牌字标保留墨色（就是 Claude“黑字标 + 珊瑚按钮”的关系）
- 语义色换成 Claude 的绿 / 琥珀 / 红；侧栏、会话气泡、代码块、滚动条、菜单浮层、
::selection 全部转暖

深浅两种模式一层通吃，切「设置 → 外观」时按 colorScheme 重新取色。

换强调色

两个预设，不用改代码：

| 预设 | 色值 | 说明 |
| claude | #D97757 | claude.ai 产品界面的暖珊瑚，默认 |
| bookcloth | #CC785C | Anthropic 品牌 "Book Cloth"，更偏赭石 |

// 浏览器控制台，然后刷新页面
localStorage.setItem('dsh-claude-theme:accent', 'bookcloth')
localStorage.setItem('dsh-claude-theme:accent', 'claude') // 恢复默认

或在页面加载前挂全局（还可以逐令牌覆盖，优先级最高）：

window.__DSH_CLAUDE_THEME__ = {
accent: 'bookcloth',
tokens: { '--dsw-alias-bg-base': { light: '#FFFFFF', dark: '#1A1A18' } },
}

改整张色板

只改 plugins/claude-theme/lib/client.js 顶部的两张表，保存后刷新页面即可（客户端 bundle 按文件 mtime 发布 revision，不用重新构建）：

- NEUTRALS —— 与强调色无关的中性色，键是令牌名，值是 [浅色, 深色]
- ACCENTS —— 强调色预设：ramp 是替换 --dsw-static-deepseek- 的梯度，其余字段是必须与强调色同步的语义令牌

细节和实现理由见 plugins/claude-theme/README.md。

dsh-opencode-session

给 opencode.ai 的推理请求盖上会话 id：

x-opencode-session:
x-deepseek-harness-session-id:

默认只盖章 POST /zen/go/*，模型列表这类 GET 不动；overwrite: false 表示请求上已有的同名头优先。配置项和实现要点见 plugins/opencode-session/README.md。

停用 / 卸载

临时停用（保留文件）——在 profile 的 cordis.patch.yml 里按行 id 覆盖，然后重启：

- id: claude-theme
disabled: true
或者
- id: opencode-session
disabled: true

彻底卸载——把 dsh-claude-theme、dsh-opencode-session 从 dsh.profile.bundles 与两个 file: 依赖从 dependencies 里删掉，删除 node_modules 下的链接，重启。harness 本体没有任何改动需要回滚。

平台

三个平台跑同一份代码：没有原生依赖（Apple Silicon 不用 rebuild）、路径全是 file: 相对正斜杠、node_modules 的文件夹名与 package.json 的 name 精确同大小写。

唯一与平台相关的是 node_modules 里的链接：Windows 是 NTFS junction， macOS / Linux 是符号链接，由各自的安装脚本处理。

⚠️ 不要把 Windows 的 node_modules 整个拷到 mac 上：junction 会被拷成真实副本，插件还能加载，但之后改 lib/client.js 就不再生效了。重跑一次 ./install.sh 即可。

用仓库当开发目录（可选）

想让仓库里的改动直接生效，把 profile 的 plugins/ 换成指向 clone 的链接：

Windows
Remove-Item -Recurse -Force "$HOME\.dsh\profiles\desktop\plugins\claude-theme"
New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\desktop\plugins\claude-theme"
-Target "D:\dsh-profile-plugins\plugins\claude-theme"

macOS / Linux
rm -rf ~/.dsh/profiles/desktop/plugins/claude-theme
ln -sfn /path/to/dsh-profile-plugins/plugins/claude-theme \
~/.dsh/profiles/desktop/plugins/claude-theme

这样改完仓库里的 lib/client.js，刷新页面就能看到效果。

仓库结构

install.ps1 / install.sh 跨平台安装脚本 scripts/wire-profile.mjs 幂等写 profile 的 package.json（两个脚本共用） assets/palette.svg 调色板 plugins/ claude-theme/ 皮肤（宿主半侧 + 客户端半侧），自包含单包 package.json dsh.client + dsh.bundle.patch cordis.patch.yml 自带组合包：插入 id 为 claude-theme 的那一行 lib/index.js 宿主半侧：装载日志 + config 校验 lib/client.js 客户端半侧：整张调色板（要改颜色就改这个文件）
locale/{zh,en}.json 插件管理页里的标题与描述
opencode-session/ 会话 id 注入，同样是自包含单包 package.json dsh.bundle.patch cordis.patch.yml 自带组合包：插入 id 为 opencode-session 的那一行 index.js 宿主插件
locale/{zh,en}.json 插件管理页里的标题与描述

为什么不再拆 -bundle 包：DSH 的组合包就是“声明了 dsh.bundle.patch 的包”，插件本体自己声明它即可。拆成两个包时，profile 必须同时拿到两个包（第一个包的 file:../第二个 依赖在 git 安装下解析不到），无法单独安装，也挡住了图形界面里的本地路径安装。

说明

这两个插件与 DeepSeek / Anthropic 官方无关，是第三方扩展。“Claude” 与相关色值仅作风格描述；配色取自公开可见的 claude.ai 界面与 Anthropic 品牌色。