DongDong1997/dsh-mcskin

dsh-mcskin

为 DeepSeek Harness（DSH）Web GUI 打造的 Minecraft 主题皮肤。6 套主题（3 种风格 × 2 种配色方案），包含 MC 像素艺术图标、侧边栏生物群系渐变、顶部草方块条带、右下角苦力怕装饰，以及主页面控件的箱子 / 草方块 / 剑 / 镐 / 苦力怕替换。

本插件是第三方 DSH 包。为你的 GitHub 仓库打上 dsh-plugin 标签，即可让它被发现。

主题

| 风格 | 浅色（白天） | 深色（夜晚） |
|---|---|---|
| 经典原版 Classic | 🌱 草方块绿 + 圆石 + 泥土 | 🌑 黑曜石 + 末影珍珠紫 + 深板岩 |
| 现代 MC Modern | 🪵 橡木 + 纸 + 绿宝石 | 🪨 深板岩 + 紫水晶 + 骨头 |
| 暗夜 MC End | 🏛️ 末地石 + 末影龙紫 | 🕳️ 虚空 + 黑曜石 + 末影珍珠辉光 |

每套主题都是一份完整的 token 映射（70+ 个 --dsw-alias- + --dsw-specific-），由单一语义调色板规格派生而来。

安装

dsh plugin dsh-mcskin

该包自带一个 cordis.patch.yml，用于注册一个顶层浏览器端插件行。web-app 包的 modules 插件会扫描它并组合构建。无需手动配置。

GUI 中的变化

设置选择器（新页面）

设置 → 🎮 Minecraft 主题

3 × 2 的卡片网格。每张卡片显示：

- 主题名称 + 模式（使用 Press Start 2P 像素字体）
- 6 个 MC 像素艺术图标（草方块、圆石、牛、苦力怕、剑等），按生物群系配色
- 描述
- 点击即可应用；选择会持久化到 localStorage['mcskin.theme']

主页面 MC 装饰（始终开启，作用域 = body.mcskin-decor）

| 元素 | 之前 | 之后 |
|---|---|---|
| 顶部边缘 | （无装饰） | 6px 品牌色草条带 |
| 右下角 | （无装饰） | 35% 不透明度苦力怕脸，34px |
| 侧边栏（整体） | 纯色 | 6–7px 生物群系条带 + 主块颜色 |
| 设置按钮（侧边栏页脚） | 齿轮图标 | 箱子 |
| 侧边栏品牌 | "DeepSeek" 字标 | 24px 草方块 |
| 新建会话按钮 | + 图标 | 铁镐 + 橡木边框 |
| 输入卡片 | 圆角胶囊 | 橡木边框，带内嵌高光/阴影 |
| 发送按钮 | 箭头 | 铁剑 + 青金石边框 |
| 设置面板关闭 | × | 迷你苦力怕脸 |

主页面的 CSS 以主题 token 为基准（--dsw-alias-brand-primary、--dsw-specific-sidebar-fill 等），因此装饰会随当前主题自动变色。

本地开发

本包使用 tsdown 构建，并遵循 DSH 的模块约定。

安装
pnpm install
构建（输出 ./dist/client.js）
pnpm build
监听
pnpm dev
类型检查
pnpm exec tsc --noEmit

在运行中的 DSH 会话内运行

本包可直接替换动态 Cordis 插件定义。在 DSH 会话运行期间，你可以热加载构建产物：

// 在 agent 的工具界面中，请求运行时求值该包：
import('/abs/path/to/dsh-mcskin/dist/client.js').then((m) => m.apply(ctx))
或者将构建输出复制到某个配置文件的 node_modules//dist/ 目录，然后重启该配置文件，以便通过标准的 DSH 插件安装器加载它。

发布

此包的结构适用于 npm + dsh plugin 。发布步骤：

1. git init && git add . && git commit -m "..."
2. npm login（或 pnpm login）
3. npm publish --access public（如果想使用带作用域的名称，请先重命名 package.json 中的 name，例如 @yourname/dsh-mcskin）
4. gh repo create 并推送
5. 在 GitHub 仓库上添加 dsh-plugin 主题标签
6. 可选：在 deepseek-ai/deepseek-harness Discussions 中发布公告（DSH 目前不接受插件 PR，请参阅 CONTRIBUTING.md）

完整的发布前检查清单请参阅 PUBLISHING.md。

项目结构

dsh-mcskin/
├── package.json                 # npm + dsh.bundle 清单
├── cordis.patch.yml             # 注册顶层浏览器插件行
├── tsconfig.json                # ESM + JSX + DOM 库
├── tsdown.config.ts             # 将 src/client/index.ts 打包为 dist/client.js
├── LICENSE                      # MIT
├── README.md                    # 本文件
├── PUBLISHING.md                # 发布前检查清单
└── src/
└── client/
├── index.ts             # 公共入口（重新导出 apply + name）
├── mcskin.ts            # Cordis apply()：主题注册表、覆盖层、插槽
├── palettes.ts          # 6 个 McPalette 规格
├── themeEntries.ts      # 6 个 ThemeEntry 行（样式/模式/图标）
├── icons.tsx            # 35 个像素艺术 SVG 图标（16x16）
├── picker.tsx           # React 选择器 UI（settings-section 插槽）
└── mainPageCss.ts       # 通过 styles.insert 注入的 CSS 字符串

主题覆盖如何胜过其他插件

DSH 的 theme.overrideTokens(source, layer) 是一个栈：每次调用都会在前一层之上添加一层，后面的层按 token 逐个胜出。skin-center 插件（以及任何其他第三方主题插件）会在 apply 时调用它一次。我们会在每次主题变更时用自己的 source 调用它，从而将我们的层重新堆叠到顶部——只要我们的插件最后一次 theme/change 处理器在它们的处理器之后运行，就能保证我们的 token 胜出。

这 6 个已注册的主题提供了回退方案：即使不存在任何覆盖层，已注册主题的 token 也会被 ThemePresenter 投射到 body.style 上。在一个没有任何覆盖的新会话中调用 theme.setTheme('mc-classic-day')，仍然会应用我们的 token。

兼容性

- DSH ≥ 某个较新版本，需具备 theme.overrideTokens、settings.section 列表插槽，以及插件可访问的 body
- React 18（peer 依赖）
- 现代浏览器（CSS color-mix、data-uri svg、image-rendering: pixelated）

许可证

MIT — 请参阅 LICENSE。