@yolk_vat-y/dsh-project-memory 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,10 +1,19 @@
 # Changelog
 
-## Unreleased
+## 0.1.4 (2026-08-25)
+
+### 修复
+- watch 轮询改用每轮从磁盘重载的存储快照：此前 `addRoot` 时加载的内存副本永不刷新，外部（`index_doc` / lazy）新索引的条目既会被重复 LLM 摘要，又会在轮询保存时被旧快照整体覆盖丢失
+- `watch_repo` 现在同时把目标 root 记入会话 cwd 的 store watchlist：此前非 cwd 项目的 watch 重启插件后不会恢复；停止 watch 时同步从两侧移除
+- 损坏的存储 JSON 不再静默当空处理：解析失败时坏文件改名备份为 `*.{时间戳}.corrupt` 并输出错误日志后再空启动，避免下次写入覆盖原始数据
+- doc↔symbol 链接对纯拉丁符号名启用词边界匹配：符号名 `run` 不再命中文档里的 `runtime` / `runner`
 
 ### 新增
 - 发布 npm 包 `@yolk_vat-y/dsh-project-memory`，支持 `dsh plugin --profile web add @yolk_vat-y/dsh-project-memory -w` 直接安装；`publishConfig.access` 设为 `public`（scoped 包默认 restricted，不设置会导致他人安装 403）
 
+### 测试
+- 测试从 101 项增至 110 项：watch 外部写入不重索引、外部条目在轮询保存后存活、损坏备份、链接词边界、watch 会话镜像增删
+
 ## 0.1.3 (2026-08-23)
 
 ### 修复

package/README.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | [简体中文](README.zh-CN.md)
 
-[![ci](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/00080000/dsh-project-memory)
+[![ci](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![npm](https://img.shields.io/npm/v/@yolk_vat-y/dsh-project-memory)](https://www.npmjs.com/package/@yolk_vat-y/dsh-project-memory) [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/00080000/dsh-project-memory)
 
 Persistent project memory for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(dsh) agents. Indexes documents (PDF / Markdown / txt) and code symbols into a per-workspace store, refreshes them automatically, and recalls them with source citations — documents are cross-linked to the code symbols they reference.
 
@@ -52,7 +52,7 @@ dsh plugin --profile web add @yolk_vat-y/dsh-project-memory -w
 A prebuilt tarball is published with each release, installable without a build step:
 
 ```bash
-dsh plugin --profile web add /path/to/dsh-project-memory-0.1.3.tgz
+dsh plugin --profile web add /path/to/dsh-project-memory-0.1.4.tgz
 ```
 
 Each indexed project has its own store at `<root>/.dsh-project-memory/`. Add it to `.gitignore` if it should not be committed.
@@ -89,7 +89,7 @@ The tools below are **invoked by the agent**, not typed by the user. In the chat
 
 - **In-process locking** — store writes are serialized per memory directory within one dsh process; two dsh instances sharing a project store is last-writer-wins.
 - **Watch poll holds the lock** — while the watcher re-indexes changed docs (LLM summarization), `remember`/`forget` queue behind it. Overlapping polls serialize on the same lock: safe, but they can pile up on very large diffs.
-- **Silent corruption recovery** — a corrupt store JSON silently falls back to empty and is rebuilt on the next write; there is no warning.
+- **Silent corruption recovery** — a corrupt store JSON falls back to empty for that file and is rebuilt on the next write; the broken file is renamed to `*.corrupt` with an error logged, but its data cannot be recovered.
 - **Absolute source paths** — entries cite absolute paths; moving a project invalidates citations until the next re-index.
 - **`forget` by query is eager** — keyword deletion matches at ≥0.5 token overlap and may remove several notes at once; prefer deleting by id for precision.
 - **Cross-language recall depends on index time** — with `llmQueryExpansion` off, a Chinese-only query reaches English content through bilingual keywords captured when docs are indexed, plus doc↔symbol links. Stores indexed before v0.1.1 gain bilingual keywords as files change, or immediately via `index_repo` with `reindex: true`.

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | [简体中文](README.zh-CN.md)
 
-[![ci](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/00080000/dsh-project-memory)
+[![ci](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/00080000/dsh-project-memory/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![npm](https://img.shields.io/npm/v/@yolk_vat-y/dsh-project-memory)](https://www.npmjs.com/package/@yolk_vat-y/dsh-project-memory) [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/00080000/dsh-project-memory)
 
 为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）agent 提供持久化的项目记忆。将文档（PDF / Markdown / txt）与代码符号索引进每个工作区独立的存储库，自动维护更新，召回时附源文件引用——文档自动交叉链接到其提及的代码符号。
 
@@ -52,7 +52,7 @@ dsh plugin --profile web add @yolk_vat-y/dsh-project-memory -w
 每个版本会附带预构建 tarball，无需构建步骤即可安装：
 
 ```bash
-dsh plugin --profile web add /path/to/dsh-project-memory-0.1.3.tgz
+dsh plugin --profile web add /path/to/dsh-project-memory-0.1.4.tgz
 ```
 
 每个被索引的项目在 `<root>/.dsh-project-memory/` 下有独立存储。如无需入库，可加入 `.gitignore`。
@@ -89,7 +89,7 @@ dsh plugin --profile web add /path/to/dsh-project-memory-0.1.3.tgz
 
 - **进程内锁** — 存储写入按记忆目录在一个 dsh 进程内串行化；两个 dsh 实例共享同一项目存储时后写覆盖先写。
 - **watch 轮询持锁** — watcher 重索引变更文档（LLM 摘要）期间，`remember`/`forget` 会排队等待。重叠轮询靠同一把锁串行：安全，但大改动时可能堆积。
-- **损坏静默重建** — 存储 JSON 损坏时静默回落为空并在下次写入时重建，无告警。
+- **损坏静默重建** — 存储 JSON 损坏时该文件回落为空并在下次写入时重建；坏文件会改名备份为 `*.corrupt` 并输出错误日志，但该文件内的数据无法恢复。
 - **绝对路径引用** — 条目引用绝对路径；项目搬家后引用失效，重建索引即恢复。
 - **`forget` 按关键词删除偏激进** — 关键词删除按 ≥0.5 token 重叠匹配，可能一次删掉多条；追求精确请用 id 删除。
 - **跨语种召回依赖索引时** — `llmQueryExpansion` 关闭时，纯中文查询靠索引时捕获的双语 keywords 和 doc↔symbol 链接触达英文内容。v0.1.1 之前建立的索引随文件变更逐步获得双语关键词，或用 `index_repo` 的 `reindex: true` 立即重建。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolk_vat-y/dsh-project-memory",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Persistent project memory for dsh agents: index docs (PDF/Markdown/text) and code symbols into a searchable per-workspace store, recall them with cited sources, and keep experience entries (problems -> solutions) searchable on demand.",
   "type": "module",
   "main": "src/index.js",

package/src/link.js

@@ -1,3 +1,11 @@
+const LATIN_NAME = /^[A-Za-z0-9_]+$/
+
+function buildMatcher(name) {
+  const lower = name.toLowerCase()
+  if (!LATIN_NAME.test(name)) return { lower, re: null }
+  return { lower, re: new RegExp(`(?<![a-z0-9_$])${lower}(?![a-z0-9_$])`) }
+}
+
 export function linkEntries(store) {
   const all = store.allEntries()
   const symbols = all.filter((e) => e.type === 'symbol')
@@ -8,21 +16,21 @@ export function linkEntries(store) {
   for (const s of symbols) {
     const name = s.keywords[0]
     if (!name || name.length < 3) continue
-    if (!symbolByName.has(name)) symbolByName.set(name, [])
-    symbolByName.get(name).push(s)
+    if (!symbolByName.has(name)) symbolByName.set(name, { syms: [], ...buildMatcher(name) })
+    symbolByName.get(name).syms.push(s)
   }
 
   let links = 0
   for (const doc of docs) {
     const linked = new Set()
     const haystack = `${doc.title || ''} ${doc.summary || ''} ${doc.keywords ? doc.keywords.join(' ') : ''}`.toLowerCase()
-    for (const [name, syms] of symbolByName) {
-      if (haystack.includes(name.toLowerCase())) {
-        for (const s of syms) {
-          const before = linked.size
-          linked.add(s.id)
-          if (linked.size > before) links++
-        }
+    for (const [, entry] of symbolByName) {
+      const hit = entry.re ? entry.re.test(haystack) : haystack.includes(entry.lower)
+      for (const s of entry.syms) {
+        if (!hit) break
+        const before = linked.size
+        linked.add(s.id)
+        if (linked.size > before) links++
       }
     }
     doc.linkedSymbols = linked.size ? [...linked] : undefined

package/src/store.js

@@ -29,11 +29,24 @@ export async function withStoreLock(memoryDir, fn) {
 }
 
 function loadJson(filePath, fallback) {
+  let raw
   try {
-    return JSON.parse(readFileSync(filePath, 'utf8'))
+    raw = readFileSync(filePath, 'utf8')
   } catch {
     return fallback
   }
+  try {
+    return JSON.parse(raw)
+  } catch {
+    const backup = `${filePath}.${Date.now()}.corrupt`
+    try {
+      renameSync(filePath, backup)
+      console.error(`[dsh-project-memory] corrupted ${path.basename(filePath)} moved to ${path.basename(backup)}; starting fresh`)
+    } catch (err) {
+      console.error(`[dsh-project-memory] corrupted ${path.basename(filePath)} could not be backed up: ${err.message}`)
+    }
+    return fallback
+  }
 }
 
 function writeJsonAtomic(filePath, data) {

package/src/tools/watch-repo.js

@@ -1,6 +1,6 @@
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import path from 'node:path'
-import { memoryRootFor } from '../util/fs.js'
+import { memoryRootFor, resolveIndexRoot } from '../util/fs.js'
 import { ProjectMemoryStore, withStoreLock } from '../store.js'
 
 export function watchRepoTool(watchManager, config) {
@@ -25,19 +25,33 @@ export function watchRepoTool(watchManager, config) {
       schema: { type: 'string' },
       render: (_args, value) => [{ type: 'text', text: value }],
     },
-    async execute(args) {
+    async execute(args, exec) {
       const root = path.resolve(args.root)
       const memoryDir = memoryRootFor(root, config.memoryDir)
-      return withStoreLock(memoryDir, () => {
+      const sessionRoot = resolveIndexRoot(exec)
+      const sessionMemoryDir = memoryRootFor(sessionRoot, config.memoryDir)
+      return withStoreLock(memoryDir, async () => {
         const store = new ProjectMemoryStore(memoryDir).load()
+        const mirrorSessionWatchlist = async (present) => {
+          if (path.resolve(sessionMemoryDir) === path.resolve(memoryDir)) return
+          await withStoreLock(sessionMemoryDir, () => {
+            const sessionStore = new ProjectMemoryStore(sessionMemoryDir).load()
+            const before = sessionStore.watchlist.length
+            sessionStore.watchlist = sessionStore.watchlist.filter((r) => r !== root)
+            if (present) sessionStore.addWatch(root)
+            if (sessionStore.watchlist.length !== before || present) sessionStore.save()
+          })
+        }
         if (args.watch === false) {
           watchManager.removeRoot(root)
           store.watchlist = store.watchlist.filter((r) => r !== root)
           store.save()
+          await mirrorSessionWatchlist(false)
           return `Stopped watching: ${root}`
         }
         store.addWatch(root)
         store.save()
+        await mirrorSessionWatchlist(true)
         watchManager.addRoot(root)
         watchManager.start(config.watchInterval * 1000)
         return `Watching ${root} (interval ${config.watchInterval}s). Docs/code changes will be re-indexed silently.`

package/src/watch.js

@@ -64,6 +64,7 @@ export class WatchManager {
   async pollRoot(root, state) {
     const memoryDir = memoryRootFor(root, this.config.memoryDir)
     await withStoreLock(memoryDir, async () => {
+      state.store = new ProjectMemoryStore(memoryDir).load()
       const files = walkDir(root)
       const seen = new Set()
       let changed = 0