LaplaceYoung/dsh-qq2006

dsh-qq2006

把 DeepSeek Harness 的 WebUI 一键变回 2006 年的 QQ 客户端。

QQ2006 皮肤插件：注册珊瑚蓝主题、镜像 body[data-ds-skin]、全局皮肤表 + 完整组件级补丁，从登录窗到聊天窗口全链路还原 2006 年的那个蓝色小企鹅。可切换、可持久化、默认皮肤零污染。

聊天窗口：好友信息条 + 原版九宫格标题带 + 列表式消息 + QQ 秀右侧栏

⚠️ 素材来自 mengkunsoft/QQ2006，为腾讯原版素材，仅供学习交流、请勿商用（出处见 assets/qq2006/README.txt）。

✨ 特性

- 可切换皮肤：设置 → 通用 → QQ2006 皮肤（当前 DSH 外观行仍是浅色 / 深色 / 跟随系统三个色块，插件自带开关）；偏好持久化，刷新/重启保持；随时切回默认皮肤，零污染契约（所有补丁锚定 body[data-ds-skin='qq2006']）
- QQ2006 登录窗：九宫格窗口框、三态按钮、记住密码/自动登录联动、连接中动态点动画
- 主面板：用户头部（50×50 蓝描边头像 + 6 个 mini 钮）、面板栏 10 钮（27×37 原版底条格）、分组/好友行（原版行高与 hover）、右键菜单
- 聊天窗口：标题栏 4 钮（含 65×24 原版"菜单"文字钮）、大工具栏 12 钮、小工具栏 8 钮（全部原版素材、原生尺寸）
- 原版消息形式：列表式消息（自己绿色昵称 / 对方深蓝紫昵称 + HH:MM:SS 时间 + 黑色正文），宋体渲染
- QQ 秀右侧栏：对方形象 / 个人空间（真实会话统计）/ 我的形象，默认展开
- 换肤 4 预设：经典蓝 / 粉红 / 薄荷绿 / 紫罗兰，窗口内实时切换
- 真实交互：Alt+S 发送、右键复制、hover 操作行（复制/引用/转发）、提示音、QQ 黄色反馈 tip

🚀 快速开始

方式一：npm 发行版（dsh plugin 安装）

仓库已包含预构建产物（lib/），发行版用户可直接从 GitHub 安装：

dsh plugin --profile web add https://github.com/LaplaceYoung/dsh-qq2006

安装后重启 dsh web，然后：

1. 打开 设置 → 通用
2. 找到 QQ2006 皮肤，点 开启

DSH 0.1.0-rc.7+ 还会在 设置 → 插件 → 插件配置 里出现同名卡片。当前上游外观行（到 dsh-v0.1.2-alpha.1）仍然只渲染浅色 / 深色 / 跟随系统，不会出现第 4 个色块——这是上游硬编码，不是安装失败。0.1.2 起开关文案走第三方 UI 语言注册（中 / 英）。

启用后获得：可见的 QQ2006 壳层（经典蓝标题栏、侧栏、输入区、设置窗）+ 珊瑚蓝 --dsw-alias- / --dsw-specific- token 叠加 + 插件注入的全局皮肤表（复古字体、滚动条、九宫格工具类、.qq-btn 三态钮）。

能力边界：组件级皮肤（登录窗、面板栏、聊天窗 chrome、列表式消息、QQ 秀右栏）改的是宿主 UI 包的源码，npm 发行版是预构建产物，无法通过插件机制注入。这些效果需要方式二。

方式二：源码 monorepo（完整效果）

完整皮肤实现位于 fork 的 skin/qq2006 分支：

git clone https://github.com/LaplaceYoung/deepseek-harness.git
cd deepseek-harness
git checkout skin/qq2006
pnpm install
pnpm run build
node --import tsx/esm apps/cli/src/bin.ts web

打开 http://127.0.0.1:3080 → 设置 → 外观 → QQ2006 皮肤。
已有 DSH 源码 checkout 的用户，也可以直接应用补丁文件：git apply patches/qq2006-skin.patch（基于上游 deepseek-ai/deepseek-harness master）。

| 能力 | npm 发行版（方式一） | 源码 monorepo（方式二） |
|---|---|---|
| 设置里的 QQ2006 皮肤开关 | ✅ | ✅ |
| 珊瑚蓝 token 换肤 | ✅ | ✅ |
| 全局皮肤表（字体/滚动条/九宫格类） | ✅ | ✅ |
| 登录窗 / 主面板 / 聊天窗 chrome | ❌ | ✅ |
| 原版列表式消息 / QQ 秀右栏 / 消息操作 | ❌ | ✅ |
| 素材（按钮图标/头像/提示音） | ❌ | ✅ |

后续计划：待 DSH 官方提供客户端插件的静态资源与 UI 槽位机制后，把组件级皮肤完整迁入插件包，使发行版获得全部效果。
📦 仓库结构

dsh-qq2006/
├── lib/                  # 预构建产物（发行版 dsh plugin 可直接安装）
├── cordis.patch.yml      # profile layer 补丁（必须用 insert，且必须打进 files）
├── patches/               # 源码 monorepo 集成补丁（git apply）
├── src/
│   ├── index.ts            # 插件入口
│   ├── invariant.ts        # 包内不变量
│   ├── client/index.ts     # 主题注册 + body[data-ds-skin] 镜像 + QQ2006_TOKENS
│   └── styles/qq2006.css   # 全局皮肤表（字体/滚动条/九宫格/三态钮）
├── assets/
│   ├── qq2006/             # 完整素材（img 366 + sound 8 + 版权说明）
│   └── screenshots/        # 效果截图
├── docs/qq2006-skin.md     # 总文档：架构/按钮映射/实现清单/验证记录
├── README.package.md       # 皮肤契约（机制/补丁规则/素材）
└── LICENSE                 # MIT

🛠 开发

组件级补丁规则（见 README.package.md）：皮肤段只追加在组件自己的 .module.css 尾部，全部以 body[data-ds-skin='qq2006'] 为祖先作用域；素材用原生尺寸；默认皮肤零回归由测试锁定。

pnpm --filter @deepseek-ai/dsh-client-ui-conversation bundle   # 单包重建
pnpm --filter @deepseek-ai/dsh-web-frontend build              # 前端重建
pnpm vitest run packages/client/ui-conversation                # 皮肤相关测试

🤝 贡献

欢迎 PR。改前先读 docs/qq2006-skin.md 的映射清单与 README.package.md 的文件所有权约定；所有视觉改动必须在皮肤作用域内生效。

📄 许可

- 插件代码：MIT
- QQ2006 素材：腾讯原版，仅供学习交流，请勿商用（assets/qq2006/README.txt）

🙏 致谢

- mengkunsoft/QQ2006：QQ2006 原版仿制项目与素材
- deepseek-ai/deepseek-harness：DSH 及插件体系