dsh-transparent-ui 1.3.20 → 1.3.21

package/README.md

@@ -2,7 +2,7 @@
 
 <img src="icon.svg" width="64" height="64" alt="Aqua glass droplet icon">
 
-English | [中文](<README.zh.md>)
+English | [中文](<docs/zh.md>)
 
 A customizable glass theme for DeepSeek Harness. The conversation toolbar, sidebar, composer, statistics bar and settings panel use translucent surfaces, with a sidebar fluid backdrop, a particle whale and an interactive mesh behind the application content.
 
@@ -26,7 +26,7 @@ Distributed under [GNU AGPL-3.0](<LICENSE>); package metadata declares `AGPL-3.0
 | Item | Current target |
 | --- | --- |
 | Plugin package | `dsh-transparent-ui` |
-| Current plugin version | `1.3.20` |
+| Current plugin version | See [`package.json`](package.json) |
 | Target DSH version | Desktop `0.2.0-rc.2` |
 | Desktop profile | `desktop` |
 | Recommended installation | This GitHub repository, branch `main` |
@@ -60,7 +60,7 @@ The legacy command below addresses a **different, unscoped package**, not this f
 dsh plugin --profile web add dsh-client-ui-aqua
 ```
 
-It is not an installation or upgrade procedure for this desktop adaptation. The old unscoped build used removed client runtime APIs. Use the GitHub source above, rather than assuming npm resolves this repository's current version.
+It is not an installation or upgrade procedure for this desktop adaptation. The old unscoped build used removed client runtime APIs. This fork's npm identity is [`dsh-transparent-ui`](https://www.npmjs.com/package/dsh-transparent-ui); use that exact package name when installing from npm. GitHub `main` may contain changes not yet published to npm, so verify the installed version rather than treating the two sources as interchangeable.
 
 The inherited [PowerShell installer](<install.ps1>) targets the older Web setup. It is retained as historical tooling, **not** as the recommended desktop installer.
 

package/{README.zh.md → docs/zh.md}

@@ -1,8 +1,8 @@
 # Aqua — DSH 透明玻璃主题插件
 
-<img src="icon.svg" width="64" height="64" alt="Aqua 玻璃水滴图标">
+<img src="../icon.svg" width="64" height="64" alt="Aqua 玻璃水滴图标">
 
-[English](<README.md>) | 中文
+[English](<../README.md>) | 中文
 
 Aqua 为 DeepSeek Harness 提供可调节的玻璃质感主题：会话顶部操作栏、侧边栏、输入框、统计栏和设置面板使用半透明材质，左侧流体背景、粒子鲸鱼与交互网格位于应用内容下方。
 
@@ -17,16 +17,16 @@ Aqua 为 DeepSeek Harness 提供可调节的玻璃质感主题：会话顶部操
 - **DSH 0.1.5-rc.2 兼容适配：**[lllong0908/DSH-Transparent-UI-Plugin](https://github.com/lllong0908/DSH-Transparent-UI-Plugin)。
 - **本 DSH 0.2.0-rc.2 桌面兼容分支：**[fegnze/dsh-transparent-ui](https://github.com/fegnze/dsh-transparent-ui)。
 
-本分支主要修复安装、客户端 API 兼容性、桌面渲染与交互问题，不替代原项目的作者身份。二次分发时请保留原项目、原贡献者及历次适配者的署名。贡献者列表见 [CONTRIBUTORS.md](<CONTRIBUTORS.md>)，来源说明见 [UPSTREAM_NOTICE.md](<UPSTREAM_NOTICE.md>)。
+本分支主要修复安装、客户端 API 兼容性、桌面渲染与交互问题，不替代原项目的作者身份。二次分发时请保留原项目、原贡献者及历次适配者的署名。贡献者列表见 [CONTRIBUTORS.md](<../CONTRIBUTORS.md>)，来源说明见 [UPSTREAM_NOTICE.md](<../UPSTREAM_NOTICE.md>)。
 
-沿用 [GNU AGPL-3.0 许可证](<LICENSE>)；包元数据声明为 `AGPL-3.0-only`。
+沿用 [GNU AGPL-3.0 许可证](<../LICENSE>)；包元数据声明为 `AGPL-3.0-only`。
 
 ## 兼容范围
 
 | 项目 | 当前目标 |
 | --- | --- |
 | 插件包名 | `dsh-transparent-ui` |
-| 当前插件版本 | `1.3.20` |
+| 当前插件版本 | 见 [`package.json`](../package.json) |
 | 目标 DSH 版本 | 桌面版 `0.2.0-rc.2` |
 | 桌面配置 Profile | `desktop` |
 | 推荐安装来源 | 本 GitHub 仓库的 `main` 分支 |
@@ -60,9 +60,9 @@ Aqua 为 DeepSeek Harness 提供可调节的玻璃质感主题：会话顶部操
 dsh plugin --profile web add dsh-client-ui-aqua
 ```
 
-它不是本桌面适配版的安装或更新方式。旧的未带作用域构建使用过已移除的客户端 runtime API；请使用上面的 GitHub 来源，不要假定 npm 会解析到本仓库的最新版本。
+它不是本桌面适配版的安装或更新方式。旧的未带作用域构建使用过已移除的客户端 runtime API。本分支的 npm 身份是 [`dsh-transparent-ui`](https://www.npmjs.com/package/dsh-transparent-ui)，从 npm 安装时应使用此完整包名。GitHub `main` 可能包含尚未发布到 npm 的变更，应核对已安装版本，不要把两种来源视为完全相同。
 
-继承保留的 [PowerShell 安装器](<install.ps1>) 面向旧版 Web 配置，仅作历史工具保留，**不作为推荐的桌面安装入口**。
+继承保留的 [PowerShell 安装器](<../install.ps1>) 面向旧版 Web 配置，仅作历史工具保留，**不作为推荐的桌面安装入口**。
 
 ## 功能与使用
 
@@ -125,7 +125,7 @@ npm run bundle
 npm test
 ```
 
-[构建脚本](<scripts/build.mjs>) 生成 Host 入口和 DSH Module Loader 客户端包。本仓库随源码提供可运行的构建包，使 GitHub 安装不依赖原作者的 monorepo。DSH 客户端 peer 由桌面 Host 提供；隔离工具安装不会让插件成为独立 Web 应用。
+[构建脚本](<../scripts/build.mjs>) 生成 Host 入口和 DSH Module Loader 客户端包。本仓库随源码提供可运行的构建包，使 GitHub 安装不依赖原作者的 monorepo。DSH 客户端 peer 由桌面 Host 提供；隔离工具安装不会让插件成为独立 Web 应用。
 
 可选的真实 Chromium 交互回归（自行指定浏览器可执行文件）：
 
@@ -133,7 +133,7 @@ npm test
 DSH_TEST_CHROME='/path/to/chrome' npm run test:browser
 ```
 
-[浏览器回归脚本](<test/toolbar.browser.mjs>) 使用独立无头测试页，包含桌面拖拽规则、`display:contents` 插槽包装、顶栏背后滚动和正文高层级遮挡元素。检查实际拖拽排除样式、稳定的悬停位置，并分别在悬停下压开启／关闭时验证**连续 100 次输入点击**。临时测试页／浏览器 Profile 位于已忽略的 `.npm-stage/`。
+[浏览器回归脚本](<../test/toolbar.browser.mjs>) 使用独立无头测试页，包含桌面拖拽规则、`display:contents` 插槽包装、顶栏背后滚动和正文高层级遮挡元素。检查实际拖拽排除样式、稳定的悬停位置，并分别在悬停下压开启／关闭时验证**连续 100 次输入点击**。临时测试页／浏览器 Profile 位于已忽略的 `.npm-stage/`。
 
 ### 验证边界
 
@@ -147,7 +147,7 @@ DSH_TEST_CHROME='/path/to/chrome' npm run test:browser
 
 下列图片继承自上游仓库，用于展示原主题。**不是本分支当前桌面验收截图**；流体显示范围及其他细节可能与本分支不同。
 
-![原项目 Aqua 示例 1](<assets/1.png>)
-![原项目 Aqua 示例 2](<assets/2.png>)
-![原项目 Aqua 示例 3](<assets/3.png>)
-![原项目 Aqua 示例 4](<assets/4.png>)
+![原项目 Aqua 示例 1](<../assets/1.png>)
+![原项目 Aqua 示例 2](<../assets/2.png>)
+![原项目 Aqua 示例 3](<../assets/3.png>)
+![原项目 Aqua 示例 4](<../assets/4.png>)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-transparent-ui",
   "description": "Aqua glassmorphism theme for DeepSeek Harness 0.2.0-rc.2",
-  "version": "1.3.20",
+  "version": "1.3.21",
   "icon": "icon.svg",
   "publishConfig": {
     "access": "public"
@@ -105,6 +105,7 @@
     "lib/client.js",
     "lib/types/**/*.d.ts",
     "cordis.patch.yml",
-    "icon.svg"
+    "icon.svg",
+    "docs/zh.md"
   ]
 }