> 👤 作者名片：本技能由 老登（SkillHub @user_11d2869f）开发维护。
> 作者作品集：📚 第二大脑操作系统 · 交付就绪进化器 · 技能编排交付 · 调研Master · 多AI协作Loop+Graph · 多智能体社会模拟器 · 招商引资工作台 · 券商研报搜索与解读 · 工作台资源管家
> 喜欢本技能请点 ⭐ 收藏；欢迎留言反馈与定制需求，作者持续更新中。

招商引资工作台 · 产业链靶心（试用版）

> ## ⚠️ 部署前置：企查查 API KEY（演示免配 / 生产必配）
>
> 平台的「企业四维画像 / 企查查档案补全 / 手机扫楼真·全楼查询」依赖企查查能力，KEY 策略如下：
> - 演示模式（默认开启，免 KEY）：不配 KEY 也能跑通「找企业→画像研判→推荐→交流→拜访→转化点亮」完整闭环，用内置契合度排序代替，界面标注「接入后叠加信用分/科创分」。新用户零门槛即可体验。
> - 生产必配 KEY：要把画像补全为真实工商/股东/司法数据，或启用「手机扫楼真·扫全楼」（企查查周边/楼宇企业查询），必须配置企查查 KEY。未配时扫楼返回通用占位示例，不影响主流程。
> - 配置方式：在 WorkBuddy 连接器设置找到 qcc-company 填入 API Key；扫楼服务另需将 KEY 写入环境变量 QCC_KEY（仅存本机，绝不上手机/云）。
> - 其余模块无需任何 KEY，纯本地运行、零云成本。

演示数据说明（可一键替换为你的辖区）

• 内置 51 条示例线索 + 1 份本地产业图谱 + 政策 / 案例 / 项目 / 知识库，开箱即见完整闭环演示。
• 示例数据全部使用通用占位（某县 / 某市 / 某区 / 某省），不含任何真实行政区划、真实企业或个人隐私，可直接作为你所在辖区的演示模板。
• 换成你自己的辖区：把 seed_data.json 中的 location / region / note / addr 等字段替换为真实辖区信息，或运行 bulk-add-leads 灌入你抓取的本地线索即可。

一、这是什么

一套完全本地运行的招商引资工作台。把公开招商信号（扩产/搬迁/新基地/专精特新/单项冠军）结构化沉淀为线索库，借助本地 SQLite 数据 + 单文件交互式 HTML 工作台，完成「找企业 → 画像研判 → 每日推荐 → 后续交流 → 拜访执行 → 转化点亮产业版图」的自上而下闭环。

核心特征：

• 数据全本地：落在本机 data/zhaoshang.db（SQLite），不依赖任何云端服务器，零月度成本。
• 零部署：随 WorkBuddy 直接跑，无需独立服务器。
• 闭环状态机：线索在 推送池(pool) → 后续交流(shortlist) → 拜访执行(engaged) → 已转化(converted) / 暂缓(held) / 流失(lost) 间流转，概览漏斗与产业版图随转化实时点亮。
• 离线可用：除「企查查画像补全」与「WebSearch 发现信号」两步可选联网外，其余全部本地运行。

> 工作台界面为单文件 HTML（workbench_preview.html），双击浏览器即可打开，无需联网。

二、六大闭环板块

1. 概览：KPI 卡 + 招商漏斗（按阶段统计线索数）+ 阶段跃迁时间轴 + 卡点预警，一眼看清全局。
2. 目标企业线索：51 条示例线索，每行带阶段彩色徽章；点开企业弹窗展示四维画像（基础层/经营层/风险层/行业层 + 信用分/科创分/风险指数/置信度四徽章），可一键「打勾进后续交流」。
3. 每日推荐：前 10 名自动推荐（按契合度+信用+科创加权排序，含推荐理由标签）+ 企业库手动调取两档；底部数据流水线条展示「数据源→获取→清洗→输出→排序」五步与对应算子。
4. 后续交流：从推送池打勾搬运来的企业汇聚于此，一键生成拜访草稿（对接人/议题/携带材料可编辑、可复制）。
5. 拜访执行：待拜访→已拜访→转化/暂缓/流失三分支；转化即点亮产业版图（产业大脑侧栏新增「已落地项目」列表）。
6. 产业大脑：本地产业链节点图谱（24 个本地/上下游 + 6 个全国节点）；已转化企业自动标亮，地图本体保持静态、轻量。

二之一、手机扫楼（一键采集园区/楼宇企业）

外拓招商员到园区/楼宇现场，用手机一键把楼内企业扫回本机工作台。设计严守「本地部署 + 轻质化 + 零云」前提。

工作流
1. PC 端运行 node scripts/scan_server.js → 终端打印一个局域网链接（含随机 token，仅绑内网 IP）；
2. 通过 邮箱（agently-mail）/ 微信 AI 助手（两者均为可选项）把链接发给招商员手机；未配置任一通道的用户，手机同 WiFi 直接点链接也能用；
3. 招商员手机点链接 → 极简采集页「获取定位」→ 输入楼宇/园区名 →「开始扫楼」；
- ⚠️ 手机 GPS 自动定位需 HTTPS：浏览器仅在安全上下文（HTTPS 或 localhost）允许地理定位。默认 scan_server.js 走 HTTP 局域网，手机浏览器会禁用定位——此时请手动填写楼宇名，扫楼主流程不受影响。
- 如需 GPS 自动填坐标：用 ZS_CERT / ZS_KEY 指向证书与私钥（PEM）启动服务即切换 HTTPS（node scripts/scan_server.js，设环境变量后终端链接变为 https://...），手机访问即可自动定位。
4. 手机把坐标+楼宇名回传 PC → PC 持企查查 KEY 查全楼企业（降级则返回通用占位示例）→ 推回手机清单；
5. 招商员勾选要跟进的企业 → 回传 PC → 写入本机 leads（source=扫楼）→ 重跑 gen_preview.js 即在工作台出现。

数据来源与降级（重要）
- 企查查连接器（qcc-company）仅支持「按企业全称/信用代码查单家」，不支持按坐标/楼宇反查整楼；故「扫全楼」走用户自备 KEY 的企查查开放平台直连（qcc_client.js），KEY 仅存本机、绝不下发手机/云。
- 降级（默认）：未配 QCC_KEY 或 KEY 不含「周边/楼宇企业查询」时，返回通用占位示例企业，仅用于把流程跑通（无任何真实地名/企业泄露）。
- 升级（可选项）：配置 QCC_KEY 且设 QCC_ADVANCED=1（表明 KEY 套餐含周边/楼宇查询）后，返回真实全楼企业清单。失败自动回退降级。

双通道发链接（均可选）
- node scripts/send_scan_link.js --mail 生成邮件转发文案（若配 AGENTLY_MAIL_CMD 则自动发）；
- node scripts/send_scan_link.js --wechat 生成微信转发文案；
- node scripts/send_scan_link.js --both 两者都生成。
- 别的用户若未配置微信 AI 助手 / AI 邮箱，跳过即可，不影响扫楼主流程。

三、本地数据层

所有运营数据通过 scripts/data_store.js（基于 Node 内置 node:sqlite）读写。

• 默认数据目录：skill 目录下的 data/ 子目录，自动适配任意电脑与盘符。
• 自定义目录：设置环境变量 ZS_DATA_DIR 覆盖（例如指向已有数据库）。
• 运行环境：需 Node 22+ 且内置 node:sqlite（WorkBuddy 受管 Node 24 满足）。用 node 直接执行脚本即可。

数据表：

• policies 政策库（category/title/content/source）
• cases 案例库（历史招商打法/失败复盘）
• projects 项目库（name/industry/stage/progress/owner/note，状态闭环：待接单→对接中→意向洽谈→签约→落地→已归档，含异常关闭）
• leads 企业线索库（company/industry/scale/location/signal/fit_score；扩展三维分、signal_detail、credit_code、enrichment 企查查档案、follow_status、lead_stage 阶段、fit_reason 逐维度依据）
• knowledge 方法论库（检索策略/契合度打分/算账口径）
• enterprises 本地企业名录（以链主为锚的产业链节点）
• todos 待办（概览「今日待办」来源）
• signals 招商信号滚动栏（新闻/政策/企业动态/展会）
• suggestions 决策建议（周/月）

四、常用命令

以下 node 指 Node 22+（内置 node:sqlite）。SK 为 scripts/data_store.js 路径，GEN 为 scripts/gen_preview.js 路径。

# 初始化数据库（首次或重置）
node "$SK" init

# 灌入演示数据（从 scripts/seed_data.json 复刻示例库，幂等）
node "$SK" seed-demo

# 政策 / 案例 / 项目 / 线索 / 知识 等增删查
node "$SK" add-policy --category 税收 --title "..." --content "..." --source "..."
node "$SK" list-policies --keyword 高新
node "$SK" add-project --name "某生物药企落地" --industry 生物医药 --stage 洽谈 --progress 40
node "$SK" update-project --id 1 --stage 签约 --progress 60
node "$SK" bulk-add-leads --file "/path/leads.json"     # 先用 WebSearch 抓信号再结构化
node "$SK" match-leads --industry 生物医药 --top 10
node "$SK" add-knowledge --topic "契合度打分规则" --content "..."

# 企查查档案补全（先实体识别，再拉档案后 enrich）
node "$SK" enrich-lead --id 19 --credit "91320113MA212GWXXU" --enrichment '{...}'

# 待办 / 信号 / 决策建议
node "$SK" add-todo --type 联系 --title "联系XX确认拜访" --due 2026-07-25 --owner 招商一组
node "$SK" add-signal --category 政策 --title "..." --summary "..." --source "..." --industry 新能源 --hot 1
node "$SK" add-suggestion --period weekly --title "本周招商作战建议" --content "{...}"

# 导出全部（供预览/报告）
node "$SK" export

# 生成工作台预览 HTML（产物 workbench_preview.html，双击浏览器打开）
node "$GEN"

# 一键内容生成 / 外勤 / 尽调（真实成品文件，输出到 skill 目录的「生成材料」或 skill 根目录）
node "scripts/gen_doc.js"          # 汇报稿/话术/邀请函/PPT大纲
node "scripts/gen_trip.js" --mode 高铁 --days 2
node "scripts/gen_diligence.js"

# 手机扫楼（本地局域网采集，零云）
node "scripts/scan_server.js"                 # 启动服务，终端打印扫楼链接
node "scripts/send_scan_link.js" --both       # 生成邮箱/微信转发文案（通道均可选）
node "$SK" add-scan-lead --company "某科技园甲企业" --industry 新能源 --building "某科技园A栋" --fit 72
node "$SK" list-scan-leads                    # 查看已扫回的线索

五、各模块执行工作流（Agent 照此走）

目标企业线索（最常用）

1. 与用户确认产业方向与信号偏好（扩产搬迁/新设基地/研发中心/专精特新）。
2. 用 WebSearch 检索（多组关键词并行：如 生物医药 扩产 新基地 2026、专精特新 小巨人 招股书 搬迁、制造业单项冠军 落子）。
3. 把结果结构化为 JSON 数组（company/industry/scale/location/signal/fit_score/note），写临时文件。
4. 调用 bulk-add-leads --file 入库；再用 match-leads 按产业排序。
5. 输出可跟进清单（含契合度与接触建议）。

产业靶心图谱

• 用户给主导产业 → WebSearch 产业链公开资料 + 知识库方法论 → 输出节点图（文字/Markdown）+ 缺口清单。可用 Visualizer show_widget 画产业链结构图。

政策智能匹配

• 从 policies 表按关键词/分类检索，匹配企业特征适用的政策，列依据。

生成类（PPT/文本/文稿/尽调/行程）

• PPT 大纲与文本由 gen_doc.js 产出 .md；如需实体 .pptx 可调用 tencent-pptx Skill。
• 外勤行程 gen_trip.js、企业尽调 gen_diligence.js 生成独立 HTML 成品，并在工作台「材料文稿」中提供入口。

项目管理与算账

• add-project / update-project / list-projects 维护在谈项目；list-leads+match-leads 做分类陈列。
• 用 knowledge 里的算账口径结合项目数据算回收期/贡献，输出风险提示。

六、企查查接入流程（需配置 API KEY）

1. 用户拿到 agent.qcc.com 的 MCP Key 后交给 AI；
2. AI 用 qcc-company 连接器 get_company_by_query（实体识别）→ get_company_profile（拉工商/股东/司法/知产/舆情）补全档案；
3. 把档案映射为四维 JSON 写入 leads.enrichment（命令见上）；
4. 重跑 gen_preview.js 重新生成 workbench_preview.html → 画像/筛查即时生效；
5. 若需「点击即实时拉取」，在模板顶部设 PORTRAIT_API = "<服务端端点>"（可选，需另起 Node 服务代理企查查）。

接入点常量：preview_template.html 顶部 QCC_READY（置 true）、PORTRAIT_API（实时端点，默认可空）。未接入时画像退化为「契合度+招商信号」排序，并提示「接入后叠加信用分/科创分」。

七、首次使用引导

1. 运行 node data_store.js init 建库（或 seed-demo 直接灌入演示数据）。
2. 运行 node seed_demo.js（等价于 seed-demo）灌入示例政策/案例/项目/线索/知识，立即可见完整闭环演示。
3. 运行 node gen_preview.js 生成 workbench_preview.html，双击浏览器打开看整体效果。
4. 选定主打产业，跑一次「目标企业线索」验证全链路。

八、与云端交付版的关系

本地版功能与招商局云端交付版一致，差异仅在数据存储位置（本地 SQLite vs 云端 API）。后续若要交付招商局，把 data_store.js 的 SQLite 读写换成云端接口即可，模块逻辑与提示词几乎不动——这是刻意的「同构设计」。

> 说明：对外交付物（说明/界面/指南）一律称「本地存储」，不出现任何内部平台概念。本 Skill 自身即方法论与流程的承载者。

九、更新日志

v2.1.0（2026-07-28）

• 新增「手机扫楼」：PC 端 scan_server.js 起局域网服务，招商员手机点链接 → 定位+楼宇名 → 一键扫回楼内企业写入本机 leads（source=扫楼）。详见「二之一」节。
• 降级（默认）：未配企查查 KEY 或 KEY 不含「周边/楼宇企业查询」时，返回通用占位示例，流程可跑通且无真实泄露。
• 升级（可选项）：设 QCC_KEY + QCC_ADVANCED=1 后返回真实全楼企业（企查查连接器本身仅支持单家查询，故扫全楼走用户自备 KEY 的开放平台直连）。
• 双通道发链接（均可选）：邮箱（agently-mail）/ 微信 AI 助手 二选一或都要；别的用户未配置可跳过，手机同 WiFi 直接点链接也能用。
• 免 KEY 演示默认开启：不配 KEY 即可跑通完整闭环（内置契合度排序），生产核验/真·扫全楼仍需配 KEY（KEY 仅存本机，不上手机/云）。
• 新增「产业补链诊断」（本地规则版，不调云）：基于产业图谱节点比对，列出缺环环节与招引建议。
• 新增「政策智能匹配」：政策库 + 线索行业 TOP5 方向联动展示。
• 标签化：扫楼线索自动打 source=扫楼 + tags=扫楼，便于筛选与统计（list-scan-leads）。
• 数据层 leads 新增 source / park / building / tags 字段（兼容旧库，可重复执行）。

> 注：企查查连接器（qcc-company）当前能力边界为「按企业全称/信用代码查单家」，不支持按坐标/楼宇反查整楼；这是选择「用户自备 KEY 开放平台直连」方案的根本原因。