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

package/src/client/styles.ts

@@ -1,7 +1,9 @@
 /**
- * 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('apr')，
- * 本文件只补插件特有规则（提示词多行输入框）。
+ * 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('apr')
+ * （按钮/字段/徽标等类名由共享控件生成，本文件**不**重复定义），这里只补
+ * 插件特有规则：提示词多行框、安装状态表、作业进度条与日志。
  * 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
+ * 颜色与度量全部走官方主题变量（--dsw-alias-*），不写死色值。
  * @module agent-preset-rea/client/styles
  */
 import { cardCss, injectCardStyle } from '@dsh-plus/shared/client'
@@ -12,6 +14,9 @@ export const PLUGIN_ID = '@dsh-plus/agent-preset-rea'
  * 多行提示词输入框：度量对齐官方 settings-form 的 textarea
  * （与 -input 同边框/底色/圆角，正文 13px/1.6），窄屏 16px 防 iOS 聚焦缩放、
  * 纵向可拖拽但不横向溢出。
+ *
+ * 类名避让 cardCss 已生成的 `-status` / `-badge` 前缀（那是 CardChrome 的状态行与
+ * 字段徽标），安装表与作业块一律用 `-install*` / `-pill*` / `-job*`。
  */
 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}
@@ -19,8 +24,28 @@ 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-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}
+.apr-installKey{flex:none;width:118px;margin:0;font-size:12px;color:var(--dsw-alias-label-tertiary)}
+.apr-installVal{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin:0;font-size:13px;color:var(--dsw-alias-label-primary)}
+.apr-mono{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;word-break:break-all}
+.apr-pill{flex:none;padding:2px 8px;border-radius:999px;font-size:11px;line-height:16px}
+.apr-pillOk{background:var(--dsw-alias-state-success-secondary);color:var(--dsw-alias-state-success-primary)}
+.apr-pillMiss,.apr-pillError,.apr-pillCancelled{background:var(--dsw-alias-state-error-secondary);color:var(--dsw-alias-state-error-primary)}
+.apr-pillRunning{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
+.apr-job{margin-top:12px;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-3)}
+.apr-jobHead{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
+.apr-jobTitle{font-size:13px;font-weight:500;color:var(--dsw-alias-label-primary)}
+.apr-bar{margin-top:8px;height:6px;border-radius:999px;background:var(--dsw-alias-interactive-bg-hover);overflow:hidden}
+.apr-barFill{height:100%;background:var(--dsw-alias-brand-primary);transition:width .3s}
+.apr-logBox{margin-top:8px}
+.apr-logSummary{font-size:12px;color:var(--dsw-alias-label-tertiary);cursor:pointer}
+.apr-log{margin:6px 0 0;max-height:200px;overflow:auto;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;line-height:1.5;white-space:pre-wrap;word-break:break-all;color:var(--dsw-alias-label-tertiary)}
+.apr-error{margin:4px 0 0;font-size:12px;color:var(--dsw-alias-state-error-primary)}
 @media (max-width:767px){
 .apr-textarea{font-size:16px;min-height:140px}
+.apr-installKey{width:100%}
 }
 `
 

package/src/config.ts

@@ -5,9 +5,9 @@
  * 与 settings 用户层（GUI 配置卡片写入 profile 行级覆盖层，loader 原位提交活动
  * 引用，消费端 `unwrapVolatile` 现取即热）。
  *
- * **只有 `personaPrefix` 标 `.volatile()`**：它是对用户的承诺（配置卡片必须给出
- * 编辑器，见 src/client/card.tsx），也是本预设里唯一需要热更的字段；其余字段是
- * **部署方平面**（MCP 参数、超时、附加 skill 根等运维旋钮），由 `cordis.patch.yml`
+ * **活动字段只有两个**：`personaPrefix` 与 `proxyPort`——两者都在配置卡片里有编辑器
+ * （见 src/client/card.tsx），保存即热更（预设换代 / 安装作业即时生效）。其余字段是
+ * **部署方平面**（安装位置、超时、附加 skill 根等运维旋钮），由 `cordis.patch.yml`
  * 整体覆盖，GUI 不提供入口。
  *
  * **persona 默认为空串**：`dsh-persona` 的空模板照样遮蔽部署级 persona 段，
@@ -21,12 +21,7 @@
 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 { INPUT_SCHEMA_PROFILES, OUTPUT_SCHEMA_PROFILES, REA_PINNED_VERSION } from './mcp.ts'
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
 /** settings 命名空间（字面量即合法命名空间；配置卡片与运行期读取同一份）。 */
@@ -67,13 +62,29 @@ export const Config = z.object({
     .string()
     .description('钉版的 rea-agents 版本（npx 拉取）')
     .default(REA_PINNED_VERSION),
+  installRoot: z
+    .string()
+    .description(
+      'REA 受管安装树位置（空 = <DSH_HOME>/dsh-plus/dsh-plus-agent-preset-rea/rea-agent）',
+    )
+    .default(''),
+  proxyPort: z
+    .natural()
+    .max(65535)
+    .description('安装/更新时使用的本机代理端口（0 = 不用代理；npm 与原生依赖 prebuild 下载同此）')
+    .default(0)
+    .volatile(),
   mcpCommand: z
     .string()
-    .description('MCP stdio 可执行文件；Windows 需 cmd.exe 配方，见包文档')
-    .default(DEFAULT_MCP_COMMAND),
+    .description(
+      '显式 MCP 启动命令（空 = 用受管安装入口，未安装时该行禁用；填 npx 即启动期拉取，风险自负）',
+    )
+    .default(''),
   mcpArgs: z
     .array(z.string())
-    .description('MCP stdio 参数；留空 = 按 reaVersion 派生 ["-y","rea-agents@<version>","mcp"]')
+    .description(
+      'MCP stdio 附加参数；留空 = 受管入口补 ["mcp"]，显式 npx 则派生 ["-y","rea-agents@<version>","mcp"]',
+    )
     .default([]),
   inputSchemaProfile: z
     .union(INPUT_SCHEMA_PROFILES)

package/src/definition.ts

@@ -8,8 +8,12 @@
  *
  * 增量仅三处，测试按 {@link ADDED_ROWS} / {@link CONFIG_DELTAS} 白名单放行：
  * 1. `persona` 行 `prefix` 取配置值（默认空串 = 空 persona）；
- * 2. `skill-filesystem` 行加 `customSkillDirs`（随包 REA skill + 配置追加目录）；
- * 3. 新增 `mcp-rea` 行：官方 MCP 客户端连 REA stdio 服务，落在本预设作用域内。
+ * 2. `skill-filesystem` 行加 `customSkillDirs`（随包 REA skill 或手动更新副本 + 追加目录）；
+ * 3. 新增 `mcp-rea` 行：官方 MCP 客户端连 REA stdio 服务，落在本预设作用域内；
+ *    **未安装 REA 时该行 `disabled`**（不 spawn npx，见 mcp.ts 的说明）。
+ *
+ * {@link RuntimeSnapshot} 是运行期事实（受管安装与 skill 来源），由 manager 现探后
+ * 传入；不传即「未安装 + 随包 skill」，测试据此断言两种形态。
  *
  * 组行必须带 `isolate` 归属 realm，否则注册表拒绝挂载（服务泄漏判定）。
  * @module @dsh-plus/agent-preset-rea/definition
@@ -17,9 +21,10 @@
 import type { PresetDefinition } from '@deepseek-ai/dsh-agent-preset-registry'
 
 import type { AgentPresetReaConfig } from './config.ts'
-import { reaMcpArgs, reaMcpEnv } from './mcp.ts'
+import type { RuntimeSnapshot } from './manager.ts'
+import { DEFAULT_MCP_COMMAND, reaMcpArgs, reaMcpEnv, reaMcpLaunch } from './mcp.ts'
 import { PLAN_MODE_SECTION } from './prompt.ts'
-import { reaSkillDirs } from './skill.ts'
+import { BUNDLED_SKILL_ROOT, reaSkillDirs } from './skill.ts'
 
 /** 预设注册表身份（改 id 等于换预设，default 等引用都会落空）。 */
 export const REA_PRESET_ID = 'rea'
@@ -42,147 +47,199 @@ const POSIX_ONLY = { __jsExpr: "process.platform !== 'win32'" } as const
 
 /** 官方 loader 的嵌套组行名。 */
 const GROUP = 'cordis:group'
+/** 未安装、随包 skill 的运行期事实（默认值：测试与无 manager 场景）。 */
+export function emptyRuntime(): RuntimeSnapshot {
+  return {
+    install: null,
+    skill: {
+      source: 'bundled',
+      version: null,
+      root: BUNDLED_SKILL_ROOT,
+      files: 0,
+      updatedAt: null,
+    },
+  }
+}
+
+/** 声明里的行类型（官方 loader entry 结构）。 */
+type Row = PresetDefinition['plugins'][number]
 
 /**
- * 由配置拼出注册表声明。
+ * 基础与工具面行：身份（persona）/ 项目指令与时钟 / shell 与文件工具 / 后台任务与
+ * 定时提醒 / skill 文件系统（本预设加 `customSkillDirs`，可指向手动更新副本）。
+ */
+function baseRows(config: AgentPresetReaConfig, runtime: RuntimeSnapshot): Row[] {
+  return [
+    // 身份：沿用官方装配（非 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,
+          runtime.skill.source === 'updated' ? runtime.skill.root : null,
+        ),
+      },
+    },
+    { 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' },
+  ]
+}
+
+/**
+ * 编排与交付面行：计划模式 / 上下文压缩 / 委派与 workflow / 交互与待办 / 网络工具 /
+ * **REA MCP 客户端** / 展示与插件管理。
+ */
+function orchestrationRows(config: AgentPresetReaConfig, runtime: RuntimeSnapshot): Row[] {
+  // 启动方式：显式 mcpCommand > 受管安装入口 > null（行禁用）。
+  const launch = reaMcpLaunch(config, runtime.install)
+  // 无启动方式时行被禁用，但 config 仍填经典 npx 配方：配置转储里能看到原始配方，
+  // 手工把行 enable 回来即回退到「启动期拉取」的老行为——默认路径绝不 spawn 它。
+  const mcp = launch ?? {
+    command: DEFAULT_MCP_COMMAND,
+    args: reaMcpArgs({ ...config, mcpCommand: DEFAULT_MCP_COMMAND }),
+  }
+  return [
+    // 计划模式：状态天然属于单个 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> 注册在
+    // 本预设作用域；服务名预留按作用域隔离，其他预设不受影响。
+    // 未安装 REA 且未显式配 mcpCommand 时整行禁用：绝不在 boot 期 spawn npx
+    // （那会跑 npm 安装脚本，卡住即吊死预设激活与名册——见 docs/README.md）。
+    {
+      id: 'mcp-rea',
+      name: '@deepseek-ai/dsh-mcp-client',
+      disabled: !config.mcpEnabled || launch === null,
+      config: {
+        transport: 'stdio',
+        serverName: config.mcpServerName,
+        command: mcp.command,
+        args: mcp.args,
+        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 },
+  ]
+}
+
+/**
+ * 由配置 + 运行期事实拼出注册表声明。
  * @param config - 已验证的插件配置。
+ * @param runtime - 受管安装与 skill 来源事实（默认「未安装 + 随包 skill」）。
  * @returns id 固定为 `rea` 的预设声明。
  */
-export function reaPresetDefinition(config: AgentPresetReaConfig): PresetDefinition {
+export function reaPresetDefinition(
+  config: AgentPresetReaConfig,
+  runtime: RuntimeSnapshot = emptyRuntime(),
+): 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 },
-    ],
+    plugins: [...baseRows(config, runtime), ...orchestrationRows(config, runtime)],
   }
 }

package/src/dto.ts

@@ -0,0 +1,87 @@
+/**
+ * 宿主半与浏览器半之间的 wire 数据门面（纯类型 + 纯函数，零 node 依赖）。
+ *
+ * 浏览器半只 `import type` 消费本文件（编译期擦除，不进 client bundle），
+ * 两端共用同一份字段定义，避免「宿主改了字段、卡片还在读老名字」的静默漂移。
+ * @module @dsh-plus/agent-preset-rea/dto
+ */
+
+/** 作业种类。 */
+export type JobKind = 'install' | 'skill'
+
+/** 作业状态。 */
+export type JobState = 'running' | 'ok' | 'error' | 'cancelled'
+
+/** 作业进度（按阶段推进；percent 为进入该阶段时的完成度）。 */
+export interface JobProgressDto {
+  step: number
+  steps: number
+  phase: string
+  percent: number
+}
+
+/** 作业快照。 */
+export interface JobDto {
+  id: number
+  kind: JobKind
+  state: JobState
+  progress: JobProgressDto
+  /** 日志尾部（宿主已有界）。 */
+  log: string[]
+  startedAt: string
+  finishedAt: string | null
+  version: string | null
+  error: string | null
+}
+
+/** 受管安装事实。 */
+export interface InstallDto {
+  installed: boolean
+  /** 已安装版本（未安装为 null）。 */
+  version: string | null
+  /** 受管安装树位置（无论是否已安装都有值，便于用户核对）。 */
+  root: string
+  /** 入口脚本（未安装为 null）。 */
+  entry: string | null
+}
+
+/** skill 来源事实。 */
+export interface SkillDto {
+  source: 'bundled' | 'updated'
+  version: string | null
+  root: string
+  files: number
+  updatedAt: string | null
+}
+
+/** MCP 行形态。 */
+export interface McpDto {
+  /** `installed` = 用受管安装入口；`custom` = 用显式 mcpCommand；`missing` = 未安装且无显式命令（行禁用）。 */
+  mode: 'installed' | 'custom' | 'missing'
+  /** 行是否启用（mcpEnabled && 有启动方式）。 */
+  enabled: boolean
+  command: string | null
+  args: string[]
+}
+
+/** `GET /status` 响应。 */
+export interface StatusDto {
+  config: {
+    reaVersion: string
+    proxyPort: number
+    mcpEnabled: boolean
+    installRoot: string
+  }
+  install: InstallDto
+  skill: SkillDto
+  mcp: McpDto
+  paths: { installRoot: string; skillRoot: string }
+  job: JobDto | null
+}
+
+/** 作业类响应（启动/取消）。 */
+export interface JobActionDto {
+  job: JobDto | null
+  /** 拒绝原因（409/400 时给出人话）。 */
+  error?: string
+}