@jiugeqqqqq/dsh-house 0.3.0 → 0.3.2

package/CHANGELOG.md

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

package/cordis.patch.yml

@@ -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';
@@ -498,7 +498,9 @@ export function apply(ctx, config = {}) {
   // 每轮都带一段用法提示：只给清单、不告诉它「找不到去哪翻」，模型就会自己猜。
   const HOUSE_GUIDE =
     '【房子怎么用】做完一件大事，用 house_add 往清单加一行（分组写「已经有的」或「正在长出来的」）；' +
-    '清单和最近对话里找不到的东西，用 house_search 去积木（knowledge 目录）里按关键词翻，翻到再答，别猜。';
+    '写积木分两种：按能力写（`手机-接入与操作`、`画图-Agnes`，回答「怎么做」）、按任务写（`任务-调通一直发`，回答「那段对话干了什么」，一段任务一篇，按时间轴切，切完要覆盖全程、不重不漏）；' +
+    '细节、命令、踩过的坑，用 house_write 写进积木（knowledge 目录，默认追加，别一个坑建一个文件）；' +
+    '清单和最近对话里找不到的东西，用 house_search 去积木里按关键词翻，翻到再答，别猜。';
 
   function assetsAsPrompt() {
     let text = '';
@@ -604,6 +606,52 @@ export function apply(ctx, config = {}) {
         }),
       '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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jiugeqqqqq/dsh-house",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "房子 — 常驻的资产/能力清单，配一个侧边栏页面。清单会自动进系统提示（装了就生效）；房子只记有没有、到哪一步，细节放 knowledge 和日志里。",
   "type": "module",
   "license": "MIT",
@@ -39,6 +39,7 @@
   "files": [
     "lib/**/*.js",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }