@dsh-plus/agent-preset-rea 0.0.0-stage → 0.1.0

package/src/client/client.ts

@@ -0,0 +1,51 @@
+/**
+ * 浏览器半入口：注册 locale 字典 + 注册「逆向工程预设」配置卡片
+ * （injectPluginConfigCard 两槽位：插件页 plugins.row.config / plugins.bundle.config）。
+ * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
+ * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
+ *
+ * 卡片只编辑 `personaPrefix`（宿主半唯一的活动字段）；配置读写经共享层直连
+ * `ctx.remote.settings`（官方 `settingsScope` 服务不存在、由 `configForms` 取代），
+ * 与 notify-email 同机制。
+ * @module @dsh-plus/agent-preset-rea/client
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import {
+  createNamespaceApi,
+  createSettingsScope,
+  injectPluginConfigCard,
+  type PluginClientContext,
+} from '@dsh-plus/shared/client'
+import { SETTINGS_NS } from '../ns.ts'
+import { ReaCard } from './card.tsx'
+import { type DictKey, en, NS, zh } from './i18n.ts'
+import { injectStyle, PLUGIN_ID } from './styles.ts'
+
+export const name = 'dsh-plus-agent-preset-rea'
+
+/** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
+export const inject = ['slots', 'locale', 'remote', 'remote.settings'] as const
+
+/** 宿主窄面收编在 @dsh-plus/shared/client；TKey 传入本包 DictKey 使键名受检。 */
+type ClientContext = PluginClientContext<DictKey>
+
+export function apply(ctx: Context): void {
+  const c = ctx as unknown as ClientContext
+  const tag = injectStyle()
+  c.effect(
+    () => () => {
+      tag?.remove()
+    },
+    'agent-preset-rea: style',
+  )
+  c.effect(() => c.locale.register(NS, { zh, en }), 'agent-preset-rea: locale')
+  const scope = createSettingsScope(c, SETTINGS_NS, 'agent-preset-rea: settings scope')
+  const api = createNamespaceApi(c.get('remote').settings, SETTINGS_NS)
+  injectPluginConfigCard(c.slots, {
+    ns: SETTINGS_NS,
+    rowId: 'dsh-plus-agent-preset-rea',
+    pkg: PLUGIN_ID,
+    component: ReaCard,
+    inject: () => ({ t: c.locale.bind(NS), scope, api }),
+  })
+}

package/src/client/draft.ts

@@ -0,0 +1,28 @@
+/**
+ * 卡片草稿的纯逻辑（无 JSX，node --test 可直接测）：命名空间解析值 ⇄ 编辑草稿。
+ *
+ * 命名空间值是整行配置的脱敏视图（本卡片只编辑 `personaPrefix`，其余字段属
+ * 部署方平面，不进卡片），因此读取时按字段收窄：值缺席或类型不符一律回落到
+ * 空串（= 空 persona），保存时只回写这一个字段（settings.update 深合并）。
+ * @module agent-preset-rea/client/draft
+ */
+
+/** 命名空间解析值中本卡片消费的部分。 */
+export interface ConfigValue {
+  personaPrefix?: unknown
+}
+
+/** 编辑草稿。 */
+export interface Draft {
+  personaPrefix: string
+}
+
+/** 解析值 → 草稿（非字符串一律视为空串）。 */
+export function draftFromValue(value: ConfigValue): Draft {
+  return { personaPrefix: typeof value.personaPrefix === 'string' ? value.personaPrefix : '' }
+}
+
+/** 草稿 → 提交形状（只回写本卡片负责的字段）。 */
+export function toPatch(draft: Draft): Record<string, unknown> {
+  return { personaPrefix: draft.personaPrefix }
+}

package/src/client/i18n.ts

@@ -0,0 +1,43 @@
+/**
+ * 配置卡片文案（zh/en）。经 ctx.locale.register 注册、bind 取用，与官方卡片同机制。
+ * 公共键（save/discard/unsaved 等）来自 shared 的 common 字典，本文件只维护业务键。
+ * @module @dsh-plus/agent-preset-rea/client/i18n
+ */
+import { commonEn, commonZh, mergeDict } from '@dsh-plus/shared/client'
+
+export const NS = 'dsh-plus-agent-preset-rea'
+
+const ownZh = {
+  title: '逆向工程预设',
+  description: 'REA 提示词：留空即空 persona，工具指引与运行时上下文照常由官方装配注入。',
+  summaryLine: '编辑「逆向工程」预设的 persona 提示词',
+  prompt: '系统提示词（persona 前缀）',
+  promptHint:
+    '写入 system-prompt 的 persona 前缀段，仅对「逆向工程」预设的新会话生效；留空 = 不注入 persona 段（官方工具指引、项目指令与运行时上下文不受影响）。保存后新建会话即用新值。',
+  promptPlaceholder: '例如：先做证据分级，再动手改二进制；每一步给出可复核的证据链……',
+  promptEmpty: '当前为空：该预设不注入 persona 段。',
+  saveFailed: '保存失败：',
+} as const
+
+const ownEn = {
+  title: 'Reverse-engineering preset',
+  description:
+    'REA prompt: leave it empty for a blank persona; official tool guidance and runtime context stay in place.',
+  summaryLine: 'Edit the persona prompt of the “逆向工程” preset',
+  prompt: 'System prompt (persona prefix)',
+  promptHint:
+    'Written to the persona-prefix section of the system prompt for new sessions of this preset only. Empty means no persona section (official tool guidance, project instructions and runtime context are unaffected). New sessions pick up the saved value.',
+  promptPlaceholder:
+    'e.g. Grade the evidence first, then patch the binary; every step needs a checkable chain of evidence…',
+  promptEmpty: 'Currently empty: this preset injects no persona section.',
+  saveFailed: 'Save failed: ',
+} as const
+
+export type DictKey = keyof typeof commonZh | keyof typeof ownZh
+
+/** 卡片共用的翻译函数类型（slot 注入的 bind 结果按此消费）。 */
+export type Translate = (key: DictKey) => string
+
+// 标注为 Record<DictKey, string>：en 缺任一键即编译期报错（中英强制对齐）。
+export const zh: Record<DictKey, string> = mergeDict(commonZh, ownZh)
+export const en: Record<DictKey, string> = mergeDict(commonEn, ownEn)

package/src/client/styles.ts

@@ -0,0 +1,32 @@
+/**
+ * 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('apr')，
+ * 本文件只补插件特有规则（提示词多行输入框）。
+ * 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
+ * @module agent-preset-rea/client/styles
+ */
+import { cardCss, injectCardStyle } from '@dsh-plus/shared/client'
+
+export const PLUGIN_ID = '@dsh-plus/agent-preset-rea'
+
+/**
+ * 多行提示词输入框：度量对齐官方 settings-form 的 textarea
+ * （与 -input 同边框/底色/圆角，正文 13px/1.6），窄屏 16px 防 iOS 聚焦缩放、
+ * 纵向可拖拽但不横向溢出。
+ */
+const extraCss = `
+.apr-textarea{box-sizing:border-box;width:100%;min-height:180px;resize:vertical;font:inherit;font-size:13px;line-height:1.6;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:10px 12px;transition:border-color .18s,background .18s}
+.apr-textarea:hover:not(:disabled):not(:focus-visible){border-color:var(--dsw-alias-label-dimmed)}
+.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)}
+@media (max-width:767px){
+.apr-textarea{font-size:16px;min-height:140px}
+}
+`
+
+export const cardCssAll = cardCss('apr', extraCss)
+
+/** 幂等注入样式标签；返回标签（已存在或环境无 document 时为 null）。 */
+export function injectStyle(): HTMLStyleElement | null {
+  return injectCardStyle(PLUGIN_ID, cardCssAll)
+}

package/src/config.ts

@@ -0,0 +1,110 @@
+/**
+ * 插件配置（schemastery）：显示面、persona、REA MCP 行与 skill 根外部化。
+ *
+ * 单一事实源同时充当两处：cordis 行级 `Config`（组合默认，profile patch 层可覆盖）
+ * 与 settings 用户层（GUI 配置卡片写入 profile 行级覆盖层，loader 原位提交活动
+ * 引用，消费端 `unwrapVolatile` 现取即热）。
+ *
+ * **只有 `personaPrefix` 标 `.volatile()`**：它是对用户的承诺（配置卡片必须给出
+ * 编辑器，见 src/client/card.tsx），也是本预设里唯一需要热更的字段；其余字段是
+ * **部署方平面**（MCP 参数、超时、附加 skill 根等运维旋钮），由 `cordis.patch.yml`
+ * 整体覆盖，GUI 不提供入口。
+ *
+ * **persona 默认为空串**：`dsh-persona` 的空模板照样遮蔽部署级 persona 段，
+ * 渲染为空后在提示词里消失；官方装配（harness 身份、工具指引、项目指令、
+ * 运行时上下文）不受影响。
+ *
+ * 预设 id 固定为 `rea`（注册表身份，不开放覆盖——改 id 等于换预设，
+ * default/selectedDefault 等引用都会落空）。
+ * @module @dsh-plus/agent-preset-rea/config
+ */
+import z from '@deepseek-ai/schemastery'
+import type { UnwrapVolatile } from '@dsh-plus/shared'
+
+import {
+  DEFAULT_MCP_COMMAND,
+  INPUT_SCHEMA_PROFILES,
+  OUTPUT_SCHEMA_PROFILES,
+  REA_PINNED_VERSION,
+} from './mcp.ts'
+import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
+
+/** settings 命名空间（字面量即合法命名空间；配置卡片与运行期读取同一份）。 */
+export const SETTINGS_NS = NS_LITERAL
+
+export const Config = z.object({
+  enabled: z
+    .boolean()
+    .description('总开关（false = 不注册 rea 预设，等价插件未安装）')
+    .default(true),
+  name: z.string().description('预设显示名（设置 → Agent 预设卡片标题）').default('逆向工程'),
+  description: z
+    .string()
+    .description('预设说明（设置 → Agent 预设卡片描述）')
+    .default(
+      '逆向工程预设：官方 standard 全量行 + 仅本预设可见的 REA MCP 客户端（mcp__rea__*）与随包 REA 官方 skill；persona 默认为空，工具指引沿用官方装配。',
+    ),
+  order: z.number().description('预设名册排序位').default(6),
+  personaPrefix: z
+    .string()
+    .description(
+      'persona 前缀（system-prompt 的 deployment:persona-prefix 段）；留空 = 空 persona（该段渲染为空后消失），工具指引与运行时上下文保留',
+    )
+    .default('')
+    .volatile(),
+  mcpEnabled: z
+    .boolean()
+    .description('是否挂 REA MCP 客户端行（false = 只保留预设其余能力）')
+    .default(true),
+  mcpServerName: z
+    .string()
+    .pattern(/^[A-Za-z0-9_-]{1,32}$/)
+    .description(
+      'MCP 服务命名空间：模型面工具名为 mcp__<serverName>__<tool>，取值 [A-Za-z0-9_-]{1,32}',
+    )
+    .default('rea'),
+  reaVersion: z
+    .string()
+    .description('钉版的 rea-agents 版本（npx 拉取）')
+    .default(REA_PINNED_VERSION),
+  mcpCommand: z
+    .string()
+    .description('MCP stdio 可执行文件；Windows 需 cmd.exe 配方，见包文档')
+    .default(DEFAULT_MCP_COMMAND),
+  mcpArgs: z
+    .array(z.string())
+    .description('MCP stdio 参数；留空 = 按 reaVersion 派生 ["-y","rea-agents@<version>","mcp"]')
+    .default([]),
+  inputSchemaProfile: z
+    .union(INPUT_SCHEMA_PROFILES)
+    .description(
+      'REA 工具入参 schema 广告档位（REA_MCP_INPUT_SCHEMA_PROFILE）：compact 压体积，full 与上游默认一致',
+    )
+    .default('compact'),
+  outputSchemaProfile: z
+    .union(OUTPUT_SCHEMA_PROFILES)
+    .description(
+      'REA 工具出参 schema 广告档位（REA_MCP_OUTPUT_SCHEMA_PROFILE）：off 不下发（结果仍由 REA 校验），full 与上游默认一致',
+    )
+    .default('off'),
+  toolCallTimeoutMs: z
+    .number()
+    .description('单次 MCP 工具调用超时（毫秒）；REA 分析类调用常超默认 60 秒')
+    .default(600_000),
+  failOnStartupError: z
+    .boolean()
+    .description(
+      'MCP 初次连接/同步失败是否让本行激活失败；默认 false：只记日志并按退避重连，不拖垮 boot',
+    )
+    .default(false),
+  extraSkillDirs: z
+    .array(z.string())
+    .description('附加 skill 根目录（随本预设作用域生效，其他预设不可见）')
+    .default([]),
+})
+
+/** 活动字段形态（loader 解析产物：`personaPrefix` 为活动引用）。 */
+export type AgentPresetReaConfigFields = Schemastery.TypeT<typeof Config>
+
+/** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
+export type AgentPresetReaConfig = UnwrapVolatile<AgentPresetReaConfigFields>

package/src/definition.ts

@@ -0,0 +1,188 @@
+/**
+ * 逆向工程预设声明组装：官方 `standard` 预设**全量行**的逐字镜像 + 三处显式增量。
+ *
+ * 镜像：每条上游行的 `id`/`name`/`config`（含平台门控 `!!js` 表达式与 plan-mode
+ * 段落原文）都与 `@deepseek-ai/dsh-web-app` 的 `presets/standard.patch.yml` 逐字一致；
+ * 上游改用新版本后按 docs/ops/新版适配流程.md 刷新夹具，
+ * tests/upstream-mirror.test.ts 会逼出对齐。本预设不丢任何上游行（与 lean 相反）。
+ *
+ * 增量仅三处，测试按 {@link ADDED_ROWS} / {@link CONFIG_DELTAS} 白名单放行：
+ * 1. `persona` 行 `prefix` 取配置值（默认空串 = 空 persona）；
+ * 2. `skill-filesystem` 行加 `customSkillDirs`（随包 REA skill + 配置追加目录）；
+ * 3. 新增 `mcp-rea` 行：官方 MCP 客户端连 REA stdio 服务，落在本预设作用域内。
+ *
+ * 组行必须带 `isolate` 归属 realm，否则注册表拒绝挂载（服务泄漏判定）。
+ * @module @dsh-plus/agent-preset-rea/definition
+ */
+import type { PresetDefinition } from '@deepseek-ai/dsh-agent-preset-registry'
+
+import type { AgentPresetReaConfig } from './config.ts'
+import { reaMcpArgs, reaMcpEnv } from './mcp.ts'
+import { PLAN_MODE_SECTION } from './prompt.ts'
+import { reaSkillDirs } from './skill.ts'
+
+/** 预设注册表身份（改 id 等于换预设，default 等引用都会落空）。 */
+export const REA_PRESET_ID = 'rea'
+
+/** 相对上游 `standard` 新增的行 id（镜像测试按此白名单放行自造行）。 */
+export const ADDED_ROWS: readonly string[] = ['mcp-rea']
+
+/**
+ * 已镜像行 → 允许偏离上游的字段名（其余字段必须逐字一致）。
+ * 删除某条等于把该行改回上游原文；改动上游不存在的字段会被测试拦下。
+ */
+export const CONFIG_DELTAS: Readonly<Record<string, readonly string[]>> = {
+  persona: ['prefix'],
+  'skill-filesystem': ['customSkillDirs'],
+}
+
+/** 平台门控表达式：与上游 `standard` 预设逐字相同，Windows 上由 pwsh 顶替 bash。 */
+const WINDOWS_ONLY = { __jsExpr: "process.platform === 'win32'" } as const
+const POSIX_ONLY = { __jsExpr: "process.platform !== 'win32'" } as const
+
+/** 官方 loader 的嵌套组行名。 */
+const GROUP = 'cordis:group'
+
+/**
+ * 由配置拼出注册表声明。
+ * @param config - 已验证的插件配置。
+ * @returns id 固定为 `rea` 的预设声明。
+ */
+export function reaPresetDefinition(config: AgentPresetReaConfig): PresetDefinition {
+  return {
+    id: REA_PRESET_ID,
+    name: config.name,
+    description: config.description,
+    order: config.order,
+    plugins: [
+      // 身份：沿用官方装配（非 complete、保留运行时上下文），前缀取配置（默认空串：
+      // 空模板照样遮蔽部署级 persona 段，渲染为空后消失，不追加任何自有文案）。
+      {
+        id: 'persona',
+        name: '@deepseek-ai/dsh-persona',
+        config: { prefix: config.personaPrefix },
+      },
+      // 项目指令（AGENTS.md）与逐步时钟上下文（默认 10 分钟一条）。
+      {
+        id: 'agent-instructions',
+        name: '@deepseek-ai/dsh-agent-instructions',
+        config: { maxBytes: 65536 },
+      },
+      { id: 'time-context', name: '@deepseek-ai/dsh-time-context' },
+      // shell：一次性执行，执行器在宿主平面；平台门控与上游一致。
+      { id: 'tool-bash', name: '@deepseek-ai/dsh-tool-bash', disabled: WINDOWS_ONLY },
+      { id: 'tool-pwsh', name: '@deepseek-ai/dsh-tool-pwsh', disabled: POSIX_ONLY },
+      // 文件读写、检索与后台任务控制。
+      { id: 'tool-fs', name: '@deepseek-ai/dsh-tool-fs' },
+      {
+        id: 'tool-fs-search',
+        name: '@deepseek-ai/dsh-tool-fs-search',
+        config: { sampleOverCapGlobResults: false },
+      },
+      { id: 'tool-jobs', name: '@deepseek-ai/dsh-tool-jobs' },
+      { id: 'tool-schedule', name: '@deepseek-ai/dsh-tool-schedule' },
+      // 技能：本地目录发现 + 模型面加载器；本预设额外挂上随包 REA 官方 skill 根
+      // （customSkillDirs 是 rank 300 的追加根，不动项目/用户/bundled 根）。
+      {
+        id: 'skill-filesystem',
+        name: '@deepseek-ai/dsh-skill-filesystem',
+        config: { customSkillDirs: reaSkillDirs(config) },
+      },
+      { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+      // 同会话目标：/goal 命令与模型面目标工具。
+      { id: 'command-goal', name: '@deepseek-ai/dsh-command-goal' },
+      { id: 'tool-goal', name: '@deepseek-ai/dsh-tool-goal' },
+      // 计划模式：状态天然属于单个 agent，条目级 realm 即正确生命周期。
+      {
+        id: 'planning',
+        name: GROUP,
+        group: true,
+        isolate: { planMode: true },
+        config: [
+          {
+            id: 'plan-mode',
+            name: '@deepseek-ai/dsh-plan-mode',
+            config: { section: PLAN_MODE_SECTION },
+          },
+        ],
+      },
+      // 压缩：token 计量器留在宿主平面，本组只挂读取它的后端与结果裁剪器。
+      {
+        id: 'compaction',
+        name: GROUP,
+        group: true,
+        isolate: { compaction: true, toolResultPruner: true },
+        config: [
+          { id: 'compaction-basic', name: '@deepseek-ai/dsh-compaction-basic' },
+          { id: 'command-compact', name: '@deepseek-ai/dsh-command-compact' },
+          {
+            id: 'tool-result-pruner',
+            name: '@deepseek-ai/dsh-compaction-tool-result-pruner',
+            config: { thresholdChars: 8192, headChars: 4096, tailChars: 1024 },
+          },
+        ],
+      },
+      // 委派与编排：子代理、fork、workflow 整组（编排引擎只在本 realm 内共享）。
+      {
+        id: 'delegation',
+        name: GROUP,
+        group: true,
+        isolate: { workflowEngine: true },
+        config: [
+          { id: 'tool-subagent-control', name: '@deepseek-ai/dsh-tool-subagent-control' },
+          {
+            id: 'tool-subagent-list-agents',
+            name: '@deepseek-ai/dsh-tool-subagent-control/list-agents',
+          },
+          {
+            id: 'tool-subagent',
+            name: '@deepseek-ai/dsh-tool-subagent',
+            config: { provider: 'spawn', toolName: 'subagent', modelSelectionSettings: true },
+          },
+          {
+            id: 'tool-subagent-fork',
+            name: '@deepseek-ai/dsh-tool-subagent',
+            config: { provider: 'fork', toolName: 'subagent_fork' },
+          },
+          {
+            id: 'workflow-ptc',
+            name: '@deepseek-ai/dsh-workflow-ptc',
+            config: { provider: 'spawn' },
+          },
+          { id: 'tool-workflow', name: '@deepseek-ai/dsh-tool-workflow' },
+        ],
+      },
+      // 其余模型面行。
+      { id: 'tool-ask-user', name: '@deepseek-ai/dsh-tool-ask-user' },
+      {
+        id: 'tool-todo',
+        name: '@deepseek-ai/dsh-tool-todo',
+        config: { allowParallelInProgress: true },
+      },
+      {
+        id: 'tool-web',
+        name: '@deepseek-ai/dsh-tool-web',
+        config: { fetch: true, searchTimeoutMs: 60000 },
+      },
+      // 本预设新增：REA MCP 客户端（stdio），工具以 mcp__<serverName>__<tool> 注册在
+      // 本预设作用域；服务名预留按作用域隔离，其他预设不受影响。
+      {
+        id: 'mcp-rea',
+        name: '@deepseek-ai/dsh-mcp-client',
+        disabled: !config.mcpEnabled,
+        config: {
+          transport: 'stdio',
+          serverName: config.mcpServerName,
+          command: config.mcpCommand,
+          args: reaMcpArgs(config),
+          env: reaMcpEnv(config),
+          toolCallTimeoutMs: config.toolCallTimeoutMs,
+          failOnStartupError: config.failOnStartupError,
+        },
+      },
+      { id: 'present', name: '@deepseek-ai/dsh-tool-present' },
+      // 宿主插件管理：上游 standard 里同样是 disabled 行。
+      { id: 'tool-plugin-manager', name: '@deepseek-ai/dsh-plugin-manager/tools', disabled: true },
+    ],
+  }
+}

package/src/index.ts

@@ -0,0 +1,95 @@
+/**
+ * dsh 服务插件：把「逆向工程」注册为官方 agent preset（id=`rea`）。
+ *
+ * 预设声明经 `ctx.agentPresets.register()` 注册（官方 preset registry 是唯一
+ * 读取方），出现在设置 → Agent 预设的名单里，可被会话选择。
+ *
+ * 预设语义：官方 `standard` 预设**全量行**的逐字镜像（shell/文件读写与检索/
+ * 后台任务/定时提醒/技能/目标/计划/压缩/委派与编排/提问/待办/联网/交付/插件管理
+ * 全在），另加三处显式增量——persona 前缀取配置（默认空串）、`skill-filesystem`
+ * 加随包 REA skill 根、新增 `mcp-rea` 行连 REA stdio 服务。详见 definition.ts。
+ *
+ * 作用域：三处增量都落在本预设声明内，因此 REA 工具（`mcp__rea__*`）、REA skill
+ * 与附加 skill 根只对该预设的会话可见；宿主平面不新增工具/提示段，其他预设不受
+ * 影响（见 docs/README.md 的隔离一节）。
+ *
+ * persona 提示词：`personaPrefix` 是活动字段（`.volatile()`），由设置 → 插件页
+ * 的配置卡片写入；保存后 loader 原位提交活动引用并广播 `loader/volatile-update`，
+ * 本插件据此换代注册（注销旧声明 → 按新值重建声明），**新建会话**即用新提示词，
+ * 已存在会话保持既有 composition（注册表语义：运行中会话的装配不随换代改变）。
+ *
+ * 设计取舍：
+ * - 独立插件而非 cordis.patch.yml 里的裸 `@deepseek-ai/dsh-agent-preset`
+ *   行：便于纳入本仓的构建/测试/文档体系，并把显示面与 MCP/skill 参数开放为
+ *   可覆盖配置；
+ * - 惰性 inject `agentPresets`：服务缺席的 profile（如 headless）里本行
+ *   照常 active、只是不注册（等价插件缺席），绝不因硬 inject 永久 pending
+ *   拖垮 boot（同 boot-retry 的教训）；
+ * - 注册与换代在 effect 内后台串行完成、不阻塞 apply：注册会同步挂载预设
+ *   子树并等待其激活（含 MCP 首次连接），await 在本行激活内可能与 Host 树推进
+ *   互锁；失败仅记 warn（重名、MCP 起不来等由各注册表/客户端负责诊断），
+ *   不使 boot 失败。
+ * @module @dsh-plus/agent-preset-rea
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import { unwrapVolatile } from '@dsh-plus/shared'
+
+import { type AgentPresetReaConfig, type AgentPresetReaConfigFields, Config } from './config.ts'
+import { reaPresetDefinition } from './definition.ts'
+import { createPresetRegistrar } from './registration.ts'
+
+export const name = 'dsh-plus-agent-preset-rea'
+
+/** 无硬 inject：agentPresets 经 apply 内惰性 inject 接线（缺席即空转）。 */
+export const inject = [] as const
+
+export { SETTINGS_NS } from './config.ts'
+export { ADDED_ROWS, CONFIG_DELTAS, REA_PRESET_ID, reaPresetDefinition } from './definition.ts'
+export {
+  DEFAULT_MCP_COMMAND,
+  INPUT_SCHEMA_PROFILES,
+  OUTPUT_SCHEMA_PROFILES,
+  REA_PINNED_VERSION,
+  reaMcpArgs,
+  reaMcpEnv,
+} from './mcp.ts'
+export { PLAN_MODE_SECTION } from './prompt.ts'
+export { createPresetRegistrar, type PresetRegistrar, type Unregister } from './registration.ts'
+export { BUNDLED_SKILL_ROOT, reaSkillDirs } from './skill.ts'
+export type { AgentPresetReaConfig, AgentPresetReaConfigFields }
+export { Config }
+
+/**
+ * 注册 rea 预设，并在 persona 热更后换代；卸载时注销当前一代。
+ *
+ * 注册与换代都在 effect 生命周期内完成：fiber 早于注册完成被卸下时，
+ * 换代器自己收掉晚到的 disposer，不泄漏预设子树。
+ * @param ctx - 宿主上下文。
+ * @param config - 已验证的插件配置（`personaPrefix` 为活动引用）。
+ */
+export function apply(ctx: Context, config: AgentPresetReaConfigFields): void {
+  const logger = ctx.logger('agent-preset-rea')
+  const current = (): AgentPresetReaConfig => unwrapVolatile(config)
+  if (current().enabled !== true) return
+
+  const onError = (error: unknown): void => {
+    const detail = error instanceof Error ? error.message : String(error)
+    logger.warn(`register rea preset failed: ${detail}`)
+  }
+
+  ctx.inject(['agentPresets'], (scope) => {
+    scope.effect(() => {
+      const registrar = createPresetRegistrar({
+        register: (definition) => scope.agentPresets.register(definition),
+        build: () => reaPresetDefinition(current()),
+        onError,
+      })
+      // 监听器挂在插件自身 fiber 上：loader 正是对该 fiber 广播 volatile 提交。
+      const off = ctx.events.on('loader/volatile-update', () => registrar.refresh())
+      return () => {
+        off()
+        registrar.dispose()
+      }
+    }, 'agent-preset-rea: register rea preset')
+  })
+}

package/src/mcp.ts

@@ -0,0 +1,42 @@
+/**
+ * REA MCP 行的取值派生：钉版版本、stdio 启动命令与参数、入参 schema 档位。
+ *
+ * REA 的 stdio 入口是 `rea-agents mcp`（`server.json` 的 positional 参数），
+ * 包版本钉在 {@link REA_PINNED_VERSION}——升级只改这一个常量，漂移由测试拦住。
+ * REA 的 Node 引擎要求为 `^22.19 || ^24.11 || >=26`（见 REA `docs/installation.md`）。
+ * @module @dsh-plus/agent-preset-rea/mcp
+ */
+import type { AgentPresetReaConfig } from './config.ts'
+
+/** 钉版基线：`rea-agents@6.5.0`（升级时同步测试断言、tests 清单与包文档）。 */
+export const REA_PINNED_VERSION = '6.5.0'
+
+/** stdio 启动命令默认值：POSIX 用 `npx`；Windows 需 `cmd.exe /c npx`（见包文档）。 */
+export const DEFAULT_MCP_COMMAND = 'npx'
+
+/** REA 工具入参 schema 广告档位：`compact` 压请求前缀体积，`full` 与上游默认一致。 */
+export const INPUT_SCHEMA_PROFILES = ['compact', 'full'] as const
+
+/** REA 工具出参 schema 广告档位：`off` 不下发（结果仍由 REA 侧校验），`full` 与上游默认一致。 */
+export const OUTPUT_SCHEMA_PROFILES = ['off', 'full'] as const
+
+/** stdio 参数：显式配置优先（Windows/全局安装配方），否则按钉版版本派生。 */
+export function reaMcpArgs(config: AgentPresetReaConfig): string[] {
+  return config.mcpArgs.length > 0
+    ? [...config.mcpArgs]
+    : ['-y', `rea-agents@${config.reaVersion}`, 'mcp']
+}
+
+/**
+ * 传给 REA 子进程的环境变量（并入被清洗过的宿主环境之上）。
+ *
+ * REA 有 207 个工具（`server.json` 同版的 skill 元数据 `tool_count`），工具定义
+ * 是每轮请求的固定开销，因此两个 schema 档位默认都取最省的一档；REA 自己仍按
+ * 规范契约校验结果，`full` 可逐项还原上游默认。
+ */
+export function reaMcpEnv(config: AgentPresetReaConfig): Record<string, string> {
+  return {
+    REA_MCP_INPUT_SCHEMA_PROFILE: config.inputSchemaProfile,
+    REA_MCP_OUTPUT_SCHEMA_PROFILE: config.outputSchemaProfile,
+  }
+}

package/src/ns.ts

@@ -0,0 +1,9 @@
+/**
+ * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
+ *
+ * 服务端以字面量参与 `Config` 的活动字段（dsh-settings 对命名空间做语法校验），
+ * 浏览器半把它作为配置卡片的注册键（插件页配置卡片挂在 row/bundle config 槽位上，
+ * 与命名空间解耦，见 shared/client/config-slots）；同一字面量两处共用，防止漂移。
+ * @module @dsh-plus/agent-preset-rea/ns
+ */
+export const SETTINGS_NS = 'dsh-plus-agent-preset-rea'

package/src/prompt.ts

@@ -0,0 +1,25 @@
+/**
+ * 本包随包携带的上游提示词文本：`standard` 预设 `plan-mode` 行的 section 原文。
+ *
+ * `dsh-plan-mode` 要求 `config.section` 非空（部署方所有权），因此该文本必须随包；
+ * 逐字相等由 tests/upstream-mirror.test.ts 对着上游夹具守卫，上游一改即失败。
+ *
+ * persona 不在本文件：本预设的 persona 前缀默认为**空串**（见 config.ts 的
+ * `personaPrefix`），不随包任何自有 persona 文案；官方工具指引、项目指令
+ * （AGENTS.md）与运行时上下文照常装配。
+ * @module @dsh-plus/agent-preset-rea/prompt
+ */
+
+/** 上游 `standard` 预设 `plan-mode` 行的 section 原文（逐字，勿手改）。 */
+export const PLAN_MODE_SECTION = `You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+`