@dsh-plus/agent-preset-rea 0.1.1 → 0.1.3

package/src/client/install.tsx

@@ -1,6 +1,6 @@
 /**
- * 卡片的「REA 安装与更新」区：只读状态表 + 三个动作（安装/更新 REA、更新 skill、
- * 取消作业）+ 运行中作业的阶段进度条、已用时与日志尾部。
+ * 卡片的「REA 安装与更新」区：只读状态表 + 四个动作（安装/更新 REA、更新 REA skill、
+ * 更新 reverse-skill、取消作业）+ 运行中作业的阶段进度条、已用时与日志尾部。
  *
  * 状态与作业都来自宿主半的同源端点（见 client/api.ts 与宿主 routes.ts）：这里只管
  * 轮询与呈现。作业在跑时按 {@link PROGRESS_POLL_MS} 轮询——进度是宿主侧的真事实，
@@ -8,9 +8,9 @@
  * @module agent-preset-rea/client/install
  */
 import { Button } from '@dsh-plus/shared/client'
-import { type ReactElement, useCallback, useEffect, useRef, useState } from 'react'
+import { type ReactElement, type ReactNode, useCallback, useEffect, useRef, useState } from 'react'
 
-import type { JobDto, StatusDto } from '../dto.ts'
+import type { JobDto, ReverseSkillDto, SkillDto, StatusDto } from '../dto.ts'
 import { cancelJob, fetchStatus, startJob } from './api.ts'
 import type { Translate } from './i18n.ts'
 
@@ -43,6 +43,14 @@ const STATE_CLASS = {
   cancelled: 'Cancelled',
 } as const
 
+/** 作业种类 → 文案键。 */
+const JOB_LABEL = { install: 'jobInstall', skill: 'jobSkill', reverse: 'jobReverse' } as const
+
+/** 进度条百分比（防御性收窄，避免越界宽度）。 */
+function widthOf(percent: number): string {
+  return `${Math.max(0, Math.min(100, percent))}%`
+}
+
 /** 作业进度块：状态徽标 + 阶段 + 进度条 + 日志尾部。 */
 function JobPanel(props: { t: Translate; job: JobDto }): ReactElement {
   const { t, job } = props
@@ -59,9 +67,7 @@ function JobPanel(props: { t: Translate; job: JobDto }): ReactElement {
     <div className="apr-job">
       <div className="apr-jobHead">
         <span className={`apr-pill apr-pill${STATE_CLASS[job.state]}`}>{t(stateKey)}</span>
-        <span className="apr-jobTitle">
-          {t(job.kind === 'install' ? 'jobInstall' : 'jobSkill')}
-        </span>
+        <span className="apr-jobTitle">{t(JOB_LABEL[job.kind])}</span>
         <span className="apr-hint">
           {t('jobPhase')} {job.progress.step}/{job.progress.steps}·{job.progress.phase}
         </span>
@@ -76,7 +82,7 @@ function JobPanel(props: { t: Translate; job: JobDto }): ReactElement {
         aria-valuemax={100}
         aria-valuenow={job.progress.percent}
       >
-        <div className="apr-barFill" style={{ width: `${job.progress.percent}%` }} />
+        <div className="apr-barFill" style={{ width: widthOf(job.progress.percent) }} />
       </div>
       {job.error === null ? null : <p className="apr-error">{job.error}</p>}
       <details className="apr-logBox" open={job.state !== 'ok'}>
@@ -88,7 +94,7 @@ function JobPanel(props: { t: Translate; job: JobDto }): ReactElement {
 }
 
 /** 一行状态（键 + 值）。 */
-function StatusRow(props: { label: string; children: React.ReactNode }): ReactElement {
+function StatusRow(props: { label: string; children: ReactNode }): ReactElement {
   return (
     <div className="apr-installRow">
       <dt className="apr-installKey">{props.label}</dt>
@@ -97,10 +103,16 @@ function StatusRow(props: { label: string; children: React.ReactNode }): ReactEl
   )
 }
 
-/** 只读状态表：REA 包 / 受管目录 / skill 来源 / MCP 行形态。 */
-function StatusTable(props: { t: Translate; status: StatusDto }): ReactElement {
+/** 状态徽标（已就绪 / 未就绪 / 已关闭）。 */
+function Pill(props: { ok: boolean; label: string }): ReactElement {
+  return (
+    <span className={`apr-pill ${props.ok ? 'apr-pillOk' : 'apr-pillMiss'}`}>{props.label}</span>
+  )
+}
+
+/** REA 包与 MCP 行状态。 */
+function InstallRows(props: { t: Translate; status: StatusDto }): ReactElement {
   const { t, status } = props
-  const skillLabel = status.skill.source === 'updated' ? t('skillUpdated') : t('skillBundled')
   const mcpLabel = !status.mcp.enabled
     ? status.config.mcpEnabled
       ? t('mcpMissing')
@@ -109,11 +121,12 @@ function StatusTable(props: { t: Translate; status: StatusDto }): ReactElement {
       ? t('mcpCustom')
       : t('mcpInstalled')
   return (
-    <dl className="apr-install">
+    <>
       <StatusRow label={t('installPackage')}>
-        <span className={`apr-pill ${status.install.installed ? 'apr-pillOk' : 'apr-pillMiss'}`}>
-          {t(status.install.installed ? 'installed' : 'notInstalled')}
-        </span>
+        <Pill
+          ok={status.install.installed}
+          label={t(status.install.installed ? 'installed' : 'notInstalled')}
+        />
         {status.install.version === null ? null : (
           <span className="apr-mono">{status.install.version}</span>
         )}
@@ -124,18 +137,6 @@ function StatusTable(props: { t: Translate; status: StatusDto }): ReactElement {
       <StatusRow label={t('installPath')}>
         <code className="apr-mono">{status.install.root}</code>
       </StatusRow>
-      <StatusRow label={t('skillSource')}>
-        <span className="apr-mono">{skillLabel}</span>
-        <span className="apr-hint">
-          {t('skillFiles')} {status.skill.files}
-          {status.skill.version === null ? '' : ` · ${status.skill.version}`}
-        </span>
-        {status.skill.updatedAt === null ? null : (
-          <span className="apr-hint">
-            {t('updatedAt')} {status.skill.updatedAt}
-          </span>
-        )}
-      </StatusRow>
       <StatusRow label={t('mcpRow')}>
         <span className="apr-mono">{mcpLabel}</span>
         {status.mcp.command === null ? null : (
@@ -144,10 +145,125 @@ function StatusTable(props: { t: Translate; status: StatusDto }): ReactElement {
           </code>
         )}
       </StatusRow>
+    </>
+  )
+}
+
+/** REA 官方 skill 状态。 */
+function SkillRows(props: { t: Translate; skill: SkillDto; enabled: boolean }): ReactElement {
+  const { t, skill, enabled } = props
+  const version = skill.version === null ? '' : ` · ${skill.version}`
+  return (
+    <StatusRow label={t('skillSource')}>
+      <Pill ok={enabled} label={t(enabled ? 'enabled' : 'disabled')} />
+      <span className="apr-mono">
+        {t(skill.source === 'updated' ? 'skillUpdated' : 'skillBundled')}
+      </span>
+      <span className="apr-hint">
+        {t('skillFiles')} {skill.files}
+        {version}
+      </span>
+      {skill.updatedAt === null ? null : (
+        <span className="apr-hint">
+          {t('updatedAt')} {skill.updatedAt}
+        </span>
+      )}
+    </StatusRow>
+  )
+}
+
+/** reverse-skill（GitHub 源）状态。 */
+function ReverseRows(props: {
+  t: Translate
+  reverse: ReverseSkillDto
+  enabled: boolean
+}): ReactElement {
+  const { t, reverse, enabled } = props
+  const active = reverse.activeGroups.length === 0 ? '—' : reverse.activeGroups.join(', ')
+  const all = reverse.groups.length === 0 ? '—' : reverse.groups.join(', ')
+  return (
+    <>
+      <StatusRow label={t('reverseSource')}>
+        <Pill ok={reverse.installed} label={t(reverse.installed ? 'installed' : 'notInstalled')} />
+        <span className="apr-mono">{reverse.repo}</span>
+        {reverse.sha === null ? null : (
+          <span className="apr-hint">
+            {t('reverseCommit')} {reverse.sha.slice(0, 12)}
+            {reverse.version === null ? '' : ` · v${reverse.version}`}
+          </span>
+        )}
+      </StatusRow>
+      <StatusRow label={t('reverseGroups')}>
+        <Pill ok={enabled} label={t(enabled ? 'enabled' : 'disabled')} />
+        <span className="apr-mono">{active}</span>
+        <span className="apr-hint">
+          {t('reverseGroupsHint')} {all}
+        </span>
+      </StatusRow>
+      <StatusRow label={t('reversePath')}>
+        <code className="apr-mono">{reverse.tree}</code>
+        {reverse.updatedAt === null ? null : (
+          <span className="apr-hint">
+            {t('updatedAt')} {reverse.updatedAt}
+          </span>
+        )}
+      </StatusRow>
+    </>
+  )
+}
+
+/** 只读状态表：REA 包 / MCP 行 / REA skill / reverse-skill。 */
+function StatusTable(props: { t: Translate; status: StatusDto }): ReactElement {
+  const { t, status } = props
+  return (
+    <dl className="apr-install">
+      <InstallRows t={t} status={status} />
+      <SkillRows t={t} skill={status.skill} enabled={status.config.skillEnabled} />
+      <ReverseRows t={t} reverse={status.reverse} enabled={status.config.reverseSkillEnabled} />
     </dl>
   )
 }
 
+/** 动作按钮行。 */
+function ActionRow(props: {
+  t: Translate
+  busy: boolean
+  running: boolean
+  disabled: boolean
+  proxyPort: number | null
+  onAction(kind: 'install' | 'skill' | 'reverse'): void
+  onCancel(): void
+}): ReactElement {
+  const { t, busy, running, disabled, proxyPort, onAction, onCancel } = props
+  const blocked = disabled || busy || running || proxyPort === null
+  return (
+    <div className="apr-btnRow">
+      <Button
+        prefix="apr"
+        variant="primary"
+        label={t('installAction')}
+        disabled={blocked}
+        onClick={() => onAction('install')}
+      />
+      <Button
+        prefix="apr"
+        label={t('skillAction')}
+        disabled={blocked}
+        onClick={() => onAction('skill')}
+      />
+      <Button
+        prefix="apr"
+        label={t('reverseAction')}
+        disabled={blocked}
+        onClick={() => onAction('reverse')}
+      />
+      {running ? (
+        <Button prefix="apr" label={t('cancelAction')} disabled={busy} onClick={onCancel} />
+      ) : null}
+    </div>
+  )
+}
+
 export interface InstallSectionProps {
   t: Translate
   /** 设置只读（不可写）时禁用全部动作。 */
@@ -215,7 +331,6 @@ export function InstallSection(props: InstallSectionProps): ReactElement {
     [load, t],
   )
 
-  const blocked = disabled || busy || running === true
   const job = status?.job ?? null
   return (
     <section className="apr-field">
@@ -235,35 +350,19 @@ export function InstallSection(props: InstallSectionProps): ReactElement {
       ) : (
         <>
           <StatusTable t={t} status={status} />
-          <div className="apr-btnRow">
-            <Button
-              prefix="apr"
-              variant="primary"
-              label={t('installAction')}
-              disabled={blocked || proxyPort === null}
-              onClick={() => {
-                runAction(() => startJob('install', proxyPort ?? 0))
-              }}
-            />
-            <Button
-              prefix="apr"
-              label={t('skillAction')}
-              disabled={blocked || proxyPort === null}
-              onClick={() => {
-                runAction(() => startJob('skill', proxyPort ?? 0))
-              }}
-            />
-            {running === true ? (
-              <Button
-                prefix="apr"
-                label={t('cancelAction')}
-                disabled={busy}
-                onClick={() => {
-                  runAction(() => cancelJob())
-                }}
-              />
-            ) : null}
-          </div>
+          <ActionRow
+            t={t}
+            busy={busy}
+            running={running === true}
+            disabled={disabled}
+            proxyPort={proxyPort}
+            onAction={(kind) => {
+              runAction(() => startJob(kind, proxyPort ?? 0))
+            }}
+            onCancel={() => {
+              runAction(() => cancelJob())
+            }}
+          />
         </>
       )}
       {job === null ? null : <JobPanel t={t} job={job} />}

package/src/client/styles.ts

@@ -24,6 +24,14 @@ const extraCss = `
 .apr-textarea:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
 .apr-textarea:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
 .apr-textarea::placeholder{color:var(--dsw-alias-label-tertiary)}
+.apr-textarea:read-only{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2)}
+.apr-modes{display:flex;gap:6px;margin:0 0 8px}
+.apr-mode{font:inherit;font-size:12px;line-height:20px;padding:2px 10px;border-radius:999px;cursor:pointer;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover);border:1px solid transparent;transition:color .18s,background .18s,border-color .18s}
+.apr-mode:hover:not(:disabled){color:var(--dsw-alias-label-primary)}
+.apr-mode-on{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-brand-primary)}
+.apr-mode:disabled{cursor:default;opacity:.6}
+.apr-link{font:inherit;font-size:12px;padding:0;border:0;background:none;color:var(--dsw-alias-brand-primary);cursor:pointer;text-decoration:underline}
+.apr-link:disabled{cursor:default;opacity:.6}
 .apr-btnRow{display:flex;flex-wrap:wrap;gap:8px;margin-top:10px}
 .apr-install{margin:6px 0 0;padding:0;display:flex;flex-direction:column;gap:6px}
 .apr-installRow{display:flex;gap:10px;align-items:baseline;flex-wrap:wrap}

package/src/client/toggles.tsx

@@ -0,0 +1,57 @@
+/**
+ * 卡片的「能力开关」区：三个一键开关（REA MCP 行 / REA 官方 skill / reverse-skill
+ * 技能包）。三者都是活动字段，保存后本预设换代注册——新建会话按新装配起（REA 工具
+ * 与 skill 根的有无），已存在会话保持既有装配。
+ *
+ * 开关只管「挂不挂」，不管「装没装」：关掉不会删磁盘上的安装副本（更新/回滚仍是
+ * 显式动作，见 install.tsx）。
+ * @module agent-preset-rea/client/toggles
+ */
+import { CheckRow } from '@dsh-plus/shared/client'
+import type { ReactElement } from 'react'
+
+import type { Draft } from './draft.ts'
+import type { Translate } from './i18n.ts'
+
+/** 三个开关的键与文案键。 */
+const TOGGLES = [
+  { field: 'mcpEnabled', id: 'apr-toggle-mcp', label: 'toggleMcp', hint: 'toggleMcpHint' },
+  { field: 'skillEnabled', id: 'apr-toggle-skill', label: 'toggleSkill', hint: 'toggleSkillHint' },
+  {
+    field: 'reverseSkillEnabled',
+    id: 'apr-toggle-reverse',
+    label: 'toggleReverse',
+    hint: 'toggleReverseHint',
+  },
+] as const
+
+export interface ToggleSectionProps {
+  t: Translate
+  draft: Draft
+  disabled: boolean
+  onEdit(patch: Partial<Draft>): void
+}
+
+export function ToggleSection(props: ToggleSectionProps): ReactElement {
+  const { t, draft, disabled, onEdit } = props
+  return (
+    <section className="apr-field">
+      <div className="apr-head">
+        <span className="apr-label">{t('toggleSection')}</span>
+      </div>
+      {TOGGLES.map((toggle) => (
+        <div key={toggle.field}>
+          <CheckRow
+            prefix="apr"
+            id={toggle.id}
+            label={t(toggle.label)}
+            checked={draft[toggle.field]}
+            disabled={disabled}
+            onEdit={(checked) => onEdit({ [toggle.field]: checked })}
+          />
+          <p className="apr-hint">{t(toggle.hint)}</p>
+        </div>
+      ))}
+    </section>
+  )
+}

package/src/config.ts

@@ -5,14 +5,16 @@
  * 与 settings 用户层（GUI 配置卡片写入 profile 行级覆盖层，loader 原位提交活动
  * 引用，消费端 `unwrapVolatile` 现取即热）。
  *
- * **活动字段只有两个**：`personaPrefix` 与 `proxyPort`——两者都在配置卡片里有编辑器
- * （见 src/client/card.tsx），保存即热更（预设换代 / 安装作业即时生效）。其余字段是
- * **部署方平面**（安装位置、超时、附加 skill 根等运维旋钮），由 `cordis.patch.yml`
- * 整体覆盖，GUI 不提供入口。
+ * **活动字段（`.volatile()`）共六个**，全部在配置卡片里有编辑器（见 src/client/card.tsx）：
+ * `personaPrefixMode` / `personaPrefix`（提示词来源与正文）、`proxyPort`（安装代理）、
+ * `mcpEnabled` / `skillEnabled` / `reverseSkillEnabled`（三个能力开关）——保存即热更
+ * （预设换代，新建会话生效）。其余字段是**部署方平面**（受管目录、版本钉、skill 组、
+ * 超时等运维旋钮），由 `cordis.patch.yml` 整体覆盖，GUI 不提供入口。
  *
- * **persona 默认为空串**：`dsh-persona` 的空模板照样遮蔽部署级 persona 段，
- * 渲染为空后在提示词里消失；官方装配（harness 身份、工具指引、项目指令、
- * 运行时上下文）不受影响。
+ * **persona 默认为随包内置提示词**（见 src/persona-prefix.ts）：`personaPrefixMode`
+ * 默认 `default`，`persona` 行写入内置文本；切到 `custom` 才由 `personaPrefix` 供文本。
+ * 该行只遮蔽**部署级 persona 段**（`deployment:persona-prefix`，order 0），官方装配
+ * （harness 身份、工具指引、项目指令、运行时上下文）不受影响。
  *
  * 预设 id 固定为 `rea`（注册表身份，不开放覆盖——改 id 等于换预设，
  * default/selectedDefault 等引用都会落空）。
@@ -23,6 +25,7 @@ import type { UnwrapVolatile } from '@dsh-plus/shared'
 
 import { INPUT_SCHEMA_PROFILES, OUTPUT_SCHEMA_PROFILES, REA_PINNED_VERSION } from './mcp.ts'
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
+import { DEFAULT_PERSONA_PREFIX } from './persona-prefix.ts'
 
 /** settings 命名空间（字面量即合法命名空间；配置卡片与运行期读取同一份）。 */
 export const SETTINGS_NS = NS_LITERAL
@@ -37,20 +40,67 @@ export const Config = z.object({
     .string()
     .description('预设说明（设置 → Agent 预设卡片描述）')
     .default(
-      '逆向工程预设：官方 standard 全量行 + 仅本预设可见的 REA MCP 客户端（mcp__rea__*）与随包 REA 官方 skill；persona 默认为空，工具指引沿用官方装配。',
+      '逆向工程预设：官方 standard 全量行 + 仅本预设可见的 REA MCP 客户端（mcp__rea__*）与随包 REA 官方 skill；persona 默认取随包内置提示词，工具指引沿用官方装配。',
     ),
   order: z.number().description('预设名册排序位').default(6),
+  personaPrefixMode: z
+    .union(['default', 'custom'])
+    .description(
+      'persona 前缀来源：default = 随包内置提示词（src/persona-prefix.ts），custom = 取 personaPrefix 的用户文本',
+    )
+    .default('default')
+    .volatile(),
   personaPrefix: z
     .string()
     .description(
-      'persona 前缀（system-prompt 的 deployment:persona-prefix 段）；留空 = 空 persona（该段渲染为空后消失），工具指引与运行时上下文保留',
+      'persona 前缀正文（system-prompt 的 deployment:persona-prefix 段）；仅 personaPrefixMode=custom 时生效，空值回落内置提示词',
     )
-    .default('')
+    .default(DEFAULT_PERSONA_PREFIX)
     .volatile(),
+  capabilityProtocol: z
+    .string()
+    .description(
+      '追加到 persona 前缀正文末尾的「能力选用协议」段（任务驱动挑选技能与 MCP；部署方平面，空串 = 不追加）',
+    )
+    .default(''),
+  subagentDirective: z
+    .string()
+    .description(
+      '追加到 persona 前缀正文末尾的「子代理指令继承」段（派发 brief 时须浓缩继承本节规则；部署方平面，空串 = 不追加）',
+    )
+    .default(''),
   mcpEnabled: z
     .boolean()
     .description('是否挂 REA MCP 客户端行（false = 只保留预设其余能力）')
-    .default(true),
+    .default(true)
+    .volatile(),
+  skillEnabled: z
+    .boolean()
+    .description('是否把 REA 官方 skill 根挂进本预设（false = 模型只看到其余 skill 根）')
+    .default(true)
+    .volatile(),
+  reverseSkillEnabled: z
+    .boolean()
+    .description(
+      '是否挂 zhaoxuya520/reverse-skill 技能包（false = 从本预设的 skill 根里摘掉，安装副本仍在）',
+    )
+    .default(true)
+    .volatile(),
+  reverseSkillRepo: z
+    .string()
+    .pattern(/^[\w.-]+\/[\w.-]+$/)
+    .description('reverse-skill 仓库（<owner>/<repo>；安装/手动更新都从这里拉）')
+    .default('zhaoxuya520/reverse-skill'),
+  reverseSkillRef: z
+    .string()
+    .description('reverse-skill 的 ref（分支/标签/提交；留空 = 仓库默认分支的最新提交）')
+    .default(''),
+  reverseSkillGroups: z
+    .array(z.string())
+    .description(
+      'reverse-skill 里挂进本预设的技能组（相对安装树根；默认只挂主包根 skills——含路由技能与全部模块技能，CTF 侧车等组按需追加）',
+    )
+    .default(['skills']),
   mcpServerName: z
     .string()
     .pattern(/^[A-Za-z0-9_-]{1,32}$/)

package/src/definition.ts

@@ -7,11 +7,18 @@
  * tests/upstream-mirror.test.ts 会逼出对齐。本预设不丢任何上游行（与 lean 相反）。
  *
  * 增量仅三处，测试按 {@link ADDED_ROWS} / {@link CONFIG_DELTAS} 白名单放行：
- * 1. `persona` 行 `prefix` 取配置值（默认空串 = 空 persona）；
- * 2. `skill-filesystem` 行加 `customSkillDirs`（随包 REA skill 或手动更新副本 + 追加目录）；
+ * 1. `persona` 行 `prefix` 取 `resolvePersonaPrefix()`（默认随包内置提示词；
+ *    `personaPrefixMode=custom` 时才取用户文本）；
+ * 2. `skill-filesystem` 行加 `customSkillDirs`（REA skill 源与 reverse-skill 技能组，
+ *    各受一个活动开关控制，另加部署方 `extraSkillDirs`）；
  * 3. 新增 `mcp-rea` 行：官方 MCP 客户端连 REA stdio 服务，落在本预设作用域内；
  *    **未安装 REA 时该行 `disabled`**（不 spawn npx，见 mcp.ts 的说明）。
  *
+ * 注入点固定在 `persona` 行：官方 `dsh-persona` 为该行注册 `deployment:persona-prefix`
+ * 段（order 0，早于全部工具指引段），且 README 明确这一行是 preset 改身份的**唯一**
+ * 入口——部署级 `system-prompt` 行归宿主平面，本预设不挂、也挂不上（作用域外挂载会与
+ * 注册表自身的 persona 注册相撞并报错）。
+ *
  * {@link RuntimeSnapshot} 是运行期事实（受管安装与 skill 来源），由 manager 现探后
  * 传入；不传即「未安装 + 随包 skill」，测试据此断言两种形态。
  *
@@ -23,8 +30,10 @@ import type { PresetDefinition } from '@deepseek-ai/dsh-agent-preset-registry'
 import type { AgentPresetReaConfig } from './config.ts'
 import type { RuntimeSnapshot } from './manager.ts'
 import { DEFAULT_MCP_COMMAND, reaMcpArgs, reaMcpEnv, reaMcpLaunch } from './mcp.ts'
+import { resolvePersonaPrefix } from './persona-prefix.ts'
 import { PLAN_MODE_SECTION } from './prompt.ts'
-import { BUNDLED_SKILL_ROOT, reaSkillDirs } from './skill.ts'
+import { emptyReverseState } from './reverse.ts'
+import { BUNDLED_SKILL_ROOT, presetSkillDirs } from './skill.ts'
 
 /** 预设注册表身份（改 id 等于换预设，default 等引用都会落空）。 */
 export const REA_PRESET_ID = 'rea'
@@ -32,6 +41,9 @@ export const REA_PRESET_ID = 'rea'
 /** 相对上游 `standard` 新增的行 id（镜像测试按此白名单放行自造行）。 */
 export const ADDED_ROWS: readonly string[] = ['mcp-rea']
 
+/** 声明必须具备的组行 id（缺一即注册前失败，见 {@link assertRequiredRows}）。 */
+const REQUIRED_GROUP_ROWS: readonly string[] = ['planning', 'compaction', 'delegation']
+
 /**
  * 已镜像行 → 允许偏离上游的字段名（其余字段必须逐字一致）。
  * 删除某条等于把该行改回上游原文；改动上游不存在的字段会被测试拦下。
@@ -41,6 +53,25 @@ export const CONFIG_DELTAS: Readonly<Record<string, readonly string[]>> = {
   'skill-filesystem': ['customSkillDirs'],
 }
 
+/**
+ * 最小（或极简）预设 id 判定：命中时注入文本需做减法适配。
+ *
+ * 判定面与上游预设命名惯例一致（`minimal` / `sdk-minimal` / `<x>/minimal` /
+ * 含 `preset-minimal`），不引入自造 id 概念。
+ */
+export function isMinimalPresetId(id: string | undefined): boolean {
+  const value = String(id ?? '')
+    .trim()
+    .toLowerCase()
+  if (value === '') return false
+  return (
+    value === 'minimal' ||
+    value === 'sdk-minimal' ||
+    value.endsWith('/minimal') ||
+    value.includes('preset-minimal')
+  )
+}
+
 /** 平台门控表达式：与上游 `standard` 预设逐字相同，Windows 上由 pwsh 顶替 bash。 */
 const WINDOWS_ONLY = { __jsExpr: "process.platform === 'win32'" } as const
 const POSIX_ONLY = { __jsExpr: "process.platform !== 'win32'" } as const
@@ -58,6 +89,7 @@ export function emptyRuntime(): RuntimeSnapshot {
       files: 0,
       updatedAt: null,
     },
+    reverse: emptyReverseState(),
   }
 }
 
@@ -70,12 +102,13 @@ type Row = PresetDefinition['plugins'][number]
  */
 function baseRows(config: AgentPresetReaConfig, runtime: RuntimeSnapshot): Row[] {
   return [
-    // 身份：沿用官方装配（非 complete、保留运行时上下文），前缀取配置（默认空串：
-    // 空模板照样遮蔽部署级 persona 段，渲染为空后消失，不追加任何自有文案）。
+    // 身份：沿用官方装配（非 complete、保留运行时上下文）。前缀来源见
+    // resolvePersonaPrefix：默认随包内置提示词，custom 模式才取用户文本。
+    // 该行注册 deployment:persona-prefix 段（order 0），遮蔽部署级 persona 而不动工具指引。
     {
       id: 'persona',
       name: '@deepseek-ai/dsh-persona',
-      config: { prefix: config.personaPrefix },
+      config: { prefix: resolvePersonaPrefix(config) },
     },
     // 项目指令（AGENTS.md）与逐步时钟上下文（默认 10 分钟一条）。
     {
@@ -102,10 +135,7 @@ function baseRows(config: AgentPresetReaConfig, runtime: RuntimeSnapshot): Row[]
       id: 'skill-filesystem',
       name: '@deepseek-ai/dsh-skill-filesystem',
       config: {
-        customSkillDirs: reaSkillDirs(
-          config,
-          runtime.skill.source === 'updated' ? runtime.skill.root : null,
-        ),
+        customSkillDirs: presetSkillDirs(config, runtime),
       },
     },
     { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
@@ -220,11 +250,28 @@ function orchestrationRows(config: AgentPresetReaConfig, runtime: RuntimeSnapsho
       },
     },
     { id: 'present', name: '@deepseek-ai/dsh-tool-present' },
-    // 宿主插件管理：上游 standard 里同样是 disabled 行。
+    // 宿主插件管理与插件市场：上游 standard 里同样是 disabled 行。
     { id: 'tool-plugin-manager', name: '@deepseek-ai/dsh-plugin-manager/tools', disabled: true },
+    { id: 'tool-plugin-market', name: '@deepseek-ai/dsh-plugin-market/tools', disabled: true },
   ]
 }
 
+/**
+ * 声明必备行自检：功能面缺行时在注册前失败，而不是静默少能力。
+ *
+ * 与 tests/upstream-mirror.test.ts 的分工：夹具测试守「偏离上游」，
+ * 这里守「本预设必须自带的组行与增量行」——上游升版把某组行改名或
+ * 本文件误删一行时，注册表挂载前就能看到明确错误。
+ * @param rows - 展开前后的顶层行清单。
+ */
+function assertRequiredRows(rows: readonly Row[]): void {
+  const ids = new Set(rows.map((row) => String(row.id)))
+  const missing = [...REQUIRED_GROUP_ROWS, ...ADDED_ROWS].filter((id) => !ids.has(id))
+  if (missing.length > 0) {
+    throw new Error(`rea 预设声明缺少必备行：${missing.join(', ')}`)
+  }
+}
+
 /**
  * 由配置 + 运行期事实拼出注册表声明。
  * @param config - 已验证的插件配置。
@@ -235,11 +282,13 @@ export function reaPresetDefinition(
   config: AgentPresetReaConfig,
   runtime: RuntimeSnapshot = emptyRuntime(),
 ): PresetDefinition {
+  const plugins = [...baseRows(config, runtime), ...orchestrationRows(config, runtime)]
+  assertRequiredRows(plugins)
   return {
     id: REA_PRESET_ID,
     name: config.name,
     description: config.description,
     order: config.order,
-    plugins: [...baseRows(config, runtime), ...orchestrationRows(config, runtime)],
+    plugins,
   }
 }