# V3.25 核心字段扩展评估与实现（0.9.17，2026-09-18）

## 一手依据

- 2026-09-17 V3.25.0 发版通知及核对说明：工商地区/国标行业、简介企查查行业/主营产品/企业规模。
- qcc_mcp_new 本地 dev@fabceff：apps/mcp/src/tools/company_registration_info.tool.ts、company_profile.tool.ts；工商变更 cf4cfe1，简介 9203e20/f9719a0/a538e16/3b672ec。
- mcp_web 本地 dev@f2b85a79：apps/web/lib/demo-data.ts 及两个对应 example tests；913882d4、c9fb123a 和 109c9216。两个源仓只读，未修改工作树。
- 清洗插件基线 origin/main@794201b / npm latest 0.9.16，无在途 PR。独立分支 feat/core-fields-20260918；不变更共享字段包或默认选择。
- 发版核对说明明确未独立验证生产部署；本次亦未发起收费 MCP 请求。代码/官网示例对齐不能替代线上验收。

## 新增 14 项一对一字段

| 来源工具 | 精确返回路径 | 补全字段 ID | 显示名 |
| --- | --- | --- | --- |
| get_company_registration_info | 地区信息.省份 | province | 省份 |
| 同上 | 地区信息.城市 | city | 城市 |
| 同上 | 地区信息.区域 | district | 区域 |
| 同上 | 地区信息.地区代码 | area_code | 地区代码 |
| 同上 | 国标行业.门类 | industry_section | 国标行业门类 |
| 同上 | 国标行业.大类 | industry_large | 国标行业大类 |
| 同上 | 国标行业.中类 | industry_middle | 国标行业中类 |
| 同上 | 国标行业.小类 | industry_small | 国标行业小类 |
| get_company_profile | 企查查行业.一级 | qcc_industry_level1 | 企查查行业一级 |
| 同上 | 企查查行业.二级 | qcc_industry_level2 | 企查查行业二级 |
| 同上 | 企查查行业.三级 | qcc_industry_level3 | 企查查行业三级 |
| 同上 | 企查查行业.四级 | qcc_industry_level4 | 企查查行业四级 |
| 同上 | 主营产品 | main_products | 主营产品 |
| 同上 | 企业规模 | company_scale | 企业规模 |

两个工具均来自 qcc-company。目录 136→150；工商 27→35、简介 3→9。仍按企业+工具去重调用，不为每个层级重复查同一工具。

## 兼容性与数据边界

- 旧 industry_category / qcc_industry ID 保留：旧文本原样输出；新对象按明确层级标注串联，禁止直接 String(object)。独立层级只取对应叶子，不把旧文本认定为某层级，也不从其他层级补缺。
- 地区字段来自嵌套“地区信息”，不从所属地区/注册地址拆分；地区代码保留字符串与前导零。不同主体可能不返回这些字段，缺失留空。
- 企业规模取简介“企业规模”（上游大型/中型/小型/微型）；原 company_size 仍是工商“人员规模”，不能互相回填。
- 主营产品是名称数组，按原顺序以中文分号合并单元格，不展开企业行、不重排、不去重。当前服务只请求前 10 项，空数组也可能来自不支持主体或补充接口异常，不能据此判断企业没有产品。
- 原表非空值保护、只回填选定字段、来源审计和客户 XLSX/任务报告分层保持不变；主结果不增加本次未选字段。

## 选择界面

保持两大来源分组及现有全选/清空交互；增加层级、规模和产品边界说明。新增省/市/区县、区域编码、企查查一级行业等别名，搜索和表头映射共用；不把笼统“行业”自动绑定到某级。数量取当前目录，移除过时固定批次数字。默认字段不扩大。

## 验证

自动化覆盖：新结构/旧文本、缺层级、畸形对象、零值和前导零、产品原顺序、两个工具去重、原值保留、未选择字段不输出、前后端目录映射及 UI 数量/搜索。

本地验收：npm run check 全部通过（302 项测试及语法、文档、打包门禁）；真实 React/Chromium 亮/暗主题 × 5 种尺寸共 10 组回归通过，包括新增别名搜索、行业层级、银行模板省市区自动映射。XLSX 合成往返测试验证中文列名、前导零、产品单元格和报告分层；未在客户已登录的 3080 会话上发起业务调用。

未验证：生产 MCP 实际部署与权限、真实企业返回完整度；不将合成 fixture 当作真实业务验收。用户后续已授权 commit、push、tag 与 npm 发布，0.9.17 按 PR 检查、合并默认分支、tag/OIDC 流程发布；发布状态以 registry 回读为准。