dsh-inkpond 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shin
+
+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.en.md

@@ -0,0 +1,102 @@
+# Inkpond for DSH
+
+[简体中文](README.md)
+
+Interactive Chinese glyph ink-wash backgrounds for DeepSeek Harness.
+The default **lotus pond** has drifting koi, lotus leaves and flowers. Pointer movement makes ripples;
+clicking empty space drops ink. Misty hills, a Qingming handscroll, the 24 solar terms and the Northern sea are also included.
+
+![Lotus pond live preview in DSH, 1280×720](https://raw.githubusercontent.com/shin4/inkpond-dsh/main/docs/images/lotus-preview.gif)
+
+[View the 16:9 still screenshot](https://raw.githubusercontent.com/shin4/inkpond-dsh/main/docs/images/lotus-preview.png) · Actual capture, approximately 10 seconds, with the default lotus scene and 45% strength.
+
+## Compatibility
+
+The initial verified host is **DSH 0.2.1-rc.3**, using the kernel shipped with the official macOS
+Desktop app in an isolated Web profile. `engines.dsh` is intentionally pinned to that version.
+Other releases and Windows/Linux are not yet verified. The adapter uses semantic conversation DOM
+markers; host layout/API changes need validation before widening compatibility.
+
+## Install
+
+### Desktop or Web: use the Add plugin wizard (recommended)
+
+1. Open **Plugins → Add plugin → Install a third-party plugin** in DSH.
+2. Enter the npm package name in the **Package name or address** field:
+
+   ```text
+   dsh-inkpond
+   ```
+
+   To pin the current version, enter `dsh-inkpond@0.2.0` instead.
+3. Select **Official npm registry** under the installation registry options, then click **Install**.
+   Mirrors may not have synchronized a newly published version yet.
+4. Start a new empty conversation to see the default lotus pond. If DSH requests a restart,
+   fully quit and reopen the application.
+
+The wizard installs directly from npm, independently of listings in 1024 Store or dshmarket.
+No source checkout or local compilation is needed. The compatibility limits above still apply.
+
+### Install into a Web profile with the CLI
+
+```bash
+dsh plugin --profile web add dsh-inkpond@0.2.0
+```
+
+For Desktop, prefer the in-app wizard above, which targets the current application's profile.
+The terminal's `web` profile is not necessarily the Desktop profile.
+The package is published on [npm](https://www.npmjs.com/package/dsh-inkpond).
+
+### Install a Release tarball
+
+Download `dsh-inkpond-0.2.0.tgz` from [Releases](https://github.com/shin4/inkpond-dsh/releases).
+Enter its absolute local path in the host plugin manager, or install into a regular Web profile:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/dsh-inkpond-0.2.0.tgz
+```
+
+Refresh the page; restart the instance if it does not hot-load. The tarball is prebuilt and
+does not compile code at installation time.
+A GitHub source checkout requires `npm ci && npm run build` before installation.
+
+## Preferences
+
+Open Plugins → Installed → dsh-inkpond. Select Lotus pond (default), Misty hills, Qingming handscroll, 24 solar terms (selected by the current date) or Northern sea (waves and a whale);
+choose new conversations only (default) or all conversations, toggle color accents, adjust ink strength,
+and select system animation preferences or a still image. All-conversation mode needs further long-chat testing.
+Restore defaults returns to Lotus pond, 45% strength, new conversations only and system motion preferences.
+
+The canvas passes through clicks and never controls typing or sending. Hidden pages pause animation;
+reduced motion produces a still image, and forced colors hides the decoration. Weak devices downgrade automatically.
+
+Preferences use this client's origin-local storage (`dsh-inkpond.preferences.v1`); performance uses
+`dsh-inkpond.tier.v1`. They do not synchronize between browsers, ports or devices. When storage is
+unavailable, changes last only for the current page. Uninstall removes runtime instances, styles and DOM
+markers but retains preferences for reinstall. Delete those two storage keys to remove preferences too.
+
+## Development
+
+Node.js 22+ and npm:
+
+```bash
+npm ci
+npm run check
+npm pack
+```
+
+`check` runs type checking, tests and the build. The tarball contains the Host entry, DSH client factory,
+offline fonts and licenses. React comes from DSH; the renderer is pinned to local inkpond commit `c502ef8ba4a898b22f321a5dba3e2255736bc60c`
+(an independent dependency tarball; see `vendor/README.md`).
+Test tarballs in a separate `DSH_HOME`. Avoid uninstall tests in a daily profile. DSH local-link removal
+was observed cleaning the linked target's development dependencies, so use tarballs for acceptance testing.
+See the [verification record](docs/verification.md) and [release checklist](docs/release.md).
+
+## Scope and licenses
+
+This plugin adds only backgrounds and appearance preferences. It registers no model tools, reads no
+messages, sends no telemetry and makes no third-party network requests. All fonts are included; no CDN
+is needed. The host's own networking is outside this plugin's control.
+
+MIT code; renderer from [inkpond](https://github.com/shin4/inkpond). Font subsets use SIL OFL 1.1;
+see [third-party notices](THIRD_PARTY_NOTICES.md). Independent community project, unaffiliated with DeepSeek.

package/README.md

@@ -1,3 +1,101 @@
-# Temporary Holding Version
+# 墨池 · Inkpond for DSH
 
-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.
+[English](README.en.md)
+
+以字为墨，以页为池。为 DeepSeek Harness 会话界面铺一层可交互的汉字水墨背景。
+
+默认是**莲池**：荷叶与荷花之间，鲤鱼缓缓游动。鼠标划过起涟漪，点击空白处落墨。
+可切换山水、清明上河、二十四节气和北冥，保留输入区留白、明暗主题跟随及自动性能降级。
+
+![莲池动态预览：DSH 实际运行画面，1280×720](https://raw.githubusercontent.com/shin4/inkpond-dsh/main/docs/images/lotus-preview.gif)
+
+[查看 16:9 静态截图](https://raw.githubusercontent.com/shin4/inkpond-dsh/main/docs/images/lotus-preview.png) · 实际录屏，约 10 秒，默认莲池与 45% 浓度。
+
+## 兼容性
+
+首版验证基线为 **DSH 0.2.1-rc.3**（macOS 官方桌面应用携带的内核，隔离 Web profile）。
+`engines.dsh` 暂时固定该版本；其他版本及 Windows/Linux 尚未验证。
+插件依赖会话容器的语义 DOM 标记，宿主 API 或布局改变时需要重新验证后扩大版本范围。
+
+## 安装
+
+### 桌面版或网页版：通过添加插件向导安装（推荐）
+
+1. 打开 DSH 的 **插件 → 添加插件 → 安装第三方插件**（Add plugin）。
+2. 在向导的「包名或地址」输入框中填写 npm 包名：
+
+   ```text
+   dsh-inkpond
+   ```
+
+   如需固定当前版本，填写 `dsh-inkpond@0.2.0`。
+3. 在「安装源」中选择 **npm 官方源**，点击 **安装**（Install）。新版本可能尚未同步到镜像源。
+4. 安装后新建空白会话，即可看到默认莲池。若宿主提示重启，请完全退出并重新打开 DSH。
+
+此入口直接从 npm 安装，不依赖 1024 Store 或 dshmarket 是否已收录。
+无需下载源码或在本机编译。适用版本仍以本文的兼容性说明为准。
+
+### 使用 CLI 安装到 Web profile
+
+```bash
+dsh plugin --profile web add dsh-inkpond@0.2.0
+```
+
+桌面版推荐使用上述应用内向导，它会安装到当前应用的 profile；
+不要假定终端的 `web` profile 就是桌面配置。包发布于 [npm](https://www.npmjs.com/package/dsh-inkpond)。
+
+### 使用 Release 安装包
+
+从 [GitHub Releases](https://github.com/shin4/inkpond-dsh/releases) 下载 `dsh-inkpond-0.2.0.tgz`。
+在 DSH 插件管理页填入本地安装包的绝对路径，或使用普通 Web profile：
+
+```bash
+dsh plugin --profile web add /absolute/path/to/dsh-inkpond-0.2.0.tgz
+```
+
+刷新页面；若宿主未热加载，重启对应实例。安装包包含构建产物，不执行安装期编译。
+GitHub 源码 checkout 需要先 `npm ci && npm run build`，不能直接从未构建源码安装。
+
+## 使用
+
+插件 → 已安装 → dsh-inkpond：
+
+- 默认莲池，亦可选山水、清明上河、二十四节气和北冥。节气随当前日期选择画面；北冥呈现海浪与鲸影。
+- 默认仅新会话显示；可选择所有会话（长对话兼容性仍需更多实测）。
+- 调整淡彩、墨色浓淡，选择跟随系统动画或静态画面。
+- 恢复默认会回到莲池、45% 浓度、仅新会话、跟随系统动画。
+
+画布不会接管点击、键盘或发送消息。关闭标签页显示会暂停，减少动画设置会生成静态画面，
+高对比度模式会隐藏画布。弱设备会自动降低动画档位。
+
+外观偏好存于当前客户端 origin 的 `localStorage`（`dsh-inkpond.preferences.v1`），
+性能档位使用 `dsh-inkpond.tier.v1`。它们不跨浏览器、端口或设备同步。
+存储不可用时设置仅在当前页面有效。卸载会清除运行实例、样式与 DOM 标记，保留本地偏好便于重装；
+需要彻底清除偏好时可删除上述两个站点存储键。
+
+## 开发
+
+Node.js 22+，npm：
+
+```bash
+npm ci
+npm run check
+npm pack
+```
+
+`check` 执行类型检查、单元测试和构建。`npm pack` 生成独立安装包，包含 Host 入口、
+DSH 客户端工厂、内嵌字体和许可证。React 由宿主提供，绘制引擎固定使用 本地 inkpond 提交 `c502ef8ba4a898b22f321a5dba3e2255736bc60c`（独立依赖包，详见 `vendor/README.md`）。
+
+使用独立 `DSH_HOME` 验证安装包；不要在日常 profile 中进行卸载测试。
+已观察到 DSH 本地链接卸载可能清理链接目标的开发依赖，因此推荐始终用 `.tgz` 做安装验收。
+
+详见 [验证记录](docs/verification.md) 和 [发布清单](docs/release.md)。
+
+## 范围与许可
+
+本插件只提供背景和外观设置，没有模型工具、遥测、消息读取或第三方网络请求。
+五个字体子集随包提供，无需 CDN。宿主自身的网络行为不由本插件控制。
+
+代码采用 MIT；绘制核心来自 [inkpond](https://github.com/shin4/inkpond)，
+字体采用 SIL OFL 1.1，见 [第三方声明](THIRD_PARTY_NOTICES.md)。
+独立社区插件，与 DeepSeek 官方无隶属关系。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,13 @@
+# Third-party notices
+
+The browser artifact bundles Inkpond 0.1.0 (https://github.com/shin4/inkpond),
+Copyright (c) 2026 Shin, under the MIT license. Built from local upstream commit c502ef8ba4a898b22f321a5dba3e2255736bc60c,
+not the published npm 0.1.0 artifact. Its vendored tarball integrity is pinned in
+package-lock.json. The upstream library remains independently maintained.
+
+The five bundled Inkpond Glyphs font subsets derive from Source Han Serif SC
+Medium and are licensed under SIL OFL 1.1. They retain their modified names.
+The complete license, copyright and modification notice is shipped in
+lib/licenses/OFL.txt; the upstream code license is in lib/licenses/inkpond-MIT.txt.
+
+React and Cordis are supplied by the DSH host, not bundled into the browser artifact.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: inkpond
+      name: dsh-inkpond

package/lib/build-info.json

@@ -0,0 +1,4 @@
+{
+  "version": "0.2.0",
+  "inkpond": "file:vendor/inkpond-c502ef8.tgz"
+}