DeepSeek Harness UI WEB · WEB UI 美化 + QQ 机器人(支持动态背景)
基于 zhu1090093659/dsh-web-ui(Apache-2.0)开发的 DeepSeek Harness(DSH)Web UI 插件套件。全套 21 个包已发布到 npm(
@captain1275/*)。
DSH Web UI 全家桶为 DeepSeek Harness 的 Web 界面提供一系列插件与皮肤:极光毛玻璃皮肤、任务看板、 SSH 运维、右侧文件/变更面板、Git 图谱、移动端远程控制、DeepSeek 娘看板娘(养成系)、实时令牌统计, 以及皮肤中心。所有插件既可独立安装,也可通过聚合包一次装齐。
极光 Aurora 皮肤效果(沉浸光感 / 深色 / 浅色)



QQ 机器人框架
把 DeepSeek Harness 直接接成 QQ 机器人:群聊、私聊、官方机器人都能走,人格、记忆、表情包、 命令全部内置。
两个通道包
| 包 | 通道 | 说明 |
|---|---|---|
| @captain1275/dsh-qq-onebot | NapCat / OneBot 11 | 群聊 + 私聊,正向 WebSocket 收事件、HTTP 发消息 |
| @captain1275/dsh-qq-official | QQ 官方机器人 | WebSocket 网关 + OpenAPI,正规通道,私聊不封号 |
两个通道共用同一套人格、记忆和表情包,可以同时开。
能做什么
- 人格:markdown 一份人格文件,每轮注入,说话是那个人,不是客服
- 记忆:旧聊天迁移 + 跨群人物档案(同一个人在哪说的话都归到一份)+ 会话超长自动压缩
- 看图:插件下载图片后直连视觉模型描述,再把描述交给 agent 回话
- 表情包:按情绪从图库挑,生气/冷话不配图
- 日记:每天固定时间自己写一篇,隔天带进上下文
- 主动:定时搭话、早安晚安,允许它选择不说
- 命令 25 条:点歌(语音)、查歌词、说说赞评、B 站五项、群管十三项
- 守护:频控、消息去重、插件卸载后不留后台任务(避免宿主崩溃)
侧栏面板
装好后侧栏「新会话」下面会多一行 QQ 通道,点开是配置向导:
怎么配
1. NapCat 里开一个正向 WebSocket(网络配置 → 新建 → WebSocket 服务器 → 端口 3001)
2. 把 wsUrl / httpUrl 填进插件配置
3. 群里 @ 它就能用
4. 想换人格改 personaPath,想配色情包改 stickerDir
面板用 DOM 注入实现,不依赖宿主 slot,也不挂 React 树。
安装
`ash
NapCat 通道(需要在 NapCat 里开一个正向 WebSocket 服务器,默认 3001)
dsh plugin add @captain1275/dsh-qq-onebot
QQ 官方机器人通道(需要 AppID / AppSecret)
dsh plugin add @captain1275/dsh-qq-official `
安装后在插件的配置里填:
`yaml
onebot
wsUrl: 'ws://127.0.0.1:3001' httpUrl: 'http://127.0.0.1:3000' requireAtInGroup: true # 群里必须 @ 才理人 personaPath: '/path/persona.md' stickerDir: '/path/stickers' proactiveMinutes: 45 # 0 = 关闭主动搭话
official
appId: '你的 AppID' clientSecret: '你的 AppSecret' allowOpenids: ['你的 openid'] `
设计说明
- 情绪不靠关键词表:该不该翻脸、该不该冷,交给模型判断,不做计数器
- 人格走消息前缀:DSH 的 gent.inject 注入 system 消息在实测中对会话影响不稳定, 所以人格拼在每条消息前面,确定性优先
- 命令不进模型:点歌、禁言 这类有确定实现的,插件自己跑脚本,省一次模型调用
- 出错不拖垮宿主:所有异步链路都兜底,插件卸载后后台循环立刻退出
特性
极光(Aurora)皮肤(支持动态背景)
- 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
- 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
深浅两套极光渐变;视频背景支持静音开关、本地文件持久化(存
~/.dsh/skin-aurora-media/,刷新不丢) - 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、 WebGL 火焰跟随、OFF/MAX 刻度、Low/Medium/High/Ultracode 状态

- 用户消息气泡毛玻璃:与输入框统一的玻璃质感
DeepSeek 看板娘(养成系)
- 图片资源(社区同人资源,codex-pet-DeepSeek-girl)
- 养成系统:亲密度 4 级成长(幼鲸 / 伙伴 / 挚友 / 深海羁绊)、升级庆祝气泡、进度条、 Token 零食经济、使用时长成长(每 30 分钟 +1)
- 待机随机气泡:空闲时随机说话(live2d 风格文案)
- 摸头 / 喂食 / 改名 / 拖动,召唤按钮(live2d 同款贴边滑出)
Skill 人格设定
- 设置「人格设定」:开关启用/禁用常驻人格,编辑技能名、描述与人格正文
- 一键生效:保存后写入用户级技能
~/.dsh/skills/catgirl-rp/SKILL.md,DSH 技能系统实时加载, 所有新对话自动以该人格回应(含语气、动作表达、互动规则) - 内置猫娘人格:默认提供「小咪」猫娘人格(常驻生效、好感度系统、模式切换指令),可自由改写
- 可临时退出:对话中说「退出角色扮演模式」即切回普通助手,说「进入角色扮演模式」恢复

用量看板
- 彩色统计卡:累计 token、调用次数、缓存命中、估算费用(按 DeepSeek 官方定价)
- 近 14 天趋势:每日 token 消耗柱状图
- 模型分布:各 provider/model 用量环形图 + 图例
- 会话排行:Top 20 会话(标题 / 模型 / 调用数 / token / 费用)
- 自动记录:对话时自动采集 token 用量(会话快照替换语义,不双计),存
~/.dsh/usage.json - 侧边栏入口:彩色柱状按钮打开全屏看板
功能插件
| 插件 | 功能 |
|---|---|
| dsh-task-board | 侧边栏任务看板:多列 kanban、真实执行(驱动 agent 会话)、定时执行(cron) |
| dsh-ssh | SSH 运维:主机管理、远程执行、SFTP 传输、隧道、集群并发、Web 终端 |
| dsh-aionui-panel | 右侧「预览 / 文件 / 变更」面板:文件树、多格式预览、git 操作、文件拖拽 |
| dsh-git-graph | 会话头部 git 分支选择器 + 提交图 |
| dsh-live-stats | 实时 token 估算与生成速度 |
| dsh-full-stats | 完整统计行:覆盖官方统计(不省略)+ 运行状态指示 + 自定义状态文本(含替换官方 Deep diving...) |
| dsh-usage-dashboard | 用量看板:彩色统计卡 / 近 14 天趋势 / 模型分布 / 会话排行 / 费用估算 |
| dsh-web-ui-settings | 设置页「Web UI 插件」配置组 + 「人格设定」+「关于」版权页 |
| dsh-web-ui-all | 聚合包:一键安装全部插件 |
皮肤中心
10 套皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song / aurora / skin-center),支持皮肤启用互斥管理与一键切换。
其余皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song) 为上游 dsh-web-ui 自带皮肤。
安装
方式一:npm(推荐,已发布)
# 在 DSH profile 目录(~/.dsh/profiles/web)安装聚合包
npm install @captain1275/dsh-web-ui-all@0.4.0
然后在 profile 的 package.json 里把 @captain1275/dsh-web-ui-all 加入
dsh.profile.bundles:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@captain1275/dsh-client-ui-skin-aurora",
"@captain1275/dsh-full-stats",
"@captain1275/dsh-web-ui-all"
]
}
}
}
重启 DSH 即生效。
方式二:从源码(开发)
git clone <your-repo-url> dsh-web-ui
cd dsh-web-ui
pnpm install
pnpm -r build
# 把本地包链接进 profile(junction)
node scripts/link-profile.mjs
开发
- 构建:
pnpm -r build(或pnpm --filter <package> build) - 新增皮肤:参考
packages/skins/aurora(skin.json+src/client+cordis.patch.yml), 然后用node scripts/skin-center-bundles重新生成注册表 - 聚合包 patch:编辑
packages/dsh-web-ui-all/aggregate.yml后node scripts/aggregate.mjs - 皮肤资产同步:
node packages/dsh-skins/build.mjs
目录结构
packages/
├─ dsh-task-board / dsh-ssh / dsh-aionui-panel / dsh-git-graph
├─ dsh-pet / dsh-live-stats / dsh-full-stats
├─ dsh-web-ui-settings / dsh-web-ui-all / dsh-skins
└─ skins/ # 皮肤源码(aurora、miku、ths 等)
scripts/ # 构建 / 注册表 / 链接工具
shared/ # 共享构建预设(tsdown.client.ts)
版权与许可
- 主体代码:zhu1090093659/dsh-web-ui,Apache-2.0
- 增强优化:@captain1275
- DeepSeek 娘精灵图:xpy12367/codex-pet-DeepSeek-girl, 社区同人资源,版权归原作者
- 人形图标:Font Awesome 6.7.2,CC BY 4.0
- 样式参考:live2d-widget(GPL-3.0,仅参考视觉风格,未搬用代码)
- 商标:DeepSeek 及其相关标识均为 DeepSeek 官方资产;本插件为社区开发者独立维护的非官方同人项目, 不代表 DeepSeek 官方立场。
No comments yet. Be the first to write one.