dsh-visual-skin
dsh-visual-skin
DeepSeek Harness Skin Studio — DeepSeek Harness 向けワンクリックビジュアルスキンツール
A visual skin studio for DeepSeek Harness (DSH): design, preview and safely apply skins with one click — no config files to touch. Ship as an Agent Skill + MCP server + DSH plugin, with a one-shot PowerShell installer.
インストール後、AIアシスタントは画像1枚で、画像アップロード → テーマ作成 → 隔離プレビュー → 手動確認適用 という完全なスキン変更フローを自動実行できます。また、独立したStudioウェブページでスキンを視覚的に調整し、ワンクリックでDSHに書き込むこともできます。
✨ 機能
機能 | 説明 |
🎨 Skin Studio(ビジュアルデザイナー) | 独立Web UI:二重領域背景(サイドバー/メインエリア)、画像/グラデーション背景、ガラスモーフィズム、トーンカラー、領域セレクター、WYSIWYG |
🤖 Agent Skill | インストール後、DSH / Codex アシスタントが「スキン変更 / この画像を背景に」というリクエストを受け取ると、完全なスキン変更フローを自動でオーケストレーションします。 |
🔌 MCP Server(26ツール) |
|
🖥️ DSH プラグイン | 常駐背景(bodyレベルのCSS、会話を切り替えても無効にならない)、会話オーバーレイ(クリックで即時適用、切り替えても違和感なし)、サイドバーセパレーター、残高バー(設定上の残高ボタン + 会話詳細の残高表示、更新可能)。 |
🛡️ セキュリティ境界 | すべての「DSHへの書き込み」操作は、隔離DSHプレビュー → 不変のapply計画 → 可視UIでの手動確認 を経由します。MCPが確認を偽造することは決してできません。 |
📦 ワンクリックインストール | PowerShellインストーラーが自動で、ビルド → Skillインストール → プラグイン登録 → MCP登録 → Studio起動 → (オプション)Codex同期を実行します。 |
Related MCP server: gpt-dsh-bridge
🎬 デモ
Hero · 暗いステージでの展示(12秒) | 生成 · 画像からスキンへ(7秒) |
|
|
アニメーション制作:huashu-design · ストーリーボード:docs/demo/storyboard.md · 方向性ボード:docs/demo/direction-boards.html
📦 インストール
前提条件
依存関係 | バージョン | 説明 |
Windows | 10 / 11 | インストーラーはPowerShellスクリプト |
22+ | プラグインとControllerの実行に必須 | |
11+ | 初回インストール時のみ必要(ポータブルランタイムのビルド用) | |
0.1.0-rc.6 | ターゲットバージョン、機能ピン留め、バージョン不一致時はプラグインはfail-closed |
方法1:コマンドラインインストール(推奨)
# 1. 获取项目
git clone https://github.com/trrrrrryg/dsh-visual-skin.git
cd dsh-visual-skin
# 2. 一键安装(默认目标:%USERPROFILE%\.dsh,profile: web,Controller 端口 11862)
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1インストーラーが自動で以下を実行します:
自己完結型ポータブルランタイムのビルド/再利用(Controller + Studio + MCP + プラグイン、約51MB、Skillディレクトリにインストール);
Skillを
%DSH_HOME%\skills\deepseek-harness-skin-studioにインストール(DSHアシスタントが即座にスキルを取得);DSHプラグインを登録(
cordis.patch.yml管理ブロック、スキン設定設定カードを含む);MCPサーバーを登録(
mcp__skin-studio__*、インストール後の自己完結型ランタイムを指す);Studioを起動(Controller、デフォルトポート11862、ブラウザで
http://127.0.0.1:11862にアクセス);Codexを検出した場合、自動的にSkillを同期し、Codex MCPを登録します。
インストール完了後、DSHを一度再起動(またはデスクトップランチャーで再起動)して、プロファイルパッチとMCPクライアントを有効にしてください。
オプションパラメータ
パラメータ | 説明 |
| DSHルートディレクトリ(デフォルト |
| ターゲットプロファイル(デフォルト |
| Studioデータディレクトリ(デフォルト |
| Studio Controllerポート(デフォルト |
| 既存のビルド済みランタイムを使用し、ビルドをスキップ |
| 対応するコンポーネントをスキップ |
| インストール後にDSHを自動再起動(デフォルトは再起動しない、実行中のセッションを中断しないため) |
例(カスタムインストール + インストール後にDSHを自動再起動):
.\install.ps1 -DshHome C:\Users\me\.dsh -ProfileName web -ControllerPort 12000 -RestartDsh方法2:AIインストール
このリポジトリを任意のエージェントに渡し、次のように指示します:
READMEとこのリポジトリの
install.ps1を読んで、インストールを実行してください。
エージェントは上記のフローに従ってインストールを完了します(直接 install.ps1 を実行することもできます)。
インストールの確認
# 插件健康检查(在 DSH 端口上,应返回 ok:true;默认 DSH 端口 10402)
Invoke-RestMethod http://127.0.0.1:10402/dsh-skin/health
# Controller / Studio 状态检查(应返回 ok:true、capabilities.compatible:true)
Invoke-RestMethod http://127.0.0.1:11862/api/v1/statusStudioを開く:
http://127.0.0.1:11862(またはスタートメニュー/タスクトレイアイコンをクリック)DSHの設定ページに「スキン設定」カードが表示されるはずです。アシスタントに「スキンを変更して」と言うと、
mcp__skin-studio__*ツールがトリガーされます。
🚀 使い方
インストールして再起動したら、DSHアシスタントに直接話しかけてください:
「スキンを変更して」 / 「この画像を背景にして」 → アシスタントが自動的に
mcp__skin-studio__*を呼び出して作成し、Studioでプレビューします;「今のスキンの背景を変えて」 → アシスタントが現在のデザインを変更します;
Studioで手動調整(背景、領域、トーン、セパレーター)→ 「DSHに書き込む」 をクリック、ポップアップする計画確認ウィンドウで手動確認 → DSHを再起動すると反映されます。
スキン変更フローチャート
用户指令 / 图片 ──▶ Agent Skill ──▶ MCP (design_create → asset_upload → theme_patch
→ theme_validate → preview_start)
│
▼
隔离 DSH 预览(真实渲染,不碰你的 DSH)
│
▼
Studio 可见确认(theme_apply_plan → theme_apply)
│
▼
你的 DSH 皮肤生效(可随时 Restore 还原)🗂️ ディレクトリ構造
├─ install.ps1 # 一键安装器(命令行 / AI)
├─ apps/
│ ├─ controller/ # Studio 后端(API、隔离预览、apply/restore、GC)
│ └─ studio/ # Studio Web UI(React + Vite)
├─ packages/
│ ├─ dsh-plugin/ # DSH 插件(host 路由 + client 皮肤渲染)
│ ├─ theme-schema/ # ThemeSpec v2 数据契约
│ ├─ design-session-core/ # 设计会话 / 确认票据 / 操作日志
│ ├─ shared/ # 跨端类型与错误码
│ ├─ agent-cli/ # dsh-skin JSON CLI
│ ├─ mcp-server/ # MCP stdio 服务器(26 个工具)
│ └─ portable-runtime/ # 便携运行时聚合
├─ agents/codex-skill/deepseek-harness-skin-studio/
│ ├─ SKILL.md # Agent Skill 指令(自动换肤流程)
│ └─ scripts/ # open-studio / build-portable / install-local
├─ research/ # 同类项目调研材料(16 个项目 README)
├─ docx/ # 项目文档(实施计划 / 需求分析 / 架构设计)
└─ tests/ # 回归测试(含真实 rc.6 隔离 Chromium 预览)🛠️ 開発
pnpm install # 安装依赖(需要 Node 22+ / pnpm 11+)
pnpm build # 构建全部包
pnpm test # 回归测试(会启动真实 rc.6 隔离预览)
pnpm controller # 本地启动 Controller(开发)
pnpm dev # Studio 开发模式(Vite)🗑️ アンインストール
%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を削除します。
🔒 セキュリティと互換性
ターゲットDSHバージョン:
0.1.0-rc.6(機能ピン留め、バージョン不一致時はプラグインはfail-closed)。スキンモデル(ThemeSpec)は構造化データのみ許可:リテラルCSS色、コンテンツアドレス可能画像(sha256)、制御されたトークン。任意のCSS/JS/URLは受け付けません。
プレビューにはControllerが所有する隔離された一時DSHを使用します。確認と書き込みは、可視のStudio内の人間が行う必要があります。
残高照会:APIキーはホスト側でのみ解析されます(
DSH_SKIN_BALANCE_API_KEY→DEEPSEEK_API_KEY→%DSH_HOME%\.credentials.yaml)。ブラウザには集約された残高のみが表示され、キーはブラウザに保存されません。
📄 ドキュメント
docx/— 実装計画、要件分析仕様書、技術アーキテクチャ設計仕様書CHANGELOG.md— 変更履歴RELEASING.md— リリースチェックリスト(GitHub Release / npm)
📃 License
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

