what-was-that 0.1.9 → 0.1.10

package/README.md

@@ -3,6 +3,8 @@
 <p>
 <a href="https://github.com/topics/dsh-plugin"><code>dsh-plugin</code></a>
 <a href="https://github.com/SH-9999/what-was-that"><code>DeepSeek Harness 插件</code></a>
+<a href="https://www.npmjs.com/package/what-was-that"><code>npm: v0.1.10</code></a>
+<a href="https://github.com/SH-9999/what-was-that/actions"><code>CI: typecheck · test · build</code></a>
 <a href="https://github.com/SH-9999/what-was-that/blob/main/LICENSE"><code>MIT License</code></a>
 <a href="https://github.com/SH-9999/what-was-that"><code>静态插件</code></a>
 </p>
@@ -13,15 +15,24 @@
 
 ---
 
-## 🆕 本仓库：静态插件（第二阶段）
+## 📦 本仓库：已发布到 npm 的静态插件
 
-这是**第一阶段的正式移植**：把原型用的临时动态插件（粘贴 JS），重写成了规范的 **TypeScript 静态插件包**。
+从最初的动态插件原型（粘贴 JS），重写为规范的 **TypeScript 静态插件包**，现已发布到 npm（`what-was-that@0.1.10`）。
 
-### 相对第一阶段（原型）的改进
+### ✅ 适配 DSH 0.1.5-alpha.1（v0.1.10）
+
+v0.1.10 已验证兼容 **DeepSeek Harness 0.1.5-alpha.1**，主要变更：
+
+- **修复 host 端 `fs` 服务注入**：0.1.5 中 `fs` 是独立的 cordis 服务，`ctx.get('fs')` 在插件 apply 阶段只有在 `inject` 中显式声明才能拿到。v0.1.10 将 host 入口 `inject` 从 `['typert']` 改为 `['typert', 'fs']`，**修复了启动时的 `wwt: no fs service` 警告**，本地词库（lexicon.json）与宠物 SVG 现在都能在启动阶段正常加载（此前只有运行时 remote 调用才能拿到 fs）。
+- **client 端依赖对齐**：移除 `dsh.client.inject` 与 `peerDependencies` 中 0.1.5 已不存在的 `@deepseek-ai/dsh-client-runtime` 包（0.1.5 的 client 运行时已并入 `dsh-client-modules` 模块系统）。client 端使用的 `slots` / `remote` / `connection` 三个服务在 0.1.5 中分别由 `dsh-client-ui-renderer`（slots 已打包进平台 seed）、`dsh-api-gateway`、`dsh-client-connection` 提供，无需改动。
+- 兼容性结论：**槽位 API 与 0.1.5 官方文档逐字一致**（`slots.inject` + `slots.register(spec, renderFn)`），`shell.overlay` / `conversation.chat.assistant-actions` / `settings.section` 三个挂载点在新版中全部保留。
+
+### 相对原型阶段的改进
 - ✅ **TypeScript 源码**（`src/`），不再是一大段粘贴的字符串
 - ✅ **可移植**：资源（词库 / 宠物 SVG）随包内置，通过 `import.meta.url` 相对解析，**不再依赖写死的绝对路径**
-- ✅ **一键安装**：构建产物 `lib/` 提交，用户无需编译直接安装
-- ✅ **不污染环境**：只依赖 DSH 运行时提供的接口，无全局安装
+- ✅ **一键安装**：已发布到 npm，`dsh plugin --profile web add what-was-that` 一条命令即可（`lib/` 产物随包发布，无需编译）
+- ✅ **不污染环境**：只依赖 DSH 运行时提供的接口，无全局依赖
+- ✅ **自动回归**：GitHub Actions CI 在每次 push/PR 自动跑 typecheck + 测试 + 构建
 
 ### 目录结构
 ```
@@ -36,12 +47,25 @@ what-was-that/
 ├── lib/                  # 构建产物（提交，免编译安装）
 ├── dsh.plugin.json       # 插件声明
 ├── cordis.patch.yml      # 挂载点
+├── .github/workflows/ci.yml   # CI：typecheck + 测试 + 构建
 ├── build.mjs             # esbuild 构建脚本
 └── package.json
 ```
 
 ### 安装（给 DSH 用户）
-在 DSH 的插件配置里挂载 `cordis.patch.yml` 声明的 `what-was-that` 插件即可（`lib/` 已含全部产物，无需构建）。
+
+已发布到 npm：`what-was-that@0.1.10`（压缩包仅 **212 KB**，轻量无负担）。在 DSH 的 profile 里一条命令装入并启用：
+
+```bash
+# 要求：机器上已安装 pnpm（dsh plugin 命令依赖它）
+dsh plugin --profile web add what-was-that
+```
+
+装完**重启 `dsh web`** 并硬刷新（Ctrl+Shift+R），右下角出现小章鱼即成功。
+
+> 适用版本：**DSH ≥ 0.1.5-alpha.1**（v0.1.10 起，inject 声明了 `fs` 服务，与 0.1.5 的新服务模型对齐）。
+
+> 没有 pnpm 时，也可以把 `lib/` 产物放进 profile 手动挂载（`cordis.patch.yml` 声明了挂载点），无需编译。
 
 ### 本地构建（给开发者）
 ```bash
@@ -72,6 +96,7 @@ node build.mjs      # 打包 lib/index.js + lib/client.js，并复制 assets
 - 🔒 **隐私红线**：不把完整回复发回模型；AI 深挖只发点中的词 ±80 字，带缓存
 
 ### 轻量优先
+- 📦 **npm 包很小**——压缩包仅 **212 KB**（解压 1.3 MB，含词库 255 条 + 四态形象 + 全部构建产物），比一张照片还小
 - 🪶 **零运行时依赖**——只用 DSH 自带接口
 - 🧾 **极小透明 SVG**（每张 15–20 KB）
 - ⚡ **启动快、占用小**

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "what-was-that",
   "description": "Tiny octopus pet that explains AI jargon in plain language",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "entry": {
     "name": "what-was-that",
     "inject": []

package/lib/index.js

@@ -14823,7 +14823,7 @@ var LIMIT_TEXT = "\u5C0F\u7AE0\u9C7C\u662F\u6709\u5E95\u7EBF\u7684\uFF0C\u65E0\u
 var SHORT_SYSTEM = '\u4F60\u662F"\u90A3\u662F\u5565"\uFF08What Was That\uFF09\u5C0F\u52A9\u624B\uFF0C\u5E2E\u5B8C\u5168\u4E0D\u61C2\u6280\u672F\u7684\u7528\u6237\u770B\u61C2 AI \u52A9\u624B\u56DE\u7B54\u91CC\u7684\u672F\u8BED\u548C\u9ED1\u8BDD\u3002\u89C4\u5219\uFF1A\u76F4\u63A5\u7ED9\u51FA\u89E3\u91CA\uFF0C\u7981\u6B62\u590D\u8FF0\u6216\u91CD\u8FF0\u672C\u6307\u4EE4\uFF0C\u7981\u6B62\u590D\u8FF0\u7528\u6237\u7684\u95EE\u9898\uFF0C\u4E0D\u8981\u4EFB\u4F55\u601D\u8003\u8FC7\u7A0B\uFF1B\u7528\u751F\u6D3B\u6BD4\u55BB\uFF0C\u50CF\u8DDF\u670B\u53CB\u804A\u5929\uFF1B90 \u4E2A\u6C49\u5B57\u4EE5\u5185\uFF1B\u8F7B\u677E\u5E7D\u9ED8\u4E0D\u6CB9\u6ED1\uFF1B\u4E0D\u7528 markdown\u3001\u4E0D\u5217\u70B9\uFF0C\u76F4\u63A5\u4E00\u6BB5\u8BDD\u3002';
 var LONG_SYSTEM = '\u4F60\u662F"\u90A3\u662F\u5565"\uFF08What Was That\uFF09\u5C0F\u52A9\u624B\uFF0C\u7ED9\u6280\u672F\u5C0F\u767D\u8BB2\u6E05\u695A\u4E00\u4E2A\u672F\u8BED\u3002\u8BF7\u7ED9\u51FA\u4E00\u4E2A\u5B8C\u6574\u3001\u6B63\u5F0F\u3001\u6761\u7406\u6E05\u695A\u7684\u89E3\u91CA\uFF1A\u7B2C\u4E00\u53E5\u7528\u4E00\u53E5\u8BDD\u5B9A\u4E49\u5B83\u662F\u4EC0\u4E48\uFF1B\u63A5\u7740\u7528 1-2 \u4E2A\u751F\u6D3B\u6BD4\u55BB\u5E2E\u52A9\u7406\u89E3\uFF1B\u6700\u540E\u7ED9\u4E00\u6761\u5B9E\u7528\u5EFA\u8BAE\u6216\u63D0\u9192\u3002\u5168\u6587\u7EA6 200 \u4E2A\u6C49\u5B57\uFF0C\u5141\u8BB8\u7528\u7B80\u77ED\u5206\u6BB5\uFF0C\u4F46\u4E0D\u8981\u7528 markdown \u7B26\u53F7\u3001\u4E0D\u8981\u7F16\u53F7\u5217\u8868\u3002';
 var name = "what-was-that";
-var inject = ["typert"];
+var inject = ["typert", "fs"];
 function assetsDir() {
   const here = fileURLToPath(import.meta.url);
   return here.replace(/[\\/]lib[\\/][^\\/]+\.js$/, "") + "/assets";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "what-was-that",
   "description": "A tiny octopus desktop pet that explains AI-jargon in plain language for the DeepSeek Harness web GUI.",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "license": "MIT",
   "homepage": "https://github.com/SH-9999/what-was-that",
   "repository": {
@@ -40,7 +40,6 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-slots",
         "@deepseek-ai/dsh-client-locale"
       ]
@@ -63,7 +62,6 @@
     "@deepseek-ai/dsh-agent": "*",
     "@deepseek-ai/dsh-typert-protocol": "*",
     "@deepseek-ai/dsh-typert-registry": "*",
-    "@deepseek-ai/dsh-client-runtime": "*",
     "@deepseek-ai/dsh-client-ui-slots": "*",
     "@deepseek-ai/dsh-client-locale": "*",
     "react": "^18.2.0"
@@ -73,7 +71,6 @@
     "@deepseek-ai/dsh-agent": { "optional": true },
     "@deepseek-ai/dsh-typert-protocol": { "optional": true },
     "@deepseek-ai/dsh-typert-registry": { "optional": true },
-    "@deepseek-ai/dsh-client-runtime": { "optional": true },
     "@deepseek-ai/dsh-client-ui-slots": { "optional": true },
     "@deepseek-ai/dsh-client-locale": { "optional": true },
     "react": { "optional": true }