@shgroup/dsh-serenity-hooks 1.23.8 → 1.24.0

package/README.md

@@ -14,7 +14,7 @@ dsh plugin --profile web add @shgroup/dsh-serenity-hooks
 
 ## 工具
 
-`cc_fs` / `session` / `acc_kit` / `cc_git` / `acc_msm` / `eap` / `neat` / `cce` / `loop`
+`cc_fs` / `session` / `acc_kit` / `cc_git` / `acc_msm` / `eap` / `neat` / `cce` / `handyman`
 
 ## 系统提示词
 
@@ -26,7 +26,7 @@ dsh plugin --profile web add @shgroup/dsh-serenity-hooks
 
 ```jsonc
 {
-  "loop": { "defaultModel": "provider/model" },
+  "handyman": { "models": ["provider/model"], "defaultModel": "provider/model" },
   "sessionKeeper": { "threshold": 100 },
   "safeMode": { "blacklist": [".secrets/", "regex:\\.env$"] }
 }

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.23.8",
+  "version": "1.24.0",
   "main": "lib/index.js",
-  "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop/session_rebuild + 拦截缝机械约束（safe-mode/路径守卫）+ 高级设定面板（双端口网关/账号管理）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。",
+  "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/handyman/session_rebuild + 拦截缝机械约束（safe-mode/路径守卫）+ 高级设定面板（双端口网关/账号管理）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。",
   "engines": {
     "dsh": ">=0.1.0-rc.5"
   },
@@ -16,7 +16,7 @@
       "eap",
       "neat",
       "cce",
-      "loop",
+      "handyman",
       "session_rebuild",
       "localstore"
     ],

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$3 = "/* SafeModePanel — 会话头部 Serenity 状态卡片（v1.22 UX 重构）\n * 卡片 → 点击 → 官方 Modal（body portal 遮罩 + 居中）\n * 模态内：tab 栏 + 分组（groupTitle 标题 + rowCard 行卡）——看齐官方 settings 设计语言\n * 遵循 web-styling.md：颜色只用 --dsw-alias-* 语义 token（明暗自适应）；\n * 前缀 sp- 防冲突。 */\n\n/* ── 头部状态卡片（可点击） ── */\n\n.sp-card {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 26px;\n  padding: 0 10px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-module-platform);\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    border-color var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-card:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  border-color: var(--dsw-alias-border-l2);\n}\n\n.sp-card:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-card:disabled {\n  opacity: 0.6;\n  cursor: default;\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/* safe-mode tag（实心方形标签，无 icon——从外面一眼可见；ON 红底 SAFE / OFF 灰底 OFF） */\n.sp-tag {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  height: 16px;\n  padding: 0 7px;\n  border-radius: 4px;\n  font-size: 10px;\n  font-weight: 700;\n  line-height: 1;\n  letter-spacing: 0.04em;\n  text-transform: uppercase;\n}\n\n.sp-tagOn {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n  border: 1px solid var(--dsw-alias-state-error-primary);\n}\n\n.sp-tagOff {\n  background: var(--dsw-alias-interactive-bg-active, rgba(128, 128, 128, 0.16));\n  color: var(--dsw-alias-label-secondary);\n  border: 1px solid var(--dsw-alias-border-l1);\n}\n\n.sp-brand {\n  color: var(--dsw-alias-label-primary);\n  font-weight: 500;\n}\n\n.sp-chev {\n  color: var(--dsw-alias-label-dimmed);\n}\n\n/* ── 官方 Modal 定制（宽度 + 内容紧凑） ── */\n\n.sp-modal {\n  width: 520px;\n  max-width: calc(100vw - 48px);\n}\n\n/* ── tab 栏 ── */\n\n.sp-tabs {\n  display: flex;\n  gap: 6px;\n  padding: 0 2px 12px;\n  border-bottom: 1px solid var(--dsw-alias-border-l1);\n}\n\n.sp-tab {\n  flex: 1;\n  padding: 8px 0;\n  border: none;\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 13px;\n  font-weight: 500;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-tab:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-tabOn {\n  background: var(--dsw-alias-interactive-bg-active, rgba(128, 128, 128, 0.2));\n  color: var(--dsw-alias-label-primary);\n  font-weight: 600;\n}\n\n/* ── 模态内容 ── */\n\n.sp-modalBody {\n  display: flex;\n  flex-direction: column;\n  gap: 16px;\n  padding-top: 14px;\n  /* 内容超出视口时 body 区滚动（兜底——不再截断）；整卡不滚动 */\n  overflow-y: auto;\n  max-height: calc(100vh - 200px);\n}\n\n/* ── 分组（官方 settings 语言：groupTitle + rows） ── */\n\n.sp-group {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n\n.sp-groupHead {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n}\n\n.sp-groupTitle {\n  margin: 0;\n  font-size: 12px;\n  line-height: 18px;\n  font-weight: 600;\n  letter-spacing: 0.02em;\n  text-transform: uppercase;\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-rows {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n\n/* 行卡（rowCard：border + radius + padding；值与 label 分离、长内容可换行） */\n.sp-row {\n  display: flex;\n  align-items: baseline;\n  gap: 12px;\n  min-width: 0;\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 10px;\n  background: var(--dsw-alias-bg-module);\n}\n\n.sp-label {\n  flex: none;\n  width: 76px;\n  font-size: 12px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-secondary);\n  white-space: nowrap;\n}\n\n.sp-value {\n  flex: 1;\n  min-width: 0;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  font-family: var(--ds-font-family-code, monospace);\n  word-break: break-all;\n  overflow-wrap: anywhere;\n}\n\n/* 安全模式动作区 */\n.sp-actions {\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 10px;\n  background: var(--dsw-alias-bg-module);\n}\n\n.sp-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 24px;\n  padding: 0 10px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 6px;\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-toggleLg {\n  height: 30px;\n  padding: 0 16px;\n  font-size: 13px;\n}\n\n.sp-toggleOn {\n  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 14%, transparent);\n  color: var(--dsw-alias-state-error-primary);\n  border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent);\n}\n\n.sp-toggleOff {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-toggleIcon {\n  flex: none;\n}\n\n.sp-toggleDesc {\n  flex: 1;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* loop 运行状态区块 */\n\n.sp-loopsToggle {\n  flex: none;\n  padding: 2px 10px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 6px;\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 11px;\n  cursor: pointer;\n}\n\n.sp-loopsToggle:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-loopsList {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  margin-top: 2px;\n}\n\n.sp-loopItem {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 8px;\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: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.sp-loopRound {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-label-dimmed);\n}\n\n.sp-loopTime {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-label-dimmed);\n}\n\n.sp-loopResp {\n  font-size: 11px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.sp-loopsMore {\n  font-size: 11px;\n  color: var(--dsw-alias-label-dimmed);\n  padding: 4px 12px;\n}\n\n/* 底部提示（配置入口引导） */\n.sp-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-word;\n  overflow-wrap: anywhere;\n  padding: 8px 12px;\n  border: 1px dashed var(--dsw-alias-border-l2);\n  border-radius: 10px;\n}\n";
+		const css$3 = "/* SafeModePanel — 会话头部 Serenity 状态卡片（v1.22 UX 重构）\n * 卡片 → 点击 → 官方 Modal（body portal 遮罩 + 居中）\n * 模态内：tab 栏 + 分组（groupTitle 标题 + rowCard 行卡）——看齐官方 settings 设计语言\n * 遵循 web-styling.md：颜色只用 --dsw-alias-* 语义 token（明暗自适应）；\n * 前缀 sp- 防冲突。 */\n\n/* ── 头部状态卡片（可点击） ── */\n\n.sp-card {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 26px;\n  padding: 0 10px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-module-platform);\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    border-color var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-card:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  border-color: var(--dsw-alias-border-l2);\n}\n\n.sp-card:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-card:disabled {\n  opacity: 0.6;\n  cursor: default;\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/* safe-mode tag（实心方形标签，无 icon——从外面一眼可见；ON 红底 SAFE / OFF 灰底 OFF） */\n.sp-tag {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  height: 16px;\n  padding: 0 7px;\n  border-radius: 4px;\n  font-size: 10px;\n  font-weight: 700;\n  line-height: 1;\n  letter-spacing: 0.04em;\n  text-transform: uppercase;\n}\n\n.sp-tagOn {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n  border: 1px solid var(--dsw-alias-state-error-primary);\n}\n\n.sp-tagOff {\n  background: var(--dsw-alias-interactive-bg-active, rgba(128, 128, 128, 0.16));\n  color: var(--dsw-alias-label-secondary);\n  border: 1px solid var(--dsw-alias-border-l1);\n}\n\n.sp-brand {\n  color: var(--dsw-alias-label-primary);\n  font-weight: 500;\n}\n\n.sp-chev {\n  color: var(--dsw-alias-label-dimmed);\n}\n\n/* ── 官方 Modal 定制（宽度 + 内容紧凑） ── */\n\n.sp-modal {\n  width: 520px;\n  max-width: calc(100vw - 48px);\n}\n\n/* ── tab 栏 ── */\n\n.sp-tabs {\n  display: flex;\n  gap: 6px;\n  padding: 0 2px 12px;\n  border-bottom: 1px solid var(--dsw-alias-border-l1);\n}\n\n.sp-tab {\n  flex: 1;\n  padding: 8px 0;\n  border: none;\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 13px;\n  font-weight: 500;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-tab:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-tabOn {\n  background: var(--dsw-alias-interactive-bg-active, rgba(128, 128, 128, 0.2));\n  color: var(--dsw-alias-label-primary);\n  font-weight: 600;\n}\n\n/* ── 模态内容 ── */\n\n.sp-modalBody {\n  display: flex;\n  flex-direction: column;\n  gap: 16px;\n  padding-top: 14px;\n  /* 内容超出视口时 body 区滚动（兜底——不再截断）；整卡不滚动 */\n  overflow-y: auto;\n  max-height: calc(100vh - 200px);\n}\n\n/* ── 分组（官方 settings 语言：groupTitle + rows） ── */\n\n.sp-group {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n\n.sp-groupHead {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n}\n\n.sp-groupTitle {\n  margin: 0;\n  font-size: 12px;\n  line-height: 18px;\n  font-weight: 600;\n  letter-spacing: 0.02em;\n  text-transform: uppercase;\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-rows {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n\n/* 行卡（rowCard：border + radius + padding；值与 label 分离、长内容可换行） */\n.sp-row {\n  display: flex;\n  align-items: baseline;\n  gap: 12px;\n  min-width: 0;\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 10px;\n  background: var(--dsw-alias-bg-module);\n}\n\n.sp-label {\n  flex: none;\n  width: 76px;\n  font-size: 12px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-secondary);\n  white-space: nowrap;\n}\n\n.sp-value {\n  flex: 1;\n  min-width: 0;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  font-family: var(--ds-font-family-code, monospace);\n  word-break: break-all;\n  overflow-wrap: anywhere;\n}\n\n/* 安全模式动作区 */\n.sp-actions {\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 10px;\n  background: var(--dsw-alias-bg-module);\n}\n\n.sp-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 24px;\n  padding: 0 10px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 6px;\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-toggleLg {\n  height: 30px;\n  padding: 0 16px;\n  font-size: 13px;\n}\n\n.sp-toggleOn {\n  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 14%, transparent);\n  color: var(--dsw-alias-state-error-primary);\n  border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent);\n}\n\n.sp-toggleOff {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-toggleIcon {\n  flex: none;\n}\n\n.sp-toggleDesc {\n  flex: 1;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* handyman 运行状态区块 */\n\n.sp-handymenToggle {\n  flex: none;\n  padding: 2px 10px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 6px;\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 11px;\n  cursor: pointer;\n}\n\n.sp-handymenToggle:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-handymenList {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  margin-top: 2px;\n}\n\n.sp-handymanItem {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 8px;\n  min-width: 0;\n}\n\n.sp-handymanHead {\n  display: flex;\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n}\n\n.sp-handymanLabel {\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: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.sp-handymanRound {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-label-dimmed);\n}\n\n.sp-handymanTime {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-label-dimmed);\n}\n\n.sp-handymanResp {\n  font-size: 11px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.sp-handymenMore {\n  font-size: 11px;\n  color: var(--dsw-alias-label-dimmed);\n  padding: 4px 12px;\n}\n\n/* 底部提示（配置入口引导） */\n.sp-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-word;\n  overflow-wrap: anywhere;\n  padding: 8px 12px;\n  border: 1px dashed var(--dsw-alias-border-l2);\n  border-radius: 10px;\n}\n";
 		if (typeof document !== "undefined" && document.querySelector("style[data-sp-css=\"SafeModePanel\"]") === null) {
 			const tag = document.createElement("style");
 			tag.setAttribute("data-sp-css", "SafeModePanel");
@@ -18,7 +18,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/SafeModePanel.tsx
 		const API = "/serenity/status";
-		const LOOPS_API = "/serenity/loops";
+		const HANDYMEN_API = "/serenity/handymen";
 		/** 拼接类名（等价 clsx 最小子集，避免额外依赖） */
 		function cx(...parts) {
 			return parts.filter(Boolean).join(" ");
@@ -28,8 +28,8 @@ 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 [loopsOpen, setLoopsOpen] = (0, react.useState)(false);
+			const [handymen, setHandymen] = (0, react.useState)([]);
+			const [handymenOpen, setHandymenOpen] = (0, react.useState)(false);
 			const sessionId = props.sessionId;
 			const refresh = (0, react.useCallback)(async () => {
 				const qs = sessionId ? `?sessionId=${encodeURIComponent(sessionId)}` : "";
@@ -49,10 +49,10 @@ window.__ModuleLoader__.load({
 				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 ?? []);
+						const data = await (await fetch(`${HANDYMEN_API}${qs}`, { headers: { accept: "application/json" } })).json();
+						if (alive) setHandymen(data.handymen ?? []);
 					} catch {
-						if (alive) setLoops([]);
+						if (alive) setHandymen([]);
 					}
 				};
 				tick();
@@ -91,7 +91,7 @@ window.__ModuleLoader__.load({
 				})]
 			});
 			const inCcc = status.root !== null;
-			const runningLoops = loops.filter((l) => !l.done);
+			const runningHandymen = handymen.filter((l) => !l.done);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 				type: "button",
 				className: cx("sp-card"),
@@ -147,11 +147,11 @@ window.__ModuleLoader__.load({
 										className: cx("sp-row"),
 										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 											className: cx("sp-label"),
-											children: "Loop 模型"
+											children: "Handyman 模型"
 										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 											className: cx("sp-value"),
-											title: status.loopModel ? `loop.defaultModel: ${status.loopModel}` : void 0,
-											children: status.loopModel ?? "未配置"
+											title: status.handymanModel ? `handyman.models: ${status.handymanModel}` : void 0,
+											children: status.handymanModel ?? "未配置"
 										})]
 									}),
 									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -205,12 +205,12 @@ window.__ModuleLoader__.load({
 									className: cx("sp-groupHead"),
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 										className: cx("sp-groupTitle"),
-										children: "Loop 运行"
-									}), loops.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										children: "Handyman 运行"
+									}), handymen.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
-										className: cx("sp-loopsToggle"),
-										onClick: () => setLoopsOpen((v) => !v),
-										children: loopsOpen ? "收起" : "详情"
+										className: cx("sp-handymenToggle"),
+										onClick: () => setHandymenOpen((v) => !v),
+										children: handymenOpen ? "收起" : "详情"
 									})]
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -222,42 +222,42 @@ window.__ModuleLoader__.load({
 											children: "状态"
 										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 											className: cx("sp-value"),
-											children: runningLoops.length > 0 ? `运行中 ${runningLoops.length}${loops.length > 0 ? ` / 共 ${loops.length}` : ""}` : "无运行中 loop"
+											children: runningHandymen.length > 0 ? `运行中 ${runningHandymen.length}${handymen.length > 0 ? ` / 共 ${handymen.length}` : ""}` : "无运行中 handyman"
 										})]
 									})
 								}),
-								loopsOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: cx("sp-loopsList"),
-									children: [loops.slice(0, 3).map((l) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: cx("sp-loopItem"),
+								handymenOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: cx("sp-handymenList"),
+									children: [handymen.slice(0, 3).map((l) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: cx("sp-handymanItem"),
 										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-											className: cx("sp-loopHead"),
+											className: cx("sp-handymanHead"),
 											children: [
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-													className: cx("sp-loopLabel"),
+													className: cx("sp-handymanLabel"),
 													title: l.label,
 													children: l.label
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-													className: cx("sp-loopRound"),
+													className: cx("sp-handymanRound"),
 													children: l.done ? "✓ 完成" : `R${l.round}`
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-													className: cx("sp-loopTime"),
+													className: cx("sp-handymanTime"),
 													children: new Date(l.updated).toLocaleTimeString()
 												})
 											]
 										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-											className: cx("sp-loopResp"),
+											className: cx("sp-handymanResp"),
 											title: l.lastResponse,
 											children: l.lastResponse.slice(0, 80) || (l.done ? "已完成" : "（等待首轮响应）")
 										})]
-									}, l.label)), loops.length > 3 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: cx("sp-loopsMore"),
+									}, l.label)), handymen.length > 3 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: cx("sp-handymenMore"),
 										children: [
 											"… 共 ",
-											loops.length,
-											" 个 loop（其余见等待界面）"
+											handymen.length,
+											" 个 handyman（其余见等待界面）"
 										]
 									})]
 								})

package/lib/index.js

@@ -69,6 +69,24 @@ function resolveInside(root, p) {
 	return abs;
 }
 /**
+* 解析 handyman 配置（v1.24.0：取代 loop.defaultModel；不兼容旧 loop 配置——用户拍板）。
+* @returns 白名单 + 缺省模型 + 上限；models 未配置返回 null（工具应报错要求配置）
+*/
+function readHandymanConfig(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	const cfg = loadSerenityConfig(root, paths);
+	const models = cfg.handyman?.models;
+	if (!Array.isArray(models) || models.length === 0) return null;
+	const clean = models.map((m) => m.trim()).filter(Boolean);
+	if (clean.length === 0) return null;
+	const defaultModel = cfg.handyman?.defaultModel?.trim();
+	return {
+		models: clean,
+		defaultModel: defaultModel !== void 0 && clean.includes(defaultModel) ? defaultModel : clean[0],
+		maxRounds: cfg.handyman?.maxRounds ?? 100,
+		maxParallel: cfg.handyman?.maxParallel ?? 10
+	};
+}
+/**
 * ACC 依赖的 CCC 配置路径（S134 修正：兼容历史——历史在 .opencode，规范位置 = .opencode；
 * .dsh 仅作 dsh 运行时回退，不优先）。
 */
@@ -782,7 +800,7 @@ function registerGuards(ctx, opts = {}) {
 /**
 * status.ts — 状态与安全模式操作（纯逻辑，零 DSH 依赖，可独立单测）
 *
-* WebUI 停靠栏的数据源：ACC 版本 / CCC 根 / safe-mode 状态 / 黑名单 / keeper 阈值 / loop 模型。
+* WebUI 停靠栏的数据源：ACC 版本 / CCC 根 / safe-mode 状态 / 黑名单 / keeper 阈值 / handyman 模型。
 * setSafeMode 直接读写 .serenity-safe-on 标记（守卫实时读取，写即生效）。
 */
 /**
@@ -815,7 +833,7 @@ function getStatus(cwd, configPaths = DEFAULT_SERENITY_CONFIG_PATHS) {
 		safeModeOn: false,
 		blacklist: [],
 		threshold: null,
-		loopModel: null,
+		handymanModel: null,
 		restrict
 	};
 	const cfg = loadSerenityConfig(root, configPaths);
@@ -825,7 +843,7 @@ function getStatus(cwd, configPaths = DEFAULT_SERENITY_CONFIG_PATHS) {
 		safeModeOn: isSafeModeOn(root),
 		blacklist: readBlacklist(root, configPaths),
 		threshold: cfg.sessionKeeper?.threshold ?? null,
-		loopModel: cfg.loop?.defaultModel ?? null,
+		handymanModel: readHandymanConfig(root, configPaths)?.defaultModel ?? null,
 		restrict
 	};
 }
@@ -979,7 +997,7 @@ const kitTool = defineTool({
 * 存储结构（JSON 顶层分节）：
 *   { "credentials": { "HOME_GITLAB_TOKEN": "xxx" }, "<config节>": { "<key>": "v" } }
 *   credentials 为保留节（credential 命名空间，key 大写蛇形）；其余节归 config 命名空间
-*   （path = section.key，如 loop.defaultModel）。
+*   （path = section.key，如 handyman.models）。
 */
 const LOCALSTORE_SCOPES = ["credential", "config"];
 /** 存储文件名（CCC 根根目录） */
@@ -1066,7 +1084,7 @@ function assertCredentialKey(key) {
 /** 校验 config 路径（节.key）；不合法抛错 */
 function assertConfigPath(path) {
 	const idx = path.indexOf(".");
-	if (idx <= 0 || idx === path.length - 1) throw new Error(`config path "${path}" must be section.key (e.g. loop.defaultModel)`);
+	if (idx <= 0 || idx === path.length - 1) throw new Error(`config path "${path}" must be section.key (e.g. handyman.models)`);
 	const section = path.slice(0, idx);
 	const key = path.slice(idx + 1);
 	if (!CONFIG_SECTION_RE.test(section)) throw new Error(`config section "${section}" must match ^[a-z][a-z0-9-]*$`);
@@ -1150,8 +1168,8 @@ function docText(root) {
 		"  \"credentials\": {",
 		"    \"HOME_GITLAB_TOKEN\": \"xxx\"",
 		"  },",
-		"  \"loop\": {",
-		"    \"defaultModel\": \"minimax-cn-coding-plan/MiniMax-M3\"",
+		"  \"handyman\": {",
+		"    \"models\": [\"minimax-cn-coding-plan/MiniMax-M3\"]",
 		"  }",
 		"}",
 		"```",
@@ -1159,7 +1177,7 @@ function docText(root) {
 		"",
 		"## Key conventions",
 		"- credential key: ^[A-Z][A-Z0-9_]*$ (e.g. HOME_GITLAB_TOKEN)",
-		"- config path: section.key (section ^[a-z][a-z0-9-]*$, key lowerCamel ^[a-z][a-zA-Z0-9_]*$, e.g. loop.defaultModel)",
+		"- config path: section.key (section ^[a-z][a-z0-9-]*$, key lowerCamel ^[a-z][a-zA-Z0-9_]*$, e.g. handyman.models)",
 		"",
 		"## Reading (agents may use fs tools directly)",
 		`- Read ${path} with the read tool → JSON.parse`,
@@ -1583,14 +1601,15 @@ const CCC_CONFIG_REFERENCE = `═══ CCC Configuration Reference ═══
 CCC-level features are configured in .opencode/serenity.json.
 Below are all available configuration sections.
 
-── 1. loop.defaultModel ──
-loop 工具缺省模型（未配置且未传 model 参数时 loop 报错）。
+── 1. handyman.models ──
+handyman（杂工）工具可用模型白名单（provider/model 列表）；未配置时 handyman 报错要求配置。
+缺省模型 = models[0]（可用 handyman.defaultModel 指定，必须 ∈ models）。
 
   Config:
-    { "loop": { "defaultModel": "provider/model-name" } }
+    { "handyman": { "models": ["provider/model-name"] } }
 
   Example:
-    { "loop": { "defaultModel": "minimax-cn-coding-plan/MiniMax-M3" } }
+    { "handyman": { "models": ["minimax-cn-coding-plan/MiniMax-M3"], "defaultModel": "minimax-cn-coding-plan/MiniMax-M3", "maxRounds": 100, "maxParallel": 10 } }
 
 ── 2. sessionKeeper.threshold ──
 SESSION-KEEPER 提醒机制的积分阈值（非 headless 主 agent）。
@@ -2014,7 +2033,7 @@ function renderText$7(value) {
 }
 const msmTool = defineTool({
 	name: "acc_msm",
-	description: "MSM (Mech & Semi-Mech) framework: list lists registered MSMs (header+flags display); exec executes (600s timeout, path-escape + symlink blocking, injects SERENITY_ROOT/CCC/VERSION env, appends --help TIP on failure; first arg --list/--schema/--format=json is protocol); register/deregister manage the registry (path inside root + script exists + globally unique validation, auto git precision commit); check quality checks DC-M1~M4; guide development manual; ccc-config CCC config reference (loop.defaultModel/sessionKeeper.threshold/localstore.gitTrack/hooks.autoRestoreSession). Reuses the CCC mech-registry.json.",
+	description: "MSM (Mech & Semi-Mech) framework: list lists registered MSMs (header+flags display); exec executes (600s timeout, path-escape + symlink blocking, injects SERENITY_ROOT/CCC/VERSION env, appends --help TIP on failure; first arg --list/--schema/--format=json is protocol); register/deregister manage the registry (path inside root + script exists + globally unique validation, auto git precision commit); check quality checks DC-M1~M4; guide development manual; ccc-config CCC config reference (handyman.models/sessionKeeper.threshold/localstore.gitTrack/hooks.autoRestoreSession). Reuses the CCC mech-registry.json.",
 	parameters: {
 		action: {
 			type: "string",
@@ -2287,46 +2306,52 @@ const cceTool = defineTool({
 	}
 });
 //#endregion
-//#region src/loop-preset-inherit.ts
+//#region src/handyman-preset-inherit.ts
 /**
-* 解析 loop agent 从父 agent 继承的 preset，并组装创建 setup 钩子。
-* @param parentCtx - 发起 loop 的 agent 的 scope ctx；无（headless/非 agent 上下文）时为 undefined。
+* 解析 handyman worker 从父 agent 继承的 preset，并组装创建 setup 钩子。
+* @param parentCtx - 发起 handyman 的 agent 的 scope ctx；无（headless/非 agent 上下文）时为 undefined。
 * @returns 继承结果：meta 用的 agentPreset 与创建 setup 钩子。
 */
-function loopPresetInheritance(parentCtx) {
-	if (parentCtx === void 0) return {};
+function handymanPresetInheritance(parentCtx) {
+	if (parentCtx === void 0) return { setup: (childCtx) => {
+		childCtx.tools.restrict({ deny: ["handyman"] });
+	} };
 	const agentPreset = parentCtx.get("agentPresets")?.composedPreset(parentCtx);
-	if (agentPreset === void 0) return {};
+	if (agentPreset === void 0) return { setup: (childCtx) => {
+		childCtx.tools.restrict({ deny: ["handyman"] });
+	} };
 	return {
 		agentPreset,
 		setup: (childCtx) => {
 			childCtx.get("agentPresets")?.composeFrom(childCtx, parentCtx);
+			childCtx.tools.restrict({ deny: ["handyman"] });
 		}
 	};
 }
 //#endregion
-//#region src/loop-ops.ts
+//#region src/handyman-ops.ts
 /**
-* loop-ops.ts — acc_loop 纯逻辑层（零 DSH 依赖，可独立单测）
+* handyman-ops.ts — handyman（杂工）纯逻辑层（零 DSH 依赖，可独立单测）
 *
-* 对齐 opencode-serenity-plugin 老 loop 语义：进度文件（loop-<label>.md/.json）、
-* 续跑、轮次 prompt 结构、stop token。
+* v1.24.0：loop（牛马）→ handyman（杂工）重命名。语义对齐 osp loop：
+* 进度文件（handyman-<label>.md/.json）、续跑、轮次 prompt 结构、stop token。
+* 不兼容旧 loop- 进度文件（用户拍板：仅新 handyman- 前缀）。
 */
 /** label 脱敏（Windows 审计问题 17）：非法字符 → '-'，去尾点/空格，限长 */
 function sanitizeLabel(label) {
 	return label.replace(/[<>:"/\\|?*\u0000-\u001f]/g, "-").replace(/[ .]+$/g, "").slice(0, 50);
 }
-function loopProgressPaths(root, label) {
+function handymanProgressPaths(root, label) {
 	const dir = join(root, "AGENT_SESSIONS");
 	const safe = sanitizeLabel(label);
 	return {
-		md: join(dir, `loop-${safe}.md`),
-		json: join(dir, `loop-${safe}.json`)
+		md: join(dir, `handyman-${safe}.md`),
+		json: join(dir, `handyman-${safe}.json`)
 	};
 }
 /** 读取进度（续跑）；无文件返回 round 0 */
 function readProgress(root, label) {
-	const { json } = loopProgressPaths(root, label);
+	const { json } = handymanProgressPaths(root, label);
 	if (!existsSync(json)) return null;
 	try {
 		return JSON.parse(readFileSync(json, "utf-8"));
@@ -2335,7 +2360,7 @@ function readProgress(root, label) {
 	}
 }
 function writeProgress(root, label, p) {
-	const { md, json } = loopProgressPaths(root, label);
+	const { md, json } = handymanProgressPaths(root, label);
 	mkdirSync(join(root, "AGENT_SESSIONS"), { recursive: true });
 	writeFileSync(json, JSON.stringify({
 		...p,
@@ -2343,7 +2368,7 @@ function writeProgress(root, label, p) {
 		updated: (/* @__PURE__ */ new Date()).toISOString()
 	}, null, 2) + "\n", "utf-8");
 	const lines = [
-		`# loop: ${label}`,
+		`# handyman: ${label}`,
 		`- Model: ${p.model}`,
 		`- Round: ${p.round}`,
 		`- Done: ${p.done}`,
@@ -2357,7 +2382,7 @@ function writeProgress(root, label, p) {
 }
 /** 失败状态落盘（对齐 osp writeFailedStatus：done=true / status=failed / errorCode） */
 function writeFailedStatus(root, label, info) {
-	const { json } = loopProgressPaths(root, label);
+	const { json } = handymanProgressPaths(root, label);
 	mkdirSync(join(root, "AGENT_SESSIONS"), { recursive: true });
 	const prev = readProgress(root, label);
 	writeFileSync(json, JSON.stringify({
@@ -2373,7 +2398,7 @@ function writeFailedStatus(root, label, info) {
 	}, null, 2) + "\n", "utf-8");
 }
 function newStopToken() {
-	return `SERENITY_LOOP_DONE_${randomBytes(8).toString("hex")}`;
+	return `SERENITY_HANDYMAN_DONE_${randomBytes(8).toString("hex")}`;
 }
 /** 解析 model 字符串（provider/model）→ {provider, model}；无 / 视为 model-only */
 function splitModel(model) {
@@ -2387,11 +2412,15 @@ function splitModel(model) {
 		model: model.slice(idx + 1)
 	};
 }
+/** 校验模型在白名单内；不在 → 抛错（用户拍板：只能使用 CCC 配置的模型） */
+function requireWhitelistedModel(model, models) {
+	if (!models.includes(model)) throw new Error(`handyman: model "${model}" is not in the CCC whitelist. Configure .opencode/serenity.json "handyman.models" with one of: ${models.join(", ")}`);
+}
 /** 轮次 prompt（对齐老 loop 结构：回顾进度 → 自由工作 → 汇报；S134 EAP 化：固定详尽） */
 function buildRoundPrompt(opts) {
 	const { root, session, label, round, stopToken, progress, task } = opts;
 	const resumeNote = progress && progress.round > 0 ? `Previous round (round ${progress.round}) completed: ${progress.lastResponse.slice(0, 300)}\nAlways continue from where you left off; never redo completed work.` : "This is the first round.";
-	return `# ${label} — workhorse loop round ${round}
+	return `# ${label} — handyman round ${round}
 
 CCC root: ${root}
 ${session ? `Work session: ${session} (progress recorded in AGENT_SESSIONS/${session}/SESSION.md)` : ""}
@@ -2415,49 +2444,53 @@ ${resumeNote}
 If the task is complete, output only ${stopToken}.`;
 }
 /**
-* loop 规模化使用指引（guide 子命令输出；S134）：
-* 使用 loop 前必须先加载 eap 设计方案；并行策略；提示词规范（详尽固定 EAP）；
-* 阅读/文字编写类 loop 内部也加载 eap。
+* handyman 规模化使用指引（guide 子命令输出；S134 继承 + v1.24.0 更新）：
+* 使用 handyman 前必须先加载 eap 设计方案；并行策略（jobs 编排）；提示词规范（详尽固定 EAP）；
+* 阅读/文字编写类 handyman 内部也加载 eap。
 */
-const LOOP_GUIDE = `# loop — Scale-Up Usage Guide (guide)
+const HANDYMAN_GUIDE = `# handyman — Scale-Up Usage Guide (guide)
 
 ## ⚠️ Before using: load eap and design the plan
-Before calling loop, load eap (acc-eap skill) and design the "scale-up loop plan" based on the EAP framework.
+Before calling handyman, load eap (acc-eap skill) and design the "scale-up handyman plan" based on the EAP framework.
 
 ### 1. Task decomposition (E↑ Explicit)
 - Split large tasks into explicit subtasks: each subtask defines goal / input / boundaries (what to do, what not to do) / acceptance criteria
 - Make dependencies explicit: dependent tasks run serially, independent ones can run in parallel
 
-### 2. Prompt design (loop's task parameter)
+### 2. Prompt design (handyman's task parameter)
 - task must be detailed, fixed, and EAP-compliant: clear goal, drawn boundaries, decidable acceptance criteria
 - Anti-example "handle this file" — ambiguous; good example "read <path>, extract all rows of the「关键决策」table,
   output a JSON array (fields id/conclusion/evidence), do not modify the original file"
 - Reading/curating or text-writing work (extracting from files, summarizing, writing docs, generating text, etc.):
-  the loop-internal agent is also required to load eap and organize output per the EAP standard
+  the handyman-internal agent is also required to load eap and organize output per the EAP standard
 
-### 3. Parallel strategy (scale-up)
-- Independent subtasks can run in parallel: each subtask gets its own loop (own label + task)
-- Parallel execution:
-  a. Background subagents: each subagent calls loop (own label), subagents run in parallel
-  b. workflow: parallel phase drives multiple loop sub-agents
-- Concurrency safety guaranteed: unique sessionId (loop-<label>-<uuid>), progress files isolated per label
-  (AGENT_SESSIONS/loop-<label>.json) — same label resumes, different labels never interfere
-- Aggregation: after each parallel loop produces progress, the main agent merges (or spawns one aggregation loop)
+### 3. Model whitelist (CCC-configured, mandatory)
+- handyman only uses models listed in .opencode/serenity.json "handyman.models" — never arbitrary models
+- Recursive subagents inside a handyman inherit the handyman's model automatically (DSH native)
+- Keep the subagent tool instance free of a fixed agentOptions, or model inheritance breaks
 
-## Completion criteria
-- The only completion condition = the loop-internal agent echoes this round's random verification code (stop token); dialogue round cap 100 (osp fail-safe, forced stop beyond the cap, resumable)
+### 4. Parallel strategy (jobs orchestration, workflow capability)
+- Independent subtasks can run in parallel via handyman(jobs=[...]): each job gets its own label + task + stop token + progress file
+- Concurrency safety guaranteed: unique sessionId (handyman-<label>-<uuid>), progress files isolated per label
+  (AGENT_SESSIONS/handyman-<label>.json) — same label resumes, different labels never interfere
+- Parallel cap: handyman.maxParallel (default 10 — cheap models are cheap)
+- Aggregation: after each parallel job produces progress, the main agent merges (or spawns one aggregation handyman)
+- For programmable pipeline/phase orchestration at scale, use the platform's workflow tool instead
+
+## Completion criteria (osp loop standard)
+- The only completion condition = the handyman-internal agent echoes this round's random verification code (stop token); dialogue round cap (default 100, osp fail-safe, forced stop beyond the cap, resumable)
 - Automatic restart on abnormal agent stop (≤100 restarts, anti-infinite-loop)
 
 ## Waiting UI
-- The WebUI session-header Serenity detail card shows running loops' progress (label / round / last response), one line per parallel task, ~3s refresh
+- The WebUI session-header Serenity detail card shows running handymen's progress (label / round / last response), one line per parallel job, ~3s refresh
 `;
-/** 列出 AGENT_SESSIONS/loop-*.json 的全部进度（按 updated 倒序；坏文件跳过） */
-function listActiveLoops(root) {
+/** 列出 AGENT_SESSIONS/handyman-*.json 的全部进度（按 updated 倒序；坏文件跳过） */
+function listActiveHandymen(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;
+		if (!entry.startsWith("handyman-") || !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;
@@ -2475,26 +2508,26 @@ function listActiveLoops(root) {
 	return out;
 }
 //#endregion
-//#region src/tools/loop.ts
+//#region src/tools/handyman.ts
 /**
-* loop.ts — acc_loop 真实 DSH 工具（老 loop 等效：廉价模型牛马循环）
+* handyman.ts — handyman（杂工）真实 DSH 工具（v1.24.0：loop 牛马 → handyman 杂工）
 *
-* 语义对齐 opencode-serenity-plugin 老 loop：
-*   label（必）任务标签 → 进度文件 loop-<label>.md/.json
-*   session（选）工作会话 S###（上下文提示）
-*   model（选）provider/model（如 minimax-cn-coding-plan/MiniMax-M3）；缺省读 loop.defaultModel
-*   （S134 修正：轮次不需要调用者指定——内部 while 驱动 agent 逐轮推进，
-*    对话轮次**无上限**（不完成不返回）；agent 非正常停止时自动重启，
-*    重启次数上限 LOOP_MAX_RESTARTS=100（防死循环保险阀））
+* 用户需求（S142 拍板）：
+*   - **同步**（用户明确：这个事一般不会异步——工具阻塞到完成）
+*   - **指定模型**（CCC 白名单内——handyman.models，未配置报错）
+*   - **自主循环到完成**（stop-token 唯一完成判据，对齐 osp loop）
+*   - **内部递归同样低能 subagent**（worker 工具面含 subagent，DSH 原生模型继承）
+*   - **workflow 能力**（jobs 编排：主 agent 一次并行多个杂工，maxParallel 默认 10）
+*   - **worker 不含 handyman 本身**（递归编排归主 agent，防无限嵌套）
+*   - **不兼容旧 loop 进度文件**（仅 handyman- 前缀）
 *
 * 机制：ctx.agents.create()（带 setup 钩子）创建专用 agent（进程内），
 * 每轮 followup → agent/status idle → 读 session.events 响应 → 写进度 → stop token 检查 →
 * 未完成继续下一轮；followup/waitIdle 抛错（非正常停止）→ dispose 并重新 create agent
 * （重启计数，≤100），同一轮重试。工厂模式：apply 时闭包捕获插件 ctx（工具 execute 无 ctx 参数）。
 *
-* preset 继承：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐 subagent 先例），
-* 使 loop agent 继承发起方会话的 agent preset 工具（read/write/edit 等 preset 层工具）。
-* agentPresets 是可选服务——无 preset 装配的环境（无 roster 部署）退化为空工具层（历史行为）。
+* preset 继承 + 工具收窄：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐
+* subagent 先例）+ tools.restrict deny handyman（worker 内部看不到 handyman 工具）。
 */
 function agentCwd$4(exec) {
 	return (exec.agent?.session)?.header?.cwd ?? process.cwd();
@@ -2505,7 +2538,7 @@ function renderText$3(value) {
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
 	}];
 }
-/** 等待 agent 空闲（agent/status → idle）；无超时（loop 可永续，agent 工作多久等多久） */
+/** 等待 agent 空闲（agent/status → idle）；无超时（handyman 可永续，agent 工作多久等多久） */
 function waitIdle(ctx, agent) {
 	return new Promise((resolve) => {
 		let settled = false;
@@ -2533,22 +2566,160 @@ function lastAssistantText(agent) {
 	}
 	return "";
 }
-/** 创建 loop 工具（闭包捕获插件 ctx → 可访问 ctx.agentLoop） */
-/** 创建 loop 工具（闭包捕获插件 ctx → 可访问 ctx.agentLoop） */
-function createLoopTool(ctx) {
+/** 运行时解析 jobs 参数（DSH schema 不支持 object items 的 required/校验 → 手工校验类型） */
+function parseJobs(raw) {
+	if (!Array.isArray(raw) || raw.length === 0) return null;
+	const jobs = [];
+	for (const item of raw) {
+		if (typeof item !== "object" || item === null) return null;
+		const rec = item;
+		if (typeof rec.task !== "string" || typeof rec.label !== "string") return null;
+		jobs.push({
+			task: rec.task,
+			label: rec.label,
+			model: typeof rec.model === "string" ? rec.model : void 0
+		});
+	}
+	return jobs;
+}
+/**
+* 驱动单个 handyman worker：创建 agent → while 循环（stop-token 完成判据）→ dispose。
+* 同步阻塞直到完成/保险阀。jobs 编排时多个 worker 并行（Promise.all）。
+*/
+async function runHandymanJob(ctx, opts) {
+	const { root, job, defaultModel, models, maxRounds, parentSession, parentCtx, session } = opts;
+	const label = job.label;
+	const model = job.model ?? defaultModel;
+	requireWhitelistedModel(model, models);
+	const { provider, model: modelName } = splitModel(model);
+	const stopToken = newStopToken();
+	let progress = readProgress(root, label);
+	const startRound = progress ? progress.round + 1 : 1;
+	const inherited = handymanPresetInheritance(parentCtx);
+	if (!ctx.agents) throw new Error("handyman: ctx.agents unavailable");
+	let handle;
+	let workerAgent;
+	const spawnAgent = async () => {
+		const sessionId = `handyman-${label}-${randomUUID()}`;
+		handle = await ctx.agents.create({
+			sessionId,
+			meta: {
+				cwd: root,
+				origin: "subagent",
+				...parentSession === void 0 ? {} : { parentSession },
+				...inherited.agentPreset === void 0 ? {} : { agentPreset: inherited.agentPreset }
+			},
+			agentOptions: {
+				provider,
+				model: modelName
+			},
+			...inherited.setup === void 0 ? {} : { setup: inherited.setup }
+		});
+		workerAgent = handle.agent;
+	};
+	await spawnAgent();
+	let done = false;
+	let lastResponse = progress?.lastResponse ?? "";
+	let finalRound = startRound - 1;
+	let restarts = 0;
+	let finishReason = "done";
+	try {
+		let round = startRound;
+		while (true) {
+			if (round > maxRounds) {
+				finishReason = "max_rounds";
+				break;
+			}
+			finalRound = round;
+			const prompt = buildRoundPrompt({
+				root,
+				session,
+				label,
+				round,
+				stopToken,
+				progress,
+				task: job.task
+			});
+			try {
+				workerAgent.followup(createUserMessage({
+					content: [{
+						type: "text",
+						text: prompt
+					}],
+					source: {
+						kind: "plugin",
+						plugin: "dsh-serenity-hooks"
+					}
+				}));
+				await waitIdle(ctx, workerAgent);
+				lastResponse = lastAssistantText(workerAgent);
+			} catch {
+				restarts++;
+				if (restarts > 100) {
+					finishReason = "restart_exceeded";
+					break;
+				}
+				await handle.dispose().catch(() => {});
+				await spawnAgent();
+				continue;
+			}
+			progress = {
+				round,
+				done: false,
+				label,
+				model,
+				updated: (/* @__PURE__ */ new Date()).toISOString(),
+				lastResponse
+			};
+			writeProgress(root, label, progress);
+			if (lastResponse.includes(stopToken)) {
+				done = true;
+				finishReason = "done";
+				break;
+			}
+			round++;
+		}
+		writeProgress(root, label, {
+			round: finalRound,
+			done,
+			label,
+			model,
+			updated: (/* @__PURE__ */ new Date()).toISOString(),
+			lastResponse,
+			status: done ? "done" : "running"
+		});
+		if (finishReason !== "done") writeFailedStatus(root, label, {
+			errorCode: finishReason,
+			errorMessage: finishReason === "max_rounds" ? `Reached ${maxRounds} rounds without completion — resume with same label to continue.` : `Agent restarted 100 times without progress — resume with same label to continue.`
+		});
+	} finally {
+		await handle.dispose().catch(() => {});
+	}
+	const { json } = handymanProgressPaths(root, label);
+	return {
+		label,
+		done,
+		rounds: finalRound,
+		finishReason,
+		restarts,
+		model,
+		lastResponse: lastResponse.slice(0, 2e3),
+		progressFile: json
+	};
+}
+/** 创建 handyman 工具（闭包捕获插件 ctx → 可访问 ctx.agents） */
+function createHandymanTool(ctx) {
 	return defineTool({
-		name: "loop",
-		description: "The workhorse loop (equivalent to the legacy loop): create a dedicated agent with the specified model and run it repeatedly until the task is done.\nUsage: loop guide (print the scale-up usage guide — load eap to design a scale-up plan before using); loop accepts task (the goal to complete) or relies on session context; default model reads loop.defaultModel from .opencode/serenity.json (currently minimax-cn-coding-plan/MiniMax-M3, the cheap workhorse).\nBehavior: an internal hard while-loop drives the agent round by round, each round waits with no timeout (the agent works as long as it needs). The only completion condition = the agent echoes this round's random completion code (stop token), preventing low-intelligence models from finishing early. Rounds need no caller input — dialogue round cap 100 (osp fail-safe; forced stop beyond the cap, resumable), automatic restart on abnormal stop (≤100 restarts, anti-infinite-loop fail-safe).\nProgress: written to AGENT_SESSIONS/loop-<label>.md/.json; calling again with the same label resumes from the last round (no redo).\nConstraints: loop agents carry full Serenity constraints (ACC identity / entry-skill system prompt / guards / trajectory-steward).\nExample: loop 执行「扫描 SQC 并修复 DC 问题」 (run SQC scan and fix DC issues), label: sqc-scan; loop guide",
+		name: "handyman",
+		description: "The handyman (杂工): delegate a do-everything worker agent to a CCC-configured model and run it synchronously in rounds until the task is done.\nUsage: handyman guide (print the scale-up usage guide — load eap to design a plan before using); single task: handyman(task, label, [model]); multi-job orchestration (workflow capability): handyman(jobs=[{task,label,model?},...]).\nModel: only models whitelisted in .opencode/serenity.json \"handyman.models\" (missing config = error); default reads handyman.defaultModel; jobs run in parallel (handyman.maxParallel, default 10 — cheap models are cheap).\nBehavior: each worker runs synchronously (this call blocks until done) with an internal hard while-loop; the only completion condition = the worker echoes this round's random completion code (stop token), preventing low-intelligence models from finishing early. Round cap (default 100, osp fail-safe; resumable), automatic restart on abnormal stop (≤100 restarts).\nRecursion: a worker's tool set includes the subagent tool (DSH-native model inheritance — its subagents use the same model), but NOT handyman itself (orchestration belongs to the main agent).\nProgress: AGENT_SESSIONS/handyman-<label>.md/.json; same label resumes from the last round (no redo). Legacy loop- progress files are NOT compatible (v1.24.0).\nExample: handyman(task=\"扫描 SQC 并修复 DC 问题\", label=\"sqc-scan\"); handyman(jobs=[{task:\"扫描 A\",label:\"scan-a\"},{task:\"扫描 B\",label:\"scan-b\"}]); handyman guide",
 		parameters: {
 			task: {
 				type: "string",
-				required: true,
-				description: "The task goal to complete (required: tell the loop agent what to do)"
+				description: "The task goal to complete (required for single-task mode; must be detailed and EAP-compliant)"
 			},
 			label: {
 				type: "string",
-				required: true,
-				description: "Task label (1-50 chars; progress file named loop-<label>.md/.json)"
+				description: "Task label (1-50 chars; progress file named handyman-<label>.md/.json)"
 			},
 			session: {
 				type: "string",
@@ -2556,11 +2727,24 @@ function createLoopTool(ctx) {
 			},
 			model: {
 				type: "string",
-				description: "provider/model (e.g. minimax-cn-coding-plan/MiniMax-M3); default reads loop.defaultModel"
+				description: "provider/model — must be in the CCC whitelist handyman.models; default reads handyman.defaultModel"
+			},
+			jobs: {
+				type: "array",
+				description: "Multi-job orchestration (workflow capability): [{task, label, model?}, ...] — runs jobs in parallel (cap handyman.maxParallel, default 10)",
+				items: {
+					type: "object",
+					properties: {
+						task: { type: "string" },
+						label: { type: "string" },
+						model: { type: "string" }
+					},
+					additionalProperties: false
+				}
 			},
 			guide: {
 				type: "boolean",
-				description: "Print the scale-up usage guide (creates no agent; read before using loop — includes eap scale-up design requirements / parallelism strategy / prompt conventions)"
+				description: "Print the scale-up usage guide (creates no agent; includes eap design requirements / whitelist rules / jobs parallel strategy / prompt conventions)"
 			}
 		},
 		output: {
@@ -2568,135 +2752,45 @@ function createLoopTool(ctx) {
 			render: (_args, value) => renderText$3(value)
 		},
 		async execute(args, exec) {
-			if (args.guide) return { guide: LOOP_GUIDE };
+			if (args.guide) return { guide: HANDYMAN_GUIDE };
 			const root = findSerenityRoot(agentCwd$4(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 requires a model: pass --model or configure .opencode/serenity.json loop.defaultModel");
-			const label = args.label;
-			if (!ctx.agentLoop) throw new Error("loop: ctx.agentLoop unavailable");
-			const { provider, model: modelName } = splitModel(model);
-			const stopToken = newStopToken();
-			let progress = readProgress(root, label);
-			const startRound = progress ? progress.round + 1 : 1;
+			const hc = readHandymanConfig(root, DEFAULT_SERENITY_CONFIG_PATHS);
+			if (hc === null) throw new Error("handyman requires a model whitelist: configure .opencode/serenity.json \"handyman.models\" (e.g. {\"handyman\": {\"models\": [\"minimax-cn-coding-plan/MiniMax-M3\"], \"defaultModel\": \"minimax-cn-coding-plan/MiniMax-M3\"}})");
+			const jobs = args.jobs !== void 0 ? (() => {
+				const parsed = parseJobs(args.jobs);
+				if (parsed === null) throw new Error("handyman: jobs must be [{task, label, model?}, ...] (every job requires task and label)");
+				return parsed;
+			})() : (() => {
+				if (typeof args.task !== "string" || typeof args.label !== "string") throw new Error("handyman: task and label are required (single-job mode)");
+				return [{
+					task: args.task,
+					label: args.label
+				}];
+			})();
+			if (jobs.length === 0) throw new Error("handyman: no jobs provided");
+			if (jobs.length > hc.maxParallel) throw new Error(`handyman: ${jobs.length} jobs exceed maxParallel ${hc.maxParallel} (configure handyman.maxParallel to raise)`);
+			if (jobs.some((j) => !j.task || !j.label)) throw new Error("handyman: every job requires task and label");
 			const parentCtx = exec.agent?.ctx;
-			const inherited = loopPresetInheritance(parentCtx);
-			if (!ctx.agents) throw new Error("loop: ctx.agents unavailable");
 			const parentSession = (exec.agent?.session)?.id;
-			let handle;
-			let loopAgent;
-			const spawnAgent = async () => {
-				const sessionId = `loop-${label}-${randomUUID()}`;
-				handle = await ctx.agents.create({
-					sessionId,
-					meta: {
-						cwd: root,
-						origin: "subagent",
-						...parentSession === void 0 ? {} : { parentSession },
-						...inherited.agentPreset === void 0 ? {} : { agentPreset: inherited.agentPreset }
-					},
-					agentOptions: {
-						provider,
-						model: modelName
-					},
-					...inherited.setup === void 0 ? {} : { setup: inherited.setup }
-				});
-				loopAgent = handle.agent;
-			};
-			await spawnAgent();
-			let done = false;
-			let lastResponse = progress?.lastResponse ?? "";
-			let finalRound = startRound - 1;
-			let restarts = 0;
-			let finishReason = "done";
-			try {
-				let round = startRound;
-				while (true) {
-					if (round > 100) {
-						finishReason = "max_rounds";
-						break;
-					}
-					finalRound = round;
-					const prompt = buildRoundPrompt({
-						root,
-						session: args.session,
-						label,
-						round,
-						stopToken,
-						progress,
-						task: args.task
-					});
-					try {
-						loopAgent.followup(createUserMessage({
-							content: [{
-								type: "text",
-								text: prompt
-							}],
-							source: {
-								kind: "plugin",
-								plugin: "dsh-serenity-hooks"
-							}
-						}));
-						await waitIdle(ctx, loopAgent);
-						lastResponse = lastAssistantText(loopAgent);
-					} catch {
-						restarts++;
-						if (restarts > 100) {
-							finishReason = "restart_exceeded";
-							break;
-						}
-						await handle.dispose().catch(() => {});
-						await spawnAgent();
-						continue;
-					}
-					progress = {
-						round,
-						done: false,
-						label,
-						model,
-						updated: (/* @__PURE__ */ new Date()).toISOString(),
-						lastResponse
-					};
-					writeProgress(root, label, progress);
-					if (lastResponse.includes(stopToken)) {
-						done = true;
-						finishReason = "done";
-						break;
-					}
-					round++;
-				}
-				writeProgress(root, label, {
-					round: finalRound,
-					done,
-					label,
-					model,
-					updated: (/* @__PURE__ */ new Date()).toISOString(),
-					lastResponse,
-					status: done ? "done" : "running"
-				});
-				if (finishReason !== "done") writeFailedStatus(root, label, {
-					errorCode: finishReason,
-					errorMessage: finishReason === "max_rounds" ? `Reached 100 rounds without completion — resume with same label to continue.` : `Agent restarted 100 times without progress — resume with same label to continue.`
-				});
-			} finally {
-				await handle.dispose().catch(() => {});
-			}
-			const { json } = loopProgressPaths(root, label);
+			const results = await Promise.all(jobs.map((job) => runHandymanJob(ctx, {
+				root,
+				job,
+				defaultModel: hc.defaultModel,
+				models: hc.models,
+				maxRounds: hc.maxRounds,
+				parentSession,
+				parentCtx,
+				session: typeof args.session === "string" ? args.session : void 0
+			})));
 			return {
-				done,
-				rounds: finalRound,
-				finishReason,
-				restarts,
-				model,
-				label,
-				progressFile: json,
-				lastResponse: lastResponse.slice(0, 2e3),
+				done: results.every((r) => r.done),
+				jobs: results.map((r) => ({ ...r })),
 				usage: {
-					how: `loop drives the agent round by round via an internal hard while-loop; the agent terminates by echoing the random completion code; dialogue round cap 100 (osp fail-safe), automatic restart on abnormal stop (≤100 times)`,
-					progress: `Progress in AGENT_SESSIONS/loop-${label}.md and .json; calling loop again with the same label resumes from the next round (no redo)`,
-					constraints: "loop agents carry full Serenity constraints (ACC identity / entry-skill system prompt / guards / trajectory-steward)",
-					next: done ? "Task completed; check the progress file to wrap up" : `Task incomplete (${finishReason}, hit 100 rounds or 100 restart fail-safe); resume with the same label`
+					how: "handyman drives each worker agent round by round via an internal hard while-loop; the worker terminates by echoing the random completion code; round cap (default 100, osp fail-safe), automatic restart on abnormal stop (≤100 times); model restricted to the CCC whitelist handyman.models",
+					progress: "Progress in AGENT_SESSIONS/handyman-<label>.md and .json; calling handyman again with the same label resumes from the next round (no redo)",
+					constraints: "handyman workers carry full Serenity constraints (ACC identity / entry-skill system prompt / guards / trajectory-steward); workers include the subagent tool (same-model inheritance) but NOT handyman itself",
+					next: results.every((r) => r.done) ? "All jobs completed; check the progress files to wrap up" : "Some jobs incomplete (max_rounds / restart_exceeded fail-safe); resume with the same labels"
 				}
 			};
 		}
@@ -5762,7 +5856,7 @@ function createEpochPromotion(promoteEvents, requiredSignals = 1, maxRoundsFallb
 				promoted: true
 			};
 			const loopSid = session.id;
-			if (typeof loopSid === "string" && loopSid.startsWith("loop-")) return {
+			if (typeof loopSid === "string" && loopSid.startsWith("handyman-")) return {
 				boundary: -1,
 				promoted: true
 			};
@@ -5866,7 +5960,7 @@ function registerBootstrap(ctx) {
 			const session = agent.session;
 			const depth = session?.header?.delegationDepth ?? 0;
 			const sid = typeof session?.id === "string" ? session.id : void 0;
-			if (sid !== void 0 && sid.startsWith("loop-")) return;
+			if (sid !== void 0 && sid.startsWith("handyman-")) return;
 			if (depth === 0) {
 				if (session?.events?.some((event) => event.type === "user/message")) return;
 			} else if (sid !== void 0 && anchoredSessions.has(sid)) return;
@@ -6218,7 +6312,7 @@ function renderText(value) {
 }
 const localstoreTool = defineTool({
 	name: "localstore",
-	description: "ACC standard local credential/config storage: one tool manages two namespaces — credential (credentials) and config (local preferences). Stored in localstore.json at the CCC root (JSON format, directly readable by MSMs). Git policy: .opencode/serenity.json localstore.gitTrack (allow commits / deny commits, default deny; .dsh fallback) — when deny, writes ensure .gitignore contains this file (physical guarantee), cc_git commit checks and refuses. Subcommands: list (list keys, credentials never return values) / get <name> (read value) / set <name> <value> (write) / unset <name> (delete) / show <name> (metadata, credentials never print values) / doc (output the storage spec — path/format/key conventions/git policy; agents may operate the file directly with read/write per the spec). Default scope=credential; config requires --scope config (path is section.key, e.g. loop.defaultModel).",
+	description: "ACC standard local credential/config storage: one tool manages two namespaces — credential (credentials) and config (local preferences). Stored in localstore.json at the CCC root (JSON format, directly readable by MSMs). Git policy: .opencode/serenity.json localstore.gitTrack (allow commits / deny commits, default deny; .dsh fallback) — when deny, writes ensure .gitignore contains this file (physical guarantee), cc_git commit checks and refuses. Subcommands: list (list keys, credentials never return values) / get <name> (read value) / set <name> <value> (write) / unset <name> (delete) / show <name> (metadata, credentials never print values) / doc (output the storage spec — path/format/key conventions/git policy; agents may operate the file directly with read/write per the spec). Default scope=credential; config requires --scope config (path is section.key, e.g. handyman.models).",
 	parameters: {
 		action: {
 			type: "string",
@@ -6818,7 +6912,7 @@ function accBlock(root) {
 		"  eap       — return the full EAP cognitive quality framework",
 		"  neat      — return the full Neat design collaboration protocol",
 		"  cce       — return the full Cognitive Continuity Engineering framework",
-		"  loop      — run a dedicated model-specific agent in repeated rounds toward a goal",
+		"  handyman  — delegate a do-everything worker agent (CCC-whitelisted model) to run synchronously in rounds until done, recursing into same-model subagents; jobs=[] orchestrates parallel work",
 		"  session_rebuild — rebuild this conversation in place from SESSION.md when the trajectory-tracker trips",
 		"  localstore — ACC local credential/config storage (CCC-root localstore.json, JSON format; git policy localstore.gitTrack default deny); doc subcommand outputs the spec",
 		"",
@@ -7270,7 +7364,8 @@ function registerEntrySkillSection(agent, root) {
 //#region src/seams/context.ts
 const DEFAULT_ENTRY_SKILL_MAX_CHARS = 3e4;
 function accIdentityText(root, configPaths = DEFAULT_SERENITY_CONFIG_PATHS, entrySkillMaxChars = DEFAULT_ENTRY_SKILL_MAX_CHARS) {
-	const loop = loadSerenityConfig(root, configPaths).loop?.defaultModel;
+	loadSerenityConfig(root, configPaths);
+	const defaultModel = readHandymanConfig(root, configPaths)?.defaultModel;
 	const phase2 = existsSync(resolve(root, ".dsh", "PHASE2-PROMPT.md"));
 	const lines = [
 		`[ACC] Serenity cognitive container active (dsh-serenity-hooks v${ACC_VERSION})`,
@@ -7278,7 +7373,7 @@ function accIdentityText(root, configPaths = DEFAULT_SERENITY_CONFIG_PATHS, entr
 		`- Constraints: path isolation (P3, fs sandbox) + session tracking (AGENT_SESSIONS/)`,
 		`- Knowledge: load the acc-serenity entry skill; use acc-eap / acc-neat for design collaboration`
 	];
-	if (loop) lines.push(`- loop default model: ${loop}`);
+	if (defaultModel) lines.push(`- handyman default model: ${defaultModel}`);
 	if (phase2) {
 		lines.push("- ⚠️ **Phase 2 cognitive alignment interview pending**: work through the 5 Topics below and record answers in an AGENT_SESSIONS/ session");
 		try {
@@ -7293,7 +7388,7 @@ const PLUGIN_SOURCE = {
 	plugin: "dsh-serenity-hooks"
 };
 /**
-* ACC 注入消息（S134 去重）：**只含简短身份锚点**（[ACC] 已激活 + CCC 根 + 约束 + loop 模型 + Phase 2）。
+* ACC 注入消息（S134 去重）：**只含简短身份锚点**（[ACC] 已激活 + CCC 根 + 约束 + handyman 模型 + Phase 2）。
 * 完整身份（ACC 5 块 + CCE + Constraints + EAP + SKILL 全文 + Session 块）由**系统提示词层**
 * （systemPrompt.section，每轮 prompt 装配自动注入，含 subagent）承担——对话消息流/压缩重注入
 * 不再重复注入同一内容（token 双倍浪费，见 S134 注入方案梳理）。
@@ -7321,7 +7416,7 @@ function agentScope(agent) {
 * 只有"conversation 根会话"才自动恢复最近激活的宁静号会话——
 * - subagent：session header `origin === 'subagent'`（DSH 路由语义，agent-lookup.ts）
 * - 派生会话：`parentSession` 存在（任何子会话）
-* - loop 牛马：sessionId 固定 `loop-` 前缀（tools/loop.ts 生成）
+* - handyman 杂工：sessionId 固定 `handyman-` 前缀（tools/handyman.ts 生成）
 * 三者都不恢复（避免把主会话激活注入子上下文，违背 v1.16.2 scope 隔离）。
 */
 function shouldAutoRestore(agent) {
@@ -7329,7 +7424,7 @@ function shouldAutoRestore(agent) {
 	if (!session) return false;
 	if (session.header?.origin === "subagent") return false;
 	if (session.header?.parentSession) return false;
-	if (session.id?.startsWith("loop-")) return false;
+	if (session.id?.startsWith("handyman-")) return false;
 	return true;
 }
 /**
@@ -7417,7 +7512,7 @@ function registerCompactRetention(ctx, opts = {}) {
 //#endregion
 //#region src/api.ts
 const ROUTE_PATH = "/serenity/status";
-const LOOPS_PATH = "/serenity/loops";
+const HANDYMEN_PATH = "/serenity/handymen";
 const UPLOAD_PATH = "/serenity/image-upload";
 const CONFIG_PATH = "/serenity/config";
 /** 图片落盘目录（CCC 根相对；S142 图片自动识别基础设施——粘贴图片落盘供 agent 经 CCC vlm MSM 自主处理） */
@@ -7500,7 +7595,7 @@ function registerStatusApi(ctx, opts = {}) {
 	const configPaths = opts.configPaths ?? DEFAULT_SERENITY_CONFIG_PATHS;
 	ctx.webServer.register({
 		kind: "exact",
-		path: LOOPS_PATH,
+		path: HANDYMEN_PATH,
 		handler: async (req, res) => {
 			try {
 				if (req.method !== "GET") {
@@ -7513,10 +7608,10 @@ function registerStatusApi(ctx, opts = {}) {
 					workspace: url.searchParams.get("workspace") ?? void 0
 				}));
 				if (!root) {
-					sendJson(res, 200, { loops: [] });
+					sendJson(res, 200, { handymen: [] });
 					return;
 				}
-				sendJson(res, 200, { loops: listActiveLoops(root) });
+				sendJson(res, 200, { handymen: listActiveHandymen(root) });
 			} catch (err) {
 				sendJson(res, 400, { error: err.message ?? String(err) });
 			}
@@ -8546,7 +8641,7 @@ function apply(ctx, config) {
 		ctx.tools.register(eapTool);
 		ctx.tools.register(neatTool);
 		ctx.tools.register(cceTool);
-		ctx.tools.register(createLoopTool(ctx));
+		ctx.tools.register(createHandymanTool(ctx));
 		ctx.tools.register(createRebuildTool(ctx));
 		ctx.tools.register(localstoreTool);
 	}

package/lib/invariant.js

@@ -41,7 +41,7 @@ const REGISTERED_TOOLS = [
 	"eap",
 	"neat",
 	"cce",
-	"loop"
+	"handyman"
 ];
 //#endregion
 export { REGISTERED_TOOLS, readPluginManifest, verifyToolConsistency };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.23.8",
+  "version": "1.24.0",
   "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": {