project-node-memory 1.0.0 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # project-node-memory
 
-> 中文 · [English](README_EN.md)
+> 简体中文 · [English](README_EN.md)
 
 把 **Markdown 目录当成知识库** 的 DSH 插件：为 Agent 提供 9 个 `kb_*` 工具，为人类提供知识节点面板（侧栏入口名「项目节点知识库」）。
 
@@ -128,9 +128,23 @@ dsh plugin add ./project-node-memory-<版本>.tgz
           - D:\shared\kb_registry.json
 ```
 
-`config.workspace` 可覆盖「工作区」，默认取会话工作区、再退回进程 cwd。
+`config.workspace` 可覆盖「工作区」；优先级是 **exec 上下文（面板点的目录 / 会话工作区）→ config.workspace → 环境变量 `DSH_NODEKB_WORKSPACE` → 最近一次工具用过的目录 → 进程 cwd**。所以在面板里换目录总能生效，配置只当默认值。
 
-面板拿不到会话上下文，所以它默认跟随**最近一次 `kb_*` 工具调用所在的工作区**（Agent 读过哪个项目，面板就显示哪个项目）；顶栏的目录下拉里直接列出 DSH 用过的项目目录（标了各自发现几个库），点右上「目录」也可以手填路径。选择存在浏览器 localStorage，只影响面板，不影响工具。
+面板拿不到会话上下文，所以它默认跟随**最近一次 `kb_*` 工具调用所在的工作区**（Agent 读过哪个项目，面板就显示哪个项目）；顶栏的目录下拉只列出 DSH 用过的、且**真的有 `.nodekb`** 的项目目录（标了各自发现几个库），点右上「目录」也可以手填路径。选择存在浏览器 localStorage，只影响面板，不影响工具。
+
+面板的两个下拉是联动的：**工作区 → 该工作区里的库**（`GET /nodekb/api/libs?scope=workspace`），全局注册表里的库单独归到「全局注册」分组，路径已不存在的注册项不显示（`exists:false`）。
+
+想知道某个请求最后解析成了哪个工作区，直接看 `GET /nodekb/api/where`：它把 config / env / exec / 上次记忆 / 进程 cwd 与最终结论一起吐出来。
+
+### 「注册」到底指什么
+
+没有注册这一步也能用 —— 只要库落在工作区里的约定位置（见上），它就会出现在列表里。`kb_registry.json` 只是给**不在工作区里**的库用的（比如 F 盘另一个项目、共享笔记目录）：
+
+```json
+{ "libraries": { "my-notes": { "path": "D:\\notes" } } }
+```
+
+读取顺序：`config.libraries` → `config.registries` 指定的文件 → `<ws>/.nodekb/registry.json` → `<ws>/kb_registry.json` → 用户目录的全局注册表（`~/.dsh/nodekb/registry.json`）。注册表里登记的名字优先级高于自动发现的名字，路径重复的以先出现的为准。
 
 ## 语法
 
@@ -185,7 +199,7 @@ node test/parity.mjs        # 与 Python 原实现逐条对拍（需要 python
 | `ctx.inject([...], cb)`                                 | `prompt.js` / `skill.js` | 动态注入不可用 → 段落/技能不注册                            | 退回同步取值；仍失败只告警                                            |
 | `ctx.systemPrompt.section({name,order,text})`           | `lib/host/prompt.js`     | 段落不出现 → Agent 不优先用它（工具仍在）                   | 失败被吞，`/api/prompt` 自证                                          |
 | `ctx.skills.register({…})`                              | `lib/host/skill.js`      | 写法规范不进技能目录                                        | 失败被吞，`/api/skill` 自证                                           |
-| `exec.workspace / cwd / session`                        | `lib/host/runtime.js`    | 定位不到工作区 → 默认库位置错                               | 4 级回退：config → env → exec → 上次工具用过的 → 进程 cwd             |
+| `exec.workspace / cwd / session`                        | `lib/host/runtime.js`    | 定位不到工作区 → 默认库位置错                               | 4 级回退：exec → config → env → 上次工具用过的 → 进程 cwd             |
 | `window.__ModuleLoader__.load({id,factory})`            | `lib/client.js`          | id 不匹配 → `bundle loaded without registering`             | 自检断言 id === 包名                                                  |
 | `ctx.slots.inject` / `slots.register`                   | `lib/client.js`          | 槽名或 props 改名 → 图标不出现                              | 走 official `inject`，失败写 `/api/client-report` 并在面板内自述      |
 

package/README_EN.md

@@ -1,6 +1,6 @@
 # project-node-memory
 
-> English · [中文](README.md)
+> [简体中文](README.md) · English
 
 A DSH plugin that treats **a directory of Markdown as a database**: nine `kb_*` tools for the agent, and a center-column panel for humans (sidebar entry: 「项目节点知识库」).
 

package/lib/client.js

@@ -940,6 +940,11 @@
       var libs = libsState[0]
       var setLibs = libsState[1]
 
+      // 全局注册表里的库（不在当前工作区内），与 libs 分组显示
+      var otherState = useState([])
+      var otherLibs = otherState[0]
+      var setOtherLibs = otherState[1]
+
       var kbState = useState('')
       var kb = kbState[0]
       var setKb = kbState[1]
@@ -1028,21 +1033,35 @@
         })
       }, [])
 
-      // 库列表
+      // 库列表：分两组
+      //   mine  = 当前工作区里的库（/libs?scope=workspace，只含真的在这个目录下的）
+      //   other = 全局注册表里登记的库（路径不在本工作区内，且必须真的存在）
+      // 「t（路径不存在）」这类失效注册项直接不进下拉。
       var loadLibs = useCallback(function () {
-        return get('/libs')
-          .then(function (r) {
-            var rows = r.libs || []
-            setLibs(rows)
+        return Promise.all([get('/libs', { scope: 'workspace' }), get('/libs')])
+          .then(function (rs) {
+            var mine = (rs[0] && rs[0].libs) || []
+            var all = (rs[1] && rs[1].libs) || []
+            var seen = {}
+            for (var i = 0; i < mine.length; i++) seen[mine[i].name + '|' + mine[i].path] = 1
+            var other = []
+            for (var j = 0; j < all.length; j++) {
+              var l = all[j]
+              if (!l.exists) continue
+              if (seen[l.name + '|' + l.path]) continue
+              other.push(l)
+            }
+            setLibs(mine)
+            setOtherLibs(other)
             var pick = null
-            for (var i = 0; i < rows.length; i++) {
-              if (rows[i].origin === 'workspace' && rows[i].exists) { pick = rows[i].name; break }
+            for (var a = 0; a < mine.length; a++) {
+              if (mine[a].exists) { pick = mine[a].name; break }
             }
             if (!pick) {
-              for (var j = 0; j < rows.length; j++) { if (rows[j].exists) { pick = rows[j].name; break } }
+              for (var b = 0; b < all.length; b++) { if (all[b].exists) { pick = all[b].name; break } }
             }
             setKb(pick || '')
-            if (!rows.length) {
+            if (!mine.length && !other.length) {
               setErr('这个工作区里没找到 .nodekb 库。换一个目录（右上「目录」），或在项目里建 .nodekb/ 放 md 文件；放在 .dsh/skills/<技能>/.nodekb/ 也会被自动发现。')
             } else {
               setErr('')
@@ -1220,10 +1239,19 @@
             onChange: function (e) { setKb(e.target.value); setSel('root'); setView('subtree') },
             title: '切换知识库',
           },
-          libs.length
-            ? libs.map(function (l) {
-                return h('option', { key: l.name, value: l.name }, l.name + (l.exists ? '' : '（路径不存在）'))
-              })
+          libs.length || otherLibs.length
+            ? [
+                libs.length
+                  ? h('optgroup', { key: 'ws', label: '当前工作区' }, libs.map(function (l) {
+                      return h('option', { key: 'w-' + l.name, value: l.name }, l.name + (l.exists ? '' : '（路径不存在）'))
+                    }))
+                  : null,
+                otherLibs.length
+                  ? h('optgroup', { key: 'reg', label: '全局注册' }, otherLibs.map(function (l) {
+                      return h('option', { key: 'r-' + l.name, value: l.name }, l.name + ' — ' + l.path)
+                    }))
+                  : null,
+              ]
             : h('option', { value: '' }, '（无库）'),
         ),
         tree && typeof tree.nodeCount === 'number' ? h('span', { className: 'nkb-muted' }, tree.nodeCount + ' 节点') : null,
@@ -1242,10 +1270,12 @@
             style: { maxWidth: 220 },
           },
           h('option', { value: '' }, '（默认目录）'),
-          wsList.map(function (w) {
-            return h('option', { key: w.id || w.path, value: w.path }, (w.title || w.path) + (w.nodekb ? '' : '（无 .nodekb）'))
-          }),
-          WS && !wsList.some(function (w) { return w.path === WS }) ? h('option', { key: 'manual', value: WS }, WS) : null,
+          wsList
+            .filter(function (w) { return w.nodekb })
+            .map(function (w) {
+              return h('option', { key: w.id || w.path, value: w.path }, (w.title || w.path) + '（' + (w.libs || 0) + ' 个库）')
+            }),
+          WS && !wsList.some(function (w) { return w.path === WS && w.nodekb }) ? h('option', { key: 'manual', value: WS }, WS + '（当前）') : null,
         ),
         h('button', { onClick: runSearch, disabled: busy }, '搜索'),
         h('button', { onClick: runDiag, disabled: busy }, '诊断'),
@@ -1381,16 +1411,16 @@
               'div',
               { className: 'nkb-diag nkb-err' },
               h('div', null, err),
-              wsList.length
+              wsList.filter(function (w) { return w.nodekb }).length
                 ? h(
                     'div',
                     { style: { marginTop: 10 } },
-                    h('div', { className: 'nkb-muted' }, '选一个 DSH 项目目录：'),
-                    wsList.map(function (w) {
+                    h('div', { className: 'nkb-muted' }, '选一个有 .nodekb 的 DSH 项目目录：'),
+                    wsList.filter(function (w) { return w.nodekb }).map(function (w) {
                       return h(
                         'div',
                         { key: w.id || w.path, style: { marginTop: 6 } },
-                        h('button', { onClick: function () { useWs(w.path) } }, (w.title || w.path) + (w.nodekb ? ' · 有 .nodekb' : ' · 无 .nodekb')),
+                        h('button', { onClick: function () { useWs(w.path) } }, (w.title || w.path) + ' · ' + (w.libs || 0) + ' 个库'),
                         h('span', { className: 'nkb-muted', style: { marginLeft: 8 } }, w.path),
                       )
                     }),

package/lib/engine/registry.js

@@ -219,8 +219,11 @@ export function resolveLibrary({ kb, lib, workspace, config } = {}) {
   )
 }
 
-/** 列出可用库（不解析内容，避免一次拖动整库） */
-export function listLibraries({ workspace, config } = {}) {
+/** 列出可用库（不解析内容，避免一次拖动整库）
+ *  scope='workspace' 时只回「真的在当前工作区里」的库（发现的 + 注册表里路径落在工作区内的），
+ *  面板用它做「知识库选择只显示当前工作区的库」；全局注册表项不再混进来。
+ */
+export function listLibraries({ workspace, config, scope } = {}) {
   const ws = path.resolve(workspace || process.cwd())
   const registries = loadRegistries(
     config && config.registries ? config.registries : defaultRegistryPaths(ws),
@@ -235,6 +238,8 @@ export function listLibraries({ workspace, config } = {}) {
   for (const [name, entry] of registries) {
     const nodekb = path.join(entry.path, '.nodekb')
     if (seen.has(nodekb)) continue
+    // 工作区视图只保留「路径位于工作区内」的注册项，否则一个全局注册表会污染所有工作区
+    if (scope === 'workspace' && !isInside(entry.path, ws)) continue
     rows.push({ name, path: entry.path, exists: isDir(nodekb), origin: entry.registry })
   }
   return rows

package/lib/host/routes.js

@@ -12,7 +12,7 @@ import { search, formatSearch } from '../engine/search.js'
 import { diag } from '../engine/diag.js'
 import { extract_refs } from '../engine/parse.js'
 import { renameFileNode, formatRename } from '../engine/rename.js'
-import { openLibrary, knownLibraries } from './runtime.js'
+import { openLibrary, knownLibraries, whereInfo, workspaceOf } from './runtime.js'
 import { promptState } from './prompt.js'
 import { skillState } from './skill.js'
 import { toolState } from './tools.js'
@@ -86,7 +86,15 @@ export function registerRoutes(ctx, config) {
       }
 
       if (url.pathname === `${PREFIX}/libs`) {
-        send(res, 200, { libs: knownLibraries(config, exec) })
+        // scope=workspace：只要当前工作区里的库（面板的「知识库」下拉用它）
+        const scope = q.get('scope') === 'workspace' ? 'workspace' : undefined
+        send(res, 200, { workspace: workspaceOf(config, exec), libs: knownLibraries(config, exec, { scope }) })
+        return
+      }
+
+      if (url.pathname === `${PREFIX}/where`) {
+        // 诊断：工作区到底是怎么定下来的（面板 / 工具对不上时先看这个）
+        send(res, 200, whereInfo(config, exec))
         return
       }
 

package/lib/host/runtime.js

@@ -58,19 +58,34 @@ function signature(nodekb) {
   return `${count}:${size}:${maxM}`
 }
 
-/** 取会话工作区：配置优先 → exec 上下文 → 进程 cwd */
+/** 取会话工作区：exec 上下文（面板显式 ws / 会话工作区） → 配置 → 环境变量 → 上次记住的 → 进程 cwd
+ *  exec 放最前面：面板点了哪个工作区、Agent 在哪个会话里，都必须压过配置里的默认值。 */
 export function workspaceOf(config, exec) {
+  const e = exec && typeof exec === 'object' ? exec : {}
+  const candidates = [e.workspace, e.cwd, e.session && e.session.workspace, e.session && e.session.cwd]
+  for (const c of candidates) if (typeof c === 'string' && c) return path.resolve(c)
   const configured = config && typeof config.workspace === 'string' ? config.workspace : ''
   if (configured) return path.resolve(configured)
   const env = process.env.DSH_NODEKB_WORKSPACE
   if (env) return path.resolve(env)
-  const e = exec && typeof exec === 'object' ? exec : {}
-  const candidates = [e.workspace, e.cwd, e.session && e.session.workspace, e.session && e.session.cwd]
-  for (const c of candidates) if (typeof c === 'string' && c) return path.resolve(c)
   if (LAST_WORKSPACE) return LAST_WORKSPACE
   return process.cwd()
 }
 
+/** 诊断用：把「工作区是怎么定下来的」原样吐出来（面板/工具都对不上时靠它） */
+export function whereInfo(config, exec) {
+  const e = exec && typeof exec === 'object' ? exec : {}
+  return {
+    configured: (config && config.workspace) || '',
+    env: process.env.DSH_NODEKB_WORKSPACE || '',
+    execWorkspace: (e.workspace && String(e.workspace)) || '',
+    execCwd: (e.cwd && String(e.cwd)) || '',
+    lastWorkspace: LAST_WORKSPACE || '',
+    processCwd: process.cwd(),
+    resolved: workspaceOf(config, exec),
+  }
+}
+
 /**
  * 打开一个库（带缓存）。
  * @returns {{name:string, base:string, nodekb:string, nodes:Map, problems:string[], cached:boolean}}
@@ -93,8 +108,8 @@ export function openLibrary(config, exec, { kb, lib, remember = true } = {}) {
   return { ...resolved, nodes, problems, cached: false }
 }
 
-export function knownLibraries(config, exec) {
-  return listLibraries({ workspace: workspaceOf(config, exec), config })
+export function knownLibraries(config, exec, opts = {}) {
+  return listLibraries({ workspace: workspaceOf(config, exec), config, scope: opts.scope })
 }
 
 export function libraryHint(config, exec) {

package/package.json

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