@12inch-glorysoft/dsh-ad-form 0.0.0-stage → 1.0.0-beta.2

package/README.md

@@ -1,3 +1,128 @@
-# Temporary Holding Version
+# AD Form Design Agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+基于 dsh (DeepSeek Harness) 平台构建的智能 Agent，用于根据手绘草图和需求描述自动生成 GLC-Form (ADForm) XML 配置文件。
+
+## 项目背景
+
+现有产品为 EJB + Eclipse RCP 的 C/S 客户端架构，有一套基于 RCP 的低代码包，使用 XML Schema 绘制布局、表单和表格。本项目旨在构建一个 Agent，通过草图识别和多轮对话交互，自动化生成符合规范的 ADForm XML。
+
+## 使用入口
+
+无需开启或关闭表单能力。直接描述表单需求、上传相关图片，或引用已有 IR JSON / XML 文件，由模型结合语义选择表单 skill；也可以主动输入 `/ad-form 创建客户表单`，同时附带图片或文件。单独输入 `/ad-form` 时先澄清需求。
+
+继续修改时沿用当前设计，切换普通话题无需关闭。宿主需提供 `skills` 服务、原生 `skill` 工具及其用户调用入口，以及内置问询工具 `ask_user_question`；本插件负责注册 `ad-form` skill 与命令。
+
+## 数据库检索配置
+
+打开 dsh 左侧「插件」→ `@12inch-glorysoft/dsh-ad-form` → `ad-form` 条目的「配置」，填写数据库连接。插件浏览器模块注册配置页面，复用宿主的表单控件；配置读取与保存由原生 settings 和 configEditor 服务完成。
+
+| 字段                  | 用途                                         |
+| --------------------- | -------------------------------------------- |
+| `dataSource.driver`   | `oracle`、`mysql` 或 `postgres`              |
+| `dataSource.host`     | 数据库地址                                   |
+| `dataSource.port`     | 正整数端口                                   |
+| `dataSource.database` | Oracle 服务名，或 MySQL / PostgreSQL 库名    |
+| `dataSource.user`     | 数据库账号                                   |
+| `dataSource.password` | 数据库密码；按宿主秘密字段处理               |
+| `dataSource.owner`    | 可选的元数据 schema；留空使用账号默认 schema |
+
+默认不提供连接值。允许分步填写；检索时需要驱动、地址、端口、库名和账号，密码与 schema 可省略。未配置或参数不完整时，数据源与字典检索返回配置引导，其他表单设计能力仍可使用。选用数据库方言时，运行环境还需有对应驱动（Oracle 使用项目依赖中的 `oracledb`；MySQL / PostgreSQL 分别需要 `mysql2` / `pg`）。
+
+保存只校验字段并写入当前 profile，不主动测试数据库连接。新检索立即使用新配置并释放旧连接池；无需重启或重新创建表单设计。清空连接字段即可恢复未配置状态。密码不会随设置读取返回；只修改其他字段时由宿主保留原密码。profile 的本地持久化不代表加密存储。
+
+### 本地开发加载
+
+在项目目录安装开发依赖后，只构建前端并安装本地目录：
+
+```bash
+pnpm install
+pnpm run build:client
+dsh --profile ad-form-dev --from-default-profile web --dump-config
+dsh plugin --profile ad-form-dev add /home/alone/workspace/ad-form-agent
+NODE_OPTIONS="$NODE_OPTIONS --conditions=development" dsh --profile ad-form-dev --no-open
+```
+
+首次使用专用的 `ad-form-dev` profile，可以避开既有 `web` profile 中手工插入的源码条目；安装命令由宿主维护 profile，无需手工修改 `.dsh` 文件。初始化与安装只需做一次，以后直接运行最后一条启动命令。若希望继续用已有 `web` profile，需先移除其中同 id 的源码插入指令并保留已有的 `ad-form` 配置覆盖，避免重复条目。之后不要再使用 `--patch cordis.yml`。
+
+本地启动时通过 Node 的 `--conditions=development` 选择 `src/plugin.ts` 入口，后端直接运行 TypeScript，可沿用原来的 TS 断点调试方式，无需后端构建或 sourcemap。未指定该条件时使用 `dist/server/plugin.js` 发布入口；开发条件仅用于已安装源码目录的本地环境。
+
+已有 `web` profile 安装本地目录时，在项目目录运行 `pnpm run dev`：先构建一次前端，再同时启动前端 Vite watch 和后端 dsh 源码模式。按 Ctrl+C 停止两者，任一进程退出时也会结束另一个。后端保留已有的 `NODE_OPTIONS`，可配合原来的调试器连接方式使用。只启动后端可运行 `pnpm run dev:server`。
+
+浏览器模块仍要求插件以裸包名 `@12inch-glorysoft/dsh-ad-form` 加载；直接引用 `src/plugin.ts` 不会加载浏览器侧页面。单独监听前端可运行 `pnpm run build:client --watch`。修改后端后重启 dsh，修改前端后刷新浏览器；宿主启用热重载时按其实际行为生效。配置保存在安装所用的 profile 中。
+
+也可通过 profile 配置中的 `!!js process.env.AD_FORM_DB_PASSWORD` 等表达式引用环境变量。命令行 overlay 的优先级高于 profile，应避免覆盖表单编辑的连接字段。
+
+### 发布与更新
+
+当前适配 DSH `0.2.1-rc.5`。
+
+```bash
+pnpm login --registry=https://registry.npmjs.org/
+pnpm check          # lint、格式检查、类型检查
+pnpm build          # prebuild 检查通过后构建前后端
+pnpm release:beta   # 递增 Beta 版本并发布
+pnpm release:stable # 转为正式版本并发布
+```
+
+`prerelease:beta` / `prerelease:stable` 负责递增版本，`release:*` 负责上传；上传前由 `prepack → prebuild → build` 完成检查和构建。格式检查失败可运行 `pnpm fmt` 修复。
+
+从 `1.0.0-beta.0` 开始：
+
+```text
+release:beta → 1.0.0-beta.1
+release:beta → 1.0.0-beta.2
+release:stable → 1.0.0
+release:beta → 1.0.1-beta.0
+```
+
+首次 Beta 后可直接转正式版。从正式版运行 `release:stable` 会递增补丁版本。脚本会修改本地版本号，不创建 Git 提交或 tag；发布成功后自行提交版本变更。
+
+发布失败时，先查看 `package.json`：版本已递增就保留，不再运行 `release:*`。修复检查、构建、登录或权限问题后，选择对应命令重试当前版本：
+
+```bash
+pnpm publish --tag beta --no-git-checks   # Beta
+pnpm publish --tag latest --no-git-checks # 正式版
+```
+
+若上传断网、超时或提示版本已存在，先确认是否已发布（替换为当前版本）：
+
+```bash
+pnpm view @12inch-glorysoft/dsh-ad-form@1.0.0-beta.1 version --registry=https://registry.npmjs.org/
+```
+
+查到版本就无需重发；确认不存在再重试。查询本身失败时，恢复网络或登录后再查。版本尚未递增时，修复问题后可重新执行 `release:*`。
+
+只演练、不上传也不改版本：
+
+```bash
+pnpm publish --tag beta --dry-run --no-git-checks
+```
+
+不要用 `release:* --dry-run` 演练，它仍会先递增版本。
+
+安装或更新后重启对应 profile；Desktop 用户将 `web` 改为 `desktop`：
+
+```bash
+dsh plugin --profile web add @12inch-glorysoft/dsh-ad-form@beta
+dsh plugin --profile web add @12inch-glorysoft/dsh-ad-form@latest
+```
+
+## 核心流程
+
+```
+需求或参考图 → 主模型理解与范围确认 → 布局规划和确认 → IR 构建或编辑 → 校验并输出 XML
+```
+
+## 技术栈
+
+- **平台**: dsh web (DeepSeek Harness)
+- **主模型**: 支持图片输入的多模态模型，直接理解创建与修改时的参考图
+- **规划子 Agent**: 接收主模型整理的有效需求、相关澄清、调整反馈与图片观察
+- **中间态**: Semantic IR JSON (ComponentNode AST, Single Source of Truth)
+- **插件框架**: Cordis 依赖注入 + 生命周期管理
+
+## 文档索引
+
+- [全局技术方案与实施规范](docs/technical-plan.md)：系统架构、Multi-Agent 协同编排流程、状态模型与演进规划
+- [Semantic IR 核心架构与规范体系](docs/semantic-ir/README.md)：领域元模型、组件全集、物理 XML DSL 与 ARB 避坑事实
+- [DSH 消息与上下文植入机制指南](docs/message-injection.md)：系统各层消息注入接缝、时序状态机与场景决策指南

package/cordis.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: ad-form
+      name: '@12inch-glorysoft/dsh-ad-form'

package/dist/client/client.js

@@ -0,0 +1,229 @@
+window.__ModuleLoader__.load({
+	id: "@12inch-glorysoft/dsh-ad-form",
+	factory(require) {
+		const module = { exports: {} };
+		const exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/index.tsx
+		var fields = [
+			"driver",
+			"host",
+			"port",
+			"database",
+			"user",
+			"password",
+			"owner"
+		];
+		var labels = {
+			host: ["数据库地址", "数据库服务器的主机名或 IP 地址"],
+			port: ["端口", "正整数；Oracle 常用 1521，MySQL 常用 3306，PostgreSQL 常用 5432"],
+			database: ["数据库", "Oracle 服务名，或 MySQL / PostgreSQL 库名"],
+			user: ["账号", "用于读取数据源和字典元数据的数据库账号"],
+			owner: ["元数据 schema", "可选；留空使用账号默认 schema"]
+		};
+		var drivers = [
+			{
+				value: "",
+				label: "未配置"
+			},
+			{
+				value: "oracle",
+				label: "Oracle"
+			},
+			{
+				value: "mysql",
+				label: "MySQL"
+			},
+			{
+				value: "postgres",
+				label: "PostgreSQL"
+			}
+		];
+		function connectionValue(value) {
+			if (!value || typeof value !== "object" || !("dataSource" in value)) return {};
+			const source = value.dataSource;
+			return source && typeof source === "object" ? source : {};
+		}
+		function invalidPort(text) {
+			return text.trim() !== "" && (!Number.isInteger(Number(text)) || Number(text) <= 0);
+		}
+		function connectionChanges(drafts, source, overridden, clearPassword) {
+			const operations = [];
+			for (const field of fields) {
+				if (field === "password") continue;
+				const raw = drafts[field];
+				if (raw === void 0) continue;
+				const value = raw.trim();
+				const path = ["dataSource", field];
+				if (value === "") {
+					if (Object.hasOwn(overridden, field)) operations.push({
+						op: "unset",
+						path
+					});
+				} else {
+					const next = field === "port" ? Number(value) : value;
+					if (source[field] !== next) operations.push({
+						op: "set",
+						path,
+						value: next
+					});
+				}
+			}
+			if (drafts.password) operations.push({
+				op: "set",
+				path: ["dataSource", "password"],
+				value: drafts.password
+			});
+			else if (clearPassword) operations.push({
+				op: "unset",
+				path: ["dataSource", "password"]
+			});
+			return operations;
+		}
+		function DatabaseSettings({ view, form, usePasswordConfigured }) {
+			const [drafts, setDrafts] = (0, react.useState)({});
+			const [clearPassword, setClearPassword] = (0, react.useState)(false);
+			const [saving, setSaving] = (0, react.useState)(false);
+			const [failed, setFailed] = (0, react.useState)(false);
+			const [revision, setRevision] = (0, react.useState)();
+			const passwordConfigured = usePasswordConfigured((configured) => configured);
+			const source = connectionValue(form?.state.value);
+			const overridden = connectionValue(form?.state.user);
+			const text = (field) => drafts[field] ?? String(source[field] ?? "");
+			const edit = (field, value) => {
+				setRevision((current) => current ?? form?.state.revision);
+				setDrafts((current) => ({
+					...current,
+					[field]: value
+				}));
+				setFailed(false);
+				if (field === "password" && value) setClearPassword(false);
+			};
+			const discard = () => {
+				setDrafts({});
+				setClearPassword(false);
+				setRevision(void 0);
+				setFailed(false);
+			};
+			const invalid = invalidPort(text("port"));
+			const operations = connectionChanges(drafts, source, overridden, clearPassword);
+			const dirty = operations.length > 0;
+			const save = async () => {
+				if (!form || saving || invalid || !dirty) return;
+				setSaving(true);
+				setFailed(false);
+				try {
+					if (await form.mutate(operations, revision ?? form.state.revision)) discard();
+					else {
+						setRevision(void 0);
+						setFailed(true);
+					}
+				} catch {
+					setRevision(void 0);
+					setFailed(true);
+				} finally {
+					setSaving(false);
+				}
+			};
+			if (view === "summary") return "设置表单设计所用的数据源与字典检索连接。";
+			const writable = form?.state.writable === true;
+			const disabled = !writable || saving;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.SettingsForm, {
+				labels: {
+					unavailable: "插件配置当前不可用，请确认 ad-form 已启用。",
+					readOnly: "当前配置为只读。",
+					saveFailed: "配置未保存，请检查输入；如果配置已被其他页面修改，请重新打开后再试。",
+					save: "保存",
+					saving: "保存中…"
+				},
+				state: {
+					available: form?.state.status === "ready",
+					writable,
+					dirty,
+					invalid,
+					saving,
+					failed
+				},
+				onSave: () => {
+					save();
+				},
+				onDiscard: discard,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: "连接仅在检索时建立。保存后新检索使用新配置，当前表单设计会保留。" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SegmentedControl, {
+						id: "ad-form-driver",
+						label: "数据库驱动",
+						value: text("driver"),
+						options: drivers,
+						disabled,
+						onChange: (value) => edit("driver", value)
+					}),
+					Object.entries(labels).map(([key, [label, hint]]) => {
+						const field = key;
+						return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SettingsValueField, {
+							id: `ad-form-${field}`,
+							label,
+							hint,
+							text: text(field),
+							overridden: drafts[field] === void 0 ? Object.hasOwn(overridden, field) : drafts[field].trim() !== "",
+							invalid: field === "port" && invalid,
+							invalidLabel: "请填写正整数端口。",
+							numeric: field === "port",
+							overriddenLabel: "已配置",
+							resetLabel: "清空",
+							disabled,
+							onEdit: (value) => edit(field, value),
+							onReset: () => edit(field, "")
+						}, field);
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SettingsSecretField, {
+						id: "ad-form-password",
+						label: "密码",
+						hint: "留空保留已保存的密码；如需删除，请点击清除密码。",
+						text: drafts.password ?? "",
+						configured: passwordConfigured && !clearPassword,
+						stateLabel: clearPassword ? "保存后清除密码" : passwordConfigured ? "已设置" : "未设置",
+						disabled,
+						onEdit: (value) => edit("password", value)
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						disabled: disabled || !passwordConfigured && !drafts.password || clearPassword,
+						onClick: () => {
+							setRevision((current) => current ?? form?.state.revision);
+							setDrafts((current) => ({
+								...current,
+								password: ""
+							}));
+							if (passwordConfigured) setClearPassword(true);
+							setFailed(false);
+						},
+						children: "清除密码"
+					})
+				]
+			});
+		}
+		var inject = ["slots", "configForms"];
+		function apply(ctx) {
+			const describe = ctx.configForms.describe();
+			const passwordConfigured = {
+				getSnapshot: () => {
+					return (describe.getSnapshot().view?.namespaces)?.find((item) => item.ns === "ad-form")?.secrets?.some((secret) => secret.path.length === 2 && secret.path[0] === "dataSource" && secret.path[1] === "password" && secret.set) ?? false;
+				},
+				subscribe: (listener) => describe.subscribe(listener)
+			};
+			ctx.effect(() => ctx.configForms.whileServed(["ad-form"], () => ctx.slots.inject("plugins.row.config", () => ctx.slots.register({
+				name: "plugins.row.config",
+				key: "@12inch-glorysoft/dsh-ad-form#ad-form",
+				inject: () => ({ hooks: { passwordConfigured } })
+			}, DatabaseSettings))));
+		}
+		//#endregion
+		exports.DatabaseSettings = DatabaseSettings;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/dist/server/_virtual/_rolldown/runtime.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll };

package/dist/server/agents/plan-preset.js

@@ -0,0 +1,17 @@
+import { PLAN_PERSONA } from "../prompt/plan.js";
+import { TOOL_NAMES } from "../tools/catalog.js";
+import { PERSONA_PREFIX_SECTION } from "@deepseek-ai/dsh-system-prompt";
+//#region src/agents/plan-preset.ts
+var PLAN_PRESET_ID = "ad-form-plan";
+var name = "ad-form-plan-preset";
+var inject = ["systemPrompt", "tools"];
+function apply(ctx) {
+	ctx.systemPrompt.section({
+		name: PERSONA_PREFIX_SECTION,
+		order: ctx.systemPrompt.getSectionOrder("DEPLOYMENT_PERSONA_PREFIX"),
+		text: PLAN_PERSONA
+	});
+	ctx.tools.restrict({ allow: [TOOL_NAMES.getComponentSpec, TOOL_NAMES.validatePlan] });
+}
+//#endregion
+export { PLAN_PRESET_ID, apply, inject, name };

package/dist/server/agents/plan-review.js

@@ -0,0 +1,60 @@
+import { PLAN_REVIEW_LABELS } from "../plan/review-spec.js";
+import { buildPlanReviewPrompt } from "../prompt/plan.js";
+import { TOOL_NAMES } from "../tools/catalog.js";
+import { VALIDATE_PLAN_SCHEMA } from "../tools/validate-plan/schema.js";
+import { injectMessageWithTool } from "../util/message.js";
+import { validateJsonSchemaValue } from "@deepseek-ai/dsh-tools";
+import { isDeepStrictEqual } from "node:util";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+//#region src/agents/plan-review.ts
+var mountPlanReview = (agent, evidence, replySchema) => {
+	const checkReview = (value, allowUnresolved = false) => {
+		const shapeIssues = validateJsonSchemaValue(replySchema, value);
+		if (shapeIssues.length) return ["规划结果需要完整的 plan 与四项 review 结论。", ...shapeIssues];
+		const reply = value;
+		const issues = [];
+		if (!hook.isEnter()) issues.push("当前候选的复检任务尚未进入后续模型请求；请校验候选并读取复检任务后提交。");
+		if (hook.state.pending && !isDeepStrictEqual(reply.plan, hook.state.pending)) issues.push("plan 与最近通过校验的候选不一致；请校验修改后的完整计划并复检。");
+		const ids = new Set(reply.plan.units.map((unit) => unit.id));
+		const reviewKeys = Object.keys(PLAN_REVIEW_LABELS);
+		for (const key of reviewKeys) {
+			const review = reply.review[key];
+			if (!review) {
+				issues.push(`review.${key} 缺失；请提供该项复检结论。`);
+				continue;
+			}
+			if (!review.evidence.trim()) issues.push(`review.${key}.evidence 为空；请提供需求依据与实际节点关系的核对结论。`);
+			if (!review.nodeIds.length) issues.push(`review.${key}.nodeIds 为空；请引用本项核对的区域。`);
+			for (const id of review.nodeIds) if (!ids.has(id)) issues.push(`review.${key}.nodeIds 引用了不存在的区域 ${id}；请引用当前计划节点。`);
+		}
+		if (!allowUnresolved && reply.review.unresolvedIssues.length) issues.push(...reply.review.unresolvedIssues.map((issue) => `布局复检未解决：${issue}`));
+		return issues;
+	};
+	const hook = injectMessageWithTool(agent, TOOL_NAMES.validatePlan, {
+		toolOutputSchema: VALIDATE_PLAN_SCHEMA,
+		when: (r) => r?.valid === true,
+		message: (r, exec, decision, state) => {
+			const task = buildPlanReviewPrompt(evidence, state.pending, state.round);
+			return createUserMessage({
+				content: [{
+					type: "text",
+					text: task
+				}],
+				source: {
+					kind: "ad-form-plan-review",
+					form: "notice",
+					summary: `布局复检任务（候选 ${state.round}）`
+				}
+			});
+		},
+		guard: { check: (output) => {
+			return checkReview(output, true);
+		} }
+	});
+	return {
+		checkReview,
+		dispose: hook.dispose
+	};
+};
+//#endregion
+export { mountPlanReview };

package/dist/server/agents/plan-schema.js

@@ -0,0 +1,21 @@
+import { PLAN_REVIEW_SPEC } from "../plan/review-spec.js";
+import { PLAN_SPEC } from "../plan/spec.js";
+import { valueSchemaSpecToJsonSchema } from "@deepseek-ai/dsh-tools";
+//#region src/agents/plan-schema.ts
+var PLAN_REPLY_SPEC = {
+	type: "object",
+	additionalProperties: false,
+	properties: {
+		plan: {
+			...PLAN_SPEC,
+			required: true
+		},
+		review: {
+			...PLAN_REVIEW_SPEC,
+			required: true
+		}
+	}
+};
+var PLAN_REPLY_SCHEMA = valueSchemaSpecToJsonSchema(PLAN_REPLY_SPEC);
+//#endregion
+export { PLAN_REPLY_SCHEMA, PLAN_REPLY_SPEC };

package/dist/server/agents/plan.js

@@ -0,0 +1,80 @@
+import { buildPlanPrompt, buildPlanReviewEvidence } from "../prompt/plan.js";
+import { PLAN_PRESET_ID } from "./plan-preset.js";
+import { extractText } from "./util.js";
+import { mountPlanReview } from "./plan-review.js";
+import { PLAN_REPLY_SCHEMA } from "./plan-schema.js";
+import { SessionId } from "@deepseek-ai/dsh-session";
+import { randomUUID } from "node:crypto";
+import { addAbortListener } from "node:events";
+//#region src/agents/plan.ts
+/** 在独立子会话中等待布局计划与复检记录。 */
+async function runPlanSubagent(ctx, parent, signal, input, label) {
+	const [prompt, reviewEvidence] = await Promise.all([buildPlanPrompt(input), buildPlanReviewEvidence(input)]);
+	signal.throwIfAborted();
+	const childId = SessionId(randomUUID());
+	const reviewBinding = bindPlanReview(ctx, childId, reviewEvidence);
+	let run;
+	let cancellation;
+	try {
+		run = await ctx.subagents.startActivation({
+			provider: "spawn",
+			childId,
+			label: label ?? "布局规划",
+			request: {
+				agentPreset: PLAN_PRESET_ID,
+				prompt: [{
+					type: "text",
+					text: prompt
+				}],
+				parent,
+				outputSchema: PLAN_REPLY_SCHEMA
+			},
+			signal,
+			delivery: "caller"
+		});
+		cancellation = cancelPlanOnAbort(ctx, run, signal);
+		const review = reviewBinding.current();
+		if (!review) return {
+			stopReason: "error",
+			reviewIssues: ["当前规划执行未提供本地子会话，无法触发布局复检；新计划未保存。"],
+			text: ""
+		};
+		const result = await run.result;
+		return {
+			stopReason: result.stopReason,
+			structured: result.structured,
+			reviewIssues: review.checkReview(result.structured),
+			text: extractText(result.output),
+			diagnostic: result.diagnostic
+		};
+	} finally {
+		cancellation?.[Symbol.dispose]();
+		try {
+			await run?.dispose();
+		} finally {
+			reviewBinding.dispose();
+		}
+	}
+}
+function bindPlanReview(ctx, childId, evidence) {
+	let review;
+	const unwatch = ctx.on("agent/created", ({ agent }) => {
+		if (agent.id === childId) review = mountPlanReview(agent, evidence, PLAN_REPLY_SCHEMA);
+	});
+	return {
+		current: () => review,
+		dispose: () => {
+			unwatch();
+			review?.dispose();
+		}
+	};
+}
+function cancelPlanOnAbort(ctx, run, signal) {
+	return addAbortListener(signal, () => {
+		run.dispose().catch((error) => {
+			ctx.logger("ad-form-agent").error("规划子会话中断清理失败：", error);
+		});
+	});
+}
+//#endregion
+export { runPlanSubagent };

package/dist/server/agents/util.js

@@ -0,0 +1,16 @@
+//#region src/agents/util.ts
+function extractText(blocks = []) {
+	return blocks.filter((block) => block.type === "text").map((block) => block.text).join("\n").trim();
+}
+/**
+* 从任务描述中提取精炼的短标题（用于 dsh label 展示），剥离 Markdown 与换行并优先取首句。
+*/
+function cleanTaskTitle(text, fallback = "直接构建", maxLen = 14) {
+	if (!text || !text.trim()) return fallback;
+	const clean = text.replace(/^#+\s+/gm, "").replace(/^[-*+]\s+/gm, "").replace(/[`*_~]/g, "").replace(/[\r\n\t]+/g, " ").trim();
+	const firstSentence = clean.split(/[，。,；;！!？?\n]/)[0]?.trim() || clean;
+	if (firstSentence.length <= maxLen) return firstSentence;
+	return `${firstSentence.slice(0, maxLen)}…`;
+}
+//#endregion
+export { cleanTaskTitle, extractText };

package/dist/server/converter/components/actions/button.js

@@ -0,0 +1,39 @@
+import { BUTTON_TAG, CATEGORY_TAG, DATAFROM_TAG, FIELDRRN_TAG, FORMRRN_TAG, IMAGE_TAG, ISAUTHORITY_TAG, ISUSEDEFAULT_TAG, LABEL_TAG, LABEL_ZH_TAG, NAME_TAG, SEPARATOR_TAG, SEQNO_TAG, STYLE_TAG, TABLERRN_TAG, TABRRN_TAG } from "../../xml-tags.js";
+import { XmlNode } from "../../utils/xml-builder.js";
+import { toXmlBoolean } from "../../utils/normalizer.js";
+import { generateNodeId } from "../../utils/id.js";
+import { appendBaseMetadata } from "../../xml-common.js";
+import { defineIr2Xml } from "../../registry.js";
+//#region src/converter/components/actions/button.ts
+/**
+* 构造 <ADBUTTON> 骨架标签
+*/
+defineIr2Xml("action:button", (node, ctx) => {
+	const xml = new XmlNode(BUTTON_TAG);
+	appendBaseMetadata(xml, ctx, generateNodeId(node));
+	const formRrn = ctx.currentForm?.uniqueId;
+	const tableRrn = ctx.currentTable?.uniqueId;
+	const tabRrn = ctx.currentTab?.uniqueId;
+	const fieldRrn = ctx.currentField?.uniqueId;
+	if (fieldRrn) {
+		xml.createRequiredChild(FIELDRRN_TAG, fieldRrn);
+		xml.createRequiredChild(TABLERRN_TAG, tableRrn);
+	} else if (tabRrn) {
+		xml.createRequiredChild(TABRRN_TAG, tabRrn);
+		xml.createRequiredChild(TABLERRN_TAG, tableRrn);
+	} else xml.createRequiredChild(FORMRRN_TAG, formRrn);
+	xml.createRequiredChild(NAME_TAG, node.id);
+	xml.createChildIfPresent(LABEL_TAG, node.label);
+	xml.createChildIfPresent(LABEL_ZH_TAG, node.labelZh);
+	xml.createChildIfPresent(CATEGORY_TAG, node.action?.placement === "collection" ? "Block" : "");
+	xml.createChildIfPresent(IMAGE_TAG, node.action?.iconSymbol);
+	xml.createChildIfPresent(SEQNO_TAG, node.layout?.sequenceOrder);
+	xml.createChildIfPresent(ISUSEDEFAULT_TAG, toXmlBoolean(node.action?.useStandardHandler ?? true));
+	xml.createChildIfPresent(ISAUTHORITY_TAG, toXmlBoolean(node.action?.requiresPermission ?? false));
+	xml.createChildIfPresent(SEPARATOR_TAG, toXmlBoolean(node.action?.isSeparator ?? false));
+	xml.createRequiredChild(STYLE_TAG, "0");
+	xml.createChildIfPresent(DATAFROM_TAG, node.action?.dataContextSource);
+	return xml;
+});
+//#endregion
+export {};

package/dist/server/converter/components/actions/index.js

@@ -0,0 +1,2 @@
+import "./button.js";
+export {};

package/dist/server/converter/components/composites/entity-form.js

@@ -0,0 +1,14 @@
+import { FIELD_TABLE_TAG, NAME_TAG, REFERENCERULE_TAG } from "../../xml-tags.js";
+import { buildCommonField, buildTable } from "../../xml-common.js";
+import { defineIr2Xml } from "../../registry.js";
+//#region src/converter/components/composites/entity-form.ts
+defineIr2Xml("composite:entity-form", (node, ctx) => {
+	const xml = buildCommonField(node, ctx);
+	const fieldTable = buildTable(node, ctx);
+	fieldTable.tag = FIELD_TABLE_TAG;
+	xml.createOrReplaceChild(REFERENCERULE_TAG, fieldTable.findChild(NAME_TAG)?.getText());
+	xml.addChild(fieldTable);
+	return xml;
+});
+//#endregion
+export {};

package/dist/server/converter/components/composites/filter-table.js

@@ -0,0 +1,24 @@
+import { FIELD_TABLE_TAG, NAME_TAG, REFERENCERULE_TAG } from "../../xml-tags.js";
+import { toXmlBoolean_YN } from "../../utils/normalizer.js";
+import { buildCommonField, buildTable } from "../../xml-common.js";
+import { defineIr2Xml } from "../../registry.js";
+//#region src/converter/components/composites/filter-table.ts
+defineIr2Xml("composite:filter-table", (node, ctx) => {
+	const xml = buildCommonField(node, ctx);
+	const fieldTable = buildTable(node, ctx);
+	fieldTable.tag = FIELD_TABLE_TAG;
+	xml.createOrReplaceChild(REFERENCERULE_TAG, fieldTable.findChild(NAME_TAG)?.getText());
+	xml.addChild(fieldTable);
+	ctx.collectFormatAttribute(node, "ShowCondition", toXmlBoolean_YN(node.props?.showCondition));
+	ctx.collectFormatAttribute(node, "ShowQueryButton", toXmlBoolean_YN(node.props?.showQueryButton));
+	ctx.collectFormatAttribute(node, "ShowProgressPanel", toXmlBoolean_YN(node.props?.showProgressPanel));
+	ctx.collectFormatAttribute(node, "ShowCount", toXmlBoolean_YN(node.props?.showCount));
+	ctx.collectFormatAttribute(node, "IsCustomQuery", toXmlBoolean_YN(node.props?.isCustomQuery));
+	ctx.collectFormatAttribute(node, "QueryTimeOut", node.props?.queryTimeOut);
+	ctx.collectFormatAttribute(node, "ShowCheckBox", toXmlBoolean_YN(node.props?.showCheckBox));
+	ctx.collectFormatAttribute(node, "ShowIndex", toXmlBoolean_YN(node.props?.showRowIndex));
+	ctx.collectFormatAttribute(node, "ItemAdapter", node.props?.itemAdapter);
+	return xml;
+});
+//#endregion
+export {};

package/dist/server/converter/components/composites/index.js

@@ -0,0 +1,3 @@
+import "./entity-form.js";
+import "./filter-table.js";
+export {};