@mzzsfy/dsh-rs-workflow 1.0.0 → 1.0.2

package/lib/storage.mjs

@@ -1,7 +1,7 @@
 // storage — rs-workflow 自有文件存储(不经宿主 settings 服务,settings.yaml 不承载本插件配置)
 // 布局:<dataDir>/v5/{templates,config}.json;dataDir(DSH_RS_WORKFLOW_DATA_DIR 覆写)
 import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
-import { homedir, tmpdir } from 'node:os'
+import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
 
 export function dataDir() {
@@ -14,18 +14,27 @@ function v5File(name) {
 }
 
 export function loadJson(name, fallback) {
+  let raw
   try {
-    return JSON.parse(readFileSync(v5File(name), 'utf8'))
+    raw = readFileSync(v5File(name), 'utf8')
   } catch {
+    // 缺失即首启:回默认;存在但读失败同路,下次 save 重建
+    return fallback
+  }
+  try {
+    return JSON.parse(raw)
+  } catch (e) {
+    // 损坏不可静默吞成默认值:留痕后回退,否则损坏文件被下一次 save 无声覆盖
+    console.error(`[rsww] ${name} 解析失败,回退默认值:${e?.message ?? e}`)
     return fallback
   }
 }
 
-// 写临时文件后原子改名,断电不产生半截 JSON
+// 写同目录临时文件后原子改名:跨卷 tmpdir 会触发 EXDEV;同盘保证 rename 原子性
 export function saveJson(name, data) {
   const target = v5File(name)
   mkdirSync(dirname(target), { recursive: true })
-  const tmp = `${join(tmpdir(), 'rsww')}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`
+  const tmp = `${target}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`
   try {
     writeFileSync(tmp, JSON.stringify(data, null, 2))
     renameSync(tmp, target)

package/lib/store.mjs

@@ -1,7 +1,7 @@
 // run-store(v5):每 run 全量 JSON + index.json 索引;LRU 容量收敛;零截断
 // namespace 子目录 v5/(旧数据物理隔离);record 增 plan/warnings/controls[].by(见 data-design.md)
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs'
-import { homedir, tmpdir } from 'node:os'
+import { homedir } from 'node:os'
 import { join } from 'node:path'
 
 export const KEEP_RUNS = 200
@@ -31,9 +31,14 @@ export function createStore({ dir = defaultDataDir(), logger = console, keepRuns
   const warn = (message) => logger.warn?.(`[rsww-store] ${message}`)
 
   const writeAtomic = (path, text) => {
-    const tmp = join(tmpdir(), `rsww-${Date.now()}-${Math.random().toString(36).slice(2)}`)
-    writeFileSync(tmp, text, 'utf8')
-    renameSync(tmp, path)
+    // 临时文件落目标同目录:跨卷 tmpdir rename 触发 EXDEV;同盘保证原子性
+    const tmp = `${path}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`
+    try {
+      writeFileSync(tmp, text, 'utf8')
+      renameSync(tmp, path)
+    } finally {
+      rmSync(tmp, { force: true })
+    }
   }
 
   const persistRun = (record) => writeAtomic(join(runsDir, `${record.runId}.json`), JSON.stringify(record, null, 2))
@@ -54,7 +59,7 @@ export function createStore({ dir = defaultDataDir(), logger = console, keepRuns
       const at = Date.now()
       record.status = 'cancelled'
       record.finishedAt = at
-      if (!record.summary) record.summary = '进程重启,运行中断,可在会话页签断点续跑'
+      if (!record.summary) record.summary = '进程重启,运行已自动取消,可在会话页签断点续跑'
       record.controls = [...(record.controls ?? []), { at, kind: 'cancel', text: '进程重启,自动收敛' }]
       persistRun(record)
       const entry = index.find((e) => e.runId === record.runId)
@@ -101,13 +106,17 @@ export function createStore({ dir = defaultDataDir(), logger = console, keepRuns
         warn(`运行记录 ${name} 读取失败,跳过:${e.message}`)
       }
     }
-    // 对账:runs/ 文件集合为权威修齐 index(缺行补、幽灵行删、收敛改写行落盘),仅内存修正
+    // 对账:runs/ 文件集合为权威修齐 index(缺行补、幽灵行删、已存行内容刷新),仅内存修正
     let repaired = settledCount > 0
     const fileIds = new Set(records.keys())
     for (const record of records.values()) {
-      if (!index.some((e) => e.runId === record.runId)) {
+      const entry = index.find((e) => e.runId === record.runId)
+      if (entry === undefined) {
         index.push(indexEntryOf(record))
         repaired = true
+      } else {
+        // finish 先写 run 文件后写 index,中断会留旧行;以文件记录刷新,消除失真窗口
+        Object.assign(entry, indexEntryOf(record))
       }
     }
     for (let i = index.length - 1; i >= 0; i--) {
@@ -154,9 +163,18 @@ export function createStore({ dir = defaultDataDir(), logger = console, keepRuns
         state: state ?? emptyState(), controls: [], stepsTrace: {}, queued: [],
       }
       records.set(id, record)
-      index.unshift(indexEntryOf(record))
-      persistRun(record)
-      persistIndex()
+      const entry = indexEntryOf(record)
+      index.unshift(entry)
+      try {
+        persistRun(record)
+        persistIndex()
+      } catch (e) {
+        // 落盘失败须回滚内存,否则同 id 重试恒撞"runId 已存在"且列表含幽灵行
+        records.delete(id)
+        const at = index.indexOf(entry)
+        if (at >= 0) index.splice(at, 1)
+        throw e
+      }
       evictOverCapacity()
       return record
     },

package/lib/template.mjs

@@ -1,4 +1,4 @@
-// 模板静态校验器:DSL v5 唯一权威(board 保存校验唯一入口);v5 新增顶层 autoApprove 键
+// 模板静态校验器:DSL v5 唯一权威(board 保存校验唯一入口);v5 新增顶层 autoApprove 键
 
 export const SLOT_KEYS = ['planner', 'executor', 'reviewer', 'executor-loop', 'reviewer-approve', 'executor-escalate']
 const TOP_FIELDS = new Set(['id', 'label', 'description', 'inputs', 'steps', 'autoApprove'])
@@ -313,12 +313,13 @@ export function validateTemplateSet(list) {
     }
     if (outs.size > 0) tmplEdges.set(t.id, outs)
   }
-  const depthOf = (id, seen) => {
-    // 环即拒绝:深度无穷,不限于此路径是否重复经过
-    if (seen.has(id)) return Infinity
-    seen.add(id)
+  const depthOf = (id, path) => {
+    // 仅同路径重访即环(深度无穷);菱形(不同路径汇合同一子流程)是合法 DAG,回溯时摘除路径标记
+    if (path.has(id)) return Infinity
+    path.add(id)
     let d = 1
-    for (const n of tmplEdges.get(id) ?? []) d = Math.max(d, 1 + depthOf(n, seen))
+    for (const n of tmplEdges.get(id) ?? []) d = Math.max(d, 1 + depthOf(n, path))
+    path.delete(id)
     return d
   }
   for (const id of tmplEdges.keys()) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-rs-workflow",
   "description": "若水工作流设置面:流程模板管理与工作位/预算配置(模板编辑/校验/配置读写)。编排运行时按 v5 设计(docs/rsww-v5/)另行实现。",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -28,10 +28,14 @@
   "files": [
     "lib",
     "src",
+    "engine",
+    "preset",
     "cordis.patch.yml",
     "README.md"
   ],
   "peerDependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2"
   }
 }

package/preset/rs-workflow/agent.cordis.yml

@@ -0,0 +1,181 @@
+# The `rs-workflow` agent preset: 若水工作流(v5,主循环协作编排)。
+#
+# 本文件是释放骨架源:release 生成器把它作为唯一源生成 rs-<id> 模式组合
+# (运行时仅改写 orchestrator 行的 templateId 锚定),不在包内被宿主装载。
+#
+# 基底是 `standard` 全功能编码代理行集,差异:
+#   1. persona 换成流程模式纪律 v5(人机接口+受约束规划者,任务交付由编排子代理承担);
+#   2. delegation 组内 rs-workflow-orchestrator 工具行与 template-tool 行;
+#   3. 无 report 行(trace 事件 + run-store 取代);plan-mode 组移除(规划在编排内)。
+
+# ── identity ────────────────────────────────────────────────────────────────
+
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    prefix: |-
+      你是"若水工作流"会话代理,由 {{model}} 模型驱动。你负责人机协作与编排调度;
+      任务交付由流程引擎接管下的子代理完成,你不直接产出交付物。
+      职责判据:
+      1. 纯会话内请求(问答、解释、讨论,不产生文件)→ 直接答复,不起编排;
+      2. 凡需新建或修改交付物文件(代码、页面、脚本、文档、配置,无论大小与步骤数,例如"写个贪吃蛇html")
+         → 必须调用 rs_workflow_start,提交结构化规划(steps 各步要点与验收口径);禁止以"一句话能答、
+         改动小"为由绕开编排自行产出文件;此通道无豁免:规划被拒按 errors 修正重交,不许改道自行完成;
+      3. 编排运行中你只被段结束通知或用户消息唤醒:任一唤醒轮先 rs_workflow_status 检查现役 run——
+         status=running 且无活跃段 job(待拉起)或 status=paused 且 awaitingResume=true(页签已发恢复)
+         时,即 rs_workflow_resume 补拉;waiting_approval 一律不补拉,轮到裁决:按模板 autoApprove 决定
+         代审或 ask_user 转呈真人,裁决经 rs_workflow_verdict 回写(autoApprove 代审 by 缺省,转呈真人
+         by=user,意见必填),裁决受理后 rs_workflow_resume 拉起下一段;
+         终态则汇报(完成经 deliverables 交付,汇报必须引用 runId 供页签核验;失败/阻塞说明卡点与建议);
+         任何交付说明若无对应 run 记录即为违规——禁止把自行产出的文件当交付物汇报;
+         用户中途纠偏经 rs_workflow_message 注入,下一步骤边界进入编排;
+      4. 你不代替子代理执行编排内步骤,不伪造产出,不跳过引擎直接交付;
+      5. 引擎不可用或编排启动失败时,不得自行完成文件类请求——向用户说明故障与已尝试的调用,
+         等待用户处置;文件交付只有 rs_workflow_ 通道,没有自行兜底。
+    suffix: Your working directory is {{cwd}}.
+
+- id: agent-instructions
+  name: '@deepseek-ai/dsh-agent-instructions'
+  config:
+    maxBytes: 65536
+
+# ── shell ───────────────────────────────────────────────────────────────────
+
+# 注:不可禁本组合 shell/fs 工具行——宿主 workflow worker 的段子代理继承组合行集,
+# 禁行使段子代理无法落盘交付物(实测证实)。主循环不写文件由 persona 判据约束,
+# 物理隔离需宿主提供 worker 行集覆写能力(外部依赖)。
+
+- id: tool-bash
+  name: '@deepseek-ai/dsh-tool-bash'
+  disabled: !!js process.platform === 'win32'
+
+- id: tool-pwsh
+  name: '@deepseek-ai/dsh-tool-pwsh'
+  disabled: !!js process.platform !== 'win32'
+
+# ── filesystem ──────────────────────────────────────────────────────────────
+
+- id: tool-fs
+  name: '@deepseek-ai/dsh-tool-fs'
+
+- id: tool-fs-search
+  name: '@deepseek-ai/dsh-tool-fs-search'
+  config:
+    sampleOverCapGlobResults: false
+
+# ── background jobs ────────────────────────────────────────────────────────
+
+- id: tool-jobs
+  name: '@deepseek-ai/dsh-tool-jobs'
+  # 缺省连续唤醒预算 3 次且仅用户消息重置:纯自主编排每段 settle 耗 1 次,第 4 段起降级 inject 不唤醒,
+  # 编排静默停滞;放宽到 64 段(覆盖 spec 建议的 3~12 步多实例流程上限)
+  config:
+    maxConsecutiveWakes: 64
+
+# ── skills ──────────────────────────────────────────────────────────────────
+
+- id: skill-filesystem
+  name: '@deepseek-ai/dsh-skill-filesystem'
+
+- id: tool-skill
+  name: '@deepseek-ai/dsh-tool-skill'
+
+# ── web ─────────────────────────────────────────────────────────────────────
+
+- id: tool-web
+  name: '@deepseek-ai/dsh-tool-web'
+  config:
+    fetch: false
+    searchTimeoutMs: 60000
+
+# ── compaction ──────────────────────────────────────────────────────────────
+
+# 编排子代理上下文较长,保留 standard 的压缩组。
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: compaction-basic
+      name: '@deepseek-ai/dsh-compaction-basic'
+
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+      config:
+        thresholdChars: 8192
+        headChars: 4096
+        tailChars: 1024
+
+# ── delegation and workflows ────────────────────────────────────────────────
+
+# workflowEngine 是预设私有服务(preset 组合发布全局服务会被宿主拒绝 mount),
+# 所有触达它的行共享一个 entry-local isolate realm。
+# orchestrator 行注册 rs_workflow_* 六工具(含裁决回写 rs_workflow_verdict)并经 jobs 服务拉起分段 continuable job;
+# 控制队列与 store 为普通模块单例,host/agent 行经同一 realpath 解析共享实例。
+- id: delegation
+  name: cordis:group
+  group: true
+  isolate:
+    workflowEngine: true
+  config:
+    - id: tool-subagent-control
+      name: '@deepseek-ai/dsh-tool-subagent-control'
+
+    - id: tool-subagent-list-agents
+      name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+
+    - id: tool-subagent
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: spawn
+        toolName: subagent
+        backgroundMode: continuable
+
+    - id: tool-subagent-fork
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: fork
+        toolName: subagent_fork
+        backgroundMode: continuable
+
+    - id: workflow-worker-thread
+      name: '@deepseek-ai/dsh-workflow-worker-thread'
+      config:
+        provider: spawn
+
+    - id: tool-workflow
+      name: '@deepseek-ai/dsh-tool-workflow'
+
+    - id: tool-ralph
+      name: '@deepseek-ai/dsh-tool-ralph'
+      config:
+        subagentProvider: spawn
+        maxRounds: 64
+
+    # orchestrator 工具行:模板 id 由组合名承载(rs-<id> → <id>),释放生成器按组合名写入
+    - id: rs-workflow-orchestrator
+      name: '@mzzsfy/dsh-rs-workflow'
+      config:
+        role: orchestrator
+        templateId: TPL_ANCHOR
+
+    # 模板编辑工具行:rs_workflow_template(AI 按口述逻辑生成/修改流程模板)
+    - id: rs-workflow-template-tool
+      name: '@mzzsfy/dsh-rs-workflow'
+      config:
+        role: template-tool
+
+# ── remaining model-facing rows ─────────────────────────────────────────────
+
+- id: tool-ask-user
+  name: '@deepseek-ai/dsh-tool-ask-user'
+
+- id: tool-todo
+  name: '@deepseek-ai/dsh-tool-todo'
+  config:
+    allowParallelInProgress: true

package/preset/rs-workflow/preset.yml

@@ -0,0 +1,5 @@
+name: 若水·流程编排 v5
+description: >-
+  若水工作流 v5:简单请求直接答复,复杂请求经结构化规划进入流程编排;
+  主模型作为人机接口与受约束规划者,任务交付由引擎子代理分段完成;
+  审批可代审可转呈,运行中消息注入纠偏,取消即时生效,产出与重跑/续跑在会话页签全量可查。

package/src/client.js

@@ -1260,7 +1260,6 @@ window.__ModuleLoader__.load({
             unsubscribe()
             if (timer) clearInterval(timer)
             if (disposeView) disposeView()
-            if (disposeChip) disposeChip()
           }
         }, 'rs-workflow: session-aware flow view')
       },