@fonlan/dsh-gitmemo 0.3.1 → 0.3.2

package/README.md

@@ -103,7 +103,9 @@ git -C .mem show <commit-hash>
    `mem_write` every completed repo-related task that still lacks a memory and whose outcome is
    **valuable/reusable** (or was explicitly asked to be remembered). Never duplicate an
    already-written entry. Never write for pure Q&A, incomplete tasks, non-repo work, or purely
-   operational git actions.
+   operational git actions. `keywords` should be task-related words NOT already present in
+   `title` / `summary` (中英文同义词 both fine) — words already there are searchable via
+   `title` / `summary` themselves, so repeating them does not improve recall.
 4. **User correction.** If a stored conclusion is outdated and a replacement exists →
    `mem_replace` (never delete-then-write). If it is obsolete with no replacement →
    `mem_delete` with a `reason`.

package/README.zh.md

@@ -94,7 +94,7 @@ git -C .mem show <commit-hash>
    `mem_read` 5 条最相关记忆；用 `skip` + 返回的 `snapshot` 翻页。
 3. **会话结束检查点 —— 唯一的写入路径。** 对话即将结束时，`mem_write` **每一条**已完成、与仓库
    相关、且结论**有价值/可复用**（或用户明确要求记住）但还没有记忆的任务。绝不重复写已存在的条目。
-   纯问答、未完成任务、与仓库无关的工作、纯操作性的 git 动作一律不写。
+   纯问答、未完成任务、与仓库无关的工作、纯操作性的 git 动作一律不写。`keywords` 应选用与任务相关但未出现在 `title` / `summary` 中的词（中英文同义词皆可）——`title` / `summary` 已有的词本身就能被检索到，重复它们不会提高召回率。
 4. **用户更正。** 已存结论过时且有替代结论 → `mem_replace`（禁止先 delete 再 write）；结论作废且无
    替代 → 带 `reason` 的 `mem_delete`。
 5. **子代理结果。** 是否形成一条会话级记忆，由根 Agent 汇总后决定。

package/lib/index.js

@@ -216,7 +216,7 @@ function registerMemTools(ctx, config) {
     }));
     ctx.tools.register(defineTool({
         name: "mem_write",
-        description: "Store a completed task outcome in the gitmemo long-term memory (.mem git repo). Write ONLY when the task is complete AND repo-related AND the outcome is valuable/reusable OR the user explicitly asked to remember. Entries are immutable: title (single line, ≤200 chars, \"[module] action + object\"), summary (≤4000 chars), keywords (2-12, include 中英文同义词) and content (markdown body; the engine generates front matter) are all required; related_branches/related_paths are optional. Corrections use mem_replace, withdrawal uses mem_delete — never rewrite in place.",
+        description: "Store a completed task outcome in the gitmemo long-term memory (.mem git repo). Write ONLY when the task is complete AND repo-related AND the outcome is valuable/reusable OR the user explicitly asked to remember. Entries are immutable: title (single line, ≤200 chars, \"[module] action + object\"), summary (≤4000 chars), keywords (2-12, include 中英文同义词) and content (markdown body; the engine generates front matter) are all required; related_branches/related_paths are optional. Keywords must ADD new search angles — pick task-related terms (中英文同义词 both fine) that are NOT already present in title/summary: words already in title/summary are searchable via those fields themselves, so repeating them does not improve recall. Corrections use mem_replace, withdrawal uses mem_delete — never rewrite in place.",
         parameters: {
             title: {
                 type: "string",
@@ -231,7 +231,7 @@ function registerMemTools(ctx, config) {
             keywords: {
                 ...KEYWORDS_ARRAY,
                 required: true,
-                description: "2-12 keywords (1-64 chars each); include 中英文同义词, e.g. [\"auth\", \"rate-limit\", \"登录\", \"限流\"]."
+                description: "2-12 keywords (1-64 chars each); task-related words NOT already present in title/summary (重复 title/summary 已有的词不会提高召回率); include 中英文同义词, e.g. [\"auth\", \"rate-limit\", \"登录\", \"限流\"]."
             },
             content: {
                 type: "string",
@@ -333,7 +333,7 @@ function registerMemTools(ctx, config) {
             keywords: {
                 ...KEYWORDS_ARRAY,
                 required: true,
-                description: "2-12 keywords (1-64 chars each); include 中英文同义词."
+                description: "2-12 keywords (1-64 chars each); task-related words NOT already present in title/summary; include 中英文同义词."
             },
             content: {
                 type: "string",
@@ -386,6 +386,7 @@ function registerPromptSection(ctx) {
             "- BEFORE WORK — search: 仓库相关任务开始前提取 1–12 个中英文关键词调用 mem_search（含中英文同义词）；纯闲聊和通用问答无需搜索。",
             "- RESULT PRESELECT — 根据 title、summary、keywords、score 和 matched keywords 选择最多 5 条执行 mem_read，复用相关结论；无相关结果时用返回的 snapshot + skip 翻页。",
             "- END-OF-SESSION CHECKPOINT — the ONLY write path: 会话结束时回顾全程，仅当结论有价值、可复用或用户明确要求记住时 mem_write；纯问答、未完成任务、非仓库工作、纯操作类 git 动作（仅 commit/push）不写；避免语义重复。",
+            "- KEYWORD SELECTION — mem_write/mem_replace 的 keywords 应选择与任务相关但未出现在 title/summary 中的词（中英文同义词皆可）；title/summary 里已有的词本身就能被检索到，重复它们不会提高召回率。",
             "- USER CORRECTION — 用户更正已有结论：有替代结论时调用 mem_replace（不得先 delete 再 write）；结论作废且无替代时调用带 reason 的 mem_delete。",
             "- SUBAGENT RESULTS — 子代理结果由根 Agent 汇总后决定是否形成一条会话级记忆。"
         ].join("\n")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-gitmemo",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Git-backed long-term memory for DeepSeek Harness: a local .mem git repo (single main branch, immutable entries, structured commit messages) with mem_search / mem_read / mem_write / mem_delete / mem_replace tools and fully automatic legacy migration (no CLI needed; the CLI remains for explicit control), auto-managed by the root agent with zero manual steps.",
   "author": "fonlan",
   "publishConfig": {
@@ -49,8 +49,8 @@
     "release:major": "npm version major && git push && git push --tags"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2",
     "@types/node": "^26.2.0",
     "typescript": "^5.5.0"
   },