A skin marketplace embedded in the settings page for DSH Web, enabling one-click browsing, installing, activating, updating, and uninstalling of community skins.
- Language
- TypeScript
- License
- MIT
- Branch
- main
Install
$ dsh plugin --profile web add dsh-skin-marketRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin kingOfSoySauce/dsh-skin-market for me: review the repository at https://github.com/kingOfSoySauce/dsh-skin-market first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Line Description
dsh-skin-market is a "Skin Market" embedded in the DSH Web settings page, allowing you to browse, install, activate, deactivate, pin, update, and uninstall community skin plugins like an app store. The installation source is pinned to a specific commit, and failures automatically rollback the profile file, minimizing the risks associated with appearance changes.
Core Capabilities
- Browse the community skin catalog with search/sort by name, tag, light/dark mode
- One-click install, activate, deactivate, pin, update, and uninstall skins within the DSH settings page
- Silently fetch the latest catalog from GitHub Pages every 5 minutes, falling back to cache or built-in catalog when offline
- Display download progress, speed, and real-time stages during skin installation/update, with cancelable operations
- Provide in-page updates for the skin market itself (no DSH restart required to detect new versions)
- Auto-restore snapshots of profile's package.json, cordis.patch.yml, workspace, and lockfile when install/activate fails
Technical Implementation
- Language: TypeScript (with client-side React 18)
- Key Dependencies: @deepseek-ai/cordis (peerDependencies, DSH host framework), @deepseek-ai/dsh-client-ui-primitives (client UI primitives), yaml (read/write cordis.patch.yml), ajv (catalog schema validation)
- Architecture Pattern: Injects webServer/loader/agents services via Cordis, registers a set of HTTP routes (
/dsh-skin-market/...); client injects into settings page'ssettings.sectionslot via slots; actual pnpm install/uninstall via child_process callingdsh pluginsubcommand - Entry Points: src/index.ts (Host side), src/client/index.ts (Client side, injects settings slot)
Use Cases
For users who want to change the DSH Web appearance but don't want to manually copy repositories, edit cordis.patch.yml, or run pnpm commands. Also for users who have installed multiple third-party skins and want unified management, or want to trial several skins before deciding which to keep. If you only install one skin and won't adjust it later, you can directly install a single skin plugin without using this market.
Prerequisites & Compatibility
| Dependency | Minimum Version | Description |
|---|---|---|
| DSH Web | 0.1.0-rc.6 | Both README and catalog's compatibility field point to this version; DSH uses pnpm to manage profile dependencies |
| Node.js | 22 or higher | Stated in README "Local Development" section; source uses ESM and built-in modules like node:crypto/node:fs |
| Platform | macOS / Windows / Linux | Subcommand calls via dsh plugin --profile <name>, no OS/CPU restrictions declared; on Windows, pnpm.cmd needs to be in PATH alongside pnpm |
| Native Modules | None | All dependencies are JS/YAML processing, no native bindings |
Installation
dsh plugin --profile web add github:kingOfSoySauce/dsh-skin-market
Configuration Options
| Config | Type | Description | Default |
|---|---|---|---|
profile | string | Which DSH profile to operate on (reads from --profile CLI arg if not passed, falls back to web) | web |
DSH_SKIN_MARKET_LOCAL_CATALOG | env var | When set to 1, only uses plugin's built-in data/catalog.json, skips remote fetch; for local entry debugging | unset |
DSH_HOME | env var | Overrides DSH user directory location; profile path resolution joins it with profiles/<name> | ~/.dsh |
Note: Each skin in the catalog may declare its own
compatibility.dshandinstall.allowBuild, but these are catalog entry-level attributes, not plugin runtime configuration.
FAQ
Q: What preparation is needed before installing dsh-skin-market?
A: It's recommended to close other skin-related plugins first to avoid conflicts. DSH uses pnpm to manage profile dependencies, so ensure pnpm is in PATH. Local development requires Node.js 22 or higher.
Q: Can skin market installation, update, or uninstallation fail?
A: It won't modify your real profile. Before each operation, it snapshots package.json, cordis.patch.yml, pnpm-workspace.yaml, and pnpm-lock.yaml; on error, it atomically restores and cleans up half-installed states; when encountering pnpm allowBuilds approval, it only writes necessary keys to the corresponding fields.
Q: How are skins in the list obtained? Does the plugin need manual updates each time?
A: No, the market silently validates the remote catalog JSON from GitHub Pages every 5 minutes or when the window regains focus. After validation passes, it writes to the profile's IndexedDB cache; offline or timeout falls back to cache, then to the plugin's built-in catalog.
Q: Why pin to a full commit instead of a branch?
A: Each skin target in the catalog is in the form github:<owner>/<repo>#<40-char commit>, optionally with a &path: subdirectory. Pinning to commit avoids subsequent main branch commits from accidentally overwriting already-captured versions, and the skin detail page can precisely display the source.
Q: What operations does the skin market support? What's the workflow?
A: It supports seven lifecycle operations: install / activate / deactivate / pin (stay active) / unpin / update / uninstall. Each skin can be installed, used, and pinned; before uninstall, if still in use, it automatically deactivates and restores the default appearance, then deletes the package.
Q: Does the skin market actively create GitHub PRs or read private files?
A: No. The browser can only submit skinId from the catalog, cannot submit arbitrary commands or installation addresses; the catalog submission process only goes through PRs in the maintainer's local fork, and explicitly states it doesn't read .env, credentials, chat records, or private files outside the workspace.
Q: No interface change after install or activate. What to do?
A: Most skins require DSH Web restart to take effect. Settings → Skin Market → Select skin → Click "Use" → "Restart DSH". If agents are still running during restart, they will be waited for until idle before safe restart.
Q: How to recover when the page is unresponsive due to skin conflicts?
A: First stop the DSH process, execute ~/.dsh/profiles/web/node_modules/.bin/dsh-skin-market-reset --profile web, which will turn off all skins managed by the market while preserving package files; then restart DSH. The command uses atomic writes and rolls back on failure.
Difficulty Level
Beginner — Users only need to click buttons in the settings page, no manual profile editing required; one-click restore command is also provided for conflicts, no need to understand Cordis or pnpm internals.
Known Issues & Limitations
- Hard timeout for single pnpm subcommand is 10 minutes; large GitHub package downloads may trigger "plugin download timeout" prompt (src/commands.ts:30, src/commands.ts:132-139)
- Catalog requires remote
generatedAtto be strictly >= locally accepted version; if remote catalog is rolled back to older timestamp, it's treated as invalid and old catalog is retained (src/catalog.ts:140-143) - Skin market extends pnpm download timeout via
.npmrc'sfetch-timeout=600000; this is to work around pnpm 11 treating--config.fetchTimeoutas string causing errors (src/lifecycle.ts:117-118) - Only verified on DSH Web
0.1.0-rc.6; README explicitly states this combination passed 132 catalog validations, 70 automated tests, and 5-minute silent update test, but doesn't imply all third-party skins in the catalog have undergone the same level of review (README.md:182-190) - Lifecycle operations like install, activate, deactivate can only run one at a time; concurrent requests are rejected (src/lifecycle.ts:241)
一个嵌入 DSH 设置页的皮肤市场,可以浏览、安装、使用、停用、更新和卸载社区皮肤。
在线预览
近期收录
- 2026-08-19:CAPTAIN1275/dsh-ui-web(
0.2.7)——7 款皮肤一次收录:极光 Aurora、蓝色幻想、龙之继承者、初音未来、Minecraft、鲸吟、Windows XP - 更多请查看收录日志
安装
方式一,命令安装:
安装前请确保已关闭其他皮肤插件,避免冲突
dsh plugin --profile web add 'dsh-skin-market@latest'
方式二,提示词安装:
点击展开提示词
复制以下给 DSH 即可,会先检查冲突,再安装皮肤市场
请把 dsh-skin-market 插件安装到 DSH 的 web profile。不能先安装再检查,必须严格按以下顺序执行:
1. 安装前只读检查 web profile 的 package.json(dependencies 与 dsh.profile.bundles)、profile 的 cordis.patch.yml 和 $DSH_HOME/cordis.patch.yml(如有)。
2. 从当前启用的 bundles 中识别皮肤、主题或外观插件:排除 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app 和 dsh-skin-market;读取候选 package.json 的名称、描述、dsh.client/dsh.bundle 声明,必要时再读 README。无法确定的候选先列出包名和描述。
3. 如果发现已启用的皮肤插件,列出它们并停在安装前,提醒我先停用以避免冲突;未经我确认不得修改任何 profile 文件,也不得执行安装。
4. 如果没有冲突,明确说“未检测到已启用的皮肤插件”,然后直接执行:
dsh plugin --profile web add 'dsh-skin-market@latest'
5. 安装后读取 web profile 的 package.json,确认 dependencies 和 dsh.profile.bundles 中都有 dsh-skin-market;缺失则报告安装或注册失败。
6. 告诉我如何重启 DSH Web,并确认重启后可从“设置 → 皮肤市场”打开。不要替我安装任何皮肤。
如果安装命令报错(例如 pnpm 不在 PATH、allowBuilds 构建审批、manifest 缺失),再读 https://github.com/kingOfSoySauce/dsh-skin-market 的 README「安装失败时,可以让 DSH 自己排查」一节处理,或把完整报错贴给我。
安装失败时,可以让 DSH 自己排查
皮肤市场的安装、更新和卸载会调用 DSH 的 profile 插件管理器;当前 DSH 使用
pnpm管理 profile 依赖。如果出现pnpm is not recognized、package manifest missing或allowBuilds相关报错,不必手动猜测 profile 状态。
点击展开排查提示词
把完整原始报错填入后复制给你的 DSH Agent:
请帮我排查 DSH Web 皮肤市场的安装失败。下面是完整原始报错:
<把完整报错粘贴到这里>
请严格按以下 3 步处理,并报告每一步的结果:
1. 确认当前使用的 profile 名称和实际目录,并检查 DSH 进程自身是否能找到 pnpm(Windows 同时检查 pnpm.cmd)。如果 pnpm 不在 PATH,先说明如何安装或修复 pnpm,并停止把问题误判为 allowBuilds 配置问题。
2. 只有确认 pnpm 可用后,才检查 profile 的 pnpm-workspace.yaml。若 pnpm 输出了构建审批 key,只把报错中完整、精确的 key 合并到 allowBuilds,对应值设为 true;不要启用 dangerouslyAllowAllBuilds,也不要放宽其他包。不要读取 .env、凭据或聊天记录。
3. 重新执行原来的皮肤安装命令。完成后验证 profile package.json 依赖、node_modules 中目标包的 package.json、dsh.client/dsh.bundle 声明和 loader 注册项;如果仍失败,请指出具体失败阶段和完整错误,不要把 package manifest missing 当作根因。
更新本插件
方式一,页面更新(推荐):
在「设置 → 皮肤市场」标题右侧点击“更新”,完成后会提醒重启 DSH Web。
方式二,命令更新:
dsh plugin --profile web add 'dsh-skin-market@latest'
完成后需手动重启 DSH
方式三,提示词更新:
点击展开提示词
复制以下内容给 DSH Agent:
请把已安装在 DSH Web profile 的 dsh-skin-market 更新到 npm 最新版本。
请严格按以下顺序执行:
1. 确认当前使用的是 web profile,并读取其 package.json,确认已安装 dsh-skin-market;不要先卸载,也不要修改其他皮肤。
2. 执行:
dsh plugin --profile web add 'dsh-skin-market@latest'
3. 更新后重新读取 web profile 的 package.json,确认 dsh-skin-market 依赖和 bundle 注册仍然存在。
4. 告诉我更新前后版本,并提醒我确认没有 Agent 正在运行后重启 DSH Web。不要替我更新或卸载任何社区皮肤。
收录你的皮肤
如果你开发了 DSH 皮肤,先准备一个公开的 GitHub 仓库,再复制下面整段提示词给你的 Agent。把 <你的皮肤仓库地址> 换成真实地址即可。
这不是终端命令,而是交给 Agent 的任务说明:
点击展开提示词
复制以下整段提示词给你的 Agent:
请把我的 DSH 皮肤提交到 DSH 皮肤市场。
皮肤仓库:<你的皮肤仓库地址>
目标目录仓库:https://github.com/kingOfSoySauce/dsh-skin-market
目录路径:registry/skins
请自主完成以下工作:
1. 只用只读方式检查皮肤仓库;识别单包或 monorepo 子包,读取 package.json、DSH bundle/client 声明、cordis.patch.yml、README、许可证、真实预览图和 release/tag。
2. 确认它确实是可安装的 DSH Web 皮肤,不要仅凭仓库名、README 文案或 dsh-plugin topic 判定。
3. 解析准备收录版本对应的完整 40 位 commit SHA。安装目标必须固定到该 SHA,禁止使用 main、master、HEAD 或其他可变分支。
4. 不要猜测皮肤名、包名、rowId、许可证、兼容版本或素材授权。缺少关键信息时先列出缺项,不要创建虚假条目。
5. 预览图只选择仓库内真实截图,使用固定 commit 的 GitHub raw HTTPS 地址;不要使用 SVG、data URI、第三方图床或带追踪参数的 URL。
6. fork 或 clone 目标目录仓库并新建分支;按照 registry/skin.schema.json,在 registry/skins 下只新增一个独立 YAML。不要修改或提交生成的 data/catalog.json,也不要覆盖已有条目。
7. 在目标目录仓库根目录运行 npm run registry:check 和相关测试。这个检查只验证 registry,不会改写生成文件。不得安装到我的真实 DSH profile,不得读取 .env、凭据、聊天记录或工作区外的私密文件。
8. 检查 git diff --name-only,确认变更只包含 registry/skins/<条目文件>.yml;提交变更并向目标目录仓库创建 PR。PR 标题使用“feat(registry): add <皮肤名>”,正文列出仓库、子包、版本、commit、许可证、预览来源、兼容性、自动检查结果和仍需人工确认的风险。
9. 创建 PR 后返回 PR 链接;如果没有 GitHub 权限或需要登录,只准备好分支、commit 和可复制的 PR 内容,并明确告诉我下一步。
收录不等于安全认证。不要声称该皮肤已被 DSH 官方、安全团队或市场背书。
皮肤市场里的「提交皮肤」也可以根据仓库地址生成这段提示词。
registry/skins/ 是社区提交的唯一事实来源,每个皮肤一个 YAML 文件。data/catalog.json 是生成文件,不需要在社区 PR 中维护;PR 合并到 main 后会由仓库自动重生成。这样新增皮肤之间不会因为共同编辑一个目录文件而反复冲突。
收录要求
皮肤市场同时支持带 dsh.bundle 的完整插件和只有 dsh.client 的纯前端皮肤。对于后者,市场会在安装后自动、幂等地写入该皮肤已审核的 rowId 和 package 注册项;卸载时一并移除。维护者不必为了进入市场而额外复制一份 cordis.patch.yml,但仍须在 package 或 README 中提供明确的 row ID 和 DSH 兼容范围。
- 必须是公开、可安装的 DSH Web 皮肤仓库或 monorepo 子包
- 安装来源必须固定到完整 40 位 commit SHA
- 必须提供明确的 package、row ID、许可证和兼容范围
- 预览图必须是仓库中的真实界面截图
- Topic、仓库名称和 Stars 只用于发现与排序,不代表安全审核或官方背书
仓库健康建议
市场在同步已收录仓库时会检查三项便于用户理解和安装的基础规范,并在皮肤详情页展示结果:
- README 是否展示仓库内、可固定到版本的真实界面截图
- README 或 package 元数据是否明确声明支持的 DSH Web 版本范围
- package 名称、
dsh.clientWeb 声明、row ID 和已构建客户端入口是否满足市场的一键安装要求
检查结果用于给维护者提供改进建议,不代表安全认证。暂未满足某项规范时,页面会说明如何完善,而不会把仓库描述为“不可用”。
“兼容性待验证”和“市场能否安装”是两个独立维度:
- 兼容性表示维护者是否明确声明并验证了支持的 DSH Web 版本;缺少声明时会提示风险,但不会单独阻止市场安装。
- 市场安装表示目录是否具备固定安装目标、package、
dsh.clientWeb 声明、row ID 和可解析的已构建客户端入口。符合这些条件时,市场会调用 DSH 的plugin add命令完成安装;不要求插件仓库自行实现名为add的命令。
兼容性验证
当前面向 DSH Web 0.1.0-rc.6。目录中的安装目标固定到收录时的完整 commit。
截至 2026-08-17,npm 的 DSH latest 与 next 均为 0.1.0-rc.6。本项目使用重新安装的该版本完成了以下验证:
- 皮肤市场
0.1.15:132 条目录校验、70 项自动化测试、类型检查、Host/Client 构建、站点构建和 package preflight 全部通过 - DSH Web 实机启动:市场 Host 路由、客户端设置入口、在线目录和 5 分钟静默更新正常加载
- Liang Intensity
0.1.4联合冒烟:8 项测试和客户端 bundle 构建通过,并可在同一 DSH Web profile 中保持 active
这组结果证明上述版本组合可以启动和运行,不代表市场内所有第三方皮肤都已完成同等级别的人工兼容或安全审核。
在线目录更新
已安装的皮肤市场不需要升级插件才能看到新收录或更新后的皮肤:
- 打开市场时由 DSH Host 从 GitHub Pages 拉取最新
catalog.json - 页面保持打开时每 5 分钟静默检查一次;窗口重新获得焦点时也会立即静默检查
- npm 上出现更高的市场插件版本时,标题右侧会显示下载按钮;悬停后显示“更新”,安装完成后提示重启生效
- 浏览器会用 IndexedDB 保留最近一次有效目录;再次打开时先展示缓存,再在后台校验在线目录
- 列表首批只渲染 20 个皮肤,接近底部时每次无感追加 20 个;搜索和排序仍覆盖完整目录
- 首次无缓存时显示结构化骨架屏,预览图延迟加载并保留固定尺寸,避免页面跳动
- 远程目录通过 schema、唯一 ID/package/rowId、GitHub 仓库地址和固定 commit 安装目标校验后,才会进入可安装生命周期
- 验证成功的目录会缓存到当前 profile;离线、超时或远程数据不合法时自动回退到缓存,再回退到插件内置目录
- 每日抓取任务在完整测试通过后直接部署在线目录,同时继续创建 registry PR 留下可审查记录
本地开发
需要 Node.js 22 或更高版本。
git clone https://github.com/kingOfSoySauce/dsh-skin-market.git
cd dsh-skin-market
npm install
npm run dev
npm run dev 只启动使用 Mock Host 数据的预览页面,不会修改任何 DSH profile。
本地目录调试
本地开发 DSH 皮肤时,市场默认仍会从 GitHub Pages 请求远程 catalog.json,因此刚写入本地 registry/skins 的条目可能被远程目录覆盖。启动 DSH Web 前设置下面的开发环境变量,市场会固定使用当前构建包内的 data/catalog.json,不发起远程目录请求:
DSH_SKIN_MARKET_LOCAL_CATALOG=1 dsh web
该开关只影响当前进程的目录读取;安装、激活、停用、更新和卸载仍然经过本地市场的完整生命周期。未设置时保持线上行为:优先读取远程目录,并在失败时回退到缓存和内置目录。
本地条目验证完成后,再删除该环境变量运行 DSH,确认远程目录行为没有被改变。
本地验证生成的 WebP
WebP 是独立的市场静态资源,catalog 中的 media 字段会让插件和在线页默认直接请求 GitHub Pages 上的 preview/full;没有对应 WebP 或请求失败时,继续使用原始 PNG/JPG。需要重新生成资源时,先安装 cwebp(macOS 可用 brew install webp),然后运行:
npm run registry
npm run media:build
本地调试默认也请求线上 WebP。只有需要关闭 WebP 对比原图时,才在地址后追加:
?dsh-media=0
对应仓库图片更新后,媒体脚本会重新下载并更新同一内容键;图片资源先发布到 ops 和 public market,插件代码可以单独发布。
常用检查命令:
npm run registry
npm test
npm run typecheck
npm run build
npm run release -- 0.1.31 --dry-run
正式发布时去掉 --dry-run;脚本会校验工作区、同步 npm 版本、提交并推送 Git tag,再发布 npm。需要同时创建 GitHub Release 时追加 --github-release。
完整的本地安装和回滚验证步骤见 TESTING.md。
目录维护
公共仓库保留 registry Schema、目录生成和社区提交校验。候选发现、全量收录、实机截图补录和运营报告属于维护者内部流程,不随市场运行时发布;正式目录条目仍位于 registry/skins/,data/catalog.json 是生成文件。
市场截图会作为 marketScreenshots 与上游截图合并展示;公共构建只负责校验和合并,不包含截图采集或提升工具。
安全说明
- 浏览器只能提交 registry 中的
skinId,不能提交任意命令或安装地址 - 安装、更新和激活失败时会恢复 profile manifest 快照并清理半安装状态
- GitHub Stars 由定时收录任务写入带更新时间的目录快照,页面和 Host 都不在浏览时请求 GitHub API
- 市场不会代替开发者登录 GitHub,也不会静默创建 PR
页面异常时重置皮肤
如果皮肤冲突导致 DSH 页面无法操作,先停止当前 DSH 进程,再执行:
~/.dsh/profiles/web/node_modules/.bin/dsh-skin-market-reset --profile web
该命令会关闭皮肤市场管理的所有皮肤并恢复默认外观,但保留已经安装的皮肤包和皮肤市场。随后重新启动 DSH 即可。命令使用原子写入;任何一步失败都会恢复执行前的 profile 文件。
License
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/kingOfSoySauce/dsh-skin-market)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.