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

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: 05f589ba582fc05b
+  zh: 3e044b6e19207bf2
+/dsh-oort-theme-plugin/understand-the-implementation:
+  en: b3fdbba52a9da811
+  zh: 53eda4ee99cce3ac
+/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: a640da147ea7a4f1
+  zh: 931c144a8752ab70
+/dsh-oort-theme-plugin/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 4f9f026b33f03db6

package/README.md

@@ -1,3 +1,83 @@
-# 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
+```
+
+After opening and fully quitting Desktop once, install the archive with the Desktop-installed `dsh` command, then reopen Desktop:
+
+```powershell
+dsh plugin --profile desktop add C:\path\to\dsh-oort-theme-plugin-0.1.0.tgz
+```
+
+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.
+
+</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. Publishing a new package version does not automatically update an installed Desktop profile.
+
+<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,83 @@
+---
+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
+```
+
+先打开一次桌面版并完全退出，再使用桌面版安装的 `dsh` 命令安装压缩包，然后重新打开桌面版：
+
+```powershell
+dsh plugin --profile desktop add C:\path\to\dsh-oort-theme-plugin-0.1.0.tgz
+```
+
+点击左下角账号头像展开菜单，即可找到「外观」。Web 配置也可用 `dsh plugin --profile web add <压缩包路径>` 安装同一压缩包。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 实现方式
+
+<details>
+<summary>实现细节——点击展开</summary>
+
+扩展包补丁插入一条 Host 配置。浏览器入口通过宿主的主题与槽位服务注册主题选项和弹框。构建时，图片资源被嵌入 `lib/client.js`。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 延伸阅读
+
+参见[桌面插件安装说明](../apps/desktop/README.zh.md)和[配置扩展包机制](../docs/architecture.zh.md)。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+此扩展包只改变界面，不增加模型可见输入或工具。
+
+## 已知限制
+
+宿主必须提供此扩展包使用的「外观」菜单操作和主题服务。发布新版本不会自动更新已安装的桌面配置。
+
+<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