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

package/src/client/draft.ts

@@ -1,18 +1,21 @@
 /**
  * 卡片草稿的纯逻辑（无 JSX，node --test 可直接测）：命名空间解析值 ⇄ 编辑草稿。
  *
- * 卡片编辑五个活动字段（`personaPrefix` 提示词、`proxyPort` 安装代理端口、
- * `mcpEnabled` / `skillEnabled` / `reverseSkillEnabled` 三个能力开关），其余字段
- * 属部署方平面不进卡片；命名空间值是整行配置的脱敏视图，读取时按字段收窄：
- * 值缺席或类型不符一律回落默认（提示词空串、代理 0、开关 true）。
+ * 卡片编辑六个活动字段（`personaPrefixMode` 提示词来源、`personaPrefix` 提示词正文、
+ * `proxyPort` 安装代理端口、`mcpEnabled` / `skillEnabled` / `reverseSkillEnabled`
+ * 三个能力开关），其余字段属部署方平面不进卡片；命名空间值是整行配置的脱敏视图，
+ * 读取时按字段收窄：值缺席或类型不符一律回落默认（提示词来源 `default`、代理 0、
+ * 开关 true）。
  *
  * 代理端口以文本承载：越界/非法不静默改写，标 `invalid` 并禁用保存（见 card.tsx），
  * 避免「输入 99999 被悄悄存成 65535」这类静默数据损坏。
  * @module agent-preset-rea/client/draft
  */
+import type { PersonaPrefixMode } from '../persona-prefix.ts'
 
 /** 命名空间解析值中本卡片消费的部分。 */
 export interface ConfigValue {
+  personaPrefixMode?: unknown
   personaPrefix?: unknown
   proxyPort?: unknown
   mcpEnabled?: unknown
@@ -22,6 +25,8 @@ export interface ConfigValue {
 
 /** 编辑草稿。 */
 export interface Draft {
+  /** persona 前缀来源：`default` = 随包内置，`custom` = 取下面的用户文本。 */
+  personaPrefixMode: PersonaPrefixMode
   personaPrefix: string
   /** 代理端口文本（空串与 `'0'` 都表示不用代理）。 */
   proxyPort: string
@@ -36,12 +41,18 @@ function boolOf(value: unknown, fallback: boolean): boolean {
   return typeof value === 'boolean' ? value : fallback
 }
 
+/** 模式收窄：只认两个字面量，其余（含缺席与旧配置）回落 `default`。 */
+function modeOf(value: unknown): PersonaPrefixMode {
+  return value === 'custom' ? 'custom' : 'default'
+}
+
 /** 代理端口上限。 */
 export const PROXY_PORT_MAX = 65535
 
 /** 解析值 → 草稿（类型不符一律回落默认）。 */
 export function draftFromValue(value: ConfigValue): Draft {
   return {
+    personaPrefixMode: modeOf(value.personaPrefixMode),
     personaPrefix: typeof value.personaPrefix === 'string' ? value.personaPrefix : '',
     proxyPort: typeof value.proxyPort === 'number' ? String(value.proxyPort) : '',
     mcpEnabled: boolOf(value.mcpEnabled, true),
@@ -65,6 +76,7 @@ export function parseProxyPort(text: string): number | null {
 /** 草稿 → 提交形状（只回写本卡片负责的字段）。 */
 export function toPatch(draft: Draft): Record<string, unknown> {
   return {
+    personaPrefixMode: draft.personaPrefixMode,
     personaPrefix: draft.personaPrefix,
     proxyPort: parseProxyPort(draft.proxyPort) ?? 0,
     mcpEnabled: draft.mcpEnabled,

package/src/client/i18n.ts

@@ -9,13 +9,21 @@ export const NS = 'dsh-plus-agent-preset-rea'
 
 const ownZh = {
   title: '逆向工程预设',
-  description: 'REA 提示词与安装维护：提示词留空即空 persona，工具指引与运行时上下文照常注入。',
+  description:
+    'REA 提示词与安装维护：提示词默认取随包内置文本，也可切到自定义；工具指引与运行时上下文照常注入。',
   summaryLine: '编辑「逆向工程」预设的提示词、开关 REA MCP 与两类 skill，并安装/更新',
   prompt: '系统提示词（persona 前缀）',
+  promptMode: '提示词来源',
+  promptModeDefault: '随包默认',
+  promptModeCustom: '自定义',
   promptHint:
-    '写入 system-prompt 的 persona 前缀段，仅对「逆向工程」预设的新会话生效；留空 = 不注入 persona 段（官方工具指引、项目指令与运行时上下文不受影响）。保存后新建会话即用新值。',
+    '写入 system-prompt 的 persona 前缀段（order 0，早于全部工具指引），仅对「逆向工程」预设的新会话生效。默认取随包内置文本；选「自定义」才用下面输入框的正文。官方工具指引、项目指令与运行时上下文不受影响。保存后新建会话即用新值。',
+  promptDefaultHint: '当前使用随包默认：下方为只读预览，切到「自定义」可改写正文。',
+  promptLegacyHint: '自定义正文与内置默认不同：「改用随包默认」只改草稿，仍需点保存才生效。',
+  promptResetToDefault: '改用随包默认',
+  promptChars: '内置文本字符数：',
   promptPlaceholder: '例如：先做证据分级，再动手改二进制；每一步给出可复核的证据链……',
-  promptEmpty: '当前为空：该预设不注入 persona 段。',
+  promptEmpty: '正文为空：保存后会回落随包内置文本，不会注入空 persona。',
   saveFailed: '保存失败：',
 
   installSection: 'REA 安装与更新',
@@ -87,14 +95,24 @@ const ownZh = {
 const ownEn = {
   title: 'Reverse-engineering preset',
   description:
-    'REA prompt and installation: an empty prompt means a blank persona; tool guidance and runtime context stay in place.',
+    'REA prompt and installation: the prompt defaults to the bundled text and can be switched to custom; tool guidance and runtime context stay in place.',
   summaryLine: 'Edit the “逆向工程” prompt, toggle REA MCP/skills, install and update them',
   prompt: 'System prompt (persona prefix)',
+  promptMode: 'Prompt source',
+  promptModeDefault: 'Bundled default',
+  promptModeCustom: 'Custom',
   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.',
+    'Written to the persona-prefix section of the system prompt (order 0, ahead of every tool-guidance section) for new sessions of this preset only. The default is the bundled text; the textarea below is used only in Custom mode. Official tool guidance, project instructions and runtime context are unaffected. New sessions pick up the saved value.',
+  promptDefaultHint:
+    'Using the bundled default: the preview below is read-only; switch to Custom to rewrite it.',
+  promptLegacyHint:
+    'The custom text differs from the bundled default; “Use bundled default” only edits the draft — save to apply.',
+  promptResetToDefault: 'Use bundled default',
+  promptChars: 'Bundled text characters: ',
   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.',
+  promptEmpty:
+    'Empty body: saving falls back to the bundled text, so no empty persona is injected.',
   saveFailed: 'Save failed: ',
 
   installSection: 'REA installation',

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/config.ts

@@ -5,15 +5,16 @@
  * 与 settings 用户层（GUI 配置卡片写入 profile 行级覆盖层，loader 原位提交活动
  * 引用，消费端 `unwrapVolatile` 现取即热）。
  *
- * **活动字段（`.volatile()`）共五个**，全部在配置卡片里有编辑器（见 src/client/card.tsx）：
- * `personaPrefix`（提示词）、`proxyPort`（安装代理）、`mcpEnabled` / `skillEnabled` /
- * `reverseSkillEnabled`（三个能力开关）——保存即热更（预设换代，新建会话生效）。
- * 其余字段是**部署方平面**（受管目录、版本钉、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 等引用都会落空）。
@@ -24,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
@@ -38,16 +40,35 @@ 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 = 只保留预设其余能力）')

package/src/definition.ts

@@ -7,12 +7,18 @@
  * tests/upstream-mirror.test.ts 会逼出对齐。本预设不丢任何上游行（与 lean 相反）。
  *
  * 增量仅三处，测试按 {@link ADDED_ROWS} / {@link CONFIG_DELTAS} 白名单放行：
- * 1. `persona` 行 `prefix` 取配置值（默认空串 = 空 persona）；
+ * 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」，测试据此断言两种形态。
  *
@@ -24,6 +30,7 @@ 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 { emptyReverseState } from './reverse.ts'
 import { BUNDLED_SKILL_ROOT, presetSkillDirs } from './skill.ts'
@@ -34,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']
+
 /**
  * 已镜像行 → 允许偏离上游的字段名（其余字段必须逐字一致）。
  * 删除某条等于把该行改回上游原文；改动上游不存在的字段会被测试拦下。
@@ -43,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
@@ -73,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 分钟一条）。
     {
@@ -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,
   }
 }

package/src/index.ts

@@ -63,6 +63,7 @@ export {
   ADDED_ROWS,
   CONFIG_DELTAS,
   emptyRuntime,
+  isMinimalPresetId,
   REA_PRESET_ID,
   reaPresetDefinition,
 } from './definition.ts'
@@ -122,6 +123,22 @@ export {
   reaMcpEnv,
   reaMcpLaunch,
 } from './mcp.ts'
+export {
+  appendPersonaExtensions,
+  DEFAULT_PERSONA_PREFIX,
+  DEFAULT_PERSONA_PREFIX_BYTES,
+  DEFAULT_PERSONA_PREFIX_HASH,
+  DEFAULT_PERSONA_PREFIX_LENGTH,
+  DEFAULT_PERSONA_PREFIX_PREVIEW,
+  normalizedDefaultPersonaPrefix,
+  normalizePersonaPrefix,
+  type PersonaPrefixChoice,
+  type PersonaPrefixExtensions,
+  type PersonaPrefixMode,
+  PREFIX_ENVELOPE_LINE,
+  REQUIRED_PREFIX_SECTIONS,
+  resolvePersonaPrefix,
+} from './persona-prefix.ts'
 export { PLAN_MODE_SECTION } from './prompt.ts'
 export { createPresetRegistrar, type PresetRegistrar, type Unregister } from './registration.ts'
 export {