portal: 金钻宇宙换成星系图(three.js 懒加载)+ 推送前审查 + 总交接文档

Browse Source
- 门户「金钻宇宙」:删掉启动仪式 / 宇宙首屏晶体 / 盘符机架 / 读盘舱及其 CSS、图标;
  换成星系图(portal/assets/universe/,three.js r170 自托管于 assets/vendor/,第一次打开板块才下载)
  + 窗下世界线卡片;#0001 深链飞到对应世界线;世界线数据只留 config.js 一份
- 像素字子集重做(旧字全保留 + 新字);其余板块与改动前逐像素一致
- 后端审查:add_call 写库失败不再打断渲染机回传;多进程同时首启只导入一次(+1 条测试,共 38);
  撤销「处理过了」清掉 handled_at
- 交接文档-2026-10.md:变更清单 / 功能增删 / 接口与数据格式变更 / 设计规范 / 业务逻辑 / 部署运维
- 交付清单哈希重算;README、旧交接说明指路

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-05 17:31:36 +00:00
co-authored by Claude Opus 5.5
parent 3ae940d828
commit 09b229deee
19 changed files with 1444 additions and 1355 deletions
+8 -3
View File
@@ -736,7 +736,11 @@ def add_call(rec):
数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** ——
手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。
"""
STORE.call_add(rec)
# ⚠️ 这条也会在渲染机回传(finish_upload)里调:库写失败只记日志,绝不能让异常把回传打断
try:
STORE.call_add(rec)
except Exception as e: # noqa: BLE001
log("⚠️ 呼叫记录写库失败(只写了 calls.jsonl):%r" % (e,))
try:
with open(CALLS_FILE, "a", encoding="utf-8") as f:
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
@@ -3433,8 +3437,9 @@ class H(BaseHTTPRequestHandler):
cid = int(d.get("id"))
except (TypeError, ValueError):
return self.err("没有这条记录", 404)
if not STORE.call_mark(cid, handled=not d.get("undo"),
handled_at=now().isoformat(timespec="seconds")):
undo = bool(d.get("undo"))
if not STORE.call_mark(cid, handled=not undo,
handled_at=None if undo else now().isoformat(timespec="seconds")):
return self.err("没有这条记录", 404)
return self.js({"ok": True, "id": cid})
+4
View File
@@ -318,6 +318,10 @@ class Store(object):
return default
now = time.time()
with self.tx() as c:
# 服务器和 admin.py 同时第一次启动时,两边都会走到这里:BEGIN IMMEDIATE 让它们排队,
# 后进来的那个在事务里再看一眼,导过了就不再导(不然呼叫记录会导两份)
if c.execute("SELECT 1 FROM schema_info WHERE k='imported'").fetchone():
return None
for k, rec in (jl(os.path.join(R, "codes.json"), {}) or {}).items():
if isinstance(rec, dict):
c.execute("INSERT OR IGNORE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
+10 -1
View File
@@ -14,7 +14,7 @@
7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用)
8. 热备份能打开、行数一致;完整性检查 ok
9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢;三个进程同时第一次启动只导一次
11. 规模:5000 张码 + 2000 单,按状态列订单的耗时
"""
import json, os, random, shutil, sqlite3, subprocess, sys, tempfile, threading, time
@@ -255,6 +255,15 @@ for i in range(300):
ps = [subprocess.Popen([sys.executable, "-c", writer, x]) for x in ("A", "B")]
[p.wait(timeout=120) for p in ps]
check("并发:两个进程同时各写 300 张码,600 张一张不少", len(st5.codes_all()) == 600, "%d 张" % len(st5.codes_all()))
R7 = tempfile.mkdtemp(prefix="ys-db-race-")
make_legacy(R7, n_codes=20, n_orders=6)
opener = "import sys; sys.path.insert(0, %r); import store; store.Store(%r)" % (SRC, R7)
ps = [subprocess.Popen([sys.executable, "-c", opener]) for _ in range(3)]
[p.wait(timeout=120) for p in ps]
st7 = store.Store(R7)
check("并发:三个进程同时第一次启动,旧数据只导一次(呼叫记录不翻倍)",
len(st7.calls()) == 6 and len(st7.codes_all()) == 21, "呼叫 %d 条 · 卡密 %d 张" % (len(st7.calls()), len(st7.codes_all())))
shutil.rmtree(R7, ignore_errors=True)
# ================================================================== 11. 规模
R6 = tempfile.mkdtemp(prefix="ys-db-scale-")
+3 -3
View File
@@ -53,7 +53,7 @@
| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG |
| `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 |
| `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) |
| `tests/数据库测试.py` | ~290 | 数据库专项(37 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
| `tests/数据库测试.py` | ~290 | 数据库专项(38 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
> 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。
@@ -179,13 +179,13 @@
### 5.6 测试
```
python3 tests/数据库测试.py <server.py 所在目录> # 37 条:数据库专项
python3 tests/数据库测试.py <server.py 所在目录> # 38 条:数据库专项
python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上)
```
- 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。
- 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。
- 2026-10-05 结果:**64 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
- 2026-10-05 结果:**65 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
### 5.7 文件 / 目录(库以外的)
+7 -1
View File
@@ -355,7 +355,7 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
接口路径、请求 / 响应字段:没动。
数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动,
`admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。
你怎么验证的:tests/数据库测试.py 37 条(全新安装 / 迁移 / 重启不重导 / 只改变化的行 / 清理 / 回滚 /
你怎么验证的:tests/数据库测试.py 38 条(全新安装 / 迁移 / 重启不重导 / 多进程同时首启只导一次 / 只改变化的行 / 清理 / 回滚 /
导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模);
tests/回执复现测试.py 27 条照旧全过(现在跑在库上)
```
@@ -376,3 +376,9 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
- 没在你们的真机器(1.6G 内存 + systemd MemoryMax)上跑过;库很小(几千行级别),按测试的内存占用不会有压力,但请部署后跑一次 `admin.py db check`。
- `admin.py` 用别的账号跑时的目录权限(WAL 要在 `<DATA_DIR>` 里建两个小文件),见交接说明 5.1。
### 第二轮自查修掉的三处(推送前审查)
- `add_call`:渲染机回传(`finish_upload`)的「部分失败」也调它;写库出错原来会把异常抛到回传接口 → 改成只记日志、`calls.jsonl` 照写。
- `store.import_legacy`:服务器和 `admin.py` 同时第一次启动会各导一遍(呼叫记录翻倍)→ 在写事务里再判一次「导过没有」。测试加了一条(三个进程同时首启)。
- `admin_call_done`:撤销「处理过了」时 `handled_at` 没清 → 一起清掉。