# knowledge-guard
**Repository Path**: smallmoon/knowledge-guard
## Basic Information
- **Project Name**: knowledge-guard
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-11
- **Last Updated**: 2026-11-16
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 知识守卫队 · Knowledge Guard
面向小学三年级的单文件教育塔防原型:答对题 = 斩杀敌人 / 点亮知识地图格子。**零外链、零构建、断网可玩**。
- 线上入口:(`http://47.93.58.68/` 是另一张默认页,不是应用,别拿裸 IP 验版本)
- 运行产物:`prototype/index.html`(P7 基线 397,635 B,sha256 `b8e29fcdaac49a076de3adc019cef5b880ea056265edcca730051af12868ba80`)
## 目录
| 路径 | 内容 |
| --- | --- |
| `prototype/index.html` | 唯一运行产物:内嵌题库、CSS、JS、知识地图、存档 |
| `prototype/data/` | 题库与知识点映射源文件(三副本一致性由 `validate-bank` 强制) |
| `prototype/tools/` | 门禁、题库同步、平衡模拟、量测脚本 |
| `design/` | Phase 6/7 规格、VFX 规格、护盾改造 ADR |
| `production/` | 变更清单 |
| `deploy/` | 部署脚本与 nginx 配置片段;`staging/` 是待上传副本 |
| `mobile-measure/` | 旋转守卫验收脚本(`npm run check` 会跨目录调用,不能删) |
| `mobile-*.md` / `how-to-play.md` | 需求、架构与玩法说明 |
## 本地开发
```bash
cd prototype
npm ci # 换机器后首次安装 jsdom / playwright;node_modules 不入库
npm run check # 全门禁,必须串行;重脚本并行会被 SIGTERM 137
npm run check:p6 # P6/P7 专项断言(含 Lv1 冻结对照、军械库 CSS、VFX 护栏)
npm run check:p8 # P8 专项:波末结算奖金 / 每波末可建可升 / 不答题不白送
npm run check:tower # 真实 Chromium 塔浮层量测,不需 8090
node tools/v2-acceptance.mjs # 含 A10 20 局矩阵 + A13 认证契约;C「随机猜」必须 0%、G「正确率75%」需 >0(P10 红线)
```
`check:p8` 刻意**不进** `npm run check` 主链(主链已很长,多个重脚本并行会被系统 SIGTERM 137 掐掉)。改波次 / 带题率 / 补给 / 奖金后,除了主链还必须单独跑 `check:p8` 和 `v2-acceptance` 的 A10 20 局矩阵 —— 只看主链会漏掉平衡崩塌:带题率同时是「防守减负率」(答对即斩杀),怪数与塔阵火力是一组耦合参数。改 `ACC_WIN` / 作答正确率口径后还必须跑 `v2-acceptance` 的 A13 静态契约。
> **A10 尺子(P9 起)**:`tools/simulate.mjs` 的策略上限仍是 **12 座 Lv1 math 塔 / 14 个塔位**,A 全答对残血门槛 `≥15` 不放宽。地图 14×8 扣掉路径有 92 个可建位,放开塔数是为了兑现真机反馈「整局要能持续建塔,不能打完才两三座」。历史 `C=65%`(6 座塔尺)与 `C=80%`(12 座塔尺)都是快照,**换尺后不再可比,别按旧区间回退、也别宣称零漂移**。
>
> **通关认证(P10 起,用户 2026-11-12 拍板)**:`ACC_WIN = 0.75`,口径 = `quizRight / (quizRight + quizWrong)`(实际作答次数,含答错冷却后重答)。**作答正确率 <75% 即使守住 5 波也不算通关**;认证只在结算判定,答错瞬间金币 / 守护值 / 塔 / 碎片四字段一个不动(A3 断言原样成立)。A10 的 C「随机猜」(正确率约 24%)目标改为 **`0%`**,G「正确率锁定 75%」只要求 `>0`;`v2-acceptance` A13 守静态契约。20 局定标:A 100% / 满血 20、C 0%(旧 80%)、G 100% / 残血 17,经济与波次一字未动。
改题库后必须跑 `node tools/sync-bank.mjs --embed-html` 回填三副本,否则 `validate-bank` 会失败。
## 部署
```bash
cd deploy
./deploy-ai.sh --key --probe # 只验证密钥登录,不上传文件
./deploy-ai.sh --key # 非交互部署,只上传一个 index.html
```
前提:本机公钥 `~/.ssh/bina_deploy.pub` 已装到服务器目标账号的 `~/.ssh/authorized_keys`。流程是临时文件 → 远端 sha256 校验 → 备份旧版 → 原子替换,只跑 `nginx -t`、**不自动 reload**。密码模式 `./deploy-ai.sh` 保留作兜底。默认目标 `root@47.93.58.68:/home/ui/ai/index.html`,详见 `deploy/README.md`。
## 版本管理
2026-11-11 起改用 git 管理,远程仓库 ****,`master` 分支,已设置 upstream。
- 历史来源:Paperclip 共享目录 `~/.paperclip/instances/.../shared/bina-2`;**原目录原样保留作回滚兜底,不再作为开发主目录**,本仓库是后续唯一开发主目录。
- 首个本地提交是 P7 基线;gitee 初始化生成的 `Initial commit` 保留在历史最底层,本地提交通过 rebase 重放到它之上,**未强推、未改写远端历史**。
- `.bak-*` 历史快照不入库;唯一例外 `prototype/index.html.bak-before-p6-20261110` 是 `p6-acceptance.mjs` 段 A 的 Lv1 冻结对照基准,删了会让门禁失败。
- `node_modules/`、`shots/`、`attic/`、截图与压缩包一律不入库(本地可保留用于跑门禁)。
- 迁移后已验证:`validate-bank` 0 错误、`p6-acceptance` 290/0、`verify-rotate-guard` 16/0;远端独立克隆复验 61 个文件、`prototype/index.html` 397,635 B / sha256 `b8e29fcd…80`。
### 推送
```bash
git push # 已设置 upstream,凭据复用 macOS 钥匙串里的 gitee 账号
```
本机全局 `~/.gitconfig` 写死了 `socks5://127.0.0.1:7890`;该代理没启动时会报 `Failed to connect to 127.0.0.1 port 7890`。gitee 直连可达,所以本仓库在 `.git/config` 里把 `http.proxy` / `https.proxy` 置空,并设 `credential.helper=osxkeychain`。换机器或代理环境不同时可临时覆盖:
```bash
git -c http.proxy= -c https.proxy= push
```
> **仓库可见性**:当前可匿名克隆(公开)。仓库内含服务器 IP、`root` 账号、部署路径与私钥**文件名**(不含私钥内容)等运维信息,建议在 gitee 设为私有,或把运维参数挪到不入库的本地配置。