# 《供水管理者的AI时代》HTML + PWA V1.0

**署名：湖山辉映 · 江南AI工作小组**

本项目把《江海潮生》研究中“核心发动机—系统扩张—治理转型—普通人承担”的结构，转译为城市供水企业可执行的AI经营体系。页面可离线安装，包含可视化体系、成熟度阶梯、场景库、治理防火墙、90天/三年路线、AI提示词、三组互动沙盘和本地研究笔记。

## 一、打开方式

### 1. 快速预览

直接双击 `index.html` 可以浏览大部分内容，但浏览器出于安全限制，PWA安装与离线缓存通常需要通过 `https://` 或 `localhost` 访问。

### 2. 本地完整运行

在项目目录打开终端：

```bash
python -m http.server 8080
```

浏览器访问：

```text
http://localhost:8080
```

也可使用任何静态Web服务器。

## 二、核心模块

- 七条供水管理启示
- “一核、两线、六层”AI经营架构
- L0—L6智能化成熟度阶梯
- 水质、水厂、调度、管网、二供、客服、成本与应急场景库
- 数据、模型、控制、网络、责任、回退六道防火墙
- 90天试点与三年体系化路线
- 十组可复制AI提示词
- 场景组合、原水突变、控制边界三组沙盘
- 本地笔记保存与Markdown导出
- 本机累计与可选Cloudflare全站累计

## 三、静态部署

只需要页面、离线和本机累计时，可将项目目录全部文件部署到任意静态托管服务。

Cloudflare Pages控制台“拖放上传”可部署静态页面，但不会编译本项目的 `functions/` 目录，因此不会启用跨设备的全站累计。此时页面会自动回退为浏览器本机累计，不影响其他功能。

## 四、Cloudflare Pages + 全站累计

全站累计采用可选的Pages Function和Workers KV。KV适合个人研究站点或中低频互动统计；它属于最终一致存储，不应作为审计级计数系统。

### 1. 通过Wrangler部署

确保本机已安装Node.js，然后在项目目录执行：

```bash
npx wrangler login
npx wrangler pages project create
npx wrangler pages deploy .
```

首次也可直接执行最后一条命令，并按提示创建项目。使用Wrangler时，项目根目录的 `functions/` 会一起部署。

### 2. 创建KV命名空间

```bash
npx wrangler kv namespace create SITE_COUNTERS
```

命令会返回一个KV命名空间ID。可以把绑定写入 `wrangler.jsonc`：

```jsonc
{
  "kv_namespaces": [
    {
      "binding": "SITE_COUNTERS",
      "id": "替换为你的KV命名空间ID"
    }
  ]
}
```

也可以在Cloudflare控制台进入：

```text
Workers & Pages → 选择项目 → Settings → Bindings → Add → KV namespace
```

变量名必须填写：

```text
SITE_COUNTERS
```

绑定后需要重新部署。

### 3. 验证

部署后访问：

```text
https://你的域名/api/counter
```

若返回JSON计数对象，则全站累计已启用；若返回503，说明页面可正常使用，但KV绑定尚未完成。

## 五、PWA安装

- iPhone/iPad：Safari打开网页 → 分享 → 添加到主屏幕。
- Android/桌面Chrome或Edge：使用浏览器地址栏的“安装”提示，或页面顶部“安装应用”。
- 首次联网打开后，核心页面、样式、脚本和图片将进入离线缓存。

## 六、供水安全边界

本工具用于经营研究、培训和桌面推演，不替代：

- 法律法规与现行标准；
- 经批准的设计文件和运行规程；
- 水质化验与仪表校准结论；
- 调度命令、现场联锁和授权人员决策；
- 网络安全审查和生产控制系统变更程序。

特别强调：通用大模型不得直接写入PLC、SCADA、加药、泵组或阀门设定值。任何进入生产控制链的功能都必须经过白名单、限幅、联锁、权限、独立验证、审计和可演练回退。

## 七、版本

- 版本：V1.0
- 日期：2026-08-28
- 署名：湖山辉映 · 江南AI工作小组