dsh-d365-kit 0.34.1 → 0.34.3

package/lib/tool-migrate.js

@@ -1,102 +1,102 @@
-/**
- * `d365_migrate` — will this solution zip hurt when imported elsewhere?
- *
- * Importing a solution silently stacks a new layer on every component it
- * contains, and stacking order is decided by import time, not by version. This
- * tool answers the questions a release engineer actually asks before pressing
- * import: does the target have this solution, which solutions' definitions will
- * be hidden underneath, and will any option-set values disappear.
- */
-import { loadConfig } from './config.js'
-import { assessMigration } from './migrate.js'
-
-export const definition = {
-  name: 'd365_migrate',
-  description:
-    '评估把某个解决方案从源环境发布到其它环境的迁移风险：目标是否已有该解决方案、每个组件在目标环境的层会被谁覆盖、'
-    + '选项集会不会丢值。只读，不会修改任何环境。',
-  parameters: {
-    type: 'object',
-    additionalProperties: false,
-    required: ['solution'],
-    properties: {
-      action: {
-        type: 'string',
-        enum: ['assess'],
-        description: '评估动作，目前只有 assess。默认 assess。',
-      },
-      source: {
-        type: 'string',
-        description: '源环境 key，例如 dev。省略则用默认环境。',
-      },
-      solution: {
-        type: 'string',
-        description: '要评估的解决方案唯一名，例如 ContosoBase。',
-      },
-      targets: {
-        type: 'array',
-        items: { type: 'string' },
-        description: '目标环境 key 列表，例如 ["sit","uat"]。省略则除源环境外的全部环境。',
-      },
-      maxComponents: {
-        type: 'integer',
-        description: '最多评估多少个组件，默认 150。单组件层查询约 1.8 秒，并发 4 时约 70 秒。',
-      },
-      full: {
-        type: 'boolean',
-        description: '忽略 maxComponents，评估全部组件（364 个组件约 3 分钟）。',
-      },
-      concurrency: {
-        type: 'integer',
-        description: '并发请求数，默认 4，最大 8。调高会更快，也更容易触发服务保护。',
-      },
-    },
-  },
-  output: {
-    schema: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['text'],
-      properties: {
-        text: { type: 'string' },
-      },
-    },
-    render(_args, value) {
-      return [{ type: 'text', text: value?.text ?? '' }]
-    },
-  },
-}
-
-function renderResult(result) {
-  const lines = []
-  lines.push(`迁移评估：${result.solution}（${result.source.label}）`)
-  lines.push(
-    `组件 ${result.componentCount} 个，本次评估 ${result.evaluated} 个`
-    + (result.truncated ? `（超过 maxComponents=${result.maxComponents}，传 full: true 可全量评估）` : ''),
-  )
-  lines.push('')
-  lines.push('| 目标环境 | 严重 | 警告 | 目标缺失组件 | 会被遮蔽的解决方案 |')
-  lines.push('| --- | --- | --- | --- | --- |')
-  for (const report of result.reports) {
-    lines.push(`| ${report.targetLabel} | ${report.critical} | ${report.warnings} | ${report.missing} | ${report.shadowed} |`)
-  }
-  for (const report of result.reports) {
-    lines.push('')
-    lines.push(`### ${report.targetLabel}`)
-    lines.push(report.verdict.summary)
-    if (report.verdict.recommendation) lines.push(`建议：${report.verdict.recommendation}`)
-    lines.push(`报告：${report.reportPath}`)
-  }
-  return lines.join('\n')
-}
-
-export function register(ctx, state) {
-  return ctx.tools.register({
-    ...definition,
-    async execute(args, exec) {
-      const config = await loadConfig(state.rawConfig)
-      const result = await assessMigration(config, args ?? {}, exec?.signal)
-      return { text: renderResult(result) }
-    },
-  })
-}
+/**
+ * `d365_migrate` — will this solution zip hurt when imported elsewhere?
+ *
+ * Importing a solution silently stacks a new layer on every component it
+ * contains, and stacking order is decided by import time, not by version. This
+ * tool answers the questions a release engineer actually asks before pressing
+ * import: does the target have this solution, which solutions' definitions will
+ * be hidden underneath, and will any option-set values disappear.
+ */
+import { loadConfig } from './config.js'
+import { assessMigration } from './migrate.js'
+
+export const definition = {
+  name: 'd365_migrate',
+  description:
+    '评估把某个解决方案从源环境发布到其它环境的迁移风险：目标是否已有该解决方案、每个组件在目标环境的层会被谁覆盖、'
+    + '选项集会不会丢值。只读，不会修改任何环境。',
+  parameters: {
+    type: 'object',
+    additionalProperties: false,
+    required: ['solution'],
+    properties: {
+      action: {
+        type: 'string',
+        enum: ['assess'],
+        description: '评估动作，目前只有 assess。默认 assess。',
+      },
+      source: {
+        type: 'string',
+        description: '源环境 key，例如 dev。省略则用默认环境。',
+      },
+      solution: {
+        type: 'string',
+        description: '要评估的解决方案唯一名，例如 ContosoBase。',
+      },
+      targets: {
+        type: 'array',
+        items: { type: 'string' },
+        description: '目标环境 key 列表，例如 ["sit","uat"]。省略则除源环境外的全部环境。',
+      },
+      maxComponents: {
+        type: 'integer',
+        description: '最多评估多少个组件，默认 150。单组件层查询约 1.8 秒，并发 4 时约 70 秒。',
+      },
+      full: {
+        type: 'boolean',
+        description: '忽略 maxComponents，评估全部组件（364 个组件约 3 分钟）。',
+      },
+      concurrency: {
+        type: 'integer',
+        description: '并发请求数，默认 4，最大 8。调高会更快，也更容易触发服务保护。',
+      },
+    },
+  },
+  output: {
+    schema: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['text'],
+      properties: {
+        text: { type: 'string' },
+      },
+    },
+    render(_args, value) {
+      return [{ type: 'text', text: value?.text ?? '' }]
+    },
+  },
+}
+
+function renderResult(result) {
+  const lines = []
+  lines.push(`迁移评估：${result.solution}（${result.source.label}）`)
+  lines.push(
+    `组件 ${result.componentCount} 个，本次评估 ${result.evaluated} 个`
+    + (result.truncated ? `（超过 maxComponents=${result.maxComponents}，传 full: true 可全量评估）` : ''),
+  )
+  lines.push('')
+  lines.push('| 目标环境 | 严重 | 警告 | 目标缺失组件 | 会被遮蔽的解决方案 |')
+  lines.push('| --- | --- | --- | --- | --- |')
+  for (const report of result.reports) {
+    lines.push(`| ${report.targetLabel} | ${report.critical} | ${report.warnings} | ${report.missing} | ${report.shadowed} |`)
+  }
+  for (const report of result.reports) {
+    lines.push('')
+    lines.push(`### ${report.targetLabel}`)
+    lines.push(report.verdict.summary)
+    if (report.verdict.recommendation) lines.push(`建议：${report.verdict.recommendation}`)
+    lines.push(`报告：${report.reportPath}`)
+  }
+  return lines.join('\n')
+}
+
+export function register(ctx, state) {
+  return ctx.tools.register({
+    ...definition,
+    async execute(args, exec) {
+      const config = await loadConfig(state.rawConfig)
+      const result = await assessMigration(config, args ?? {}, exec?.signal)
+      return { text: renderResult(result) }
+    },
+  })
+}

package/lib/tool-refs.js

@@ -1,206 +1,206 @@
-/**
- * `d365_refs` — the reverse question: who uses this?
- *
- * `d365_metadata` answers "does it exist"; `d365_layers` answers "who overrides
- * it"; this answers "what breaks if I remove or rename it". Every branch reads
- * stored definitions (formxml, layoutxml/fetchxml, workflow clientdata) and
- * reports exact matches, so the answer is evidence rather than a guess.
- */
-import { loadConfig } from './config.js'
-import { makeClient, pickEnvironments, writeArtifact } from './runtime.js'
-import { D365Error } from './errors.js'
-import {
-  findFieldAutomations,
-  findFieldForms,
-  findFieldViews,
-  findPluginUsage,
-  findResourceForms,
-} from './refs.js'
-
-const KINDS = ['field', 'web_resource', 'plugin_assembly']
-
-export const definition = {
-  name: 'd365_refs',
-  description:
-    '反查引用：某个字段被哪些表单/视图/流程使用，某个 Web 资源被哪些表单加载，某个插件程序集有哪些注册类型与步骤。'
-    + '用于判断"改这个/删这个会不会坏"，与 d365_layers（谁覆盖）互补。可一次查多个环境。',
-  parameters: {
-    type: 'object',
-    additionalProperties: false,
-    required: ['kind'],
-    properties: {
-      kind: {
-        type: 'string',
-        enum: KINDS,
-        description: 'field：字段引用；web_resource：表单脚本引用；plugin_assembly：插件注册情况。',
-      },
-      entity: {
-        type: 'string',
-        description: 'kind=field 时必填：字段所属实体逻辑名，例如 account。',
-      },
-      attribute: {
-        type: 'string',
-        description: 'kind=field 时必填：字段逻辑名，例如 contoso_customertier。',
-      },
-      name: {
-        type: 'string',
-        description: 'kind=web_resource 时填 Web 资源名称（如 contoso_/scripts/account_form.js）；kind=plugin_assembly 时填程序集名（如 Contoso.Customizations）。',
-      },
-      environment: {
-        type: 'string',
-        description: '环境 key，例如 dev。省略则用默认环境。',
-      },
-      environments: {
-        type: 'array',
-        items: { type: 'string' },
-        description: '一次查多个环境，例如 ["dev","sit"]。',
-      },
-      allEnvironments: {
-        type: 'boolean',
-        description: '对全部已配置环境执行同一查询。',
-      },
-    },
-  },
-  output: {
-    schema: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['text'],
-      properties: {
-        text: { type: 'string' },
-      },
-    },
-    render(_args, value) {
-      return [{ type: 'text', text: value?.text ?? '' }]
-    },
-  },
-}
-
-/** Render a field reference report for one environment. */
-function renderField(env, entity, attribute, result) {
-  const lines = [`字段 ${entity}.${attribute} 的引用（${env.key}）`]
-  const total = result.forms.length + result.views.length + result.automations.length
-
-  lines.push('', `表单：${result.forms.length} 张`)
-  for (const form of result.forms.slice(0, 10)) {
-    lines.push(`- ${form.name}（${form.typeLabel}${form.managed ? '，受管' : ''}${form.visible ? '' : '，字段被隐藏'}）`)
-  }
-  if (result.forms.length > 10) lines.push(`- … 其余 ${result.forms.length - 10} 张见文件`)
-
-  const layout = result.views.filter((view) => view.inLayout).length
-  const filtered = result.views.filter((view) => view.inFilter).length
-  lines.push('', `视图：${result.views.length} 个（列 ${layout} / 筛选条件 ${filtered}）`)
-  for (const view of result.views.slice(0, 10)) {
-    const usage = [view.inLayout ? '显示列' : null, view.inFilter ? '筛选条件' : null].filter(Boolean).join('+')
-    lines.push(`- ${view.name}（${usage}${view.default ? '，默认视图' : ''}）`)
-  }
-  if (result.views.length > 10) lines.push(`- … 其余 ${result.views.length - 10} 个见文件`)
-
-  lines.push('', `流程/业务规则：${result.automations.length} 个`)
-  for (const item of result.automations.slice(0, 10)) {
-    lines.push(`- ${item.name}（${item.category}，${item.state}）`)
-  }
-  if (result.automations.length > 10) lines.push(`- … 其余 ${result.automations.length - 10} 个见文件`)
-
-  lines.push(
-    '',
-    total
-      ? `结论：共 ${total} 处引用；删除或改名会同时影响上述位置。`
-      : '结论：没有找到引用。注意本工具按实体过滤表单，快速查看表单里引用其它实体字段的情况不在范围内。',
-  )
-  return lines.join('\n')
-}
-
-/** Render a web resource report for one environment. */
-function renderResource(env, name, forms) {
-  const lines = [`Web 资源 ${name} 的引用（${env.key}）`]
-  if (!forms.length) {
-    lines.push('', '结论：没有表单引用这个库。若它是 ribbon 命令或独立加载的脚本，这不代表它没在用。')
-    return lines.join('\n')
-  }
-  lines.push('', `表单：${forms.length} 张`)
-  let handlers = 0
-  for (const form of forms.slice(0, 12)) {
-    handlers += form.handlers.length
-    const names = form.handlers.map((h) => `${h.event || '?'}→${h.functionName || '?'}`).join('，')
-    lines.push(`- ${form.name}（${form.typeLabel}，${form.entity}）${names ? `：${names}` : ''}`)
-  }
-  if (forms.length > 12) lines.push(`- … 其余 ${forms.length - 12} 张见文件`)
-  lines.push('', `结论：${forms.length} 张表单加载该库，共 ${handlers} 个事件处理器；改函数名或删文件会让这些处理器失效。`)
-  return lines.join('\n')
-}
-
-/** Render a plugin assembly report for one environment. */
-function renderAssembly(env, name, result) {
-  const { assembly, types } = result
-  const lines = [
-    `插件程序集 ${assembly.name} 的注册情况（${env.key}）`,
-    `版本：${assembly.version ?? '未知'}，隔离模式：${assembly.isolation ?? '?'}`,
-    `类型：${types.length} 个`,
-  ]
-  let stepCount = 0
-  let disabled = 0
-  for (const type of types.slice(0, 12)) {
-    stepCount += type.steps.length
-    disabled += type.steps.filter((step) => !step.enabled).length
-    lines.push('', `- ${type.typename}`)
-    if (!type.steps.length) lines.push('  （没有注册步骤）')
-    for (const step of type.steps.slice(0, 8)) {
-      const filter = step.filteringAttributes ? `，过滤 ${step.filteringAttributes}` : ''
-      lines.push(`  · ${step.name}（stage ${step.stage}，mode ${step.mode}，rank ${step.rank ?? 1}${filter}${step.enabled ? '' : '，已停用'}）`)
-    }
-    if (type.steps.length > 8) lines.push(`  · … 其余 ${type.steps.length - 8} 步见文件`)
-  }
-  if (types.length > 12) lines.push(`… 其余 ${types.length - 12} 个类型见文件`)
-  lines.push('', `结论：共 ${stepCount} 个步骤${disabled ? `，其中 ${disabled} 个已停用` : ''}。`)
-  return lines.join('\n')
-}
-
-export function register(ctx, state) {
-  return ctx.tools.register({
-    ...definition,
-    async execute(args, exec) {
-      const config = await loadConfig(state.rawConfig)
-      const kind = args.kind
-      if (!KINDS.includes(kind)) {
-        throw new D365Error(`不认识的查询类型：${kind}`, { code: 'unknown-kind', hint: `可选：${KINDS.join(' / ')}` })
-      }
-      if (kind === 'field' && (!args.entity || !args.attribute)) {
-        throw new D365Error('kind=field 需要 entity 和 attribute', { code: 'missing-field' })
-      }
-      if (kind !== 'field' && !args.name) {
-        throw new D365Error(`kind=${kind} 需要 name`, { code: 'missing-name' })
-      }
-
-      const envs = pickEnvironments(config, args)
-      const sections = []
-      const artifact = { kind, entity: args.entity, attribute: args.attribute, name: args.name, environments: {} }
-
-      for (const env of envs) {
-        const client = makeClient(env, config)
-        let text
-        if (kind === 'field') {
-          const result = {
-            forms: await findFieldForms(client, args.entity, args.attribute, exec?.signal),
-            views: await findFieldViews(client, args.entity, args.attribute, exec?.signal),
-            automations: await findFieldAutomations(client, args.entity, args.attribute, exec?.signal),
-          }
-          artifact.environments[env.key] = result
-          text = renderField(env, args.entity, args.attribute, result)
-        } else if (kind === 'web_resource') {
-          const forms = await findResourceForms(client, args.name, exec?.signal)
-          artifact.environments[env.key] = { forms }
-          text = renderResource(env, args.name, forms)
-        } else {
-          const result = await findPluginUsage(client, args.name, exec?.signal)
-          artifact.environments[env.key] = result
-          text = renderAssembly(env, args.name, result)
-        }
-        sections.push(text)
-      }
-
-      const file = await writeArtifact(config, `refs-${kind}`, artifact)
-      return { text: `${sections.join('\n\n')}\n\n完整结果：${file}` }
-    },
-  })
-}
+/**
+ * `d365_refs` — the reverse question: who uses this?
+ *
+ * `d365_metadata` answers "does it exist"; `d365_layers` answers "who overrides
+ * it"; this answers "what breaks if I remove or rename it". Every branch reads
+ * stored definitions (formxml, layoutxml/fetchxml, workflow clientdata) and
+ * reports exact matches, so the answer is evidence rather than a guess.
+ */
+import { loadConfig } from './config.js'
+import { makeClient, pickEnvironments, writeArtifact } from './runtime.js'
+import { D365Error } from './errors.js'
+import {
+  findFieldAutomations,
+  findFieldForms,
+  findFieldViews,
+  findPluginUsage,
+  findResourceForms,
+} from './refs.js'
+
+const KINDS = ['field', 'web_resource', 'plugin_assembly']
+
+export const definition = {
+  name: 'd365_refs',
+  description:
+    '反查引用：某个字段被哪些表单/视图/流程使用，某个 Web 资源被哪些表单加载，某个插件程序集有哪些注册类型与步骤。'
+    + '用于判断"改这个/删这个会不会坏"，与 d365_layers（谁覆盖）互补。可一次查多个环境。',
+  parameters: {
+    type: 'object',
+    additionalProperties: false,
+    required: ['kind'],
+    properties: {
+      kind: {
+        type: 'string',
+        enum: KINDS,
+        description: 'field：字段引用；web_resource：表单脚本引用；plugin_assembly：插件注册情况。',
+      },
+      entity: {
+        type: 'string',
+        description: 'kind=field 时必填：字段所属实体逻辑名，例如 account。',
+      },
+      attribute: {
+        type: 'string',
+        description: 'kind=field 时必填：字段逻辑名，例如 contoso_customertier。',
+      },
+      name: {
+        type: 'string',
+        description: 'kind=web_resource 时填 Web 资源名称（如 contoso_/scripts/account_form.js）；kind=plugin_assembly 时填程序集名（如 Contoso.Customizations）。',
+      },
+      environment: {
+        type: 'string',
+        description: '环境 key，例如 dev。省略则用默认环境。',
+      },
+      environments: {
+        type: 'array',
+        items: { type: 'string' },
+        description: '一次查多个环境，例如 ["dev","sit"]。',
+      },
+      allEnvironments: {
+        type: 'boolean',
+        description: '对全部已配置环境执行同一查询。',
+      },
+    },
+  },
+  output: {
+    schema: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['text'],
+      properties: {
+        text: { type: 'string' },
+      },
+    },
+    render(_args, value) {
+      return [{ type: 'text', text: value?.text ?? '' }]
+    },
+  },
+}
+
+/** Render a field reference report for one environment. */
+function renderField(env, entity, attribute, result) {
+  const lines = [`字段 ${entity}.${attribute} 的引用（${env.key}）`]
+  const total = result.forms.length + result.views.length + result.automations.length
+
+  lines.push('', `表单：${result.forms.length} 张`)
+  for (const form of result.forms.slice(0, 10)) {
+    lines.push(`- ${form.name}（${form.typeLabel}${form.managed ? '，受管' : ''}${form.visible ? '' : '，字段被隐藏'}）`)
+  }
+  if (result.forms.length > 10) lines.push(`- … 其余 ${result.forms.length - 10} 张见文件`)
+
+  const layout = result.views.filter((view) => view.inLayout).length
+  const filtered = result.views.filter((view) => view.inFilter).length
+  lines.push('', `视图：${result.views.length} 个（列 ${layout} / 筛选条件 ${filtered}）`)
+  for (const view of result.views.slice(0, 10)) {
+    const usage = [view.inLayout ? '显示列' : null, view.inFilter ? '筛选条件' : null].filter(Boolean).join('+')
+    lines.push(`- ${view.name}（${usage}${view.default ? '，默认视图' : ''}）`)
+  }
+  if (result.views.length > 10) lines.push(`- … 其余 ${result.views.length - 10} 个见文件`)
+
+  lines.push('', `流程/业务规则：${result.automations.length} 个`)
+  for (const item of result.automations.slice(0, 10)) {
+    lines.push(`- ${item.name}（${item.category}，${item.state}）`)
+  }
+  if (result.automations.length > 10) lines.push(`- … 其余 ${result.automations.length - 10} 个见文件`)
+
+  lines.push(
+    '',
+    total
+      ? `结论：共 ${total} 处引用；删除或改名会同时影响上述位置。`
+      : '结论：没有找到引用。注意本工具按实体过滤表单，快速查看表单里引用其它实体字段的情况不在范围内。',
+  )
+  return lines.join('\n')
+}
+
+/** Render a web resource report for one environment. */
+function renderResource(env, name, forms) {
+  const lines = [`Web 资源 ${name} 的引用（${env.key}）`]
+  if (!forms.length) {
+    lines.push('', '结论：没有表单引用这个库。若它是 ribbon 命令或独立加载的脚本，这不代表它没在用。')
+    return lines.join('\n')
+  }
+  lines.push('', `表单：${forms.length} 张`)
+  let handlers = 0
+  for (const form of forms.slice(0, 12)) {
+    handlers += form.handlers.length
+    const names = form.handlers.map((h) => `${h.event || '?'}→${h.functionName || '?'}`).join('，')
+    lines.push(`- ${form.name}（${form.typeLabel}，${form.entity}）${names ? `：${names}` : ''}`)
+  }
+  if (forms.length > 12) lines.push(`- … 其余 ${forms.length - 12} 张见文件`)
+  lines.push('', `结论：${forms.length} 张表单加载该库，共 ${handlers} 个事件处理器；改函数名或删文件会让这些处理器失效。`)
+  return lines.join('\n')
+}
+
+/** Render a plugin assembly report for one environment. */
+function renderAssembly(env, name, result) {
+  const { assembly, types } = result
+  const lines = [
+    `插件程序集 ${assembly.name} 的注册情况（${env.key}）`,
+    `版本：${assembly.version ?? '未知'}，隔离模式：${assembly.isolation ?? '?'}`,
+    `类型：${types.length} 个`,
+  ]
+  let stepCount = 0
+  let disabled = 0
+  for (const type of types.slice(0, 12)) {
+    stepCount += type.steps.length
+    disabled += type.steps.filter((step) => !step.enabled).length
+    lines.push('', `- ${type.typename}`)
+    if (!type.steps.length) lines.push('  （没有注册步骤）')
+    for (const step of type.steps.slice(0, 8)) {
+      const filter = step.filteringAttributes ? `，过滤 ${step.filteringAttributes}` : ''
+      lines.push(`  · ${step.name}（stage ${step.stage}，mode ${step.mode}，rank ${step.rank ?? 1}${filter}${step.enabled ? '' : '，已停用'}）`)
+    }
+    if (type.steps.length > 8) lines.push(`  · … 其余 ${type.steps.length - 8} 步见文件`)
+  }
+  if (types.length > 12) lines.push(`… 其余 ${types.length - 12} 个类型见文件`)
+  lines.push('', `结论：共 ${stepCount} 个步骤${disabled ? `，其中 ${disabled} 个已停用` : ''}。`)
+  return lines.join('\n')
+}
+
+export function register(ctx, state) {
+  return ctx.tools.register({
+    ...definition,
+    async execute(args, exec) {
+      const config = await loadConfig(state.rawConfig)
+      const kind = args.kind
+      if (!KINDS.includes(kind)) {
+        throw new D365Error(`不认识的查询类型：${kind}`, { code: 'unknown-kind', hint: `可选：${KINDS.join(' / ')}` })
+      }
+      if (kind === 'field' && (!args.entity || !args.attribute)) {
+        throw new D365Error('kind=field 需要 entity 和 attribute', { code: 'missing-field' })
+      }
+      if (kind !== 'field' && !args.name) {
+        throw new D365Error(`kind=${kind} 需要 name`, { code: 'missing-name' })
+      }
+
+      const envs = pickEnvironments(config, args)
+      const sections = []
+      const artifact = { kind, entity: args.entity, attribute: args.attribute, name: args.name, environments: {} }
+
+      for (const env of envs) {
+        const client = makeClient(env, config)
+        let text
+        if (kind === 'field') {
+          const result = {
+            forms: await findFieldForms(client, args.entity, args.attribute, exec?.signal),
+            views: await findFieldViews(client, args.entity, args.attribute, exec?.signal),
+            automations: await findFieldAutomations(client, args.entity, args.attribute, exec?.signal),
+          }
+          artifact.environments[env.key] = result
+          text = renderField(env, args.entity, args.attribute, result)
+        } else if (kind === 'web_resource') {
+          const forms = await findResourceForms(client, args.name, exec?.signal)
+          artifact.environments[env.key] = { forms }
+          text = renderResource(env, args.name, forms)
+        } else {
+          const result = await findPluginUsage(client, args.name, exec?.signal)
+          artifact.environments[env.key] = result
+          text = renderAssembly(env, args.name, result)
+        }
+        sections.push(text)
+      }
+
+      const file = await writeArtifact(config, `refs-${kind}`, artifact)
+      return { text: `${sections.join('\n\n')}\n\n完整结果：${file}` }
+    },
+  })
+}