dsh-inkpond 0.0.0-stage → 0.1.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,72 @@
+# 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 and a Qingming handscroll are also included.
+
+![Lotus pond behind the DSH composer](docs/images/lotus-light.png)
+
+## 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
+
+Download `dsh-inkpond-0.1.0.tgz` from [Releases](https://github.com/shin4/inkpond-dsh/releases),
+then install the local package through the host plugin manager, or into a regular Web profile:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/dsh-inkpond-0.1.0.tgz
+```
+
+Refresh the page; restart the instance if it does not hot-load. Desktop users should use the app's
+installation UI or its actual profile, which is not necessarily `web`. The tarball is prebuilt and
+does not compile code at installation time.
+
+The intended npm name is `dsh-inkpond`; use the Release tarball until npm publication is available.
+A GitHub source checkout requires `npm ci && npm run build` before installation.
+
+## Preferences
+
+Open Plugins → Installed → dsh-inkpond. Select Lotus pond (default), Misty hills or Qingming handscroll;
+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 `inkpond@0.1.0`.
+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,78 @@
-# 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 会话界面铺一层可交互的汉字水墨背景。
+
+默认是**莲池**：荷叶与荷花之间，鲤鱼缓缓游动。鼠标划过起涟漪，点击空白处落墨。
+可切换山水、清明上河，保留输入区留白、明暗主题跟随及自动性能降级。
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="docs/images/lotus-dark.png" />
+  <img src="docs/images/lotus-light.png" alt="DSH 新会话页面中的莲池背景，输入区域保持留白" width="634" />
+</picture>
+
+## 兼容性
+
+首版验证基线为 **DSH 0.2.1-rc.3**（macOS 官方桌面应用携带的内核，隔离 Web profile）。
+`engines.dsh` 暂时固定该版本；其他版本及 Windows/Linux 尚未验证。
+插件依赖会话容器的语义 DOM 标记，宿主 API 或布局改变时需要重新验证后扩大版本范围。
+
+## 安装
+
+从 [GitHub Releases](https://github.com/shin4/inkpond-dsh/releases) 下载 `dsh-inkpond-0.1.0.tgz`。
+在 DSH 插件管理页通过本地安装包安装，或使用普通 Web profile：
+
+```bash
+dsh plugin --profile web add /absolute/path/to/dsh-inkpond-0.1.0.tgz
+```
+
+刷新页面；若宿主未热加载，重启对应实例。桌面版请使用应用实际 profile 或应用内安装入口，
+不要假定终端的 `web` profile 就是桌面配置。安装包包含构建产物，不执行安装期编译。
+
+npm 包名计划为 `dsh-inkpond`；尚未发布前请使用 Release 安装包。
+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@0.1.0`。
+
+使用独立 `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,12 @@
+# Third-party notices
+
+The browser artifact bundles Inkpond 0.1.0 (https://github.com/shin4/inkpond),
+Copyright (c) 2026 Shin, under the MIT license. Its npm integrity is pinned in
+package-lock.json. The upstream library remains independently maintained.
+
+The three 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.1.0",
+  "inkpond": "0.1.0"
+}