project-node-memory 1.3.0 → 1.3.2

package/lib/host/prompt.js

@@ -14,14 +14,13 @@ export const PROMPT_SECTION_ORDER = 100
 export const DEFAULT_PROMPT = [
   '## 项目知识库（project-node-memory）',
   '',
-  '本项目需要沉淀长期知识（设计决策、踩坑、事实常量、待办、交接）时，**用 `.nodekb/` + `kb_*` 工具**，不要用 write/edit 手搭 `docs/*.md` 式的渐进式文档——手写没有校验、没有稳定 TID、没有引用展开。',
+  '当本项目需要沉淀长期知识（设计决策、踩坑、事实常量、待办、交接）时，可用 `.nodekb/` + `kb_*` 工具。',
   '',
-  '- 建库：`kb_init` 一次铺出骨架（`doc/ lessons/ todo/ index/entry.md` + 约定说明）。已有 `.nodekb/` 就别重建；目录与节点类型都可按项目实际增删。',
-  '- 写库：`kb_write`（append/replace/create，或对显式节点用 mode=node）。写前校验 TID 与标签独占一行，写后立刻 `kb_diag` 报悬空引用/重复定义；用 write 做这些没有任何一层会拦。',
-  '- 读库：先 `kb_read mode=toc` 看结构（几百 token），再按 TID 读一支；找不到就 `kb_search`。别一次性把整库读进上下文。',
+  '- 建库：`kb_init` 一次铺出骨架 `doc/ lessons/ todo/ index/entry.md` + 落位约定。已有 `.nodekb/` 就别重建；目录与节点类型都可按项目实际增删。',
+  '- 写库：`kb_write`（append/replace/create，或对显式节点用 mode=node）。写前校验 TID 与标签独占一行，写后 `kb_diag` 报悬空引用/重复定义。',
+  '- 读库：先 `kb_read mode=toc` 看结构，再按 TID 读一支；找不到就 `kb_search`。别一次性把整库读进上下文。',
   '- 改名前先 `kb_backlinks`，改名用 `kb_rename`（会重写全库引用并跳过被并发改过的文件）。',
-  '- 引用分两种，别混：**结构**用 `[[node="doc:03-build:3.1"]]`（只出一个链接，不复制正文）；**值只写一处**——定义 `<tscl id="fact:abi">…</tscl>`，各处写 `[[tscl="fact:abi"]]`，同一 id 全库只能定义一次。定义可就近写在正文句子里（单行、别写进表格）。读一个值用 `kb_read target=<定义 id>`。',
-  '- 旧写法 `[[TID]]` 仍能用但 `kb_diag` 会 warning，2.0 移除（老库按 diag 清单逐处改成 `[[node=…]]` / `[[tscl=…]]`）。',
+  '- 引用分两种：结构用 `[[node="xxx"]]`（只出一个链接，不复制正文）；值只写一处——定义 `<tscl id="xxx:xxx">…</tscl>`，嵌入处写 `[[tscl="xxx:xxx"]]`，同一 id 全库只能定义一次。定义可就近写在正文句子里（单行、别写进表格）。读一个值用 `kb_read target=<定义 id>`。',
 ].join('\n')
 
 function textOf(config) {

package/lib/host/tools.js

@@ -73,8 +73,7 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_list',
     description:
-      '列出当前可用的 nodekb 知识库（名字 + 路径 + 是否存在），以及本次调用实际会命中的默认库。' +
-      '不确定该传什么 kb 参数时先调它。只读、极轻量。',
+      '列出当前可用的 nodekb 知识库以及本次调用实际会命中的默认库。不确定该传什么 kb 参数时先用它。',
     parameters: { type: 'object', properties: {} },
     output: {
       schema: {},
@@ -97,13 +96,15 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_read',
     description:
-      '读知识库的一个节点。target = TID 或其唯一前缀（空/"." = 库根），也可以是 <tscl id> 定义的名字（回定义体、定义处、被谁引用）。' +
-      'mode: subtree（默认，整支投影）| toc（只看结构，' +
-      '先定位再读）| node（只本节点）| raw（元信息+原文）。比 read 好在 TID 不随行号漂移；超 maxlen 会报错并提示换 toc/node。',
+      '读知识库的一个节点。target = TID 或其唯一前缀（空/"." = 库根），也可以是 <tscl id> 定义的名字。' +
+      'mode: subtree（默认，整支投影）| toc（只看结构，先定位再读）| node（只本节点）| raw（元信息+原文）。',
     parameters: {
       type: 'object',
       properties: {
-        target: { type: 'string', description: '节点 TID 或其唯一前缀。空字符串或 "." 表示库根。' },
+        target: {
+          type: 'string',
+          description: '节点 TID 或其唯一前缀；也可以是 <tscl id> 定义的名字（回定义体、定义处、被谁引用）。空字符串或 "." 表示库根。',
+        },
         kb: KB_PARAM,
         mode: {
           type: 'string',
@@ -185,8 +186,7 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_search',
     description:
-      '检索知识库（中文 2-gram + 多词加权 + 子串兜底）。返回稳定 TID、类型、标题、源行、片段。' +
-      '先 kb_search 拿 tid 再 kb_read，比 grep 后逐个 read 省往返。',
+      '检索知识库（中文 2-gram + 多词加权 + 子串兜底）。建议先 kb_search 拿 tid 再 kb_read。',
     parameters: {
       type: 'object',
       properties: {
@@ -224,8 +224,7 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_diag',
     description:
-      '结构自检。errors = 真损坏（悬空/位置型引用、循环、孤儿、树环、重复 TID、tscl 定义问题）；' +
-      'warnings = 疑似漂移（同一段文字出现在多处），默认不算失败。写完 md 就跑一次。',
+      '结构自检。errors = 真损坏；warnings = 疑似漂移，默认不算失败。建议写完 md 就跑一次。',
     parameters: {
       type: 'object',
       properties: {
@@ -254,8 +253,7 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_backlinks',
     description:
-      '反查：谁引用了这个 id（`[[node=…]]`/`[[tscl=…]]`/旧式 `[[TID]]` 都算）。改 TID 或删节点前先跑，' +
-      '比全库 grep 准——只认真实引用语法。',
+      '反查：谁引用了这个 id。建议改 TID 或删节点前先跑。',
     parameters: {
       type: 'object',
       properties: {
@@ -289,8 +287,7 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_rename',
     description:
-      '重命名 md 文件并改写全库指向它的引用（含子节点）。TID 由文件名派生，所以用 mv 改名必然留悬空引用；' +
-      '写前重读校验，别人刚改过的文件跳过不覆盖。',
+      '重命名 md 文件并改写全库指向它的引用。写前重读校验，别人刚改过的文件跳过不覆盖。',
     parameters: {
       type: 'object',
       properties: {
@@ -403,8 +400,8 @@ export function buildTools(ctx, config) {
   tools.push({
     name: 'kb_write',
     description:
-      '写库并立刻自检（悬空引用/重复定义/结构错误当场报回来）。写前校验 TID 与 <node> 独占一行；' +
-      '用 write/edit 直接改没有这层。mode=append（追加，不存在则建）| replace（整篇）| create（只新建）| node（就地改一个 <node> 块）。',
+      '写库并立刻自检。写前会校验 TID 与 <node> 规范。' +
+      'mode=append（追加，不存在则建）| replace（整篇）| create（只新建）| node（就地改一个 <node> 块）。',
     parameters: {
       type: 'object',
       properties: {

package/package.json

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

package/skills/project-node-memory-guide/SKILL.md

@@ -36,10 +36,10 @@ kb_search query=...         # toc 里找不到再搜
 
 ## 两种引用方法
 
-| 写法                          | 渲染成                                         | 用在                              |
-| ----------------------------- | ---------------------------------------------- | --------------------------------- |
-| `[[node="doc:03-build:3.1"]]` | 一个链接，**不复制正文**                       | 指向另一段结构：「细节见 …」      |
-| `[[tscl="fact:abi"]]`         | 把 `<tscl id="fact:abi">` 的定义体**替换进来** | 同一句话/同一组数字必须在多处出现 |
+| 写法                          | 渲染成                                         |
+| ----------------------------- | ---------------------------------------------- |
+| `[[node="doc:03-build:3.1"]]` | 一个链接，**不复制正文**                       |
+| `[[tscl="fact:abi"]]`         | 把 `<tscl id="fact:abi">` 的定义体**替换进来** |
 
 ```md
 <tscl id="fact:sample">
@@ -81,5 +81,3 @@ kb_write target=doc/03-...md          mode=append  content=...
 
 1. 不要把整段对话贴进 `doc/` —— 记的是过程，不是结论。
 2. 不要把同一件事在 `doc/` 和 `lessons/` 各写一份 —— 抽成 `<tscl>` 定义，两处都引用它。
-
-