聊天皮肤工坊 Liyuk/dsh-skin-chatlab

dsh-skin-chatlab

English · 简体中文

为 DeepSeek Harness (DSH) Web GUI 打造的可扩展聊天皮肤 monorepo。核心是「基座 + 皮肤包」的架构：基座提供注册表与切换器，每套皮肤是独立 npm 包，即插即用、互不干扰。

包结构

| 包 | 版本 | 作用 |
| @liyuk/dsh-skin-chatlab-core | 1.0.3 | 基座：皮肤注册服务、切换器、装饰逻辑、预览/未读 RPC |
| @liyuk/dsh-skin-feishu | 1.0.2 | 飞书皮肤：工作区=项目组、会话=联系人、聊天气泡化 |
| @liyuk/dsh-skin-slack | 1.0.0 | Slack 风格：紧凑工作区、平面消息 |
| @liyuk/dsh-skin-wecom | 1.0.0 | 企业微信风格：企业通讯录密度、绿色气泡 |
| @liyuk/dsh-skin-dingtalk | 1.0.0 | 钉钉风格：蓝色企业感、卡片选中态 |
| @liyuk/dsh-skin-telegram | 1.0.0 | Telegram 风格：轻盈蓝色、大圆角气泡 |
| @liyuk/dsh-skin-whatsapp | 1.0.0 | WhatsApp 风格：绿色聊天感、圆形头像 |
| @liyuk/dsh-skin-chatlab | 2.1.0 | 聚合包：一键依赖 core + 六套皮肤 |

每套皮肤只负责外观（布局 / 配色 / 气泡样式），绝不侵入 DSH 的聊天逻辑，也不改动任何现有插件。

安装

方式一：装聚合包（一键带基座 + 六套皮肤）

dsh plugin --profile web add @liyuk/dsh-skin-chatlab

聚合包会通过随包提供的 profile patch 自动把 core 和六套皮肤加入 dsh.profile.bundles，不需要再手工逐个补包。

方式二：单独安装任一皮肤

dsh plugin --profile web add @liyuk/dsh-skin-chatlab-core @liyuk/dsh-skin-slack

将 core 和所选皮肤包加入 profile 的 bundles。可替换示例中的 slack 为 wecom、dingtalk、telegram 或 whatsapp。

方式三：只装飞书

dsh plugin --profile web add @liyuk/dsh-skin-chatlab-core @liyuk/dsh-skin-feishu

方式四：只装基座（无皮肤，默认外观）

dsh plugin --profile web add @liyuk/dsh-skin-chatlab-core

关键：聚合包安装后会自动注入完整 bundle 列表；如果使用单包安装，才需要把 core 和所选皮肤手工加入 profile 的 bundles。

装完重启 DSH Web，打开设置 → 「ChatLab 皮肤」→ 选择任一已安装皮肤。

特性

- 基座 + 皮肤包架构：皮肤是独立 npm 包，通过 ctx.chatlab.registerSkin 注册到基座，加新皮肤 = 新建一个包，不改基座
- 设置面板切换器：胶囊按钮一键切换；切皮肤自动刷新，深色模式热切换
- 六套可切换皮肤：飞书 / Slack 风格 / 企业微信风格 / 钉钉风格 / Telegram 风格 / WhatsApp 风格；后五套使用原创抽象标记，不含官方品牌素材
- Slack：紧凑工作区、平面消息
- 企业微信：企业通讯录密度、绿色气泡
- 钉钉：蓝色企业感、卡片选中态
- Telegram：轻盈蓝色、大圆角气泡
- WhatsApp：绿色聊天感、圆形头像
- 飞书首发适配：工作区=项目组、会话=联系人、最近回复预览、未读红点和聊天气泡化
- 最近回复预览 + 未读：loopback RPC 读会话日志（live + 冷会话），数据层与皮肤解耦
- 纯增量：切「无皮肤」彻底卸载，恢复 DSH 默认外观

使用指南

打开设置 → 左侧「ChatLab 皮肤」。

切换皮肤

- 一排胶囊按钮：无皮肤 / 飞书 / …
- 点皮肤 → 提示刷新 → 页面自动刷新生效
- 所有已安装且 ready: true 的皮肤都会显示为可点击选项
- 选「无皮肤」彻底卸载，恢复默认

深色模式

- 「深色模式」开关热切换（不刷新）
- 底层调 DSH 主题系统，明暗自动跟随

飞书皮肤效果

| 区域 | 效果 |
| 左侧工作区 | 「项目组」：彩色圆角方块 + 首字母 |
| 左侧会话列表 | 「联系人」：圆形头像 + 最近消息预览 |
| 未读消息 | 头像右上角红点，点开消除 |
| 聊天窗口 | 蓝色气泡 + 已读标记；AI 回复灰色正文 |
| 顶部品牌 | DeepSeek 品牌 + 皮肤名徽章 |

皮肤开发：加一套新皮肤

新建一个皮肤包（推荐）：

1. 复制 packages/skin-feishu 的包结构（不要复制生成的 lib/client.js）
2. 建立独立的 src/.js，使用 tokens: { light, dark }、原创 inline SVG 和严格限定 html[data-chatlab-skin=""] 的 CSS
3. 在 src/index.js 通过 inject: ["chatlab"] 调用 ctx.chatlab.registerSkin({ id, name, desc, ready, tokens, css, brand })
4. 在 scripts/bundles.mjs 增加唯一的 client entry/output，并增加 cordis.patch.yml、host no-op、README 和 publish 顺序
5. 先写契约测试，再 npm run build，最后用 npm pack --dry-run 检查包内容

皮肤契约

| 字段 | 类型 | 说明 |
| id | string | localStorage 唯一 key，也写进 data-chatlab-skin |
| name | string | 设置面板显示名 |
| desc | string | 一句话说明 |
| ready | boolean | false = 占位（置灰）；true = 可切换 |
| tokens | {light, dark} | 覆盖 --dsw-alias-* 设计 token |
| css | string | 皮肤专属规则 |

架构

packages/
core/ 基座：注册服务 + 切换器 + 装饰 + 预览/未读 RPC skin-feishu/ 飞书皮肤包 skin-slack/ Slack 风格独立皮肤包 skin-wecom/ 企业微信风格独立皮肤包 skin-dingtalk/ 钉钉风格独立皮肤包 skin-telegram/ Telegram 风格独立皮肤包 skin-whatsapp/ WhatsApp 风格独立皮肤包 skin-shared/ 私有 build-time token mapper（不发布、不运行时依赖） chatlab/ 聚合包（依赖 core + 六套皮肤）

跨插件注册机制：

// core：暴露服务
ctx.provide("chatlab", skinRegistry);

// skin-feishu：注入服务并注册
inject: ["chatlab"],
apply(ctx) { ctx.chatlab.registerSkin({ id:"feishu", name:"飞书", css: FEISHU_CSS }); }

关键实现约束（DSH 是 React 应用）：

- 绝不用 MutationObserver 观察整个 body（会拖垮 React reconcile）
- 绝不用 innerHTML="" 删 React 节点、绝不 insertBefore 到 React 节点前（会触发 removeChild 崩溃）
- 装饰只 appendChild 自己的节点，用 CSS Grid/flex 排位，不移动 React 的节点
- 深色模式交给 DSH 的 ctx.theme.setTheme()
- 皮肤包在 core 之后注册：core 订阅注册事件，皮肤注册后重建 CSS（否则皮肤样式丢失）

贡献 / 一起共建

欢迎把更多聊天软件做成皮肤！

- 开发入门：CONTRIBUTING.md
- 发布流程：RELEASING.md
- 加皮肤：复制 packages/skin-feishu 起一个新包

有任何想法或皮肤创意，欢迎提 Issue / PR。

License

MIT