project-node-memory 1.4.0 → 1.4.1

package/lib/engine/commands.js

@@ -33,7 +33,7 @@ export function cmdRead(nodes, target, { node = false, raw = false, toc = false,
     // 不是节点：再看是不是一个 tscl 定义 id（值的老家可能只是一句话）
     const defsMap = defs || collectDefs(nodes).defs
     const def = defsMap.get(target)
-    if (def) return { text: formatDefRead(def, refsToDef(nodes, target)), code: 0, def: target }
+    if (def) return { text: formatDefRead(def, refsToDef(nodes, target, def.ownerTid)), code: 0, def: target }
     const cands = [...nodes.keys()]
       .filter((t) => t.startsWith(target) || t.startsWith(target + ':'))
       .sort()

package/lib/engine/defs.js

@@ -59,10 +59,13 @@ export function isMultiline(body) {
   return String(body || '').replace(/\s+$/, '').includes('\n')
 }
 
-/** 谁在正文里引用了这个定义（[[tscl="id"]]，或指向它的旧语法裸引用）→ [{tid,title,source,line,legacy}] */
-export function refsToDef(nodes, id) {
+/** 谁在正文里引用了这个定义（[[tscl="id"]]，或指向它的旧语法裸引用）→ [{tid,title,source,line,legacy}]
+ *  `ownerTid` 传进来的话，定义所在节点自己不算「引用者」——定义就写在它里面，
+ *  再把它列成一处引用会让计数虚高。 */
+export function refsToDef(nodes, id, ownerTid = '') {
   const out = []
   for (const node of nodes.values()) {
+    if (ownerTid && node.tid === ownerTid) continue
     const content = String(node.content || '')
     if (!content.includes(id)) continue
     for (const ref of extractRefs(content)) {
@@ -82,13 +85,14 @@ export function refsToDef(nodes, id) {
 
 /** 定义 → 人读文本（kb_read 按 tscl id 读、面板点宏时跳转用） */
 export function formatDefRead(def, refs = []) {
-  const src = String(def.source || '').split(/[\\/]/).filter(Boolean).slice(-2).join('/')
+  const fileOf = (source) => String(source || '').split('#')[0].split(/[\\/]/).filter(Boolean).slice(-2).join('/')
+  const src = fileOf(def.source)
   const lines = [`定义体 <tscl id="${def.id}"> · 定义在 ${def.ownerTid}${src ? `（${src}）` : ''}`, '', String(def.body || '').replace(/\s+$/, '')]
   if (def.count > 1) lines.push('', `重复定义 ${def.count} 处（必须只剩一处）: ${def.owners.join('、')}`)
   if (refs.length) {
     lines.push('', `被引用 ${refs.length} 处：`)
     for (const r of refs) {
-      const at = String(r.source || '').split(/[\\/]/).filter(Boolean).slice(-2).join('/')
+      const at = fileOf(r.source)
       lines.push(`- ${r.tid}${r.title ? ` · ${r.title}` : ''}${at ? `（${at}#L${r.line}）` : ''}${r.legacy ? `  ← 旧语法，建议 [[tscl="${def.id}"]]` : ''}`)
     }
   } else {

package/lib/engine/rename.js

@@ -15,10 +15,27 @@ import fs from 'node:fs'
 import path from 'node:path'
 import { slugify } from './parse.js'
 import { ROOT_TID } from './mdlib.js'
+import { resolve_path } from './render.js'
 
 const FENCE = '```'
 
-/** 把一段文本里的 oldTid 引用改写成 newTid（含 `oldTid:…` 子节点引用）。 */
+/** 把引用体（`[[…]]` 中间那段）换成新 TID；不是这个 TID 的返回 null。 */
+function rewriteInner(inner, oldTid, newTid) {
+  // 新语法：[[node="TID"]] / [[tscl="TID"]]
+  const quoted = /^(node|tscl)\s*=\s*"([^"]*)"$/.exec(inner)
+  if (quoted) {
+    const [, kind, id] = quoted
+    if (id === oldTid) return `[[${kind}="${newTid}"]]`
+    if (id.startsWith(oldTid + ':')) return `[[${kind}="${newTid}${id.slice(oldTid.length)}"]]`
+    return null
+  }
+  // 旧语法：[[TID]] / [[TID:子节点]]
+  if (inner === oldTid) return `[[${newTid}]]`
+  if (inner.startsWith(oldTid + ':')) return `[[${newTid}${inner.slice(oldTid.length)}]]`
+  return null
+}
+
+/** 把一段文本里的 oldTid 引用改写成 newTid（三种写法都覆盖，含 `oldTid:…` 子节点引用）。 */
 export function rewriteRefsInText(text, oldTid, newTid) {
   const lines = String(text).split('\n')
   const out = []
@@ -36,15 +53,10 @@ export function rewriteRefsInText(text, oldTid, newTid) {
     }
     out.push(
       line.replace(/\[\[([^[\]]+)\]\]/g, (whole, inner) => {
-        if (inner === oldTid) {
-          count += 1
-          return `[[${newTid}]]`
-        }
-        if (inner.startsWith(oldTid + ':')) {
-          count += 1
-          return `[[${newTid}${inner.slice(oldTid.length)}]]`
-        }
-        return whole
+        const next = rewriteInner(inner, oldTid, newTid)
+        if (next === null) return whole
+        count += 1
+        return next
       }),
     )
   }
@@ -97,11 +109,22 @@ export function renameFileNode(lib, target, newName, opts = {}) {
 
   let node = nodes.get(wanted)
   if (!node) {
-    // 允许直接给相对路径
-    const rel = wanted.split(path.sep).join('/')
-    node = [...nodes.values()].find((n) => n.kind === 'file' && String(n.source).split('#')[0] === rel)
+    // 允许直接给相对路径（doc/03-x.md、lessons/004-…）：走与 kb_read 相同的三级路径解析
+    let tid = null
+    try {
+      tid = resolve_path(nodes, wanted)
+    } catch {
+      tid = null
+    }
+    if (tid) node = nodes.get(tid)
+  }
+  if (!node) {
+    // source 存的是绝对路径，按「库根 + 相对路径」比较（大小写与分隔符都归一）
+    const rel = wanted.split(path.sep).join('/').replace(/^\.?\/+/, '')
+    const want = path.normalize(path.join(lib.nodekb, rel))
+    node = [...nodes.values()].find((n) => n.kind === 'file' && absOf(lib, n) === want)
   }
-  if (!node) throw new Error(`未找到节点: ${wanted}（可先 kb_read --toc 看 TID 清单）`)
+  if (!node) throw new Error(`未找到节点: ${wanted}（可先 kb_read --toc 看 TID 清单；也可以给相对路径 doc/03-x.md）`)
   if (node.kind !== 'file') {
     throw new Error(`只能重命名文件节点；${node.tid} 是 ${node.kind} 节点（目录改名请直接改文件夹）`)
   }
@@ -145,7 +168,7 @@ export function renameFileNode(lib, target, newName, opts = {}) {
       report.skipped.push({ path: relOf(lib, file), why: `读失败: ${e.message}` })
       continue
     }
-    if (!text.includes(oldRefPrefix(node.tid))) continue
+    if (!text.includes(node.tid)) continue
     const { text: next, count } = rewriteRefsInText(text, node.tid, newTid)
     if (!count) continue
     edits.push({ file, st1, next, count })
@@ -177,10 +200,6 @@ export function renameFileNode(lib, target, newName, opts = {}) {
   return report
 }
 
-function oldRefPrefix(tid) {
-  return `[[${tid}`
-}
-
 /** 人读的回执 */
 export function formatRename(report) {
   const lines = []

package/lib/engine/render.js

@@ -14,6 +14,7 @@
 
 import path from 'node:path'
 import { anyRefRegex, strip_tags } from './parse.js'
+import { ROOT_TID } from './mdlib.js'
 
 const MAX_EMBED = 64 // 单次渲染最多展开的宏个数（防病态文件自引用爆炸）
 
@@ -169,15 +170,18 @@ export function node_info(nodes, tid) {
   }
 }
 
-/** 路径解析（三级）：精确 TID → 段边界前缀唯一 → 裸前缀（模糊）唯一 */
+/** 路径解析（三级）：精确 TID → 段边界前缀唯一 → 裸前缀（模糊）唯一。
+ *  空串与 "." 都当库根（README 一直这么写，代码以前只认空串）。 */
 export function resolve_path(nodes, p) {
-  if (nodes.has(p)) return p
+  const raw = String(p ?? '').trim()
+  const target = raw === '' || raw === '.' || raw === './' ? ROOT_TID : raw
+  if (nodes.has(target)) return target
   const keys = [...nodes.keys()]
-  let hits = keys.filter((t) => t === p || t.startsWith(p + ':')).sort()
+  let hits = keys.filter((t) => t === target || t.startsWith(target + ':')).sort()
   if (hits.length === 1) return hits[0]
   if (!hits.length) {
     // 段边界无命中 → 裸前缀模糊（fact:mod → fact:modid / fact:modid-places / fact:modid-trap）
-    hits = keys.filter((t) => t.startsWith(p)).sort()
+    hits = keys.filter((t) => t.startsWith(target)).sort()
     if (hits.length === 1) return hits[0]
   }
   return null

package/lib/host/routes.js

@@ -197,7 +197,7 @@ export function registerRoutes(ctx, config) {
             send(res, 404, { error: `未找到定义: ${id}`, kb: lib.name })
             return
           }
-          const refs = refsToDef(lib.nodes, id)
+          const refs = refsToDef(lib.nodes, id, def.ownerTid)
           send(res, 200, {
             kb: lib.name,
             id,

package/lib/host/runtime.js

@@ -12,6 +12,7 @@
 
 import fs from 'node:fs'
 import path from 'node:path'
+import crypto from 'node:crypto'
 import { parse_library } from '../engine/mdlib.js'
 import { collectDefs } from '../engine/defs.js'
 import { resolveLibrary, listLibraries } from '../engine/registry.js'
@@ -90,6 +91,7 @@ function signature(nodekb) {
   let count = 0
   let maxM = 0
   let size = 0
+  const names = []
   const walk = (d) => {
     let entries
     try {
@@ -108,6 +110,9 @@ function signature(nodekb) {
           count += 1
           size += st.size
           if (st.mtimeMs > maxM) maxM = st.mtimeMs
+          // 文件名也算签名：改名/移动既不改 mtime 也不改大小，
+          // 只按内容比签名会让「改名后的旧索引」一直命中缓存（库看着正常、实际裂开）。
+          names.push(path.relative(nodekb, p).split(path.sep).join('/'))
         } catch {
           /* 竞态删除：忽略 */
         }
@@ -115,7 +120,14 @@ function signature(nodekb) {
     }
   }
   walk(nodekb)
-  return `${count}:${size}:${maxM}`
+  names.sort()
+  const digest = crypto.createHash('sha1').update(names.join('\n')).digest('hex').slice(0, 12)
+  return `${count}:${size}:${maxM}:${digest}`
+}
+
+/** 让某个库的缓存立刻失效（改名/移动之后必须调，别指望下一次签名比对） */
+export function forgetLibrary(nodekb) {
+  if (nodekb) CACHE.delete(path.resolve(nodekb))
 }
 
 /** 判定工作区，并说明它是怎么定下来的。
@@ -128,11 +140,13 @@ export function workspaceSource(config, exec) {
   if (cwd) return { path: cwd, from: 'exec.cwd' }
   const scwd = sessionCwd(e)
   if (scwd) return { path: scwd, from: 'session.header.cwd' }
+  // 面板没有会话：优先「最近一次工具用过的目录」，配置只当最后的默认值。
+  // 这样配置里留着的旧路径不会把面板钉在某个老项目上。
+  if (!e && LAST_WORKSPACE) return { path: LAST_WORKSPACE, from: 'last-workspace（面板）' }
   const configured = config && typeof config.workspace === 'string' ? config.workspace : ''
   if (configured) return { path: path.resolve(configured), from: 'config.workspace' }
   const env = process.env.DSH_NODEKB_WORKSPACE
   if (env) return { path: path.resolve(env), from: 'env.DSH_NODEKB_WORKSPACE' }
-  if (!e && LAST_WORKSPACE) return { path: LAST_WORKSPACE, from: 'last-workspace（面板）' }
   return { path: process.cwd(), from: 'process.cwd' }
 }
 

package/lib/host/tools.js

@@ -28,6 +28,7 @@ import {
   workspaceRoots,
   sessionIdOf,
   bindServices,
+  forgetLibrary,
 } from './runtime.js'
 
 const DEFAULT_MAXLEN = 50000
@@ -167,7 +168,7 @@ export function buildTools(ctx, config) {
             kb: lib.name,
             mode,
             chars: String(def.body || '').length,
-            text: warnPrefix(lib) + formatDefRead(def, refsToDef(lib.nodes, target)),
+            text: warnPrefix(lib) + formatDefRead(def, refsToDef(lib.nodes, target, def.ownerTid)),
           }
         }
         const cands = [...lib.nodes.keys()].filter((t) => t.startsWith(target) || t.startsWith(target + ':')).sort().slice(0, 10)
@@ -335,6 +336,8 @@ export function buildTools(ctx, config) {
       const report = renameFileNode(lib, String(args.target ?? ''), String(args.new_name ?? ''), {
         dryRun: Boolean(args.dry_run),
       })
+      // 改名只动文件名：缓存签名里的 mtime/size 都不变，不主动失效就会继续用旧索引
+      if (!report.dry_run && report.renamed) forgetLibrary(lib.nodekb)
       return { ...report, kb: lib.name, text: warnPrefix(lib) + formatRename(report) }
     },
   })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-node-memory",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Project node knowledge base for DSH agents: markdown-as-database, stable TIDs, transclusion projection, structure self-check.",
   "type": "module",
   "license": "MIT",