历史文档归档

之前零散写在桌面、工程目录、飞书里的方案文档和分析报告，全部盘点在这里。 结论已经吸收进百科正文，原件保留供追溯—— 需要「当时是怎么想的」「和谁确认过什么」时来这里。

0. 怎么用这一页

1. 传送专题（Desktop/传送/）

这是最大的一组，从 2026-04-29 的业界调研一路做到 8 月的超时兜底，完整记录了同步瞬移改造的全过程。

1.1 已原样归档（可直接打开）

1.2 方案文档五件套（已索引）

路径：C:\Users\zhaozibo\Desktop\传送\

1.3 协议改动文档

Desktop\传送\teleport-sync-client-protocol.md · 2026-05-12

服务器给的协议契约文档，含 mermaid 序列图和逐协议作用表。三条关键时序约束：

1.4 分析与修复文档

2. 爬塔星级系统方案

C:\Users\zhaozibo\Desktop\爬塔星级系统方案.md · 2026-06-08

面向服务器 / QA / 策划的方案变更说明，记录了一次重要的设计转向：

关卡内追踪提示的设计（需求第 5 条）

新增 ChildQuest 子任务类型「显示星级提示」，关卡行为树调用。 节点激活 → 左上角列出每条条件的 Description → 客户端 CheckConditionNew 实时判定， 达成 = 实心图标 + 正常字体，未达成 = 空心 + 置灰。

文档最后还留了 4 条待服务器 / QA 反馈的问题，都是设计阶段该问的： 星级判定改条件 ID 是否 OK、新条件类型客户端能否本地检测、 提示节点是手填还是自动取、条件文本统一用 Description 是否可行。

3. 环境子弹 TypeId 拼装规则

C:\Users\zhaozibo\Desktop\环境子弹TypeId拼装规则.md · 2026-06-16

这份文档已经完整吸收进 关卡子弹 · TypeId， 包括分段表、fixServerBulletId / GetBulletIdFromInfo 源码、 实例验算和反查方法。看百科页即可，不必再翻原文。

唯一值得单独拎出来的是那条命名陷阱：

function GetBulletIdFromInfo(EntityConfigId, BulletConfigId, BulletTypeId) {
    // ↑ 第三个形参名叫 BulletTypeId，实际是 BulletType（0=子弹 / 1=发射器）
    //   不是最终拼出来的 TypeId，别被名字误导
    const ConfigStr = BulletTypeId === 1 ? '1' : '0';
}

4. 结算相机调度（Desktop/文档/）

4.1 结算相机配置说明（给美术填表用）

Desktop\文档\结算相机配置说明.md · 2026-06-02

这是一份写给非程序看的说明书，是这批文档里质量最高的一份，值得作为写策划文档的模板。

调试时日志过滤关键字：副本结算。 UCurveVector 的横轴是归一化时间 0~1，纵轴是插值进度 0~1，留空 = 匀速直线。

4.2 结算相机调度 · 结构设计方案

Desktop\文档\结算相机调度-结构设计方案.md · 2026-06-01 · 9 KB

程序侧设计：FSSettlementCameraConfig（FTableRowBase + UCurveVector）的结构定义， 以及把 Seq1 换成逐帧 Tween 相机调度的方案。
→ 落地情况见 结算 · Tween 相机。

5. 飞船 / 落兵船惯性

6. 工作流与环境

6.1 开分支操作手册

Desktop\文档\开分支操作手册.md · 2026-04-29

和业务无关，但每次开新分支都要用。 Claude Code 的 memory 按项目目录哈希隔离， 每个分支 workspace（065 / 070 / 080…）会各自生成一份独立 memory。 解决办法是用 NTFS junction 把所有分支的 memory 指向同一份真实数据。

C:\Users\zhaozibo\.claude\shared-memory\        ← 真实数据，唯一一份
        ▲                ▲
        │                │
   065\memory       070\memory                  ← 都是 junction

新开分支时两条 cmd 命令（必须用 cmd，不能用 bash / PowerShell）：

rmdir "C:\Users\zhaozibo\.claude\projects\<新项目目录>\memory"
mklink /J "C:\Users\zhaozibo\.claude\projects\<新项目目录>\memory" "C:\Users\zhaozibo\.claude\shared-memory"

目录名规则：分支根路径删掉 :、\ 换成 -。 如 C:\Client080\Source\Client\TypeScript → c--Client080-Source-Client-TypeScript。

6.2 其它 Markdown

7. 仅登记（docx / xlsx，需 Office 打开）

路径：C:\Users\zhaozibo\Desktop\文档\（除特别标注外）

8. 原始素材

9. 从这批文档里总结出的写作经验