@jiugeqqqqq/dsh-house 0.2.2 → 0.3.0

package/README.md

@@ -37,6 +37,17 @@ dsh plugin --profile web add @jiugeqqqqq/dsh-house
 <DSH_HOME>\logs\...          # 启动日志里会有 dsh-house: 房子清单 = ...
 ```
 
+## 给模型的两个工具（0.3.0 起）
+
+装完模型自己能维护清单，不用你手动改：
+
+- `house_add`：做完一件大事往清单加一行（`text` + 可选 `group`，默认「已经有的」）
+- `house_search`：在积木（`knowledge` 目录里的 .md）里按关键词翻原文
+
+系统提示里会带一句引导：「做完大事用 house_add 记一行；清单和最近对话里找不到的，用 house_search 去积木里翻，翻到再答，别猜。」
+
+`knowledge` 目录不存在时会自动建一份带说明的 `README.md`，别人装完知道该往里写什么。
+
 ## 清单格式
 
 只有两种语法，够用就好：

package/cordis.patch.yml

@@ -6,7 +6,7 @@
 
 - insert:
     - id: house
-      name: dsh-house
+      name: "@jiugeqqqqq/dsh-house"
       config:
         # 房子清单：Markdown，按 "## 分组" 和 "- 条目" 解析。留空 = <DSH_HOME>/house.md
         assetsPath: ''

package/lib/client.js

@@ -428,14 +428,18 @@ window.__ModuleLoader__.load({
     var inject = ['slots'];
 
     function apply(ctx) {
-      ctx.slots.inject('sidebar.panellist', function () {
-        return ctx.slots.register(
+      // 2026-10-27：DSH 0.2.1-rc.3 起，slots 要拿 ctx.get('slots')，直接读 ctx.slots 会是
+      // undefined（表现：host 正常、侧栏静默不出现、Console 也不报错）。
+      // 老版本没有 ctx.get，所以两种写法都兜一下。
+      var slots = (typeof ctx.get === 'function' && ctx.get('slots')) || ctx.slots;
+      slots.inject('sidebar.panellist', function () {
+        return slots.register(
           { name: 'sidebar.panellist', id: PANEL_ID, order: 21, label: function () { return '房子'; } },
           Icon,
         );
       });
-      ctx.slots.inject('main', function () {
-        return ctx.slots.register({ name: 'main', key: PANEL_ID }, HousePage);
+      slots.inject('main', function () {
+        return slots.register({ name: 'main', key: PANEL_ID }, HousePage);
       });
     }
 

package/lib/host/index.js

@@ -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,101 @@ 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 往清单加一行（分组写「已经有的」或「正在长出来的」）；' +
+    '清单和最近对话里找不到的东西，用 house_search 去积木（knowledge 目录）里按关键词翻，翻到再答，别猜。';
+
   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 +526,86 @@ 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',
+    );
+  });
+
   // ---------------------------------------------------------------- web API
   ctx.inject(['webServer'], (scoped) => {
     const webServer = scoped.get('webServer');

package/package.json

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