dsh-kinich-theme 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+## 1.0.0 — First stable public release
+
+- Promoted the v0.9.1 product experience to the first stable public release.
+- Added public npm/GitHub metadata and one-command DSH installation documentation.
+- Added English and Simplified Chinese public README files.
+- Kept the three visual modes: Jungle, Phlogiston, and Sunlit.
+- Kept Minimal / Balanced / Immersive visual intensity controls.
+- Kept Ajaw Companion 2.0 with session-state feedback, click/double-click interaction, rAF drag, mirror, rotation, and reset.
+- Kept themed sidebar branding and blank-session Hero branding.
+- Kept mode-aware dynamic environment effects with reduced-motion support.
+- Ships prebuilt Host and Client bundles; end users do not need a build step.
+
+## 0.9.1
+
+- Added dynamic mode-aware ambient effects: Jungle fireflies, Phlogiston energy sparks, and Sunlit dust/light pass.
+- Added an ambient motion toggle and intensity-aware density.
+- Dynamic motion automatically disables under `prefers-reduced-motion`.
+
+## 0.9.0
+
+- Added session running/completed visual feedback bridged from the session-scoped composer dock.
+- Added Ajaw Companion 2.0 with thinking/success/idle moods, double-click flip, and richer status feedback.
+- Deepened Jungle / Phlogiston / Sunlit composition and sidebar branding.
+- Added Minimal / Balanced / Immersive visual intensity.
+
+## 0.8.0
+
+- Added three live visual modes and live DSH semantic-token switching.
+- Redesigned Hero/sidebar branding and product-style Settings UI.
+- Added Ajaw hover and click reactions.
+
+## 0.7.0
+
+- Moved build generation to esbuild.
+- Unified persisted setting definitions.
+- Added rAF-throttled Ajaw dragging.
+- Added visual presets, Ajaw reset, and character-position previews.

package/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 Xian-JL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the original plugin code 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.
+
+Third-party content notice
+--------------------------
+
+This license applies only to the original plugin code and documentation. It
+does not grant any rights to third-party game characters, artwork, trademarks,
+or other visual assets embedded in lib/client.js. Those materials remain the
+property of their respective rights holders and are documented in
+THIRD_PARTY_ASSETS.md. Users and redistributors are responsible for complying
+with the applicable third-party terms.

package/README.md

@@ -0,0 +1,111 @@
+# Kinich Theme for DeepSeek Harness
+
+Interactive **Kinich & Ajaw** themed UI experience for DeepSeek Harness Web.
+
+- Repository: https://github.com/Xian-JL/dsh-Kinich-theme
+- npm: `dsh-kinich-theme`
+- Stable release: `1.0.0`
+- Target runtime: `@deepseek-ai/dsh@0.1.5-rc.1` Web
+
+> This is an independent community plugin and is not affiliated with or endorsed by DeepSeek or HoYoverse.
+
+## Install
+
+```powershell
+dsh plugin --profile web add dsh-kinich-theme
+```
+
+Then launch DSH Web:
+
+```powershell
+dsh web
+```
+
+No local clone, build step, or esbuild installation is required for normal users. The npm package ships prebuilt `lib/index.js` and `lib/client.js`.
+
+## Update
+
+```powershell
+dsh plugin --profile web add dsh-kinich-theme@latest
+```
+
+## Uninstall
+
+```powershell
+dsh plugin --profile web remove dsh-kinich-theme
+```
+
+## Features
+
+### Three complete visual modes
+
+- **Jungle** — deep forest greens, organic ambience, firefly-like motion.
+- **Phlogiston** — dark lime/orange energy language with stronger edge glow.
+- **Sunlit** — lighter stone-and-gold presentation optimized for long sessions.
+
+### Visual intensity
+
+Choose **Minimal**, **Balanced**, or **Immersive** independently from the visual mode.
+
+### Ajaw Companion 2.0
+
+- Idle / hover / reaction / dragging states.
+- Session-aware thinking and completion feedback.
+- Drag position, mirror, rotation, and reset controls.
+- Double-click interaction and lightweight idle moods.
+
+### DSH-native integration
+
+- Kinich/Ajaw sidebar branding.
+- Blank-session Hero branding.
+- Native DSH settings integration.
+- Live DSH semantic-token overrides.
+- Dynamic environment effects with `prefers-reduced-motion` support.
+
+## Settings
+
+Open DSH **Settings → General → Kinich Theme** to configure:
+
+- Jungle / Phlogiston / Sunlit
+- Minimal / Balanced / Immersive
+- Kinich character layer
+- Ajaw companion
+- Natlan ornament / texture
+- Dynamic environment motion
+
+## Compatibility
+
+`v1.0.0` targets the current stable DSH Web line used for this release:
+
+```text
+@deepseek-ai/dsh 0.1.5-rc.1
+Node.js ^22.19.0 || >=24.0.0
+```
+
+DeepSeek Harness is still evolving quickly. If a future DSH release changes plugin APIs, use the latest Kinich Theme release that explicitly lists support for that DSH version.
+
+## Development
+
+```powershell
+npm install
+npm run verify
+```
+
+The source tree is modular under `src/`; `esbuild` produces the prebuilt Host and Client bundles in `lib/`.
+
+## Project structure
+
+```text
+src/       Modular Host / Client / shared source
+assets/    Source visual assets used to generate the runtime bundle
+scripts/   Build and verification tooling
+lib/       Prebuilt DSH runtime entrypoints
+```
+
+## Credits and third-party assets
+
+See [`THIRD_PARTY_ASSETS.md`](./THIRD_PARTY_ASSETS.md). The MIT license covers the original plugin code and documentation only; third-party characters, artwork, trademarks, and visual materials remain subject to their respective rights and terms.
+
+## License
+
+Original plugin code and documentation: MIT. See [`LICENSE`](./LICENSE).

package/README.zh-CN.md

@@ -0,0 +1,102 @@
+# Kinich Theme for DeepSeek Harness
+
+面向 DeepSeek Harness Web 的 **基尼奇（Kinich）& 阿乔（Ajaw）交互主题插件**。
+
+- GitHub：https://github.com/Xian-JL/dsh-Kinich-theme
+- npm：`dsh-kinich-theme`
+- 正式版本：`1.0.0`
+- 目标运行环境：`@deepseek-ai/dsh@0.1.5-rc.1` Web
+
+> 本项目是独立社区插件，与 DeepSeek、HoYoverse 无官方关联，也不代表其认可或背书。
+
+## 安装
+
+```powershell
+dsh plugin --profile web add dsh-kinich-theme
+```
+
+随后启动：
+
+```powershell
+dsh web
+```
+
+普通用户无需克隆仓库、运行构建或安装 esbuild；npm 包中已经包含预构建的 `lib/index.js` 与 `lib/client.js`。
+
+## 更新
+
+```powershell
+dsh plugin --profile web add dsh-kinich-theme@latest
+```
+
+## 卸载
+
+```powershell
+dsh plugin --profile web remove dsh-kinich-theme
+```
+
+## 主要功能
+
+### 三套完整视觉模式
+
+- **Jungle**：深绿雨林、自然环境氛围与萤火动态。
+- **Phlogiston**：深色 + 荧光绿/橙色的燃素能量语言。
+- **Sunlit**：浅石色、金绿配色，适合长时间阅读。
+
+### 视觉强度
+
+视觉模式之外，可独立选择 **Minimal / Balanced / Immersive** 三档表现强度。
+
+### Ajaw Companion 2.0
+
+- Idle / Hover / Reacting / Dragging 状态。
+- 根据 DSH 会话运行与完成状态反馈。
+- 支持拖拽、镜像、旋转、复位。
+- 双击互动与轻量随机待机状态。
+
+### 原生 DSH 集成
+
+- Sidebar Kinich/Ajaw 品牌区域。
+- 空白会话 Hero 品牌视觉。
+- 原生 Settings 设置项。
+- DSH Semantic Token 实时覆盖。
+- 动态环境效果，并支持 `prefers-reduced-motion`。
+
+## 设置入口
+
+进入 **Settings → General → Kinich Theme**，可调整：
+
+- Jungle / Phlogiston / Sunlit
+- Minimal / Balanced / Immersive
+- 基尼奇角色层
+- 阿乔伙伴
+- 纳塔边角装饰与纹理
+- 动态环境效果
+
+## 兼容性
+
+`v1.0.0` 正式面向：
+
+```text
+@deepseek-ai/dsh 0.1.5-rc.1
+Node.js ^22.19.0 || >=24.0.0
+```
+
+DeepSeek Harness 仍处于快速迭代阶段。未来 DSH API 发生变化时，请使用明确声明兼容对应 DSH 版本的 Kinich Theme 版本。
+
+## 开发
+
+```powershell
+npm install
+npm run verify
+```
+
+源码位于 `src/`，使用 esbuild 生成 `lib/` 中的 Host / Client 预构建运行文件。
+
+## 素材与署名
+
+详见 [`THIRD_PARTY_ASSETS.md`](./THIRD_PARTY_ASSETS.md)。MIT 许可仅覆盖本项目原创代码和文档；第三方角色、图片、商标及视觉素材仍受各自权利和条款约束。
+
+## License
+
+原创插件代码及文档采用 MIT License，详见 [`LICENSE`](./LICENSE)。

package/RELEASE_NOTES.md

@@ -0,0 +1,35 @@
+# Kinich Theme v1.0.0
+
+First stable public release of Kinich Theme for DeepSeek Harness Web.
+
+## Highlights
+
+- Jungle / Phlogiston / Sunlit visual modes
+- Minimal / Balanced / Immersive visual intensity
+- Ajaw Companion 2.0
+- DSH session-state visual feedback
+- Kinich/Ajaw sidebar and blank-session Hero branding
+- Dynamic environment effects with reduced-motion support
+- Native DSH settings and semantic-token integration
+- Prebuilt runtime package with one-command installation
+
+## Install
+
+```powershell
+dsh plugin --profile web add dsh-kinich-theme
+```
+
+Then:
+
+```powershell
+dsh web
+```
+
+## Compatibility
+
+- DeepSeek Harness Web: `0.1.5-rc.1`
+- Node.js: `^22.19.0 || >=24.0.0`
+
+## Important asset notice
+
+The MIT license covers the original plugin code and documentation only. The runtime bundle contains processed third-party visual materials documented in `THIRD_PARTY_ASSETS.md`. Public redistribution rights for those materials must be confirmed separately before publication.

package/THIRD_PARTY_ASSETS.md

@@ -0,0 +1,47 @@
+# 第三方素材记录
+
+本文件记录 `dsh-kinich-theme 1.0.0` 实际使用的视觉素材、当前仓库中的处理后文件及其来源说明。它是来源清单，不构成授权证明或法律意见。
+
+v1.0.0 延续既有 的素材恢复方案：此前只存在于 `lib/client.js` data URI 中的处理后素材恢复为独立文件；`npm run build` 会从这些文件重新生成完全自包含的 Client Bundle。
+
+## 实际嵌入浏览器包的素材
+
+| 包内用途 | v1.0.0 处理后文件 | 来源 | 处理方式 | 默认状态 |
+| --- | --- | --- | --- | --- |
+| 阿乔品牌标记 | `assets/mascot/ajaw-mark.png` | Bilibili UP 主“公公的日常”提供/发布的素材集 | 去除透明留白、最近邻缩放至 112×112 PNG，构建时作为 data URI 嵌入 Client Bundle | 开启 |
+| 阿乔待机动画 | `assets/mascot/ajaw-idle.webp` | Bilibili UP 主“公公的日常”提供/发布的素材集 | 从纵向五帧源图最近邻缩放至 128×485 无损 WebP，构建时作为 data URI 嵌入 Client Bundle | 开启 |
+| 基尼奇角色装饰 | `assets/character/kinich-character.webp` | 米游社《【原神档案室】丨基尼奇》：https://www.miyoushe.com/ys/article/58586903 | 保留透明通道、缩放至 520×520、转 WebP；UI 中降低不透明度并做底部遮罩 | 关闭 |
+| 纳塔边角装饰 | `assets/ornaments/natlan-corner.webp` | 米游社《【原神】纳塔角色立绘～新背景图》：https://www.miyoushe.com/ys/article/55171368 | 裁切、去白底、缩放并转透明 WebP；UI 中按日夜模式低透明度混合 | 开启 |
+
+## 处理后文件校验值
+
+- `ajaw-mark.png`: `e28cc6f7d740508985d5796797710521905c3fb39614724cc5d31ef872ec538e`
+- `ajaw-idle.webp`: `df3ade3f54f0e5c7623999f0e8af33ce565d018d49210e1e4acaa85036fee59e`
+- `kinich-character.webp`: `3b8aed011da5cbad0bce197938b8c316e74e4d656a2bf06045469b335caad702`
+- `natlan-corner.webp`: `c6b945094e477ea02d342ef13a348bbee3214231e957bb6fa258681aedd34f3d`
+
+这些文件字节与 v1.0.0 Client Bundle 中的四个 data URI 完全一致；v1.0.0 仍沿用这些处理后素材。
+
+## 原始素材路径记录（历史）
+
+重构前文档记录的原始工作文件包括：
+
+- `assets/originals/mascot/ajaw-pixel.png`
+- `assets/originals/mascot/ajaw-idle-source.png`
+- `assets/originals/character/kinich-illustration.png`
+- `assets/originals/ornaments/natlan-corner-source.png`
+
+这些原始工作文件不在本次上传的 v0.8.0 ZIP 内，因此当前项目仍仅保留实际嵌入运行包的处理后文件，没有凭空补造原始素材。
+
+## 原创实现
+
+- 像素几何网格、燃素色光晕及响应式遮罩由插件 CSS 原创生成，不使用外部纹理图片。
+- 主题色板为针对 DSH 语义 Token 编写的原创配置。
+
+## 公开发布前必须复核
+
+1. 保存每项素材作者或权利人的明确再分发许可记录。
+2. 核实是否允许修改、压缩、透明化及嵌入 npm 包。
+3. 按许可补充作者署名、作品链接、许可名称和版权声明。
+4. 如任一素材没有公开再分发许可，公开版应替换为自制或明确授权素材。
+5. 复核“原神”、角色及相关视觉元素的商标、同人内容与平台规则。

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Bundle layer for dsh-kinich-theme.
+# `dsh plugin --profile web add <package>` appends this bundle to the Web profile.
+- insert:
+    - id: dsh-kinich-theme
+      name: dsh-kinich-theme