dsh-zed-space 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,216 @@
+# Changelog
+
+本文件记录 Zed Space Skin 及其 Backspace 历史变更。Zed Space Skin 从 1.0.0 开始独立编号；Backspace 的历史版本号和本地候选记录保留原含义。
+
+## Zed Space Skin 1.0.0 — 2026-10-28
+
+- 展示名改为 Zed Space Skin；包、插件和新仓库标识为 `dsh-zed-space`。
+- 保留 Open Sea Skin / Backspace 来源与许可，旧存储键和视频数据库名称保持兼容。
+- Git tag 从 `v1.0.0` 重新开始；npm、Release 与社区市场进度见[发布记录](docs/publishing/releases/1.0.0.md)。视频市场当前仅支持本地服务。
+- 插件列表、皮肤设置入口和面板使用统一的 Zed Space 产品图标，列表展示名为 Zed Space Skin。
+- 根目录 bundle 提供多背景；旧 React 源码集成仍只接海洋。
+
+### 本地视频市场接入
+
+- 发现页无法连接时说明公网平台尚未上线，提供返回本地视频和重试入口。
+- 导入和发现入口并排显示小图标，视频移除增加二次确认。
+- 本地视频与内置皮肤、不同视频之间统一渐变过渡，完成后释放旧画面与媒体资源。
+
+- DSH 插件新增全窗口官方画廊入口，复用市场搜索与详情；返回或 Esc 关闭后恢复入口焦点。
+- 从可信签名目录下载视频，校验字节数、SHA-256 与现有视频兼容性后加入「我的视频」；用户显式应用后返回 DSH。
+- 同一来源复用已有素材并保留重命名；取消会停止尚未入库的下载，已完成的副本可保留，下载不会自动应用。
+- 保持 32 MiB、30 秒、1080p 限制和现有 IndexedDB 隔离；嵌入模式不回退浏览器下载，独立网站保留下载功能。
+- 当前市场、目录与媒体仅接固定本地服务；[接入说明](docs/market-integration.md)记录安装步骤、网络边界及验证范围，原生 Electron 尚未验证。
+
+### 本地视频素材列表
+
+- 新增第四个「本地视频」入口，支持多选导入、缩略图列表、单选启用、重命名及单项移除。
+- 素材和选择仅在本机 IndexedDB 保存，重启恢复；扩展路径按宿主 origin 隔离，不同步视频内容。
+- 检查实际容器、编码、大小、分辨率与时长；错误可见，播放或存储失败时回退海面。
+- 静音循环播放，遵守总开关、页面可见性和减少动态设置；未新增运行时依赖。
+
+### 设置面板
+
+- 更新设置入口、深浅色面板、逐项帮助提示及键盘操作；窄屏内容可滚动。
+- 各皮肤独立保存效果参数、自动光影和通用配置，迁移旧设置并保留原值。
+- 恢复默认仅作用于当前皮肤，先显示标题与确认按钮；切换时同步中间区域高度。
+
+### 日常背景开销
+
+- 宇宙背景在静稳工作状态采用 10 FPS 帧预算，设置预览、视角切换、视差和点击效果的活跃阶段恢复完整帧预算；不缩放流动速度、亮度或任何可调参数，保留原生清晰度。
+- 海面与宇宙切换时保留旧画面，目标首帧就绪后交叠并释放旧 iframe；视频切回内置皮肤也保留画面直到目标准备完成。减少动态效果时缩短交叠，重复入口不接管已有界面。
+- 过滤零强度及重复交互消息，消息流新增内容不再反复触发入口定位；保留锚点迟到、替换和窗口调整的定位行为。
+
+### Backspace 1.3.0-rc.1 本地候选记录
+
+- 将事件视界与吸积涡旋的八项共享参数接入正式插件，切换视角保留参数和同一画布；迁移已有配置并保留旧记录。
+- 优化宇宙渲染调度：静止画面按需绘制，高刷新屏的装饰动画限制为 30 FPS；保留原生 Retina 分辨率和原有着色器视觉。
+- 减少逐帧参数归一化，补充参数迁移、插件生命周期和渲染唤醒回归。
+- 本版本用于本地 Desktop 验证，未发布到 npm。
+
+### Changed
+
+- 事件视界与吸积涡旋合并为一个吸积场景：共享星空、光线积分与辉光，保留紫红侧视和铜金俯视的视觉标定，并以约 2.2 秒连续切换。
+- 本地宇宙预览页提供两种视角和同一组八项参数；切换保留调参，支持中途反向、暂停补帧和减少动态效果。现有旧参数入口保持兼容。
+- 提升宇宙皮肤的 Retina 分辨率、近缘光弧采样和自适应画质恢复；补充浏览器回归检查。
+
+- **New code-level defaults**, matching the shipped skin baseline: sea state
+  **50**, daylight **55** (afternoon), glass opacity **70%**, automatic day
+  cycle on, and the independent conversation background **on at 90%**. Earlier
+  installs keep their saved values; the new defaults apply to fresh installs
+  and to the panel's "Reset to defaults" button, whose note now names them.
+
+### Added
+
+- **Independent conversation background** in the skin settings panel. A
+  switch reveals a slider that sets the center conversation column's own
+  opacity from **40% to 100%**; 100% is indistinguishable from unthemed Harness
+  because the paint is derived from Harness's own
+  `--dsw-static-neutral-bluish-*` palette and only scaled by `color-mix()`.
+  With the switch off the conversation follows the workspace glass, exactly as
+  before, and the sidebars and details columns keep that glass in both modes.
+  On by default at 90%; stored as `bsChatCustom` / `bsChatOpacity` (localStorage) and
+  `skinChatCustom` / `skinChatOpacity` (extension sync storage). The control is
+  wired through all install paths: DSH bundle, static installer and MV3
+  extension.
+
+### Fixed
+
+- Floating Harness surfaces no longer inherit the workspace glass opacity.
+  Harness paints its hover preview cards — including the edited-file diff
+  popover — with `--dsw-alias-bg-layer-1`, and dialogs and floating dock
+  windows with `--dsw-alias-bg-layer-2`. Both are opaque in Harness's own
+  palette, but the skin had overridden them with the glass alpha, so page
+  content showed through the preview card's diff text. They now keep a
+  near-opaque `ELEVATED_ALPHA` (0.97, the same value the settings dialog
+  already used) while `--dsw-alias-bg-base` still follows the glass setting.
+- The community desktop details column no longer composites two nested
+  translucent fills when the independent conversation background is on.
+
+## 1.2.6 — 2026-10-20
+
+### 修复 / Fixed
+
+- 将浮层背景与工作区玻璃值分离：插件广场使用的 overlay token 保持 97% 不透明度。
+- 语义 dialog / alertdialog 与设置弹窗使用独立可读底色，覆盖 body portal 中的二级插件配置弹窗；不改遮罩、层级和海洋效果。感谢 #16 的复现信息。
+- Keep overlay tokens and semantic modal cards legible independently of workspace glass opacity, including sibling-portalled plugin configuration dialogs.
+
+### 验证范围 / Verification scope
+
+- macOS / Windows 页面结构、浅深色、40% / 90% 工作区玻璃组合回归；确认工作区透明度与 shell overlay 不变，停用后样式清除。
+- 核对官方 Harness 0.2.1-rc.2 安装文档及 Modal 结构。不是 Windows 原生安装或该新版完整实机兼容认证。
+- 中文安装指引明确 npm 插件优先、社区市场可选、浏览器扩展不适用于桌面客户端。Logo 未修改。
+
+## 1.2.5 — 2026-10-10
+
+### Fixed
+
+- Official DeepSeek Harness Desktop `0.2.0-rc.2` now paints one glass layer
+  across the sidebar, conversation, and rightbar. The conversation's nested
+  background no longer compounds opacity, while the composer remains readable.
+- Official Desktop Settings stays opaque enough to read when workspace glass
+  is set to its minimum 40%.
+
+### Tested
+
+- Installed the release package into an isolated official macOS Desktop
+  `0.2.0-rc.2` profile with its bundled CLI and visually verified the shell.
+- Added a 0.2.x shell regression fixture for macOS/Windows structure in light
+  and dark modes. Windows is fixture-tested, not native Windows E2E-tested.
+
+### Documentation
+
+- Clarified the Desktop install path and distinguished the GitHub release from
+  the older npm package currently available through registries.
+
+## 1.2.4 — 2026-09-09
+
+### Fixed
+
+- Quick controls follow asynchronous Harness document-language changes in both
+  Chinese and English, including accessibility labels, without losing focus or
+  control state. The observer is removed on disposal. Thanks to @Max-Null for
+  reporting the issue in #6; the fix lives in the shared source and all generated
+  install targets.
+
+### Documentation
+
+- Recommend the prebuilt npm package to avoid Git transport failures during
+  installation; explain why a `git ls-remote` error is not proof of a blocked
+  build script (#8).
+
+## 1.2.3 — 2026-09-07
+
+### Fixed
+
+- DSH Desktop advanced and extended layouts now paint a single shared glass
+  background. The sidebar, conversation and details panes no longer differ
+  in opacity due to transparent sidebar overrides and stacked conversation fills.
+- Composer cards and dialogs retain their own backgrounds. Disabling or
+  unloading Backspace restores the desktop's original styles.
+
+### Tested
+
+- Desktop shell regression based on DSH Desktop Beta `2.0.5-beta.1`: 24
+  combinations of layout, native material, light/dark mode and glass opacity,
+  plus settings, text input, disable/re-enable and disposal in Chromium.
+- The old `1.2.2` bundle fails this regression: at 40% glass the sidebar's
+  effective opacity is 0%, while nested conversation fills reach 64%.
+
+## 1.2.2 — 2026-09-01
+
+### Added
+
+- Quick-controls panel gains an enable toggle, an automatic day-cycle toggle,
+  and a reset-to-defaults button. Disabling the skin now only tears down the
+  ocean surface while keeping the button and panel, so the skin can always be
+  re-enabled from the same page.
+- Public npm publishing metadata and guarded release automation for DSH
+  Desktop managed installation.
+
+### Fixed
+
+- Dragging the daylight slider now unchecks the automatic day-cycle toggle to
+  match the persisted state.
+- Native source integration now supports Harness `0.1.2-alpha.3` and its split
+  client store, renderer, and session services.
+- Browsers without WebGPU can use a capped low-end WebGL2 fallback instead of
+  stopping at an unavailable screen.
+
+## 1.2.1 — 2026-08-18
+
+### Changed
+
+- The Chrome/Edge extension is now Harness-only and no longer replaces the
+  browser new-tab page.
+- Loopback pages must match the DeepSeek Harness title, root element, and
+  server-injected boot marker before the extension changes their DOM.
+- Browser acceptance now proves that real Harness pages are skinned while a
+  generic localhost app and an existing third-party new-tab homepage remain
+  untouched.
+
+## 1.2.0 — 2026-08-17
+
+### Added
+
+- A root `dsh.bundle` package that installs directly into DeepSeek Harness.
+- Lower-left quick controls for wave size, daylight, glass opacity, and the
+  automatic day/night cycle in the one-line DSH installation.
+- A DeepSeek Harness-specific marketplace cover and four 40%-glass gallery
+  animations covering dark mode, light mode, waves, and sunset.
+- Host-route boundary tests for local renderer assets.
+
+### Fixed
+
+- Kept the native Settings dialog above the conversation composer at wide
+  aspect ratios.
+- Restored the lower-left Skin settings launcher and persisted every control.
+
+## 1.1.0 — 2026-08-17
+
+- Added the native Harness source integration, static installer, browser
+  acceptance coverage, and bilingual 40%-glass gallery.
+
+## 1.0.0 — 2026-08-14
+
+- Initial Backspace WebGPU showcase and Chrome/Edge extension.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Open Sea Skin contributors (upstream: d-dev0101/open-sea-skin)
+Copyright (c) 2026 Zed Space Skin contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,97 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/extension/icons/icon128.png" width="80" height="80" alt="Zed Space mark" />
+  <h1>Zed Space Skin</h1>
+  <p>Dynamic backgrounds and interface skins for DeepSeek Harness</p>
+  <p><a href="README.md">简体中文</a> · <strong>English</strong></p>
+</div>
+
+Ocean, two cosmic views, and local videos for your Harness workspace. Each scene keeps its own settings, with smooth transitions between backgrounds.
+
+**1.0.0 · Package name: `dsh-zed-space`.** See the [release record](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/publishing/releases/1.0.0.md) for downloads and marketplace review status.
+
+[Source](https://github.com/hetonghao/dsh-zed-space) · [Installation](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/dsh-plugin.md) · [Issues](https://github.com/hetonghao/dsh-zed-space/issues)
+
+This is an independent community plugin for DeepSeek Harness, not an official DeepSeek product or a skin for the DeepSeek web chat site.
+
+## Current features
+
+| Scene or feature | What it does |
+| --- | --- |
+| Live ocean | Adjust waves and daylight, or enable the automatic day cycle. |
+| Two cosmic views | Switch between horizon and vortex, with separate glow, stars, and motion settings. |
+| Per-scene settings | Keep scene parameters and glass opacity; optionally adjust the conversation background independently. |
+| Local video library | Import multiple files, view thumbnails, enable one video, rename, remove, and restore after reopening. |
+| Smooth transitions | Wait for the next frame before blending; both cosmic views transition within one renderer. |
+
+Each video is limited to **32 MiB, 30 seconds, and 1080p**. See [local video background](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/video-background.md) for formats and storage details. Media stays on the device and is not automatically uploaded or synced through a browser account. **The local acceptance build includes the official video skin gallery.** Open “Discover official animated skins” from “Local video” to browse, preview, and download; applying a downloaded video is a separate action. The gallery service currently runs locally. See [local marketplace integration](docs/market-integration.md).
+
+## Scene gallery
+
+These five screenshots were captured in the real **DeepSeek Harness Web 0.2.1-rc.3** application with `dsh-zed-space@1.0.0` installed in a separate temporary profile. Each image shows the active wallpaper’s settings: glass opacity at its minimum of **40%**, with independent conversation opacity enabled at **60%**. The PNGs are compressed without resizing. See the [capture environment, settings, and media sources](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/screenshots/README.md).
+
+### Black hole · event horizon
+
+![Event horizon running in DeepSeek Harness Web](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-event-horizon.png)
+
+### Black hole · accretion vortex
+
+![Accretion vortex running in DeepSeek Harness Web](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-accretion-vortex.png)
+
+### Ocean · golden hour
+
+![Ocean background running in the light theme of DeepSeek Harness Web](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-ocean.png)
+
+### Local video · sea of clouds
+
+![Sea of clouds video wallpaper playing in DeepSeek Harness Web](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-video-clouds.png)
+
+### Local video · deep dive
+
+![Deep dive video wallpaper playing in DeepSeek Harness Web](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-video-deep-dive.png)
+
+Both videos were imported through the local video library and played in the application. They are demonstration media and are not included with the plugin.
+
+## Installation
+
+In Harness, open Plugins → Add plugin and enter `dsh-zed-space@1.0.0`. For Harness Web:
+
+```sh
+dsh plugin --profile web add dsh-zed-space@1.0.0
+```
+
+Alternatively, download `dsh-zed-space-1.0.0.tgz` from the [GitHub Release](https://github.com/hetonghao/dsh-zed-space/releases/tag/v1.0.0) and install using its local path. Restart the corresponding Harness instance after installation.
+
+When upgrading from Backspace, remove the old plugin from the same profile before adding the new one. Keep your settings and video data. See [installation and migration](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md).
+
+## Build and preview locally
+
+Requires Node.js 20+. From the repository directory:
+
+```sh
+npm ci
+npm run build
+npm run build:site
+npm test
+```
+
+`pages-dist/` contains the static website and can be previewed through a local HTTP server. Pages deployment is manual and does not run with npm or GitHub releases.
+
+See [plugin integration](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/dsh-plugin.md), [source integration](https://github.com/hetonghao/dsh-zed-space/blob/main/harness-plugin/README.md), and [migration notes](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md). Do not delete the entire Harness configuration or session directory.
+
+## Common questions
+
+**Can I install this version from npm or a marketplace?**
+
+Use the exact package version or Release file above. Marketplace listing requires maintainer review; see the [release record](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/publishing/releases/1.0.0.md).
+
+**Is there a shared wallpaper marketplace?**
+
+The local acceptance build connects to the official video skin gallery and shares its catalog with Zed Space. You can browse, download to “My videos,” and apply a video in DSH. It is not publicly released; see [local marketplace integration](docs/market-integration.md) for setup requirements.
+
+**Why is historical Backspace content still present?**
+
+This project evolved from Backspace. Historical changelog entries and media remain for provenance. Git tags in the current repository restart at `v1.0.0`. See [THIRD_PARTY_NOTICES.md](https://github.com/hetonghao/dsh-zed-space/blob/main/THIRD_PARTY_NOTICES.md) and [LICENSE](https://github.com/hetonghao/dsh-zed-space/blob/main/LICENSE) for upstream authorship and licensing.
+
+## Development
+
+[Changelog](https://github.com/hetonghao/dsh-zed-space/blob/main/CHANGELOG.md) · [Contributing](https://github.com/hetonghao/dsh-zed-space/blob/main/CONTRIBUTING.md) · [Privacy](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/privacy.md) · [Security](https://github.com/hetonghao/dsh-zed-space/blob/main/SECURITY.md)

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+<div align="center">
+  <img src="https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/extension/icons/icon128.png" width="80" height="80" alt="Zed Space 标志" />
+  <h1>Zed Space Skin</h1>
+  <p>DeepSeek Harness 动态背景与界面皮肤</p>
+  <p><strong>简体中文</strong> · <a href="README.en.md">English</a></p>
+</div>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+海洋、宇宙双视角和本地视频，让 Harness 随你的工作场景变化。每个场景单独保存参数，切换时平滑衔接。
+
+**1.0.0 · 技术包名 `dsh-zed-space`。** 下载安装入口与市场收录进度见[发布记录](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/publishing/releases/1.0.0.md)。
+
+[源代码](https://github.com/hetonghao/dsh-zed-space) · [安装说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md) · [问题反馈](https://github.com/hetonghao/dsh-zed-space/issues)
+
+本项目是 DeepSeek Harness 的社区插件，不是 DeepSeek 官方产品，也不适用于 DeepSeek 网页聊天站点。
+
+## 当前功能
+
+| 场景或功能 | 可以做什么 |
+| --- | --- |
+| 实时海洋 | 调节波浪、日光，或启用自动昼夜变化。 |
+| 宇宙双视角 | 在地平线和漩涡视角间切换，分别调整光晕、星点与运动参数。 |
+| 每场景参数 | 各场景保存自己的参数和玻璃浓度；可单独调整对话面板背景。 |
+| 本地视频库 | 多选导入、缩略图列表、勾选启用一个、重命名和移除，重新打开后恢复。 |
+| 平滑切换 | 新画面就绪后交叠过渡；宇宙双视角在同一个渲染器内切换。 |
+
+单个视频上限为 **32 MiB、30 秒、1080p**，支持范围及存储说明见[本地视频背景](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/video-background.md)。素材保存在本机，不会自动上传或随浏览器账号同步。**本地验收版已接入官方视频皮肤画廊**：在「本地视频」中点击「发现官方精美动态皮肤」，即可搜索、预览和下载；校验入库后再显式应用。市场服务目前仅在本机运行，详见[本地市场接入](docs/market-integration.md)。
+
+## 场景展示
+
+以下五张截图来自 **DeepSeek Harness Web 0.2.1-rc.3** 的真实运行界面，安装的是 `dsh-zed-space@1.0.0`。截图使用独立临时 profile，展示当前壁纸的配置面板：玻璃不透明度为最低值 **40%**，开启对话面板独立调整并设为 **60%**。图片已压缩；[截图环境、参数与素材来源](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/screenshots/README.md)均有记录。
+
+### 黑洞 · 事件视界
+
+![事件视界在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-event-horizon.png)
+
+### 黑洞 · 吸积涡旋
+
+![吸积涡旋在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-accretion-vortex.png)
+
+### 海面 · 金色时刻
+
+![浅色界面下海面背景在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-ocean.png)
+
+### 本地视频 · 云海日出
+
+![云海日出视频壁纸在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-video-clouds.png)
+
+### 本地视频 · 深蓝潜行
+
+![深蓝潜行视频壁纸在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-video-deep-dive.png)
+
+两段视频通过「本地视频」导入并实际播放，仅作效果展示，不随插件分发。
+
+## 安装
+
+在 Harness 的「插件 → 添加插件」中输入 `dsh-zed-space@1.0.0`。Harness Web 可运行：
+
+```sh
+dsh plugin --profile web add dsh-zed-space@1.0.0
+```
+
+也可从 [GitHub Release](https://github.com/hetonghao/dsh-zed-space/releases/tag/v1.0.0) 下载 `dsh-zed-space-1.0.0.tgz`，将本地文件路径填入安装命令。安装后重启对应的 Harness 实例。
+
+从 Backspace 升级时，先在同一 profile 卸载旧插件，再安装新包；保留原有配置与视频数据。详见[安装与迁移](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md)。
+
+## 本地构建与预览
+
+需要 Node.js 20+。在仓库目录运行：
+
+```sh
+npm ci
+npm run build
+npm run build:site
+npm test
+```
+
+`pages-dist/` 是官网静态产物，可通过本地 HTTP 服务预览。Pages 工作流只保留手动触发，不随 npm 或 GitHub Release 自动发布。
+
+开发者接入方式见[插件构建说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/dsh-plugin.md)和[源码集成](https://github.com/hetonghao/dsh-zed-space/blob/main/harness-plugin/README.md)。旧版迁移注意事项见[安装说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md)，不要删除整个 Harness 配置或会话目录。
+
+## 常见问题
+
+**现在能从 npm 或市场安装新版吗？**
+
+可按上方精确版本或 Release 文件安装。社区市场需要维护者审核，收录状态见[发布记录](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/publishing/releases/1.0.0.md)。
+
+**有共享壁纸市场吗？**
+
+已接通本地官方视频皮肤画廊，与 Zed Space 网站复用目录。支持在 DSH 内浏览、下载到「我的视频」并应用；尚未公开发布，启动条件见[本地市场接入](docs/market-integration.md)。
+
+**历史 Backspace 内容为什么还在？**
+
+本项目从 Backspace 演进而来。历史变更记录和旧媒体保留溯源用途。当前仓库的 Git tag 从 `v1.0.0` 重新开始。上游作者和许可记录见 [THIRD_PARTY_NOTICES.md](https://github.com/hetonghao/dsh-zed-space/blob/main/THIRD_PARTY_NOTICES.md) 与 [LICENSE](https://github.com/hetonghao/dsh-zed-space/blob/main/LICENSE)。
+
+## 开发资料
+
+[变更记录](https://github.com/hetonghao/dsh-zed-space/blob/main/CHANGELOG.md) · [贡献指南](https://github.com/hetonghao/dsh-zed-space/blob/main/CONTRIBUTING.md) · [隐私说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/privacy.md) · [安全政策](https://github.com/hetonghao/dsh-zed-space/blob/main/SECURITY.md)

package/README.zh.md

@@ -0,0 +1,97 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/extension/icons/icon128.png" width="80" height="80" alt="Zed Space 标志" />
+  <h1>Zed Space Skin</h1>
+  <p>DeepSeek Harness 动态背景与界面皮肤</p>
+  <p><strong>简体中文</strong> · <a href="README.en.md">English</a></p>
+</div>
+
+海洋、宇宙双视角和本地视频，让 Harness 随你的工作场景变化。每个场景单独保存参数，切换时平滑衔接。
+
+**1.0.0 · 技术包名 `dsh-zed-space`。** 下载安装入口与市场收录进度见[发布记录](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/publishing/releases/1.0.0.md)。
+
+[源代码](https://github.com/hetonghao/dsh-zed-space) · [安装说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md) · [问题反馈](https://github.com/hetonghao/dsh-zed-space/issues)
+
+本项目是 DeepSeek Harness 的社区插件，不是 DeepSeek 官方产品，也不适用于 DeepSeek 网页聊天站点。
+
+## 当前功能
+
+| 场景或功能 | 可以做什么 |
+| --- | --- |
+| 实时海洋 | 调节波浪、日光，或启用自动昼夜变化。 |
+| 宇宙双视角 | 在地平线和漩涡视角间切换，分别调整光晕、星点与运动参数。 |
+| 每场景参数 | 各场景保存自己的参数和玻璃浓度；可单独调整对话面板背景。 |
+| 本地视频库 | 多选导入、缩略图列表、勾选启用一个、重命名和移除，重新打开后恢复。 |
+| 平滑切换 | 新画面就绪后交叠过渡；宇宙双视角在同一个渲染器内切换。 |
+
+单个视频上限为 **32 MiB、30 秒、1080p**，支持范围及存储说明见[本地视频背景](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/video-background.md)。素材保存在本机，不会自动上传或随浏览器账号同步。**本地验收版已接入官方视频皮肤画廊**：在「本地视频」中点击「发现官方精美动态皮肤」，即可搜索、预览和下载；校验入库后再显式应用。市场服务目前仅在本机运行，详见[本地市场接入](docs/market-integration.md)。
+
+## 场景展示
+
+以下五张截图来自 **DeepSeek Harness Web 0.2.1-rc.3** 的真实运行界面，安装的是 `dsh-zed-space@1.0.0`。截图使用独立临时 profile，展示当前壁纸的配置面板：玻璃不透明度为最低值 **40%**，开启对话面板独立调整并设为 **60%**。图片已压缩；[截图环境、参数与素材来源](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/screenshots/README.md)均有记录。
+
+### 黑洞 · 事件视界
+
+![事件视界在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-event-horizon.png)
+
+### 黑洞 · 吸积涡旋
+
+![吸积涡旋在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-accretion-vortex.png)
+
+### 海面 · 金色时刻
+
+![浅色界面下海面背景在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-ocean.png)
+
+### 本地视频 · 云海日出
+
+![云海日出视频壁纸在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-video-clouds.png)
+
+### 本地视频 · 深蓝潜行
+
+![深蓝潜行视频壁纸在 DeepSeek Harness Web 中的真实运行截图](https://raw.githubusercontent.com/hetonghao/dsh-zed-space/main/docs/screenshots/harness-video-deep-dive.png)
+
+两段视频通过「本地视频」导入并实际播放，仅作效果展示，不随插件分发。
+
+## 安装
+
+在 Harness 的「插件 → 添加插件」中输入 `dsh-zed-space@1.0.0`。Harness Web 可运行：
+
+```sh
+dsh plugin --profile web add dsh-zed-space@1.0.0
+```
+
+也可从 [GitHub Release](https://github.com/hetonghao/dsh-zed-space/releases/tag/v1.0.0) 下载 `dsh-zed-space-1.0.0.tgz`，将本地文件路径填入安装命令。安装后重启对应的 Harness 实例。
+
+从 Backspace 升级时，先在同一 profile 卸载旧插件，再安装新包；保留原有配置与视频数据。详见[安装与迁移](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md)。
+
+## 本地构建与预览
+
+需要 Node.js 20+。在仓库目录运行：
+
+```sh
+npm ci
+npm run build
+npm run build:site
+npm test
+```
+
+`pages-dist/` 是官网静态产物，可通过本地 HTTP 服务预览。Pages 工作流只保留手动触发，不随 npm 或 GitHub Release 自动发布。
+
+开发者接入方式见[插件构建说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/dsh-plugin.md)和[源码集成](https://github.com/hetonghao/dsh-zed-space/blob/main/harness-plugin/README.md)。旧版迁移注意事项见[安装说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/install.zh.md)，不要删除整个 Harness 配置或会话目录。
+
+## 常见问题
+
+**现在能从 npm 或市场安装新版吗？**
+
+可按上方精确版本或 Release 文件安装。社区市场需要维护者审核，收录状态见[发布记录](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/publishing/releases/1.0.0.md)。
+
+**有共享壁纸市场吗？**
+
+已接通本地官方视频皮肤画廊，与 Zed Space 网站复用目录。支持在 DSH 内浏览、下载到「我的视频」并应用；尚未公开发布，启动条件见[本地市场接入](docs/market-integration.md)。
+
+**历史 Backspace 内容为什么还在？**
+
+本项目从 Backspace 演进而来。历史变更记录和旧媒体保留溯源用途。当前仓库的 Git tag 从 `v1.0.0` 重新开始。上游作者和许可记录见 [THIRD_PARTY_NOTICES.md](https://github.com/hetonghao/dsh-zed-space/blob/main/THIRD_PARTY_NOTICES.md) 与 [LICENSE](https://github.com/hetonghao/dsh-zed-space/blob/main/LICENSE)。
+
+## 开发资料
+
+[变更记录](https://github.com/hetonghao/dsh-zed-space/blob/main/CHANGELOG.md) · [贡献指南](https://github.com/hetonghao/dsh-zed-space/blob/main/CONTRIBUTING.md) · [隐私说明](https://github.com/hetonghao/dsh-zed-space/blob/main/docs/privacy.md) · [安全政策](https://github.com/hetonghao/dsh-zed-space/blob/main/SECURITY.md)

package/SECURITY.md

@@ -0,0 +1,57 @@
+# Security policy
+
+## Supported version
+
+Zed Space Skin 1.0.0 is an unpublished candidate. After its first release, security fixes target the latest maintained release; inherited historical tags do not establish a Zed Space Skin release.
+
+## Reporting a vulnerability
+
+Please use [the new repository's security page](https://github.com/hetonghao/dsh-zed-space/security) and its **Report a vulnerability** form so a
+report and any proof of concept remain private until a fix is available. If
+private vulnerability reporting is unavailable, open a minimal issue that
+does not include exploit details and ask the maintainer for a private channel.
+
+Include the affected installation path (DSH plugin, source integration, static
+installer, or browser extension), browser and Harness version, reproduction
+steps, and expected impact.
+
+## Security model
+
+- 渲染器、three.js 与字体随包提供，不加载远程代码或遥测。DSH 视频市场新增固定
+  loopback 目录与媒体读取，用于用户主动浏览和添加视频；范围见下文。
+- Preferences contain only appearance values and stay in `localStorage` or
+  `chrome.storage.sync`, depending on the installation path.
+- DSH Host 静态路由仅提供包内 `native-dist` 文件；市场路由另外提供受限的目录与媒体
+  读取。两者仅接受 `GET` 和 `HEAD`。
+- The extension is limited to `storage` and loopback Harness URLs on
+  `127.0.0.1` or `localhost`.
+
+These constraints are covered by repository and browser acceptance tests but
+do not replace independent review of code before installation.
+
+## 用户素材存储
+
+用户导入的视频、缩略图、显示名称及启用项仅由背景 iframe 保存在 `backspace-videos`
+IndexedDB 中，不进入 localStorage 或 chrome.storage.sync，不外传。每个文件上限 32 MiB，
+整体容量受浏览器配额限制；支持面板内逐项移除，也可清除对应站点/扩展的数据。
+移除不会改变磁盘上的原始文件。
+
+消息边界校验父窗口来源、实际 origin 和每次挂载生成的 token。素材按浏览器认证的
+宿主 origin 隔离；URL 中自报的 parentOrigin 不单独作为访问依据。文件及名称只以 Blob、
+textContent 或表单值传递，用户名称不拼接进 HTML。文件大小、容器、编码、视频轨、尺寸、
+时长与读取时限均在 iframe 的接收边界检查，写入采用 IndexedDB 事务。
+
+## 本地视频市场网络边界
+
+市场页面固定为 `http://127.0.0.1:4173`。新增请求仅用于读取
+`http://127.0.0.1:8080/api/catalog` 的 Ed25519 签名目录及目录内
+`http://127.0.0.1:9000/zed-space-public/` 媒体；插件使用固定公钥，禁止重定向、
+任意 URL 代理及通过 HTTP 修改信任配置。此接入不上传素材、不加入遥测。
+
+嵌入通信校验实际窗口、准确 origin、版本和 session；网站提交的素材 ID 与哈希必须
+重新匹配可信目录。插件下载时校验字节数及 SHA-256，现有视频接收端再次检查哈希、
+真实容器和兼容性后才写入 IndexedDB。来源去重按当前 owner 范围执行，不跨宿主读取。
+导入不等于应用；取消可能保留已原子写入的副本，但不会因下载完成而自动切换背景。
+
+嵌入握手失败时不回退浏览器下载。独立市场网站的下载行为保留；完整流程和本地服务
+要求见[视频市场接入](docs/market-integration.md)。CLI 登录地址含认证信息，不应公开。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,40 @@
+# 来源与第三方许可
+
+Zed Space Skin 继续使用下列上游代码、库和字体。安装版把渲染依赖与字体打包在本地；网络安装、更新和访问托管网站不属于离线运行承诺。
+
+## Open Sea Skin 与本项目沿革
+
+- 上游项目：https://github.com/d-dev0101/open-sea-skin
+- 本项目旧名 Backspace：https://github.com/hetonghao/dsh-backspace
+- 许可：MIT
+- 上游版权：© 2026 Open Sea Skin contributors
+- 本项目版权：© 2026 Zed Space Skin contributors（包含以 Backspace 名义提交的贡献）
+
+海洋渲染、Harness 集成、扩展与安装器继承自 Open Sea Skin。Backspace 是本项目的旧名；宇宙双视角、本地视频、各皮肤配置与背景切换延续了更名前的功能历史。项目更名后，自有贡献者署名统一为 Zed Space Skin contributors，历史贡献和提交记录保留。`LICENSE` 继续保留 Open Sea Skin 的上游版权声明和完整 MIT 许可。
+
+## three.js 0.178.0
+
+- 项目：https://threejs.org/
+- 源码：https://github.com/mrdoob/three.js/tree/r178
+- 许可：MIT
+- 版权：© 2010–2025 three.js authors
+- 本地许可：`shared/vendor/licenses/three-LICENSE.txt`（构建后随 runtime 分发）
+
+内置 WebGPU/TSL 构建已压缩，导入路径调整为本地相对地址；未携带上游可选的远程 WebGPU 调试导入。
+
+## Geist 字体
+
+- 项目：https://vercel.com/font
+- 源码：https://github.com/vercel/geist-font
+- 许可：SIL Open Font License 1.1
+- 本地许可：`shared/vendor/licenses/geist-OFL.txt`（构建后随字体分发）
+
+`.woff2` 文件本地提供。OFL 适用于字体文件，本仓库自有源码仍按 MIT 分发。
+
+## Zed Space 品牌标志
+
+本次使用用户现有同品牌项目的标志：`../zed-space/apps/website/public/brand/zed-space-mark.png`。本仓库的扩展图标与展示标志由该图片复用、缩放而来。此记录说明资产来源，不代表已完成第三方商标或全部历史素材权利清查。
+
+## 历史演示
+
+`site/` 保留原始参考实现，使用 jsDelivr 加载 three.js 0.178.0 与 Geist，保持其历史来源。自包含扩展和 Harness 安装版不使用这些 CDN 地址。

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# DeepSeek Harness bundle layer. Installing this repository with
+# `dsh plugin --profile web add github:hetonghao/dsh-zed-space` adds the Host
+# route and the matching browser module without modifying Harness source.
+- insert:
+    - id: dsh-zed-space
+      name: dsh-zed-space