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:2領域背景(サイドバー/メインエリア)、画像/グラデーション背景、グラスモーフィズム、トークンカラー、領域セレクター、WYSIWYG |
🤖 Agent Skill | インストール後、DSH / Codex アシスタントが「スキン変更 / この画像を背景に使う」リクエストを受け取ると、自動的に完全なスキン変更フローを実行 |
🔌 MCP Server(26 ツール) |
|
🖥️ DSH プラグイン | 常駐背景(bodyレベルのCSS、会話切替えでも無効にならない)、会話マスク(クリック即反映、切替えに違和感なし)、サイドバー区切り線、残高バー(設定上部の残高ボタン+会話詳細の残高表示、リフレッシュ可能) |
🛡️ セキュリティ境界 | 全ての「DSH書き込み」操作は 隔離DSHプレビュー → 不変のapply計画 → 可視UI上での手動確認 を経る。MCPは決して確認を偽造できない |
📦 ワンクリックインストール | PowerShellインストーラーが自動で ビルド → スキルインストール → プラグイン登録 → MCP登録 → Studio起動 → (オプション)Codex同期 を実行 |
📦 インストール
前提条件
依存 | バージョン | 説明 |
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を再起動(デフォルトは再起動しない、実行中のセッションを中断しないため) |
例(カスタムインストール + インストール後に自動再起動):
.\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 Keyはホスト側でのみ解析(
DSH_SKIN_BALANCE_API_KEY→DEEPSEEK_API_KEY→%DSH_HOME%\.credentials.yaml)、ブラウザには集約された残高のみ表示、キーはブラウザに保存されない。
📄 ドキュメント
docx/— 実装計画、要件分析仕様書、技術アーキテクチャ設計仕様書CHANGELOG.md— 変更履歴RELEASING.md— リリースチェックリスト(GitHub Release / npm)
📃 ライセンス
MIT © 2026 trrrrrryg
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Generate on-brand images from your AI agent: design, edit, and render templates over MCP.
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/trrrrrryg/dsh-visual-skin'
If you have feedback or need assistance with the MCP directory API, please join our Discord server