dsh-lite-memory 0.2.3 → 0.2.5

package/README.md

@@ -16,7 +16,7 @@ Lightweight memory for the DeepSeek Harness. Nothing in the system prompt, nothi
 | 场景 | 行为 |
 | --- | --- |
 | **L0** 你明确要求「记住这个」 | 立即写盘，一条确认行 |
-| **L1** 它发现有跨会话价值的经验 | 一行灰字 `可记「X」` + 一个 `保留` 按钮；不写问句、不用你打字，不点就永远不写，48 小时内不重复 |
+| **L1** 它发现有跨会话价值的经验 | 一行灰字 `memory · keep? "X" — 要记的内容` + 一个 `keep` 按钮；标题加一句话，看得懂才点，不点就永远不写，48 小时内不重复 |
 | **L2** 常识、一次性参数、凭据的值 | 永不写入 |
 
 触发词：`记住`、`记一下`、`上次`、`规范`、`约定`、`路径`、`凭据怎么取`。
@@ -24,14 +24,14 @@ Lightweight memory for the DeepSeek Harness. Nothing in the system prompt, nothi
 | Case | Behaviour |
 | --- | --- |
 | **L0** you ask it to remember | written immediately, one confirmation line |
-| **L1** it spots something worth keeping | one muted line `可记「X」` with a single `保留` 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 |
 
 ## 点一下就存 / One click, no turn
 
-「保留」是同源直写：不产生消息、不动输入框、不打断当前回复。按钮变 `已保存` 就结束了。
+`keep` 是同源直写：不产生消息、不动输入框、不打断当前回复。按钮变 `kept` 就结束了。自动写入的行尾有个 `✕`，点它就把刚才那条移入归档。
 
-`保留` writes straight to disk from the page: no message, no extra model turn, the input box untouched. The button turns into `已保存` and that is the whole interaction.
+`keep` writes straight to disk from the page: no message, no extra model turn, the input box untouched. The button turns into `kept` and that is the whole interaction. An auto-saved line ends with `✕`: click it and that entry moves to the archive.
 
 ## 为什么轻 / Why it stays light
 

package/TRIGGERS.md

@@ -4,8 +4,8 @@
 
 | 档 | 谁发起 | 什么时候 | 存不存 | 用户看到什么 |
 | --- | --- | --- | --- | --- |
-| L0 | 用户 | 说「记住 / 以后 / 别用 / 下次」这类话 | 直接存 | `记忆 · 已存「X」` |
-| L1 | 模型 | 用户没说，但这经验跨会话有用 | 点了才存 | `可记「X」` + 「保留」按钮 |
+| L0 | 用户 | 说「记住 / 以后 / 别用 / 下次」这类话 | 直接存 | `memory · saved "X"` + `✕` |
+| L1 | 模型 | 用户没说，但这经验跨会话有用 | 点了才存 | `memory · keep "X"?` + `keep` 按钮 |
 | L2 | — | 常识、一次性参数、临时路径 | 不存 | 无 |
 
 ## 什么时候触发
@@ -22,15 +22,15 @@
 每次调用只占一行、灰色、12px：
 
 ```
-· 记忆 · 命中 2 条 · 引用 96 字
-· 记忆 · 无匹配
-· 记忆 · 已存「插件市场条目规范」
-· 可记「提交前先跑文案 lint」        [保留]
-· 记忆 · 未建议：今天已经建议过「插件市场条目规范」
-· 记忆 · 已归档「插件市场条目规范」
+· memory · 2 hits · 96 chars
+· memory · no hits
+· memory · saved "插件市场条目字段" — 目录条目要写应用名、一句话作用、图标地址     ✕
+· memory · keep? "发布前先跑文案检查" — 界面文字只留标签、值和动作，交付前跑脚本清零   [keep]
+· memory · skipped
+· memory · dropped "插件市场条目字段"
 ```
 
-「保留」按钮只在 `可记` 那一行出现。点一下直接写盘：不产生消息、不动输入框、不占用下一轮对话，按钮变 `已保存` 并禁用。同源写盘通道不通时才退回旧路——插入 `保留记忆「X」` 并排队，至少不丢这条建议，按钮显示 `已保留`。不点就什么都不发生，那行过一会儿只是一段灰色历史。
+`keep` 按钮只在建议行出现。点一下直接写盘：不产生消息、不动输入框、不占用下一轮对话，按钮变 `kept` 并禁用。同源写盘通道不通时才退回旧路——插入 `保留记忆「X」` 并排队，至少不丢这条建议。自动写入的行尾带 `✕`，点了把那一条移入归档（不删文件，可从归档取回）。不点就什么都不发生，那行过一会儿只是一段灰色历史。
 
 ## 频率与退让
 

package/client.js

@@ -6,47 +6,63 @@ window.__ModuleLoader__.load({
 
     /** One muted line per memory call: a summary, never the payload. */
     const RUNNING = {
-      memory_save: '记忆 · 写入中',
-      memory_suggest: '记忆 · 判断中',
-      memory_search: '记忆 · 检索中',
-      memory_read: '记忆 · 读取中',
-      memory_forget: '记忆 · 归档中',
+      memory_save: 'memory · saving',
+      memory_suggest: 'memory · checking',
+      memory_search: 'memory · searching',
+      memory_read: 'memory · reading',
+      memory_forget: 'memory · dropping',
     };
 
-    const LABELS = { idle: '保留', saving: '保存中', saved: '已保存', kept: '已保留' };
+    const KEEP = { idle: 'keep', saving: 'saving', saved: 'kept', kept: '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' };
-    const KEEP = { flex: '0 0 auto', border: '1px solid currentColor', background: 'transparent', color: 'inherit', borderRadius: '999px', padding: '0 8px', fontSize: '12px', lineHeight: '18px' };
-    const KEEP_ON = { ...KEEP, opacity: 0.9, cursor: 'pointer' };
-    const KEEP_OFF = { ...KEEP, opacity: 0.45, cursor: 'default' };
+    const KEEP_STYLE = { flex: '0 0 auto', border: '1px solid currentColor', background: 'transparent', color: 'inherit', borderRadius: '999px', padding: '0 8px', fontSize: '12px', lineHeight: '18px' };
+    const KEEP_ON = { ...KEEP_STYLE, opacity: 0.9, cursor: 'pointer' };
+    const KEEP_OFF = { ...KEEP_STYLE, opacity: 0.45, cursor: 'default' };
+    const DROP = { flex: '0 0 auto', border: 'none', background: 'transparent', color: 'inherit', padding: '0 2px', fontSize: '12px', lineHeight: '18px', opacity: 0.55, cursor: 'pointer' };
 
-    /** 结果文本已经是中文，这里只取第一行。 */
     const settledText = (block) => {
       if (block === undefined || block === null || !('kind' in block)) return null;
       const content = Array.isArray(block.content) ? block.content : [];
       for (const item of content) {
         if (item !== null && item.type === 'text' && typeof item.text === 'string' && item.text.length > 0) return item.text;
       }
-      if (block.error !== undefined) return '记忆 · 已中止';
-      if (block.isError === true) return '记忆 · 失败';
+      if (block.error !== undefined) return 'memory · stopped';
+      if (block.isError === true) return 'memory · failed';
       return null;
     };
 
     const firstLine = (value) => (typeof value === 'string' ? value.split('\n')[0] : null);
 
+    /** 结果行里带标题时把它取出来，用于点按钮后原路回传。 */
+    const quoted = (value) => {
+      const match = typeof value === 'string' ? /"([^"]+)"/.exec(value) : null;
+      return match ? match[1] : null;
+    };
+
+    const post = (payload) => {
+      if (typeof fetch !== 'function') return Promise.resolve(null);
+      return fetch('/lite-memory/keep', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(payload),
+      })
+        .then((response) => (response.ok ? response.json() : null))
+        .catch(() => null);
+    };
+
     const Row = (props) => {
       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] ?? '记忆'));
+      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) => {
       const [state, setState] = React.useState('idle');
       const text = props.phase === 'preparing' ? null : settledText(props.block);
-      const label = firstLine(text) ?? RUNNING.memory_suggest ?? '记忆';
-      const match = typeof text === 'string' && text.startsWith('可记「') ? /「([^」]+)」/.exec(text) : null;
-      const title = match ? match[1] : null;
+      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';
@@ -67,28 +83,39 @@ window.__ModuleLoader__.load({
           }
         };
         if (typeof fetch !== 'function') return fallback();
-        fetch('/lite-memory/keep', {
-          method: 'POST',
-          headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ title, cwd }),
-        })
-          .then((response) => (response.ok ? response.json() : null))
-          .then((value) => setState(value && value.ok ? 'saved' : 'kept'))
-          .catch(() => setState('kept'));
+        post({ op: 'keep', title, cwd }).then((value) => setState(value && value.ok ? 'saved' : 'kept'));
       };
       const button = title
-        ? h('button', { type: 'button', onClick: keep, disabled: !canKeep, 'aria-label': '保留这条记忆', style: canKeep ? KEEP_ON : KEEP_OFF }, LABELS[state] ?? LABELS.idle)
+        ? h('button', { type: 'button', onClick: keep, disabled: !canKeep, 'aria-label': '保留这条记忆', style: canKeep ? KEEP_ON : KEEP_OFF }, KEEP[state] ?? KEEP.idle)
         : null;
       return h('div', { 'data-tool': props.toolName, style: ROW }, h('span', { style: DOT }, '·'), h('span', { style: LABEL }, label), button);
     };
 
+    /** 自动写入行：一个「✕」，点了把它移入归档。 */
+    const SavedRow = (props) => {
+      const [state, setState] = React.useState('idle');
+      const text = props.phase === 'preparing' ? null : settledText(props.block);
+      const title = quoted(text);
+      const cwd = typeof props.cwd === 'string' ? props.cwd : '';
+      const canDrop = Boolean(title) && Boolean(cwd) && state === 'idle';
+      const drop = () => {
+        if (!canDrop) return;
+        setState('saving');
+        post({ op: 'undo', title, cwd }).then((value) => setState(value && value.ok ? 'dropped' : 'idle'));
+      };
+      const label = state === 'dropped' ? 'memory · dropped' : firstLine(text) ?? RUNNING.memory_save;
+      const button = title && state !== 'dropped' ? h('button', { type: 'button', onClick: drop, disabled: !canDrop, 'aria-label': '删除这条记忆', style: DROP }, '✕') : null;
+      return h('div', { 'data-tool': props.toolName, style: ROW }, h('span', { style: DOT }, '·'), h('span', { style: LABEL }, label), button);
+    };
+
     return {
       inject: ['slots'],
       apply(ctx) {
-        for (const name of ['memory_save', 'memory_search', 'memory_read', 'memory_forget']) {
+        for (const name of ['memory_search', 'memory_read', 'memory_forget']) {
           ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({ name: 'tool.call.toolview', key: name }, Row));
         }
         ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({ name: 'tool.call.toolview', key: 'memory_suggest' }, SuggestRow));
+        ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({ name: 'tool.call.toolview', key: 'memory_save' }, SavedRow));
       },
     };
   },

package/index.js

@@ -66,7 +66,7 @@ function readJsonBody(req, limit = 8192) {
   });
 }
 
-/** 「保留」按钮的唯一入口：只认已经建议过的那条，不接收任意正文。 */
+/** 「保留」和「✕」的唯一入口：保留只认已经建议过的那条，删除只按标题找已有条目。 */
 function keepHandler(webServer) {
   return async (req, res) => {
     if (req.method !== 'POST') return sendJson(res, 405, { ok: false, reason: '只接受 POST' });
@@ -75,7 +75,8 @@ function keepHandler(webServer) {
       return sendJson(res, 403, { ok: false, reason: '来源不符' });
     }
     const pathname = String(req.url || '').split('?')[0];
-    if (pathname !== REMOTE_PATH + '/keep') return sendJson(res, 404, { ok: false, reason: '未知操作' });
+    const known = pathname === REMOTE_PATH + '/keep' || pathname === REMOTE_PATH + '/undo';
+    if (!known) return sendJson(res, 404, { ok: false, reason: '未知操作' });
     let body;
     try {
       body = await readJsonBody(req);
@@ -86,6 +87,16 @@ function keepHandler(webServer) {
     const title = typeof body.title === 'string' ? body.title : '';
     if (cwd.length === 0 || title.length === 0) return sendJson(res, 400, { ok: false, reason: '请求不完整' });
     const scope = scopeOf(cwd);
+    if (body.op === 'undo' || pathname === REMOTE_PATH + '/undo') {
+      const record = loadIndex(scope).entries.find((item) => item.title === title);
+      if (!record) return sendJson(res, 404, { ok: false, reason: '没有这条记忆' });
+      try {
+        forget(scope, record.id);
+        return sendJson(res, 200, { ok: true, title: record.title, id: record.id });
+      } catch (error) {
+        return sendJson(res, 400, { ok: false, reason: error instanceof Error ? error.message : '删除失败' });
+      }
+    }
     const draft = findSuggestion(scope, title);
     if (!draft) return sendJson(res, 404, { ok: false, reason: '没有待保留的建议' });
     try {
@@ -100,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 个标签' },
@@ -153,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.title}」${value.merged ? '（并入了同主题条目）' : ''}`,
+        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');
 
@@ -180,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 ? `可记「${value.title}」` : `记忆 · 未建议：${value.reason ?? ''}`,
+        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');
 
@@ -216,7 +232,7 @@ export function apply(ctx) {
       },
       render: (value) => [{
         type: 'text',
-        text: value.count === 0 ? '记忆 · 无匹配' : `记忆 · 命中 ${value.count} 条 · 引用 ${value.chars} 字\n${value.index}`,
+        text: value.count === 0 ? 'memory · no hits' : `memory · ${value.count} hits · ${value.chars} chars\n${value.index}`,
       }],
     },
     execute: async (args, execution) => {
@@ -264,7 +280,7 @@ export function apply(ctx) {
       },
       render: (value) => [{
         type: 'text',
-        text: `记忆 · 已归档「${value.title}」`,
+        text: `memory · dropped "${value.title}"`,
       }],
     },
     execute: async (args, execution) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lite-memory",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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",