dlaoshi-outfit 0.0.0-stage → 2.1.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## 2.1.0 — 2026-10-22
+
+发布到 npm，安装只需一行。
+
+- 包名从 `@local/dsh-fatfish-outfit` 改为 **`dlaoshi-outfit`**（可在 npm 与 DSH 插件市场搜索安装）
+- `cordis.patch.yml` 的插件名同步为 `dlaoshi-outfit`
+- `package.json` 增加 `files` 白名单与 `publishConfig`，npm 包只带运行必需文件
+- README 安装章节改为「一条命令 / GitHub / 手动」三种方式
+- 市场描述关键词调整为：鲸鱼正太、女仆装、二次元
+
+> 从 `@local/...` 升级的用户：先卸载旧条目（`dsh plugin remove @local/dsh-fatfish-outfit`），再装 `dlaoshi-outfit`。
+
+## 2.0.1 — 2026-10-22
+
+文档与协作设施补全（无功能变更）。
+
+- 新增 `CONTRIBUTING.md`、`SECURITY.md`
+- 新增 Issue 模板（Bug 报告 / 功能请求）与 PR 模板
+- README 增加 CI / License / 插件 / Release 徽章与发布包入口
+- 首个 GitHub Release 与发布包 `dlaoshi-outfit-opensource.zip`
+
+## 2.0.0 — 2026-10-22
+
+第一个公开版本。
+
+- **桌宠**：4 种表情、自由拖拽、位置记忆、点击切换、状态联动
+- **右下角立牌**：每轮结束弹出 token 消耗与思考时间气泡；点击 q 弹 + 气泡膜音效 + 独立余额气泡
+- **聊天皮肤**：背景壁纸、液态玻璃输入框；消息区改为纯文字（无玻璃、无黑色气泡）
+- **设置开关**：设置 › 通用 里一键启用/禁用整套外观，状态持久化
+- **宿主统计**：`session/event` + `llm/stream` 采集，`/fatfish/*` 回环路由
+- **测试**：四套无浏览器行为测试 + GitHub Actions CI
+- **工具**：抠图、壁纸生成、素材内联脚本
+
+## 1.0.0
+
+内部初版：桌宠形象替换、四表情、侧栏头像与开屏立绘。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 use3346631993
+
+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/NOTICE

@@ -0,0 +1,22 @@
+NOTICE — artwork and character
+
+The MIT license in LICENSE covers the source code of this plugin only.
+
+Character artwork
+-----------------
+The character illustrations under `assets/` (and the copies inlined into
+`client.js`) were supplied by the plugin author. They are distributed here for
+use together with this plugin; they are NOT covered by the MIT license.
+
+If you want to redistribute the artwork itself — in another project, a fork
+with a different character, or a commercial product — please confirm the
+original artwork's license with its author first.
+
+If the artwork was generated by you (for example with an image model you have
+rights to use), you may replace this notice with whatever license you prefer,
+such as CC BY 4.0.
+
+Third-party assets
+------------------
+This package embeds no third-party fonts, icons or images. Everything visual is
+either the author's artwork or plain CSS.

package/README.en.md

@@ -0,0 +1,79 @@
+# Dlaoshi Outfit — a desktop pet & glass theme for DeepSeek Harness
+
+A draggable anime desktop pet (a maid-outfit character), a bottom-right standee that
+reports each turn's token usage and thinking time, a chat wallpaper, a liquid-glass
+composer, and a deep-sea blue theme — all in one zero-dependency DSH plugin.
+
+![preview](docs/preview.png)
+
+## Features
+
+- **Floating pet** with four expressions, free dragging, remembered position
+- **State machine**: thinking while streaming, happy on success, sad on failure
+- **Click to cycle** expressions, with speech bubbles and idle expiry
+- **Corner standee**: a thought bubble after every turn with token usage and think latency
+- **Poke the standee**: springy squish, bubble-wrap "pop", wallet balance in its own bubble
+- **Chat wallpaper** with a theme-aware veil so text stays readable
+- **Liquid glass** composer; messages stay plain text over the wallpaper
+- **One switch** in Settings › General to enable or disable the whole look
+
+## Install
+
+### A. One command (recommended)
+
+```powershell
+dsh plugin add dlaoshi-outfit
+```
+
+Or in DSH: **Settings → Plugins → Add plugin** and enter `dlaoshi-outfit`, then restart DSH.
+
+### B. From GitHub
+
+```
+https://github.com/use3346631993/dlaoshi-outfit.git
+```
+
+### C. Manual (offline)
+
+1. Copy the repository into your DSH profile's `node_modules`:
+
+   ```powershell
+   git clone https://github.com/<you>/dlaoshi-outfit.git C:\Users\you\Documents\dlaoshi-outfit
+   New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dlaoshi-outfit"
+   Copy-Item "C:\Users\you\Documents\dlaoshi-outfit\*" "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dlaoshi-outfit" -Recurse -Force
+   ```
+
+2. Add the plugin to `%USERPROFILE%\.dsh\profiles\desktop\package.json`:
+
+   ```json
+   {
+     "dsh": { "profile": { "bundles": ["dlaoshi-outfit"] } },
+     "dependencies": { "dlaoshi-outfit": "file:C:/Users/you/Documents/dlaoshi-outfit" }
+   }
+   ```
+
+   (Keep your existing bundles and dependencies — see `examples/profile.package.json`.)
+
+3. Fully quit and restart DeepSeek Harness.
+
+## Usage
+
+- Drag the pet anywhere; the position persists.
+- Click the pet to cycle expressions; it returns to its calm face on its own.
+- Click the corner standee: squish, pop, balance bubble.
+- Toggle the whole outfit in **Settings › General › “D老师” Theme**.
+
+## Development
+
+```powershell
+npm run check
+npm test
+```
+
+The tests run without a browser: fake DOM, fake React, a virtual clock and a fake
+Cordis context drive the real handlers and host logic.
+
+## License
+
+- Code: MIT — see `LICENSE`
+- Character artwork: provided by the author, **not** covered by MIT — see `NOTICE`

package/README.md

@@ -1,3 +1,169 @@
-# Temporary Holding Version
+# 「D老师」桌宠 · DeepSeek Harness 主题插件
 
-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 插件。
+
+> 一个插件、一个开关：不想要的时候滑一下，DSH 立刻回到原样。
+
+[![test](https://github.com/use3346631993/dlaoshi-outfit/actions/workflows/ci.yml/badge.svg)](https://github.com/use3346631993/dlaoshi-outfit/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/dlaoshi-outfit.svg)](https://www.npmjs.com/package/dlaoshi-outfit)
+[![DeepSeek Harness plugin](https://img.shields.io/badge/DeepSeek%20Harness-plugin-1E4D8F.svg)](https://github.com/use3346631993/dlaoshi-outfit)
+[![release](https://img.shields.io/badge/release-v2.1.0-2F55E0.svg)](https://github.com/use3346631993/dlaoshi-outfit/releases/latest)
+
+> **不想看源码？** 一条命令搞定：`dsh plugin add dlaoshi-outfit`
+
+![预览](docs/preview.jpg)
+
+![预览](docs/preview.jpg)
+
+## 功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 🐟 浮动桌宠 | 4 种表情（默认 / 开心 / 思考 / 失望），可自由拖拽，位置会记住 |
+| 🎯 状态联动 | 自动跟随对话：流式输出时进入思考态，成功转开心，报错转失望 |
+| 🖱️ 点击互动 | 单击切换表情（会自己回到默认），带语音气泡与"别戳啦"等台词 |
+| 🪧 右下角立牌 | 常驻右下角，每轮结束弹出气泡：**本次 token 消耗**、**思考时间** |
+| 🫧 点击立牌 | q 弹回弹 + 气泡膜"啵"声 + 单独一个余额气泡（读取官方 `deepseekAccount`） |
+| 🖼️ 聊天背景 | 用你自己的插画做会话区壁纸，主题自适应蒙版保证可读性 |
+| 🧊 液态玻璃 | 输入框磨砂玻璃 + 高光描边（不再有黑气泡，消息为纯文字） |
+| ⚙️ 主题开关 | 设置 › 通用 里的滑动开关：一键启用 / 禁用整套外观 |
+
+## 安装
+
+前置：已安装 **DeepSeek Harness（桌面版）**，并至少启动过一次（生成了 profile）。
+
+### 方式 A：一条命令（推荐）
+
+```powershell
+dsh plugin add dlaoshi-outfit
+```
+
+或者在 DSH 里打开 **设置 → 插件 → 添加插件**，填：
+
+```
+dlaoshi-outfit
+```
+
+装完**完全退出并重启** DSH。
+
+### 方式 B：从 GitHub 装
+
+```
+https://github.com/use3346631993/dlaoshi-outfit.git
+```
+
+### 方式 C：手动（离线 / 网络不好时）
+
+1. 把本仓库复制到 profile 的 `node_modules\dlaoshi-outfit`：
+
+```powershell
+git clone https://github.com/use3346631993/dlaoshi-outfit.git C:\Users\你\Documents\dlaoshi-outfit
+mkdir "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dlaoshi-outfit" -Force
+Copy-Item "C:\Users\你\Documents\dlaoshi-outfit\*" `
+  "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dlaoshi-outfit" -Recurse -Force
+```
+
+2. 编辑 `%USERPROFILE%\.dsh\profiles\desktop\package.json`：
+
+```json
+{
+  "dsh": {
+    "profile": {
+      "bundles": [
+        "@deepseek-ai/dsh-base",
+        "@deepseek-ai/dsh-web-app",
+        "dlaoshi-outfit"
+      ]
+    }
+  },
+  "dependencies": {
+    "dlaoshi-outfit": "file:C:/Users/你/Documents/dlaoshi-outfit"
+  }
+}
+```
+
+> 完整示例见 [`examples/profile.package.json`](examples/profile.package.json)。
+
+3. 重启 DSH。右下角出现桌宠即安装成功。
+
+## 使用
+
+- **拖动**：按住桌宠拖到任意位置，松手即停留，下次启动还在原地
+- **点击桌宠**：依次切换 开心 → 思考 → 失望 → 默认，几秒无操作自动回默认
+- **点击右下角立牌**：q 弹一下、响一声气泡膜"啵"、弹出余额气泡
+- **主题开关**：设置 › 通用 › 「D老师」主题
+
+  ![设置里的主题开关](docs/settings.png)
+
+  - **开**：壁纸 + 液态玻璃 + 桌宠 + 立牌 + 侧栏头像
+  - **关**：以上全部隐藏，恢复 DSH 原始界面（开关状态会记住）
+
+## 兼容性
+
+- 只依赖 DSH 自带的 Client 运行时与官方 `deepseekAccount` 能力，**无第三方依赖**
+- 客户端 bundle 单文件自包含：所有图片内联为 data URI，不需要联网加载素材
+- 宿主路由仅监听 **回环地址**（`127.0.0.1`），不对外暴露
+- 余额只在点击立牌时读取，结果缓存 60 秒
+- 若 DSH 版本较旧、没有 `settings.general.item` 槽位：开关不显示，其余功能照常
+
+## 目录结构
+
+```
+.
+├── client.js              # 浏览器端：桌宠 + 立牌 + 主题皮肤 + 设置开关
+├── index.js               # 宿主端：turn 统计 + /fatfish/* 路由
+├── package.json           # 插件清单
+├── cordis.patch.yml       # bundle patch，让 DSH 自动挂载
+├── assets/                # 原始立绘（运行时不需要，改素材用）
+├── tools/                 # 抠图 / 生成壁纸 / 内联素材脚本
+├── test/                  # 无浏览器行为的 Node 测试
+├── docs/                  # 截图与技术说明
+└── examples/              # profile 配置示例
+```
+
+## 开发
+
+```powershell
+npm run check   # 语法检查
+npm test        # 四套行为测试（表情循环 / 状态机 / 立牌气泡 / 宿主统计）
+```
+
+测试不依赖浏览器：它们用假的 DOM、假的 `React`、虚拟时钟和假的 Cordis 上下文，
+直接驱动真实的 handler 与宿主逻辑。
+
+### 更换素材
+
+```powershell
+# 1) 从插画里抠出立牌（透明背景）
+python tools/cut_portrait.py path/to/your-art.png
+# 2) 生成 1600px 宽的聊天壁纸
+python tools/make_wallpaper.py path/to/your-art.png
+# 3) 重新内联进 client.js（会改写 client.js 里的 __SPRITE_*__ 占位）
+python tools/inline_sprites.py
+```
+
+依赖：Python 3 + Pillow + numpy。
+
+## 技术要点
+
+详见 [`docs/architecture.md`](docs/architecture.md)。
+
+- **单文件客户端**：DSH 的模块表只解析包根 specifier，所以图片必须内联
+- **不抢事件**：立牌是桌宠拖拽层的子节点，指针事件显式拦截，点击不会被拖拽吞掉
+- **动画可重播**：q 弹用两套同名不同名的 keyframes 交替，保证每次点击都从头播
+- **玻璃不闪屏**：`backdrop-filter` 放在 `::before` 图层，光标闪烁不再触发背景重采样
+- **开关可回退**：所有皮肤规则挂在 `html.dlao-skin-on` 下，关掉即恢复原生界面
+
+## 许可
+
+- **代码**：MIT，见 [`LICENSE`](LICENSE)
+- **角色立绘**：由作者提供，**不包含在 MIT 授权内**，见 [`NOTICE`](NOTICE)
+
+如果你要再分发角色形象，请先确认原画授权。
+
+## 致谢
+
+- [DeepSeek Harness](https://github.com/deepseek-ai) 的插件体系与官方 `deepseekAccount` 能力
+- 灵感来自各类「桌面宠物 + 状态气泡」实现