@jiugeqqqqq/dsh-house 0.1.2 → 0.2.0

package/README.md

@@ -0,0 +1,121 @@
+# 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: ''     # ← 留空，否则清单在提示词里出现两遍
+```
+
+默认就是空的，正常不用动。
+
+## 常见问题
+
+**Q：页面空白 / 显示"解析不出条目"？**
+说明 `house.md` 被外部程序写坏了结构（比如少了 `## ` 或 `- `）。页面会直接把原文摊开显示，照着补回格式即可。原文件也有 `.bak-*` 备份。
+
+**Q：改了清单，模型没反应？**
+注入是每一步重新读文件的 —— 检查 `assetsPath` 指对了没，以及文件是不是空的。
+
+**Q：搜历史搜不到？**
+它只翻 `sessionsDir` 下最近 30 天、小于 80MB 的 `session.v4.jsonl.zstd`。刚聊的内容可能还没落盘，等一会儿再搜。
+
+**Q：「搜历史」会不会很慢？**
+会扫文件，但只解压匹配的那些行，一般几秒内。对话特别多时可以把 `days` 限定小一点（页面暂固定 30 天）。
+
+## License
+
+MIT

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/client.js

@@ -225,7 +225,7 @@ 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) + ' 条'),
         ),
       );
@@ -286,7 +286,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 +395,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

@@ -107,14 +107,18 @@ export function apply(ctx, config = {}) {
   const TEMPLATE = [
     '# 房子（资产清单）',
     '',
-    '> 每个大操作一行：任务名 + 到哪一步 + 一句话 + 能搜到的词（工具名/时间）。',
-    '> 只记「有/没有、到哪一步」；细节留在别处，需要时按关键词搜历史。',
+    '> 一行一个：**名字** 状态 一句话。',
+    '> 只记「有/没有、到哪一步、怎么用一句话」；细节留在别处，需要时用页面底部的「搜历史」翻。',
+    '> 这份文件每一轮都会自动进系统提示 —— 改完立刻生效，不用重启。',
     '',
-    '## 住着的地方',
-    '- 🏠 **示例条目** ✅ 这是自动生成的模板，改成你自己的第一条房子',
+    '## 已经有的',
+    '- 🏠 **第一条** ✅ 把这条改成你真正能用的东西（工具、设备、账号、脚本都算）',
     '',
     '## 正在长出来的',
-    '- 🚧 **把这条删掉** 这组空了，配合 autoRotate 才会在任务收尾后自动换会话',
+    '- 🚧 **还没做完的** 写在这组；这组清空后，配合 autoRotate 才会在任务收尾时换会话',
+    '',
+    '---',
+    '更新：' + new Date().toISOString().slice(0, 10),
     '',
   ].join('\n');
 
@@ -166,7 +170,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 +186,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 } };
   }
 
   // ── 搜历史原话 ────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@jiugeqqqqq/dsh-house",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "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"
   ]
 }