admin
e6207aa691
build / build-and-scan (push) Canceled after 0s
文档库：目录改为编号制（01-规范/02-架构设计/03-数据库/04-调整方案/
05-交接单/06-ops/07-scripts/08-skills/09-archive），顶层散文件归入 01-规范/；
INDEX.md 与 docs-manifest.json 重刷（档案 146 篇）；旧目录名引用全量对齐。
IM 线：src/im/**（SDK / hub / store / presence / ws / gateway-token）、
src/web/routes/im.ts、src/db/plugin-data/**、src/supervisor/plugin-assembly.ts
及对应 test/**。
插件线：poc/{im-agent-bridge,im-connection-gateway,im-conversation-tabs,
business-plugins-im,carbon-mcp-probe}、src/web/routes/{sessions,overlay-device}.ts、
src/net/relay/{device-grant,instance-credential}.ts。
仓库卫生：清出 40 个历史误入库 / 已改名文件（34 个交接单归档 + 6 个旧结构，
本地均有副本）；dsh-server-docs/.gitignore 补 tmp/；交接单不入库（政策）。
架构设计（定稿）
一个目录装全部架构文档，文件名标明是哪个架构。每份都是「推演完成、结论收敛、可直接据此施工」的成品。
与 04-调整方案/ 的分工（🔴 别混）
04-调整方案/ |
本目录 02-架构设计/ |
|
|---|---|---|
| 装什么 | 过程 —— 调研、推演、取证、权衡、待拍板 | 成品 —— 收敛后的架构设计 |
| 形态 | 逐个问题一档，编号递增（100–150…），记录「当时怎么想的」 | 按架构成篇，文件名＝架构名 |
| 会不会过时 | 会 —— 需求变则结论变 | 不轻易变 —— 只有架构本身变了才改 |
| 读者 | 追根因、查证据、看权衡过程 | 照此施工、对外介绍、新人理解全局 |
| 可否删 | ⛔ 不可（是历史与判据来源） | ⛔ 不可（是当前唯一权威） |
判据一句话：想知道「为什么这么做」→ 查 04-调整方案/；想知道「现在该做成什么样」→ 查本目录。
命名约定
<对象>-<架构名>.md。例：覆盖网络-顶层架构全貌.md。
- 对象 = 覆盖网络 / 平台 / 插件体系 / 客户端 …
- 架构名 = 这份文档讲的那个架构，看文件名就知道该不该打开
- ⛔ 不用编号前缀（编号属过程档案），本目录内按文件名排序即可
当前内容
| 文档 | 讲什么 | 定稿 |
|---|---|---|
覆盖网络-顶层架构全貌.md |
两图分离 · 三层权威 · 多根与角色升格 · 缺口与推进序 | 2026-09-21 |
数据-分库与权威存储架构.md |
一插件一库 · 归属列与按用户迁移 · 文件入桶 · S0–S5 路线 | 2026-09-22 |
来源（过程依据）
本目录内容不是新写的，而是从过程档案收敛而来，每条结论都能回溯到带 file:line 的证据：
- 103–117 —— 可行性、全球架构复盘、九大瓶颈、骨干层、百台/千台推演、游戏专项、答疑、补遗、传输方案取舍、应用场景、插件化判断、问题逐条推演、参数表
- 118–120 —— 会合中继拆分、集群化 Manager/Worker、跨节点迁移
- 133 / 136 —— 低熵块治理、控制面按两台中继取并集
- 145 / 146 / 147 —— 会话并存与设备来源维度、中继 per-port 额度、多节点插件投放
- 148 —— 多 Manager 多区域联邦形态（首份提出元假设问题）
- 149 —— 顶层架构全貌（信任图/数据图分离；修正 148 两处过强表述）
- 序③ 交接单 —— 四层密钥模型落地（离线根 → 在线签名者 → 每机节点密钥 → 会话）
- 数据分库 —— 用户拍板 2026-09-22（「分库 = 不同插件建不同库」＋「用户数据入库以便备份与迁移，实例本地只留文件与缓存」）；取数基线 = 服务器实测（47 / PG 13.23 / 单库
dshs/ 13 张内核表 / 迁移 v13）+src/db/index.ts:19-23（单库单适配器）+src/fs/user-fs.ts:113/126（home 面无二进制通路）
⚠️ 本目录与过程档案冲突时，以本目录为准；若发现冲突，请在过程档案头部加状态块指向此处，⛔ 不要直接改过程档案正文。