project-node-memory 1.0.3 → 1.0.6

package/README.md

@@ -68,9 +68,17 @@ dsh plugin add ./project-node-memory-<版本>.tgz
 | `workspace`      | 会话工作区 → 进程 cwd                           | 覆盖「工作区」，库发现与路径白名单都以它为界                  |
 | `libraries`      | 无                                              | `名字: 目录`，显式登记工作区之外的库（目录下需有 `.nodekb/`） |
 | `registries`     | 工作区 `.nodekb/registry.json` + 用户全局注册表 | 额外的 `kb_registry.json`（与 Python 版同格式）               |
+| `exclude`        | 见下                                            | 库发现时忽略的目录名，支持 `*` 通配；`!pattern` 强制放行     |
 | `prompt.enabled` | `true`                                          | 是否注册系统提示词段落                                        |
 | `skill.enabled`  | `true`                                          | 是否把随包 Skill 注册进宿主 `skills` 服务                     |
 
+`exclude` 默认忽略这些名字：`tmp`、`tmp_*`、`temp*`、`.tmp*`、`*_probe`、`nodekb_lab`、`__pycache__`、`_release_assets`、`venv`。临时目录、探针目录里的 `.nodekb` 通常是实验残渣，列进选择器只会碍事。要放行某个目录写 `"!tmp_keep"`；要额外忽略写 `"scratch"`（与默认名单叠加）。
+
+```yaml
+config:
+  exclude: ['tmp_*', '!tmp_keep', 'scratch']
+```
+
 ## 面板
 
 侧边栏多一个图标（名字「项目节点知识库」），点开是中栏三列：
@@ -146,6 +154,12 @@ dsh plugin add ./project-node-memory-<版本>.tgz
 
 读取顺序：`config.libraries` → `config.registries` 指定的文件 → `<ws>/.nodekb/registry.json` → `<ws>/kb_registry.json` → 用户目录的全局注册表（`~/.dsh/nodekb/registry.json`）。注册表里登记的名字优先级高于自动发现的名字，路径重复的以先出现的为准。
 
+给条目加 `"hidden": true` 后，它**只作为别名**存在：仍然可以用 `kb="my-notes"` 调用（老文档里写死的库名不会失效），但不会出现在面板的知识库下拉里。
+
+```json
+{ "libraries": { "my-notes": { "path": "D:\\notes", "hidden": true } } }
+```
+
 ## 语法
 
 ```md

package/README_EN.md

@@ -65,9 +65,17 @@ All optional, under `config:` on the plugin's row in `cordis.patch.yml`:
 | `workspace` | session workspace → process cwd | Overrides "the workspace"; library discovery and the path whitelist are scoped to it |
 | `libraries` | none | `name: directory` pairs registering libraries outside the workspace (each needs a `.nodekb/`) |
 | `registries` | workspace `.nodekb/registry.json` + user-global registry | Extra `kb_registry.json` files (same format as the Python build) |
+| `exclude` | see below | Directory names skipped during discovery (`*` wildcard; `!pattern` forces inclusion) |
 | `prompt.enabled` | `true` | Register the system-prompt section |
 | `skill.enabled` | `true` | Register the bundled skill with the host `skills` service |
 
+`exclude` defaults to `tmp`, `tmp_*`, `temp*`, `.tmp*`, `*_probe`, `nodekb_lab`, `__pycache__`, `_release_assets`, `venv`. A `.nodekb` inside a scratch or probe directory is usually leftover from an experiment; listing it only clutters the selector. Use `"!tmp_keep"` to force one back in, and plain names to add more:
+
+```yaml
+config:
+  exclude: ['tmp_*', '!tmp_keep', 'scratch']
+```
+
 ## Panel
 
 The sidebar gains an icon; opening it gives a three-column center panel (modeled on nodekb's MCP WebUI):
@@ -112,7 +120,7 @@ The right column renders at most 10,000 characters per view (with a truncation n
 
 It skips `node_modules` / `dist` / `build` / `out` / `target` / `coverage` / dot-directories and caps `readdir` calls, so the panel can afford to run it on every load. That is what "the knowledge base travels with the project" means: point at a project root and the `.nodekb/` directories inside skills surface on their own.
 
-Registries use the same format as the Python build's `kb_registry.json`; by default the plugin reads `.nodekb/registry.json` in the workspace and the global registry in the user directory. Libraries can also be declared inline:
+Registries use the same format as the Python build's `kb_registry.json`; by default the plugin reads `.nodekb/registry.json` in the workspace and the global registry in the user directory. Add `"hidden": true` to an entry to keep it as an **alias only** — `kb="my-notes"` still resolves (old docs keep working) but the entry never shows up in the panel's library picker. Libraries can also be declared inline:
 
 ```yaml
 - insert:

package/lib/engine/registry.js

@@ -51,7 +51,9 @@ export function readRegistryFile(file) {
     if (!libs || typeof libs !== 'object') return {}
     const out = {}
     for (const [name, info] of Object.entries(libs)) {
-      if (info && typeof info.path === 'string' && info.path) out[name] = { path: info.path, registry: file }
+      if (info && typeof info.path === 'string' && info.path) {
+        out[name] = { path: info.path, registry: file, hidden: info.hidden === true }
+      }
     }
     return out
   } catch {
@@ -94,7 +96,51 @@ function safeReaddir(dir) {
  */
 const SKIP_DIR = new Set(['node_modules', 'dist', 'build', 'out', 'target', 'coverage', '.git'])
 
-export function discoverLibraries(root, { depth = 2, budget = 300, limit = 60 } = {}) {
+/**
+ * 默认忽略的目录名（支持 * 通配、大小写不敏感）。这些目录里的 .nodekb 一律不算库：
+ * 临时/探针/构建产物目录里的库通常是实验残渣，列出来只会污染选择器。
+ * 可用 `--lib` 显式指定、或在插件配置里写 `"exclude": ["我的目录"]` 覆盖；
+ * 写 `"!tmp_*"` 之类的反向模式可重新放行（见 isExcluded）。
+ */
+export const DEFAULT_EXCLUDE = [
+  'tmp',
+  'tmp_*',
+  'temp',
+  'temp_*',
+  '.tmp*',
+  '*_probe',
+  '*_probe_*',
+  'nodekb_lab',
+  '__pycache__',
+  '_release_assets',
+  'venv',
+  '.venv',
+]
+
+function globMatch(str, pattern) {
+  const re = new RegExp(
+    '^' +
+      pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.') +
+      '$',
+  )
+  return re.test(str)
+}
+
+/** 目录名是否被忽略。exclude 里的 `!xxx` 表示强制放行（优先于默认名单）。 */
+export function isExcluded(name, { exclude } = {}) {
+  const n = String(name).toLowerCase()
+  const extra = Array.isArray(exclude) ? exclude.map((p) => String(p)) : []
+  const allow = extra.filter((p) => p.startsWith('!')).map((p) => p.slice(1).toLowerCase())
+  if (allow.some((p) => globMatch(n, p))) return false
+  const patterns = [...DEFAULT_EXCLUDE, ...extra.filter((p) => !p.startsWith('!'))]
+  return patterns.some((p) => globMatch(n, p.toLowerCase()))
+}
+
+export function discoverLibraries(root, { depth = 2, budget = 300, limit = 60, exclude } = {}) {
+  const skipName = (name) => name.startsWith('.') || SKIP_DIR.has(name) || isExcluded(name, { exclude })
   const ws = path.resolve(root || '.')
   const out = []
   const seen = new Set()
@@ -111,7 +157,7 @@ export function discoverLibraries(root, { depth = 2, budget = 300, limit = 60 }
   // 技能自带的知识库是约定位置，单独直查（不进 BFS，因为 .dsh 是点目录）
   const scanSkills = (base, prefix) => {
     for (const e of safeReaddir(path.join(base, '.dsh', 'skills'))) {
-      if (!e.isDirectory() || e.name.startsWith('.')) continue
+      if (!e.isDirectory() || skipName(e.name)) continue
       push(path.join(base, '.dsh', 'skills', e.name), (prefix ? prefix + '/' : '') + '.dsh/skills/' + e.name, 'discovered')
       if (out.length >= limit) return
     }
@@ -131,7 +177,7 @@ export function discoverLibraries(root, { depth = 2, budget = 300, limit = 60 }
     }
     for (const e of entries) {
       if (out.length >= limit || spent >= budget) break
-      if (!e.isDirectory() || e.name.startsWith('.') || SKIP_DIR.has(e.name)) continue
+      if (!e.isDirectory() || skipName(e.name)) continue
       const rel = cur.rel ? cur.rel + '/' + e.name : e.name
       const dir = path.join(cur.dir, e.name)
       push(dir, rel, 'discovered')
@@ -148,6 +194,8 @@ export function discoverLibraries(root, { depth = 2, budget = 300, limit = 60 }
  */
 export function resolveLibrary({ kb, lib, workspace, config } = {}) {
   const ws = path.resolve(workspace || process.cwd())
+  const exclude = config && config.exclude
+  const discover = () => discoverLibraries(ws, { exclude })
   const registries = loadRegistries(
     config && config.registries ? config.registries : defaultRegistryPaths(ws),
     config && config.libraries,
@@ -177,7 +225,7 @@ export function resolveLibrary({ kb, lib, workspace, config } = {}) {
       if (!isDir(nodekb)) throw new Error(`库目录不存在: ${nodekb}（注册表 ${name} 指向 ${entry.path}）`)
       return { name, base: entry.path, nodekb, origin: entry.registry }
     }
-    const discovered = discoverLibraries(ws).find((r) => r.name === name)
+    const discovered = discover().find((r) => r.name === name)
     if (discovered) {
       return { name, base: path.dirname(discovered.nodekb), nodekb: discovered.nodekb, origin: discovered.origin }
     }
@@ -185,14 +233,14 @@ export function resolveLibrary({ kb, lib, workspace, config } = {}) {
       const wsLib = workspaceBase(ws)
       if (wsLib) return wsLib
     }
-    const names = [...registries.keys(), ...discoverLibraries(ws).map((r) => r.name)]
+    const names = [...registries.keys(), ...discover().map((r) => r.name)]
     throw new Error(`未注册的库: ${name}（可用: ${names.join(', ') || '无'}；或用 lib 参数给绝对路径）`)
   }
 
   // 3) 无参：工作区自带 → 工作区里唯一发现 → 唯一的注册表库
   const wsLib = workspaceBase(ws)
   if (wsLib) return wsLib
-  const found = discoverLibraries(ws)
+  const found = discover()
   if (found.length === 1) {
     return { name: found[0].name, base: path.dirname(found[0].nodekb), nodekb: found[0].nodekb, origin: found[0].origin }
   }
@@ -222,8 +270,10 @@ export function resolveLibrary({ kb, lib, workspace, config } = {}) {
 /** 列出可用库（不解析内容，避免一次拖动整库）
  *  scope='workspace' 时只回「真的在当前工作区里」的库（发现的 + 注册表里路径落在工作区内的），
  *  面板用它做「知识库选择只显示当前工作区的库」；全局注册表项不再混进来。
+ *  注册项可以写 `hidden: true`：仍然能按名字解析（兼容老文档里的 kb="filmmeasure"），
+ *  但不进任何列表——面板里不显示，相当于「只保留别名」。
  */
-export function listLibraries({ workspace, config, scope } = {}) {
+export function listLibraries({ workspace, config, scope, includeHidden = false } = {}) {
   const ws = path.resolve(workspace || process.cwd())
   const registries = loadRegistries(
     config && config.registries ? config.registries : defaultRegistryPaths(ws),
@@ -231,11 +281,12 @@ export function listLibraries({ workspace, config, scope } = {}) {
   )
   const rows = []
   const seen = new Set()
-  for (const r of discoverLibraries(ws)) {
+  for (const r of discoverLibraries(ws, { exclude: config && config.exclude })) {
     rows.push({ name: r.name, path: path.dirname(r.nodekb), exists: true, origin: r.origin })
     seen.add(r.nodekb)
   }
   for (const [name, entry] of registries) {
+    if (entry.hidden && !includeHidden) continue
     const nodekb = path.join(entry.path, '.nodekb')
     if (seen.has(nodekb)) continue
     // 工作区视图只保留「路径位于工作区内」的注册项，否则一个全局注册表会污染所有工作区

package/lib/index.js

@@ -22,6 +22,8 @@ export const inject = ['tools', 'webServer']
  * - libraries: { 名字: 技能目录绝对路径 }   —— 内联登记库
  * - registries: [注册表 JSON 路径]           —— 与 Python 版 kb_registry.json 同格式
  * - workspace: 工作区路径（默认取会话工作区，取不到用进程 cwd）
+ * - exclude: ['tmp_*', '!tmp_keep']   —— 库发现时额外忽略的目录名（支持 * 通配；
+ *   `!` 前缀表示强制放行，可覆盖默认名单）。默认已忽略 tmp/temp/*_probe/nodekb_lab 等。
  * - prompt: { enabled?: false, text?: string } —— 系统提示词里的那段约定（默认开）
  */
 export function apply(ctx, config) {

package/package.json

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