# 主别墅控制台 · 使用说明

> 末世私人文明 · 主别墅控制台（ARK VILLA CONSOLE）
> 一个完全离线运行的静态网页控制台，以《末世私人文明：主别墅完整设定档》为唯一设定来源。

## 一、如何打开

- 直接双击项目根目录的 `index.html`（推荐 Chrome / Edge），无需安装、无需启动服务器、无需联网。
- 页面使用浏览器 localStorage 保存状态，同一浏览器再次打开会继续上次的沙盒状态。
- 若需从头开始：进入「设定与参数」页 → 控制台运行管理 → 重置沙盒。
- 页面彼此通过左侧导航互相跳转；总览页的 17 个系统磁贴可直接进入各系统。

## 二、界面结构

- **左侧栏**：ARK VILLA 标志、总览 / 基础设施 / 生产体系 / 文明核心 / 生活与保障 / 安全与设定 六组导航，底部为末世时钟。
- **顶栏**：当前页面标题、全局状态（聚变负载、双层防护、卫星链路、室内外温度）、末世日历、时间流速（1× / 10× / 60× / 600×）、暂停键、设定入口。
- **时间模拟**：1× 表示现实 1 秒 = 别墅 1 分钟；加速后农业生长、飞船航线、防护倒计时、协议倒计时等会随之推进。
- **事件记录**：各系统操作会写入总览页的「系统事件记录」以及相关页面日志。

## 三、主要操作入口

### 能源 / 水 / 空气
- 能源：调节聚变输出、供电优先级、储能放电测试、满载演练、故障回路隔离。
- 水：查看闭环率与三级水质，启停 7 个处理模块、水质检测、外部补水。
- 空气：调节目标温湿度与新风比例，分区管理、消杀、滤芯更换。

### 农业 / 医疗 / 废物
- 农业：8 个种植区可播种、采收、补光与营养液调整；13 条食品加工线可独立启停；可查看种质库。
- 医疗：十大医疗模块、生命体征、AI 辅助诊断、药品与耗材、隔离区、急救演练。
- 废物：自动分类与回收数据、有机资源化、危废封存、外围最终处理区自检。

### 机器人 / 制造 / 储存
- 机器人：76 台示例机器人编队，可筛选、派发任务、召回、查看 4 层 AI 架构；可做断网本地自治演练。
- 制造：制造工单、维修工单、自动维修流程、设备健康度与自我维护。
- 储存：末世前物资分类、空间储存完整性扫描、分基地配给、出入库演练。

### AI / 网络 / 家居
- AI 超算：算力集群与 15 项任务负载、知识库检索、算力优先级、科研任务、离线本地模式。
- 网络：私人网络核心指标、12 颗示例卫星、链路切换、全链路测试、断网演练。
- 智能家居：10 个房间独立控制、7 种场景、厨房 / 卧室 / 清洁 / 影音 / 安防。

### 防护与协议
- 第一层外围电控防护、第二层本体防护罩分别操作；关闭前需要完成主人授权。
- 本体防护罩临时关闭约 30 分钟后自动恢复；页面上会实时显示倒计时。
- 最终终止协议默认处于「演练模式」。7 项条件可逐项模拟；关闭演练模式后将进入实弹沙盒判定（含 10 分钟确认倒计时，可中止并挂起）。
- 主动终止授权需要授权 + 二次确认短语；仅在实弹模式才会执行沙盒协议。

### 交通与分基地
- 大型飞船可选择目的分基地、驾驶模式（自动 / 手动 / 交通机器人辅助）并启动航线。
- 飞船抵达分基地后自动共享 AI 算力；返回主别墅后恢复。
- 分基地页可点名、测试卫星链路、派遣飞船与配给物资。
- 超小型无人运输飞船与空间移动能力在同一页面演示。

### 设定与参数
- 25 章设定档索引可直接跳转各页面。
- 第二十五章 15 项未确定参数可记录个人规划草稿，不视为设定定稿。
- 可导出 / 导入 JSON 状态、重置沙盒、记录控制台备注。

## 四、状态与存档

- 存储键：`ark-villa-console-v1`（localStorage）。
- 自动保存：每 12 秒及重要操作后保存；关闭页面前也会保存。
- 导出：设定页「导出状态 JSON」，可用于备份或分享。
- 导入：设定页「导入状态 JSON」，会覆盖当前状态。
- 重置：设定页「重置沙盒」清除全部本地状态并重新初始化。

## 五、设定忠实度说明

- 控制台按设定档第二十五章原则，将未确定参数标记为「待定」，不擅自当作既定事实。
- 页面中的示例数值（聚变规模、储能容量、卫星数量、飞船数量、分基地数量等）仅用于演示，可在设定页记录草稿。
- 授权、最终终止协议等流程为世界观内的交互模拟，不连接真实设备或外部服务。

## 六、开发者信息

- 技术栈：纯静态 HTML + CSS + 原生 JavaScript，无构建、无框架、无外部依赖。
- 共享内核：`assets/js/villa.js`（状态 / 模拟 / 外壳 / 组件）与 `assets/js/data.js`（设定数据）。
- 页面开发规范：`PAGE-GUIDE.md`。
- 页面自检：在项目根目录执行 `node tools/check.mjs <页面.html>`，会使用本机 Chrome 打开页面、收集控制台错误并截图到 `shots/`。
- 全站回归：`node tools/qa-links.mjs`（静态一致性）、`node tools/qa-nav.mjs`（导航与持久化）、`node tools/qa-interactions.mjs`（关键交互）、`node tools/qa-coverage.mjs`（设定条目覆盖）。
- 设定文档：`docs/末世私人文明主别墅完整设定档（补充版）.md`（原文 + 控制台补充草案）。

## 七、常见问题

- **打开后是空白页？** 确认使用 Chrome / Edge 的最新版本，并检查是否启用了严格的本地文件限制；所有资源均为相对路径，项目文件夹需完整保留。
- **状态没有保存？** 某些浏览器在 file:// 下对 localStorage 有限制；可尝试用本地静态服务器打开，或改用 Chrome/Edge。切换浏览器后状态不会共享。
- **想回到设定初始状态？** 设定页 → 重置沙盒。
- **页面数字和设定档不一致？** 示例数值用于模拟演示；以设定档正文与第二十五章的待定说明为准。