dsh-lite-memory 0.2.4 → 0.2.6

package/README.md

@@ -16,17 +16,21 @@ Lightweight memory for the DeepSeek Harness. Nothing in the system prompt, nothi
 | 场景 | 行为 |
 | --- | --- |
 | **L0** 你明确要求「记住这个」 | 立即写盘，一条确认行 |
-| **L1** 它发现有跨会话价值的经验 | 一行灰字 `memory · keep "X"?` + 一个 `keep` 按钮；不写问句、不用你打字，不点就永远不写，48 小时内不重复 |
+| **L1** 它发现有跨会话价值的经验 | 一行灰字 `memory · keep? "X" — 要记的内容` + 一个 `keep` 按钮；标题加一句话，看得懂才点，不点就永远不写，48 小时内不重复 |
 | **L2** 常识、一次性参数、凭据的值 | 永不写入 |
 
+这些行只属于产生它的那一轮：重进会话就没了，历史里只留正文。
+
 触发词：`记住`、`记一下`、`上次`、`规范`、`约定`、`路径`、`凭据怎么取`。
 
 | Case | Behaviour |
 | --- | --- |
 | **L0** you ask it to remember | written immediately, one confirmation line |
-| **L1** it spots something worth keeping | one muted line `memory · keep "X"?` with a single `keep` button — never a question, no typing, nothing written unless you click, at most once per two days |
+| **L1** it spots something worth keeping | one muted line `memory · keep? "X" — what would be remembered` with a single `keep` button — readable before you click, nothing written unless you click, at most once per two days |
 | **L2** common sense, one-off parameters, credential values | never written |
 
+Those lines belong to the turn that made them: reopening the session drops them, leaving only the prose in history.
+
 ## 点一下就存 / One click, no turn
 
 `keep` 是同源直写：不产生消息、不动输入框、不打断当前回复。按钮变 `kept` 就结束了。自动写入的行尾有个 `✕`，点它就把刚才那条移入归档。

package/TRIGGERS.md

@@ -22,15 +22,17 @@
 每次调用只占一行、灰色、12px：
 
 ```
-· memory · 2 hits · 96 chars
+· memory · 2 hits
 · memory · no hits
-· memory · saved "插件市场条目规范"              ✕
-· memory · keep "提交前先跑文案 lint"           [keep]
+· memory · saved "插件市场条目字段" — 目录条目要写应用名、一句话作用、图标地址     ✕
+· memory · keep? "发布前先跑文案检查" — 界面文字只留标签、值和动作，交付前跑脚本清零   [keep]
 · memory · skipped
-· memory · dropped "插件市场条目规范"
+· memory · dropped "插件市场条目字段"
 ```
 
-`keep` 按钮只在建议行出现。点一下直接写盘：不产生消息、不动输入框、不占用下一轮对话，按钮变 `kept` 并禁用。同源写盘通道不通时才退回旧路——插入 `保留记忆「X」` 并排队，至少不丢这条建议。自动写入的行尾带 `✕`，点了把那一条移入归档（不删文件，可从归档取回）。不点就什么都不发生，那行过一会儿只是一段灰色历史。
+`keep` 按钮只在建议行出现。点一下直接写盘：不产生消息、不动输入框、不占用下一轮对话，按钮变 `kept` 并禁用。同源写盘通道不通时才退回旧路——插入 `保留记忆「X」` 并排队，至少不丢这条建议。自动写入的行尾带 `✕`，点了把那一条移入归档（不删文件，可从归档取回）。
+
+这些行只属于产生它的那一轮：重进会话时不再显示，历史里只留正文。行出现在调用本身的位置——一轮正在跑时，那就是对话的最下面，不会悬浮在输入框上方。
 
 ## 频率与退让
 

package/client.js

@@ -13,7 +13,7 @@ window.__ModuleLoader__.load({
       memory_forget: 'memory · dropping',
     };
 
-    const KEEP = { idle: 'keep', saving: 'saving', saved: 'kept', kept: 'kept' };
+    const KEEP = { idle: 'keep', saving: 'saving', saved: 'kept' };
     const ROW = { display: 'flex', alignItems: 'center', gap: '6px', padding: '1px 0', fontSize: '12px', lineHeight: '1.6', opacity: 0.7 };
     const DOT = { flex: '0 0 auto', opacity: 0.8 };
     const LABEL = { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' };
@@ -41,6 +41,13 @@ window.__ModuleLoader__.load({
       return match ? match[1] : null;
     };
 
+    /** 只在产生这行的那一轮显示。 */
+    const useLive = (phase) => {
+      const live = React.useRef(phase !== 'result');
+      if (phase !== 'result') live.current = true;
+      return live.current;
+    };
+
     const post = (payload) => {
       if (typeof fetch !== 'function') return Promise.resolve(null);
       return fetch('/lite-memory/keep', {
@@ -53,37 +60,24 @@ window.__ModuleLoader__.load({
     };
 
     const Row = (props) => {
+      if (!useLive(props.phase)) return null;
       const line = props.phase === 'preparing' ? null : firstLine(settledText(props.block));
       return h('div', { 'data-tool': props.toolName, style: ROW }, h('span', { style: DOT }, '·'), h('span', { style: LABEL }, line ?? RUNNING[props.toolName] ?? 'memory'));
     };
 
     /** 建议行：一个「keep」按钮，点了直接写盘。 */
     const SuggestRow = (props) => {
+      if (!useLive(props.phase)) return null;
       const [state, setState] = React.useState('idle');
       const text = props.phase === 'preparing' ? null : settledText(props.block);
       const label = firstLine(text) ?? RUNNING.memory_suggest;
       const title = quoted(text);
       const cwd = typeof props.cwd === 'string' ? props.cwd : '';
-      const actions = props.inputActions;
       const canKeep = Boolean(title) && Boolean(cwd) && state === 'idle';
       const keep = () => {
         if (!canKeep) return;
         setState('saving');
-        /** 写盘通道不通时退回一条普通消息，至少不丢这条建议。 */
-        const fallback = () => {
-          try {
-            const message = `保留记忆「${title}」`;
-            const span = actions && typeof actions.captureInsertion === 'function' ? actions.captureInsertion() : null;
-            const inserted = span && actions && typeof actions.insertText === 'function' ? actions.insertText(message, span) : false;
-            if (inserted === false && actions && typeof actions.setDraft === 'function') actions.setDraft(message);
-            if (actions && typeof actions.submit === 'function') actions.submit();
-            setState('kept');
-          } catch {
-            setState('idle');
-          }
-        };
-        if (typeof fetch !== 'function') return fallback();
-        post({ op: 'keep', title, cwd }).then((value) => setState(value && value.ok ? 'saved' : 'kept'));
+        post({ op: 'keep', title, cwd }).then((value) => setState(value && value.ok ? 'saved' : 'idle'));
       };
       const button = title
         ? h('button', { type: 'button', onClick: keep, disabled: !canKeep, 'aria-label': '保留这条记忆', style: canKeep ? KEEP_ON : KEEP_OFF }, KEEP[state] ?? KEEP.idle)
@@ -93,6 +87,7 @@ window.__ModuleLoader__.load({
 
     /** 自动写入行：一个「✕」，点了把它移入归档。 */
     const SavedRow = (props) => {
+      if (!useLive(props.phase)) return null;
       const [state, setState] = React.useState('idle');
       const text = props.phase === 'preparing' ? null : settledText(props.block);
       const title = quoted(text);

package/index.js

@@ -111,8 +111,8 @@ function keepHandler(webServer) {
 const SAVE_PARAMS = {
   type: 'object',
   properties: {
-    title: { type: 'string', description: `标题，名词短语，不超过 ${LIMITS.titleChars} 字` },
-    summary: { type: 'string', description: `一句话摘要，名词短语，不超过 ${LIMITS.summaryChars} 字` },
+    title: { type: 'string', description: `标题：名词短语，用户一眼能认出是哪件事，不超过 ${LIMITS.titleChars} 字` },
+    summary: { type: 'string', description: `一句话说清要记的内容本身——用户只看这一行决定留不留，名词短语，不超过 ${LIMITS.summaryChars} 字` },
     body: { type: 'string', description: '正文 markdown。只写指针与要点，不抄录长文档' },
     kind: { type: 'string', enum: ['preference', 'convention', 'procedure', 'pointer', 'pitfall', 'credential_hint', 'note'], description: '条目类型' },
     tags: { type: 'array', items: { type: 'string' }, description: '最多 5 个标签' },
@@ -164,20 +164,21 @@ export function apply(ctx) {
         properties: {
           id: { type: 'string' },
           title: { type: 'string' },
+          summary: { type: 'string' },
           merged: { type: 'boolean' },
         },
-        required: ['id', 'title', 'merged'],
+        required: ['id', 'title', 'summary', 'merged'],
         additionalProperties: false,
       },
       render: (value) => [{
         type: 'text',
-        text: value.merged ? `memory · merged "${value.title}"` : `memory · saved "${value.title}"`,
+        text: `${value.merged ? 'memory · merged' : 'memory · saved'} "${value.title}"${value.summary ? ` — ${value.summary}` : ''}`,
       }],
     },
     execute: async (args, execution) => {
       const scope = scopeOf(cwdOf(execution));
       const saved = upsert(scope, args);
-      return { id: saved.record.id, title: saved.record.title, merged: saved.merged };
+      return { id: saved.record.id, title: saved.record.title, summary: saved.record.summary, merged: saved.merged };
     },
   }), 'lite-memory: memory_save');
 
@@ -191,22 +192,26 @@ export function apply(ctx) {
         properties: {
           asked: { type: 'boolean' },
           title: { type: 'string' },
+          summary: { type: 'string' },
           reason: { type: 'string' },
         },
-        required: ['asked', 'title'],
+        required: ['asked', 'title', 'summary'],
         additionalProperties: false,
       },
       render: (value) => [{
         type: 'text',
-        text: value.asked ? `memory · keep "${value.title}"?` : 'memory · skipped',
+        text: value.asked
+          ? `memory · keep? "${value.title}"${value.summary ? ` — ${value.summary}` : ''}`
+          : 'memory · skipped',
       }],
     },
     execute: async (args, execution) => {
       const scope = scopeOf(cwdOf(execution));
       const gate = suggestionGate(scope, args.title);
-      if (!gate.ok) return { asked: false, title: String(args.title ?? ''), reason: gate.reason };
+      const summary = String(args.summary ?? '');
+      if (!gate.ok) return { asked: false, title: String(args.title ?? ''), summary, reason: gate.reason };
       noteSuggestion(scope, args, 'asked');
-      return { asked: true, title: String(args.title ?? '') };
+      return { asked: true, title: String(args.title ?? ''), summary };
     },
   }), 'lite-memory: memory_suggest');
 
@@ -227,7 +232,7 @@ export function apply(ctx) {
       },
       render: (value) => [{
         type: 'text',
-        text: value.count === 0 ? 'memory · no hits' : `memory · ${value.count} hits · ${value.chars} chars\n${value.index}`,
+        text: value.count === 0 ? 'memory · no hits' : `memory · ${value.count} hits\n${value.index}`,
       }],
     },
     execute: async (args, execution) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lite-memory",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "On-demand memory for the DeepSeek Harness: nothing in the system prompt, one muted line only when something is saved, hit or suggested.",
   "type": "module",
   "main": "index.js",