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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/agent-preset-rea",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "dsh-plus service + UI plugin: 注册逆向工程 agent preset（id=rea）——官方 standard 全量行镜像 + 预设作用域的 REA MCP 客户端（mcp__rea__*）、随包 REA 官方 skill、提示词卡片与 REA/skill 的受管安装更新",
   "type": "module",
   "main": "lib/index.js",
@@ -32,17 +32,17 @@
     }
   },
   "dependencies": {
-    "@dsh-plus/shared": "0.1.40"
+    "@dsh-plus/shared": "0.1.41"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.2",
-    "@deepseek-ai/dsh-agent-preset-registry": "^0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.2.1-alpha.4",
     "@deepseek-ai/schemastery": "^3.18.5-alpha.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.5-alpha.2",
-    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.4",
     "@deepseek-ai/schemastery": "3.18.5-alpha.2",
     "@types/react": "~18.3.31",
     "react": "^18.2.0",

package/src/client/api.ts

@@ -6,7 +6,7 @@
  * @module agent-preset-rea/client/api
  */
 import { getJson, postJson } from '@dsh-plus/shared/client'
-import type { JobActionDto, JobDto, StatusDto } from '../dto.ts'
+import type { JobActionDto, JobDto, JobKind, StatusDto } from '../dto.ts'
 
 /** 载荷类型谓词（与 shared/client 的 fetch 同形；此处按本插件契约自持）。 */
 type Guard<T> = (value: unknown) => value is T
@@ -34,6 +34,7 @@ function isStatus(value: unknown): value is StatusDto {
   const install = body['install']
   const skill = body['skill']
   const mcp = body['mcp']
+  const reverse = body['reverse']
   return (
     typeof install === 'object' &&
     install !== null &&
@@ -41,6 +42,8 @@ function isStatus(value: unknown): value is StatusDto {
     skill !== null &&
     typeof mcp === 'object' &&
     mcp !== null &&
+    typeof reverse === 'object' &&
+    reverse !== null &&
     typeof body['config'] === 'object' &&
     body['config'] !== null
   )
@@ -60,13 +63,11 @@ export async function fetchStatus(): Promise<StatusDto> {
 
 /**
  * 启动作业。
- * @param kind - `install` = 安装/更新 REA 包；`skill` = 拉取并替换 skill 副本。
+ * @param kind - `install` = 安装/更新 REA 包；`skill` = 更新 REA skill 副本；
+ *   `reverse` = 更新 reverse-skill（GitHub 源）。
  * @param proxyPort - 草稿里当前填的代理端口（未保存也即时生效）。
  */
-export async function startJob(
-  kind: 'install' | 'skill',
-  proxyPort: number,
-): Promise<JobActionDto> {
+export async function startJob(kind: JobKind, proxyPort: number): Promise<JobActionDto> {
   return postJson<JobActionDto>(`${ROUTE_BASE}/${kind}`, { proxyPort }, isJobAction)
 }
 

package/src/client/card.tsx

@@ -6,11 +6,14 @@
  * （CardChrome + useNamespaceDraft：staged 草稿、脏判定、revision fencing、
  * Host 更新不覆盖在途编辑），安装维护区见 client/install.tsx。
  *
- * 两个活动字段（`Config` 里标 `.volatile()` 的）都在这里给出编辑器：
- * - `personaPrefix`：system-prompt 的 persona 前缀段；
- * - `proxyPort`：安装/更新时的本机代理端口。
- * 其余字段（安装位置、MCP 参数、超时、附加 skill 根）属部署方平面，由 profile 的
- * cordis.patch.yml 行级配置覆盖，卡片只读展示关键事实。
+ * 六个活动字段（`Config` 里标 `.volatile()` 的）都在这里给出编辑器：
+ * - `personaPrefixMode` / `personaPrefix`：persona 前缀的来源与正文；默认取随包内置
+ *   文本（只读预览，见 persona-prefix.ts 的 DEFAULT_PROMPT_PREVIEW），切「自定义」
+ *   才写正文；
+ * - `proxyPort`：安装/更新时的本机代理端口；
+ * - `mcpEnabled` / `skillEnabled` / `reverseSkillEnabled`：三个能力开关（见 toggles.tsx）。
+ * 其余字段（受管目录、版本钉、skill 组、MCP 参数、超时、附加 skill 根）属部署方平面，
+ * 由 profile 的 cordis.patch.yml 行级配置覆盖，卡片只读展示关键事实。
  *
  * 安装维护为什么不放在注册期自动做：启动期 `npx`/npm 安装会跑依赖安装脚本
  * （原生 prebuild 下载），卡住即吊死预设激活与整个名册；因此改成显式动作
@@ -30,9 +33,33 @@ import {
 } from '@dsh-plus/shared/client'
 import type { ReactElement } from 'react'
 
+import { DEFAULT_PERSONA_PREFIX_LENGTH, DEFAULT_PERSONA_PREFIX_PREVIEW } from '../persona-prefix.ts'
 import { type ConfigValue, type Draft, draftFromValue, parseProxyPort, toPatch } from './draft.ts'
 import type { Translate } from './i18n.ts'
 import { InstallSection } from './install.tsx'
+import { ToggleSection } from './toggles.tsx'
+
+/** 提示词来源的二选一按钮（与能力开关同形态的轻量控件）。 */
+function ModeButton(props: {
+  id: string
+  label: string
+  active: boolean
+  disabled: boolean
+  onSelect(): void
+}): ReactElement {
+  return (
+    <button
+      type="button"
+      id={props.id}
+      className={`apr-mode${props.active ? ' apr-mode-on' : ''}`}
+      aria-pressed={props.active}
+      disabled={props.disabled}
+      onClick={props.onSelect}
+    >
+      {props.label}
+    </button>
+  )
+}
 
 export interface CardProps extends PluginConfigViewProps {
   t: Translate
@@ -87,6 +114,7 @@ export function ReaCard(props: CardProps): ReactElement | string | null {
 
   const disabled = state.disabled
   const port = parseProxyPort(draft.proxyPort)
+  const custom = draft.personaPrefixMode === 'custom'
   return (
     <CardChrome
       prefix="apr"
@@ -112,18 +140,56 @@ export function ReaCard(props: CardProps): ReactElement | string | null {
             {t('prompt')}
           </label>
         </div>
+        <div className="apr-modes">
+          <ModeButton
+            id="apr-prompt-mode-default"
+            label={t('promptModeDefault')}
+            active={custom === false}
+            disabled={disabled}
+            onSelect={() => state.edit({ personaPrefixMode: 'default' })}
+          />
+          <ModeButton
+            id="apr-prompt-mode-custom"
+            label={t('promptModeCustom')}
+            active={custom === true}
+            disabled={disabled}
+            onSelect={() => state.edit({ personaPrefixMode: 'custom' })}
+          />
+        </div>
         <textarea
           id="apr-prompt"
           className="apr-textarea"
           rows={10}
           spellCheck={false}
           placeholder={t('promptPlaceholder')}
-          value={draft.personaPrefix}
+          value={custom === true ? draft.personaPrefix : DEFAULT_PERSONA_PREFIX_PREVIEW}
+          readOnly={custom !== true}
           disabled={disabled}
           onChange={(event) => state.edit({ personaPrefix: event.target.value })}
         />
         <p className="apr-hint">{t('promptHint')}</p>
-        {draft.personaPrefix.trim() === '' ? <p className="apr-hint">{t('promptEmpty')}</p> : null}
+        {custom === true ? null : (
+          <p className="apr-hint">
+            {t('promptDefaultHint')} {t('promptChars')}
+            {String(DEFAULT_PERSONA_PREFIX_LENGTH)}
+          </p>
+        )}
+        {custom === true && draft.personaPrefix.trim() === '' ? (
+          <p className="apr-hint">{t('promptEmpty')}</p>
+        ) : null}
+        {custom === true && draft.personaPrefix.trim() !== '' ? (
+          <p className="apr-hint">
+            {t('promptLegacyHint')}{' '}
+            <button
+              type="button"
+              className="apr-link"
+              disabled={disabled}
+              onClick={() => state.edit({ personaPrefixMode: 'default', personaPrefix: '' })}
+            >
+              {t('promptResetToDefault')}
+            </button>
+          </p>
+        ) : null}
       </div>
 
       <TextField
@@ -139,6 +205,8 @@ export function ReaCard(props: CardProps): ReactElement | string | null {
         onEdit={(text) => state.edit({ proxyPort: text })}
       />
 
+      <ToggleSection t={t} draft={draft} disabled={disabled} onEdit={state.edit} />
+
       <InstallSection t={t} disabled={disabled} proxyPort={port} />
     </CardChrome>
   )

package/src/client/client.ts

@@ -4,8 +4,9 @@
  * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
  * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
  *
- * 卡片编辑两个活动字段（`personaPrefix`、`proxyPort`），并驱动宿主半的受管安装/更新
- * 作业（同源自定义端点，见 client/api.ts）；配置读写经共享层直连 `ctx.remote.settings`
+ * 卡片编辑六个活动字段（`personaPrefixMode` 提示词来源、`personaPrefix` 提示词正文、
+ * `proxyPort` 与 mcp/skill/reverse 三个开关），
+ * 并驱动宿主半的受管安装/更新作业（同源自定义端点，见 client/api.ts）；配置读写经共享层直连 `ctx.remote.settings`
  * （官方 `settingsScope` 服务不存在、由 `configForms` 取代），与 notify-email 同机制。
  * @module @dsh-plus/agent-preset-rea/client
  */

package/src/client/draft.ts

@@ -1,26 +1,49 @@
 /**
  * 卡片草稿的纯逻辑（无 JSX，node --test 可直接测）：命名空间解析值 ⇄ 编辑草稿。
  *
- * 卡片编辑两个活动字段（`personaPrefix` 提示词、`proxyPort` 安装代理端口），其余字段
- * 属部署方平面不进卡片；命名空间值是整行配置的脱敏视图，读取时按字段收窄：
- * 值缺席或类型不符一律回落默认（提示词空串、代理 0）。
+ * 卡片编辑六个活动字段（`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
+  skillEnabled?: unknown
+  reverseSkillEnabled?: unknown
 }
 
 /** 编辑草稿。 */
 export interface Draft {
+  /** persona 前缀来源：`default` = 随包内置，`custom` = 取下面的用户文本。 */
+  personaPrefixMode: PersonaPrefixMode
   personaPrefix: string
   /** 代理端口文本（空串与 `'0'` 都表示不用代理）。 */
   proxyPort: string
+  /** 三个能力开关（REA MCP 行 / REA skill / reverse-skill）。 */
+  mcpEnabled: boolean
+  skillEnabled: boolean
+  reverseSkillEnabled: boolean
+}
+
+/** 布尔字段收窄（缺席或类型不符回落默认值）。 */
+function boolOf(value: unknown, fallback: boolean): boolean {
+  return typeof value === 'boolean' ? value : fallback
+}
+
+/** 模式收窄：只认两个字面量，其余（含缺席与旧配置）回落 `default`。 */
+function modeOf(value: unknown): PersonaPrefixMode {
+  return value === 'custom' ? 'custom' : 'default'
 }
 
 /** 代理端口上限。 */
@@ -29,8 +52,12 @@ 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),
+    skillEnabled: boolOf(value.skillEnabled, true),
+    reverseSkillEnabled: boolOf(value.reverseSkillEnabled, true),
   }
 }
 
@@ -49,7 +76,11 @@ 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,
+    skillEnabled: draft.skillEnabled,
+    reverseSkillEnabled: draft.reverseSkillEnabled,
   }
 }

package/src/client/i18n.ts

@@ -9,13 +9,21 @@ export const NS = 'dsh-plus-agent-preset-rea'
 
 const ownZh = {
   title: '逆向工程预设',
-  description: 'REA 提示词与安装维护：提示词留空即空 persona，工具指引与运行时上下文照常注入。',
-  summaryLine: '编辑「逆向工程」预设的提示词，并安装/更新 REA 与 skill',
+  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 安装与更新',
@@ -58,6 +66,26 @@ const ownZh = {
   jobElapsed: '已用时',
   jobLogEmpty: '（暂无输出）',
 
+  toggleSection: '能力开关',
+  toggleMcp: 'REA MCP 工具（mcp__rea__*）',
+  toggleMcpHint:
+    '关掉即从本预设摘掉 REA MCP 行，模型面看不到 mcp__rea__* 工具；REA 仍留在磁盘上，随时可开回来（保存后新建会话生效）。',
+  toggleSkill: 'REA 官方 skill',
+  toggleSkillHint:
+    '关掉即不挂 REA 官方 skill 根（reverse-engineer-anything），其余 skill 根不受影响。',
+  toggleReverse: 'reverse-skill 技能包',
+  toggleReverseHint:
+    '关掉即不挂 zhaoxuya520/reverse-skill 的技能组（默认挂主包根：路由技能 + 各模块技能）；安装副本仍在，可从下面重新更新。',
+  enabled: '已挂载',
+  disabled: '已关闭',
+  reverseSource: 'reverse-skill',
+  reverseCommit: '提交',
+  reverseGroups: '技能组',
+  reverseGroupsHint: '树内可选组：',
+  reversePath: '技能包目录',
+  reverseAction: '更新 reverse-skill',
+  jobReverse: '更新 reverse-skill',
+
   proxyPort: '安装代理端口',
   proxyPortHint:
     '安装/更新时供 npm 与原生依赖（node-pty）prebuild 下载使用的本机代理端口；0 或留空 = 直连。未保存也用于本次安装，保存后长期生效。',
@@ -67,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.',
-  summaryLine: 'Edit the “逆向工程” prompt and install/update REA and its skill',
+    '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',
@@ -118,6 +156,26 @@ const ownEn = {
   jobElapsed: 'Elapsed',
   jobLogEmpty: '(no output yet)',
 
+  toggleSection: 'Capability switches',
+  toggleMcp: 'REA MCP tools (mcp__rea__*)',
+  toggleMcpHint:
+    'Turning this off drops the REA MCP row from this preset, so mcp__rea__* tools disappear; REA stays on disk and can be switched back on. New sessions pick up the change.',
+  toggleSkill: 'REA official skill',
+  toggleSkillHint:
+    'Turning this off unmounts the bundled REA skill root (reverse-engineer-anything); other skill roots are unaffected.',
+  toggleReverse: 'reverse-skill pack',
+  toggleReverseHint:
+    'Turning this off unmounts the skill groups of zhaoxuya520/reverse-skill (the main pack root is mounted by default: router skill plus module skills). The installed copy stays on disk and can be updated again below.',
+  enabled: 'Mounted',
+  disabled: 'Off',
+  reverseSource: 'reverse-skill',
+  reverseCommit: 'Commit',
+  reverseGroups: 'Skill groups',
+  reverseGroupsHint: 'Available in tree: ',
+  reversePath: 'Pack directory',
+  reverseAction: 'Update reverse-skill',
+  jobReverse: 'Update reverse-skill',
+
   proxyPort: 'Install proxy port',
   proxyPortHint:
     'Local proxy port used by npm and by the native node-pty prebuild download during install/update; 0 or empty means direct. The unsaved value is used for the next install and applies permanently once saved.',