@jiugeqqqqq/dsh-house 0.1.3 → 0.2.1

package/README.md

@@ -0,0 +1,137 @@
+# dsh-house
+
+> 一份**常驻的资产清单** + 一个侧边栏页面。
+> 清单每轮自动进系统提示（装了就生效），页面里能搜、能增、能改、能删；
+> 被上下文压缩掉的旧原文还能按关键词翻回来。
+
+"房子"是一个比喻：每个大能力/设备/工具算一座房子，只记**有没有、到哪一步、怎么用一句话**。
+细节不写在这里 —— 需要时用页面底部的「搜历史」去会话存档里翻原话。
+
+## 装
+
+```powershell
+dsh plugin --profile desktop add @jiugeqqqqq/dsh-house
+# 或 web profile
+dsh plugin --profile web add @jiugeqqqqq/dsh-house
+```
+
+重启 DSH。
+
+> 包名带 `@jiugeqqqqq/` 是因为 npm 上裸名 `dsh-house` 已被别人占用。
+
+## 装完什么样
+
+1. **第一次打开侧边栏「房子」** → 如果 `<DSH_HOME>/house.md` 不存在，会自动建一份模板，页面直接能看能改。
+2. **每一步请求** → 清单全文以 `【资产清单】` 注入系统提示。改了立刻生效，不用重启。
+3. **页面**：
+   - 顶部搜索框：按条目/分组名过滤
+   - `＋ 新增`：选分组 + 写一行
+   - 每条右边 `改` / `删`（删除要二次确认）
+   - 底部「搜历史」：按关键词翻会话存档里被压缩掉的原文
+4. **写回有备份**：每次改动前把 `house.md` 复制成 `house.md.bak-<时间戳>`。
+
+确认装好：
+
+```
+<DSH_HOME>\house.md          # 清单本体
+<DSH_HOME>\logs\...          # 启动日志里会有 dsh-house: 房子清单 = ...
+```
+
+## 清单格式
+
+只有两种语法，够用就好：
+
+```markdown
+# 标题（随便写）
+
+> 引用块随便写，不进解析
+
+## 分组名
+
+- 🏠 **条目名** ✅ 一句话说明
+  - 缩进的子项挂在上面那条下面（不算独立条目）
+- 🚧 **在做的东西** 到哪一步了
+```
+
+- `## ` 开一个分组
+- `- ` 开一个条目
+- **缩进的 `- `** 算上一条的子说明（比如「入口：…」「限制：…」），不单独占一条
+
+## 配置
+
+```yaml
+- id: house
+  config:
+    assetsPath: ''                    # 留空 = <DSH_HOME>/house.md
+    knowledgeDir: ''                  # 留空 = <DSH_HOME>/knowledge（页面只显示路径，不读内容）
+    sessionsDir: ''                   # 留空 = <DSH_HOME>/sessions（「搜历史」去这里翻）
+    autoRotate: false                 # 默认关，见下
+    bridgeUrl: 'http://127.0.0.1:3100'
+    bridgeTokenPath: ''
+    rotateKeys: ''
+    pendingGroup: '正在长出来的'
+    rotateCooldownMs: 600000
+```
+
+## autoRotate（可选，默认关）
+
+如果你有一条能重置会话的桥接（本项目的 QQ 桥接有 `POST /api/session/reset`），
+可以打开它：**清单被改过、且 `pendingGroup` 那组清空了**，插件就调桥接换新会话，省上下文。
+
+```yaml
+- id: house
+  config:
+    autoRotate: true
+    bridgeUrl: 'http://127.0.0.1:3100'
+    bridgeTokenPath: 'D:/path/to/console-token'
+    rotateKeys: 'private:123456789'
+    pendingGroup: '正在长出来的'
+```
+
+没有桥接就保持 `false` —— 它不会自己乱换会话。
+
+## 和 dsh-session-rotate 的关系
+
+`dsh-house` 自己注入资产清单。如果你同时装了 `dsh-session-rotate`：
+
+```yaml
+- id: session-rotate
+  config:
+    assetsPath: ''     # ← 留空，否则清单在提示词里出现两遍
+```
+
+默认就是空的，正常不用动。
+
+## 更新
+
+```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：页面空白 / 显示"解析不出条目"？**
+说明 `house.md` 被外部程序写坏了结构（比如少了 `## ` 或 `- `）。页面会直接把原文摊开显示，照着补回格式即可。原文件也有 `.bak-*` 备份。
+
+**Q：改了清单，模型没反应？**
+注入是每一步重新读文件的 —— 检查 `assetsPath` 指对了没，以及文件是不是空的。
+
+**Q：搜历史搜不到？**
+它只翻 `sessionsDir` 下最近 30 天、小于 80MB 的 `session.v4.jsonl.zstd`。刚聊的内容可能还没落盘，等一会儿再搜。
+
+**Q：「搜历史」会不会很慢？**
+会扫文件，但只解压匹配的那些行，一般几秒内。对话特别多时可以把 `days` 限定小一点（页面暂固定 30 天）。
+
+## License
+
+MIT

package/lib/client.js

@@ -225,8 +225,15 @@ window.__ModuleLoader__.load({
         React.createElement(
           'div', { key: 'head', style: styles.head },
           React.createElement('h1', { style: styles.title }, '房子'),
-          React.createElement('span', { style: styles.sub }, '她的资产与能力清单 · 常驻'),
+          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,
         ),
       );
 
@@ -286,7 +293,24 @@ window.__ModuleLoader__.load({
         children.push(React.createElement('div', { key: 'loading', style: styles.note }, '读取中…'));
       }
       if (!s.loading && !s.error && shown.length === 0) {
-        children.push(React.createElement('div', { key: 'empty', style: styles.note }, needle ? '没有匹配的房子。' : '还没有房子。'));
+        if (needle) {
+          children.push(React.createElement('div', { key: 'empty', style: styles.note }, '没有匹配的房子。'));
+        } else if (s.data && s.data.raw) {
+          // 解析不出任何条目，但文件非空 —— 多半是结构被写坏了。把原文摊开，
+          // 至少能看见内容，不至于以为整份清单丢了。
+          children.push(
+            React.createElement('div', { key: 'rawhead', style: styles.err }, '清单解析不出条目（格式可能被改坏了），下面是原文：'),
+          );
+          children.push(
+            React.createElement(
+              'pre',
+              { key: 'raw', style: { whiteSpace: 'pre-wrap', wordBreak: 'break-word', fontSize: '12px', opacity: 0.8, margin: 0 } },
+              s.data.raw,
+            ),
+          );
+        } else {
+          children.push(React.createElement('div', { key: 'empty', style: styles.note }, '还没有房子。点上面的「＋ 新增」写第一条。'));
+        }
       }
 
       shown.forEach(function (g, gi) {
@@ -378,7 +402,7 @@ window.__ModuleLoader__.load({
           return;
         }
         var when = new Date(h.time).toLocaleString('zh-CN', { hour12: false });
-        var who = h.role === 'user' ? '粑粑' : '她';
+        var who = h.role === 'user' ? '你' : 'AI';
         histChildren.push(
           React.createElement(
             'div', { key: 'h' + String(i), style: styles.row },

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,19 +111,36 @@ 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 = [
     '# 房子（资产清单）',
     '',
-    '> 每个大操作一行：任务名 + 到哪一步 + 一句话 + 能搜到的词（工具名/时间）。',
-    '> 只记「有/没有、到哪一步」；细节留在别处，需要时按关键词搜历史。',
+    '> 一行一个：**名字** 状态 一句话。',
+    '> 只记「有/没有、到哪一步、怎么用一句话」；细节留在别处，需要时用页面底部的「搜历史」翻。',
+    '> 这份文件每一轮都会自动进系统提示 —— 改完立刻生效，不用重启。',
     '',
-    '## 住着的地方',
-    '- 🏠 **示例条目** ✅ 这是自动生成的模板，改成你自己的第一条房子',
+    '## 已经有的',
+    '- 🏠 **第一条** ✅ 把这条改成你真正能用的东西（工具、设备、账号、脚本都算）',
     '',
     '## 正在长出来的',
-    '- 🚧 **把这条删掉** 这组空了，配合 autoRotate 才会在任务收尾后自动换会话',
+    '- 🚧 **还没做完的** 写在这组；这组清空后，配合 autoRotate 才会在任务收尾时换会话',
+    '',
+    '---',
+    '更新：' + new Date().toISOString().slice(0, 10),
     '',
   ].join('\n');
 
@@ -166,7 +192,7 @@ export function apply(ctx, config = {}) {
           const total = groups.reduce((n, g) => n + g.items.length, 0);
           return {
             ok: true,
-            data: { path: assetsPath, missing: false, created: true, note: '已自动创建一份模板清单', groups, total },
+            data: { path: assetsPath, missing: false, created: true, note: '已自动创建一份模板清单', groups, total, raw: '' },
           };
         } catch {}
       }
@@ -182,7 +208,10 @@ export function apply(ctx, config = {}) {
     }
     const { groups } = parseWithLines(text);
     const total = groups.reduce((n, g) => n + g.items.length, 0);
-    return { ok: true, data: { path: assetsPath, missing: false, groups, total } };
+    // 2026-10-27：解析出 0 条但文件非空 → 多半是被外部程序写坏了结构。
+    // 这时候把原文带回去，页面直接显示，总比"空白一片"让人以为文件丢了强。
+    const raw = total === 0 && text.trim() ? text.slice(0, 20000) : '';
+    return { ok: true, data: { path: assetsPath, missing: false, groups, total, raw } };
   }
 
   // ── 搜历史原话 ────────────────────────────────────────────────────────────
@@ -418,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.1.3",
+  "version": "0.2.1",
   "description": "房子 — 常驻的资产/能力清单，配一个侧边栏页面。清单会自动进系统提示（装了就生效）；房子只记有没有、到哪一步，细节放 knowledge 和日志里。",
   "type": "module",
   "license": "MIT",
@@ -27,8 +27,18 @@
     },
     "manifestVersion": 1
   },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "assets",
+    "capabilities",
+    "sidebar",
+    "memory"
+  ],
+  "author": "jiuge",
   "files": [
     "lib/**/*.js",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "README.md"
   ]
 }