dsh-visual-skin
dsh-visual-skin
DeepSeek Harness Skin Studio
为 DeepSeek Harness(DSH)制作、预览并安全写入皮肤的本地可视化工作台。
先说结论
给一张图片,或直接在 Studio 里调色、调背景和区域效果;Skin Studio 会在隔离的临时 DSH中渲染结果。只有你在可见网页中审阅并确认后,主题才会写入本机 DSH。
你要做的事 | 得到什么 |
用图片做皮肤 | Agent Skill / MCP 自动创建设计、上传资产并打开预览 |
精细调整两块背景 | 侧边栏、主工作区、图片位置、遮罩和分隔线的即时预览 |
安全写入本机 DSH | 不可变计划、可见确认、可恢复的安装记录 |
Related MCP server: gpt-dsh-bridge
10 秒看懂流程
flowchart LR
A[图片 / 你的描述] --> B[Skin Studio 设计]
B --> C[隔离 DSH 真实预览]
C --> D{你在 Studio 中确认}
D -- 确认 --> E[写入你的 DSH]
D -- 继续修改 --> BAgent 和 MCP 可以帮你完成设计与预览;不能伪造最后的写入确认。
功能一览
模块 | 做什么 | 为什么有用 |
Skin Studio | 图片、纯色、渐变;双区域背景;遮罩、玻璃拟态、token 调色与分隔线 | 所见即所得,不必手改配置文件 |
隔离预览 | 使用 Controller 管理的临时 DSH 实例,并复用 warm runner | 预览不触碰正在使用的 DSH,也减少重复启动负载 |
DSH 插件 | 常驻背景层、对话蒙版、侧边栏分隔与「皮肤设置」入口 | 切换对话后仍保持皮肤,不需要重新注入页面 |
Agent Skill | 理解「换个皮肤」「用这张图做背景」等请求并编排流程 | DSH、Codex 等 agent 都能接入同一套设计能力 |
MCP Server |
| 让 agent 有结构化、可审计的操作接口 |
安全写入 | 隔离预览回执 + 不可变 apply 计划 + 人工确认 | 写入前知道会改什么,失败时可恢复 |
安装
前置条件 | 版本 / 说明 |
Windows | 10 或 11 |
Node.js | 22+ |
pnpm | 11+;首次构建便携运行时时需要 |
DeepSeek Harness |
|
git clone https://github.com/trrrrrryg/dsh-visual-skin.git
cd dsh-visual-skin
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1安装器会构建便携运行时、安装 Skill、注册 DSH 插件与 MCP,并启动 Studio。默认不重启 DSH,避免打断正在进行的会话;完成后请自行重启一次 DSH。
参数 | 作用 |
| 指定 DSH 根目录,默认 |
| 指定 profile,默认 |
| Studio 数据目录 |
| Studio Controller 端口,默认 |
| 复用已构建 runtime |
| 跳过可选组件 |
| 安装后自动重启 DSH |
.\install.ps1 -DshHome C:\Users\me\.dsh -ProfileName web -ControllerPort 12000 -RestartDsh使用
在 Studio 中手动设计
打开
http://127.0.0.1:11862,或从 DSH 的「设置 → 插件 → 皮肤设置」打开 Studio。上传图片,或调整背景、区域和 token,等待隔离预览就绪。
点击 写入我的 DSH,审阅计划并亲自勾选确认;随后重启 DSH。
勾选整合两区域:背景会是一张随窗口缩放保持连续的画面。
取消勾选:可分别编辑侧边栏与主工作区,使用不同的颜色、渐变或图片。
所有变更先进入实时隔离预览;正式 DSH 在确认前不会被改动。
直接对 agent 说
「给我换个皮肤」
「用这张图片做背景」
「把现在的皮肤背景换掉」
Agent 会调用 mcp__skin-studio__* 完成设计与隔离预览,并把最终确认留在 Studio 网页中。
验证安装
# DSH 插件健康检查(DSH 默认端口为 10402)
Invoke-RestMethod http://127.0.0.1:10402/dsh-skin/health
# Studio Controller 状态
Invoke-RestMethod http://127.0.0.1:11862/api/v1/status开发
pnpm install
pnpm build # 构建全部包
pnpm test # 回归测试;会启动真实 rc.6 隔离预览
pnpm controller # 本地启动 Controller
pnpm dev # Studio Vite 开发模式apps/controller/ # API、隔离预览、apply/restore、GC
apps/studio/ # React + Vite Studio
packages/dsh-plugin/ # DSH host 路由与 client 皮肤渲染
packages/theme-schema/ # ThemeSpec v2 数据契约
packages/mcp-server/ # MCP stdio 服务
agents/codex-skill/ # 可安装 Agent Skill 与脚本
tests/ # 含真实 rc.6 Chromium 隔离预览的回归测试
docs/demo/ # README 动画、分镜与导出脚本
docx/ # 实施计划、需求分析、架构文档安全与兼容
ThemeSpec 只接受受控的颜色、内容寻址图片(sha256)和 token;不接收任意 CSS、JS 或 URL。
预览只在 Controller 拥有的临时 DSH 里运行;浏览器、MCP 和 agent 都拿不到写入确认凭据。
当前目标版本是
0.1.0-rc.6;不兼容时拒绝加载,而不是猜测性修改 DSH。
卸载
从
%DSH_HOME%\profiles\<profile>\cordis.patch.yml移除# >>> dsh-skin-studio到# <<< dsh-skin-studio之间的托管条目;删除
%DSH_HOME%\profiles\node_modules\@dsh-skin和%DSH_HOME%\skills\deepseek-harness-skin-studio;重启 DSH;如需清理 Studio 数据,再删除
%LOCALAPPDATA%\DeepSeekHarnessSkinStudio。
文档
MIT © 2026 trrrrrryg
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Agent MCP: 65 tools — 5-chain verification, risk, prediction & crypto trends, 17 web tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceAugments DeepSeek-V4 with image understanding and deep research capabilities via MCP, enabling vision and web research tools.51MIT
- AlicenseNot gradedqualityCmaintenanceMCP server bridging ChatGPT to DeepSeek Harness, exposing 13 tools for task submission, status tracking, result retrieval, project/session management, and human-in-the-loop approvals.4MIT
- AlicenseBqualityDmaintenanceLets any MCP-compatible agent analyze, describe, OCR, compare, locate, upload, and manage images through DeepSeek's vision model.81MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to create, edit, animate, inspect, and export icons and icon packs through MCP tools, with live previews and SVG or React output. It provides read, look, write, export, and language-setting tools for agent-driven icon design.MIT