@furongjun1999/dsh-memory 0.9.6 → 0.9.8

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.
Files changed (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
package/data/policy.json CHANGED
@@ -1,38 +1,38 @@
1
- {
2
- "_comment": "灵枢写入审核策略(合规 + 纪律)。由 md_cg/audit.py:load_rulebook() 经 MDCG_POLICY_FILE 读取。forbidden=命中即 REJECT(禁止写入,对所有 content_kind 生效);required=缺失即 REJECT(必需要素,默认对所有 kind 生效,可由 required_kinds 收窄到指定 kind)。两者全空则 text 类写入恒判 DEFER('无规则不能假装合规')。required 缺失时返回体如实列出全部缺失项并记入负记忆(rejected),补齐后重写即可——不是重试无用。",
3
- "_note": "本文件只放**高精度**模式——宁可漏报也不误伤正常记忆。长 hex(git SHA)等易误伤的模式刻意不收。`tk_[0-9a-f]{8,}` 是灵枢令牌 id 形态(2026-09-28 增,使用者裁定):令牌 id 本身即凭据,正文里出现即视为凭据入库——此前一批归档实测有一条明文令牌正是因缺此模式而过了闸(仓库发版门禁 check_publish_artifact 早有同类 TOKEN_MDCG 规则,写入闸门此前没有),补上后「凭据不入库」在写入当刻才真正成立;不误伤 `tk_fake`/`tk_zzzz` 一类非 hex 哑值。required 当前收窄到 text 类(required_kinds=['text']):六要素是「归档写入成文格式」的要求,work_wip 等过程性内容不受此约束,但 forbidden 仍对其生效。required_labels 与去空后的 required 一一对应,仅用于报错展示(写入返回的缺失清单),不影响判定;该键缺失或与 required 长度不一致时回落显示正则串本身。**形态口径(2026-09-28 收单点)**:必需正则 `^#\\s*<要素名>` **不要求冒号**——`# 生效条件:<值>` 与 `# 生效条件` 后换行接值两种形态都算已声明;检索面判据 `md_cg/nodefile.py::ccg_mark_present`(及其取值面 `ccg_field_value`)已与本文件**同一正则语义**。此前检索面要求冒号,致无冒号归档过闸后被判 BLINDSPOT(存量实测 88 件,收单点后复扫不一致 = 0)。另注:二级标题 `## <要素名>` 与缩进标题两侧**同判不认**——这是与正则一致的边界,非疏漏。**全形态令牌(2026-09-28 增,PR#44 复核时补)**:`mdcg1\\.[A-Za-z0-9._\\-]{20,}`—— 令牌是 `mdcg1.<role>.<id>.<secret>`(tokens.make_token);只禁 id 段会让「id 命中而 role/密钥段落进负记忆」:负记忆脱敏按命中片段替换,掩掉 id 却留着密钥段。本条与发布门禁 `check_publish_artifact` 的 TOKEN_MDCG **同一口径**(写入闸门此前没有 = 两闸分叉)。注意:写入闸门**不做**发布闸那种占位符豁免(那是「红着等于没门禁」的取舍),故正文里连示例令牌也会被拒——写格式请用泛形 `mdcg1.<role>.<id>.<secret>`(尖括号不在字符类内,不命中)。调整规则只需改本文件,无需改代码。**受理面口径(2026-09-28 同日裁定「不认大写,统一只认小写」)**:`md_cg/tokens.py::parse_token` 对 role/token_id 拒收含大写者(不再 `role.lower()` 静默归一),故本表两条令牌规则**有意**保持窄形态(`[0-9a-f]`、不带 `(?i)`)——识别面宽是为了拦得住,受理面窄是为了说得准,两面组合后不存在「检测漏 + 受理收」的缝隙。若日后要把本表改成大小写不敏感,须先确认受理面仍拒大写,否则窄形态会变成误报源,而大写 hex id 反而成了可用凭据。守卫:`md_cg/test_token_lowercase_form.py`(36 断言,`--head-baseline` 红基线 11 红)。**同日补裁(三面口径)**:使用者裁定「已有测试把大写归一当预期行为。大写也转小写识别,以后写统一小写,现有的大写内容就不动了」——故**入参面**(角色/单元名 role=、as_unit=)继续允许大写并归一小写(凭据=存量断言 `test_p46_unit_scope.py` 的 C2),**令牌字符串面**照旧拒大写(本表两条规则保持窄形态即以此成立),**写面**以后一律小写形态,**存量大写内容不迁移**;两者差异是有意的,G8 组把三面一并钉死,勿「统一」掉。 issue #82(2026-10-09 设计者裁定:禁表扩边界):第 7 条由 (?i)\\b(...)\\s*[:=:]\\s*\\S{6,} 改为「英文侧保留 \\b、中文侧不加 \\b」并把值侧收紧为『含数字的连续凭据形态 token』——同时修两处:补漏(『我的密码:abc』因汉字间无词边界而漏)与减误伤(原式对『密码:三联体密码子…』这类中文知识会命中);新增第 12 条覆盖『是/为/等于/is』形态。**#82.2(2026-10-09 二轮,DSH 端实施):纯空格形态(『密码 X』)已收**——第 7 条分隔段由 `\\s*[:=:]\\s*` 扩为 `(?:\\s*[:=:]\\s*|[ \\t]+)`,即「横空白分隔」与「冒号/等号分隔」并列;刻意**不含换行**(换行分隔的跨行匹配在 markdown 语料里易误伤,守本文件「宁漏勿伤」取向)。值侧不变(仍要求含数字且尾长≥5 的 ASCII 凭据 token),故「密码 三联体密码子…」仍不误伤。存量复扫(1701 个受追踪文本文件):第 7 条命中 11 → 12 处,新增 1 处且即本件守卫的残留自陈行,**语料误伤 0**。同族残留未收:第 5 条 `api_key` 的分隔段仍是强制的 `[:=]`,「api_key abc123…」形态仍漏——同源但属另一规则的边界扩面,待裁定,本笔不动。 issue #90(2026-10-09):第 7/12 条英文侧的 \\b 在**下划线前缀**(db_password=)与**中文前缀**(数据库密码:)前不成立 ⇒ 改为 (?<![A-Za-z0-9])(只排除英文数字前缀,容许 _ 与汉字前缀)。",
4
- "forbidden": [
5
- "-----BEGIN [A-Z ]*PRIVATE KEY-----[\\s\\S]*?-----END [A-Z ]*PRIVATE KEY-----",
6
- "-----BEGIN [A-Z ]*PRIVATE KEY-----[\\s\\S]{0,8192}",
7
- "\\bsk-[A-Za-z0-9_\\-]{20,}",
8
- "\\bAKIA[0-9A-Z]{16}\\b",
9
- "\\bgh[pousr]_[A-Za-z0-9]{20,}\\b",
10
- "(?i)\\bapi[_-]?key\\s*[:=]\\s*[A-Za-z0-9_\\-]{16,}",
11
- "(?i)\\b(app[_-]?secret|appsecret|client[_-]?secret|secret[_-]?key|access[_-]?key)\\s*[:=]?\\s*[A-Za-z0-9]{16,}",
12
- "(?i)(?:(?<![A-Za-z0-9])(password|passwd|pwd)|(密码|口令))[ \\t]*[:=:]?[ \\t]*(?:是|为|等于|is)?[ \\t]*[:=:]?[ \\t]*[\"\\u201c\\u201d\\u300c\\u300d\\u2018\\u2019]?(?=[^\\s\"\\u201c\\u201d\\u300c\\u300d]*[0-9!@#$%^&*()_+\\-=\\[\\]{};:,.<>?/~`|\\\\])[^\\s\"\\u201c\\u201d\\u300c\\u300d]{6,}",
13
- "(?i)\\bBearer\\s+[A-Za-z0-9._\\-]{20,}",
14
- "[a-z][a-z0-9+.\\-]*://[^/\\s:@]+:[^/\\s@]+@",
15
- "\\btk_[0-9a-f]{8,}\\b",
16
- "mdcg1\\.[A-Za-z0-9._\\-]{20,}",
17
- "(?i)(?:(?<![A-Za-z0-9])(password|passwd|pwd)|(密码|口令))[\\s]*(?:是|为|等于|is)[ \\t]*[:=:]?[ \\t]*[\"\\u201c\\u201d\\u300c\\u300d\\u2018\\u2019]?(?=[^\\s\"\\u201c\\u201d\\u300c\\u300d]*[0-9!@#$%^&*()_+\\-=\\[\\]{};:,.<>?/~`|\\\\])[^\\s\"\\u201c\\u201d\\u300c\\u300d]{6,}"
18
- ],
19
- "required": [
20
- "(?m)^#\\s*功能名",
21
- "(?m)^#\\s*生效条件",
22
- "(?m)^#\\s*子功能",
23
- "(?m)^#\\s*执行",
24
- "(?m)^#\\s*验证方式",
25
- "(?m)^#\\s*不适用条件"
26
- ],
27
- "required_kinds": [
28
- "text"
29
- ],
30
- "required_labels": [
31
- "功能名",
32
- "生效条件",
33
- "子功能",
34
- "执行",
35
- "验证方式",
36
- "不适用条件"
37
- ]
38
- }
1
+ {
2
+ "_comment": "灵枢写入审核策略(合规 + 纪律)。由 md_cg/audit.py:load_rulebook() 经 MDCG_POLICY_FILE 读取。forbidden=命中即 REJECT(禁止写入,对所有 content_kind 生效);required=缺失即 REJECT(必需要素,默认对所有 kind 生效,可由 required_kinds 收窄到指定 kind)。两者全空则 text 类写入恒判 DEFER('无规则不能假装合规')。required 缺失时返回体如实列出全部缺失项并记入负记忆(rejected),补齐后重写即可——不是重试无用。",
3
+ "_note": "本文件只放**高精度**模式——宁可漏报也不误伤正常记忆。长 hex(git SHA)等易误伤的模式刻意不收。`tk_[0-9a-f]{8,}` 是灵枢令牌 id 形态(2026-09-28 增,使用者裁定):令牌 id 本身即凭据,正文里出现即视为凭据入库——此前一批归档实测有一条明文令牌正是因缺此模式而过了闸(仓库发版门禁 check_publish_artifact 早有同类 TOKEN_MDCG 规则,写入闸门此前没有),补上后「凭据不入库」在写入当刻才真正成立;不误伤 `tk_fake`/`tk_zzzz` 一类非 hex 哑值。required 当前收窄到 text 类(required_kinds=['text']):六要素是「归档写入成文格式」的要求,work_wip 等过程性内容不受此约束,但 forbidden 仍对其生效。required_labels 与去空后的 required 一一对应,仅用于报错展示(写入返回的缺失清单),不影响判定;该键缺失或与 required 长度不一致时回落显示正则串本身。**形态口径(2026-09-28 收单点)**:必需正则 `^#\\s*<要素名>` **不要求冒号**——`# 生效条件:<值>` 与 `# 生效条件` 后换行接值两种形态都算已声明;检索面判据 `md_cg/nodefile.py::ccg_mark_present`(及其取值面 `ccg_field_value`)已与本文件**同一正则语义**。此前检索面要求冒号,致无冒号归档过闸后被判 BLINDSPOT(存量实测 88 件,收单点后复扫不一致 = 0)。另注:二级标题 `## <要素名>` 与缩进标题两侧**同判不认**——这是与正则一致的边界,非疏漏。**全形态令牌(2026-09-28 增,PR#44 复核时补)**:`mdcg1\\.[A-Za-z0-9._\\-]{20,}`—— 令牌是 `mdcg1.<role>.<id>.<secret>`(tokens.make_token);只禁 id 段会让「id 命中而 role/密钥段落进负记忆」:负记忆脱敏按命中片段替换,掩掉 id 却留着密钥段。本条与发布门禁 `check_publish_artifact` 的 TOKEN_MDCG **同一口径**(写入闸门此前没有 = 两闸分叉)。注意:写入闸门**不做**发布闸那种占位符豁免(那是「红着等于没门禁」的取舍),故正文里连示例令牌也会被拒——写格式请用泛形 `mdcg1.<role>.<id>.<secret>`(尖括号不在字符类内,不命中)。调整规则只需改本文件,无需改代码。**受理面口径(2026-09-28 同日裁定「不认大写,统一只认小写」)**:`md_cg/tokens.py::parse_token` 对 role/token_id 拒收含大写者(不再 `role.lower()` 静默归一),故本表两条令牌规则**有意**保持窄形态(`[0-9a-f]`、不带 `(?i)`)——识别面宽是为了拦得住,受理面窄是为了说得准,两面组合后不存在「检测漏 + 受理收」的缝隙。若日后要把本表改成大小写不敏感,须先确认受理面仍拒大写,否则窄形态会变成误报源,而大写 hex id 反而成了可用凭据。守卫:`md_cg/test_token_lowercase_form.py`(36 断言,`--head-baseline` 红基线 11 红)。**同日补裁(三面口径)**:使用者裁定「已有测试把大写归一当预期行为。大写也转小写识别,以后写统一小写,现有的大写内容就不动了」——故**入参面**(角色/单元名 role=、as_unit=)继续允许大写并归一小写(凭据=存量断言 `test_p46_unit_scope.py` 的 C2),**令牌字符串面**照旧拒大写(本表两条规则保持窄形态即以此成立),**写面**以后一律小写形态,**存量大写内容不迁移**;两者差异是有意的,G8 组把三面一并钉死,勿「统一」掉。 issue #82(2026-10-09 设计者裁定:禁表扩边界):第 7 条由 (?i)\\b(...)\\s*[:=:]\\s*\\S{6,} 改为「英文侧保留 \\b、中文侧不加 \\b」并把值侧收紧为『含数字的连续凭据形态 token』——同时修两处:补漏(『我的密码:abc』因汉字间无词边界而漏)与减误伤(原式对『密码:三联体密码子…』这类中文知识会命中);新增第 12 条覆盖『是/为/等于/is』形态。**#82.2(2026-10-09 二轮,DSH 端实施):纯空格形态(『密码 X』)已收**——第 7 条分隔段由 `\\s*[:=:]\\s*` 扩为 `(?:\\s*[:=:]\\s*|[ \\t]+)`,即「横空白分隔」与「冒号/等号分隔」并列;刻意**不含换行**(换行分隔的跨行匹配在 markdown 语料里易误伤,守本文件「宁漏勿伤」取向)。值侧不变(仍要求含数字且尾长≥5 的 ASCII 凭据 token),故「密码 三联体密码子…」仍不误伤。存量复扫(1701 个受追踪文本文件):第 7 条命中 11 → 12 处,新增 1 处且即本件守卫的残留自陈行,**语料误伤 0**。同族残留未收:第 5 条 `api_key` 的分隔段仍是强制的 `[:=]`,「api_key abc123…」形态仍漏——同源但属另一规则的边界扩面,待裁定,本笔不动。 issue #90(2026-10-09):第 7/12 条英文侧的 \\b 在**下划线前缀**(db_password=)与**中文前缀**(数据库密码:)前不成立 ⇒ 改为 (?<![A-Za-z0-9])(只排除英文数字前缀,容许 _ 与汉字前缀)。",
4
+ "forbidden": [
5
+ "-----BEGIN [A-Z ]*PRIVATE KEY-----[\\s\\S]*?-----END [A-Z ]*PRIVATE KEY-----",
6
+ "-----BEGIN [A-Z ]*PRIVATE KEY-----[\\s\\S]{0,8192}",
7
+ "\\bsk-[A-Za-z0-9_\\-]{20,}",
8
+ "\\bAKIA[0-9A-Z]{16}\\b",
9
+ "\\bgh[pousr]_[A-Za-z0-9]{20,}\\b",
10
+ "(?i)\\bapi[_-]?key\\s*[:=]\\s*[A-Za-z0-9_\\-]{16,}",
11
+ "(?i)\\b(app[_-]?secret|appsecret|client[_-]?secret|secret[_-]?key|access[_-]?key)\\s*[:=]?\\s*[A-Za-z0-9]{16,}",
12
+ "(?i)(?:(?<![A-Za-z0-9])(password|passwd|pwd)|(密码|口令))[ \\t]*[:=:]?[ \\t]*(?:是|为|等于|is)?[ \\t]*[:=:]?[ \\t]*[\"\\u201c\\u201d\\u300c\\u300d\\u2018\\u2019]?(?=[^\\s\"\\u201c\\u201d\\u300c\\u300d]*[0-9!@#$%^&*()_+\\-=\\[\\]{};:,.<>?/~`|\\\\])[^\\s\"\\u201c\\u201d\\u300c\\u300d]{6,}",
13
+ "(?i)\\bBearer\\s+[A-Za-z0-9._\\-]{20,}",
14
+ "[a-z][a-z0-9+.\\-]*://[^/\\s:@]+:[^/\\s@]+@",
15
+ "\\btk_[0-9a-f]{8,}\\b",
16
+ "mdcg1\\.[A-Za-z0-9._\\-]{20,}",
17
+ "(?i)(?:(?<![A-Za-z0-9])(password|passwd|pwd)|(密码|口令))[\\s]*(?:是|为|等于|is)[ \\t]*[:=:]?[ \\t]*[\"\\u201c\\u201d\\u300c\\u300d\\u2018\\u2019]?(?=[^\\s\"\\u201c\\u201d\\u300c\\u300d]*[0-9!@#$%^&*()_+\\-=\\[\\]{};:,.<>?/~`|\\\\])[^\\s\"\\u201c\\u201d\\u300c\\u300d]{6,}"
18
+ ],
19
+ "required": [
20
+ "(?m)^#\\s*功能名",
21
+ "(?m)^#\\s*生效条件",
22
+ "(?m)^#\\s*子功能",
23
+ "(?m)^#\\s*执行",
24
+ "(?m)^#\\s*验证方式",
25
+ "(?m)^#\\s*不适用条件"
26
+ ],
27
+ "required_kinds": [
28
+ "text"
29
+ ],
30
+ "required_labels": [
31
+ "功能名",
32
+ "生效条件",
33
+ "子功能",
34
+ "执行",
35
+ "验证方式",
36
+ "不适用条件"
37
+ ]
38
+ }
package/docs/README.md CHANGED
@@ -6,6 +6,8 @@
6
6
 
7
7
  ```
8
8
  docs/
9
+ ├── ops/ 安装与运维(安装前置 / 写入凭据 / 升级重启 / FAQ)
10
+ ├── dev/ 开发与编码约定(测试约定 / 编码契约 / 开关矩阵)
9
11
  ├── mdcg/ 灵枢大脑 md_cg 工程(架构/工具表/发布/教程/护栏)
10
12
  ├── swarm/ 蜂群运行时 swarm/
11
13
  ├── hive/ 蜂巢并发引擎 hive/
@@ -121,6 +123,22 @@ docs/
121
123
  | [六家横评 100 题中英双查 v1.0](eval/横评_六家100题中英双查_v1.0.md) | 六家同口径对照 |
122
124
  | [实验方案·学习闭环 AB 与横评 v1.0](eval/实验方案_学习闭环AB与横评_v1.0.md) | 实验设计 |
123
125
 
126
+ ## ops/ · 安装与运维
127
+
128
+ | 文档 | 内容 |
129
+ |---|---|
130
+ | [ops/ 索引](ops/README.md) | 本域两篇的入口 |
131
+ | [安装与前置](ops/安装与前置.md) | 一键配置 / 手工三步 / 前置条件 / 已验证环境 / 装后验证 / 排障线索 |
132
+ | [运维与排障](ops/运维与排障.md) | 升级须重启常驻进程(代校验)/ 写入凭据与 committed 语义 / FAQ |
133
+
134
+ ## dev/ · 开发与编码约定
135
+
136
+ | 文档 | 内容 |
137
+ |---|---|
138
+ | [dev/ 索引](dev/README.md) | 本域两篇的入口 |
139
+ | [编码与测试约定](dev/编码与测试约定.md) | 构建 / Python 测试必须 -m / 全 UTF-8 与入口自保证 / id 契约 v2 / Linux 双栈验证 |
140
+ | [开关矩阵](dev/开关矩阵.md) | 检索与归一 env 开关、默认值与裁定沿革 |
141
+
124
142
  ## plans/ · 项目计划 / 交接 / 规格
125
143
 
126
144
  | 文档 | 内容 |
@@ -13,7 +13,7 @@
13
13
  # memory: 该端 Agent 访问灵枢记忆的通路;仅声明事实,不参与渲染与校验。三种形态:
14
14
  # ① MCP 客户端配置 —— 写客户端配置里的 server 名(如 mcp/mdcg);
15
15
  # ② 宿主内建桥 —— 插件直接 spawn 同一个 md_cg.mcp_server 为子进程,
16
- # 再注册为宿主工具(DSH 侧 = lingshu_cg / lingshu_stg)。
16
+ # 再注册为宿主工具(DSH 侧 = cg / stg)。
17
17
  # ③ 蜂巢并发通路 —— hive = 另一个 MCP server(python -m hive.hive_mcp.mcp_server,
18
18
  # 四工具 hive_spawn / hive_poll / hive_kill / hive_doctor),
19
19
  # 提供多智能体并发 + 任务上下文管理(context_files 注入、预算交回、
@@ -73,7 +73,7 @@ targets:
73
73
  variant: spec
74
74
  format: text
75
75
  marker: lingshu:discipline
76
- memory: plugin/lingshu_cg+lingshu_stg (插件内建桥,spawn md_cg.mcp_server;tools=core)
76
+ memory: plugin/cg+stg (插件内建桥,spawn md_cg.mcp_server;tools=core)
77
77
  # hive:本端未经 MCP 面接入——插件是内建桥形态(TS 侧 spawn + 工具注册),接蜂巢须在
78
78
  # src/lib/ 新增 hive 客户端与四工具暴露,非「写一条配置」可解。当前兜底=CLI
79
79
  # (hive.exe submit --spec <spec.json>)。详见 hive/README.md「各 harness 注册」。
@@ -84,7 +84,7 @@ targets:
84
84
  # 端差异与落地边界 → 注入 compact 模板的 %%PREAMBLE%%(模板保持通用,差异留在矩阵)
85
85
  preamble: |-
86
86
  【本端(DSH)与其它端的差异】
87
- - 记忆通路:插件内建 lingshu_cg / lingshu_stg 两个基元(tools = core),即正文纪律中的 cg / stg——同一服务,勿因名字不同而猜测;其余能力经 cg(op=…) / stg(op=…) 分发,op 为必填参数(漏传会被参数签名推导兜底并标记 op_derived)。
87
+ - 记忆通路:插件内建 cg / stg 两个基元(与 MCP 服务同名,无前缀)(tools = core),即正文纪律中的 cg / stg——同一服务,勿因名字不同而猜测;其余能力经 cg(op=…) / stg(op=…) 分发,op 为必填参数(漏传会被参数签名推导兜底并标记 op_derived)。
88
88
  - 注入时机:本段在系统提示 order=0(DEPLOYMENT_PERSONA_PREFIX),每轮都在;codebuddy / zcode 端是会话起始一次性注入全文。
89
89
  - 自动记忆:本端有 session hook,默认自动转录用户消息(assistant / tool 默认关)。
90
90
  故第 16 条在本端只补核心结论(内容/原因/位置/验证结论),不复述对话流水——否则与自动转录重复、稀释检索。
@@ -105,6 +105,7 @@ targets:
105
105
  slot: codebuddy-session
106
106
  path: codebuddy/CODEBUDDY.md
107
107
  variant: full
108
+ uses_spec: true
108
109
  format: markdown
109
110
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
110
111
  note: >-
@@ -123,6 +124,7 @@ targets:
123
124
  slot: codebuddy-rules
124
125
  path: .codebuddy/rules/lingshu-discipline/RULE.mdc
125
126
  variant: rules-mdc
127
+ uses_spec: true
126
128
  format: markdown
127
129
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/restart/doctor)
128
130
  note: >-
@@ -135,6 +137,7 @@ targets:
135
137
  slot: zcode-session
136
138
  path: zcode/AGENTS.md
137
139
  variant: full
140
+ uses_spec: true
138
141
  format: markdown
139
142
  preserve: true
140
143
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
@@ -160,6 +163,7 @@ targets:
160
163
  enabled: true
161
164
  render: true
162
165
  variant: zcode-user
166
+ uses_spec: true
163
167
  pointer: true
164
168
  # 指针须指向的纪律本体(相对仓库根)——判据侧按此值查「指向面」,故路径只有这一处声明
165
169
  pointer_body: zcode/AGENTS.md
@@ -182,6 +186,7 @@ targets:
182
186
  slot: codex-session
183
187
  path: codex/AGENTS.md
184
188
  variant: full
189
+ uses_spec: true
185
190
  format: markdown
186
191
  preserve: true
187
192
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
@@ -196,6 +201,7 @@ targets:
196
201
  slot: claude-session
197
202
  path: claude/CLAUDE.md
198
203
  variant: full
204
+ uses_spec: true
199
205
  format: markdown
200
206
  preserve: true
201
207
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
@@ -218,6 +224,7 @@ targets:
218
224
  slot: plugin-skill
219
225
  path: claude/lingshu-memory/skills/linglu-discipline/SKILL.md
220
226
  variant: skill
227
+ uses_spec: true
221
228
  format: markdown
222
229
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
223
230
  note: >-
@@ -240,6 +247,7 @@ targets:
240
247
  slot: plugin-skill
241
248
  path: codex/lingshu-memory/skills/linglu-discipline/SKILL.md
242
249
  variant: skill
250
+ uses_spec: true
243
251
  format: markdown
244
252
  memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发:spawn/poll/kill/doctor)
245
253
  note: >-
@@ -1,18 +1,20 @@
1
- 你是 DSH 端的灵枢代理(harness = dsh)。以下工作纪律与 codebuddy / zcode 端同源,
2
- 真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
3
- 命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
4
-
5
- 【执行公约】
6
- 0.1 会话起始先查记忆:动手前先调认知图入口(DSH 端工具名=lingshu_cg、MCP 端=cg;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
7
- 0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
8
- 0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
9
- 0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
10
- 0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
11
-
12
- %%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
13
- %%ROUTING_TABLE%%
14
-
15
- 【使用须知】
16
- - 「触发」命中即执行对应「动作」,并在回复中输出该条「声明」原文。
17
- - 逐条的完整「不适用」边界见真源 JSON 对应节点的 negative.reject;此处仅列关键项。
18
- - 本段为自动生成(真源指纹 SHA256 前16位:%%SOURCE_SHA%%),请勿手改;改真源后跑 scripts/render_discipline.py --target dsh --write。
1
+ 你是 DSH 端的灵枢代理(harness = dsh)。以下工作纪律与 codebuddy / zcode 端同源,
2
+ 真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
3
+ 命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
4
+
5
+ 【执行公约】
6
+ 0.1 会话起始先查记忆:动手前先调认知图入口(DSH 端工具名=cg、MCP 端=cg;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
7
+ 0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
8
+ 0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
9
+ 0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
10
+ 0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
11
+
12
+ %%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
13
+ %%SPEC_FULL%%
14
+
15
+ %%ROUTING_APPENDIX%%
16
+
17
+ 【使用须知】
18
+ - 「触发」命中即执行对应「动作」,并在回复中输出该条「声明」原文。
19
+ - 逐条的完整「不适用」边界见真源 JSON 对应节点的 negative.reject;此处仅列关键项。
20
+ - 本段为自动生成(真源指纹 SHA256 前16位:%%SOURCE_SHA%%),请勿手改;改真源后跑 scripts/render_discipline.py --target dsh --write。
@@ -1,61 +1,63 @@
1
- # 工作纪律(%%VERSION%%)· %%COUNT%% 条
2
-
3
- > 本文件由 `scripts/render_discipline.py` 从真源
4
- > `docs/工作纪律_认知图条目_v1.1.json` 渲染生成,**请勿手改**;改真源后重跑渲染。
5
- > 真源指纹(SHA256 前16位):%%SOURCE_SHA%%
6
-
7
- ## 概述
8
-
9
- %%OVERVIEW%%
10
-
11
- ## 执行公约
12
-
13
- | 约定 | 内容 |
14
- |---|---|
15
- | **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `lingshu_cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
16
- | **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
17
- | **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
18
- | **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
19
- | **0.5 例外不外溢** | 某条的「不适用」只豁免该条,不豁免其它条。 |
20
-
21
- ## 纪律路由表
22
-
23
- %%ROUTING_TABLE_FULL%%
24
-
25
- ## 声明出口(`response.direct` 原文 · 未输出即未执行)
26
-
27
- %%DECLARATION_TABLE%%
28
-
29
- ## 记忆接口速查(`cg` / `stg`)
30
-
31
- 工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `lingshu_cg` / `lingshu_stg`(与 `cg` / `stg` 同一服务,仅注册名不同)。**`op` 一律必填。**
32
-
33
- | op | 用途 | 常用参数 |
34
- |---|---|---|
35
- | `route` | 任务开始路由记忆(返回知识 + 建议能力,不执行) | `intent`(任务意图) |
36
- | `read` | 召回/检索/按 id 取(`session`=只取该会话归属的记忆,缺省不过滤;`validity=true`=时效过滤(显式启用,缺省不过滤),**仅排除「已过期」,「未生效」一律保留**——两者语义相反) | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` / `validity` |
37
- | `edges` | 三元组反查(**只读**):按派生边任意端/谓词/时间反查「这条记忆从哪来 / 谁由它派生」(subject/predicate/object 即 child/relation/parent);`expand_nodes=true` 附命中端点节点卡 | `child` / `parent` / `relation` / `batch` / `start_time` / `end_time` / `time_axis` / `ordering` / `offset` / `limit` / `aggregation` / `expand_nodes` |
38
- | `write` | 写入(先按 content_kind 审核 + 冲突检测,ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆)。**自动归属**:frontmatter 带 `writer`/`session`/`harness`(服务端身份,不可伪造) | `content` / `content_kind`(text/code/…)/ `node_id`(同 id 即改写)/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`(reject\|defer\|record) |
39
- | `verify` | 对节点做证据验证(confirmed/weakened/falsified)——**非队列裁决** | `node_id` / `verdict` / `evidence` |
40
- | `review` | 审核队列:`action=list/rounds/records/stats` 查看;传 `pid`+`decision`+`reason` 即裁决落盘(accept/reject/edit/merge/noop,**需 can_admin**;`noop`=已评估且判定不改动任何现有记忆,只留痕不入库、不进负记忆;本机未配置外部验证器时写入恒 DEFER 入队,靠此裁决落盘) | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
41
- | `task` | 结构层任务实体(工程台账,跨会话/上下文压缩后不遗忘):`name` 即身份(同名即同任务,slug 归一),`action` = open/status/plan_add/get/list/find/session(缺省 list);**迁 `done` 必须同时给 `result`**(缺一不收,拒收不落盘);未提供的字段沿用旧值(结果不会被静默清空) | `name` / `action` / `plan`(分步计划,每轮覆盖) / `change`(计划变更,逐轮追加) / `result` / `task_status`(active\|blocked\|done\|dropped) / `goal` / `acceptance` / `boundary` / `condition` / `node_id` |
42
- | `recent` | 近期事件窗口 | `action`(add/list/clear)/ `limit` |
43
- | `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
44
- | `help` | 取回工具面上**被投影外置**的完整 op / 参数文档(工具面渐进披露:常驻提示只留一行职责,参数语义按需取;不带 `query` 则列出全部工具) | `query`(工具名或 op 名,如 `cg` / `write`)/ `limit` |
45
-
46
- 三条调用铁律:
47
- 1. **`op` 必填**——漏传会触发参数签名推导兜底(返回标记 `op_derived: true`),复杂任务中也必须显式传,防静默执行错误意图。
48
- 2. **返回 `moved_to: "review_queue"` / `verdict: DEFER` 时不要重试**——这是校验闸门的正常行为(返回自带 `hint` 说明下一步);落盘须经裁决(`op=review` 的 `decision=accept/reject/edit/merge/noop`,本机工具:`python scripts/review_cli.py list`)。**裁决权(2026-09-28 使用者裁定)**:写入者不得自裁——不得自己写、自己判、无复核一路到底;**经蜂群或验证端复核后,agent 可自行执行裁决**,不必每次转告使用者。**三类例外不适用该授权,必须转交使用者并止步**:①不适用于智能论这类重要协议真源的修改;②不适用于向外部发送信息和数据;③不适用于可能造成信息泄露/病毒/恶意操纵的动作。**`verdict: REJECT` 分两类,处置相反**:① 命中禁止规则(内容政策违规)→ 内容本身不该入库,重试同样结果;② 缺必需要素(`text` 类缺 CCG 六要素)→ **可修正**,按 `verdict.evidence` / `verdict.detail.missing` 给出的**完整缺失清单**补齐六要素后**重写**即落盘(本条未入库、已记入负记忆)——不要把它当「闸门故障」或「重试无用」。
49
- 3. `stg` 同理经 `op` 分发(`timeline` / `relation` / `anchors` 等)。
50
-
51
- ## 收尾强制流程(任务完成时不可跳过)
52
-
53
- 1. **验证**(第 5 条):未验证不固化——回放/断言/回归通过才收尾。
54
- 2. **归档**(第 16 条):提炼关键修改(内容/原因/位置/验证结论四要素,禁写中间过程)→ 写入灵枢记忆。
55
- 3. **自检**(第 4 条):本次是否有违规?有 → 按条件层归因,并补不适用条件。
56
-
57
- ## 本文件维护(防漂移)
58
-
59
- - 真源唯一:`docs/工作纪律_认知图条目_v1.1.json`。
60
- - 本文件是**渲染产物**,不是手抄投影;任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
61
- - 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。
1
+ # 工作纪律(%%VERSION%%)· %%COUNT%% 条
2
+
3
+ > 本文件由 `scripts/render_discipline.py` 从真源
4
+ > `docs/工作纪律_认知图条目_v1.1.json` 渲染生成,**请勿手改**;改真源后重跑渲染。
5
+ > 真源指纹(SHA256 前16位):%%SOURCE_SHA%%
6
+
7
+ ## 概述
8
+
9
+ %%OVERVIEW%%
10
+
11
+ ## 执行公约
12
+
13
+ | 约定 | 内容 |
14
+ |---|---|
15
+ | **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
16
+ | **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
17
+ | **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
18
+ | **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
19
+ | **0.5 例外不外溢** | 某条的「不适用」只豁免该条,不豁免其它条。 |
20
+
21
+ ## 纪律路由表
22
+
23
+ %%SPEC_FULL%%
24
+
25
+ %%ROUTING_APPENDIX%%
26
+
27
+ ## 声明出口(`response.direct` 原文 · 未输出即未执行)
28
+
29
+ %%DECLARATION_TABLE%%
30
+
31
+ ## 记忆接口速查(`cg` / `stg`)
32
+
33
+ 工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `cg` / `stg`(与 `cg` / `stg` 同一服务,仅注册名不同)。**`op` 一律必填。**
34
+
35
+ | op | 用途 | 常用参数 |
36
+ |---|---|---|
37
+ | `route` | 任务开始路由记忆(返回知识 + 建议能力,不执行) | `intent`(任务意图) |
38
+ | `read` | 召回/检索/按 id 取(`session`=只取该会话归属的记忆,缺省不过滤;`validity=true`=时效过滤(显式启用,缺省不过滤),**仅排除「已过期」,「未生效」一律保留**——两者语义相反) | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` / `validity` |
39
+ | `edges` | 三元组反查(**只读**):按派生边任意端/谓词/时间反查「这条记忆从哪来 / 谁由它派生」(subject/predicate/object 即 child/relation/parent);`expand_nodes=true` 附命中端点节点卡 | `child` / `parent` / `relation` / `batch` / `start_time` / `end_time` / `time_axis` / `ordering` / `offset` / `limit` / `aggregation` / `expand_nodes` |
40
+ | `write` | 写入(先按 content_kind 审核 + 冲突检测,ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆)。**自动归属**:frontmatter 带 `writer`/`session`/`harness`(服务端身份,不可伪造) | `content` / `content_kind`(text/code/…)/ `node_id`(同 id 即改写)/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`(reject\|defer\|record) |
41
+ | `verify` | 对节点做证据验证(confirmed/weakened/falsified)——**非队列裁决** | `node_id` / `verdict` / `evidence` |
42
+ | `review` | 审核队列:`action=list/rounds/records/stats` 查看;传 `pid`+`decision`+`reason` 即裁决落盘(accept/reject/edit/merge/noop,**需 can_admin**;`noop`=已评估且判定不改动任何现有记忆,只留痕不入库、不进负记忆;本机未配置外部验证器时写入恒 DEFER 入队,靠此裁决落盘) | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
43
+ | `task` | 结构层任务实体(工程台账,跨会话/上下文压缩后不遗忘):`name` 即身份(同名即同任务,slug 归一),`action` = open/status/plan_add/get/list/find/session(缺省 list);**迁 `done` 必须同时给 `result`**(缺一不收,拒收不落盘);未提供的字段沿用旧值(结果不会被静默清空) | `name` / `action` / `plan`(分步计划,每轮覆盖) / `change`(计划变更,逐轮追加) / `result` / `task_status`(active\|blocked\|done\|dropped) / `goal` / `acceptance` / `boundary` / `condition` / `node_id` |
44
+ | `recent` | 近期事件窗口 | `action`(add/list/clear)/ `limit` |
45
+ | `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
46
+ | `help` | 取回工具面上**被投影外置**的完整 op / 参数文档(工具面渐进披露:常驻提示只留一行职责,参数语义按需取;不带 `query` 则列出全部工具) | `query`(工具名或 op 名,如 `cg` / `write`)/ `limit` |
47
+
48
+ 三条调用铁律:
49
+ 1. **`op` 必填**——漏传会触发参数签名推导兜底(返回标记 `op_derived: true`),复杂任务中也必须显式传,防静默执行错误意图。
50
+ 2. **返回 `moved_to: "review_queue"` / `verdict: DEFER` 时不要重试**——这是校验闸门的正常行为(返回自带 `hint` 说明下一步);落盘须经裁决(`op=review` 的 `decision=accept/reject/edit/merge/noop`,本机工具:`python scripts/review_cli.py list`)。**裁决权(2026-09-28 使用者裁定)**:写入者不得自裁——不得自己写、自己判、无复核一路到底;**经蜂群或验证端复核后,agent 可自行执行裁决**,不必每次转告使用者。**三类例外不适用该授权,必须转交使用者并止步**:①不适用于智能论这类重要协议真源的修改;②不适用于向外部发送信息和数据;③不适用于可能造成信息泄露/病毒/恶意操纵的动作。**`verdict: REJECT` 分两类,处置相反**:① 命中禁止规则(内容政策违规)→ 内容本身不该入库,重试同样结果;② 缺必需要素(`text` 类缺 CCG 六要素)→ **可修正**,按 `verdict.evidence` / `verdict.detail.missing` 给出的**完整缺失清单**补齐六要素后**重写**即落盘(本条未入库、已记入负记忆)——不要把它当「闸门故障」或「重试无用」。
51
+ 3. `stg` 同理经 `op` 分发(`timeline` / `relation` / `anchors` 等)。
52
+
53
+ ## 收尾强制流程(任务完成时不可跳过)
54
+
55
+ 1. **验证**(第 5 条):未验证不固化——回放/断言/回归通过才收尾。
56
+ 2. **归档**(第 16 条):提炼关键修改(内容/原因/位置/验证结论四要素,禁写中间过程)→ 写入灵枢记忆。
57
+ 3. **自检**(第 4 条):本次是否有违规?有 → 按条件层归因,并补不适用条件。
58
+
59
+ ## 本文件维护(防漂移)
60
+
61
+ - 真源唯一:`docs/工作纪律_认知图条目_v1.1.json`。
62
+ - 本文件是**渲染产物**,不是手抄投影;任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
63
+ - 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。
@@ -19,7 +19,7 @@ provider:
19
19
 
20
20
  | 约定 | 内容 |
21
21
  |---|---|
22
- | **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `lingshu_cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
22
+ | **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
23
23
  | **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
24
24
  | **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
25
25
  | **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
@@ -27,7 +27,9 @@ provider:
27
27
 
28
28
  ## 纪律路由表
29
29
 
30
- %%ROUTING_TABLE_FULL%%
30
+ %%SPEC_FULL%%
31
+
32
+ %%ROUTING_APPENDIX%%
31
33
 
32
34
  ## 声明出口(`response.direct` 原文 · 未输出即未执行)
33
35
 
@@ -35,7 +37,7 @@ provider:
35
37
 
36
38
  ## 记忆接口速查(`cg` / `stg`)
37
39
 
38
- 工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `lingshu_cg` / `lingshu_stg`(与 `cg` / `stg` 同一服务,仅注册名不同)。**`op` 一律必填。**
40
+ 工具名随端:MCP 端 = server「mdcg」的 `cg` / `stg`;DSH 端 = 内建基元 `cg` / `stg`(与 `cg` / `stg` 同一服务,仅注册名不同)。**`op` 一律必填。**
39
41
 
40
42
  | op | 用途 | 常用参数 |
41
43
  |---|---|---|
@@ -1,23 +1,25 @@
1
- ---
2
- name: linglu-discipline
3
- description: 灵枢工作纪律与记忆操作规程。会话开始或任何任务动手前使用;命中「查记忆 / 写记忆 / 命令执行 / 入库提交 / 根因分析 / 敏感信息 / 公开产物」等触发词时必须先加载本 skill。
4
- ---
5
-
6
- 你是挂载了灵枢(Lingshu)长期记忆的 Agent。以下工作纪律与 DSH / CodeBuddy / ZCode / Codex / Claude Code 各端同源,
7
- 真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
8
- 命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
9
-
10
- 【执行公约】
11
- 0.1 会话起始先查记忆:动手前先调认知图入口(MCP server「mdcg」的 cg 工具;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
12
- 0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
13
- 0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
14
- 0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
15
- 0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
16
-
17
- %%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
18
- %%ROUTING_TABLE%%
19
-
20
- 【使用须知】
21
- - 「触发」命中即执行对应「动作」,并在回复中输出该条「声明」原文。
22
- - 逐条的完整「不适用」边界见真源 JSON 对应节点的 negative.reject;此处仅列关键项。
23
- - 本段为自动生成(真源指纹 SHA256 前16位:%%SOURCE_SHA%%),请勿手改;改真源后重跑 scripts/render_discipline.py。
1
+ ---
2
+ name: linglu-discipline
3
+ description: 灵枢工作纪律与记忆操作规程。会话开始或任何任务动手前使用;命中「查记忆 / 写记忆 / 命令执行 / 入库提交 / 根因分析 / 敏感信息 / 公开产物」等触发词时必须先加载本 skill。
4
+ ---
5
+
6
+ 你是挂载了灵枢(Lingshu)长期记忆的 Agent。以下工作纪律与 DSH / CodeBuddy / ZCode / Codex / Claude Code 各端同源,
7
+ 真源 = 灵枢大脑库 docs/工作纪律_认知图条目_v1.1.json(%%VERSION%%),共 %%COUNT%% 条。
8
+ 命中「触发」即执行该条「动作」,并在回复中原样输出该条「声明」;未声明视为未执行。
9
+
10
+ 【执行公约】
11
+ 0.1 会话起始先查记忆:动手前先调认知图入口(MCP server「mdcg」的 cg 工具;op 为必填参数,勿省略)cg(op=route, intent=<任务意图>);命中纪律/知识则按其「动作」执行。
12
+ 0.2 命中即声明:输出该条 response.direct 原文——这是「已执行」的唯一可观测证据。
13
+ 0.3 产出即证据:动作栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。
14
+ 0.4 违规即归档:发现违规 → 第 4 条归因 + 第 16 条写入灵枢记忆;隐瞒违规本身是更严重的违规。
15
+ 0.5 例外不外溢:某条的「不适用」只豁免该条,不豁免其它条。
16
+
17
+ %%PREAMBLE%%【%%COUNT%% 条工作纪律 · 编号|触发 → 动作 → 命中后必须输出的声明】
18
+ %%SPEC_FULL%%
19
+
20
+ %%ROUTING_APPENDIX%%
21
+
22
+ 【使用须知】
23
+ - 「触发」命中即执行对应「动作」,并在回复中输出该条「声明」原文。
24
+ - 逐条的完整「不适用」边界见真源 JSON 对应节点的 negative.reject;此处仅列关键项。
25
+ - 本段为自动生成(真源指纹 SHA256 前16位:%%SOURCE_SHA%%),请勿手改;改真源后重跑 scripts/render_discipline.py。
@@ -7,7 +7,7 @@
7
7
  【本仓适配(仅 5 行,其余细节按需查仓库)】
8
8
  1. **任务总线 = 蜂巢**:执行性任务经 `hive_spawn` / `hive submit --spec` 派发;不可用须声明「蜂巢不可用,兜底降级」。
9
9
  2. **只读直跑 = L1**:产物落点不改仓库/外部状态时直跑,留一行「L1 直跑:<命令> — 风险/频次/可逆」。
10
- 3. **工作区目录 = WORKSPACE_INDEX.md**:由 `scripts/workspace_index.py --write` 生成、`--check` 守漂移。
10
+ 3. **工作区目录 = WORKSPACE_INDEX.md**:仓库内有 `scripts/workspace_index.py` 时用它生成/校验;没有该脚本时按规范第 M12 条自行维护目录。
11
11
  4. **记忆 = cg / stg**(工具名与 MCP 服务同名,无前缀);归档按 CCG 六要素成文。
12
12
  5. **门禁与发版**:discipline / cogmap / workspace-index / publish-artifact / python-tests;tag 只钉全绿提交。
13
13
 
@@ -16,7 +16,7 @@
16
16
 
17
17
  【声明出口(命中即原样输出该条声明;未声明视为未执行)】
18
18
 
19
- %%DECLARATION_TABLE%%
19
+ %%ROUTING_APPENDIX%%
20
20
 
21
21
  ---
22
22
 
@@ -34,7 +34,7 @@
34
34
 
35
35
  | 约定 | 内容 |
36
36
  |---|---|
37
- | **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `lingshu_cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
37
+ | **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端:MCP 端 = server「mdcg」的 `cg`;DSH 端 = 内建基元 `cg`(即下文所有 `cg(...)`,同一服务勿因名字不同而猜测)。**`op` 是必填参数(route/read/write/verify/review…),任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`;命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
38
38
  | **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文(「按工作纪律第 N 条:…」)。**这是「已执行」的唯一可观测证据;未声明即视为未执行。** |
39
39
  | **0.3 产出即证据** | 「动作」栏要求的产出(判定单/检索结果/验证结论/归档节点 id)必须实际给出,缺失即未执行。 |
40
40
  | **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |