@jiugeqqqqq/dsh-house 0.2.3 → 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# 更新日志
+
+> 每次发版都必须在这里写一条：改了什么、为什么改、别人要不要跟着动。
+> 版本号跟 `package.json` 走，`npm i` 的人看这里就知道升了什么。
+
+## 0.3.1 — 2026-10-29
+
+**新增写积木的能力，积木终于能自己长出来。**
+
+- 新增 `house_write`：往积木里写一篇（`file` + `content`，默认追加；`mode: overwrite` 才整篇重写）。
+  之前只有 `house_add`（记清单一行）和 `house_search`（翻积木），**没有写积木的工具**——别人装完 `knowledge` 一直是空的。
+- 系统提示里教「两条轴」：能力型（`手机-接入与操作`，回答「怎么做」）和任务型（`任务-调通一直发`，回答「那段轮对话干了什么」）。
+  任务轴按时间轴切，一段任务一篇，要求覆盖全程、不重不漏。
+- `house_write` 的描述点名两种命名都行。
+- 插件 README 增加「积木怎么组织：两条轴」一节。
+
+> 升级提醒：如果对方有工具白名单（比如 QQ 桥接的 `qq-tool-restrict` / `dsh-qq-guard`），
+> 要把 `house_add`、`house_write`、`house_search` 三个都加进去，否则调了会被拒。
+
+## 0.3.0 — 2026-10-28
+
+- 新增 `house_add`：模型自己往清单加一行（`text` + 可选 `group`）。
+- 新增 `house_search`：在 `knowledge` 目录里按关键词翻原文（递归、跳过 README）。
+- 启动时自动建 `knowledge` 目录 + 带说明的 `README.md`，别人装完知道往里写什么。
+- 系统提示里带用法引导（之前只注入清单、不告诉模型去哪翻）。
+
+## 0.2.3 — 2026-10-27
+
+- 修别人装完侧栏不出现：包名和 patch 名统一成 `@jiugeqqqqq/dsh-house`，`inject` 写 `slots`，`ctx.get('slots')` 兼容 rc.3。
+
+## 0.2.x — 2026-10-25 ~ 10-27
+
+- 侧边栏「房子」页：搜索、增、改、删（删除二次确认）。
+- 清单每轮注入系统提示，改完立刻生效，不用重启。
+- 「搜历史」：翻会话存档里被压缩掉的原文。
+- 写回前自动备份 `house.md.bak-<时间戳>`。
+- `autoRotate`（可选，默认关）：清单改过且 `pendingGroup` 清空时，调桥接换新会话。
+- 每日自查 npm 新版本（只提示，不自动装）。
+
+## 0.1.x — 2026-10-24
+
+- 初始版本：清单 + 页面。
+
+---
+格式约定：`## 版本 — 日期`，下面用短句列改动，先说「用户能感知到什么」，再说实现。

package/README.md

@@ -37,6 +37,35 @@ dsh plugin --profile web add @jiugeqqqqq/dsh-house
 <DSH_HOME>\logs\...          # 启动日志里会有 dsh-house: 房子清单 = ...
 ```
 
+## 给模型的三个工具（0.3.1 起）
+
+装完模型自己能维护清单和积木，不用你手动改：
+
+- `house_add`：做完一件大事往清单加一行（`text` + 可选 `group`，默认「已经有的」）
+- `house_write`：往积木里写一篇（`file` + `content`，默认追加；`mode: overwrite` 才整篇重写）
+- `house_search`：在积木（`knowledge` 目录里的 .md）里按关键词翻原文
+
+系统提示里会带一句引导：「做完大事用 house_add 记一行；写积木分能力型和任务型；清单和最近对话里找不到的，用 house_search 去积木里翻，翻到再答，别猜。」
+
+`knowledge` 目录不存在时会自动建一份带说明的 `README.md`，别人装完知道该往里写什么。
+
+## 积木怎么组织：两条轴（0.3.1 起）
+
+`house_write` 的文件名就是组织方式，两种都支持、都要有：
+
+| 轴 | 一个文件对应 | 例子 | 回答的问题 |
+|---|---|---|---|
+| 能力轴 | 一个能力/设备/工具 | `手机-接入与操作`、`画图-Agnes` | 「这个怎么做」 |
+| 任务轴 | 一段任务 | `任务-调通一直发` | 「那三十轮干了什么」 |
+
+任务轴是**按时间轴切，不是按标签分类**：
+
+- 一段对话里有几个任务就写几篇，切完正好覆盖全程，不重不漏
+- 任务边界：① 目标变了；② 他明说换事；③ 交付物变了
+- 一篇只写「做了什么 / 卡在哪 / 最后怎么定的」，别复述过程
+
+> 为什么要两条轴：能力轴回答「怎么用」，任务轴回答「发生过什么」。上下文压缩之后，任务轴是唯一能证明「那段时间真的干过这件事」的东西。
+
 ## 清单格式
 
 只有两种语法，够用就好：
@@ -102,6 +131,10 @@ dsh plugin --profile web add @jiugeqqqqq/dsh-house
 
 默认就是空的，正常不用动。
 
+## 更新日志
+
+每次发版改了什么，看 [CHANGELOG.md](./CHANGELOG.md)——`npm i` 之前先扫一眼，能知道要不要跟着动配置。
+
 ## 更新
 
 ```powershell

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# Bundle patch layer for dsh-house（房子）。
+# Bundle patch layer for dsh-house（房子）。
 #
 # 只插入一行 Host。浏览器那一半由 package.json 的 dsh.client 声明。
 # 这里的默认值**不写死任何人的路径**：装完直接能用，清单文件不存在会自动建模板。
@@ -6,7 +6,7 @@
 
 - insert:
     - id: house
-      name: "@jiugeqqqqq/dsh-house"
+      name: "dsh-house"
       config:
         # 房子清单：Markdown，按 "## 分组" 和 "- 条目" 解析。留空 = <DSH_HOME>/house.md
         assetsPath: ''

package/lib/host/index.js

@@ -13,7 +13,7 @@
  *
  * 2026-10-26：加写能力（之前只有 list/read，装了等于 Markdown 预览器）+ 搜存档。
  */
-import { readFile, writeFile, mkdir, copyFile } from 'node:fs/promises';
+import { readFile, writeFile, appendFile, mkdir, copyFile } from 'node:fs/promises';
 import fs from 'node:fs';
 import zlib from 'node:zlib';
 import path from 'node:path';
@@ -144,6 +144,42 @@ export function apply(ctx, config = {}) {
     '',
   ].join('\n');
 
+  // 积木目录：房子只记结论，细节（怎么调通的、踩了什么坑、为什么这么改）写这里。
+  // 别人装完如果目录不存在，自动建一份带说明的 README —— 否则页面只显示一个空路径，
+  // 谁也不知道该往里写什么。
+  const KNOWLEDGE_TEMPLATE = [
+    '# 积木库',
+    '',
+    '> 房子清单（house.md）只记「有/没有、到哪一步、怎么用一句话」。',
+    '> 怎么调通的、踩了什么坑、为什么这么改 —— 写在这里，一个主题一个 .md。',
+    '> 新会话不会自动读这里；需要时用 house_search 按关键词翻，或者直接打开文件。',
+    '',
+    '## 怎么写',
+    '- 文件名用主题，比如 `手机-接入与操作.md`、`画图-Agnes.md`',
+    '- 只记「最后怎么定的 + 为什么」，不记纠结过程',
+    '- 原始输出留在日志里，不要整段粘进来',
+    '',
+    '## 索引',
+    '（把自己的文件一行一个写在这里，方便翻）',
+    '',
+  ].join('\n');
+
+  async function ensureKnowledge() {
+    try {
+      await mkdir(knowledgeDir, { recursive: true });
+      const readme = path.join(knowledgeDir, 'README.md');
+      if (!fs.existsSync(readme)) await writeFile(readme, KNOWLEDGE_TEMPLATE, 'utf8');
+      return { created: true };
+    } catch (error) {
+      return { created: false, error: error instanceof Error ? error.message : String(error) };
+    }
+  }
+  // 启动就建，不等页面打开（fire and forget，失败也不影响清单）。
+  ensureKnowledge().then((r) => {
+    if (r.created) ctx.logger?.info('dsh-house: 积木目录 = %s', knowledgeDir);
+    else ctx.logger?.warn('dsh-house: 建积木目录失败：%s', r.error);
+  });
+
   async function ensureAssets() {
     try {
       await readFile(assetsPath, 'utf8');
@@ -375,20 +411,103 @@ export function apply(ctx, config = {}) {
     }
   }
 
-  // ------------------------------------------------------- 注入到系统提示
+  /** 往清单里加一行（工具 house_add 用，走和页面同一条写回链路）。 */
+  async function addHouseItem(group, text) {
+    const item = String(text || '').replace(/\s+/g, ' ').trim();
+    if (!item) return { ok: false, error: { code: 'invalid', message: '要写点什么。' } };
+    // 别人可能还没打开过页面，清单文件不存在 —— 先建模板再写，别让第一次 house_add 就失败。
+    if (!fs.existsSync(assetsPath)) await ensureAssets();
+    const g = String(group || '已经有的').trim() || '已经有的';
+    const r = await mutate((lines) => {
+      let gi = lines.findIndex((l) => l.trim() === '## ' + g);
+      if (gi < 0) {
+        lines.push('', '## ' + g);
+        gi = lines.length - 1;
+      }
+      let end = lines.length;
+      for (let i = gi + 1; i < lines.length; i++) {
+        if (/^##\s+/.test(lines[i])) {
+          end = i;
+          break;
+        }
+      }
+      let insertAt = end;
+      for (let i = end - 1; i > gi; i--) {
+        if (lines[i].trim()) {
+          insertAt = i + 1;
+          break;
+        }
+      }
+      lines.splice(insertAt, 0, '- ' + item);
+      return true;
+    });
+    return r.ok ? { ok: true, data: { group: g, text: item } } : r;
+  }
+
+  /** 在积木目录里按关键词翻（工具 house_search 用）。 */
+  function walkKnowledge(dir, out = [], depth = 0) {
+    if (depth > 4) return out;
+    let ents;
+    try {
+      ents = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return out;
+    }
+    for (const e of ents) {
+      const p = path.join(dir, e.name);
+      if (e.isDirectory()) walkKnowledge(p, out, depth + 1);
+      else if (/\.md$/i.test(e.name) && e.name !== 'README.md') out.push(p);
+    }
+    return out;
+  }
+
+  function searchKnowledge(query, limit) {
+    const q = String(query ?? '').trim().toLowerCase();
+    if (!q) return { ok: false, error: { code: 'invalid', message: '要给个关键词。' } };
+    const max = Math.max(1, Math.min(30, Number(limit) || 8));
+    const files = walkKnowledge(knowledgeDir);
+    const hits = [];
+    for (const f of files) {
+      if (hits.length >= max) break;
+      let text;
+      try {
+        text = fs.readFileSync(f, 'utf8');
+      } catch {
+        continue;
+      }
+      const lines = text.split('\n');
+      for (let i = 0; i < lines.length; i++) {
+        if (hits.length >= max) break;
+        if (lines[i].toLowerCase().includes(q)) {
+          hits.push({
+            file: path.relative(knowledgeDir, f),
+            line: i + 1,
+            text: lines[i].trim().slice(0, 240),
+          });
+        }
+      }
+    }
+    return { ok: true, data: { query: q, hits, scanned: files.length } };
+  }
+
+
   // 2026-10-27：以前「房子清单能不能进模型上下文」要靠**另一个插件**
   // (dsh-session-rotate 的 assetsPath) 配一下才行 —— 等于装了这个插件的人也
   // 只得到页面、模型根本看不见清单。粑粑要求「装上就和我们一样」，所以这里自己注入。
   // 文件小（几 KB）且每轮重读，保证清单改了立刻生效；读不到就注入空串，不报错。
+  // 每轮都带一段用法提示：只给清单、不告诉它「找不到去哪翻」，模型就会自己猜。
+  const HOUSE_GUIDE =
+    '【房子怎么用】做完一件大事，用 house_add 往清单加一行（分组写「已经有的」或「正在长出来的」）；' +
+    '写积木分两种：按能力写（`手机-接入与操作`、`画图-Agnes`，回答「怎么做」）、按任务写（`任务-调通一直发`，回答「那段对话干了什么」，一段任务一篇，按时间轴切，切完要覆盖全程、不重不漏）；' +
+    '细节、命令、踩过的坑，用 house_write 写进积木（knowledge 目录，默认追加，别一个坑建一个文件）；' +
+    '清单和最近对话里找不到的东西，用 house_search 去积木里按关键词翻，翻到再答，别猜。';
+
   function assetsAsPrompt() {
+    let text = '';
     try {
-      if (!fs.existsSync(assetsPath)) return '';
-      const text = fs.readFileSync(assetsPath, 'utf8').trim();
-      if (!text) return '';
-      return `【资产清单】\n${text}`;
-    } catch {
-      return '';
-    }
+      if (fs.existsSync(assetsPath)) text = fs.readFileSync(assetsPath, 'utf8').trim();
+    } catch {}
+    return text ? `【资产清单】\n${text}\n\n${HOUSE_GUIDE}` : HOUSE_GUIDE;
   }
 
   ctx.inject(['systemPrompt'], (scoped) => {
@@ -409,6 +528,132 @@ export function apply(ctx, config = {}) {
     );
   });
 
+  // ----------------------------------------------------------- 两个工具
+  // 2026-10-28 加的：以前房子只能靠页面手改，模型自己没法维护；
+  // 积木目录也没人搜得到。给模型两个口子，它才能「做完事记一行、找不到就翻」。
+  ctx.inject(['tools'], (scoped) => {
+    const tools = scoped.get('tools');
+    if (tools === undefined || typeof tools.register !== 'function') {
+      ctx.logger?.warn('dsh-house: 宿主没有 tools，house_add / house_search 不可用（页面不受影响）。');
+      return;
+    }
+    const render = (args, value) => [{ type: 'text', text: String(value?.message ?? '') }];
+    const output = {
+      schema: {
+        type: 'object',
+        properties: {
+          ok: { type: 'boolean', description: '是否成功' },
+          message: { type: 'string', description: '给模型看的一句话结果' },
+        },
+        required: ['ok', 'message'],
+        additionalProperties: false,
+      },
+      render,
+    };
+
+    scoped.effect(
+      () =>
+        tools.register({
+          name: 'house_add',
+          description:
+            '往「房子」清单里加一行。做完一件大事（装好一个工具、接好一个设备、跑通一个流程）就调一次，' +
+            '只写「有/没有、到哪一步、怎么用一句话」，细节留在积木里。分组不写默认「已经有的」，' +
+            '没做完的写「正在长出来的」。',
+          parameters: {
+            type: 'object',
+            properties: {
+              text: { type: 'string', description: '一行话，比如「手机截图 ✅ phone.cmd shot」' },
+              group: { type: 'string', description: '分组名：已经有的 / 正在长出来的 / 或者你自己开的分组' },
+            },
+            required: ['text'],
+            additionalProperties: false,
+          },
+          output,
+          async execute(args) {
+            const r = await addHouseItem(args?.group, args?.text);
+            return r.ok
+              ? { ok: true, message: `已加到「${r.data.group}」：${r.data.text}` }
+              : { ok: false, message: r.error?.message || '没写成' };
+          },
+        }),
+      'dsh-house: house_add',
+    );
+
+    scoped.effect(
+      () =>
+        tools.register({
+          name: 'house_search',
+          description:
+            '在「积木」（knowledge 目录里的 .md）里按关键词翻原文。房子清单和最近对话里找不到的细节，' +
+            '先在这里搜；搜到再回答，搜不到就说没找到，别猜。',
+          parameters: {
+            type: 'object',
+            properties: {
+              query: { type: 'string', description: '关键词，比如 抖音、画图、报错信息里的词' },
+              limit: { type: 'number', description: '最多返回几处，默认 8' },
+            },
+            required: ['query'],
+            additionalProperties: false,
+          },
+          output,
+          async execute(args) {
+            const r = searchKnowledge(args?.query, args?.limit);
+            if (!r.ok) return { ok: false, message: r.error?.message || '没搜成' };
+            if (!r.data.hits.length) return { ok: true, message: `积木里没搜到「${r.data.query}」（翻过 ${r.data.scanned} 个文件）` };
+            const body = r.data.hits.map((h) => `${h.file}:${h.line}  ${h.text}`).join('\n');
+            return { ok: true, message: `在积木里找到 ${r.data.hits.length} 处：\n${body}` };
+          },
+        }),
+      'dsh-house: house_search',
+    );
+
+    // 0.3.1：写积木。之前只有「加一行清单」和「翻积木」，积木永远长不出来。
+    scoped.effect(
+      () =>
+        tools.register({
+          name: 'house_write',
+          description:
+            '往「积木」里写一篇：按名字写进 knowledge/<名字>.md。' +
+            '做完一件大事、踩了坑、调通一个流程，就把命令/坑/为什么这么改记进来。' +
+            '名字两种：能力型（手机-接入与操作）或任务型（任务-调通一直发，一段任务一篇、覆盖全程）。' +
+            '默认追加；同一个名字只开一个文件，别一个坑建一个文件。',
+          parameters: {
+            type: 'object',
+            properties: {
+              file: { type: 'string', description: '积木文件名（不带 .md），比如「手机-接入与操作」' },
+              content: { type: 'string', description: '要写的内容，markdown；只写结果/命令/坑，别写纠结过程' },
+              mode: { type: 'string', enum: ['append', 'overwrite'], description: '默认 append（追加）；只有整篇重写才用 overwrite' },
+            },
+            required: ['file', 'content'],
+            additionalProperties: false,
+          },
+          output,
+          async execute(args) {
+            const rawName = String(args?.file ?? '').trim().replace(/\.md$/i, '');
+            if (!rawName || /[\\/:*?"<>|]/.test(rawName) || rawName.includes('..')) {
+              return { ok: false, message: '文件名不合法（不能带路径分隔符或 ..）' };
+            }
+            const content = String(args?.content ?? '').trim();
+            if (!content) return { ok: false, message: '内容不能为空' };
+            const file = path.join(knowledgeDir, rawName + '.md');
+            const mode = args?.mode === 'overwrite' ? 'overwrite' : 'append';
+            try {
+              await mkdir(knowledgeDir, { recursive: true });
+              if (mode === 'append' && fs.existsSync(file)) {
+                await appendFile(file, `\n${content}\n`, 'utf8');
+              } else {
+                await writeFile(file, `${content}\n`, 'utf8');
+              }
+              return { ok: true, message: `已${mode === 'append' ? '追加到' : '写入'} 积木/${rawName}.md（${content.length} 字）` };
+            } catch (error) {
+              return { ok: false, message: error?.message || '写失败' };
+            }
+          },
+        }),
+      'dsh-house: house_write',
+    );
+  });
+
   // ---------------------------------------------------------------- web API
   ctx.inject(['webServer'], (scoped) => {
     const webServer = scoped.get('webServer');

package/package.json

@@ -1,44 +1,45 @@
-{
-    "name":  "@jiugeqqqqq/dsh-house",
-    "version":  "0.2.3",
-    "description":  "房子 — 常驻的资产/能力清单，配一个侧边栏页面。清单会自动进系统提示（装了就生效）；房子只记有没有、到哪一步，细节放 knowledge 和日志里。",
-    "type":  "module",
-    "license":  "MIT",
-    "main":  "./lib/host/index.js",
-    "exports":  {
-                    ".":  "./lib/host/index.js",
-                    "./client":  "./lib/client.js",
-                    "./package.json":  "./package.json"
-                },
-    "meta":  {
-                 "title":  "房子",
-                 "description":  "常驻的资产与能力清单：只记有没有、到哪一步、怎么用一句话。细节留给 knowledge 和日志，需要时再查。"
-             },
-    "dsh":  {
-                "bundle":  {
-                               "patch":  "./cordis.patch.yml"
-                           },
-                "client":  {
-                               "platform":  "web",
-                               "immediately":  true,
-                               "inject":  [
-                                              "slots"
-                                          ]
-                           },
-                "manifestVersion":  1
-            },
-    "keywords":  [
-                     "dsh",
-                     "deepseek-harness",
-                     "assets",
-                     "capabilities",
-                     "sidebar",
-                     "memory"
-                 ],
-    "author":  "jiuge",
-    "files":  [
-                  "lib/**/*.js",
-                  "cordis.patch.yml",
-                  "README.md"
-              ]
-}
+{
+  "name": "@jiugeqqqqq/dsh-house",
+  "version": "0.3.1",
+  "description": "房子 — 常驻的资产/能力清单，配一个侧边栏页面。清单会自动进系统提示（装了就生效）；房子只记有没有、到哪一步，细节放 knowledge 和日志里。",
+  "type": "module",
+  "license": "MIT",
+  "main": "./lib/host/index.js",
+  "exports": {
+    ".": "./lib/host/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "meta": {
+    "title": "房子",
+    "description": "常驻的资产与能力清单：只记有没有、到哪一步、怎么用一句话。细节留给 knowledge 和日志，需要时再查。"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "slots"
+      ]
+    },
+    "manifestVersion": 1
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "assets",
+    "capabilities",
+    "sidebar",
+    "memory"
+  ],
+  "author": "jiuge",
+  "files": [
+    "lib/**/*.js",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}