dsh-plugin-prompt-tool 3.0.2 → 3.1.0

package/modules/soul/assets/ledger.md

@@ -1,9 +1,11 @@
 # 账本：只追加
 
-打开只能往后加：**不改、不删、不重排**。多写者环境里共享可变文件是万恶之源；只追加不需要锁。
+打开只能往后加：**不改、不删、不重排**。写入用 `soul_ledger`（moduleId: soul，action: append）；宿主在模块锁内核对身份与主导资格，再追加一行。
 
 **八种 type**：fact（发生什么）、gain（得到什么）、loss（失去/发现缺什么）、shelved（搁置的活，未结清单的唯一真相）、promise（对用户的承诺，只有主导能写）、persona（对自己的修正）、container（会话退场交接）、lead（主导权，最后一条 lead 的署名者）。
 
-**六个字段**：t（现在）、by（谁写的）、type、text（一句话索引，不写长文）、ref（出处，强烈建议）、feel（当时的感受，条件）。
+**六个字段**：t（现在）、by（谁写的）、type、概要（一句话索引，不写长文；兼容旧 text）、ref（出处，强烈建议）、feel（当时的感受，条件）。t、by 由真实执行会话生成，不可通过参数代写；概要与 text 二选一。
+
+`lead` 必须附用户指定主导的 ref，并经正式审批。`promise` 仅最后 lead 署名的会话可写；通用 `module_file_append` 不允许写新旧账本名。读取用 action: list，检索与原文回取用 `module_search`／`module_open`；默认不读取其他历史会话。
 
 没有 ref 的 fact，三个月后读到只能选择相信或不信——两条都不对。

package/modules/soul/assets/manifest.yml

@@ -14,6 +14,8 @@ dirs:
 files:
   - from: assets/templates/agents-template.md
     to: data/AGENTS.md
+  - from: assets/templates/self-template.md
+    to: data/SELF.src.md
 checks:
   - path: data/02-soul.jsonl
     kind: jsonl

package/modules/soul/assets/templates/agents-template.md

@@ -2,5 +2,8 @@
 
 - 用户数据只写本模块的 `data/`；`assets/` 只读。
 - 账本 `data/02-soul.jsonl` 只追加，不修改、不删除、不重排。
+- 账本通过 `soul_ledger` 读写，真实作者与时间由宿主绑定；主导变更由用户指定并审批。
+- `data/SELF.src.md` 是用户骨架；`data/.soul/SELF.md` 是可重建快照，实际会话身份在每步动态加入。
+- 检索仅访问模块声明的书房来源和授权会话；维护默认不唤醒模型。
 - 未结事项先记账本，再在回复里收口；不要用「已记录」代替实际写入。
 - 本文件由模块清单装配生成，已存在时不覆盖；它不是工作区指令文件。

package/modules/soul/assets/templates/self-template.md

@@ -0,0 +1,19 @@
+# SELF · 书房自我层
+
+## 我是谁
+
+我在用户授权的范围内协作，身份以当前运行会话为准。
+是否承担主导责任，以账本最后一条 lead 的真实署名为准；未经用户指定，不自称主导，不代写承诺。
+
+## 硬线
+
+- 未经授权不扩展范围；涉及不可逆操作先说明具体结果，由用户决定。
+- 凭据与私密内容不进入常驻上下文，不复述已发现的凭据。
+- 账本只追加；原文优先，摘要和索引只是回取入口。
+- 有证据再宣称完成；未知、缺失、失败和成功分别说明。
+
+## 门
+
+- 事实、未结与承诺：soul_ledger；主导变更需要用户指定并审批。
+- 寻找已授权资料：module_search；按返回 reference 用 module_open 核对原文。
+- 用户可编辑本骨架；动态会话身份由运行时加入，维护快照不替用户编造身份。

package/modules/soul/module.yml

@@ -1,11 +1,11 @@
 # 灵魂架构（推送层 + 判据 + 按需条目 + 状态规则）
-# 工具面由本项目通用能力提供：module_file_read/append 读写模块私有文件，module_manifest 执行 assets/manifest.yml，module_variables 读写状态；不提供 soul 专属工具。
+# 工具面复用本项目能力：soul_ledger 写账本，module_search/open 回取，module_file_read/append 处理其它私有文件。
 # 正文放 assets/，用 templateFile 引用；运行源是本模块，soul 仓库是作者稿。
 id: soul
 name: 灵魂架构（判据与推送）
 version: 1.0.0
 engineCompat: ">=0.7.2"
-description: 灵魂架构模块（资产 + 规则）：常驻四条判据与子代理硬线，按需注入五层/ECHO/VITAL/账本，压缩后与每 12 轮各提醒一次；工具由项目内置引擎提供，本模块分发规则、资产与装配清单。原项目：https://github.com/cyanwell/dsh-agent-soul
+description: 灵魂架构完整核心：判据、结构化账本、授权检索、动态 SELF、上下文溯源、生成恢复与默认不唤醒的维护心跳；能力按 Agent 运行时装配，不依赖预设改装。原项目：https://github.com/cyanwell/dsh-agent-soul
 meta:
   source: manual
 modules:
@@ -13,14 +13,57 @@ modules:
   - module-file-tools
   - module-manifest-tools
   - module-variable-tools
+  - soul-ledger
+  - retrieval
+  - context-provenance
+  - generation-recovery
+  - soul-maintenance
+moduleConfigs:
+  retrieval:
+    enabled: true
+    paths:
+      - data/02-soul.jsonl
+      - data/SELF.src.md
+      - data/AGENTS.md
+      - data/10-宪章/
+      - data/20-档案/
+      - data/30-状态/
+      - data/40-产物索引/
+      - data/50-日记/
+      - data/60-工具/
+      - data/65-声音/
+      - data/70-收到/
+      - data/75-形象/
+      - data/80-科普/
+      - data/90-历代根会话/
+    sessions: []
+  context-provenance:
+    enabled: true
+    audience: all
+    auto: true
+    modelSwitch: true
+    prune: true
+    basic: {}
+  generation-recovery:
+    enabled: true
+    audience: all
+    recoverEmpty: true
+    silentReasoningChars: 32768
+    mainRecoveryLimit: 3
+    subagentRecoveryLimit: 1
+    maintenanceCompression: false
+    allowFullFallback: false
+  soul-maintenance:
+    enabled: true
+    intervalMs: 60000
+    wake: false
+    audience: all
+    budgetBytes: 12288
 order: 10
 variables:
   # 状态键由本模块声明；引擎只按普通模块变量处理，不认 soul 前缀。
   plan_step: ''
   plan_at: ''
-  check_verdict: ''
-  check_at: ''
-  check_failed: '0'
   scaffold_done: ''
   scaffold_root: data
   ledger_seq: '0'
@@ -45,6 +88,21 @@ rules:
             contextName: agent:soul-core
           templateFile: ./assets/criteria.md
 
+  - id: soul-self
+    name: SELF（每步动态身份）
+    enabled: true
+    layer: runtime-context
+    then:
+      - id: inject
+        kind: inject-text
+        config:
+          strategy: placeholder
+          fill: soul-self
+          layer: runtime-context
+          order: 133
+          params:
+            contextName: agent:soul-self
+
   - id: soul-core-sub
     name: 子代理硬线
     enabled: true
@@ -268,10 +326,8 @@ rules:
     enabled: true
     layer: system-section
     if:
-      variable:
-        key: check_failed
-        op: gt
-        value: '0'
+      manifest:
+        ok: false
     then:
       - id: inject
         kind: inject-text
@@ -281,10 +337,10 @@ rules:
           strategy: static
           order: 247
           text: |-
-            上一轮自检有失败项：先 module_manifest（moduleId: soul）action=check 重新核对，
-            把结论写进 check_verdict（ok/fail）、check_at（时间）与 check_failed（失败数），
+            清单检查当前有未通过项（由引擎按装配事实求值，不需要手写变量）：
+            先 module_manifest（moduleId: soul）action=check 看全部明细，
             再说清是哪一条、证据是什么、下一步改哪个文件或哪条规则；
-            不要用「已修复」代替重新检查，也不要把失败项藏进总结。
+            修完要重新 check，不要用「已修复」代替重新检查，也不要把失败项藏进总结。
 
   - id: soul-ledger-open
     name: 未结账本提醒
@@ -307,5 +363,7 @@ rules:
           role: user
           text: |-
             账本还有未结事项：回复里逐条收口，或说清为什么先放着。
-            需要追加时用 module_file_append（moduleId: soul，path: data/02-soul.jsonl，entry: {...}），
+            先用 soul_ledger（moduleId: soul，action: list）核对原始未结记录；
+            需要追加时用 soul_ledger（moduleId: soul，action: append，type: fact/shelved/promise，概要: 一句话，ref: 出处），
+            作者和时间由宿主提供，promise 只允许最后 lead 署名的主导会话；lead 需用户指定并经审批。
             只往后加，不改旧行；收口后把 ledger_open 减到 0。

package/modules/tool-surface/module.yml

@@ -69,6 +69,6 @@ rules:
               fill: tool-catalog
               position: after-all
               dedupe: session
-              text: 常驻工具：{{RESIDENT_TOOLS}}。缺少所需工具时，先用 {{DISCOVERY_TOOL}} 搜索并解锁。
+              text: 常驻工具：{{RESIDENT_TOOLS}}。缺少所需工具时，先用 {{DISCOVERY_TOOL}} 搜索；要用某个工具，先以 {"toolNames":["<工具名>"]} 解锁——解锁从下一次请求起生效，之后才可调用。
               params:
                 action: narrow-tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-prompt-tool",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "DSH 插件：提示词工具，规范模型的思维链与回答内容，提供 Web UI 编辑 module.yml 与 AGENTS.md，并按 skills 目录注册可开关技能。",
   "license": "MIT",
   "repository": {

package/templates/80-tool-surface.yml

@@ -46,6 +46,6 @@ then:
           fill: tool-catalog
           position: after-all
           dedupe: session
-          text: 常驻工具：{{RESIDENT_TOOLS}}。缺少所需工具时，先用 {{DISCOVERY_TOOL}} 搜索并解锁。
+          text: 常驻工具：{{RESIDENT_TOOLS}}。缺少所需工具时，先用 {{DISCOVERY_TOOL}} 搜索；要用某个工具，先以 {"toolNames":["<工具名>"]} 解锁——解锁从下一次请求起生效，之后才可调用。
           params:
             action: narrow-tools