@anionex/dsh-eye-care 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anionex
+
+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,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write dsh-eye-care/README.md
+README.md: a1992d36826adbbf5be6abd43bcad4b5366b643c
+README.zh.md: 19f5bcd0d176715622aaaf6598606a3dc4bab44e

package/README.md

@@ -0,0 +1,86 @@
+# DSH Eye Care
+
+English | [中文](README.zh.md)
+
+Warm Light, Warm Dark, System-Aware.
+
+A DeepSeek Harness Web profile bundle that replaces cool white interface colors with six warm semantic themes while leaving the native Appearance preference intact.
+
+<p align="center">
+  <img src="assets/eye-care-light.png" alt="DSH Eye Care settings row in warm light mode with Day and Warm selected" width="49%">
+  <img src="assets/eye-care-dark.png" alt="DSH Eye Care settings row in warm dark mode with Auto and Warm selected" width="49%">
+</p>
+
+## What it does
+
+DSH Web's built-in Light and Dark themes are cool-toned. Eye care adds a warm light palette, a warm dark palette, and an automatic scheme without a global sepia filter or image transform.
+
+- **Four operating modes:** `off`, `auto`, `light`, and `dark`.
+- **Three warmth levels:** `soft`, `balanced`, and `warm`.
+- **Six concrete themes** registered through the official ThemeService.
+- **Real semantic tokens** for backgrounds, text, borders, buttons, sidebar, bubbles, inputs, code blocks, scrollbars, and Shiki colors.
+- **Native Appearance stays authoritative:** choosing Light, Dark, or System turns eye care off and keeps that newly selected theme.
+- **Loopback persistence** stores the selection in Host settings; remote browsers keep the selection in the current process.
+
+## Preview
+
+The screenshots above show the General settings row in warm day mode and warm night mode. Day and Night are explicit; Auto follows `prefers-color-scheme` at the selected warmth. The row also renders an `aria-live` status and keyboard-visible focus states.
+
+## Install
+
+Install the public npm package into the Web profile:
+
+```sh
+dsh plugin --profile web add @anionex/dsh-eye-care
+```
+
+For local development, replace the package name with the checkout's absolute path or a locally packed tarball. `DSH_HOME` defaults to `~/.dsh`; point it at a temporary directory to try the bundle without changing your main profiles.
+
+Restart or start the Web UI:
+
+```sh
+dsh web
+```
+
+Open **Settings → General → Eye care** and choose a mode and warmth.
+
+## Theme matrix
+
+| Scheme | Soft | Balanced | Warm |
+|---|---|---|---|
+| Light | `eye-care-light-soft` | `eye-care-light-balanced` | `eye-care-light-warm` |
+| Dark | `eye-care-dark-soft` | `eye-care-dark-balanced` | `eye-care-dark-warm` |
+
+## How it works
+
+The Host half registers the `eye-care` Settings namespace and exposes a loopback-only Connection RPC channel `/eye-care`. Writes are serialized and fenced by `expectedRevision`; a conflict re-reads the Host snapshot and retries the latest intent.
+
+The browser half registers the six themes, injects the General-settings row, and owns the controller lifecycle. The controller subscribes to `theme/change` and `prefers-color-scheme`, restores the pre-eye-care theme on disable or unload, and unregisters every theme on dispose. Remote browsers do not inject the Host RPC and therefore stay process-local.
+
+## Compatibility and limitations
+
+- Requires a DeepSeek Harness Web profile with the standard `settings`, `connection`, `locale`, `slots`, and `theme` services.
+- A native Appearance change is treated as an explicit opt-out by design.
+- Remote browser sessions do not persist eye care back to the Host.
+- There is no global color filter; all colors come from named semantic tokens.
+- The package is pre-release and follows the profile bundle format; its generated theme ids are stable while the bundle is installed.
+
+## Development
+
+```sh
+cd dsh-eye-care
+pnpm install --frozen-lockfile
+pnpm run check
+pnpm run test
+pnpm run build
+```
+
+Run the optional clean-profile installation test:
+
+```sh
+DSH_EYE_CARE_PROFILE_E2E=1 pnpm exec vitest run tests/profile-install.e2e.spec.ts
+```
+
+## License
+
+[MIT](LICENSE)

package/README.zh.md

@@ -0,0 +1,86 @@
+# DSH Eye Care
+
+[English](README.md) | 中文
+
+暖色浅色、暖色暗色，自动跟随系统。
+
+这是一个 DeepSeek Harness Web Profile Bundle：用六套暖色语义主题替换冷白界面配色，同时保持原生外观偏好不被破坏。
+
+<p align="center">
+  <img src="assets/eye-care-light.png" alt="DSH Eye Care 设置行：暖色日间主题，已选择日间和温暖" width="49%">
+  <img src="assets/eye-care-dark.png" alt="DSH Eye Care 设置行：暖色夜间主题，已选择自动和温暖" width="49%">
+</p>
+
+## 功能
+
+DSH Web 内置的 Light 与 Dark 主题偏冷。护眼模式在不使用全局 sepia 滤镜或图片变换的前提下，提供暖色浅色、暖色暗色和自动明暗切换。
+
+- **四种模式：** `off`、`auto`、`light`、`dark`。
+- **三档暖色强度：** `soft`、`balanced`、`warm`。
+- **六套具体主题**通过官方 ThemeService 注册。
+- **真正的语义 token**覆盖背景、文字、边框、按钮、sidebar、bubble、输入框、代码块、滚动条与 Shiki 配色。
+- **原生外观仍然权威：** 选择浅色、深色或跟随系统会关闭护眼模式，并保留新选择的主题。
+- **Loopback 持久化**把选择保存到 Host settings；远程浏览器则把选择保留在当前进程。
+
+## 预览
+
+上方截图分别展示暖色日间与暖色夜间状态下的 General 设置行。日间与夜间是显式模式；自动模式会按所选暖色强度跟随 `prefers-color-scheme`。设置行还提供 `aria-live` 状态提示和键盘可见的焦点状态。
+
+## 安装
+
+把公共 npm 包一键安装到 Web Profile：
+
+```sh
+dsh plugin --profile web add @anionex/dsh-eye-care
+```
+
+本地开发时，把包名替换为 checkout 的绝对路径或本地打包的 tarball。`DSH_HOME` 默认指向 `~/.dsh`；只想试用而不改动主 Profile 时，可把它指向一个临时目录。
+
+重启或启动 Web UI：
+
+```sh
+dsh web
+```
+
+打开 **设置 → 通用设置 → 护眼模式**，选择模式与暖色强度。
+
+## 主题矩阵
+
+| 明暗 | 柔和 | 均衡 | 温暖 |
+|---|---|---|---|
+| 浅色 | `eye-care-light-soft` | `eye-care-light-balanced` | `eye-care-light-warm` |
+| 暗色 | `eye-care-dark-soft` | `eye-care-dark-balanced` | `eye-care-dark-warm` |
+
+## 工作原理
+
+Host 半区注册 `eye-care` Settings 命名空间，并暴露仅限 loopback 的 Connection RPC 通道 `/eye-care`。写入串行执行，并以 `expectedRevision` 做版本栅栏；发生冲突时重新读取 Host 快照，再重试最新意图。
+
+Browser 半区注册六套主题，注入 General 设置行，并管理控制器生命周期。控制器订阅 `theme/change` 与 `prefers-color-scheme`，在关闭或卸载时恢复启用护眼前的主题，并在 dispose 时注销全部主题。远程浏览器不注入 Host RPC，因此选择保持进程本地。
+
+## 兼容性与限制
+
+- 需要包含标准 `settings`、`connection`、`locale`、`slots` 和 `theme` 服务的 DeepSeek Harness Web Profile。
+- 原生外观切换按设计视为明确退出护眼模式。
+- 远程浏览器会话不会把护眼选择回写到 Host。
+- 不使用全局颜色滤镜；所有颜色都来自命名的语义 token。
+- 该包处于预发布阶段，遵循 Profile Bundle 格式；只要 bundle 已安装，其生成的主题 id 就保持稳定。
+
+## 开发
+
+```sh
+cd dsh-eye-care
+pnpm install --frozen-lockfile
+pnpm run check
+pnpm run test
+pnpm run build
+```
+
+运行可选的干净 Profile 安装测试：
+
+```sh
+DSH_EYE_CARE_PROFILE_E2E=1 pnpm exec vitest run tests/profile-install.e2e.spec.ts
+```
+
+## 许可证
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-eye-care
+      name: '@anionex/dsh-eye-care'