dsh-data-cleaning-agent 0.6.0 → 0.6.2

package/lib/qcc-command.js

@@ -0,0 +1,280 @@
+/**
+ * Agent-owned QCC command bridge.
+ *
+ * DSH Code Mode only permits dynamic MCP calls as nested executions of an
+ * Agent-owned tool call.  The Web workbench therefore stages rows under an
+ * opaque command id, sends only that id through the visible conversation,
+ * and lets this high-level tool perform the paid calls with exec.token.
+ */
+import { randomUUID } from 'node:crypto';
+import { QccBridgeError } from './qcc.js';
+import { normalizeFieldSelection } from './workflow-contract.js';
+
+export const TOOL_QCC_COMMAND = 'data_cleaning_qcc_run';
+
+const DEFAULT_TTL_MS = 30 * 60 * 1000;
+const DEFAULT_MAX_COMMANDS = 50;
+
+function clone(value) {
+  return structuredClone(value);
+}
+
+function safeError(error) {
+  if (error instanceof QccBridgeError) return error.toJSON();
+  return new QccBridgeError('QCC_COMMAND_FAILED', 'Data-cleaning QCC command failed', {
+    retryable: false,
+  }).toJSON();
+}
+
+function requiredText(value, code, message) {
+  const text = String(value ?? '').trim();
+  if (!text) throw new QccBridgeError(code, message);
+  return text;
+}
+
+function normalizedInput(input = {}) {
+  const kind = String(input.kind ?? 'enrich');
+  if (!['enrich', 'resolve', 'retry'].includes(kind)) {
+    throw new QccBridgeError('QCC_COMMAND_KIND_INVALID', 'Unsupported data-cleaning QCC command kind');
+  }
+  const taskId = requiredText(input.taskId, 'QCC_COMMAND_TASK_REQUIRED', 'A workflow taskId is required');
+  if (kind === 'enrich') {
+    const rows = Array.isArray(input.rows) ? input.rows : [];
+    if (rows.length === 0) throw new QccBridgeError('QCC_INVALID_ROWS', 'At least one row is required');
+    if (rows.length > 100) throw new QccBridgeError('QCC_BATCH_TOO_LARGE', 'QCC batch exceeds 100 rows');
+    return {
+      kind,
+      taskId,
+      rows: clone(rows),
+      headers: Array.isArray(input.headers) ? input.headers.map(String) : [],
+      nameField: String(input.nameField ?? 'name'),
+      fieldSelection: normalizeFieldSelection(input.fieldSelection),
+      includeRisk: input.includeRisk === true,
+      concurrency: Math.min(4, Math.max(1, Math.trunc(Number(input.concurrency ?? 2)))),
+    };
+  }
+  const runId = requiredText(input.runId, 'QCC_RUN_NOT_FOUND', 'A G5 runId is required');
+  if (kind === 'resolve') {
+    return {
+      kind,
+      taskId,
+      runId,
+      companyName: requiredText(input.companyName, 'QCC_REVIEW_NOT_PENDING', 'A company name is required'),
+      selectedCreditNo: requiredText(input.selectedCreditNo, 'QCC_CANDIDATE_INVALID', 'A selected credit number is required'),
+    };
+  }
+  const companyNames = [...new Set((Array.isArray(input.companyNames) ? input.companyNames : [])
+    .map((name) => String(name).trim()).filter(Boolean))];
+  if (companyNames.length === 0) throw new QccBridgeError('QCC_RETRY_EMPTY', 'At least one failed company must be selected');
+  return { kind, taskId, runId, companyNames };
+}
+
+export function serializeQccCommandPrompt(command) {
+  const visible = {
+    schemaVersion: 1,
+    commandId: command.commandId,
+    taskId: command.taskId,
+    kind: command.kind,
+  };
+  return [
+    '请执行数据清洗补全企查查任务。',
+    '',
+    '类型化任务意图（schemaVersion 1）：',
+    '```json',
+    JSON.stringify(visible, null, 2),
+    '```',
+    '',
+    `请准确调用一次 ${TOOL_QCC_COMMAND} 并只传递 commandId。`,
+    '企业名单和字段选择已安全暂存在本机 Host，不得要求用户在对话中重复粘贴，不得直接调用任何 mcp__qcc-* 工具。',
+    '高层工具返回后立即结束本轮；不得重试、扩大名单或追加字段。',
+  ].join('\n');
+}
+
+export class QccCommandStore {
+  constructor({ bridge, runs, clock = () => Date.now(), ttlMs = DEFAULT_TTL_MS, maxCommands = DEFAULT_MAX_COMMANDS } = {}) {
+    if (!bridge || !runs) throw new TypeError('QccCommandStore requires bridge and runs');
+    this.bridge = bridge;
+    this.runs = runs;
+    this.clock = clock;
+    this.ttlMs = ttlMs;
+    this.maxCommands = maxCommands;
+    this.commands = new Map();
+  }
+
+  cleanup(reserveSlot = false) {
+    const cutoff = this.clock() - this.ttlMs;
+    for (const [id, command] of this.commands) {
+      if (command.state !== 'running' && command.touchedAtMs < cutoff) this.commands.delete(id);
+    }
+    const limit = reserveSlot ? this.maxCommands - 1 : this.maxCommands;
+    while (this.commands.size > limit) {
+      const removable = [...this.commands].find(([, command]) => command.state !== 'running');
+      if (!removable) throw new QccBridgeError('QCC_COMMAND_CAPACITY', 'QCC command queue is full', { retryable: true });
+      this.commands.delete(removable[0]);
+    }
+  }
+
+  prepare(input) {
+    this.cleanup(true);
+    const normalized = normalizedInput(input);
+    const commandId = `dcq-${randomUUID()}`;
+    const at = new Date(this.clock()).toISOString();
+    const record = {
+      commandId,
+      taskId: normalized.taskId,
+      kind: normalized.kind,
+      state: 'prepared',
+      createdAt: at,
+      updatedAt: at,
+      touchedAtMs: this.clock(),
+      input: normalized,
+      runId: null,
+      error: null,
+      promise: null,
+    };
+    this.commands.set(commandId, record);
+    return { ...this.publicRecord(record), prompt: serializeQccCommandPrompt(record) };
+  }
+
+  require(commandId) {
+    this.cleanup();
+    const record = this.commands.get(String(commandId ?? ''));
+    if (!record) throw new QccBridgeError('QCC_COMMAND_NOT_FOUND', 'QCC command was not found or expired');
+    record.touchedAtMs = this.clock();
+    return record;
+  }
+
+  publicRecord(record) {
+    return clone({
+      commandId: record.commandId,
+      taskId: record.taskId,
+      kind: record.kind,
+      state: record.state,
+      createdAt: record.createdAt,
+      updatedAt: record.updatedAt,
+      runId: record.runId,
+      error: record.error,
+      expiresInMs: this.ttlMs,
+    });
+  }
+
+  status(commandId) {
+    const record = this.require(commandId);
+    const output = this.publicRecord(record);
+    if (record.runId) output.run = this.runs.get(record.runId);
+    return output;
+  }
+
+  async run(commandId, execution) {
+    const record = this.require(commandId);
+    if (!execution?.agent || !execution?.token) {
+      throw new QccBridgeError('QCC_AGENT_EXECUTION_REQUIRED', 'QCC commands require an Agent-owned DSH tool execution');
+    }
+    if (record.promise) return record.promise;
+    record.state = 'running';
+    record.updatedAt = new Date(this.clock()).toISOString();
+    record.promise = this.execute(record, execution)
+      .then((run) => {
+        record.runId = run.runId;
+        record.state = 'completed';
+        record.updatedAt = new Date(this.clock()).toISOString();
+        record.touchedAtMs = this.clock();
+        return this.toolResult(record, run);
+      })
+      .catch((error) => {
+        record.error = safeError(error);
+        record.state = 'failed';
+        record.updatedAt = new Date(this.clock()).toISOString();
+        record.touchedAtMs = this.clock();
+        throw error;
+      });
+    return record.promise;
+  }
+
+  async execute(record, execution) {
+    const options = { execution };
+    if (record.kind === 'resolve') {
+      return this.runs.resolveCandidate(record.input.runId, record.input, this.bridge, options);
+    }
+    if (record.kind === 'retry') {
+      return this.runs.retryCompanies(record.input.runId, record.input.companyNames, this.bridge, options);
+    }
+    const audit = [];
+    const result = await this.bridge.enrichRows(record.input.rows, {
+      nameField: record.input.nameField,
+      includeRisk: record.input.includeRisk,
+      fieldSelection: record.input.fieldSelection,
+      concurrency: record.input.concurrency,
+      maxRows: 100,
+      execution,
+      onAudit: (event) => audit.push(event),
+    });
+    return this.runs.createRun({
+      headers: record.input.headers,
+      nameField: record.input.nameField,
+      includeRisk: record.input.includeRisk,
+      fieldSelection: record.input.fieldSelection,
+      concurrency: record.input.concurrency,
+      result,
+      audit,
+    });
+  }
+
+  toolResult(record, run) {
+    return clone({
+      commandId: record.commandId,
+      taskId: record.taskId,
+      runId: run.runId,
+      state: run.state,
+      summary: run.summary,
+    });
+  }
+}
+
+export function registerQccCommandTool(tools, commands) {
+  return tools.register({
+    name: TOOL_QCC_COMMAND,
+    description: 'Execute one already-staged data-cleaning QCC command. Call only when a visible typed intent supplies commandId. The Host owns rows, billing confirmation, idempotency and result artifacts.',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: { commandId: { type: 'string' } },
+      required: ['commandId'],
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          commandId: { type: 'string' },
+          taskId: { type: 'string' },
+          runId: { type: 'string' },
+          state: { type: 'string' },
+          summary: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+              totalRows: { type: 'integer' },
+              uniqueCompanies: { type: 'integer' },
+              enriched: { type: 'integer' },
+              ambiguous: { type: 'integer' },
+              unresolved: { type: 'integer' },
+              failed: { type: 'integer' },
+              missingName: { type: 'integer' },
+              includeRisk: { type: 'boolean' },
+            },
+            required: ['totalRows', 'uniqueCompanies', 'enriched', 'ambiguous', 'unresolved', 'failed', 'missingName', 'includeRisk'],
+          },
+        },
+        required: ['commandId', 'taskId', 'runId', 'state', 'summary'],
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: `数据清洗补全企查查任务已完成：${value.summary?.enriched ?? 0}/${value.summary?.totalRows ?? 0} 条已补全，状态 ${value.state}。`,
+      }],
+    },
+    async execute(args, exec) {
+      return commands.run(args.commandId, exec);
+    },
+  });
+}

package/lib/qcc-runs.js

@@ -143,7 +143,7 @@ export class G5RunStore {
     return { value: await entry.promise, replayed: false };
   }
 
-  createRun({ headers, nameField, includeRisk, concurrency, result, audit = [] }) {
+  createRun({ headers, nameField, fieldSelection, includeRisk, concurrency, result, audit = [] }) {
     this.cleanup();
     const id = this.runIdFactory();
     const at = this.nowIso();
@@ -156,6 +156,7 @@ export class G5RunStore {
       touchedAtMs: this.clock(),
       headers: Array.isArray(headers) ? headers.map(String) : [],
       nameField: String(nameField ?? 'name'),
+      fieldSelection: Array.isArray(fieldSelection) ? fieldSelection.map(String) : [],
       includeRisk: Boolean(includeRisk),
       concurrency: Number(concurrency ?? 2),
       summary: clone(result.summary),
@@ -196,6 +197,7 @@ export class G5RunStore {
       createdAt: record.createdAt,
       updatedAt: record.updatedAt,
       headers: record.headers,
+      fieldSelection: record.fieldSelection,
       summary: record.summary,
       rows: record.rows,
       reviewQueue: record.reviewQueue,
@@ -269,6 +271,7 @@ export class G5RunStore {
       }, {
         ...options,
         includeRisk: record.includeRisk,
+        fieldSelection: record.fieldSelection,
         onAudit: (event) => this.appendAudit(record, event),
       });
       this.patchCompany(record, name, queued.rowIndexes, result);
@@ -303,6 +306,7 @@ export class G5RunStore {
           result = await bridge.enrichCompany(item.companyName, {
             ...options,
             includeRisk: record.includeRisk,
+            fieldSelection: record.fieldSelection,
             onAudit: (event) => this.appendAudit(record, event),
           });
         } catch (error) {

package/lib/qcc.js

@@ -24,6 +24,7 @@ export const QCC_TOOL_NAMES = Object.freeze({
   oauthStatus: 'qcc_oauth_status',
   entityLookup: 'mcp__qcc-company__get_company_by_query',
   registration: 'mcp__qcc-company__get_company_registration_info',
+  profile: 'mcp__qcc-company__get_company_profile',
   riskScan: 'mcp__qcc-risk__get_company_risk_scan',
 });
 
@@ -145,13 +146,31 @@ export class QccBridgeError extends Error {
   }
 }
 
+function messageFailureCode(message) {
+  const text = String(message ?? '').trim();
+  if (!text) return '';
+  const cases = [
+    [/only\s+[`'\"]?run_code|requires task-based execution|direct(?:ly)?[^.]{0,48}(?:not allowed|not callable|denied)/i, 'DSH_EXECUTION_DENIED'],
+    [/(?:^|\D)401(?:\D|$)|unauthori[sz]ed|auth(?:entication|orization)? required|invalid token|token expired/i, '401'],
+    [/(?:^|\D)403(?:\D|$)|forbidden|permission denied|resource not authorized/i, '403'],
+    [/(?:^|\D)429(?:\D|$)|rate[ -]?limit|too many requests/i, '429'],
+    [/quota[^.]{0,32}(?:exhausted|insufficient|limit)|insufficient quota/i, 'QUOTA_EXHAUSTED'],
+    [/unknown tool|tool unavailable|method not found|mcp error\s*-32601/i, 'UNKNOWN_TOOL'],
+    [/timed?\s*out|deadline exceeded/i, 'TIMEOUT'],
+    [/mcp error\s*-32602|invalid (?:argument|parameter)|validation error|bad request/i, 'INVALID_ARGUMENT'],
+    [/(?:^|\D)5\d\d(?:\D|$)|service unavailable|upstream unavailable|connection (?:error|failed)/i, 'UPSTREAM_UNAVAILABLE'],
+  ];
+  return cases.find(([pattern]) => pattern.test(text))?.[1] ?? 'UNCLASSIFIED_TOOL_ERROR';
+}
+
 function upstreamFailureCode(result) {
-  return String(
+  const structured = String(
     result?.error?.info?.code
       ?? result?.error?.info?.status
       ?? result?.error?.info?.httpStatus
       ?? '',
   ).trim().toUpperCase();
+  return structured || messageFailureCode(result?.error?.message);
 }
 
 function failureDetails(result) {
@@ -218,6 +237,13 @@ function normalizedFailure(result, toolName, state) {
       connectRequired: true,
     });
   }
+  if (upstreamCode === 'DSH_EXECUTION_DENIED') {
+    return new QccBridgeError('QCC_EXECUTION_DENIED', 'DSH denied this programmatic QCC tool execution', {
+      toolName,
+      upstreamCode,
+      retryable: false,
+    });
+  }
   if (/^(?:5\d\d|SERVICE_UNAVAILABLE|UPSTREAM_UNAVAILABLE|CONNECTION_ERROR)$/.test(upstreamCode)) {
     return new QccBridgeError('QCC_UPSTREAM_UNAVAILABLE', 'QCC upstream service is temporarily unavailable', {
       toolName,
@@ -291,18 +317,98 @@ export function mapRegistrationFields(value, fallback = {}) {
   if (value.无匹配项 !== undefined) {
     throw new QccBridgeError('QCC_ENTITY_NOT_FOUND', 'Locked QCC entity could not be resolved by registration tool');
   }
+  const text = (...keys) => {
+    for (const key of keys) {
+      const item = value[key];
+      if (item !== undefined && item !== null && String(item).trim()) return String(item);
+    }
+    return '';
+  };
+  const region = text('所属地区', '所属地域', '地区');
+  const location = splitAdministrativeRegion(region);
+  return {
+    company_name: text('企业名称') || String(fallback.companyName ?? ''),
+    credit_no: text('统一社会信用代码', '信用代码') || String(fallback.creditNo ?? ''),
+    reg_no: text('工商注册号', '注册号'),
+    org_no: text('组织机构代码'),
+    reg_status: text('登记状态', '执业状态', '证书状态'),
+    legal_rep: text('法定代表人', '负责人', '经营者'),
+    reg_capital: text('注册资本', '注册资金', '开办资金', '成员出资总额', '资金数额'),
+    paid_capital: text('实缴资本'),
+    establish_date: text('成立日期'),
+    company_type: text('企业类型', '公司类型'),
+    registration_authority: text('登记机关'),
+    english_name: text('英文名', '英文名称'),
+    registered_address: text('注册地址', '住所', '经营场所'),
+    province: text('省份地区', '省份', '所属省份') || location.province,
+    city: text('城市', '所属城市', '市') || location.city,
+    district: text('区县', '所属区县') || location.district,
+    business_scope: text('经营范围'),
+    industry_category: text('国标行业'),
+    industry_large: text('一级行业', '企查查一级行业'),
+    industry_middle: text('二级行业', '企查查二级行业'),
+    operating_period: text('营业期限', '经营期限'),
+    company_size: text('企业规模', '人员规模'),
+    biz_status: text('经营状态'),
+  };
+}
+
+function splitAdministrativeRegion(value) {
+  const region = String(value ?? '').trim().replace(/\s+/g, '');
+  if (!region) return { province: '', city: '', district: '' };
+  const municipality = region.match(/^((?:北京|上海|天津|重庆)市)(.*)$/);
+  if (municipality) {
+    const district = municipality[2].match(/^(.+?(?:区|县))/)?.[1] ?? '';
+    return { province: municipality[1], city: municipality[1], district };
+  }
+  const provinceMatch = region.match(/^(.+?(?:省|自治区|特别行政区))/);
+  const province = provinceMatch?.[1] ?? '';
+  const remainder = province ? region.slice(province.length) : region;
+  const city = remainder.match(/^(.+?(?:市|自治州|地区|盟))/)?.[1] ?? '';
+  const districtRemainder = city ? remainder.slice(city.length) : remainder;
+  const district = districtRemainder.match(/^(.+?(?:区|县|旗|市))/)?.[1] ?? '';
+  return { province, city, district };
+}
+
+export function mapProfileFields(value) {
+  if (!isRecord(value)) {
+    throw new QccBridgeError('QCC_CONTRACT_MISMATCH', 'QCC profile tool returned a non-object result');
+  }
+  if (value.无匹配项 !== undefined) return {};
   return {
-    credit_no: String(value.统一社会信用代码 ?? fallback.creditNo ?? ''),
-    legal_rep: String(value.法定代表人 ?? value.负责人 ?? value.经营者 ?? ''),
-    reg_capital: String(
-      value.注册资本 ?? value.注册资金 ?? value.开办资金 ?? value.成员出资总额 ?? value.资金数额 ?? '',
-    ),
-    establish_date: String(value.成立日期 ?? ''),
-    reg_status: String(value.登记状态 ?? value.执业状态 ?? value.证书状态 ?? ''),
-    biz_status: String(value.经营状态 ?? ''),
+    // “企查查行业”没有声明一/二级语义，不得猜测塞入层级列。
+    industry_large: String(value.一级行业 ?? value.企查查一级行业 ?? ''),
+    industry_middle: String(value.二级行业 ?? value.企查查二级行业 ?? ''),
+    company_profile: String(value.企业简介 ?? value.简介 ?? ''),
   };
 }
 
+const LEGACY_ENRICHMENT_FIELDS = Object.freeze([
+  'credit_no', 'legal_rep', 'reg_capital', 'establish_date', 'reg_status', 'biz_status',
+]);
+const PROFILE_FIELDS = new Set(['industry_large', 'industry_middle', 'company_profile']);
+
+function requiresProfile(fieldSelection) {
+  return Array.isArray(fieldSelection) && fieldSelection.some((field) => PROFILE_FIELDS.has(field));
+}
+
+function mergeMappedFields(...sources) {
+  const output = {};
+  for (const source of sources) {
+    for (const [key, value] of Object.entries(source ?? {})) {
+      if (!Object.hasOwn(output, key) || (value !== '' && value !== null && value !== undefined)) output[key] = value;
+    }
+  }
+  return output;
+}
+
+function projectSelectedFields(fields, fieldSelection) {
+  const selected = Array.isArray(fieldSelection) && fieldSelection.length
+    ? [...new Set(fieldSelection.map(String))]
+    : LEGACY_ENRICHMENT_FIELDS;
+  return Object.fromEntries(selected.map((field) => [field, fields[field] ?? '']));
+}
+
 export function mapRiskTags(value) {
   if (!isRecord(value)) return '';
   const rows = Array.isArray(value.风险因子扫描) ? value.风险因子扫描 : [];
@@ -374,6 +480,7 @@ export class QccHostBridge {
       oauthStatus: this.has(QCC_TOOL_NAMES.oauthStatus),
       entityLookup: this.has(QCC_TOOL_NAMES.entityLookup),
       registration: this.has(QCC_TOOL_NAMES.registration),
+      profile: this.has(QCC_TOOL_NAMES.profile),
       riskScan: this.has(QCC_TOOL_NAMES.riskScan),
     };
     const ready = capabilities.entityLookup && capabilities.registration;
@@ -507,11 +614,24 @@ export class QccHostBridge {
           attemptAudited = true;
           throw error;
         }
+        const execution = options.execution;
+        if (execution && (!execution.agent || !execution.token)) {
+          throw new QccBridgeError(
+            'QCC_AGENT_EXECUTION_REQUIRED',
+            'Nested QCC calls require an Agent-owned DSH tool execution',
+            { toolName: activeToolName },
+          );
+        }
         const result = await this.tools.execute({
           name: activeToolName,
           callId,
           signal: state.signal,
           arguments: args,
+          ...(execution ? {
+            rootCallId: execution.rootCallId,
+            parent: execution.token,
+            agent: execution.agent,
+          } : {}),
         });
         if (result?.isError !== true) {
           emitAudit(options, {
@@ -607,12 +727,15 @@ export class QccHostBridge {
       { searchKey: lockedKey },
       options,
     );
-    const fields = mapRegistrationFields(registration.data, match);
+    let mapped = mapRegistrationFields(registration.data, match);
+    if (requiresProfile(options.fieldSelection)) {
+      const profile = await this.call(QCC_TOOL_NAMES.profile, { searchKey: lockedKey }, options);
+      mapped = mergeMappedFields(mapped, mapProfileFields(profile.data));
+    }
+    const fields = projectSelectedFields(mapped, options.fieldSelection);
     if (options.includeRisk) {
       const risk = await this.call(QCC_TOOL_NAMES.riskScan, { searchKey: lockedKey }, options);
       fields.risk_tags = mapRiskTags(risk.data);
-    } else {
-      fields.risk_tags = '';
     }
     return {
       status: 'enriched',
@@ -632,12 +755,15 @@ export class QccHostBridge {
       { searchKey: creditNo },
       options,
     );
-    const fields = mapRegistrationFields(registration.data, { companyName, creditNo });
+    let mapped = mapRegistrationFields(registration.data, { companyName, creditNo });
+    if (requiresProfile(options.fieldSelection)) {
+      const profile = await this.call(QCC_TOOL_NAMES.profile, { searchKey: creditNo }, options);
+      mapped = mergeMappedFields(mapped, mapProfileFields(profile.data));
+    }
+    const fields = projectSelectedFields(mapped, options.fieldSelection);
     if (options.includeRisk) {
       const risk = await this.call(QCC_TOOL_NAMES.riskScan, { searchKey: creditNo }, options);
       fields.risk_tags = mapRiskTags(risk.data);
-    } else {
-      fields.risk_tags = '';
     }
     return { status: 'enriched', companyName, fields };
   }
@@ -652,6 +778,7 @@ export class QccHostBridge {
     }
 
     const requiredTools = [QCC_TOOL_NAMES.entityLookup, QCC_TOOL_NAMES.registration];
+    if (requiresProfile(options.fieldSelection)) requiredTools.push(QCC_TOOL_NAMES.profile);
     if (options.includeRisk) requiredTools.push(QCC_TOOL_NAMES.riskScan);
     try {
       await Promise.all(requiredTools.map((name) => this.waitForTool(name, {

package/lib/skill-enrich.js

@@ -6,9 +6,10 @@
  *   - `enterprise-enrichment`：用企查查 MCP 工具按最新工商信息补全企业名单
  *     （依赖 `qcc-dsh-mcp-oauth` 已连接；本 Skill 不重造 OAuth）。
  *
- * 方案 A（模型中介式）：模型亲自调用 `mcp__qcc-company__*` / `mcp__qcc-risk__*`
+ * 方案 A（自由对话）：模型亲自调用 `mcp__qcc-company__*` / `mcp__qcc-risk__*`
  * / `mcp__qcc-ipr__*` / `mcp__qcc-operation__*` 完成消歧 → 工商详情 → 各域维度，
- * 再组装结果。本插件零后端改动（Host Bridge 批量是独立于本 Skill 的方案 B）。
+ * 再组装结果。工作台批量路径则只调用 Agent-owned 高层工具，避免 Code Mode
+ * 拒绝 Web Host 的无父执行调用。
  */
 import {
   QCC_PHASE2_COMPANY_TOOLS,
@@ -53,6 +54,10 @@ export function registerEnrichSkill(skills) {
     content: [
       'You are an enterprise-list enrichment assistant. You fill company lists with Qichacha (QCC) data by calling QCC MCP tools. Never invent, pad, or fabricate any field.',
       '',
+      'Typed workbench command (highest priority):',
+      '- If the visible user message contains a typed data-cleaning intent with `commandId` and explicitly requests `data_cleaning_qcc_run`, call that high-level tool exactly once with only `commandId`, then stop.',
+      '- The Host already holds the rows, billing confirmation and field selection. Do not ask the user to paste rows, do not call any `mcp__qcc-*` tool directly, do not retry, and do not expand the batch.',
+      '',
       'Workflow:',
       '1. Check QCC availability first: run `qcc_oauth_status`. If not connected, tell the user to run `qcc_oauth_connect` first and stop. If the token is expired, guide the user to `qcc_oauth_connect` (it reuses the grant and refreshes without a new authorization page).',
       '2. Parse the company-name list from what the user gave (pasted text / CSV / JSON / inline list). Keep only the distinct company-name column.',

package/lib/tools.js

@@ -100,7 +100,7 @@ export function registerTools(tools) {
       const r = completeRows(Array.isArray(args.rows) ? args.rows : []);
       return {
         total: r.total,
-        completed: r.completed,
+        completed: r.completedCount,
         incompleteCount: r.incompleteCount,
         name: r.fillStats.name,
         amount: r.fillStats.amount,