@furongjun1999/dsh-memory 0.9.18 → 0.9.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -180,4 +180,104 @@ def decide_write(layer, reviewers=None, channels=None, mode=None, environ=None):
180
180
  if gap:
181
181
  return {"decision": "require_review", "tier": tier, "mode": m, "missing": gap,
182
182
  "reason": "该层需 " + "/".join(need) + " 复核,仍缺 " + "/".join(gap)}
183
- return {"decision": "allow", "tier": tier, "mode": m, "missing": [], "reason": "复核齐备"}
183
+ return {"decision": "allow", "tier": tier, "mode": m, "missing": [], "reason": "复核齐备"}
184
+
185
+ # ── issue #722 / 规范 v0.5:生效条件是否在描述「元数据」而非「什么时候该用」──
186
+ #
187
+ # ⚠️ 判据演进(2026-10-31,四次实测修正留痕,勿重蹈):
188
+ # ① 正向「所有词项都含元数据特征」→ 失败:含「源文档 a/b/c.md」时被 / 切成路径片段,all() 恒 False,
189
+ # 120 抽样元数据判出 0 条。
190
+ # ② 反向「不含任何场景标志词」→ 失败:单字标志词「时」被「全时窗」误触发。
191
+ # ⇒ **放弃自然语言启发式**,改用**结构化判据**:看槽标签。
192
+ #
193
+ # 结构化判据的依据:CCG「生效条件」若由 `condition_space` 四槽合成,必然带槽标签;
194
+ # 实测 14/20 的条件形如「载体/位置:…;时间:…;方法:…;约束:…」。
195
+ # 真正的"触发场景"(如 #722 报告人改写的「当他说"不想你被换掉"时」)**不会**带这些标签。
196
+ _SLOT_LABELS = ("载体/位置:", "载体/位置:", "载体=", "时间:", "时间:", "方法:", "方法:", "约束:", "约束:")
197
+
198
+
199
+ # 生效条件:cond_text 为假值时返回 False(无条件是另一类问题,不由本函数判);
200
+ # 否则:若同时含**载体/位置**类槽标签与**约束/方法**类槽标签 ⇒ 判为元数据(四槽合成形态)。
201
+ # 只用于写入把关,**不参与判定**——实测证明"跳元数据词项"不能改善判定。
202
+ def cond_is_metadata(cond_text) -> bool:
203
+ """生效条件是否在描述「元数据」(载体/路径/方法/约束),而非「什么时候该用」。
204
+
205
+ 实测背景(2026-10-31,全库 32842 抽样):约 14/20 的条件是四槽合成形态
206
+ `载体/位置:本地文档仓(大域=xxx);时间:全时窗;方法:md…;约束:源文档 a/b.md`,
207
+ **0 条**是「用户会怎么说」。
208
+
209
+ 判据(结构化,非词义猜测):**同时**出现 `载体/位置` 类标签与 `约束`/`方法` 类标签。
210
+ 这样「当他说"不想你被换掉"时」这类真场景条件不会被误判(它没有槽标签)。
211
+ """
212
+ text = str(cond_text or "")
213
+ if not text.strip():
214
+ return False
215
+ has_carrier = ("载体/位置:" in text or "载体/位置:" in text or "载体=" in text)
216
+ has_other = any(k in text for k in ("时间:", "时间:", "方法:", "方法:", "约束:", "约束:"))
217
+ return bool(has_carrier and has_other)
218
+
219
+
220
+ # ── issue #722 / 规范 v0.5 第四节:写入把关(warn 优先,不阻断)─────────
221
+ # 生效条件:content 为节点正文(str 或 None)时,取「# 生效条件」行判其是否为元数据;
222
+ # 无该行时返回 ok=True(无条件是另一类问题,见规范 v0.5「不适用条件 1」)。
223
+ # **不抛异常**:任何内部错误都返回 ok=True + error 字段(写入把关绝不阻断写入)。
224
+ def check_condition_quality(content) -> dict:
225
+ """检查节点的「生效条件」是否为元数据(载体/路径/方法),而非触发场景。
226
+
227
+ 返回 {"ok": bool, "is_metadata": bool, "cond": str, "hint": str}。
228
+ `ok=False` 仅表示"条件质量可疑",**不表示写入应被拒绝**——
229
+ 按 v0.5 第四节,默认档是 `warn`(计数 + 提示),不是 enforce。
230
+ """
231
+ try:
232
+ text = str(content or "")
233
+ cond = ""
234
+ for line in text.splitlines():
235
+ s = line.strip()
236
+ if s.startswith("#") and "生效条件" in s:
237
+ if ":" in s:
238
+ cond = s.split(":", 1)[1].strip()
239
+ elif ":" in s:
240
+ cond = s.split(":", 1)[1].strip()
241
+ break
242
+ if not cond:
243
+ return {"ok": True, "is_metadata": False, "cond": "", "hint": "无生效条件行"}
244
+ meta = cond_is_metadata(cond)
245
+ return {"ok": not meta, "is_metadata": meta, "cond": cond,
246
+ "hint": ("生效条件在描述载体/路径/方法(元数据),不是在描述"
247
+ "「什么时候该用」——检索时它几乎不可能被自然问法命中"
248
+ "(实测库内 76.5% 节点如此)") if meta else ""}
249
+ except Exception as exc: # noqa: BLE001 —— 把关绝不阻断
250
+ return {"ok": True, "is_metadata": False, "cond": "",
251
+ "hint": "检查失败(不影响写入):%s: %s" % (type(exc).__name__, exc)}
252
+
253
+
254
+ # ── 规范 v0.6 第 2.3 节:别名是否"薄"(写入把关用)───────────────────
255
+ # 生效条件:fm 为节点 frontmatter(dict 或 None)、content 为正文(str 或 None)时——
256
+ # 无 aliases(缺失/非 list/空 list)⇒ True;否则若**每个**别名都能在 content 里原样
257
+ # 找到 ⇒ True(只重复已有词、没扩召回首);只要有一个别名在正文里找不到 ⇒ False(有扩展)。
258
+ # **不判数量**——3 个精准别名可能胜过 10 个噪声别名。不抛异常。
259
+ def aliases_is_thin(fm, content) -> bool:
260
+ """别名是否"薄"(无别名,或只重复正文里已有的词)。
261
+
262
+ 实测依据(2026-10-31):issue #722 的条件 `聊交接、换会话、压缩…`
263
+ 与查询 `我不想你被换掉` —— 整词 / 二元组 / 查询扩展 / 现有同义词表**四条路全废**,
264
+ 只有 `aliases=[换掉, 被换, 别消失, 舍不得, …]` 能让 `_like` 从不命中变为命中。
265
+ 而库内 aliases 覆盖率为 **0/120 = 0%** ⇒ 这是最大的一次性改进空间。
266
+ """
267
+ try:
268
+ f = fm if isinstance(fm, dict) else {}
269
+ al = f.get("aliases")
270
+ if not isinstance(al, list) or not al:
271
+ return True
272
+ body = str(content or "")
273
+ if not body:
274
+ return False # 无正文可判,保守认为有扩展
275
+ for a in al:
276
+ s = str(a or "").strip()
277
+ if not s:
278
+ continue
279
+ if s not in body:
280
+ return False # 找到扩召回词
281
+ return True # 全部重复正文已有词 ⇒ 薄
282
+ except Exception: # noqa: BLE001 —— 把关绝不抛
283
+ return True
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@furongjun1999/dsh-memory",
3
- "version": "0.9.18",
3
+ "version": "0.9.21",
4
4
  "description": "灵枢(Lingshu·líng shū)DeepSeek Harness 插件:完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH,对话自动沉淀进 md_cg 认知图(md 文档)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -37,7 +37,14 @@
37
37
  "docs/工作纪律_认知图条目_v1.1.json",
38
38
  "scripts/workspace_index.py",
39
39
  "ui",
40
- "web"
40
+ "web",
41
+ "docs/mdcg/写入别名aliases规范_v0.6.md",
42
+ "docs/mdcg/CCG六要素编译.md",
43
+ "docs/mdcg/guardrail-charter.md",
44
+ "docs/mdcg/MCP工具名口径_v1.0.md",
45
+ "docs/mdcg/recall_metadata.md",
46
+ "docs/mdcg/世界模型功能端_使用与运维_v1.0.md",
47
+ "docs/mdcg/cogmap_ops.md"
41
48
  ],
42
49
  "keywords": [
43
50
  "deepseek",
@@ -60,7 +60,7 @@
60
60
  try { renderResult(await call(tool,args,true)); } catch(e) { const target=$('result'); if(target) target.innerHTML=errorHTML(e); }
61
61
  finally { button.disabled=false; button.textContent=original; }
62
62
  }
63
- function permissionNote(op) { const allowed=info?.whoami?.principal?.ops_allow; return allowed && !allowed.includes(op) ? `<div class="notice">当前令牌未声明 ${esc(op)} 权限。入口保留,调用仍由灵枢权限系统裁定;本界面不会自动扩权。</div>`:''; }
63
+ function permissionNote(op) { const allowed=info?.whoami?.principal?.ops_allow; return allowed && !allowed.includes('*') && !allowed.includes(op) ? `<div class="notice">当前令牌未声明 ${esc(op)} 权限。入口保留,调用仍由灵枢权限系统裁定;本界面不会自动扩权。</div>`:''; }
64
64
  async function overview(token) {
65
65
  $('main').innerHTML=title('让认知,有迹可循。','COGNITIVE WORKSPACE','记忆、目标与自我,在同一张认知图中延续。','<button id="new-memory" class="button primary">+ 记录记忆</button>')+loading();
66
66
  $('new-memory').onclick=()=>navigate('memory',true);
package/web/app.js CHANGED
@@ -60,7 +60,7 @@
60
60
  try { renderResult(await call(tool,args,true)); } catch(e) { const target=$('result'); if(target) target.innerHTML=errorHTML(e); }
61
61
  finally { button.disabled=false; button.textContent=original; }
62
62
  }
63
- function permissionNote(op) { const allowed=info?.whoami?.principal?.ops_allow; return allowed && !allowed.includes(op) ? `<div class="notice">当前令牌未声明 ${esc(op)} 权限。入口保留,调用仍由灵枢权限系统裁定;本界面不会自动扩权。</div>`:''; }
63
+ function permissionNote(op) { const allowed=info?.whoami?.principal?.ops_allow; return allowed && !allowed.includes('*') && !allowed.includes(op) ? `<div class="notice">当前令牌未声明 ${esc(op)} 权限。入口保留,调用仍由灵枢权限系统裁定;本界面不会自动扩权。</div>`:''; }
64
64
  async function overview(token) {
65
65
  $('main').innerHTML=title('让认知,有迹可循。','COGNITIVE WORKSPACE','记忆、目标与自我,在同一张认知图中延续。','<button id="new-memory" class="button primary">+ 记录记忆</button>')+loading();
66
66
  $('new-memory').onclick=()=>navigate('memory',true);