Skip to content
Back to search

dsh-skin-market

DeepSeek Harness skin market 皮肤市场 已收录200+DSH 皮肤 完善评分系统加人工审核,有便捷的社区收录入口;有在线页面方便在线浏览,也有插件方便管理本地皮肤

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kingOfSoySauce/dsh-skin-market with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kingOfSoySauce/dsh-skin-market'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kingofsoysauce--dsh-skin-market/badge.svg)](/listings/kingofsoysauce--dsh-skin-market)

HTML

<a href="/listings/kingofsoysauce--dsh-skin-market"><img src="/api/listings/kingofsoysauce--dsh-skin-market/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

安装方式

> 安装前请确保已关闭其他皮肤插件,避免冲突

Web 版(命令行)

dsh plugin --profile web add "dsh-skin-market@latest"

官方 Desktop

APP左上角「插件 → 添加插件」中输入 `dsh-skin-market@latest` 并启用

提示词安装

<details> <summary><strong>点击展开安装提示词</strong></summary>

复制以下给 DSH Agent;它会先判断宿主,再选择安装方式。

请安装 dsh-skin-market。先运行 dsh --version,并根据当前宿主和实际 profile 的 package.json/bundles 判断是 Web 版还是官方 Desktop;无法判断就先问我。

- Web 版:先检查冲突,再执行 dsh plugin --profile web add "dsh-skin-market@latest"。
- 官方 Desktop:不要执行 dsh plugin --profile desktop;在桌面应用「插件 → 添加插件」中输入 dsh-skin-market@latest 并启用。

安装前只读检查当前宿主实际 profile,发现其他皮肤插件就列出并停下;没有冲突才安装。安装后验证同一 profile 中有 dsh-skin-market 的依赖和 bundle,并告诉我重启哪个宿主、从哪里打开「皮肤市场」。不要替我安装其他皮肤。

</details>

---

<a id="install-troubleshooting"></a>

安装失败时,可以让 DSH 自己排查

把完整原始报错粘贴给 DSH Agent;它会先区分 Web 和官方 Desktop,再按实际 profile 排查。

<details> <summary><strong>点击展开排查说明与提示词</strong></summary>

> 皮肤市场的安装、更新和卸载会调用 DSH 的 profile 插件管理器;当前 DSH 使用 `pnpm` 管理 profile 依赖。如果出现 `pnpm is not recognized`、`package manifest missing` 或 `allowBuilds` 相关报错,不必手动猜测 profile 状态。 > > 含子目录路径的 GitHub 目标(`github:…#commit&path:/…`)请优先用市场页一键安装。市场安装结束后会校验 `node_modules` 中的包名是否与目录一致,避免 `&path:` 被截断时误把仓库根包装成成功。Windows 上不要把这段 spec 交给 `dsh plugin add`:cmd.exe 会在 `&` 处截断。下面的手动命令仅适用于 Web profile;官方 Desktop 请使用桌面插件管理器: > > ```powershell > pnpm add "github:owner/repo#<commit>&path:/subdir" --dir $env:USERPROFILE\.dsh\profiles\web > ``` > > 如果报错含 `ERR_PNPM_UNEXPECTED_STORE`,是 profile 的 `node_modules` 与当前 pnpm store 代际不一致(常见于本机同时装了 pnpm 10 / store v10 和 pnpm 11 / store v11)。在 **profile 目录内** 查看 `node_modules/.modules.yaml` 的 `packageManager` 和 `storeDir`,再对比同一目录下的 `pnpm --version` 与 `pnpm store path`;不要用 DSH 源码仓库目录里的结果来判断。用 `.modules.yaml` 记录的同一版 pnpm 重试,或用当前 pnpm 重建该 profile 的 `node_modules`。Windows 上 `dsh plugin add` 走 PATH 上的 pnpm,不会因为源码仓库写了 `"packageManager": "pnpm@11"` 就自动切换。

把完整原始报错填入后复制给你的 DSH Agent。它会先判断当前是 Web 还是官方 Desktop;无法判断时先询问你:

请帮我排查 DSH 皮肤市场的安装或启用失败。先运行 dsh --version,并根据当前宿主和实际 profile 判断是 Web 版还是官方 Desktop;无法判断就先问我。下面是完整原始报错:

<把完整报错粘贴到这里>

如果是官方 Desktop:只读检查桌面应用插件管理器中的 dsh-skin-market 状态和完整原始错误;不要执行 dsh plugin --profile desktop,也不要手动修改 profile。若错误是 same-origin request required,请报告该错误并停止,不要猜测或重写 profile。

如果是 Web 版,请严格按以下 3 步处理,并报告每一步的结果:

1. 确认当前使用的 profile 名称和实际目录,并检查 DSH 进程自身是否能找到 pnpm(Windows 同时检查 pnpm.cmd)。如果 pnpm 不在 PATH,先说明如何安装或修复 pnpm,并停止把问题误判为 allowBuilds 配置问题。如果报错含 ERR_PNPM_UNEXPECTED_STORE,再比较 profile 的 node_modules/.modules.yaml(packageManager、storeDir)与「在 profile 目录内」执行的 pnpm --version / pnpm store path;不要用 DSH 源码仓库目录里的 pnpm 版本来判断。用同一版 pnpm 重试,或用当前 pnpm 重建该 profile 的 node_modules。
2. 只有确认 pnpm 可用且 store 一致后,才检查 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 当作根因。

</details>

安装来源与长时间等待

Web 市场优先使用目录中已经核验的 npm 精确版本;没有合格 npm 来源时,继续使用 GitHub 固定 commit。遇到长时间等待时,请提供皮肤名、DSH/市场版本、操作系统及市场横幅中的“复制日志”。

<details> <summary><strong>点击展开安装来源校验与等待机制</strong></summary>

npm 来源须与目录的包名、版本、仓库、完整 commit 一致,并通过安装包完整性与已构建客户端入口检查。已有的 GitHub 安装仍然有效,不会仅因目录补充 npm 来源而要求重装。

安装横幅显示当前步骤、尝试次数和 pnpm 阶段;连续 30 秒没有输出时会提示,运行中也能复制诊断日志。Web 安装和更新的准备、下载、重试共用 15 分钟预算,达到时限后结束当前任务;已修改 profile 的失败操作只做一次、独立限时 60 秒的依赖恢复。市场会等待执行进程结束后再允许下一次操作,恢复未完成时会明确提示。Desktop 的安装失败恢复由宿主插件服务处理。

浏览器能够访问 GitHub,不能单独证明实际运行 DSH 的进程和 pnpm 已使用相同代理;也可能卡在依赖解析或构建阶段。

</details>

<a id="manual-update"></a>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 330 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # DSH 皮肤市场 <sub><a href="./README.en.md">English</a></sub>
  2. 浏览、搜索、安装并管理 DSH 皮肤。
  3. <p align="center">
  4. <img src="./docs/assets/skin-market-liang.png" alt="DSH 设置中的皮肤市场发现页" width="70%">
  5. </p>
  6. <p align="center">
  7. <img src="./docs/assets/skin-market-deep-whale.png" alt="DSH 皮肤市场中的 Deep Whale 皮肤详情弹窗" width="70%">
  8. </p>
  9. ## 在线预览
  10. [打开在线皮肤市场](https://kingofsoysauce.github.io/dsh-skin-market/)
  11. ### 近期收录
  12. - **2026-11-18**:[深深桌宠手机版](https://github.com/Jcnet-9527/dsh-Jpet-phone)(Jcnet-9527)——把 PC2005-cloud/dsh-pet v0.3.7 的大肥鱼桌宠搬到安卓手机版:插件版常驻页面、可拖动、被戳会回应,随会话状态换动作,还能聊天和查余额;同仓库另带独立安卓悬浮 App,不装插件也能在系统最上层常驻,语音识别与朗读都在手机本地跑。详见[收录日志](./docs/recently-added.md#recent-2026-11-18-jcnet-9527-dsh-jpet-phone)。
  13. 最新收录见[收录日志](./docs/recently-added.md)。
  14. <a id="manual-update"></a>
  15. ## 安装、更新
  16. 兼容 DSH Web `>=0.1.0-rc.6` 与官方 Desktop `>=0.2.0-rc.1`。
  17. > 更新失败时先按弹窗原因处理,不要先卸载:官方 Desktop 卸载市场会先摘掉正在运行的插件。Web 可直接重装;Desktop 到「插件 → 添加插件」重新添加 `dsh-skin-market@latest`。重装仍失败时再复制诊断日志。
  18. ### 方法 1:命令
  19. 终端执行:
  20. ```sh
  21. dsh plugin --profile web add "dsh-skin-market@latest"
  22. ```
  23. ### 方法 2:应用内
  24. 左上角「插件 → 添加插件」,输入:
  25. ```text
  26. dsh-skin-market@latest
  27. ```
  28. ### 方法 3:插件内更新
  29. 皮肤市场内点击「更新」按钮
  30. ### 方法 4: Agent 帮忙
  31. 复制下面的提示词给你的 DSH Agent。它会先判断当前是 Web 还是官方 Desktop。Web 由 Agent 执行命令;官方 Desktop 如果当前 DSH 提供插件管理工具(plugin_manager),Agent 可以在你确认精确目标和 profile 后直接安装/启用;工具不可用或需要应用内确认时,Agent 指导你在「插件 → 添加插件」操作。重启仍由你完成。
  32. <details>
  33. <summary><strong>点击展开提示词</strong></summary>
  34. **安装提示词**
  35. ```text
  36. 请帮我安装 dsh-skin-market。先只读确认当前是 Web 版还是官方 Desktop,以及当前宿主和实际 profile。Web 查看 dsh --version;官方 Desktop 以应用“关于”中的版本为准,不把系统终端的 npm dsh 版本当作桌面版本。无法读取应用信息时,请让我提供该版本;无法判断宿主就先问我。
  37. - Web 版:执行 dsh plugin --profile web add "dsh-skin-market@latest",然后核对同一 web profile 中的依赖和 bundle。
  38. - 官方 Desktop:先只读确认当前 profile 和已安装版本。如果当前宿主提供插件管理工具(plugin_manager)且你能确认当前 profile,先告诉我准备安装/更新的精确目标和会修改的 profile,我确认后由你安装并启用;安装后核对实际版本、启用状态和是否需要重启。工具不可用、宿主拒绝或需要我在应用内确认时,再指导我打开「插件 → 添加插件」,输入 dsh-skin-market@latest,由我点击安装并按应用提示启用。不要执行 dsh plugin --profile desktop,不要用 npm/pnpm 直接写 Desktop profile,也不要手改 profile。重启由我完成。每次只给一个操作,等我反馈再继续。
  39. 这次只安装皮肤市场,不做其他皮肤的冲突检查,也不要求停用它们。不要替我安装其他皮肤。安装后告诉我从哪里打开「皮肤市场」;Desktop 以插件页状态和我的实际操作反馈核对结果,没有核实就不要声称安装或启用成功。不要读取 .env、凭据或聊天记录。
  40. ```
  41. **更新提示词**
  42. ```text
  43. 请更新已安装的 dsh-skin-market。先判断当前宿主和实际 profile:Web 查看 dsh --version;官方 Desktop 查看应用“关于”中的版本,不用系统终端的 npm dsh 版本替代。无法判断就先问我。
  44. - Web 版:只读确认 web profile 已安装 dsh-skin-market,再执行 dsh plugin --profile web add "dsh-skin-market@latest"。
  45. - 官方 Desktop:先只读核对版本和插件状态。如果当前宿主提供插件管理工具(plugin_manager)且你能确认 profile,先告诉我准备更新的精确目标和会修改的 profile,我确认后由你更新并启用;更新后核对实际版本、启用状态和是否需要重启。工具不可用、宿主拒绝或需要我在应用内确认时,再指导我在「插件 → 添加插件」中输入 dsh-skin-market@latest、确认更新结果并按提示启用。不要执行 dsh plugin --profile desktop,不要用 npm/pnpm 直接写 Desktop profile,也不要手改 profile。重启由我完成。
  46. Web 更新后验证同一宿主的 dsh-skin-market 依赖和 bundle;Desktop 根据插件页状态和我的实际反馈核对结果,没有核实就不要声称成功。告诉我更新前后版本及需要重启哪个宿主。不要替我更新或卸载其他皮肤。
  47. ```
  48. </details>
  49. ## 使用皮肤
  50. 打开「设置 → 皮肤市场」或 「插件 → dsh-skin-market」
  51. ### 从市场安装具体皮肤
  52. 可直接安装的 npm 皮肤会使用「安装」或「安装并使用」流程。官方 Desktop 默认先安装,再进入使用确认;取消使用确认时,皮肤包会保留,但不会启用。
  53. 标为「需手动安装」的皮肤,需要把市场提供的完整固定目标交给 Agent。有已发布 npm 包时用 `name@version`(预构建);没有 npm 包时才用 GitHub 完整 commit 和 `&path:/子目录`。不要用未构建的 GitHub 源码代替 npm 包,也不要把 commit 或子目录改成 `latest`、仓库主分支或另一个包名。
  54. <details>
  55. <summary><strong>点击展开手动皮肤安装流程</strong></summary>
  56. Agent 先只读确认当前 Desktop 版本和其他已启用的皮肤;发现冲突时列出名称,指导你在应用中停用,并核对停用结果后再继续。拿不到启用状态时,应请你提供插件列表或界面状态,不能把“无法确认”当成“没有冲突”。
  57. 安装目标使用面板给出的完整固定 spec。有 npm 包的皮肤优先 `name@version`;没有 npm 包时用 GitHub 完整 commit,monorepo 子包还要保留 `&path:/子目录`,例如 `github:owner/repo#<完整 commit>&path:/packages/skin`。不要把该目标换成 `latest` 或仓库主分支。
  58. 如果当前宿主提供插件管理工具(plugin_manager),Agent 把最终精确目标和会修改的 profile 发给你确认后,可直接安装(默认不启用);需要启用时先查冲突并再次确认。工具不可用、宿主拒绝或需要你在应用内处理构建授权时,Agent 指导你打开「插件 → 添加插件」、粘贴完整目标、确认安装结果、按提示启用,最后按当前版本要求完全退出并重新打开应用。Agent 不执行 `dsh plugin --profile desktop`,不手改 profile;构建授权只按宿主返回的精确项逐项确认;重启由你完成。界面不支持该目标或安装失败时,先核对原始报错和维护者说明,再决定下一步;依赖伴生包的皮肤须核对完整安装要求。
  59. 这些说明不改变市场的 npm 一键安装流程,也不代表所有 GitHub 或子目录皮肤都已完成官方 Desktop 实机验收。
  60. </details>
  61. <a id="install-troubleshooting"></a>
  62. <a id="configuration-override"></a>
  63. ## 常见问题与故障处理
  64. 先按市场弹窗或横幅中的具体原因处理。不要因为“已安装”就重复安装,也不要因为某次启用失败就直接卸载整个 profile。
  65. | 情况 | 先做什么 |
  66. | --- | --- |
  67. | 网络或下载超时 | 重试一次;持续失败时复制市场诊断日志,检查 DSH 实际使用的网络和安装源 |
  68. | 已安装但没有生效 | 进入皮肤详情点击「使用」,检查是否显示「待重启」或「未生效」及其原因 |
  69. | 启用/停用被其他配置覆盖 | 按弹窗指出的组件处理;不要反复重装。市场能安全定位覆盖时,会给出明确的修复入口 |
  70. | 安装被新包保护阻止 | 只允许报错中明确指出的那个精确版本,或等待保护期结束;不要关闭全局保护 |
  71. | 操作结果正在确认 | 等待市场核对宿主结果,不要再次点击安装、启用或卸载 |
  72. | 安装/更新/卸载被另一个已安装插件的失效仓库挡住 | 按失败弹窗里默认折叠的三步处理:手动去掉该依赖、退出 DSH 后执行修复命令,或把提示词交给当前 DSH 以外的 Agent。不要在市场里卸载那个失效插件 |
  73. | 页面因皮肤冲突无法操作 | 停止对应的 DSH Web 进程后,使用下面的 Web 重置命令 |
  74. | 点击更新后市场从插件列表消失 | 旧版的 Desktop 自更新会先卸载市场再补装,补装可能没有执行。到「插件 → 添加插件」重新安装 `dsh-skin-market@latest` 并启用 |
  75. ### 更新后市场从插件列表消失
  76. <details>
  77. <summary>展开查看原因和处理步骤</summary>
  78. 旧版市场在官方 Desktop 点击「更新」时会先卸载自己,再执行补装;卸载已经把市场从正在运行的组合里摘掉,补装那一步不会执行,profile 里就只剩一个没有市场的状态。
  79. 1. 不要再点市场里的「更新」,那会重复同一步。
  80. 2. 打开 DSH 的「插件 → 添加插件」,输入 `dsh-skin-market@latest`,安装并按提示启用。
  81. 3. 应用内安装被拒绝时,完全退出 DSH(关窗口不算),在 profile 目录(通常是 `~/.dsh/profiles/desktop`,Windows 为 `%USERPROFILE%\.dsh\profiles\desktop`)执行 `pnpm add dsh-skin-market@latest`,确认 `package.json` 的 `dependencies` 和 `dsh.profile.bundles` 都包含 `dsh-skin-market`,再重新打开。
  82. 修复后的版本改用 DSH 发布的宿主 pnpm 就地覆盖,不再卸载市场;更新完成后仍需重启 DSH 才会加载新代码。
  83. </details>
  84. <a id="release-wait"></a>
  85. ### 安装被新包保护阻止
  86. 市场会尽量合并当前 profile 中重复的精确版本例外。仍被阻止时,只有在确认包名和版本来自本次报错后,才允许这一版本继续;也可以等待 pnpm 的保护期结束。市场不会为整个包或所有未来版本关闭保护。
  87. <details>
  88. <summary><strong>需要 Agent 帮忙处理新包保护错误?</strong></summary>
  89. ```text
  90. 请处理这次 DSH Desktop 的新包保护错误。先确认 Desktop 实际使用的 profile 名称和目录,并从本次 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION 诊断中确认被阻止的精确包名和版本;不要把正在安装的皮肤直接当成被阻止的包。
  91. 仅处理这个 profile 的 pnpm-workspace.yaml 中 minimumReleaseAgeExclude 字段。先合并同名规则中已经允许的版本,保留其他规则、注释和全局年龄策略。如果报错中的精确版本确实没有例外,先向我展示包名、版本和来源,由我确认后才添加这个精确版本。不要设置 minimumReleaseAge=0,不要允许整个包的未来版本,不要读取 .env、凭据或其他存放秘密的配置。混合配置可能含秘密时,先取得指定字段的限定读取授权。
  92. 如果你正运行在这个 DSH 中,不要修改自己的活动组合配置、重启或安装当前宿主;先准备可重复执行的 apply 与 rollback 方案,交给外部终端或独立 Agent 执行。Desktop 包操作由我在官方页面重试。最后核对实际安装版本和组件状态,报告具体结果。
  93. ```
  94. </details>
  95. <a id="profile-dependency-repair"></a>
  96. ### 安装被已安装插件的失效来源阻塞
  97. <details>
  98. <summary>展开查看原因、诊断命令和修复步骤</summary>
  99. 报错形如 `ERR_PNPM_FETCH_404`,URL 指向 `codeload.github.com/...`,而该仓库属于你**之前安装过**的插件,并不是这次要装的皮肤。pnpm 每次安装都会重新解析 profile 里全部 Git 依赖;只要其中一个上游仓库或 commit 被删除,安装、更新、卸载和更新皮肤市场本身都会失败。
  100. 失败弹窗里有同样的三步,默认折叠。市场不能在运行中的 DSH 里替你修改依赖,需要先**完全退出 DSH**(不是只关页面),再从外部终端执行下面的命令。修复命令随市场包发布,通过 `npx` 取用最新版,不需要先更新当前 profile 里的市场,也不会对运行中的 DSH 执行 `pnpm add`。
  101. ```bash
  102. # 只读诊断:列出失效来源、锁文件漂移和计划移除的包
  103. npx -y -p dsh-skin-market@latest dsh-skin-market-repair --profile web
  104. # 完全退出 DSH 后执行修复;用 --keep <包名> 可保留某个失效插件
  105. npx -y -p dsh-skin-market@latest dsh-skin-market-repair --profile web --apply --yes --i-have-stopped-dsh
  106. # 需要时回滚
  107. npx -y -p dsh-skin-market@latest dsh-skin-market-repair --profile web --rollback ~/.dsh/profiles/web/.dsh-skin-market/backups/repair-<时间戳> --yes --i-have-stopped-dsh
  108. ```
  109. 修复会先把 `package.json` 和 `pnpm-lock.yaml` 备份到 profile 内,只移除诊断确认 404 的依赖,然后用该 profile 同一代际的 pnpm 执行一次 `install --no-frozen-lockfile`;完成后校验剩余依赖、锁文件一致性和皮肤市场版本。过程中可能需要网络(pnpm 会重新拉取其余 Git 依赖),不要关闭完整性校验,也不要删除整个锁文件。如果目录维护者已经把同名皮肤改到新仓库或 npm 源,并给出完整固定目标,可以用 `--migrate 包名=完整目标` 保留皮肤而不是删除(例如 `--migrate dsh-dream-skin=dsh-dream-skin@11.7.0`)。迁移目标必须由维护者确认;没有确认目标的失效依赖仍按默认方式移除。修复后启动 DSH,核对页面版本和保存的启用/停用选择,再重试原安装。诊断和修复都需要 `pnpm` 可用;如果 PATH 中没有 pnpm,用 `--pnpm <可执行文件>` 指向该 profile 使用的同一版本。
  110. </details>
  111. <details>
  112. <summary><strong>需要 Agent 帮忙修复 profile 依赖?</strong></summary>
  113. ```text
  114. 这次 DSH 皮肤安装/更新失败在 pnpm 依赖解析阶段:报错指向 codeload.github.com 上某个我已安装插件的上游仓库 404,而不是我要装的皮肤。请先只读诊断,不要重试安装或卸载。
  115. 1. 确认当前 DSH 的 home、profile 和 profile 目录,不要假设默认路径;确认这个 DSH 正在使用该 profile。
  116. 2. 只读核对 profile 的 package.json、pnpm-lock.yaml 和 node_modules,找出:哪些已安装依赖的上游仓库/commit 已不可达、package.json 与锁文件有哪些不一致、哪些包实际已物化。不要读取 .env、凭据或可能含秘密的配置。
  117. 3. 先给我看诊断结果、计划移除的精确包名、备份目录和修复命令;我确认后,由我在外部终端或由独立 Agent 在完全退出 DSH 后执行修复。你如果正运行在这个 DSH 中,不要修改自己的活动 profile、安装或卸载当前 DSH、停止或重启自己。
  118. 4. 修复前保留备份;只移除确认不可达的依赖,不关闭完整性校验、不放宽 allowBuild、不删除整个锁文件、不改其他皮肤。
  119. 5. 修复后核对实际安装版本、锁定文件一致性与启用/停用选择;未读到运行状态时请我提供官方页面结果,并注明尚未验证。最后核对失败原因是否已消除,再按原操作重试。
  120. ```
  121. </details>
  122. ### Web 页面异常时重置皮肤
  123. 如果皮肤冲突导致 DSH Web 页面无法操作,先停止当前 DSH Web 进程,再执行:
  124. ```bash
  125. ~/.dsh/profiles/web/node_modules/.bin/dsh-skin-market-reset --profile web
  126. ```
  127. 这个命令会关闭皮肤市场管理的皮肤并恢复默认外观,但保留已安装的皮肤包和皮肤市场。随后重新启动 DSH Web。官方 Desktop 不要执行这个 Web profile 命令,请在应用插件管理器或市场中停用冲突皮肤。
  128. ## 给皮肤作者
  129. 维护 DSH 皮肤时,把下面的提示词交给 Agent,准备收录或更新自己的条目。市场不会代替你登录 GitHub,也不会静默创建 PR。
  130. <details>
  131. <summary><strong>点击展开收录皮肤提示词</strong></summary>
  132. 复制以下整段提示词给你的 Agent:
  133. ```text
  134. 请帮我向 DSH 皮肤市场(DSH Skin Market)投稿一款 DSH 皮肤。
  135. 皮肤仓库:<你的皮肤仓库地址>
  136. 目标目录仓库:https://github.com/kingOfSoySauce/dsh-skin-market
  137. 目录路径:registry/skins
  138. 请按以下步骤完成:
  139. 1. 只用只读方式确认皮肤仓库是公开的 GitHub 仓库(或 monorepo 子目录),且确实是可安装的 DSH 皮肤(Web 与官方 Desktop 共用 Web 客户端)。不要读取 .env、凭据或聊天记录。
  140. 2. 确认 CI 能从该仓库读到这些材料;缺了就先告诉我,不要编造:
  141. - package.json 有 name、version、license,以及 dsh.client
  142. - cordis.patch.yml 有与 package 名对应的 loader 行
  143. - 描述在薄条目 description 或 package.json description
  144. - 预览图是仓库内的 png、jpg、webp 或 gif,来自 screenshots.json 相对路径、README 仓库图片,或薄条目 screenshots(https 图片地址)
  145. - 建议 README 声明 DSH Web 与官方 Desktop 的版本范围,并包含一条 dsh plugin add 安装命令;建议仓库加上 dsh-plugin Topic
  146. 3. fork 或 clone 目标目录仓库并新建分支。在 registry/skins 下只新增一个 YAML,文件名用 owner__repo.yml(子包用 owner__repo--path.yml)。不要覆盖已有条目,不要修改 data/catalog.json 或 data/catalog-copy.json。
  147. 4. YAML 必须写成薄条目,只允许以下字段,一个都不能多:
  148. - url(必填):公开 GitHub 仓库地址;monorepo 子包再用 subpath 或仓库 tree 路径指定子目录
  149. - 可选字段:name.zh、name.en、author、description、category、tags、modes、screenshots
  150. 除 url 外都可以省略,缺省时由 CI 推导:name 用仓库名,author 用 GitHub owner,description 用 package.json description,category 默认 skin,tags 默认 appearance,modes 默认 light 和 dark,screenshots 从仓库预览图读取。为了收录质量,请尽量填写你能确认的可选字段,尤其要同时写 name.zh 和 name.en,并补上作者、描述、类别、标签、适用模式和预览图。
  151. 可选值约束:category 只能是 skin、pet、player 或 splash;tags 是非空字符串数组;modes 只能是 light、dark 的非空子集;screenshots 写 https 图片地址,或把图片放进仓库的 screenshots.json / README。package、rowId、install、license、compatibility、commit 仍由 CI 从仓库读取,不要手写。内容示例:
  152. url: https://github.com/<owner>/<repo>
  153. # subpath: packages/my-skin # 仅 monorepo 子包需要
  154. # name: # 可选;如果写,必须同时有 zh 和 en
  155. # zh: 中文名
  156. # en: English name
  157. # author: owner # 可选;未填写时使用 GitHub owner
  158. # description: 一句用户能看到的外观或行为说明 # 可选;未填写则使用 package.json description
  159. # category: skin # 可选;skin、pet、player 或 splash
  160. # tags: # 可选;非空字符串数组
  161. # - appearance
  162. # modes: # 可选;light、dark 的非空子集
  163. # - light
  164. # - dark
  165. # screenshots: # 可选;https 图片地址,更推荐放进仓库 screenshots.json 或 README
  166. # - https://.../screenshots/home.png
  167. 5. 不要写完整 schema,不要编造 commit SHA、rowId 或许可证。若 npm run registry:check 报缺少 id/install,先删掉薄条目以外的字段再跑,不要靠补全 schema 过 CI。
  168. 6. 在目标目录仓库根目录运行 npm run registry:check。不得安装到我的真实 DSH profile。
  169. 7. git diff --name-only 应只有 registry/skins/<条目文件>.yml。提交并向 https://github.com/kingOfSoySauce/dsh-skin-market 创建 PR,标题 feat(registry): add <皮肤名>。
  170. 8. 返回 PR 链接;没有 GitHub 权限时只准备好分支和可复制的 PR 内容。
  171. 收录不等于安全认证。不要声称该皮肤已被 DSH 官方、安全团队或市场背书。
  172. ```
  173. </details>
  174. <details>
  175. <summary><strong>点击展开更新展示字段提示词</strong></summary>
  176. 要更新已收录条目时,复制这段。把要改的字段和内容填进提示词。
  177. ```text
  178. 请帮我更新 DSH 皮肤市场里已收录条目的展示字段、兼容范围或前台展示文案。
  179. 皮肤仓库:<你的皮肤仓库地址>
  180. 目标目录仓库:https://github.com/kingOfSoySauce/dsh-skin-market
  181. 目录路径:registry/skins
  182. 要改的内容:<name.zh / name.en / author / description / category / tags / modes / screenshots / listScreenshot / marketScreenshots / compatibility.dsh / data/catalog-copy.json 中的哪几项,以及新内容>
  183. 请按以下步骤完成:
  184. 1. 只用只读方式确认这个仓库已经在 registry/skins 里有条目,并且仓库 remote 与条目的 repo 一致。找不到就停下来问我,不要新建条目。不要读取 .env、凭据或聊天记录。
  185. 2. 只修改这一条已有 YAML;如果还要更新前台展示文案,在同一个 PR 里修改它自己的 data/catalog-copy.json。社区 PR 只能改自己的条目,不要改别人的条目、data/catalog.json 或其他文件。
  186. 3. YAML 只允许改这些字段:name.zh、name.en、author、description、category、tags、modes、screenshots、listScreenshot、marketScreenshots、compatibility.dsh。
  187. - name 必须同时保留 zh 和 en;category 只能是 skin、pet、player 或 splash;tags 是非空字符串数组;modes 只能包含 light、dark 且不能为空。
  188. - screenshots 数组顺序就是前台展示顺序。用可直接访问的 png、jpg、webp 或 gif 图片(仓库内图片或 https 地址),不要用 SVG、data URI 或临时图床;换新预览图直接更新地址即可,不需要和安装版本的 commit 对齐。
  189. - listScreenshot 是封面,必须引用该条目 screenshots 或 marketScreenshots 里已经有的图片地址。
  190. - marketScreenshots 只能重排已有展示图,集合不能变。
  191. - compatibility.dsh 必须是合法 semver 区间,不能改回 unverified;要改它时,在 PR 正文附上该条目固定 commit 的 README、package.json 的 engines.dsh 或兼容性文档链接作为证据,不要编造兼容范围。
  192. 4. 如果要改前台中英双语展示文案,在同一个 PR 里修改 data/catalog-copy.json 中自己条目的 name、description、descriptionPolicy:descriptionPolicy 只能是 show 或 omit;show 必须提供 zh 和 en 两段 description,omit 不能保留 description。已有 source、override、nameSource 元数据必须原样保留;没有展示文案的条目可以新增这三类键。如果条目已经有展示文案,只改 YAML 的 description 不会改变市场卡片,必须同时更新这里的 description。不要改别的条目,也不要新增 source、override、nameSource。
  193. 5. 不要改 id、repo、subpath、package、rowId、install、license、review、health、featuredRank、star 计数或任何时间字段;固定版本刷新不由这次 PR 改写,需要更新固定版本时只在 PR 正文说明,不要编造 install.target 或 rowId。
  194. 6. 在目标目录仓库根目录运行 npm run registry:check。不得安装到我的真实 DSH profile。
  195. 7. git diff --name-only 应只有这一条 YAML;如果改了展示文案,再包含 data/catalog-copy.json。提交并创建 PR,标题 feat(registry): update <皮肤名>。
  196. 8. 返回 PR 链接;没有 GitHub 权限时只准备好分支和可复制的 PR 内容。
  197. 说明:合并 PR 即审核。CI 会校验 PR 自己的 diff 只有一个条目 YAML(可加自己的 data/catalog-copy.json)、机器字段未变、兼容范围合法、封面引用已有截图、marketScreenshots 只是重排、catalog-copy 只改自己的条目且 source/override/nameSource 不变。CI 不能证明 GitHub 账号就是条目作者,靠单人单条目边界和人工审核控制范围。不要声称字段已经在线上目录生效;合并后由仓库的目录同步写入 catalog。收录不等于安全认证,也不要声称该皮肤已被 DSH 官方、安全团队或市场背书。
  198. ```
  199. </details>
  200. 新收录只写薄条目,字段和优先级见下表。`url` 必填;名称、作者、描述、类别、标签、适用模式、预览图和子目录都是可选字段,能确认就尽量填写,缺省由 CI 推导。package、loader id、commit、许可证和兼容范围由 CI 从皮肤仓库读取,不要写进 YAML。新条目只新增一个 `registry/skins/<owner>__<repo>.yml`,不要改 `data/catalog.json`,也不要在新条目的 PR 里改 `data/catalog-copy.json`。
  201. <!-- submission-contract:START -->
  202. | 类别 | 字段 / 项 | 规则 |
  203. | --- | --- | --- |
  204. | 作者写(薄条目) | `url`、`subpath`、`name`、`author`、`description`、`category`、`tags`、`modes`、`screenshots` | 只写这些;`name` 写了就必须同时有 `zh` 和 `en`。除 `url` 外都可省略,缺省时由 CI 推导:`name`=仓库名(子包取子目录名)、`author`=GitHub owner、`description`=`package.json` 的 description、`category`=`skin`、`tags`=`appearance`、`modes`=`light` 和 `dark`、`screenshots`=仓库 `screenshots.json` 或 README 图片。 |
  205. | CI 自动补 | `package`、`rowId`、`install`、`license`、`compatibility` | 不要手写;写了会被 schema 拒绝。 |
  206. | 软必填(不阻断,进补全队列) | 可用预览图(上游或实机)、双语展示名 / 描述、动效 GIF(motion)、启动 launchGif(splash) | 缺了仍可合并,但会记录在每日完整性报告;补全队列接入后自动进队。 |
  207. | 推荐(只提示) | 实机截图 `marketScreenshots`、封面 `listScreenshot`、WebP `media`、README 安装命令 / 版本范围(Web 与官方 Desktop)/ `dsh-plugin` topic、Desktop 安装支持(npm 包或手动安装说明) | 不阻断合并。 |
  208. | 已收录条目更新(作者可改) | `name`、`author`、`description`、`category`、`tags`、`modes`、`screenshots`、`listScreenshot`、`marketScreenshots`、`compatibility.dsh`、`data/catalog-copy.json` | 合并社区 PR 即审核:只能改自己条目的展示字段、兼容范围和前台中英双语展示文案;改兼容范围要在 PR 正文附固定 commit 的证据,不要动别人的条目,也不要编造 commit 或 rowId。 |
  209. 字段说明:
  210. - `name`:`zh` 和 `en` 必须同时非空。
  211. - `author`:作者署名。
  212. - `description`:写用户能看到的外观或行为。
  213. - `category`:只能是 `skin`、`pet`、`player` 或 `splash`。
  214. - `tags`:非空字符串数组。
  215. - `modes`:`light`、`dark` 的非空子集。
  216. - `screenshots`:数组顺序即前台展示顺序;截图不需要和安装的固定 commit 对齐,可以随时刷新(pin 只作证据快照)。
  217. - `listScreenshot`:封面,必须引用该条目 `screenshots` 或 `marketScreenshots` 里已有的地址。
  218. - `marketScreenshots`:只允许重排已有展示图,集合不能变。
  219. - `compatibility.dsh`:合法 semver 区间,不能改回 `unverified`;PR 正文附固定 commit 的 README、`package.json` `engines.dsh` 或兼容性文档链接作为证据。
  220. - `data/catalog-copy.json`:只改自己条目的 `name`、`description`、`descriptionPolicy`(`show` 或 `omit`);已有 `source`/`override`/`nameSource` 保持原样;没有展示文案的条目可新增,只写这三类键。
  221. <!-- submission-contract:END -->
  222. 皮肤仓库需要能被 CI 读到:公开 GitHub 仓库或 monorepo 子目录;`package.json` 有 name、version、license 和 `dsh.client`;`cordis.patch.yml` 有对应 loader。预览图用仓库内的 png、jpg、webp 或 gif。建议 README 声明 DSH Web 与官方 Desktop 的版本范围和一条 `dsh plugin add` 安装命令,并为仓库加上 `dsh-plugin` Topic。
  223. 已收录条目合并社区 PR 即审核:作者可以在同一个 PR 里更新自己条目的展示字段、兼容范围和前台中英双语展示文案,可改字段见上表「已收录条目更新」一行和下面的字段说明。具体限制:`screenshots` 数组顺序就是前台展示顺序;`listScreenshot` 封面必须引用该条目 `screenshots` 或 `marketScreenshots` 里已有的图片地址;`marketScreenshots` 只允许重排、集合不能变;`compatibility.dsh` 必须是合法 semver 区间、不能改回 `unverified`,PR 正文要附固定 commit 的 README、`package.json` 的 `engines.dsh` 或兼容性文档链接作为证据。
  224. 如果要改前台展示文案,同一个 PR 里可以改自己条目的 `data/catalog-copy.json`:只写 `name`、`description`、`descriptionPolicy`(`show` 或 `omit`)三类键;`show` 必须同时有中英文描述,`omit` 不能保留描述;已有 `source`、`override`、`nameSource` 必须保持原样;没有展示文案的条目可以新增这三类键。如果条目已经有展示文案,市场卡片显示的是 `data/catalog-copy.json` 里的那一份;只改 YAML 的 `description` 只会在没有展示文案时作为兜底,前台不会变化。
  225. 不要改 id、repo、subpath、package、rowId、install、license、review、health、featuredRank、star 数量和任何时间戳,不要改 `data/catalog.json`,不要改别人的条目,也不要编造 commit、rowId 或兼容性证据。CI 按 PR 自己的 diff 校验:只能有一个 `registry/skins/*.yml`,可选一个自己条目的 `data/catalog-copy.json`。固定版本刷新不由这次 PR 改写;需要时在 PR 正文写明上游 commit,维护者会在发行跟进流程中处理。收录不等于安全认证。
  226. 本地验收步骤见 [TESTING.md](./docs/TESTING.md)。
  227. ## License
  228. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.