floodwise 是一个面向 AI 智能体的数据工具，用于按邮编查询英格兰的长期洪水风险。其名称“Qiniso”在祖鲁语中意为“真相”，强调提供经过验证、可信赖的数据，而非模型猜测。
用途 当用户向大语言模型询问“SW1A 1AA 的洪水风险如何”时，模型往往会自信作答，但每个邮编的洪水风险是特定的、经过整理的数据，存在于政府数据集中，而非模型权重中。floodwise 会在环境署官方的“洪水风险：邮编搜索工具”数据中查找该邮编，返回真实的长期风险带，或者诚实地返回“未找到”，而不是猜测。
主要能力
- 按邮编查询英格兰的长期洪水风险等级。
- 返回每个邮编周边区域处于高（≥3.3%/年）、中（1–3.3%）或低（0.1–1%）长期风险（来自河流、海洋或地表水，取其中最高者）的地址数量，并单独提供地下水“可能/不太可能”的指示。
- 邮编接受带空格或不带空格、任意大小写。
- 格式正确但不在已加载英格兰数据集中的邮编返回 found: false 并附明确说明，绝不编造风险等级。
- 数据约每季度刷新一次。
使用方式 floodwise 通过 stdio 在本地运行（无需密钥、无需登录）。在 npm 上发布后，可在客户端配置的 mcpServers 下添加。它也可作为库导入使用，由同一套 core.ts 工具定义驱动。仓库附带一个说明性的起始样本（非地理性的 ZZ 伪邮编），使测试开箱即用，其每个响应都标记为 dataset: "sample"。要加载真实数据，需从 data.gov.uk / Defra Data Services Platform 下载 Postcodes_Risk_Assessment_All.csv 并运行相应命令。
适用场景 适用于需要为 AI 智能体提供可信英格兰洪水风险数据的场景，例如在对话中查询特定邮编的长期洪水风险，或将其作为库集成到应用中。
限制
- 仅限英格兰。数据来自环境署，覆盖英格兰；威尔士（Natural Resources Wales）、苏格兰（SEPA）和北爱尔兰（DfI）不在覆盖范围内。有效的威尔士/苏格兰邮编返回“未找到”，绝不猜测。
- 区域级别，非房产级别。风险针对邮编内地址周边区域，而非特定建筑。环境署指出该数据“通常不适合房产级别评估”。
- 长期风险，非实时预警。反映长期年度洪水概率，而非当前或预报是否正在发生洪水。不构成保险、承保、测量或专业建议。
- 不涵盖所有洪水类型。排除来自公路排水、下水道和地表径流的洪水；地下水单独报告，不合并进主要风险带。
- 非全英国。仅限英格兰。
- 不猜测。未知或超出覆盖范围的邮编返回诚实的“未找到”，绝不编造风险等级。
技术说明 这是一个单一的 TypeScript 包，通过 stdio（本地 / npx）暴露一个 MCP 服务器，由同一套 core.ts 工具定义驱动可导入的库。包含一个 Cloudflare Worker 入口，用于未来的托管边缘端点——注意完整的英格兰数据集（约 160 万邮编）超出 Worker 打包限制，因此托管版本将把数据移入 Cloudflare D1（后续工作）；npm 库和 stdio 服务器直接运行完整数据集。该工具在本地机器上运行，设计上不收集、存储或传输用户数据——无分析、无遥测、无账户。所有参考数据均打包在内——无网络调用，数据不离开设备。
许可 Apache-2.0。洪水数据 © Environment Agency，Open Government Licence v3.0。
