客户信息检索 — 功能说明

本文档介绍 客户信息检索 桌面程序的主要功能、使用方式与配置说明，便于快速上手并提高检索与电话补全效果。

界面：
在这里插入图片描述

一、软件概述

客户信息检索 是一款基于 WPF 的 Windows 桌面应用，用于按业务关键字（如「线束」「模具」）从地图上抓取相关企业信息，并可对缺少联系电话的记录进行联网补全，最后导出为 Excel 表格。

典型使用场景：

  • 销售/市场人员按行业关键词批量收集目标客户名单
  • 按城市范围检索工厂、门店、公司等 POI（兴趣点）
  • 汇总公司名称、电话、地址后导出跟进

技术栈：.NET 10、WPF、MVVM；地图数据来自高德/百度开放平台；电话补全使用百度千帆「智能搜索生成」接口。

二、核心功能一览

功能 说明
关键字 POI 检索 通过高德和/或百度地图地点检索 API 搜索企业类 POI
多城市批量检索 一次输入多个城市，程序按城市依次检索并合并结果
多关键词（高德） 关键字可用 | 分隔多个词，高德会分别匹配（如 线束|线束厂）
双平台合并与去重 可选「高德 + 百度」，按公司名+城市去重，优先保留有电话的记录
城市范围限定 指定城市时启用 city_limit，减少跨城无关结果
AI 精准补全电话 对无电话企业逐条联网查询，提高补全成功率
Excel 导出 将结果导出为 .xlsx，含公司名、电话、地址、城市、分类、来源
百度 AI 测试窗口 独立调试 AI 接口、查看请求/响应与解析结果
本地配置持久化 API Key 等保存在本机用户目录，不上传第三方

三、主界面功能说明

3.1 检索条件

关键字

  • 输入要搜索的业务词，例如：线束、模具厂、连接器。
  • 多词扩展（推荐）：使用英文竖线 | 分隔，例如：线束|线束厂|线束加工。
    • 高德地图 会将整串关键字传给 API，一次检索可覆盖多个相关词。
    • 百度地图 仅使用竖线前的第一个词（百度接口不支持多词 OR）。
  • 词越具体，结果越相关；过泛的词可能混入无关 POI。

城市

  • 支持 逗号、分号、中文逗号、换行 分隔多个城市，例如：
    深圳, 广州 或 
    深圳
东莞
惠州
  • 留空时：若已在「设置」中配置了默认城市，则使用默认城市；否则按地图接口的全国/默认范围检索（高德可能提示需指定城市）。
  • 强烈建议填写城市，可显著提高结果数量与准确度。

数据来源

选项 行为
高德地图 仅调用高德 place/text
百度地图 仅调用百度 place/v2/search
高德 + 百度 两个平台都查，合并后去重

双平台并用通常能得到 更多不重复企业，适合尽量扩大名单。

AI 精准补全无电话（勾选框）

  • 勾选：地图检索结束后，对 没有联系电话 的记录自动调用百度 AI 逐条查询。
  • 取消：只做地图检索，不消耗 AI 配额。
  • 还需在设置中填写百度 AI API Key，且设置里开启「检索后自动 AI 补全」才会真正执行（主界面勾选与设置项共同生效）。

3.2 操作按钮

按钮 功能
搜索 开始检索；检索过程中可点「取消」中断
取消 取消当前进行中的检索或 AI 补全
导出 Excel 将当前表格全部结果导出为 .xlsx（有结果时可用）
测试百度 AI 打开 AI 诊断窗口；若当前列表有无电话企业，会自动带入样例
设置 API Key 打开配置窗口，填写各平台密钥与检索参数

3.3 结果表格

每条记录包含以下列：

列名 含义
公司名称 POI 名称，一般为工商/门店对外名称
联系电话 地图返回的电话；AI 补全后会更新
公司地址 省市区 + 详细地址拼接
城市 检索城市或 POI 返回的城市名
分类 高德返回的类型（百度可能为空）
来源 如「高德地图」「百度地图」「高德地图+AI」

检索过程中，底部状态栏会显示当前城市、页码或 AI 补全进度。

四、检索流程（地图 POI）

程序按以下顺序工作：

输入关键字 + 城市列表 + 选择地图平台
        ↓
按城市循环（城市1 → 城市2 → …）
        ↓
每个城市：调用所选地图 API，按「页」分页拉取（页数见设置）
        ↓
合并所有城市、所有平台的结果
        ↓
按「归一化公司名 + 城市」去重（有电话的优先保留）
        ↓
（可选）对无电话记录逐条 AI 补全
        ↓
显示在表格，可导出 Excel

4.1 高德地图检索

  • 接口：高德 Web 服务 关键字搜索 v3/place/text
  • 参数要点：extensions=all（尽量返回电话）、指定城市时 city_limit=true
  • 每页最多 25 条，连续翻页直到无更多数据或达到设置的最大页数

4.2 百度地图检索

  • 接口：百度 地点检索 place/v2/search（行政区划区域检索）
  • 参数要点：scope=2（详情含电话）、指定城市时 city_limit=true
  • 每页 20 条，页码从 0 开始

4.3 结果去重规则

当使用「高德 + 百度」或同一企业在不同来源重复出现时：

  • 以 简化后的公司名 + 城市 作为唯一键；
  • 若重复，优先保留已有电话号码 的那条；
  • 减少双平台重复条目，使表格更易阅读、导出更干净。

五、AI 电话补全功能

5.1 为什么需要 AI 补全？

地图 POI 中相当一部分企业 未登记电话 或字段为空。本程序在地图检索后，可对这类记录调用 百度千帆智能搜索生成，通过联网搜索官网、黄页、企查类页面等，尝试补全联系电话。

5.2 工作方式（精准逐条模式）

与「一次请求查 40 家公司」的批量模式不同，当前版本采用 逐条精准查询：

  • 每一家无电话企业 单独发起 1 次 AI 搜索；
  • 查询词示例：深圳 深圳市某某线束有限公司 宝安区某某路 联系电话；
  • AI 返回正文及 references 引用片段后，程序从中提取与公司名最相关的电话号码。

优点：成功率明显高于批量模式（批量时模型常只泛搜一轮，无法覆盖清单内每一家公司）。
代价：每补全 1 家企业消耗 1 次 AI 调用配额；补全 N 家约需 N 次请求（请求之间有间隔，见设置）。

5.3 启用条件

需同时满足：

  1. 主界面勾选 「AI 精准补全无电话」；
  2. 设置中勾选 「检索后自动 AI 补全无电话记录」；
  3. 设置中已填写有效的 百度 AI API Key；
  4. 检索结果中存在 公司名非空且电话为空 的记录。

5.4 相关设置项

设置项 说明
百度 AI API Key 千帆 AppBuilder 的 API Key（Bearer 认证）
AI 模型 默认 ernie-3.5-8k，须与账号已开通模型一致
单次最多补全企业数 限制一次检索后最多对多少家无电话企业做 AI（0 表示不限制条数逻辑由代码处理；实际受配额与耗时约束）
多批/请求间隔（毫秒） 两次 AI 请求之间的等待时间，建议 300～1000，降低限流风险

5.5 解析策略（程序自动完成）

AI 回复格式不固定，程序会依次尝试：

  1. 解析 JSON 数组（若模型按指令返回结构化数据）；
  2. 解析 Markdown 序号列表（如 1. **公司名** 下的手机/电话行）；
  3. 按公司名在全文及 references 中模糊匹配并提取号码。

支持手机号、固话（区号-号码）、400 电话等常见格式；多个号码以分号 ; 连接写入表格。

六、百度 AI 测试窗口

用于验证 API Key、查看原始请求与响应，排查「搜到了但没写入表格」等问题。

入口：主界面 → 测试百度 AI

主要能力：

  • 简单搜索：输入一句自然语言（如 深圳线束有限公司 联系电话），查看模型回复；
  • 批量样例测试：多行文本，每行格式 公司名|城市|地址（后两项可省略）；
  • 展示 HTTP 状态码、请求体、原始 JSON、解析摘要；
  • 打开窗口时，若主列表有无电话企业，可自动带入作为批量样例。

建议在正式大批量检索前，先用测试窗口确认 Key 有效、能返回含电话的联网结果。

七、设置页面说明

打开方式：主界面 → 设置 API Key

配置保存在：

%AppData%\Retrievecustomerinformation\settings.json

（仅本机，不会上传到除地图/百度官方接口以外的第三方。）

7.1 地图 POI

配置项 说明
高德 Web 服务 Key 用于高德 place/text 等 Web 服务
百度地图 AK 服务端 AK，须开通「地点检索」类服务

7.2 百度 AI 搜索（补全电话）

配置项 说明
百度 AI API Key 千帆 AppBuilder，用于 ai_search/chat/completions
AI 模型 如 ernie-3.5-8k
检索后自动 AI 补全 总开关（与主界面勾选配合）
单次最多补全企业数 控制一次搜索后 AI 处理的上限条数
请求间隔（毫秒） 逐条 AI 调用之间的延迟

7.3 检索参数

配置项 说明
默认城市 主界面城市框为空时使用；支持多城市分隔
每平台每城市最多检索页数 越大结果越多，但 API 调用次数与耗时增加（程序内单平台上限约 100 页，设置界面提示常为 1～20，可按账号配额调整）

八、API Key 申请指引

8.1 高德地图

  1. 登录 高德开放平台
  2. 创建应用，添加 Web 服务 类型 Key
  3. 在控制台为 Key 勾选/开通 搜索类 服务（关键字搜索）
  4. 将 Key 填入本程序「高德 Web 服务 Key」

文档：搜索 POI

8.2 百度地图

  1. 登录 百度地图开放平台
  2. 创建应用，获取 服务端 AK
  3. 开通 地点检索（Place API）
  4. 填入本程序「百度地图 AK」

文档：地点检索

8.3 百度 AI（千帆 AppBuilder）

  1. 登录 百度智能云控制台
  2. 进入 千帆 AppBuilder → API Key
  3. 创建 Key，服务选择 千帆 AppBuilder（智能搜索生成）
  4. 填入本程序「百度 AI API Key」
  5. 确认账户已开通所用模型（如 ernie-3.5-8k）

接口地址：https://qianfan.baidubce.com/v2/ai_search/chat/completions

说明：智能搜索一般有 每日免费次数限制（以控制台为准），逐条补全会按企业数量消耗次数，请在设置中合理限制「最多补全企业数」。

九、Excel 导出

  • 格式：Excel 2007+（.xlsx）
  • 触发：主界面 导出 Excel，在对话框中选择保存路径
  • 默认文件名：关键字_yyyyMMdd_HHmm.xlsx
  • 导出列与界面表格一致：公司名称、联系电话、公司地址、城市、分类、来源

适合二次筛选、CRM 导入或打印。

十、提高检索数量的建议

  1. 务必填写城市（或多个目标城市），避免全国泛搜导致结果被稀释或高德返回城市建议。
  2. 关键字用 | 扩展同义词（高德有效），例如：线束|线缆|线束加工。
  3. 数据来源选「高德 + 百度」，两套数据互补。
  4. 在设置中适当增大「最多检索页数」（注意各地图账号每日配额）。
  5. 业务词可尝试 行业词 + 地域 组合，或拆成多次不同关键字检索后合并导出。

十一、提高 AI 补全成功率的建议

  1. 确保 POI 记录 公司名称完整，城市、地址越全，AI 查询词越精准。
  2. 先用 测试百度 AI 验证 Key 与模型是否正常返回电话。
  3. 无电话企业过多时，在设置中设置 「单次最多补全企业数」，优先补全最重要的前 N 条。
  4. 若频繁失败，可适当 增大请求间隔，避免触发限流。
  5. 部分企业网上本就没有公开电话，补全失败属正常情况。

十二、常见问题

Q：检索结果很少或为零？

  • 检查 Key 是否正确、服务是否开通；
  • 是否填写了城市；
  • 关键字是否过偏；
  • 尝试换「高德 + 百度」并增加页数。

Q：高德提示「建议在城市中指定范围」？

  • 未指定城市且关键字较泛时，高德可能只返回推荐城市列表；在「城市」框填写具体城市后重试。

Q：AI 测试成功，但主界面表格没写上电话？

  • 确认主界面与设置中均已开启 AI 补全；
  • 查看状态栏是否显示补全条数；
  • 用测试窗口查看「解析摘要」，确认程序能从回复中提取号码。

Q：补全很慢？

  • 逐条模式每家约 1～2 秒外加间隔，40 家大约需数十秒，属正常现象。

Q：HTTP 411 等错误？

  • 程序已对百度 AI 请求设置 Content-Length；若仍报错，检查网络代理或 Key 权限。

Q：配置丢失？

  • 配置在 %AppData%\Retrievecustomerinformation\settings.json，换机需重新填写或复制该文件。

十三、程序结构（便于二次开发）

Retrievecustomerinformation/
├── Models/              # 数据模型（客户 POI、设置、地图枚举等）
├── Services/            # 高德/百度 POI、AI 补全、协调器、导出、设置持久化
├── ViewModels/          # 主界面、设置、AI 测试 的 MVVM
├── Views/               # 设置窗口、百度 AI 测试窗口
├── Helpers/             # HTTP、城市解析、AI 回复解析、JSON 转换等
├── Resources/           # 界面主题样式
└── MainWindow.xaml      # 主界面

分层原则：界面只负责展示与命令；检索与补全逻辑在 Services；AI 回复解析在 Helpers/AiPhoneResponseParser。

十四、依赖与运行环境

  • 操作系统：Windows 10 及以上
  • 运行时：.NET 10（Windows 桌面）
  • NuGet：ClosedXML（Excel 导出）

编译与运行（开发机）：

cd Retrievecustomerinformation
dotnet build
dotnet run

发布版可在 bin/Release 或发布目录直接运行 Retrievecustomerinformation.exe。

十五、免责声明

  • 检索数据来源于第三方地图与公开网页，准确性、时效性、合法性由数据源决定，请遵守各地图平台服务条款与个人信息保护相关法规。
  • 导出名单仅供商务拓展等合规用途，请勿用于骚扰电话等违法行为。
  • API 调用可能产生费用或受配额限制，请以各平台控制台说明为准。

文档版本与程序功能对应；若界面文案与行为略有差异，以实际运行版本为准。

# 人工智能 # .net
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

Faust：把 Kafka Streams 搬到 Python 里

Faust 是 Robinhood 开源的 Python 流处理库（6.8k Star），将 Kafka Streams 功能引入 Python 生态。它无需 DSL，基于 async/await 语法，支持静态类型检查，通过装饰器定义流处理逻辑。Faust 提供分布式 K/V 存储和状态管理，支持窗口聚合与故障恢复，单核每秒可处理数万事件，天然支持水平扩展。与主流 Python 库（如 NumP

avatar AtomGit开源社区
cover

KV Cache 到底是什么？一文讲透大模型推理加速原理

avatar AtomGit开源社区

大厂 Java 面试实录：从音视频内容社区到 AI RAG 的全链路技术设计

通过一个互联网大厂 Java 面试故事场景，让读者在轻松对话中理解音视频与内容社区场景下的微服务架构设计、Spring Boot 与 Spring Cloud 技术栈选型、缓存与消息队列、监控与日志体系、AI RAG 能力接入等关键知识点，小白也能看懂并入门。

avatar AtomGit开源社区