@jiugeqqqqq/dsh-house2 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 > 每次发版都必须在这里写一条：改了什么、为什么改、别人要不要跟着动。
 > 版本号跟 `package.json` 走，`npm i` 的人看这里就知道升了什么。
 
+## 0.2.1 — 2026-10-30
+
+- `house_search` 加 `stage` 参数：先按工段名找到它挂的积木文件（`stage_done` 时写的「积木：xxx」），只在那一个文件里搜，比全目录翻更快更准。不传就还是全目录搜。
+
+## 0.2.0 — 2026-10-30
+
+- 新功能：**工段（任务段）**。不再按轮数切，按「这件事做完了没有」切——`stage_start` 开一座、`stage_done` 收掉（写结果 + 积木文件名）。
+- 工段清单每轮注入：正在做的全给、最近完成的给 5 条、更早的只留名字（细节去积木里翻），注入量不随任务数线性涨。
+- 数据文件：`<DSH_HOME>/stages.md`（装了就自动建，别人不用手动初始化）。
+- 下一步（未做）：任务完成时主动压缩/换会话、房子→积木的定向检索。
+
+## 0.1.3 — 2026-10-30
+
+- 修 client 的注册 id：必须是 scoped 包名 `@jiugeqqqqq/dsh-house2`，写裸名会导致 `loaded without registering` + `duplicate factory registration`（跟旧插件 0.3.6 以后崩的是同一个根因）。
+
 ## 0.1.0 — 2026-10-30
 
 - 新插件，从 dsh-house 分出来的一代：旧插件在别人机器上一直报 `duplicate factory registration`，换了几种包结构都修不掉，先起一个新的。

package/lib/host/index.js

@@ -18,6 +18,7 @@ import fs from 'node:fs';
 import zlib from 'node:zlib';
 import path from 'node:path';
 import { createUpdateChecker, compareVersions } from '../update-check.js';
+import { createStages } from './stages.js';
 
 export const name = 'house';
 export const inject = [];
@@ -111,6 +112,19 @@ export function apply(ctx, config = {}) {
       ? config.sessionsDir
       : path.join(dshHome, 'sessions');
 
+  // 工段（任务段）：每做完一个任务记一座，不按轮数切。
+  // 活跃的工段每轮注入；完成的只留最近几条，更早的只有名字，细节去积木里翻。
+  const stagesPath =
+    typeof config.stagesPath === 'string' && config.stagesPath.length > 0
+      ? config.stagesPath
+      : path.join(dshHome, 'stages.md');
+  const stages = createStages({
+    filePath: stagesPath,
+    log: (m) => ctx.logger?.info('dsh-house2: ' + m),
+  });
+  stages.ensure();
+  ctx.logger?.info('dsh-house2: 工段文件 = %s', stagesPath);
+
   // 版本自检：只查 npm 有没有新版，不自动安装。
   // 注意：本地开发目录的 package.json name 是 dsh-house2，而 npm 上是 scoped 包，所以写死 npmName。
   const updateChecker = createUpdateChecker({
@@ -514,11 +528,12 @@ export function apply(ctx, config = {}) {
     return out;
   }
 
-  function searchKnowledge(query, limit) {
+  function searchKnowledge(query, limit, onlyFiles) {
     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);
+    // 2026-10-30：给了 onlyFiles 就只在这些积木里搜（工段定向检索）。
+    const files = Array.isArray(onlyFiles) && onlyFiles.length ? onlyFiles : walkKnowledge(knowledgeDir);
     const hits = [];
     for (const f of files) {
       if (hits.length >= max) break;
@@ -543,6 +558,22 @@ export function apply(ctx, config = {}) {
     return { ok: true, data: { query: q, hits, scanned: files.length } };
   }
 
+  /** 按工段名找它挂的积木文件（stage_done 时写的「积木：xxx」）。 */
+  function stageBrickFiles(stageName) {
+    const name = String(stageName ?? '').trim();
+    if (!name) return null;
+    const { doing, done } = stages.parse();
+    const all = [...doing, ...done];
+    const hit = all.find((x) => x.name === name) || all.find((x) => x.name.includes(name) || name.includes(x.name));
+    if (!hit) return { error: `没有叫「${name}」的工段` };
+    const m = hit.line.match(/积木[:：]\s*([^\s|]+)/);
+    if (!m) return { error: `工段「${hit.name}」没有记积木文件名` };
+    const base = m[1].replace(/\.md$/i, '');
+    const file = path.join(knowledgeDir, `${base}.md`);
+    if (!fs.existsSync(file)) return { error: `积木文件不存在：${base}.md` };
+    return { files: [file], brick: base };
+  }
+
 
   // 2026-10-27：以前「房子清单能不能进模型上下文」要靠**另一个插件**
   // (dsh-session-rotate 的 assetsPath) 配一下才行 —— 等于装了这个插件的人也
@@ -562,7 +593,9 @@ export function apply(ctx, config = {}) {
     try {
       if (fs.existsSync(assetsPath)) text = fs.readFileSync(assetsPath, 'utf8').trim();
     } catch {}
-    return text ? `【资产清单】\n${text}\n\n${HOUSE_GUIDE}` : HOUSE_GUIDE;
+    const stageText = stages.renderPrompt();
+    const base = text ? `【资产清单】\n${text}\n\n${HOUSE_GUIDE}` : HOUSE_GUIDE;
+    return stageText ? `${base}\n\n${stageText}` : base;
   }
 
   // 2026-10-30：改成直接 ctx.systemPrompt.section（跟 dsh-affection 一样）。
@@ -643,13 +676,20 @@ export function apply(ctx, config = {}) {
             properties: {
               query: { type: 'string', description: '关键词，比如 抖音、画图、报错信息里的词' },
               limit: { type: 'number', description: '最多返回几处，默认 8' },
+              stage: { type: 'string', description: '可选：先定位到这个工段，只搜它挂的积木文件（更快更准）' },
             },
             required: ['query'],
             additionalProperties: false,
           },
           output,
           async execute(args) {
-            const r = searchKnowledge(args?.query, args?.limit);
+            let onlyFiles = null;
+            if (args?.stage) {
+              const sb = stageBrickFiles(args.stage);
+              if (!sb || sb.error) return { ok: false, message: sb?.error || '找不到这个工段' };
+              onlyFiles = sb.files;
+            }
+            const r = searchKnowledge(args?.query, args?.limit, onlyFiles);
             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');
@@ -736,6 +776,63 @@ export function apply(ctx, config = {}) {
         }),
       'dsh-house2: house_done',
     );
+
+    // 2026-10-30：工段（任务段）。一个任务一座工段，做完 stage_done 记结果 + 积木。
+    // 不按轮数切；活跃工段每轮注入，完成的只留最近几条，更早的只留名字。
+    scoped.effect(
+      () =>
+        tools.register({
+          name: 'stage_start',
+          description:
+            '开一座工段（一个任务）。说清楚这个任务要做什么，做完再用 stage_done 收掉。' +
+            '不是按轮数切，是按「这件事做完了没有」切。',
+          parameters: {
+            type: 'object',
+            properties: {
+              name: { type: 'string', description: '工段名，一句话说清这个任务' },
+              goal: { type: 'string', description: '目标/验收标准，一句话' },
+            },
+            required: ['name'],
+            additionalProperties: false,
+          },
+          output,
+          async execute(args) {
+            const r = stages.start(args?.name, args?.goal);
+            return r.ok
+              ? { ok: true, message: `工段已开：${r.data.name}` }
+              : { ok: false, message: r.error || '没开成' };
+          },
+        }),
+      'dsh-house2: stage_start',
+    );
+
+    scoped.effect(
+      () =>
+        tools.register({
+          name: 'stage_done',
+          description:
+            '把工段标记完成：写结果 + 积木文件名，它就会从「正在做的」移到「已经完成的」。' +
+            '做完一个任务就调一次，别挂着；拿不准算不算做完就别调。',
+          parameters: {
+            type: 'object',
+            properties: {
+              name: { type: 'string', description: '工段名（和 stage_start 一致）' },
+              result: { type: 'string', description: '最后成了什么，一句话' },
+              brick: { type: 'string', description: '积木文件名（不带 .md），比如 任务-调通一直发' },
+            },
+            required: ['name', 'result'],
+            additionalProperties: false,
+          },
+          output,
+          async execute(args) {
+            const r = stages.done(args?.name, args?.result, args?.brick);
+            return r.ok
+              ? { ok: true, message: `工段完成：${r.data.name}` }
+              : { ok: false, message: r.error || '没写成' };
+          },
+        }),
+      'dsh-house2: stage_done',
+    );
   });
 
   // ---------------------------------------------------------------- web API

package/lib/host/stages.js

@@ -0,0 +1,152 @@
+// dsh-house2 工段（任务段）—— 2026-10-30 新功能
+//
+// 房子 = 能力清单（一直留着）；工段 = 一次任务（做完就归档）。
+// 不按轮数切，按「这件事做完了没有」切：做完了 stage_done，写结果和积木指针。
+// 工段清单每轮注入（活跃的 + 最近完成的），老的不注入、只留名字，细节去积木里翻。
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+const TEMPLATE = `# 工段（任务段）
+
+> 每做一个任务就是一座工段。做完写一行到「已经完成的」，细节进积木（knowledge 目录）。
+> 不要按轮数切，按「这件事做完了没有」切。
+
+## 正在做的
+
+## 已经完成的
+`;
+
+export function createStages({ filePath, log = () => {} }) {
+  function ensure() {
+    try {
+      if (fs.existsSync(filePath)) return { created: false };
+      fs.mkdirSync(path.dirname(filePath), { recursive: true });
+      fs.writeFileSync(filePath, TEMPLATE, 'utf8');
+      return { created: true };
+    } catch (e) {
+      log('建工段文件失败：' + (e && e.message ? e.message : e));
+      return { created: false, error: e };
+    }
+  }
+
+  function readText() {
+    try {
+      return fs.readFileSync(filePath, 'utf8');
+    } catch {
+      return '';
+    }
+  }
+
+  /** 按分组解析成 {doing:[], done:[]}，每条保留原文和名字。 */
+  function parse() {
+    const text = readText();
+    const out = { doing: [], done: [] };
+    let group = '';
+    for (const raw of text.split(/\r?\n/)) {
+      const t = raw.trim();
+      if (t.startsWith('## ')) {
+        group = t.slice(3).trim();
+        continue;
+      }
+      if (!t.startsWith('- ')) continue;
+      const line = t.slice(2).trim();
+      if (group === '正在做的') out.doing.push({ line, name: nameOf(line) });
+      else if (group === '已经完成的') out.done.push({ line, name: nameOf(line) });
+    }
+    return out;
+  }
+
+  function nameOf(line) {
+    // 条目格式：🚧 **名字** | 目标：...  或 ✅ **名字** | 结果：...
+    const m = line.match(/\*\*([^*]+)\*\*/);
+    return m ? m[1].trim() : line.split('|')[0].replace(/^[^\w\u4e00-\u9fa5]+/, '').trim();
+  }
+
+  function today() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+  }
+
+  function start(name, goal) {
+    ensure();
+    const n = String(name || '').trim();
+    if (!n) return { ok: false, error: '工段名不能为空' };
+    const { doing } = parse();
+    if (doing.some((x) => x.name === n)) return { ok: false, error: `工段「${n}」已经开始过了` };
+    const line = `- 🚧 **${n}** | 目标：${String(goal || '（没写）').trim()} | 开始：${today()}`;
+    const text = readText();
+    const marker = '## 正在做的';
+    const idx = text.indexOf(marker);
+    if (idx < 0) {
+      fs.appendFileSync(filePath, `\n${line}\n`, 'utf8');
+    } else {
+      const insertAt = text.indexOf('\n', idx) + 1;
+      fs.writeFileSync(filePath, text.slice(0, insertAt) + line + '\n' + text.slice(insertAt), 'utf8');
+    }
+    log(`开工段：${n}`);
+    return { ok: true, data: { name: n, line } };
+  }
+
+  function done(name, result, brick) {
+    ensure();
+    const n = String(name || '').trim();
+    if (!n) return { ok: false, error: '工段名不能为空' };
+    const text = readText();
+    const lines = text.split(/\r?\n/);
+    const out = [];
+    let group = '';
+    let removed = false;
+    for (const raw of lines) {
+      const t = raw.trim();
+      if (t.startsWith('## ')) {
+        group = t.slice(3).trim();
+        out.push(raw);
+        continue;
+      }
+      if (group === '正在做的' && t.startsWith('- ') && nameOf(t.slice(2).trim()) === n) {
+        removed = true;
+        continue;
+      }
+      out.push(raw);
+    }
+    const line = `- ✅ **${n}** | 结果：${String(result || '（没写）').trim()} | 完成：${today()}${brick ? ` | 积木：${String(brick).trim()}` : ''}`;
+    let next = out.join('\n');
+    const marker = '## 已经完成的';
+    const idx = next.indexOf(marker);
+    if (idx < 0) {
+      next += `\n${marker}\n\n${line}\n`;
+    } else {
+      const end = next.indexOf('\n## ', idx + marker.length);
+      const insertAt = end < 0 ? next.length : end;
+      const before = next.slice(0, insertAt).replace(/\s*$/, '\n');
+      next = before + line + '\n' + next.slice(insertAt);
+    }
+    fs.writeFileSync(filePath, next.replace(/\n{3,}/g, '\n\n'), 'utf8');
+    log(`完工段：${n}${removed ? '' : '（原来不在「正在做的」里）'}`);
+    return { ok: true, data: { name: n, removed, line } };
+  }
+
+  /** 注入用：活跃工段全给，最近完成的给 5 条，更老的只给名字。 */
+  function renderPrompt(maxDone = 5) {
+    const { doing, done } = parse();
+    if (!doing.length && !done.length) return '';
+    const lines = ['【工段】'];
+    if (doing.length) {
+      lines.push('正在做的：');
+      for (const x of doing) lines.push(`  ${x.line}`);
+    }
+    if (done.length) {
+      const recent = done.slice(-maxDone);
+      const older = done.length - recent.length;
+      lines.push('最近完成的：');
+      for (const x of recent) lines.push(`  ${x.line}`);
+      if (older > 0) lines.push(`  （更早的 ${older} 座工段只留了名字，细节翻积木）`);
+    }
+    lines.push('做完一个任务就 stage_done 记一笔（结果 + 积木文件名），别挂着。');
+    return lines.join('\n');
+  }
+
+  return { ensure, parse, start, done, renderPrompt, path: filePath };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jiugeqqqqq/dsh-house2",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "房子 2 —— 资产/能力清单 + 工段，配侧边栏页面。0.1.0 先把安装跑通（保守兼容写法），功能后续迭代。",
   "type": "module",
   "license": "MIT",