SuperMate-Harness-System

---

DSH version support (important for GitHub users)

• Works with DSH rc.5 (legacy, no auth) and 0.1.2 / 0.1.3+ (per-launch token auth). The launcher auto-detects: GET / returns 200 -> legacy plain URL; returns 401 -> opens the per-launch token URL printed by dsh web.
• Upgrading to the latest DSH? Read skills/dsh-upgrade-runbook first (BOM/schema pitfalls, official git-clone steps, preflight script).
• NOT upgrading? Nothing to do - old DSH keeps working in legacy mode.
• Backup: this repo's git history is the old-version fallback; always back up your DSH_HOME (sessions/settings/storages) before upgrading.

✨ 核心亮点

---

📦 仓库结构

SuperMate Harness System
 ├── skills/                        → Skill 层（任务级：教"怎么做"）
 │    ├── Supermate-harness-launcher/ 🚀 一键启动：Harness + 夸克 + 千问悬浮侧边栏
 │    ├── quark-qwen-vision/         🖼️ 夸克浏览器视觉+生图（零 API Key）
 │    ├── Deepseek-eyes/             👁️ 视觉 skill（Ollama / 视觉 API）
 │    ├── doubao-creator/            🎬 豆包文生视频（Seedance 2.0，零 API Key）
 │    ├── dsh-im-wecom/              💬 企业微信机器人 × DSH（@xmanrui/dsh-im + 千问读图代理）
 │    ├── rh-workflow/               🎥 RunningHub 云端 H3 工作流 API
 │    ├── rh-workflow-9b/            📋 9B RH 执行宪章
 │    ├── video-production-studio/   🎥 通用视频制作流水线（五文档+确认闸门+H3 原生提示词+本地通道）
 │    ├── lyric-mv-storyboard/       🎵 歌词驱动 MV 分镜（LRC 时间轴/三层表演/防变脸/一句一片段）
 │    ├── MiniMax h3-video-producer/ 🎞️ H3 视频生产全流程
 │    ├── Supermate/                 🤖 SuperMate 智能体身份
 │    └── DSH Official/             官方 deepseek-ai 技能（13 个 · fork 拷贝）
 └── plugins/                        → 插件层（系统级：能"做什么"）
      ├── Supermate/                自研插件（skill-json-importer 已开源；核心增强=闭源商业层）
      └── DSH Official/             官方 deepseek-ai 插件（49 族 · fork 拷贝）

---

⚡ 快速开始

一键环境 —— Harness + 夸克 + 千问悬浮侧边栏：

# 1. 把启动器技能拷入 DSH 技能目录
Copy-Item skills\Supermate-harness-launcher\ ~\.dsh\skills\ -Recurse

# 2. 编辑 config.ps1 —— 配置 Harness 启动命令 / 夸克路径
#    $HarnessStartCmd = 'E:\deepseek-harness-v013\start-web.cmd'   （留空=手动启动 Harness）

# 3. 运行——Harness 启动、夸克打开、千问悬浮侧边栏弹出
powershell -ExecutionPolicy Bypass -File scripts\launch.ps1

其他技能同理：把文件夹拷进 ~/.dsh/skills/，重启 DSH 会话即可。

---

🧩 原创技能

基于夸克浏览器 —— 夸克自带千问侧边栏 + 夸克网盘，是 SuperMate Harness System 拓展（视觉、生图、网盘、视频）的理想底座。

---

🚀 主打 · 一键启动：Harness + 夸克 + 千问悬浮侧边栏

双击一个图标 → Harness 自动启动 → 夸克打开 → 千问悬浮侧边栏在对话页右侧弹出。

Supermate-harness-launcher 一个入口搞定整个工作环境：

1. 启动 Harness——http://127.0.0.1:3080 未运行时，调用配置的启动脚本并等待就绪（最多 120s）
2. 打开夸克——确保浏览器带 --remote-debugging-port=9222 运行，打开 Harness 界面 + 千问侧边栏页
3. 弹出悬浮侧边栏——截图定位夸克原生**"问AI"**按钮（右上角蓝色 ✨ 星标）并自动点击

跨机型/分辨率/DPI 自适应：按钮像素位置随显示器变化，但在窗口内的比例稳定——DPI 感知截图 + 颜色扫描蓝星（取最顶部簇）+ 按宽高比换算的兜底偏移。

⚠️ "问AI"按钮是开关（再运行会关闭面板）。千问侧边栏页必须用带参 URL（entry=frame&tab_id=...）——普通 URL 只会加载坏壳（报 SidebarService instanceId is required）。

---

👁️ 主打技能 · 给 DeepSeek 装眼睛

图片 → 视觉模型转成文字 → 文本模型"看见"

deepseek-eyes 把图片——截图、照片、图表、设计稿、插画、角色设定图、AI 生成图——转换成 DeepSeek（或任意文本模型）能推理的结构化文字。

图片 / 图形文件 → Skill → 本地视觉模型或视觉 API → 结构化文字 → DeepSeek 阅读与推理

实测于 RTX 5080 16GB — 中文手册 · English manual

---

🧠 架构级突破 · dsh-deepseek-vision-bridge

"看图"是能力，不是模型属性。 DeepSeek 权重里没有视觉编码器——这是物理限制， prompt 技巧解不了。但本桥在架构层跨过了它：视觉通道（夸克千问侧栏）从 "手动调用"升级为模型请求管线里的自动环节。

GUI 贴图 → Host 预检放行（adapter 现声明含 image）
  → 图入 durable（历史可见，永不丢失）
  → llm-deepseek adapter 每次请求前扫描 image block
  → 夸克千问侧栏（CDP）识图（~6-12s，缓存后秒回）
  → 干净文本替换 image block → 序列化（assertTextOnly 不触发）
  → DeepSeek 正常回复，已"看懂"图片

为什么是突破而不是技巧：

• 原生层 · 全局生效——补丁在 DSH 自己的 llm-deepseek adapter，GUI 贴图 / IM 通道 / 一切走 DeepSeek 的图片统一自动转译，无需逐通道维护桥接
• 图永不丢失——原图字节在 durable attachment store，只转译发给模型的副本
• 零显存 · 零 token——识图走已开的夸克浏览器 CDP，16GB 显卡留给 ComfyUI H3
• 工程级健壮——严格串行 + 1.5s 冷却（侧栏是网页会话，突发并发会卡）；只缓存 成功（同图秒回、失败不污染）；失败降级占位 + 下轮自动重试；无附件 seam 保持 原生 text-only（零回归，158 测试全绿）
• 上游通用 · 非 SuperMate 私有——补丁只改官方 @deepseek-ai/dsh-llm-deepseek 包，依赖全为 @deepseek-ai/* + Node 内置 + 通用夸克 CDP。clone 官方 deepseek-ai/deepseek-harness，覆盖 patch/ 重建重启即得同等能力；本仓库只是 它的分发点（可回馈上游）
• 双 agent 胜过投影——本地多模态靠 mmproj 做权重内静态对齐（固定本地小眼睛、 不可追问）；本桥让文本 agent（DeepSeek）自动调用夸克云端满血千问（qwen-vl-max 级）做运行时转译——借来的满血眼睛远超本地 9B/35B，且可对话追问、可替换、 可迭代，静态 mmproj 做不到
• 诚实边界——首图 ~10s 在模型请求内；缓存进程级；侧栏会话式是极端多图的上限

源码补丁 + 文档：skills/dsh-deepseek-vision-bridge/patch/（含回滚）。

---

🏛 官方内容随仓库自带

---

🔗 生态与许可

属于 DeepSeek Harness 插件生态——主题 dsh-plugin · DeepSeek Harness · Agent Skills

许可 · Apache-2.0（含专利授权条款）· 双许可边界（核心闭源商业层：调度/记忆治理/沙箱/评测）见 双许可说明

---