@jiugeqqqqq/dsh-house 0.2.0 → 0.2.2

package/README.md

@@ -102,6 +102,22 @@ dsh plugin --profile web add @jiugeqqqqq/dsh-house
 
 默认就是空的，正常不用动。
 
+## 更新
+
+```powershell
+dsh plugin --profile desktop add @jiugeqqqqq/dsh-house@latest
+```
+
+重启 DSH 生效。
+
+**自动检测**：插件每天查一次 npm（配置项 `updateCheck`，默认开）。有新版本时：
+
+- `<DSH_HOME>/plugin-updates.json` 里记一条
+- 日志里写一行
+- 侧边栏「房子」页标题旁显示 `v0.2.1 → 0.3.0 可更新`
+
+**它不会自动安装** —— DSH 没有热重载，装了也要重启；运行时替换自己的代码风险不值得。
+
 ## 常见问题
 
 **Q：页面空白 / 显示"解析不出条目"？**

package/lib/client.js

@@ -227,6 +227,13 @@ window.__ModuleLoader__.load({
           React.createElement('h1', { style: styles.title }, '房子'),
           React.createElement('span', { style: styles.sub }, '常驻的资产与能力清单'),
           React.createElement('span', { style: styles.note }, '共 ' + String(total) + ' 条'),
+          s.data && s.data.version
+            ? React.createElement(
+                'span',
+                { style: Object.assign({}, styles.note, s.data.updateAvailable ? { color: '#e0a030' } : null) },
+                'v' + s.data.version + (s.data.updateAvailable ? ' → ' + s.data.latest + ' 可更新' : ''),
+              )
+            : null,
         ),
       );
 

package/lib/host/index.js

@@ -17,10 +17,19 @@ import { readFile, writeFile, mkdir, copyFile } from 'node:fs/promises';
 import fs from 'node:fs';
 import zlib from 'node:zlib';
 import path from 'node:path';
+import { createUpdateChecker } from '../update-check.js';
 
 export const name = 'house';
 export const inject = [];
 
+const pkgVersion = (() => {
+  try {
+    return JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+})();
+
 const ROUTE_PREFIX = '/dsh-house/api';
 
 function writeJson(response, status, payload) {
@@ -102,6 +111,19 @@ export function apply(ctx, config = {}) {
       ? config.sessionsDir
       : path.join(dshHome, 'sessions');
 
+  // 版本自检：只查 npm 有没有新版，不自动安装。
+  // 注意：本地开发目录的 package.json name 是 dsh-house，而 npm 上是 scoped 包，所以写死 npmName。
+  const updateChecker = createUpdateChecker({
+    npmName: '@jiugeqqqqq/dsh-house',
+    version: pkgVersion,
+    log: (m) => ctx.logger?.info('dsh-house: ' + m),
+    enabled: config.updateCheck !== false,
+  });
+  const updateTimer = setTimeout(() => {
+    updateChecker.check().catch(() => {});
+  }, 15000);
+  updateTimer.unref?.();
+
   // 房子清单不存在时自动建一份模板：别人装完第一次打开页面就有东西可看，
   // 不会像 2026-10-26 那样提示「读不到房子清单」。
   const TEMPLATE = [
@@ -425,7 +447,19 @@ export function apply(ctx, config = {}) {
 
             try {
               if (method === 'list') {
-                writeJson(response, 200, await loadAssets());
+                const result = await loadAssets();
+                if (result.ok && result.data) {
+                  const u = updateChecker.get() || {};
+                  result.data.version = pkgVersion;
+                  result.data.latest = u.latest || '';
+                  result.data.updateAvailable = u.updateAvailable === true;
+                }
+                writeJson(response, 200, result);
+                return;
+              }
+              if (method === 'checkUpdate') {
+                const rec = await updateChecker.check({ force: true });
+                writeJson(response, 200, { ok: true, data: { ...(rec || {}), version: pkgVersion } });
                 return;
               }
               if (method === 'read') {

package/lib/update-check.js

@@ -0,0 +1,116 @@
+// dsh-affection —— 版本更新检查（自动检测 npm 上有没有新版本）
+//
+// 只做「检测 + 报告」，不擅自替换自己的代码：DSH 没有热重载，
+// 插件在运行中改自己的文件也只会下次重启才生效，风险不值得。
+//
+// 结果写到 <DSH_HOME>/plugin-updates.json，页面/日志都能读：
+//   { "dsh-affection": { current, latest, updateAvailable, checkedAt, lastError? } }
+//
+// 频率：默认每 24 小时查一次；失败也记录时间，避免离线时每步重试。
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+/** '0.10.2' vs '0.9.9' → 1；相等 0；更小 -1。忽略预发布后缀。 */
+export function compareVersions(a, b) {
+  const parse = (v) =>
+    String(v || '')
+      .trim()
+      .replace(/^v/i, '')
+      .split('-')[0]
+      .split('.')
+      .map((x) => Number.parseInt(x, 10) || 0);
+  const pa = parse(a);
+  const pb = parse(b);
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const x = pa[i] || 0;
+    const y = pb[i] || 0;
+    if (x > y) return 1;
+    if (x < y) return -1;
+  }
+  return 0;
+}
+
+export function createUpdateChecker({
+  npmName,
+  version,
+  log,
+  enabled = true,
+  intervalHours = 24,
+  registry = 'https://registry.npmjs.org',
+}) {
+  const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+  const statePath = path.join(dshHome, 'plugin-updates.json');
+
+  function readState() {
+    try {
+      const j = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+      return j && typeof j === 'object' ? j : {};
+    } catch {
+      return {};
+    }
+  }
+
+  function writeState(state) {
+    try {
+      fs.mkdirSync(path.dirname(statePath), { recursive: true });
+      const tmp = `${statePath}.tmp-${process.pid}`;
+      fs.writeFileSync(tmp, JSON.stringify(state, null, 1), 'utf8');
+      fs.renameSync(tmp, statePath);
+    } catch {}
+  }
+
+  function record(partial) {
+    const state = readState();
+    state[npmName] = { ...(state[npmName] || {}), ...partial };
+    writeState(state);
+    return state[npmName];
+  }
+
+  async function check({ force = false } = {}) {
+    if (!enabled) return null;
+    const prev = readState()[npmName] || {};
+    const now = Date.now();
+    const interval = Math.max(1, Number(intervalHours) || 24) * 3600 * 1000;
+    if (!force && prev.checkedAt && now - prev.checkedAt < interval) return prev;
+
+    try {
+      const res = await fetch(`${registry.replace(/\/+$/, '')}/${npmName.replace('/', '%2F')}/latest`, {
+        headers: { accept: 'application/json' },
+        signal: AbortSignal.timeout(8000),
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const j = await res.json();
+      const latest = String(j?.version || '');
+      if (!latest) throw new Error('响应里没有 version');
+      const available = compareVersions(latest, version) > 0;
+      const rec = record({
+        current: version,
+        latest,
+        updateAvailable: available,
+        checkedAt: now,
+        lastError: '',
+        updateCommand: available ? `dsh plugin --profile <你的profile> add ${npmName}@latest` : '',
+      });
+      if (available) {
+        log?.(`发现新版本 ${latest}（当前 ${version}）：dsh plugin --profile <你的profile> add ${npmName}@latest`);
+      }
+      return rec;
+    } catch (e) {
+      const rec = record({
+        current: version,
+        checkedAt: now,
+        lastError: String(e?.message ?? e),
+      });
+      log?.(`检查更新失败（不影响使用）：${rec.lastError}`);
+      return rec;
+    }
+  }
+
+  function get() {
+    return readState()[npmName] || null;
+  }
+
+  return { check, get, npmName, version };
+}

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@jiugeqqqqq/dsh-house",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "房子 — 常驻的资产/能力清单，配一个侧边栏页面。清单会自动进系统提示（装了就生效）；房子只记有没有、到哪一步，细节放 knowledge 和日志里。",
   "type": "module",
   "license": "MIT",