本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-skin-market

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-skin-market

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 2026-08-19：CAPTAIN1275/dsh-ui-web（0.2.7）——7 款皮肤一次收录：极光 Aurora、蓝色幻想、龙之继承者、初音未来、Minecraft、鲸吟、Windows XP
• 更多请查看收录日志
• 必须是公开、可安装的 DSH Web 皮肤仓库或 monorepo 子包
• 安装来源必须固定到完整 40 位 commit SHA
• 必须提供明确的 package、row ID、许可证和兼容范围

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装 dsh-skin-market 之前需要做哪些准备？

建议先关闭其他皮肤类插件以避免冲突，DSH 使用 pnpm 管理 profile 依赖，需确认 pnpm 在 PATH 中。本地开发需要 Node.js 22 或更高版本。

皮肤市场安装、更新、卸载一个皮肤会失败吗？

不会修改你的真实 profile。每一步操作前会先快照 package.json、cordis.patch.yml、pnpm-workspace.yaml 和 pnpm-lock.yaml，出错时会原子恢复并清理半安装状态；遇到 pnpm allowBuilds 审批时只把必要的 key 写入对应字段。

列表里的皮肤是怎么获取的，需要每次手动更新插件吗？

不需要。市场从 GitHub Pages 拉取远程目录 JSON，每 5 分钟或窗口重新获得焦点时静默校验一次。校验通过后会写入 profile 的 IndexedDB 缓存；离线或超时会回退到缓存，再回退到插件内置目录。

安装来源为什么不固定到某个分支，而要绑定完整 commit？

目录中每个皮肤的目标形如 github:/#<40位 commit>，必要时带 &path: 子目录。固定 commit 可避免 main 分支后续提交对已收录版本造成意外覆盖，皮肤详情页也能精确显示来源。

皮肤市场支持哪些操作？使用流程是怎样的？

支持 install / activate / deactivate / pin（常驻开启）/ unpin / update / uninstall 七种生命周期操作。每个皮肤可安装、可使用、可常驻；卸载前若仍在使用会自动停用并恢复默认外观，再删除 package。

皮肤市场会主动创建 GitHub PR 或读取隐私文件吗？

不会。浏览器只能提交目录里的 skinId，无法提交任意命令或安装地址；收录流程只在维护者本地的 fork 中通过 PR 提交，并明确不读取 .env、凭据、聊天记录或工作区外的私密文件。

安装或激活后界面没变化怎么办？

多数皮肤需要在 DSH Web 重启后生效。设置 → 皮肤市场 → 选中皮肤 → 点击「使用」→「重启 DSH」。重启时若仍有 Agent 正在运行，会被等待至空闲后再安全重启。

页面因皮肤冲突无法操作时怎么恢复？

先停止 DSH 进程，执行 ~/.dsh/profiles/web/node_modules/.bin/dsh-skin-market-reset --profile web，会关闭市场管理的所有皮肤并保留包文件；之后重启 DSH 即可。命令使用原子写入，失败会回滚。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6
• Node: >=22.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则