@shgroup/dsh-serenity-hooks 1.16.7 → 1.16.9

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.16.7",
+  "version": "1.16.9",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop + 拦截缝机械约束（safe-mode/路径守卫/会话落盘）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。私有（dsh-external 组织）。",
   "engines": {

package/lib/client.js

@@ -8,7 +8,7 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		//#region \0sp-css:/home/yh/home/home-serenity/AI_LAB/dsh-serenity-plugin/hooks/dsh-serenity-hooks/src/client/SafeModePanel
-		const css = "/* SafeModePanel — 会话头部 Serenity 状态徽章（点击展开详情卡）。\n * 遵循 web-styling.md：颜色只用 --dsw-alias-* 语义 token（明暗自适应）；\n * 尺寸与官方 header 标签一致；前缀 sp- 防冲突。 */\n\n.sp-root {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 24px;\n  padding: 0 4px 0 4px;\n  border-radius: 6px;\n  background: var(--dsw-alias-bg-module-platform);\n  font-size: 12px;\n  line-height: 24px;\n  white-space: nowrap;\n}\n\n.sp-badge {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 22px;\n  padding: 0 6px;\n  border: none;\n  border-radius: 5px;\n  background: transparent;\n  color: inherit;\n  font-size: 12px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-badge:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-badge:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-dot {\n  flex: none;\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n}\n\n.sp-dotOn {\n  background: var(--dsw-alias-state-success-primary);\n}\n\n.sp-dotOff {\n  background: var(--dsw-alias-label-dimmed);\n}\n\n.sp-brand {\n  color: var(--dsw-alias-label-primary);\n  font-weight: 500;\n}\n\n.sp-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  height: 18px;\n  padding: 0 8px;\n  border: none;\n  border-radius: 5px;\n  font-size: 12px;\n  font-weight: 600;\n  line-height: 18px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-toggle:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-toggle:disabled {\n  opacity: 0.55;\n  cursor: default;\n}\n\n.sp-toggleOn {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.sp-toggleOn:hover:not(:disabled) {\n  background: var(--dsw-alias-state-error-secondary);\n}\n\n.sp-toggleOff {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-toggleOff:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover-solid);\n}\n\n.sp-toggleIcon {\n  flex: none;\n}\n\n.sp-toggleLg {\n  height: 26px;\n  padding: 0 14px;\n  font-size: 13px;\n  line-height: 26px;\n  border-radius: 6px;\n}\n\n/* 详情卡：相对徽章绝对定位（右对齐），卡片 token */\n.sp-pop {\n  position: absolute;\n  top: calc(100% + 8px);\n  right: 0;\n  z-index: 20;\n  width: 300px;\n  box-sizing: border-box;\n  padding: 12px 14px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 12px;\n  background: var(--dsw-specific-tip);\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n\n.sp-popRow {\n  display: flex;\n  align-items: baseline;\n  gap: 10px;\n  min-width: 0;\n}\n\n.sp-popLabel {\n  flex: none;\n  width: 34px;\n  font-size: 12px;\n  color: var(--dsw-alias-label-caption);\n}\n\n.sp-popValue {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n.sp-popActions {\n  display: flex;\n  justify-content: flex-end;\n  padding-top: 4px;\n  border-top: 1px solid var(--dsw-alias-border-l1);\n  margin-top: 2px;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .sp-toggle,\n  .sp-badge {\n    transition: none;\n  }\n}\n";
+		const css = "/* SafeModePanel — 会话头部 Serenity 状态徽章（点击展开详情卡）。\n * 遵循 web-styling.md：颜色只用 --dsw-alias-* 语义 token（明暗自适应）；\n * 尺寸与官方 header 标签一致；前缀 sp- 防冲突。 */\n\n.sp-root {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 24px;\n  padding: 0 4px 0 4px;\n  border-radius: 6px;\n  background: var(--dsw-alias-bg-module-platform);\n  font-size: 12px;\n  line-height: 24px;\n  white-space: nowrap;\n}\n\n.sp-badge {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 22px;\n  padding: 0 6px;\n  border: none;\n  border-radius: 5px;\n  background: transparent;\n  color: inherit;\n  font-size: 12px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-badge:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-badge:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-dot {\n  flex: none;\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n}\n\n.sp-dotOn {\n  background: var(--dsw-alias-state-success-primary);\n}\n\n.sp-dotOff {\n  background: var(--dsw-alias-label-dimmed);\n}\n\n.sp-brand {\n  color: var(--dsw-alias-label-primary);\n  font-weight: 500;\n}\n\n.sp-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  height: 18px;\n  padding: 0 8px;\n  border: none;\n  border-radius: 5px;\n  font-size: 12px;\n  font-weight: 600;\n  line-height: 18px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-toggle:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-toggle:disabled {\n  opacity: 0.55;\n  cursor: default;\n}\n\n.sp-toggleOn {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.sp-toggleOn:hover:not(:disabled) {\n  background: var(--dsw-alias-state-error-secondary);\n}\n\n.sp-toggleOff {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-toggleOff:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover-solid);\n}\n\n.sp-toggleIcon {\n  flex: none;\n}\n\n.sp-toggleLg {\n  height: 26px;\n  padding: 0 14px;\n  font-size: 13px;\n  line-height: 26px;\n  border-radius: 6px;\n}\n\n/* 详情卡：相对徽章绝对定位（右对齐），卡片 token */\n.sp-pop {\n  position: absolute;\n  top: calc(100% + 8px);\n  right: 0;\n  z-index: 20;\n  width: 300px;\n  box-sizing: border-box;\n  padding: 12px 14px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 12px;\n  background: var(--dsw-specific-tip);\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n\n.sp-popRow {\n  display: flex;\n  align-items: baseline;\n  gap: 10px;\n  min-width: 0;\n}\n\n.sp-popLabel {\n  flex: none;\n  width: 34px;\n  font-size: 12px;\n  color: var(--dsw-alias-label-caption);\n}\n\n.sp-popValue {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n.sp-popActions {\n  display: flex;\n  justify-content: flex-end;\n  padding-top: 4px;\n  border-top: 1px solid var(--dsw-alias-border-l1);\n  margin-top: 2px;\n}\n\n/* loop 运行状态区块（WebUI 等待界面；并行任务各自一行） */\n.sp-popSection {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding-top: 6px;\n  border-top: 1px solid var(--dsw-alias-border-l1);\n  margin-top: 2px;\n}\n\n.sp-loopItem {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  padding: 2px 0 2px 44px;\n  min-width: 0;\n}\n\n.sp-loopHead {\n  display: flex;\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n}\n\n.sp-loopLabel {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  font-size: 12px;\n  font-weight: 600;\n  color: var(--dsw-alias-label-primary);\n}\n\n.sp-loopRound {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-state-info-primary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n.sp-loopTime {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-label-caption);\n}\n\n.sp-loopResp {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  font-size: 11px;\n  color: var(--dsw-alias-label-secondary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .sp-toggle,\n  .sp-badge {\n    transition: none;\n  }\n}\n";
 		if (typeof document !== "undefined" && document.querySelector("style[data-sp-css]") === null) {
 			const tag = document.createElement("style");
 			tag.setAttribute("data-sp-css", "1");
@@ -18,6 +18,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/SafeModePanel.tsx
 		const API = "/serenity/status";
+		const LOOPS_API = "/serenity/loops";
 		/** 拼接类名（等价 clsx 最小子集，避免额外依赖） */
 		function cx(...parts) {
 			return parts.filter(Boolean).join(" ");
@@ -27,6 +28,7 @@ window.__ModuleLoader__.load({
 			const [status, setStatus] = (0, react.useState)(null);
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [open, setOpen] = (0, react.useState)(false);
+			const [loops, setLoops] = (0, react.useState)([]);
 			const rootRef = (0, react.useRef)(null);
 			const sessionId = props.sessionId;
 			const refresh = (0, react.useCallback)(async () => {
@@ -41,6 +43,25 @@ window.__ModuleLoader__.load({
 			(0, react.useEffect)(() => {
 				refresh();
 			}, [refresh]);
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				let alive = true;
+				const qs = sessionId ? `?sessionId=${encodeURIComponent(sessionId)}` : "";
+				const tick = async () => {
+					try {
+						const data = await (await fetch(`${LOOPS_API}${qs}`, { headers: { accept: "application/json" } })).json();
+						if (alive) setLoops(data.loops ?? []);
+					} catch {
+						if (alive) setLoops([]);
+					}
+				};
+				tick();
+				const timer = setInterval(() => void tick(), 3e3);
+				return () => {
+					alive = false;
+					clearInterval(timer);
+				};
+			}, [open, sessionId]);
 			(0, react.useEffect)(() => {
 				if (!open) return;
 				const onDown = (e) => {
@@ -166,6 +187,43 @@ window.__ModuleLoader__.load({
 										status.safeModeOn ? "ON" : "OFF"
 									]
 								})
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: cx("sp-popSection"),
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: cx("sp-popRow"),
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: cx("sp-popLabel"),
+										children: "loops"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: cx("sp-popValue"),
+										children: loops.filter((l) => !l.done).length > 0 ? `运行中 ${loops.filter((l) => !l.done).length}${loops.length > 0 ? ` / 共 ${loops.length}` : ""}` : "无运行中 loop"
+									})]
+								}), loops.slice(0, 5).map((l) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: cx("sp-loopItem"),
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: cx("sp-loopHead"),
+										children: [
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: cx("sp-loopLabel"),
+												title: l.label,
+												children: l.label
+											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: cx("sp-loopRound"),
+												children: l.done ? "✓" : `R${l.round}`
+											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: cx("sp-loopTime"),
+												children: new Date(l.updated).toLocaleTimeString()
+											})
+										]
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: cx("sp-loopResp"),
+										title: l.lastResponse,
+										children: l.lastResponse.slice(0, 80) || (l.done ? "已完成" : "（等待首轮响应）")
+									})]
+								}, l.label))]
 							})
 						] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: cx("sp-popRow"),

package/lib/index.js

@@ -12,7 +12,7 @@ import { randomBytes, randomUUID } from "node:crypto";
 /**
 * ccc.ts — CCC 纯逻辑层（零 DSH 依赖，可独立单测）
 *
-* 职责：CCC 根检测（P1）、git 检测（P2）、.dsh/serenity.json 配置读取、
+* 职责：CCC 根检测（P1）、git 检测（P2）、serenity.json 配置读取（.opencode 规范位置，.dsh 回退）、
 * 路径守卫（P3 语义）、安全模式黑名单匹配。
 *
 * 由 tools/ 与 seams/ 复用；逻辑移植自 dsh-serenity-plugin v0.1-v0.2
@@ -66,7 +66,11 @@ function resolveInside(root, p) {
 	if (classifyPath(abs, root) === "outside") throw new Error(`Path escape blocked: "${p}" resolves outside "${root}"`);
 	return abs;
 }
-const DEFAULT_SERENITY_CONFIG_PATHS = [".dsh/serenity.json", ".opencode/serenity.json"];
+/**
+* ACC 依赖的 CCC 配置路径（S134 修正：兼容历史——历史在 .opencode，规范位置 = .opencode；
+* .dsh 仅作 dsh 运行时回退，不优先）。
+*/
+const DEFAULT_SERENITY_CONFIG_PATHS = [".opencode/serenity.json", ".dsh/serenity.json"];
 function loadSerenityConfig(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
 	for (const candidate of paths) {
 		const p = resolve(root, candidate);
@@ -1389,7 +1393,7 @@ const kitTool = defineTool({
 * （JSON 格式——方便 MSM 直接 read + JSON.parse 读取，零解析依赖）。
 *
 * git 提交策略（可靠机制 × 用户自由）：
-*   - 配置：.dsh/serenity.json `localstore.gitTrack`: "allow"（可提交）| "deny"（禁提交）
+*   - 配置：.opencode/serenity.json `localstore.gitTrack`: "allow"（可提交）| "deny"（禁提交）
 *   - **缺省 deny（没配就是不提交）**；且 deny 的保证**不依赖 dsh 运行**——
 *     写入时自动确保 .gitignore 含 localstore.json（物理保证：即使 dsh 不在、
 *     用户手动 git commit 也不会误提交），cc_git 检查为第二道防线（拒绝 + 提示）
@@ -1558,7 +1562,7 @@ function docText(root) {
 		`存储于 CCC 根根目录 ${path}（JSON 格式，MSM 可直接 read + JSON.parse）。`,
 		"",
 		"## git 提交策略",
-		"- 配置：.dsh/serenity.json `localstore.gitTrack`：`\"allow\"`（可提交）| `\"deny\"`（禁提交）",
+		"- 配置：.opencode/serenity.json `localstore.gitTrack`：`\"allow\"`（可提交）| `\"deny\"`（禁提交；.dsh 回退）",
 		"- **缺省 deny（没配就是不提交）**；deny 时写入会自动确保 .gitignore 含 localstore.json",
 		"  （物理保证，不依赖 dsh 运行）；cc_git commit 会检查拒绝",
 		"- 想提交：配置 `\"localstore\": { \"gitTrack\": \"allow\" }`，并从 .gitignore 移除 localstore.json",
@@ -2162,7 +2166,7 @@ function splitModel(model) {
 		model: model.slice(idx + 1)
 	};
 }
-/** 轮次 prompt（对齐老 loop 结构：回顾进度 → 自由工作 → 汇报） */
+/** 轮次 prompt（对齐老 loop 结构：回顾进度 → 自由工作 → 汇报；S134 EAP 化：固定详尽） */
 function buildRoundPrompt(opts) {
 	const { root, session, label, round, stopToken, progress, task } = opts;
 	const resumeNote = progress && progress.round > 0 ? `上一轮（round ${progress.round}）已完成：${progress.lastResponse.slice(0, 300)}\n永远从上次停止处继续，绝不重做已完成工作。` : "这是第一轮。";
@@ -2173,14 +2177,82 @@ ${session ? `工作会话：${session}（AGENT_SESSIONS/${session}/SESSION.md
 ${task ? `任务：${task}` : `任务：以 label「${label}」对应的工作为准（若存在工作会话，先读 SESSION.md 明确目标）`}
 ${resumeNote}
 
-本轮内你可以自由工作：读文件、改代码、执行命令，尽一切手段推进任务。
-每轮结束时汇报：
+## 工作规范（每轮固定，必须遵守）
+1. 本轮内自由工作：读文件、改代码、执行命令，尽一切手段推进任务。
+2. 若本任务属于**阅读整理或文字编写类工作**（读文件提炼、总结、撰写文档、生成文本等），
+   请先加载 eap（acc-eap skill）并按 EAP 标准组织输出：
+   - E↑ 显式：实体/变量明确定义，关系指明方向与基数，边界划定，不用歧义词
+   - R↓ 可重建：关键结论记录来源与推理，可被后续 agent 重建
+   - S↑ 稳定：输出结构可重复生成，不依赖隐含上下文
+3. 汇报必须具体可核验，不写空话。
+
+## 每轮汇报（固定格式，逐条回答）
 1. 本轮做了什么（具体）
 2. 下一步计划
-3. 是否已完成（若完成，输出 ${stopToken}）
+3. 是否已完成（若完成，只输出 ${stopToken}）
 
 若已完成任务，只输出 ${stopToken}。`;
 }
+/**
+* loop 规模化使用指引（guide 子命令输出；S134）：
+* 使用 loop 前必须先加载 eap 设计方案；并行策略；提示词规范（详尽固定 EAP）；
+* 阅读/文字编写类 loop 内部也加载 eap。
+*/
+const LOOP_GUIDE = `# loop — 规模化使用指引（guide）
+
+## ⚠️ 使用前：必须先加载 eap 设计方案
+调用 loop 前，请先加载 eap（acc-eap skill），基于 EAP 框架设计「规模化 loop 方案」。
+
+### 1. 任务拆解（E↑ 显式）
+- 大任务拆成明确子任务：每个子任务定义 目标 / 输入 / 边界（做什么、不做什么）/ 验收标准
+- 依赖显式化：有依赖的串行，无依赖的可并行
+
+### 2. 提示词设计（loop 的 task 参数）
+- task 必须详尽、固定、符合 EAP：目标明确、边界划定、验收标准可判定
+- 反例「处理这个文件」——歧义；正例「读取 <路径>，提取「关键决策」表格全部行，
+  输出 JSON 数组（字段 id/结论/证据），不改动原文件」
+- 阅读整理 / 文字编写类工作（读文件提炼、总结、撰写文档、生成文本等）：
+  loop 内部 agent 也会被要求加载 eap，按 EAP 标准组织输出
+
+### 3. 并行策略（规模化）
+- 无依赖的子任务可并行：每个子任务一个独立 loop（独立 label + task）
+- 并行执行方式：
+  a. 后台 subagent：每个 subagent 内调 loop（各自 label），subagent 并行运行
+  b. workflow：parallel 阶段驱动多个 loop 子 agent
+- 并发安全已保证：sessionId 唯一（loop-<label>-<uuid>）、进度文件按 label 隔离
+  （AGENT_SESSIONS/loop-<label>.json）——同 label 续跑、不同 label 互不干扰
+- 汇总：并行 loop 各自产出进度后，主 agent 汇总合并（或再派一个汇总 loop）
+
+## 完成判定
+- 唯一完成条件 = loop 内部 agent 精确回显本轮随机验证码（stop token）；对话轮次无上限（不完成不返回）
+- agent 非正常停止时自动重启（≤100 次防死循环）
+
+## 等待界面
+- WebUI 会话头部 Serenity 详情卡显示运行中 loop 的进度（label / 轮次 / 最近响应），并行任务各自一行，约 3s 刷新
+`;
+/** 列出 AGENT_SESSIONS/loop-*.json 的全部进度（按 updated 倒序；坏文件跳过） */
+function listActiveLoops(root) {
+	const dir = join(root, "AGENT_SESSIONS");
+	if (!existsSync(dir)) return [];
+	const out = [];
+	for (const entry of readdirSync(dir)) {
+		if (!entry.startsWith("loop-") || !entry.endsWith(".json")) continue;
+		try {
+			const data = JSON.parse(readFileSync(join(dir, entry), "utf-8"));
+			if (typeof data.label !== "string" || typeof data.round !== "number") continue;
+			out.push({
+				label: data.label,
+				round: data.round,
+				done: data.done === true,
+				model: typeof data.model === "string" ? data.model : "",
+				updated: typeof data.updated === "string" ? data.updated : "",
+				lastResponse: typeof data.lastResponse === "string" ? data.lastResponse : ""
+			});
+		} catch {}
+	}
+	out.sort((a, b) => a.updated < b.updated ? 1 : -1);
+	return out;
+}
 //#endregion
 //#region src/tools/loop.ts
 /**
@@ -2245,7 +2317,7 @@ function lastAssistantText(agent) {
 function createLoopTool(ctx) {
 	return defineTool({
 		name: "loop",
-		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .dsh/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。轮次不需要调用者指定——对话轮次**无上限**（不完成不返回），agent 非正常停止时自动重启（重启 ≤100 次，防死循环保险阀）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan",
+		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop guide（输出规模化使用指引——使用前先加载 eap 设计规模化方案）；loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .opencode/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。轮次不需要调用者指定——对话轮次**无上限**（不完成不返回），agent 非正常停止时自动重启（重启 ≤100 次，防死循环保险阀）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan；loop guide",
 		parameters: {
 			task: {
 				type: "string",
@@ -2263,6 +2335,10 @@ function createLoopTool(ctx) {
 			model: {
 				type: "string",
 				description: "provider/model（如 minimax-cn-coding-plan/MiniMax-M3）；缺省读 loop.defaultModel"
+			},
+			guide: {
+				type: "boolean",
+				description: "输出规模化使用指引（不创建 agent；使用 loop 前先看——含 eap 设计方案要求/并行策略/提示词规范）"
 			}
 		},
 		output: {
@@ -2270,11 +2346,12 @@ function createLoopTool(ctx) {
 			render: (_args, value) => renderText$1(value)
 		},
 		async execute(args, exec) {
+			if (args.guide) return { guide: LOOP_GUIDE };
 			const root = findSerenityRoot(agentCwd$2(exec));
 			if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 			const cfg = loadSerenityConfig(root, DEFAULT_SERENITY_CONFIG_PATHS);
 			const model = args.model ?? cfg.loop?.defaultModel;
-			if (!model) throw new Error("loop 需要 model：传参或配置 .dsh/serenity.json loop.defaultModel");
+			if (!model) throw new Error("loop 需要 model：传参或配置 .opencode/serenity.json loop.defaultModel");
 			const label = args.label;
 			if (!ctx.agentLoop) throw new Error("loop: ctx.agentLoop 不可用");
 			const { provider, model: modelName } = splitModel(model);
@@ -2413,7 +2490,7 @@ function renderText(value) {
 }
 const localstoreTool = defineTool({
 	name: "localstore",
-	description: "ACC 标准本地凭据/配置存储：一个工具管理两个命名空间 credential（凭据）与 config（本地偏好）。存储于 CCC 根根目录 localstore.json（JSON 格式，MSM 可直接读取）。git 策略：.dsh/serenity.json localstore.gitTrack（allow 可提交 / deny 禁提交，缺省 deny）——deny 时写入自动确保 .gitignore 含该文件（物理保证），cc_git commit 会检查拒绝。子命令：list（列 key，凭据不返回值）/ get <name>（读值）/ set <name> <value>（写）/ unset <name>（删）/ show <name>（元数据，凭据不打印值）/ doc（输出存储规范——路径/格式/key 规范/git 策略，agent 可按说明直接用 read/write 操作文件）。默认 scope=credential；config 需传 --scope config（路径为 section.key，如 loop.defaultModel）。",
+	description: "ACC 标准本地凭据/配置存储：一个工具管理两个命名空间 credential（凭据）与 config（本地偏好）。存储于 CCC 根根目录 localstore.json（JSON 格式，MSM 可直接读取）。git 策略：.opencode/serenity.json localstore.gitTrack（allow 可提交 / deny 禁提交，缺省 deny；.dsh 回退）——deny 时写入自动确保 .gitignore 含该文件（物理保证），cc_git commit 会检查拒绝。子命令：list（列 key，凭据不返回值）/ get <name>（读值）/ set <name> <value>（写）/ unset <name>（删）/ show <name>（元数据，凭据不打印值）/ doc（输出存储规范——路径/格式/key 规范/git 策略，agent 可按说明直接用 read/write 操作文件）。默认 scope=credential；config 需传 --scope config（路径为 section.key，如 loop.defaultModel）。",
 	parameters: {
 		action: {
 			type: "string",
@@ -2656,7 +2733,9 @@ function accBlock(root) {
 		"  neat     — return the full Neat design collaboration protocol",
 		"  cce      — return the full Cognitive Continuity Engineering framework",
 		"  loop     — 牛马循环：指定模型专用 agent 反复执行",
-		"  localstore — ACC 本地凭据/配置存储（credential 0600 + config 0644，~/.serenity/）；doc 子命令输出规范",
+		"  localstore — ACC 本地凭据/配置存储（CCC 根 localstore.json，JSON 格式；git 策略 localstore.gitTrack 缺省 deny）；doc 子命令输出规范",
+		"",
+		"  ℹ️ CCC 内文件操作（read/write/edit/glob/grep 等）请使用相对 CCC 根的相对路径（如 AGENT_SESSIONS/2026-08-14--S134--x/SESSION.md）；Root / SESSION.md path 等绝对路径仅作标识，不作工具入参",
 		"",
 		"The DSH platform tools remain available too (read/write/edit/glob/grep/web_search/ask_user_question/subagent/workflow/goal and more) — the ACC tools above are the serenity-native layer, not the only tools.",
 		"",
@@ -3037,6 +3116,7 @@ function registerCompactRetention(ctx, opts = {}) {
 //#endregion
 //#region src/api.ts
 const ROUTE_PATH = "/serenity/status";
+const LOOPS_PATH = "/serenity/loops";
 function readBody(req) {
 	return new Promise((resolve, reject) => {
 		let data = "";
@@ -3070,6 +3150,30 @@ function resolveWorkspace(ctx, params) {
 }
 function registerStatusApi(ctx, opts = {}) {
 	const configPaths = opts.configPaths ?? DEFAULT_SERENITY_CONFIG_PATHS;
+	ctx.webServer.register({
+		kind: "exact",
+		path: LOOPS_PATH,
+		handler: async (req, res) => {
+			try {
+				if (req.method !== "GET") {
+					sendJson(res, 405, { error: "method not allowed" });
+					return;
+				}
+				const url = new URL(req.url ?? "/", "http://127.0.0.1");
+				const root = findSerenityRoot(resolveWorkspace(ctx, {
+					sessionId: url.searchParams.get("sessionId") ?? void 0,
+					workspace: url.searchParams.get("workspace") ?? void 0
+				}));
+				if (!root) {
+					sendJson(res, 200, { loops: [] });
+					return;
+				}
+				sendJson(res, 200, { loops: listActiveLoops(root) });
+			} catch (err) {
+				sendJson(res, 400, { error: err.message ?? String(err) });
+			}
+		}
+	});
 	ctx.webServer.register({
 		kind: "exact",
 		path: ROUTE_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.16.7",
+  "version": "1.16.9",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {