mirror of
https://github.com/zhu1090093659/dsh-web.git
synced 2026-09-28 06:13:45 +08:00
docs(repo): reposition as aggregate plugin ecosystem, unify skins naming
Skins are one plugin in the family, not a peer pillar: the root README pair demotes the skins chapter to a subsection of feature plugins, the tagline and intro describe an aggregate plugin ecosystem distributed through the Workshop, and the display name is simply skins (皮肤) — Skin Center survives only in frozen technical identifiers (npm package, directory, bundle id, wallpapers path). GitHub About and homepage match; AGENTS.md and docs/development.md state the same hierarchy. Decision record: .agents/notes/implemented/architecture/2026-08-24-plugin-aggregate-positioning.md
This commit is contained in:
zhu1090093659
+5
@@ -0,0 +1,5 @@
|
||||
# Bilingual-pair consistency record (docs/i18n.md): the git blob hash of each
|
||||
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
||||
# after editing either side, bring the other along and re-record with git hash-object.
|
||||
2026-08-24-plugin-aggregate-positioning.md: 18556b93f390d3c36fed46f4e0a77d2e1a4b2779
|
||||
2026-08-24-plugin-aggregate-positioning.zh.md: bba4c87c794a7787741634bb019fab78bf3a471a
|
||||
@@ -0,0 +1,30 @@
|
||||
# Agent Note: Aggregate-plugin positioning and the skins naming
|
||||
|
||||
Status: implemented
|
||||
|
||||
## Problem
|
||||
|
||||
The repository presented skins as a product pillar peer to plugins: the tagline said "plugin and skin ecosystem", the root README gave skins a top-level chapter beside feature plugins, and the loader surfaced as "Skin Center". The actual product is an aggregate plugin package — every capability, including skins, is one Cordis plugin — and the Workshop (dsh-market.com) is the distribution direction. The peer framing mis-states the hierarchy, and "Skin Center" names a surface after its container rather than its content.
|
||||
|
||||
## Decision
|
||||
|
||||
The product is positioned as the aggregate plugin ecosystem for DSH Web, and the skin surface is named simply "skins" (皮肤):
|
||||
|
||||
- Root README pair: the skins chapter demotes from a peer chapter to the last subsection of feature plugins; tagline, intro, capability table, package table, and troubleshooting prose now describe skins as pure asset packs of the skins plugin, distributed through the Workshop. The Chinese surface name is 皮肤 and the English one is skins — "皮肤中心 / Skin Center" no longer appears as a display name in the root README pair.
|
||||
- GitHub About description and homepage (dsh-market.com) match this positioning; AGENTS.md and docs/development.md opening lines state the same hierarchy.
|
||||
- Identifiers stay frozen: the npm package @linxin666/dsh-client-ui-skin-center, the packages/skins/skin-center directory, the web-ui-skin-center bundle id, and the skin-center/wallpapers path keep their technical names; only display prose changed.
|
||||
- The Workshop storefront keeps its skins / pets / plugins merchandise taxonomy — those are goods categories in a store, not product pillars.
|
||||
- Cross-link: [product rename](2026-08-24-product-rename-dsh-web.md) covers the dsh-web-ui to dsh-web naming this positioning rides on.
|
||||
|
||||
## Alternatives considered
|
||||
|
||||
- Keep the peer "plugins and skins" framing: rejected by product decision; it contradicts the aggregate-package reality and the Workshop direction.
|
||||
- Rename the technical identifiers too (skin-center package, directory, bundle id): rejected for the same reason as the product rename freeze — published npm names and profile-persisted ids cannot move without breaking installs.
|
||||
- Rename the GUI settings section display string in the same change: deferred; it is user-visible runtime copy inside the skin-center package's locales and needs its own rebuild-and-verify pass, so it is tracked as a follow-up scope question rather than folded into a documentation edit.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Readers meet one hierarchy everywhere in current docs: the aggregate package contains plugins; the skins plugin owns skin assets; the Workshop distributes all of it.
|
||||
- The name "skin-center" persists in technical identifiers; docs prose must not present "Skin Center" as a product surface name anymore.
|
||||
- Verification: pnpm docs:check passes (bilingual structure mirror intact after the heading demotion); GitHub About verified via gh repo view.
|
||||
- Follow-up: applying the 皮肤/skins naming to the GUI settings section title and market storefront copy requires a skin-center locale change plus market rebuild and redeploy, and is pending explicit scope confirmation.
|
||||
@@ -0,0 +1,30 @@
|
||||
# Agent Note: 插件聚合定位与皮肤命名
|
||||
|
||||
Status: implemented
|
||||
|
||||
## Problem
|
||||
|
||||
仓库此前把皮肤呈现为与插件平级的产品支柱：标语写「插件与皮肤生态」，根 README 给皮肤开了与功能插件平级的一章，加载器以「皮肤中心」为名。实际产品是一个插件聚合包——包括皮肤在内的每项能力都是一个 Cordis 插件——而创意工坊（dsh-market.com）是分发方向。平级表述误述了层级，「皮肤中心」也是以容器而非内容命名。
|
||||
|
||||
## Decision
|
||||
|
||||
产品定位为 DSH Web 的插件聚合生态包，皮肤表面统一命名为「皮肤」（skins）：
|
||||
|
||||
- 根 README 双语对：皮肤章从平级章节降为功能插件章的末节；标语、导言、能力表、包表与故障排查文案均改为「皮肤是皮肤插件的纯资产包，经创意工坊分发」。中文显示名为「皮肤」，英文为 skins——「皮肤中心 / Skin Center」不再作为显示名出现在根 README 对中。
|
||||
- GitHub About 描述与主页（dsh-market.com）与该定位一致；AGENTS.md 与 docs/development.md 开篇陈述同一层级。
|
||||
- 标识符保持冻结：npm 包 @linxin666/dsh-client-ui-skin-center、packages/skins/skin-center 目录、web-ui-skin-center bundle id 与 skin-center/wallpapers 路径保留技术名；只改展示文案。
|
||||
- 创意工坊店面保留 皮肤 / 宠物 / 插件 的商品分类——那是商店的货品类目，不是产品支柱。
|
||||
- 交叉链接：[产品更名](2026-08-24-product-rename-dsh-web.md) 记录了本定位所依托的 dsh-web-ui 到 dsh-web 更名。
|
||||
|
||||
## Alternatives considered
|
||||
|
||||
- 保留「插件与皮肤」平级框架：被产品决策否决；它与插件聚合包的现实和创意工坊方向矛盾。
|
||||
- 连技术标识符一起改（skin-center 包名、目录、bundle id）：与产品更名的冻结理由相同——已发布 npm 名与持久化 id 移动即破坏存量安装。
|
||||
- 同改动内把 GUI 设置分区的显示名也改掉：暂缓；那是皮肤包 locales 里的用户可见运行时文案，需要独立的重建与验证，作为跟进范围问题记录，不混入文档改动。
|
||||
|
||||
## Consequences
|
||||
|
||||
- 当前文档只呈现一种层级：聚合包装插件；皮肤插件拥有皮肤资产；创意工坊统一分发。
|
||||
- 「skin-center」仅存于技术标识符；文档文案不得再把「Skin Center / 皮肤中心」当作产品表面名。
|
||||
- 验证：pnpm docs:check 通过（标题降级后双语结构镜像完好）；GitHub About 经 gh repo view 核实。
|
||||
- 跟进：把 皮肤/skins 命名落到 GUI 设置分区标题与市场店面文案，需要改皮肤包 locale、重建并重新部署 market，等待明确的范围确认。
|
||||
@@ -1,6 +1,6 @@
|
||||
# dsh-web Repository Instructions
|
||||
|
||||
This repository is a monorepo of DeepSeek Harness Web GUI plugins and skins. Each plugin is an independent Cordis bundle mounted through `cordis.patch.yml` and profiles. Never modify a DSH source checkout.
|
||||
This repository is a monorepo of DeepSeek Harness Web GUI plugins; skins ship as pure asset packs of the skins plugin, distributed through the Workshop. Each plugin is an independent Cordis bundle mounted through `cordis.patch.yml` and profiles. Never modify a DSH source checkout.
|
||||
|
||||
Before changing `packages/`, read [packages/AGENTS.md](packages/AGENTS.md). Before editing documentation, read [docs/AGENTS.md](docs/AGENTS.md).
|
||||
|
||||
|
||||
+21
-21
@@ -21,8 +21,8 @@
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<strong>The plugin and skin ecosystem for the DeepSeek Harness (DSH) Web GUI · Everything is a plugin</strong><br>
|
||||
<em>Liang Shen Mode · Task Board · Mobile Remote · SSH Ops · Image Understanding · Whale-Girl Pet · Skin Center · Workshop</em>
|
||||
<strong>The aggregate plugin ecosystem for DeepSeek Harness (DSH) Web · Everything is a plugin</strong><br>
|
||||
<em>Liang Shen Mode · Task Board · Mobile Remote · SSH Ops · Image Understanding · Whale-Girl Pet · Skins · Workshop</em>
|
||||
</p>
|
||||
|
||||
<div align="center">
|
||||
@@ -33,9 +33,9 @@
|
||||
|
||||
## What It Is
|
||||
|
||||
dsh-web is the plugin and skin ecosystem for the DeepSeek Harness (DSH) Web GUI — the most complete realization of "everything is development, everything is a plugin" on the web: Liang Shen Mode, the task board, mobile remote, SSH ops, image understanding, the right panel, the whale-girl pet and the skin center each ship as an independent, self-contained plugin — pluggable, swappable, re-developable. Install the whole family to assemble a complete dev workbench, or pick one or two and they melt quietly into the stock UI. Everything mounts into `dsh web` through the official profile mechanism, no DSH source changes; the aggregate can even bolt on external plugins like `dsh-better-sidebar` — see the [dsh-web-all README](packages/dsh-web-all/README.md).
|
||||
dsh-web is the aggregate plugin ecosystem for DeepSeek Harness (DSH) Web — the most complete realization of "everything is development, everything is a plugin" on the web: Liang Shen Mode, the task board, mobile remote, SSH ops, image understanding, the right panel, the whale-girl pet and skins each ship as an independent, self-contained plugin — pluggable, swappable, re-developable. Install the whole family to assemble a complete dev workbench, or pick one or two and they melt quietly into the stock UI. Everything mounts into `dsh web` through the official profile mechanism, no DSH source changes; the aggregate can even bolt on external plugins like `dsh-better-sidebar` — see the [dsh-web-all README](packages/dsh-web-all/README.md).
|
||||
|
||||
Skins follow the same philosophy: a v2 skin is no longer an npm package coupled to the official core, but a pure asset directory (a skin.json manifest plus styles, art and optional effect scripts) loaded on demand by the skin center, the single loader — official upgrades no longer touch any skin, and adding one means dropping in a directory: no publish, no install. Plugins own the logic, skins own the look; skins, pets and plugins are all distributed through the [Workshop](#workshop-dsh-marketcom) (dsh-market.com).
|
||||
Skins live inside the same plugin system: a v2 skin is not a standalone product but a pure asset pack of the skins plugin (a skin.json manifest plus styles, art and optional effect scripts), loaded on demand by that plugin, the single loader — official upgrades no longer touch any skin, and adding one means dropping in a directory: no publish, no install. Plugins own the logic, skin assets own the look; plugins and skin or pet assets are all distributed through the [Workshop](#workshop-dsh-marketcom) (dsh-market.com).
|
||||
|
||||
|
||||
|
||||
@@ -49,11 +49,11 @@ Skins follow the same philosophy: a v2 skin is no longer an npm package coupled
|
||||
| File preview & changes | None | Right panel: explorer / editor / terminal / git / browser |
|
||||
| Companion pet | None | Whale girl: reacts to agent state, feeding and bonding |
|
||||
| Git visualization | None | Branch picker + commit history graph |
|
||||
| Themes & skins | Default theme | Skin center with 19 skins + a custom-theme editor, try-on before apply |
|
||||
| Themes & skins | Default theme | Skins plugin with 19 skins + a custom-theme editor, try-on before apply |
|
||||
|
||||
## Workshop (dsh-market.com)
|
||||
|
||||
The [Workshop](https://dsh-market.com) (dsh-market.com) is DSH's one-stop home for creations: skins, pets and plugins in one place, each category ranked by device-backed likes with the top three on the landing-page podium; skins preview in a live try-on, plugins expose one-copy install commands. The Workshop settings card inside the Web GUI browses the catalog directly — skins and pets install into the DSH home directories in one click, plugins go through the plugin manager, and everything shows up in the skin center and pet panel afterwards.
|
||||
The [Workshop](https://dsh-market.com) (dsh-market.com) is DSH's one-stop home for creations: skins, pets and plugins in one place, each category ranked by device-backed likes with the top three on the landing-page podium; skins preview in a live try-on, plugins expose one-copy install commands. The Workshop settings card inside the Web GUI browses the catalog directly — skins and pets install into the DSH home directories in one click, plugins go through the plugin manager, and everything shows up in the skins and pet panels afterwards.
|
||||
|
||||
|
||||
|
||||
@@ -138,47 +138,47 @@ The mechanics, stabilization controls and limits live in [dsh-liangshen README](
|
||||
- **Rescue mode** (`dsh-doctor`): transactionally repairs a broken DSH profile — supervised launcher, isolated recovery capsule and a local web recovery console; off by default, enable it in settings.
|
||||
- **Archive manager** (external plugin [@mlgbnb/dsh-archive-manager](https://github.com/z953218350/dsh-archive-manager), bundled in the aggregate): group sessions by project, search and filter, preview conversations, restore or delete in one click.
|
||||
|
||||
## Skins
|
||||
### Skins
|
||||
|
||||
The skin center is the single skin loader: 19 theme skins try on before apply — previews apply instantly and revert fully on exit, apply with one click once happy; the list ends with a custom-theme editor previewing accent, background, foreground and contrast live. Blue Fantasy ships with the skin center; every other skin downloads on demand from the [Workshop](#workshop-dsh-marketcom).
|
||||
The skins plugin is the single loader for every skin: 19 theme skins try on before apply — previews apply instantly and revert fully on exit, apply with one click once happy; the list ends with a custom-theme editor previewing accent, background, foreground and contrast live. Blue Fantasy ships with the skins plugin; every other skin downloads on demand from the [Workshop](#workshop-dsh-marketcom).
|
||||
|
||||
|
||||
|
||||
|
||||
All theme skins at a glance:
|
||||
|
||||
|
||||
|
||||
### Wallpaper Engine Wallpapers
|
||||
#### Wallpaper Engine Wallpapers
|
||||
|
||||
The skin center can use your local Wallpaper Engine library as the GUI backdrop: video, web and scene wallpapers all render live — scene wallpapers are driven by a built-in WebGL player — and any type can be pinned to a zero-animation "static frame" image. Import a single wallpaper into `skin-center/wallpapers/` to keep it working outside the Steam library, with update detection against the workshop original; without a Wallpaper Engine install (e.g. macOS), manual folders can add any `.mp4`/`.webm` folder or wallpaper project folder as the library. Wallpapers are your own local files and are never uploaded or redistributed.
|
||||
The skins plugin can use your local Wallpaper Engine library as the GUI backdrop: video, web and scene wallpapers all render live — scene wallpapers are driven by a built-in WebGL player — and any type can be pinned to a zero-animation "static frame" image. Import a single wallpaper into `skin-center/wallpapers/` to keep it working outside the Steam library, with update detection against the workshop original; without a Wallpaper Engine install (e.g. macOS), manual folders can add any `.mp4`/`.webm` folder or wallpaper project folder as the library. Wallpapers are your own local files and are never uploaded or redistributed.
|
||||
|
||||
|
||||
|
||||
### Windows XP (Luna)
|
||||
#### Windows XP (Luna)
|
||||
|
||||
A faithful recreation of the classic Luna interface: blue gradient window chrome, a green Start button, the Bliss blue-sky desktop, and square corners throughout.
|
||||
|
||||
|
||||
|
||||
### Blue Fantasy
|
||||
#### Blue Fantasy
|
||||
|
||||
Whale artwork sits beneath translucent panes in a periwinkle-indigo palette. It reads best in dark mode. Ships with the skin center, ready out of the box.
|
||||
Whale artwork sits beneath translucent panes in a periwinkle-indigo palette. It reads best in dark mode. Ships with the skins plugin, ready out of the box.
|
||||
|
||||
|
||||
|
||||
### Whale Song
|
||||
#### Whale Song
|
||||
|
||||
The deep-sea whale-goddess theme: a text-free ambience painting sits beneath translucent panes in an ice-blue palette, with a night-cruise dark variant.
|
||||
|
||||
 · 
|
||||
|
||||
### Harbor
|
||||
#### Harbor
|
||||
|
||||
A dusk-harbor theme: a twilight-blue sky melting into sunset orange sits beneath translucent panes, wrapped in a deep-navy base with amber-orange accents.
|
||||
|
||||
 · 
|
||||
|
||||
### Maid Atelier
|
||||
#### Maid Atelier
|
||||
|
||||
An ornate navy workshop skin with two character layers and responsive sidebar decoration. This skin is licensed separately under CC BY-NC-SA 4.0 and is restricted to non-commercial use.
|
||||
|
||||
@@ -195,7 +195,7 @@ An ornate navy workshop skin with two character layers and responsive sidebar de
|
||||
|
||||
1. Install the aggregate package: `dsh plugin --profile web add @linxin666/dsh-web-all@latest`
|
||||
2. Restart `dsh web`, every plugin entry appears in the sidebar
|
||||
3. Open "Settings > Plugin config" to toggle plugins, or try on skins in the skin center
|
||||
3. Open "Settings > Plugin config" to toggle plugins, or try on skins in the skins panel
|
||||
|
||||
> Skins only? Install `@linxin666/dsh-client-ui-skin-center`. If you ended up with an old version (pnpm 11's release-age gate), see "Install Troubleshooting" below.
|
||||
|
||||
@@ -253,7 +253,7 @@ Every plugin is published on npm under the `@linxin666/dsh-*` scope and can be v
|
||||
|
||||
| npm package | What it is |
|
||||
| --- | --- |
|
||||
| [@linxin666/dsh-web-all](https://www.npmjs.com/package/@linxin666/dsh-web-all) | All-in-one aggregate: every feature plugin plus the skin set in one install |
|
||||
| [@linxin666/dsh-web-all](https://www.npmjs.com/package/@linxin666/dsh-web-all) | All-in-one aggregate: every feature plugin in one install, including the skins plugin and its skin assets |
|
||||
| [@linxin666/dsh-liangshen](https://www.npmjs.com/package/@linxin666/dsh-liangshen) | Liang Shen Mode: two-phase anchoring agent preset for V4 Pro |
|
||||
| [@linxin666/dsh-client-ui-task-board](https://www.npmjs.com/package/@linxin666/dsh-client-ui-task-board) | Task board: real session execution plus cron scheduling |
|
||||
| [@linxin666/dsh-remote-web-ui](https://www.npmjs.com/package/@linxin666/dsh-remote-web-ui) | Scan-to-pair remote control of the Web GUI from mobile or PC |
|
||||
@@ -261,7 +261,7 @@ Every plugin is published on npm under the `@linxin666/dsh-*` scope and can be v
|
||||
| [@linxin666/dsh-tool-describe-image](https://www.npmjs.com/package/@linxin666/dsh-tool-describe-image) | `describe_image` vision tool |
|
||||
| [@linxin666/dsh-pet](https://www.npmjs.com/package/@linxin666/dsh-pet) | Registry-driven floating pet companion |
|
||||
| [@linxin666/dsh-client-ui-git-graph](https://www.npmjs.com/package/@linxin666/dsh-client-ui-git-graph) | Git branch selector and commit history graph |
|
||||
| [@linxin666/dsh-client-ui-skin-center](https://www.npmjs.com/package/@linxin666/dsh-client-ui-skin-center) | Skin center: the single skin loader, with skins installed on demand from the Workshop |
|
||||
| [@linxin666/dsh-client-ui-skin-center](https://www.npmjs.com/package/@linxin666/dsh-client-ui-skin-center) | Skins: the single loader for every skin, with skin assets installed on demand from the Workshop |
|
||||
| [@linxin666/dsh-client-ui-market](https://www.npmjs.com/package/@linxin666/dsh-client-ui-market) | Workshop card: browse skins / pets / plugins from dsh-market.com and install with one click |
|
||||
| [@linxin666/dsh-client-ui-plugin-manager](https://www.npmjs.com/package/@linxin666/dsh-client-ui-plugin-manager) | Plugin manager: install from npm or git, enable, disable and configure |
|
||||
| [@linxin666/dsh-client-ui-skill-explorer](https://www.npmjs.com/package/@linxin666/dsh-client-ui-skill-explorer) | Skill center: browse, toggle and manage skills |
|
||||
@@ -293,7 +293,7 @@ Technical details live in [docs/plugins.md](docs/plugins.md).
|
||||
|
||||
> First install may stop on `ERR_PNPM_IGNORED_BUILDS` (pnpm blocks dependency build scripts): copy the printed keys (`cloudflared` / `cpu-features` / `ssh2`) into the profile's `pnpm-workspace.yaml` `allowBuilds` list and re-run.
|
||||
|
||||
> **pnpm 11 release-age gate**: within 24 hours of a new release (the built-in `minimumReleaseAge` default), pnpm 11 can silently resolve to older `@linxin666/*` versions (e.g. `dsh-web-all@0.1.20` with the old skin center); an explicit `@latest` is gated the same way. The old skin center writes references to standalone skin packages when a skin is applied, which crashes `dsh web` at boot (`ERR_MODULE_NOT_FOUND ... dsh-client-ui-skin-*`). Exclude every `@linxin666/*` package in the profile's `pnpm-workspace.yaml` before installing or updating:
|
||||
> **pnpm 11 release-age gate**: within 24 hours of a new release (the built-in `minimumReleaseAge` default), pnpm 11 can silently resolve to older `@linxin666/*` versions (e.g. `dsh-web-all@0.1.20` with the old skins plugin); an explicit `@latest` is gated the same way. The old skins plugin writes references to standalone skin packages when a skin is applied, which crashes `dsh web` at boot (`ERR_MODULE_NOT_FOUND ... dsh-client-ui-skin-*`). Exclude every `@linxin666/*` package in the profile's `pnpm-workspace.yaml` before installing or updating:
|
||||
>
|
||||
> ```yaml
|
||||
> minimumReleaseAgeExclude:
|
||||
|
||||
@@ -21,8 +21,8 @@
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<strong>DeepSeek Harness（DSH）Web GUI 的插件与皮肤生态 · 一切皆插件</strong><br>
|
||||
<em>梁神模式 · 任务看板 · 移动端远程 · SSH 运维 · 图像理解 · 鲸鱼娘宠物 · 皮肤中心 · 创意工坊</em>
|
||||
<strong>DeepSeek Harness（DSH）Web 的插件聚合生态包 · 一切皆插件</strong><br>
|
||||
<em>梁神模式 · 任务看板 · 移动端远程 · SSH 运维 · 图像理解 · 鲸鱼娘宠物 · 皮肤 · 创意工坊</em>
|
||||
</p>
|
||||
|
||||
<div align="center">
|
||||
@@ -33,9 +33,9 @@
|
||||
|
||||
## 是什么
|
||||
|
||||
dsh-web 是 DeepSeek Harness（DSH）Web GUI 的插件与皮肤生态，也是「一切皆开发、一切皆插件」理念在 Web 端最完整的落地：梁神模式、任务看板、移动端远程、SSH 运维、图像理解、右侧面板、鲸鱼娘宠物与皮肤中心，每一样都是独立成包的插件，可插拔、可替换、可再开发——一次装齐便是完整的开发工作台，只挑一两个也能安静融入原生界面。所有插件都经官方 profile 机制挂载到 `dsh web`，不改 DSH 源码；聚合包还能把外部插件（如 `dsh-better-sidebar`）拼进全家桶，详见 [dsh-web-all README](packages/dsh-web-all/README.zh.md)。
|
||||
dsh-web 是 DeepSeek Harness（DSH）Web 的插件聚合生态包，也是「一切皆开发、一切皆插件」理念在 Web 端最完整的落地：梁神模式、任务看板、移动端远程、SSH 运维、图像理解、右侧面板、鲸鱼娘宠物与皮肤，每一样都是独立成包的插件，可插拔、可替换、可再开发——一次装齐便是完整的开发工作台，只挑一两个也能安静融入原生界面。所有插件都经官方 profile 机制挂载到 `dsh web`，不改 DSH 源码；聚合包还能把外部插件（如 `dsh-better-sidebar`）拼进全家桶，详见 [dsh-web-all README](packages/dsh-web-all/README.zh.md)。
|
||||
|
||||
皮肤贯彻同一理念：v2 皮肤不再是耦合官方的 npm 包，而是一份纯资产目录（skin.json 清单 + 样式、贴图与可选特效脚本），由皮肤中心这一唯一加载器即时加载，与官方彻底解耦——官方升级不再牵动皮肤，新增皮肤也只需落一个目录，无需发布、无需安装。插件负责逻辑，皮肤负责外观；皮肤、宠物与插件的分发统一走 [创意工坊](#创意工坊dsh-marketcom)（dsh-market.com）。
|
||||
皮肤同样长在插件体系里：v2 皮肤不是独立产品，而是「皮肤」插件的纯资产包（skin.json 清单 + 样式、贴图与可选特效脚本），由该插件这一唯一加载器即时加载，与官方彻底解耦——官方升级不再牵动皮肤，新增皮肤也只需落一个目录，无需发布、无需安装。插件负责逻辑，皮肤资产负责外观；插件与皮肤、宠物资产的分发统一走 [创意工坊](#创意工坊dsh-marketcom)（dsh-market.com）。
|
||||
|
||||
|
||||
|
||||
@@ -49,11 +49,11 @@ dsh-web 是 DeepSeek Harness（DSH）Web GUI 的插件与皮肤生态，也是
|
||||
| 文件预览与变更 | 无 | 右侧面板：资源管理器 / 编辑器 / 终端 / Git / 浏览器 |
|
||||
| 陪伴宠物 | 无 | 鲸鱼娘：跟随智能体状态互动、喂养养成 |
|
||||
| Git 可视化 | 无 | 分支选择器 + 提交历史图谱 |
|
||||
| 主题皮肤 | 默认主题 | 皮肤中心 19 款主题皮肤 + 自定义主题编辑器，先试穿再应用 |
|
||||
| 主题皮肤 | 默认主题 | 皮肤插件 19 款主题皮肤 + 自定义主题编辑器，先试穿再应用 |
|
||||
|
||||
## 创意工坊（dsh-market.com）
|
||||
|
||||
[创意工坊](https://dsh-market.com)（dsh-market.com）是 DSH 的一站式创作空间：皮肤、宠物、插件三位一体，每类按设备点赞热度排序、前三名登上首页颁奖台；皮肤支持实时试穿预览，插件提供一键复制的安装命令。Web GUI 里的「创意工坊」设置卡直接浏览工坊清单——皮肤与宠物一键装进 DSH 主目录，插件经插件管理器安装，装完即可在皮肤中心与宠物面板中使用。
|
||||
[创意工坊](https://dsh-market.com)（dsh-market.com）是 DSH 的一站式创作空间：皮肤、宠物、插件三位一体，每类按设备点赞热度排序、前三名登上首页颁奖台；皮肤支持实时试穿预览，插件提供一键复制的安装命令。Web GUI 里的「创意工坊」设置卡直接浏览工坊清单——皮肤与宠物一键装进 DSH 主目录，插件经插件管理器安装，装完即可在皮肤与宠物面板中使用。
|
||||
|
||||
|
||||
|
||||
@@ -138,47 +138,47 @@ DeepSeek V4 Pro 对首轮工具目录很敏感。社区评测里，官方 Standa
|
||||
- **救助模式**（`dsh-doctor`）：事务式修复损坏的 DSH profile——受监管启动器、隔离恢复舱与本地 Web 恢复控制台；默认关闭，在设置中启用。
|
||||
- **归档管理**（外部插件 [@mlgbnb/dsh-archive-manager](https://github.com/z953218350/dsh-archive-manager)，聚合包内置）：按项目分组、搜索筛选、预览对话、一键恢复与删除。
|
||||
|
||||
## 皮肤
|
||||
### 皮肤
|
||||
|
||||
皮肤中心是皮肤的唯一加载器：19 款主题皮肤先试穿再应用——试穿即时生效、退出完全还原，满意再一键应用；列表末尾还有自定义主题编辑器，强调色、背景、前景与对比度即时预览。除 Blue Fantasy 随包自带外，其余皮肤按需从 [创意工坊](#创意工坊dsh-marketcom) 下载安装。
|
||||
「皮肤」插件是全部皮肤的唯一加载器：19 款主题皮肤先试穿再应用——试穿即时生效、退出完全还原，满意再一键应用；列表末尾还有自定义主题编辑器，强调色、背景、前景与对比度即时预览。除 Blue Fantasy 随包自带外，其余皮肤按需从 [创意工坊](#创意工坊dsh-marketcom) 下载安装。
|
||||
|
||||
|
||||
|
||||
|
||||
主题皮肤一览：
|
||||
|
||||
|
||||
|
||||
### Wallpaper Engine 壁纸
|
||||
#### Wallpaper Engine 壁纸
|
||||
|
||||
皮肤中心可直接把本机 Wallpaper Engine 壁纸库用作 GUI 背景：视频、网页与场景壁纸均动态渲染——场景壁纸由内置 WebGL 播放器驱动；任意类型也可切到「静态帧」模式，钉成零动画开销的图片。单张壁纸可导入 `skin-center/wallpapers/`，脱离 Steam 库也能用，并检测创意工坊原作更新；没有 Wallpaper Engine（如 macOS）时，手动目录可把任意 `.mp4`/`.webm` 视频文件夹或壁纸项目文件夹加为壁纸库。壁纸都是本机文件，从不上传或再分发。
|
||||
皮肤插件可直接把本机 Wallpaper Engine 壁纸库用作 GUI 背景：视频、网页与场景壁纸均动态渲染——场景壁纸由内置 WebGL 播放器驱动；任意类型也可切到「静态帧」模式，钉成零动画开销的图片。单张壁纸可导入 `skin-center/wallpapers/`，脱离 Steam 库也能用，并检测创意工坊原作更新；没有 Wallpaper Engine（如 macOS）时，手动目录可把任意 `.mp4`/`.webm` 视频文件夹或壁纸项目文件夹加为壁纸库。壁纸都是本机文件，从不上传或再分发。
|
||||
|
||||
|
||||
|
||||
### Windows XP（Luna）
|
||||
#### Windows XP（Luna）
|
||||
|
||||
还原 Luna 经典界面：蓝色渐变窗口条、绿色「开始」按钮、Bliss 蓝天桌面，全局直角风格。
|
||||
|
||||
|
||||
|
||||
### Blue Fantasy 蓝色幻想
|
||||
#### Blue Fantasy 蓝色幻想
|
||||
|
||||
鲸鱼插画垫在半透明面板下面，靛蓝色调贯穿全局，暗色主题下更明显。随皮肤中心自带，开箱即用。
|
||||
鲸鱼插画垫在半透明面板下面，靛蓝色调贯穿全局，暗色主题下更明显。随皮肤插件自带，开箱即用。
|
||||
|
||||
|
||||
|
||||
### 鲸吟（Whale Song）
|
||||
#### 鲸吟（Whale Song）
|
||||
|
||||
深海鲸语女神主题：纯氛围背景画垫在半透明面板下，冰蓝冷色系贯穿全局，暗色变体是深海夜航调。
|
||||
|
||||
 · 
|
||||
|
||||
### 夕港（Harbor）
|
||||
#### 夕港（Harbor）
|
||||
|
||||
黄昏港口主题：暮光蓝天空渐入日落橙的港口背景垫在半透明面板下，深暮蓝底与日落橙主色贯穿全局。
|
||||
|
||||
 · 
|
||||
|
||||
### 深海女仆工坊（Maid Atelier）
|
||||
#### 深海女仆工坊（Maid Atelier）
|
||||
|
||||
深海蓝工坊主题，包含双角色图层与响应式侧边栏装饰。本皮肤单独采用 CC BY-NC-SA 4.0，仅限非商业使用。
|
||||
|
||||
@@ -195,7 +195,7 @@ DeepSeek V4 Pro 对首轮工具目录很敏感。社区评测里，官方 Standa
|
||||
|
||||
1. 安装聚合包：`dsh plugin --profile web add @linxin666/dsh-web-all@latest`
|
||||
2. 重启 `dsh web`，侧边栏出现全部插件入口
|
||||
3. 打开「设置 > 插件配置」按需开关插件，或在皮肤中心试穿皮肤
|
||||
3. 打开「设置 > 插件配置」按需开关插件，或在皮肤面板试穿皮肤
|
||||
|
||||
> 只要皮肤就装 `@linxin666/dsh-client-ui-skin-center`。若装到了旧版本（pnpm 11 的发布年龄门禁），见下方「安装排障」。
|
||||
|
||||
@@ -252,7 +252,7 @@ dsh plugin --profile web add @linxin666/dsh-client-ui-aionui-panel@latest # 旧
|
||||
|
||||
| npm 包 | 说明 |
|
||||
| --- | --- |
|
||||
| [@linxin666/dsh-web-all](https://www.npmjs.com/package/@linxin666/dsh-web-all) | 全家桶聚合包：一个包装齐全部功能插件与皮肤 |
|
||||
| [@linxin666/dsh-web-all](https://www.npmjs.com/package/@linxin666/dsh-web-all) | 全家桶聚合包：一个包装齐全部功能插件（含皮肤插件及其皮肤资产） |
|
||||
| [@linxin666/dsh-liangshen](https://www.npmjs.com/package/@linxin666/dsh-liangshen) | 梁神模式：面向 V4 Pro 的两阶段锚定预设 |
|
||||
| [@linxin666/dsh-client-ui-task-board](https://www.npmjs.com/package/@linxin666/dsh-client-ui-task-board) | 任务看板：真实会话执行 + cron 定时 |
|
||||
| [@linxin666/dsh-remote-web-ui](https://www.npmjs.com/package/@linxin666/dsh-remote-web-ui) | 扫码配对，移动端 / PC 远程使用 Web GUI |
|
||||
@@ -260,7 +260,7 @@ dsh plugin --profile web add @linxin666/dsh-client-ui-aionui-panel@latest # 旧
|
||||
| [@linxin666/dsh-tool-describe-image](https://www.npmjs.com/package/@linxin666/dsh-tool-describe-image) | `describe_image` 视觉工具 |
|
||||
| [@linxin666/dsh-pet](https://www.npmjs.com/package/@linxin666/dsh-pet) | 注册表驱动的悬浮宠物 |
|
||||
| [@linxin666/dsh-client-ui-git-graph](https://www.npmjs.com/package/@linxin666/dsh-client-ui-git-graph) | Git 分支选择器与提交历史图谱 |
|
||||
| [@linxin666/dsh-client-ui-skin-center](https://www.npmjs.com/package/@linxin666/dsh-client-ui-skin-center) | 皮肤中心：皮肤的唯一加载器，皮肤按需从创意工坊安装 |
|
||||
| [@linxin666/dsh-client-ui-skin-center](https://www.npmjs.com/package/@linxin666/dsh-client-ui-skin-center) | 皮肤：全部皮肤的唯一加载器，皮肤资产按需从创意工坊安装 |
|
||||
| [@linxin666/dsh-client-ui-market](https://www.npmjs.com/package/@linxin666/dsh-client-ui-market) | 创意工坊商店卡：浏览 dsh-market.com 的皮肤 / 宠物 / 插件并一键安装 |
|
||||
| [@linxin666/dsh-client-ui-plugin-manager](https://www.npmjs.com/package/@linxin666/dsh-client-ui-plugin-manager) | 插件管理器：从 npm / git 安装、启停与配置 |
|
||||
| [@linxin666/dsh-client-ui-skill-explorer](https://www.npmjs.com/package/@linxin666/dsh-client-ui-skill-explorer) | Skill 中心：浏览 / 启停 / 管理 |
|
||||
@@ -292,7 +292,7 @@ dsh plugin --profile web add @linxin666/dsh-client-ui-aionui-panel@latest # 旧
|
||||
|
||||
> 首次安装若提示 `ERR_PNPM_IGNORED_BUILDS`（pnpm 拒绝依赖的构建脚本），按提示把 `cloudflared` / `cpu-features` / `ssh2` 加入 profile 的 `pnpm-workspace.yaml` `allowBuilds` 后重新执行即可。
|
||||
|
||||
> **pnpm 11 发布年龄门禁**：新版本发布后 24 小时内（`minimumReleaseAge` 内置默认值），pnpm 11 会静默装回更旧的 `@linxin666/*` 版本（如 `dsh-web-all@0.1.20` 配旧版皮肤中心），显式写 `@latest` 同样被隔离。旧版皮肤中心 Apply 皮肤时会写入独立皮肤包引用，导致 `dsh web` 启动崩溃（`ERR_MODULE_NOT_FOUND ... dsh-client-ui-skin-*`）。在 profile 的 `pnpm-workspace.yaml` 中排除全部 `@linxin666/*` 包后再安装或更新：
|
||||
> **pnpm 11 发布年龄门禁**：新版本发布后 24 小时内（`minimumReleaseAge` 内置默认值），pnpm 11 会静默装回更旧的 `@linxin666/*` 版本（如 `dsh-web-all@0.1.20` 配旧版皮肤插件），显式写 `@latest` 同样被隔离。旧版皮肤插件 Apply 皮肤时会写入独立皮肤包引用，导致 `dsh web` 启动崩溃（`ERR_MODULE_NOT_FOUND ... dsh-client-ui-skin-*`）。在 profile 的 `pnpm-workspace.yaml` 中排除全部 `@linxin666/*` 包后再安装或更新：
|
||||
>
|
||||
> ```yaml
|
||||
> minimumReleaseAgeExclude:
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# 开发流程（development）
|
||||
|
||||
dsh-web 是 DeepSeek Harness Web GUI 的插件与皮肤 monorepo。本文定义
|
||||
dsh-web 是 DeepSeek Harness Web 的插件 monorepo（皮肤以「皮肤」插件的资产包形式存在）。本文定义
|
||||
贡献者日常流程；仓库规则见根 [AGENTS.md](../AGENTS.md)，包级规则见
|
||||
[packages/AGENTS.md](../packages/AGENTS.md)，文档标准见 [AGENTS.md](AGENTS.md)。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user