dsh-oort-theme-plugin 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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.i18n.yaml

@@ -0,0 +1,37 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write theme-plugin/README.md
+/:
+  en: 284c2f1d20f8450f
+  zh: 6eea2682ef3f023a
+/dsh-oort-theme-plugin:
+  en: 008ca914d02b6785
+  zh: 81738d91fc1743a2
+/dsh-oort-theme-plugin/summary:
+  en: cb86b4478c72ea61
+  zh: e88f3fc8ed5eccf5
+/dsh-oort-theme-plugin/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: e36dead4f5b39924
+/dsh-oort-theme-plugin/use-this-package:
+  en: bbff250eba0f1b89
+  zh: be52206a1599204f
+/dsh-oort-theme-plugin/use-this-package/install-a-local-package-archive:
+  en: a102bf63bc785773
+  zh: 5fbfadb8a07e0795
+/dsh-oort-theme-plugin/understand-the-implementation:
+  en: 659711f8bef2f20d
+  zh: 0c6cfc4923914973
+/dsh-oort-theme-plugin/further-exploration:
+  en: 5a33a44e99fa4a4d
+  zh: f8f23a2fd9f92f36
+/dsh-oort-theme-plugin/model-experience:
+  en: a9adeafd581db859
+  zh: 0a828c3687bae3d3
+/dsh-oort-theme-plugin/known-limitations-and-deferred-work:
+  en: bfeea25d6565e8c4
+  zh: e59a722d24fd9b55
+/dsh-oort-theme-plugin/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 4f9f026b33f03db6

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+---
+description: "Adds an Appearance dialog and image themes to the DSH desktop and Web client."
+kind: "package-bundle"
+---
 
-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.
+# dsh-oort-theme-plugin
+
+English | [中文](README.zh.md)
+
+## Summary
+
+This bundle adds an Appearance dialog to the account menu and provides selectable image themes. It uses the host's theme service, so the built-in light, dark, and system modes remain available. Install the bundle in a DSH profile and restart the application to load it.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+### Install a local package archive
+
+Build and pack this directory from the repository checkout:
+
+```powershell
+cd theme-plugin
+npm pack
+```
+
+Desktop includes version `0.1.0` as an offline fallback and checks npm for newer versions at startup. To install this archive manually, fully quit Desktop and run:
+
+```powershell
+dsh plugin --profile desktop add C:\path\to\dsh-oort-theme-plugin-0.1.1.tgz
+```
+
+Reopen Desktop to use a manual installation. The Appearance entry is in the menu opened from the account avatar at the lower left. The Web profile accepts the same archive through `dsh plugin --profile web add <archive>`.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals — click to expand</summary>
+
+The bundle patch inserts one Host row. The package's browser entry registers the theme options and dialog through the host's theme and slot services. Image assets are embedded in `lib/client.js` during the package build.
+
+Version `0.1.1` adds Spring, Autumn leaves, Winter snow, Lavender, and Chinese ink backgrounds. Their photos come from Pixabay: [Spring](https://pixabay.com/photos/tree-276014/), [Autumn](https://pixabay.com/photos/forest-8371211/), [Winter](https://pixabay.com/photos/trees-4830285/), [Lavender](https://pixabay.com/photos/sunset-1373171/), and [Chinese ink](https://pixabay.com/photos/mountain-6815304/). The photos follow the [Pixabay Content License](https://pixabay.com/service/license-summary/); the theme palette and preview are defined in this package.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+See the [Desktop plugin installation guide](../apps/desktop/README.md) and the [profile bundle model](../docs/architecture.md).
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+This bundle changes the interface only. It does not add model-visible input or tools.
+
+## Known Limitations and Deferred Work
+
+The host must provide the Appearance menu action and theme service used by this package. Desktop checks npm for newer versions at startup; other profiles retain their installed version until updated explicitly.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,85 @@
+---
+description: "为 DSH 桌面版和 Web 客户端提供外观弹框与图片主题。"
+kind: "package-bundle"
+---
+
+# dsh-oort-theme-plugin
+
+[English](README.md) | 中文
+
+## 概述
+
+此扩展包在账号菜单中提供「外观」弹框和可选图片主题。弹框使用宿主的主题服务，内置浅色、深色和跟随系统模式仍由宿主提供。将扩展包安装到 DSH 配置后，重启应用即可加载。
+
+## 目录
+
+- [使用此扩展包](#use-this-package)
+- [实现方式](#understand-the-implementation)
+- [延伸阅读](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用此扩展包
+
+### 安装本地压缩包
+
+在仓库检出目录构建并打包：
+
+```powershell
+cd theme-plugin
+npm pack
+```
+
+桌面版以 `0.1.0` 作为离线兜底，启动时检查 npm 是否有更新。若需手动安装此压缩包，先完全退出桌面版，再运行：
+
+```powershell
+dsh plugin --profile desktop add C:\path\to\dsh-oort-theme-plugin-0.1.1.tgz
+```
+
+手动安装后重新打开桌面版。点击左下角账号头像展开菜单，即可找到「外观」。Web 配置也可用 `dsh plugin --profile web add <压缩包路径>` 安装同一压缩包。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 实现方式
+
+<details>
+<summary>实现细节——点击展开</summary>
+
+扩展包补丁插入一条 Host 配置。浏览器入口通过宿主的主题与槽位服务注册主题选项和弹框。构建时，图片资源被嵌入 `lib/client.js`。
+
+`0.1.1` 新增春日、秋叶、冬雪、紫罗兰、中国风五套背景。照片来自 Pixabay：[春日](https://pixabay.com/photos/tree-276014/)、[秋叶](https://pixabay.com/photos/forest-8371211/)、[冬雪](https://pixabay.com/photos/trees-4830285/)、[紫罗兰](https://pixabay.com/photos/sunset-1373171/)及[中国风](https://pixabay.com/photos/mountain-6815304/)。照片适用 [Pixabay 内容许可](https://pixabay.com/service/license-summary/)；本插件负责配色与预览。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 延伸阅读
+
+参见[桌面插件安装说明](../apps/desktop/README.zh.md)和[配置扩展包机制](../docs/architecture.zh.md)。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+此扩展包只改变界面，不增加模型可见输入或工具。
+
+## 已知限制
+
+宿主必须提供此扩展包使用的「外观」菜单操作和主题服务。桌面版启动时检查 npm 新版本；其他配置需显式更新已安装版本。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作记录——点击展开</summary>
+
+无。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: oort-theme-plugin
+      name: dsh-oort-theme-plugin