- Language
- TypeScript
- License
- BSD-3-Clause
- Branch
- main
ai-agentai-coding-assistantcodexdeepseekdeepseek-harnessdesktop-appdshdsh-plugin
为 dsh web GUI 提供「夕港」黄昏港口主题：动漫港口画背景、深暮蓝底日落橙主色、半透明面板，不影响模型请求与对话数据。
$ dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/skins/harborRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
「夕港（Harbor）」是 dsh web GUI 的主题皮肤插件，把原版 dsh-skins 夕港皮肤移植过来，给整套界面换上动漫风格的黄昏港口画背景，并把主题色板换成深暮蓝底 + 日落橙主色。它只改变 DOM 外观，不影响模型请求和对话数据。
data-ds-dark-theme 变化自动重绘@deepseek-ai/cordis（仅类型导入，effect 生命周期）、lightningcss（CSS 编译）、tsdown（构建）apply(ctx) 通过 ctx.effect(...) 注册 disposer，关闭时按 ThemePresenter 规范撤回所有写入；不注入任何 cordis 服务、不发事件src/index.ts（host 侧空壳）+ src/client/index.ts（核心逻辑，102 行）喜欢黄昏港口动漫插画和暮光暖色配色的普通用户，把 dsh web GUI 换成更具情绪氛围的视觉风格。安装并激活后，整个界面背景变成港口暮色画，面板变成带磨砂感的半透明，深暮蓝底搭配日落橙强调色，不影响任何对话和模型行为。适合日常长时间使用、希望界面更有故事感的人群。
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH | 未声明 | 包内未声明具体 DSH 版本；作为官方 bundle 形态插件，需 DSH 启用客户端插件机制 |
| Node.js | ^22.19.0 || >=24.0.0 | 来自仓库根 package.json#engines |
| 平台 | 跨平台 | DSH web GUI 客户端；macOS / Windows / Linux 均可运行宿主 |
| 原生模块 | 无 | 纯浏览器端实现，无 Node 原生模块依赖 |
dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/skins/harbor
安装完成后还需要激活：
dsh-skin use harbor
本插件无需额外配置。apply() 内部通过 ctx.effect(...) 自动注册 disposer，无需用户手动维护生命周期。
Q: 这个皮肤影响我的对话记录和模型请求吗？
A: 不影响。它只修改浏览器 DOM（背景图、面板颜色、favicon），不注入任何 cordis 服务、不发请求、不触碰模型 API，也不会修改 KV Cache 行为。
Q: 一次能同时启用多个皮肤吗？
A: 不能。同一时刻只激活一个皮肤，切换时新皮肤接管、旧皮肤完整卸载；切换用 dsh-skin use harbor。
Q: 关闭后会留下痕迹吗？
A: 不会。effect disposer 会撤回它写入的所有内容：移除 body 属性、按 CSSOM 规范读取并按原值还原背景图、移除注入的 favicon，原页面样式完整恢复。这点由 tests/apply.spec.ts 的"retracts everything on dispose"用例守护。
Q: 装了之后为什么界面没变？
A: 仅安装到 profile 不等于已激活。还需要执行 dsh-skin use harbor 才会套用该皮肤。
Q: 支持深色模式吗？
A: 支持。皮肤会跟随宿主基础主题切换：深色模式下遮罩换成深海夜航纱（rgba(11,14,26,...) 系），亮色模式下是薄暮纱（rgba(20,26,46,...) 系），由 MutationObserver 监听 body[data-ds-dark-theme] 实时重绘背景，无需重新挂载。
Q: 港口背景图是哪来的，为什么安装包不大却能离线显示？
A: 图片以 base64 data URL 内嵌在 src/client/art.ts 里（约 83KB 的 1600×900 WebP），皮肤完全不依赖任何外部静态资源，离线也能正常显示。需要换画时可按文件头注释的 node scripts/embed-skin-art harbor HARBOR_ART <imagePath> 1600 重新生成。
Q: 第一次安装需要先本地构建吗？
A: 不需要。通过 git 链接安装时 prepare 脚本会自动构建 lib/；但 pnpm ≥10 首次安装 git 依赖可能需要把打印的包键加入 pnpm-workspace.yaml 的 allowBuilds 列表再重试。
Q: 跟其它皮肤比有什么不一样？
A: 这个皮肤的核心卖点就是黄昏港口动漫插画背景和深暮蓝底日落橙配色；同仓库还有 blue-fantasy、miku、minecraft 等其它皮肤可选，每个都有不同的背景画作与配色。
入门 — 一条命令安装、一条命令激活，没有任何配置项，普通用户即可上手。
backdrop-filter 模糊祖先元素：会破坏 fixed 定位覆盖层（如设置面板）的包含块，使其被锁在父容器内