技能介绍

要解决的问题

在「口播变文章」流水线中，脚本写完后需要补充真实的楼盘成交、板块均价、政策条款等事实数据来深化内容。这些数据散落在本地 SQL 库、知识库和历史素材中，来源不一、可用性不稳定。如果上游流程直接硬编码查询逻辑，任何一环失效都会导致整条链路中断，或者退而求其次编造数据。

核心机制

这个技能把数据查询拆成三个固定步骤，每一步都有明确输出协议：

Step 1 · 可用性检测：先探测当前会话中哪些数据源在线——本地 SQL、IMA、常青知识库、灵感田逐一确认。
Step 2 · 按方向构造查询：根据深化方向（如「板块对比」「小区深挖」）从路由表匹配数据源。本地 SQL 优先处理结构化数据，常青知识库补政策和贷款信息，IMA 搜索文档，灵感田取历史判断。
Step 3 · 汇总返回：被调用时返回「可注入素材清单」给上游；独立使用时直接输出完整数据表供人工查看。

数据源优先级固定为四级路由：本地 SQL → 常青知识库 → IMA → 灵感田。本地库 xuzhou_v3.db 覆盖贝壳二手和金刚石新房的成交、均价、挂牌等指标，常青知识库存储政策与交易流程文档，灵感田则沉淀历史创作中已验证的判断。

v1.1 引入了全链路容错：外部共享文件缺失时使用内置路由表和 SQL 模板降级；单个数据源不可用时自动跳过并切换到下一级；sqlite3 查询支持 2 次重试、10 秒超时，知识库调用支持 3 次指数退避。

适用边界

这个引擎有几个硬约束。beike_community_weekly 是单周快照，禁止跨周取趋势；部分表标注为「未自动化」或「未整理」，查询前需要人工核实最新期次。所有数据源全部不可用时，输出终止信号而不伪造数据。共享文件 db-access-guide.md 是 Schema 和路由的权威源，内置模板只覆盖最常见的四类查询，复杂场景仍需依赖外部文件。