dsh-plugin-prompt-tool 3.1.3 → 3.1.5

package/modules/soul/assets/ledger.md

@@ -11,3 +11,7 @@
 `lead` 必须附用户指定主导的 ref，并经正式审批。`promise` 仅最后 lead 署名的会话可写；通用 `module_file_append` 不允许写新旧账本名。读取用 action: list，检索与原文回取用 `module_search`／`module_open`；默认不读取其他历史会话。
 
 没有 ref 的 fact，三个月后读到只能选择相信或不信——两条都不对。
+
+**逐项收口**：`action: list, view: pending` 包含新未结与历史待核对，条目 `id` 是宿主稳定引用；分页游标随账本变化失效，失效后重读。`action: close` 必填 `targetId`、`outcome: completed/cancelled` 和非空 `reason`；`ref` 仍是证据出处。完成与取消均追加 close 事件，不改原行。promise 仅当前 lead 收口，shelved 原作者或当前 lead 可收口；同结果重复不追加，换结果拒绝。执行者只能给依据，不能替主导确认承诺。
+
+历史分界在首个合法写操作前固定，普通读取不创建元数据。历史 promise/shelved 逐条待核对，不按摘要猜测完成。SELF 与提醒读取同一投影，无需手工 ledger_open。含 close 后不能把旧程序当安全可写版本；回滚先停写及旧投影贡献，保留全部历史。

package/modules/soul/assets/retrieval-synonyms.json

@@ -0,0 +1,8 @@
+[
+  ["未结", "待办", "未完成"],
+  ["承诺", "promise"],
+  ["搁置", "shelved"],
+  ["主导", "lead"],
+  ["压缩", "compact"],
+  ["恢复", "recovery"]
+]

package/modules/soul/assets/tools.md

@@ -4,6 +4,10 @@
 
 - `soul_ledger`（moduleId: soul）：`action: list` 读账本（limit 1–100）；`action: append` 追加，必填 `type` 与 `概要`（一句话索引，不写长文），建议带 `ref`。type 八种：fact / gain / loss / shelved / promise / persona / container / lead。`promise` 仅最后 lead 署名会话可写，`lead` 需用户指定并审批；t/by 由宿主生成，不能改历史。
 - `module_search`（moduleId: soul）→ 用命中的 `reference` 调 `module_open`（moduleId: soul）回取原文；引用会重新校验授权与版本，不是访问凭据。
+- `soul_ledger` 收口：先 `action: list, view: pending` 取稳定 `id`（有 `nextCursor` 则继续）；再 `action: close, targetId: id, outcome: completed/cancelled, reason: 非空依据`，可附 `ref`。promise 仅当前 lead 确认，shelved 原作者或当前 lead 可确认；暂时搁置仍未结。历史项标待核对，不自动视为已完成。
+- `soul_state`（moduleId: soul）：`status` 看当前时钟、会话状态和来源；`mark` 用 `text`＋`expectedRevision` 显式记短状态（首次 null）；`check` 只读核对文件、SELF实际投递、索引及运行观测，并给旧规则定向升级预览。标记时间与实际活动时间分开，不能指定其他会话。
+- `module_search` 的 `mode: timeline` 按可信时间查已授权账本/会话，可用带时区的 `since/until` 和 `cursor`；未知时间明确标记。普通查询标注精确/归一/近义，原文不改。
+- 旧副本升级：`soul_state action: check, includeUpgrade: true` 显式展开完整文件候选；有冲突先处理，不强覆盖。完整 `files` 交 `module_import` 模型工具按 `targetId`、`overwrite: true` 预览，核对后带新凭据提交；该入口保留私有数据、记忆和技能，不用普通覆盖导入替代。
 - `module_file_read` / `module_file_append`（moduleId: soul）：读取允许 `memory.md`、`assets/`、`data/`；追写只允许 `memory.md` 与 `data/`，一次一行。账本 `data/02-soul.jsonl` 只能走 `soul_ledger`，通用文件接口会被拒。
 - `module_manifest`（moduleId: soul）：`action: next` 看第一条缺失，`check` 看全部检查结果，`apply` 只建缺失文件、不覆盖不删除。
 - `module_variables`（moduleId: soul，scope: module）：`action: list` 读全部并返回 revisions；`get` 读单键；`set` 必须 `key` + `value` + 读取时的 `expectedRevisions`；`delete` 只删本模块键，删除后回落全局。

package/modules/soul/module.yml

@@ -5,7 +5,8 @@ id: soul
 name: 灵魂架构（判据与推送）
 version: 1.0.0
 engineCompat: ">=0.7.2"
-description: 灵魂架构完整核心：判据、结构化账本、授权检索、动态 SELF、上下文溯源、生成恢复与默认不唤醒的维护心跳；能力按 Agent 运行时装配，不依赖预设改装。原项目：https://github.com/cyanwell/dsh-agent-soul
+description: 灵魂架构完整核心：判据、结构化账本、授权检索、动态 SELF、上下文溯源、生成恢复与默认不唤醒的维护心跳；能力按 Agent
+  运行时装配，不依赖预设改装。原项目：https://github.com/cyanwell/dsh-agent-soul
 meta:
   source: manual
 modules:
@@ -37,6 +38,7 @@ moduleConfigs:
       - data/80-科普/
       - data/90-历代根会话/
     sessions: []
+    synonymsFile: assets/retrieval-synonyms.json
   context-provenance:
     enabled: true
     audience: all
@@ -53,12 +55,19 @@ moduleConfigs:
     subagentRecoveryLimit: 1
     maintenanceCompression: false
     allowFullFallback: false
+    lineRepeatChars: 2048
+    crossCallRepeatChars: 2048
+    maxCycleChars: 512
   soul-maintenance:
     enabled: true
     intervalMs: 60000
     wake: false
     audience: all
     budgetBytes: 12288
+    pressureThresholds:
+      - 0.45
+      - 0.6
+      - 0.8
 order: 10
 variables:
   # 状态键由本模块声明；引擎只按普通模块变量处理，不认 soul 前缀。
@@ -66,8 +75,6 @@ variables:
   plan_at: ''
   scaffold_done: ''
   scaffold_root: data
-  ledger_seq: '0'
-  ledger_open: '0'
 rules:
   - id: soul-core
     name: 四条判据（常驻）
@@ -89,7 +96,7 @@ rules:
           templateFile: ./assets/criteria.md
 
   - id: soul-self
-    name: SELF（每步动态身份）
+    name: SELF（每步当前事实）
     enabled: true
     layer: runtime-context
     then:
@@ -150,7 +157,7 @@ rules:
           templateFile: ./assets/layers.md
           params:
             constant: false
-            keys: [灵魂, 五层, ECHO, VITAL, 架构]
+            keys: [ 灵魂, 五层, ECHO, VITAL, 架构 ]
             secondaryKeys: []
             selectiveLogic: AND_ANY
             wordBoundary: ascii-token
@@ -176,7 +183,7 @@ rules:
           templateFile: ./assets/echo.md
           params:
             constant: false
-            keys: [压缩, 上下文满, 摘要, 找不回, 退化]
+            keys: [ 压缩, 上下文满, 摘要, 找不回, 退化 ]
             secondaryKeys: []
             selectiveLogic: AND_ANY
             wordBoundary: ascii-token
@@ -202,7 +209,7 @@ rules:
           templateFile: ./assets/vital.md
           params:
             constant: false
-            keys: [预算, 烧光, 打转, 空转, 该停, 阈值]
+            keys: [ 预算, 烧光, 打转, 空转, 该停, 阈值 ]
             secondaryKeys: []
             selectiveLogic: AND_ANY
             wordBoundary: ascii-token
@@ -228,7 +235,7 @@ rules:
           templateFile: ./assets/ledger.md
           params:
             constant: false
-            keys: [账本, 未结, 承诺, 只追加]
+            keys: [ 账本, 未结, 承诺, 只追加 ]
             secondaryKeys: []
             selectiveLogic: AND_ANY
             wordBoundary: ascii-token
@@ -353,20 +360,19 @@ rules:
           strategy: static
           order: 247
           text: |-
-            清单检查当前有未通过项（由引擎按装配事实求值，不需要手写变量）：
-            先 module_manifest（moduleId: soul）action=check 看全部明细，
-            再说清是哪一条、证据是什么、下一步改哪个文件或哪条规则；
-            修完要重新 check，不要用「已修复」代替重新检查，也不要把失败项藏进总结。
+            清单检查当前有未通过项：先 module_manifest（moduleId: soul）action=check 看文件明细，再 soul_state（moduleId: soul）action=check 看SELF、索引和运行证据。
+            文件齐全不代表SELF已投递或能力已运行；明确哪项失败、证据和下一步，修复后重查，不以手写变量替代检查。
 
   - id: soul-ledger-open
     name: 未结账本提醒
     enabled: true
     layer: pre-step
     if:
-      variable:
-        key: ledger_open
-        op: gt
-        value: '0'
+      all:
+        - scope:
+            audience: main
+        - soul:
+            pending: true
     then:
       - id: inject
         kind: inject-text
@@ -378,8 +384,8 @@ rules:
           order: 126
           role: user
           text: |-
-            账本还有未结事项：回复里逐条收口，或说清为什么先放着。
-            先用 soul_ledger（moduleId: soul，action: list）核对原始未结记录；
-            需要追加时用 soul_ledger（moduleId: soul，action: append，type: fact/shelved/gain/loss/persona/container 之一，概要: 一句话，ref: 出处），
-            作者和时间由宿主提供，promise 只允许最后 lead 署名的主导会话；lead 需用户指定并经审批。
-            只往后加，不改旧行；收口后把 ledger_open 减到 0。
+            账本有未结或历史待核对事项：先用 soul_ledger（moduleId: soul，action: list，view: pending）分页核对稳定 id。
+            明确完成或取消时，action: close，targetId: 该 id，outcome: completed/cancelled，reason: 非空依据；ref 仍表示出处。
+            promise 仅当前 lead 收口；shelved 允许原作者或当前 lead。执行者可提交证据，不替主导确认承诺。
+            暂时搁置仍是未结，不猜测历史已完成，不手工修改计数。仅主会话按集合变化或成功压缩提醒一次。
+          dedupe: batch

package/package.json

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