@furongjun1999/dsh-memory 0.4.11 → 0.5.1

package/md_cg/writepipe.py

@@ -206,7 +206,7 @@ def _gate_audit(ctx):
            "hint": "这是校验闸门的正常行为（verdict=%s）：内容未达 ACCEPT，"
                    "已入审核队列——不需要重试；落盘须由设计者权限（can_admin）"
                    "对提案 pid 裁决（agent 端无裁决权是设计），转告使用者："
-                   "python scripts/review_cli.py list 后 accept/reject，"
+                   "python -m md_cg.review_cli list 后 accept/reject，"
                    "或 cg(op=review, pid=<pid>, decision=accept|reject|"
                    "edit|merge, reason=<理由>)" % verdict.get("state")}
     if pr.get("dedup"):
@@ -216,7 +216,7 @@ def _gate_audit(ctx):
         out["hint"] = (
             "同内容提案已存在（pid=%s，状态=%s，幂等去重），"
             "本次未重复入队——无需重试；落盘须由设计者权限（can_admin）"
-            "对该 pid 裁决：python scripts/review_cli.py list 后 accept/reject，"
+            "对该 pid 裁决：python -m md_cg.review_cli list 后 accept/reject，"
             "或 cg(op=review, pid=<pid>, decision=accept|reject|edit|merge, "
             "reason=<理由>)" % (pr["pid"], pr.get("dup_status") or "pending"))
     return out
@@ -226,7 +226,9 @@ def _gate_audit(ctx):
 def _gate_consistency(ctx):
     """冲突闸：节点间自动冲突检测（三级决策）。
 
-    不通过时按 on_conflict：reject=直接拒绝；defer=转入审核队列。
+    仅 REJECT（明确判为冲突）按 on_conflict 处置：reject=直接拒绝；
+    defer=转入审核队列。BLINDSPOT（无可比对节点，检测前提不存在）恒放行，
+    cvd 审计经链尾透出（issue #26：无法比对 ≠ 冲突，入队是死胡同）。
     """
     a = ctx["a"]
     cg = ctx["cg"]
@@ -243,8 +245,14 @@ def _gate_consistency(ctx):
         tags=a.get("tags"), exclude=ctx["nid"], auto_flywheel=True)
     ctx["cvd"] = cvd
     v = cvd.get("verdict")
-    blocked = ((v == "REJECT" and oc == "reject")
-               or (v in ("REJECT", "BLINDSPOT") and oc == "defer"))
+    # issue #26（2026-09-23）：BLINDSPOT ≠ REJECT——冲突闸的 BLINDSPOT 唯一出口
+    # 是 comparable==0（既有节点无一声明条件，含空库），语义是「检测前提不
+    # 存在」而非「已判定冲突」；defer 入队后裁决者面对同样空白（无可操作
+    # 下一步，死胡同）。故 BLINDSPOT 恒放行：cvd 经链尾 _executor 的
+    # consistency 字段如实透出（放行原因可观测）；REJECT（明确冲突）维持
+    # 原拦截语义。原先两者等同拦截 → 空库首次写入恒不落盘（README 推荐的
+    # content_kind=code 通路必失败——库越空越写不进）。
+    blocked = (v == "REJECT" and oc in ("reject", "defer"))
     if not blocked:
         return None
     if oc == "reject":
@@ -264,7 +272,7 @@ def _gate_consistency(ctx):
                    "（on_conflict=defer），已转入审核队列待裁决——"
                    "不是工具故障，重试同样结果；"
                    "落盘须由设计者权限（can_admin）裁决，转告使用者："
-                   "python scripts/review_cli.py list 后 accept/reject，"
+                   "python -m md_cg.review_cli list 后 accept/reject，"
                    "或 cg(op=review, pid=<pid>, decision=accept|reject|"
                    "edit|merge, reason=<理由>)"}
     if pr.get("dedup"):
@@ -274,7 +282,7 @@ def _gate_consistency(ctx):
             "同内容提案已存在于审核队列（pid=%s，幂等去重），"
             "本次未重复入队——无需重试；"
             "落盘须由设计者权限（can_admin）对该 pid 裁决："
-            "python scripts/review_cli.py list 后 accept/reject，"
+            "python -m md_cg.review_cli list 后 accept/reject，"
             "或 cg(op=review, pid=<pid>, decision=accept|reject|"
             "edit|merge, reason=<理由>)" % pr["pid"])
     return out
@@ -460,10 +468,14 @@ def _executor(ctx):
     """
     a = ctx["a"]
     cg = ctx["cg"]
+    # importance 显式 null（JSON null→None）时 get 的缺省值不生效，直接
+    # float(None) 抛 TypeError 崩主写路径——回退默认 0.5（与 add 缺省同口径）；
+    # 0 / 0.0 等合法 falsy 数值照传（_gate_gated :304 已是同款 None 判定）。
+    _imp = a.get("importance")
     cg.add(ctx["nid"], a.get("content", ""),
            layer=a.get("layer") or "knowledge",
            tags=a.get("tags"), condition_space=a.get("condition_space"),
-           importance=float(a.get("importance", 0.5)),
+           importance=0.5 if _imp is None else float(_imp),
            verification_basis=a.get("verification_basis")
            or (ctx.get("verdict") or {}).get("basis"),
            non_applicable_conditions=a.get("non_applicable_conditions"),

package/package.json

@@ -1,96 +1,101 @@
-{
-  "name": "@furongjun1999/dsh-memory",
-  "version": "0.4.11",
-  "description": "灵枢（Lingshu·líng shū）DeepSeek Harness 插件：完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH，对话自动沉淀进 md_cg 认知图（md 文档）",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "import": "./lib/index.js"
-    }
-  },
-  "files": [
-    "lib",
-    "src",
-    "md_cg",
-    "skills",
-    "README.md",
-    "dsh",
-    "codebuddy",
-    "zcode",
-    "docs"
-  ],
-  "keywords": [
-    "deepseek",
-    "dsh",
-    "dsh-plugin",
-    "cordis",
-    "memory",
-    "agent",
-    "aeis",
-    "lingshu",
-    "multi-agent",
-    "spatiotemporal",
-    "knowledge-graph"
-  ],
-  "license": "MIT",
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-llm": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-session": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-system-prompt": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-tools": {
-      "optional": true
-    },
-    "@deepseek-ai/schemastery": {
-      "optional": true
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": ">=4.0.1",
-    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
-    "@deepseek-ai/schemastery": ">=3.0.0"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.0.0",
-    "@types/node": "^24.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.5.0"
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.json",
-    "test": "npm run build && node --import tsx --test \"test/*.test.ts\"",
-    "prepare": "node -e \"const fs=require('fs');const tsc='node_modules/typescript/bin/tsc';fs.existsSync(tsc)?(fs.rmSync('lib',{recursive:true,force:true}),require('child_process').execFileSync(process.execPath,[tsc,'-p','tsconfig.json'],{stdio:'inherit'})):console.log('[prepare] 跳过构建：typescript 未安装（NODE_ENV=production 或 --omit=dev 会省略 devDependencies）——需要构建请用 npm install --include=dev')\"",
-    "prepublishOnly": "npm run build && npm test && python scripts/check_publish_artifact.py"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/FuRongJun-1999/dsh-memory.git"
-  },
-  "engines": {
-    "node": ">=22.19"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./dsh/cordis.patch.yml"
-    }
-  }
-}
+{
+  "name": "@furongjun1999/dsh-memory",
+  "version": "0.5.1",
+  "description": "灵枢（Lingshu·líng shū）DeepSeek Harness 插件：完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH，对话自动沉淀进 md_cg 认知图（md 文档）",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src",
+    "md_cg",
+    "skills",
+    "README.md",
+    "dsh",
+    "codebuddy",
+    "zcode",
+    "docs"
+  ],
+  "keywords": [
+    "deepseek",
+    "dsh",
+    "dsh-plugin",
+    "cordis",
+    "memory",
+    "agent",
+    "aeis",
+    "lingshu",
+    "multi-agent",
+    "spatiotemporal",
+    "knowledge-graph"
+  ],
+  "license": "MIT",
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
+    "@deepseek-ai/schemastery": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.0.0",
+    "@types/node": "^24.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "test": "npm run build && node --import tsx --test \"test/*.test.ts\"",
+    "prepare": "node -e \"const fs=require('fs');const tsc='node_modules/typescript/bin/tsc';fs.existsSync(tsc)?(fs.rmSync('lib',{recursive:true,force:true}),require('child_process').execFileSync(process.execPath,[tsc,'-p','tsconfig.json'],{stdio:'inherit'})):console.log('[prepare] 跳过构建：typescript 未安装（NODE_ENV=production 或 --omit=dev 会省略 devDependencies）——需要构建请用 npm install --include=dev')\"",
+    "gate": "python scripts/check_unreachable.py && python scripts/check_publish_artifact.py && python scripts/cogmap_sync.py check && python scripts/link_check.py && python scripts/workspace_index.py --check && python scripts/verify_discipline.py --allow-missing",
+    "prepublishOnly": "npm run build && npm test && npm run gate"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FuRongJun-1999/dsh-memory.git"
+  },
+  "engines": {
+    "node": ">=22.19"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./dsh/cordis.patch.yml"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/skills/plugin.json

@@ -1,55 +1,55 @@
-{
-  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
-  "name": "lingshu-skills",
-  "version": "0.1.0",
-  "description": "灵枢（AEIS）自我认知技能包——白箱条件化知识（Agent Skills 兼容导出）。本质是灵枢了解自身的工具：每个技能描述灵枢在什么条件下能做什么、怎么执行、克制什么（KCCS 四要素），由条件路由图精确路由，由灵枢 MCP 工具执行验证（物理基底）。",
-  "author": {
-    "name": "灵枢（AEIS）· CommonTrustProtocol"
-  },
-  "license": "MIT",
-  "keywords": [
-    "agent-skills",
-    "whitebox",
-    "condition-route",
-    "kccs",
-    "self-cognition",
-    "lingshu"
-  ],
-  "extensions": {
-    "lingshu": {
-      "self-cognition": {
-        "essence": "灵枢自我认知技能包——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）",
-        "source-of-truth": "本仓 md_cg/whitebox_kb/wisdom/*_code_units.py（真源，S3 已内迁）；本 skills/ 为生成投影"
-      },
-      "condition-route": {
-        "layout": "v2.0-hierarchical（687 平铺收敛为 6 域入口 + units/ 收纳；入口层进 agent 上下文，单元层按需回读）",
-        "domains": {
-          "compiler": { "entry": "lingshu-compiler", "unit-count": 116, "subdomains": 10 },
-          "pylang": { "entry": "lingshu-pylang", "unit-count": 120, "subdomains": 25 },
-          "graph": { "entry": "lingshu-graph", "unit-count": 117, "subdomains": 17 },
-          "os": { "entry": "lingshu-os", "unit-count": 112, "subdomains": 18 },
-          "browser": { "entry": "lingshu-browser", "unit-count": 104, "subdomains": 14 },
-          "net": { "entry": "lingshu-net", "unit-count": 117, "subdomains": 2 }
-        },
-        "unit-count": 686,
-        "entry-count": 6,
-        "routing": "词面：域入口路由表（units/<slug>/SKILL.md 按需回读）；语义：mdcg cg op=route；全量触发词：md_cg/whitebox_kb/wisdom/trigger_words_index.json",
-        "kccs-version": "四要素（生效条件/子功能/执行/不适用条件）——单元级在 units/<slug>/SKILL.md，域级在域入口",
-        "negative-route": true,
-        "condition-space": "观测位置/观测工具/时间窗口/存在约束（D(C)）"
-      },
-      "meta-skill": {
-        "name": "designer-perspective",
-        "essence": "设计者视角元技能——不承担操作层执行，只赋予全局观测/结构识别/方向判断/资格裁决/条件层归因（《智能论3.4》1.4.2 视角层次）",
-        "source-of-truth": "手写（真源即 skills/designer-perspective/SKILL.md）；不属于六域条件单元，不经 tools/skill_export.py 生成",
-        "relation-to-condition-route": "互补：686 条件单元回答「怎么做」，本元技能回答「该不该做/为什么做/条件够不够」；condition-route.unit-count 仍为 686（元技能单列）",
-        "mcp": "只读接入 md_cg（dsh-memory）：mdcg_metacognition.self_check / mdcg_search 四态阶梯 / mdcg_evolution 账本；写操作须由 agent 显式发起",
-        "self-test": "skills/designer-perspective/tests/selftest.py（认知能力验收用例集，输出逐项结果与通过率）"
-      },
-      "mcp": {
-        "relation": "技能为说明书（何时用/怎么用/克制什么），灵枢 MCP 33 工具（cg/stg 基元 + 31 细粒度）为执行（物理基底）——技能 Verification 由 MCP 工具（编译/运行/断言）裁决",
-        "entry": "md_cg-mcp（MCP stdio server，随 dsh-memory 插件自带；python -m md_cg.mcp_server）"
-      }
-    }
-  }
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "lingshu-skills",
+  "version": "0.1.0",
+  "description": "灵枢（AEIS）自我认知技能包——白箱条件化知识（Agent Skills 兼容导出）。本质是灵枢了解自身的工具：每个技能描述灵枢在什么条件下能做什么、怎么执行、克制什么（KCCS 四要素），由条件路由图精确路由，由灵枢 MCP 工具执行验证（物理基底）。",
+  "author": {
+    "name": "灵枢（AEIS）· CommonTrustProtocol"
+  },
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "whitebox",
+    "condition-route",
+    "kccs",
+    "self-cognition",
+    "lingshu"
+  ],
+  "extensions": {
+    "lingshu": {
+      "self-cognition": {
+        "essence": "灵枢自我认知技能包——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）",
+        "source-of-truth": "本仓 md_cg/whitebox_kb/wisdom/*_code_units.py（真源，S3 已内迁）；本 skills/ 为生成投影"
+      },
+      "condition-route": {
+        "layout": "v2.0-hierarchical（687 平铺收敛为 6 域入口 + units/ 收纳；入口层进 agent 上下文，单元层按需回读）",
+        "domains": {
+          "compiler": { "entry": "lingshu-compiler", "unit-count": 116, "subdomains": 10 },
+          "pylang": { "entry": "lingshu-pylang", "unit-count": 120, "subdomains": 25 },
+          "graph": { "entry": "lingshu-graph", "unit-count": 117, "subdomains": 17 },
+          "os": { "entry": "lingshu-os", "unit-count": 112, "subdomains": 18 },
+          "browser": { "entry": "lingshu-browser", "unit-count": 104, "subdomains": 14 },
+          "net": { "entry": "lingshu-net", "unit-count": 117, "subdomains": 2 }
+        },
+        "unit-count": 686,
+        "entry-count": 6,
+        "routing": "词面：域入口路由表（units/<slug>/SKILL.md 按需回读）；语义：mdcg cg op=route；全量触发词：md_cg/whitebox_kb/wisdom/trigger_words_index.json",
+        "kccs-version": "四要素（生效条件/子功能/执行/不适用条件）——单元级在 units/<slug>/SKILL.md，域级在域入口",
+        "negative-route": true,
+        "condition-space": "观测位置/观测工具/时间窗口/存在约束（D(C)）"
+      },
+      "meta-skill": {
+        "name": "designer-perspective",
+        "essence": "设计者视角元技能——不承担操作层执行，只赋予全局观测/结构识别/方向判断/资格裁决/条件层归因（《智能论3.4》1.4.2 视角层次）",
+        "source-of-truth": "手写（真源即 skills/designer-perspective/SKILL.md）；不属于六域条件单元，不经 tools/skill_export.py 生成",
+        "relation-to-condition-route": "互补：686 条件单元回答「怎么做」，本元技能回答「该不该做/为什么做/条件够不够」；condition-route.unit-count 仍为 686（元技能单列）",
+        "mcp": "只读接入 md_cg（dsh-memory）：mdcg_metacognition.self_check / mdcg_search 四态阶梯 / mdcg_evolution 账本；写操作须由 agent 显式发起",
+        "self-test": "skills/designer-perspective/tests/selftest.py（认知能力验收用例集，输出逐项结果与通过率）"
+      },
+      "mcp": {
+        "relation": "技能为说明书（何时用/怎么用/克制什么），灵枢 MCP 33 工具（cg/stg 基元 + 31 细粒度）为执行（物理基底）——技能 Verification 由 MCP 工具（编译/运行/断言）裁决",
+        "entry": "md_cg-mcp（MCP stdio server，随 dsh-memory 插件自带；python -m md_cg.mcp_server）"
+      }
+    }
+  }
 }