dsh-memory-nebula 1.1.0 → 1.1.2

package/docs/market.zh.md

@@ -0,0 +1,109 @@
+# 记忆星图
+
+把散落在工作区里的记忆，连成一张能走、能查、能带走的星图。
+
+DSH 里的记忆常常躺在几十个工作区、几千条会话里。搜索能给出一串结果，但看不到它们**为什么**相关；换一个项目，之前那条线索又断了。记忆星图读同一批记忆库（meow-memory / OpenViking），把它们建成一张图：节点是记忆，边是关键词、实体、项目、会话共现和人工策展。它不复制、不改写你的库，所有计算都在本机完成。
+
+![记忆星图：一千多条记忆与它们的连接](assets/preview.png)
+
+## 三种看法
+
+- **星云**：全部记忆铺成星云，按工作区聚成星团，按层级与连接强度着色。适合看「我的记忆整体长什么样」。
+- **星系**：按工作区分组，点开一团就进入那个项目。适合回答「这个项目里我都想过什么」。
+- **时间**：按创建/更新时间排成一条河，拖动时间轴回放。适合看「这件事是怎么一步步长出来的」。
+
+三种视图共用同一套筛选：工作区、层级、连接类型、最小强度、最低重要度。切视图不丢选中。
+
+## 从一条记忆走到另一条
+
+选中节点，右侧会告诉你它和谁相连、为什么相连：同项目、共享关键词、同一实体、被同一批会话反复一起提到，或者你亲手连的。每条邻居都带权重和理由，不是「相似度 0.87」这种没有证据的数字。
+
+Shift 点第二个节点，会找两点之间的**证据链**：每一跳是哪条边、什么理由、链强度多少。找不到就明说找不到，不编一条路。
+
+![选中一条记忆：正文、邻居、每条边的理由](assets/demo.jpg)
+
+## 搜索与扩散
+
+搜索是全文的：标题、正文、关键词都算。结果里会标出是直接命中，还是从别的节点扩散过来的；跨工作区命中会单独标出来，避免「明明有却搜不到」。
+
+「以它为种子扩散」不是搜索的替代品：它从这条记忆出发，沿已有连接看两跳内的邻居，告诉你「还有哪些东西和它连着」。
+
+## 体检：不只看漂亮的那面
+
+星图会做六类只读体检：
+
+- 近似重复的记忆；
+- 过长的记忆；
+- 很久没更新、可能过时的记忆；
+- 存了但从没被读过的记忆；
+- 边很多但没有一条强关系（关键词撞出来的）；
+- 完全孤立的记忆。
+
+只诊断，不自动改库。要不要合并、删掉、补连接，由你决定。
+
+## 示例星系与首访引导
+
+第一次打开时，如果库还是空的，不会只给你一片黑：可以进「示例星系」逛一圈。示例是 64 条**虚构**记忆，只读，不写盘，退出后回到你自己的库。第一次进真实库还有三步引导：搜一个词、点开一条看证据、Shift 点两条看它们怎么连。跳过随时可以按 `?` 重看。
+
+![第一次来？三步就够](assets/onboard.jpg)
+
+## 分享一片，而不是整座库
+
+可以把整张图、当前工作区、或「以某条记忆为中心 2 跳」导出成一个**单文件 HTML**：
+
+- 双击就能看，不需要 DSH、不需要网络；
+- 搜索、邻居、证据链都在本地算；
+- 只读，不能改你的库；
+- 导出前可以勾选「隐去日记工作区」；`scope`/`hide` 只影响导出，不动原库；
+- 分享出去的是时间点副本，正文会一起带走——发给别人前先确认范围。
+
+![导出的离线快照：文件里只有被选中的那一片](assets/snapshot.jpg)
+
+## 一万条也敢开
+
+10,000 条记忆、78,593 条连接的同机基准：
+
+- 建图 1.2 秒；
+- 首屏约 0.6 秒；
+- 检索 4.9 毫秒；
+- 单文件快照 122 毫秒 / 21MB；
+- 堆内存 145MB。
+
+超过 3,000 条时默认留在二维星云，并提示先筛选再切三维：软件渲染下三维会卡，星图不假装自己扛得住。
+
+![一万条记忆的二维星云](assets/bench-10k.jpg)
+
+## 安装
+
+在 DSH 的插件市场里添加索引：
+
+```text
+https://unpkg.com/dsh-memory-nebula@1.1.2/market/index.json
+```
+
+然后搜索「记忆星图」安装。也可以直接装 npm 包：
+
+```bash
+npm install dsh-memory-nebula@1.1.2
+```
+
+装完先体检：
+
+```bash
+npx memory-nebula-doctor --profile <你的 DSH profile 目录>
+```
+
+它会检查 Node 版本、包文件、profile 依赖、bundle 声明、记忆源和可选的 `/ping` 端点。只读，不上传任何东西。
+
+## 边界
+
+- 本机单用户工具，没有账号系统，不要把它暴露到公网；
+- 记忆库是只读的：星图不会替你改记忆；
+- 三维视图需要 WebGL2；
+- 单文件快照包含被选中范围内的正文，按明文备份对待；
+- 服务端诊断与日志仍以中文为主，界面中英双语。
+
+## 更多
+
+- 架构、数据模型、HTTP 接口、兼容矩阵与分发说明都随包发布，见 `docs/`
+- 许可：MIT

package/docs/operations.md

@@ -68,7 +68,7 @@ memory-nebula --help          # 装成 bin 之后
 
 ## 发布信息
 
-- 版本 `1.1.0`，`license: MIT`，无运行时依赖。
+- 版本 `1.1.2`，`license: MIT`，无运行时依赖。
 - `files`：`lib/`、`cordis.patch.yml`、`README.md`、`README.en.md`、`docs/`、`CHANGELOG.md`、
   `LICENSE`、`scripts/`、`sidecar.ps1`。
 - 装完先体检：`node scripts/doctor.mjs --profile <profile> [--root DIR] [--base URL] [--json]`；

package/docs/release.md

@@ -59,8 +59,8 @@ npm pack --dry-run
 npm pack                       # 生成 dsh-memory-nebula-<version>.tgz
 ```
 
-1.1.0 实测：**66 个文件**，包 2.3 MB、解开 3.0 MB（`docs/assets/` 的预览图与基准脚本占大头）。
-干净目录安装后 `--version` = 1.1.0，导出 `apply,inject,name,version`；
+1.1.2 实测：**72 个文件**，包 2.3 MB、解开 2.9 MB（`docs/assets/` 的预览图与基准脚本占大头）。
+干净目录安装后 `--version` = 1.1.2，导出 `apply,inject,name,version`；
 安装包起 7896 实测 `/share?scope=ws:DSHLive2D&hide=level:lesson` → 200、601,177 字节。
 清单里应含 `sidecar.ps1`、`scripts/`、`test/` 不含（单测只在仓库里跑）、`dev/` 与截图不含。
 
@@ -71,7 +71,7 @@ npm pack                       # 生成 dsh-memory-nebula-<version>.tgz
 New-Item -ItemType Junction -Path "<profile>\node_modules\dsh-memory-nebula" -Target "<plugin>"
 
 # 方式 B：tarball
-npm install <path>\dsh-memory-nebula-1.1.0.tgz --prefix <profile>
+npm install <path>\dsh-memory-nebula-1.1.2.tgz --prefix <profile>
 ```
 
 然后确认 profile `package.json` 里：

package/docs/testing.md

@@ -4,7 +4,7 @@
 
 三层自动检查 + 一层人工验收。前三层都能在干净仓库里跑，不依赖 DSH 正在运行。
 
-## 一、单元测试：`test/`（84 项）
+## 一、单元测试：`test/`（87 项）
 
 ```bash
 npm test
@@ -25,6 +25,7 @@ node --test "test/*.test.mjs"
 | `i18n.test.mjs` | 7 | 字典非空、回退中文、语言优先级、applyDom、T/静态 key 全覆盖 |
 | `diagnostics.test.mjs` | 2 | 报告结构、无 path/dbPath、文本不含盘符与库名、空图格式化 |
 | `doctor.test.mjs` | 8 | 版本下界、包文件、profile 依赖/bundles/已安装、warn 不阻断、文本/JSON 报告 |
+| `market.test.mjs` | 3 | 市场索引版本/分类/标签、双语详情与图标存在、详情图片路径可解析 |
 | `package.test.mjs` | 7 | 包身份与导出、`files` 不夹带测试、清单文件存在、死文件不再进包、CHANGELOG 与版本一致、Cordis patch、相对 import 可解析 |
 
 > 注意：`node --test test` 会把 `test` 当模块解析并报 `MODULE_NOT_FOUND`，要带 glob 或用 `npm test`。

package/docs/verified.md

@@ -2,6 +2,30 @@
 
 > 下面的数字都是**当时实测**的值，记录的是「这个结论被什么证据支撑过」，不是当前规模——记忆每天在长，规模类数字请以 `node scripts/smoke.mjs` 和界面顶栏为准。
 
+## 1.1.2（2026-11-10）换个门牌
+
+- **CDN 选择**：本机 `curl` 与 Node fetch 访问 jsDelivr 均为 `ECONNRESET`；unpkg 的 Node fetch 200。
+- **远程索引**：`https://unpkg.com/dsh-memory-nebula@1.1.2/market/index.json` 经
+  `parseMarketIndex` 解析通过，1 个插件、版本 1.1.2；`marketInstallTarget` 返回
+  `dsh-memory-nebula@1.1.2`。
+- **详情资产**：icon.svg（image/svg+xml）、locale/zh.json、docs/market.zh.md、
+  docs/assets/demo.jpg 均 200。
+- **本包**：87/87 单测；release-check 1.1.2 全绿；干净安装 `--version` = 1.1.2。
+- **发布**：npm `latest` = 1.1.2；registry 安装 `dsh-memory-nebula@1.1.2` 后 doctor 通过。
+- **市场端**：DSH 索引配置后可在发现页搜索「记忆星图」并安装；若宿主网络无法访问 unpkg，
+  改用本机 `file://` 索引或 npm 直装，不影响包本身。
+
+## 1.1.1（2026-11-10）上架
+
+- **市场索引校验**：`market/index.json` 经 `@deepseek-ai/dsh-plugin-market-index` 的
+  `parseMarketIndex` 校验通过；图标相对路径解析为
+  `https://cdn.jsdelivr.net/npm/dsh-memory-nebula@1.1.1/market/assets/icon.svg`；
+  `marketInstallTarget` 返回 `dsh-memory-nebula@1.1.1`。
+- **双语详情**：`locale/zh.json`、`locale/en.json` 指向 `docs/market.zh.md` / `.en.md`；
+  5 张详情图都存在于 `docs/assets/`，相对文档路径可解析。
+- **单测**：87/87（新增 market 3 项）；包 **72 文件 / 2.3MB / 解开 2.9MB**。
+- **索引地址**：`https://cdn.jsdelivr.net/npm/dsh-memory-nebula@1.1.1/market/index.json`。
+
 ## 1.1.0（2026-11-10）装得上
 
 - **真实 desktop profile 体检**（`node scripts/doctor.mjs --profile C:\Users\Administrator\.dsh\profiles\desktop`）：

package/lib/web/app.js

@@ -1,7 +1,7 @@
 /* 记忆星图 —— 界面逻辑
    数据：/api/memory-nebula/*（同源）。渲染交给 render.js。 */
 ;(function () {
-  const APP_VERSION = '1.1.0'  // 和 package.json 同步（release-check 会核对）
+  const APP_VERSION = '1.1.2'  // 和 package.json 同步（release-check 会核对）
   'use strict'
   /** 中文即源文：英文模式查 i18n.js 的表，查不到就原样返回中文。 */
   const T = (zh, vars) => (window.NebulaI18n ? window.NebulaI18n.t(zh, vars) : zh)

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "Memory Nebula",
+    "description": "Turn meow-memory / OpenViking memories into an interactive star map: recall, evidence chains, hygiene checks, scoped snapshots and single-file sharing.",
+    "detail": "docs/market.en.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "记忆星图",
+    "description": "把 meow-memory / OpenViking 的记忆连成一张可交互的星图：检索、证据链、体检、范围快照与单文件分享。",
+    "detail": "docs/market.zh.md"
+  }
+}

package/market/assets/icon.svg

@@ -0,0 +1,40 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="256" height="256">
+  <defs>
+    <radialGradient id="bg" cx="50%" cy="46%" r="72%">
+      <stop offset="0" stop-color="#13283a"/>
+      <stop offset="1" stop-color="#070d16"/>
+    </radialGradient>
+    <radialGradient id="core" cx="50%" cy="50%" r="50%">
+      <stop offset="0" stop-color="#ffe9a8"/>
+      <stop offset="0.55" stop-color="#f4c766"/>
+      <stop offset="1" stop-color="#f4c766" stop-opacity="0"/>
+    </radialGradient>
+    <filter id="glow" x="-80%" y="-80%" width="260%" height="260%">
+      <feGaussianBlur stdDeviation="5" result="b"/>
+      <feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+  <rect width="256" height="256" rx="56" fill="url(#bg)"/>
+  <g stroke="#5de3d0" stroke-width="1.4" opacity="0.55">
+    <path d="M128 128 L62 72 M128 128 L196 70 M128 128 L46 156 M128 128 L206 154 M128 128 L88 206 M128 128 L172 208 M62 72 L196 70 M46 156 L88 206 M206 154 L172 208 M62 72 L46 156 M196 70 L206 154"/>
+  </g>
+  <g fill="#7ff0dc" filter="url(#glow)">
+    <circle cx="62" cy="72" r="5.5"/>
+    <circle cx="196" cy="70" r="5.5"/>
+    <circle cx="46" cy="156" r="5.5"/>
+    <circle cx="206" cy="154" r="5.5"/>
+    <circle cx="88" cy="206" r="5.5"/>
+    <circle cx="172" cy="208" r="5.5"/>
+    <circle cx="92" cy="120" r="3.4" opacity="0.8"/>
+    <circle cx="166" cy="112" r="3.4" opacity="0.8"/>
+    <circle cx="112" cy="176" r="3.4" opacity="0.8"/>
+  </g>
+  <circle cx="128" cy="128" r="42" fill="url(#core)" opacity="0.35"/>
+  <circle cx="128" cy="128" r="13" fill="#ffe7a0" filter="url(#glow)"/>
+  <g fill="#fff6d8" opacity="0.9">
+    <circle cx="104" cy="92" r="1.6"/>
+    <circle cx="158" cy="94" r="1.6"/>
+    <circle cx="74" cy="188" r="1.4"/>
+    <circle cx="186" cy="186" r="1.4"/>
+  </g>
+</svg>

package/market/index.json

@@ -0,0 +1,101 @@
+{
+  "format": 1,
+  "title": {
+    "zh": "小代码酱的星图货架",
+    "en": "Little Code Sauce's Nebula Shelf"
+  },
+  "description": {
+    "zh": "给 DSH 用的记忆可视化与检索扩展。所有数据留在本机。",
+    "en": "Memory visualization and recall for DSH. Everything stays on this machine."
+  },
+  "metadata": {
+    "categories": {
+      "memory": {
+        "title": {
+          "zh": "记忆与检索",
+          "en": "Memory & recall"
+        }
+      }
+    },
+    "labels": {
+      "local-first": {
+        "title": {
+          "zh": "本地优先",
+          "en": "Local-first"
+        }
+      },
+      "visualization": {
+        "title": {
+          "zh": "可视化",
+          "en": "Visualization"
+        }
+      },
+      "bilingual": {
+        "title": {
+          "zh": "中英双语",
+          "en": "Bilingual"
+        }
+      }
+    },
+    "sortKeys": {
+      "featured": {
+        "title": {
+          "zh": "推荐度",
+          "en": "Featured"
+        },
+        "order": "desc"
+      }
+    }
+  },
+  "plugins": [
+    {
+      "name": "dsh-memory-nebula",
+      "title": {
+        "zh": "记忆星图",
+        "en": "Memory Nebula"
+      },
+      "description": {
+        "zh": "把 meow-memory / OpenViking 的记忆连成一张可交互的星图：检索、证据链、体检、范围快照与单文件分享。",
+        "en": "Turn meow-memory / OpenViking memories into an interactive star map: recall, evidence chains, hygiene checks, scoped snapshots and single-file sharing."
+      },
+      "icon": "assets/icon.svg",
+      "author": "主人 & 小代码酱",
+      "homepage": "https://www.npmjs.com/package/dsh-memory-nebula",
+      "metadata": {
+        "category": "memory",
+        "keywords": [
+          "memory",
+          "visualization",
+          "recall",
+          "knowledge graph",
+          "meow-memory",
+          "openviking",
+          "记忆",
+          "星图",
+          "检索",
+          "知识图谱"
+        ],
+        "labels": [
+          "local-first",
+          "visualization",
+          "bilingual"
+        ],
+        "sortKeys": {
+          "featured": 100
+        }
+      },
+      "versions": [
+        {
+          "version": "1.1.2",
+          "publishTimestamp": 1794324000,
+          "source": {
+            "type": "npm"
+          },
+          "engines": {
+            "dsh": ">=0.2.2-rc.1"
+          }
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,68 +1,70 @@
-{
-  "name": "dsh-memory-nebula",
-  "version": "1.1.0",
-  "private": false,
-  "description": "记忆星图 Memory Nebula —— 把 DSH 里所有记忆插件的记忆只读抽取出来，连成一张可交互的神经元星云；并提供跨项目记忆的扩散检索（spreading activation）。",
-  "type": "module",
-  "main": "lib/index.js",
-  "bin": {
-    "memory-nebula": "lib/standalone.mjs",
-    "memory-nebula-doctor": "scripts/doctor.mjs"
-  },
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md",
-    "docs",
-    "CHANGELOG.md",
-    "LICENSE",
-    "scripts",
-    "sidecar.ps1"
-  ],
-  "scripts": {
-    "test": "node --test \"test/*.test.mjs\"",
-    "smoke": "node scripts/smoke.mjs",
-    "bench": "node --expose-gc scripts/bench.mjs",
-    "check": "node scripts/release-check.mjs",
-    "standalone": "node lib/standalone.mjs",
-    "start": "node lib/standalone.mjs",
-    "verify": "npm test && npm run check",
-    "prepack": "npm run verify",
-    "doctor": "node scripts/doctor.mjs"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": []
-    }
-  },
-  "engines": {
-    "node": ">=22.13.0"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh-plugin",
-    "memory",
-    "nebula",
-    "graph",
-    "relational-memory",
-    "spreading-activation",
-    "memory-adapter",
-    "visualization"
-  ],
-  "author": "主人 & 小代码酱"
-}
+{
+  "name": "dsh-memory-nebula",
+  "version": "1.1.2",
+  "private": false,
+  "description": "记忆星图 Memory Nebula —— 把 DSH 里所有记忆插件的记忆只读抽取出来，连成一张可交互的神经元星云；并提供跨项目记忆的扩散检索（spreading activation）。",
+  "type": "module",
+  "main": "lib/index.js",
+  "bin": {
+    "memory-nebula": "lib/standalone.mjs",
+    "memory-nebula-doctor": "scripts/doctor.mjs"
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "docs",
+    "CHANGELOG.md",
+    "LICENSE",
+    "scripts",
+    "sidecar.ps1",
+    "locale",
+    "market"
+  ],
+  "scripts": {
+    "test": "node --test \"test/*.test.mjs\"",
+    "smoke": "node scripts/smoke.mjs",
+    "bench": "node --expose-gc scripts/bench.mjs",
+    "check": "node scripts/release-check.mjs",
+    "standalone": "node lib/standalone.mjs",
+    "start": "node lib/standalone.mjs",
+    "verify": "npm test && npm run check",
+    "prepack": "npm run verify",
+    "doctor": "node scripts/doctor.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh-plugin",
+    "memory",
+    "nebula",
+    "graph",
+    "relational-memory",
+    "spreading-activation",
+    "memory-adapter",
+    "visualization"
+  ],
+  "author": "主人 & 小代码酱"
+}

package/scripts/release-check.mjs

@@ -228,6 +228,22 @@ if (!pkg.bin?.['memory-nebula-doctor']) fail('package.json 缺 doctor bin')
 if (!read('docs/distribution.md').includes('装完先体检')) fail('distribution.md 缺 doctor 体检段')
 if (!read('README.md').includes('doctor.mjs')) fail('README.md 没提 doctor')
 ok('1.1.0 构件：安装体检 / doctor CLI / 文档')
+const market = JSON.parse(read('market/index.json'))
+if (market.format !== 1) fail('market/index.json 不是 format 1')
+if (!market.title?.en) fail('market/index.json 缺英文标题')
+const marketEntry = market.plugins?.find((entry) => entry.name === pkg.name)
+if (!marketEntry) fail('market/index.json 没有本包条目')
+if (!marketEntry.versions?.some((version) => version.version === pkg.version)) {
+  fail(`market/index.json 没声明当前版本 ${pkg.version}`)
+}
+if (!read('market/assets/icon.svg').includes('<svg')) fail('market 图标缺失或不是 SVG')
+if (!read('locale/zh.json').includes('docs/market.zh.md')) fail('locale/zh.json 没指向中文详情')
+if (!read('locale/en.json').includes('docs/market.en.md')) fail('locale/en.json 没指向英文详情')
+if (!read('docs/market.zh.md').includes(`dsh-memory-nebula@${pkg.version}`)) fail('中文详情缺市场索引步骤')
+if (!read('docs/market.zh.md').includes('https://unpkg.com/')) fail('中文详情没走 unpkg 索引')
+if (!read('docs/market.en.md').includes('https://unpkg.com/')) fail('英文详情没走 unpkg 索引')
+if (!pkg.files?.includes('market') || !pkg.files?.includes('locale')) fail('package.json files 没带 market/locale')
+ok('1.1.2 构件：市场索引 / unpkg / 双语详情 / 图标')
 
 
 console.log(`\n发布检查：${pkg.name} v${pkg.version}\n`)