技术栈保留 / 收敛评估

September 7, 2026 · View on GitHub

文档角色：技术栈决策 canonical doc。
最后核对代码基线（全局技术栈评估的历史锚点）：commit 9f8f0c225（2026-04-20）；它不是下文 §3 的 Agent Runtime source baseline。§3 保留 F7 C1 与 F8 协议冻结的历史锚点；当前 P4/P5 formal release source 为 bf9be8c43b223b84f487464a7e6aa9eb8211630b / tree 44de7f66421a908723f196718e42867dce601f30，F8 implementation/release source 53caabc90941826ddacf626f536b0f473adbf049 / 6f3d50a52413c747b05b74be88d6ee46650f4597 只保留为被当前列车继承的协议底座历史。

1. 总结结论

当前不建议发起“代码层全栈重写”。
建议发起的是：文档与治理全量翻新 + 技术栈收敛路线图。

原因不是“现有技术栈很优雅”，而是：

  • AS2 / Flash CS6 仍是物理约束，不能假装不存在
  • C# Guardian + WebView2 已经成为运行时中枢，重写代价高、回归面大
  • TypeScript / Rust / PowerShell 目前更多是受控边界件，不是失控主栈
  • 当前最大问题是 认知失真和治理缺位，而不是“语言数量本身”

2. 三段式矩阵

Hard Keep

栈 / 组件当前角色保留理由
AS2 / Flash CS6核心游戏逻辑、资产编译无现实替代链路，且游戏主体绑定该运行时
C# Guardian Launcher宿主、启动链、总线、音频、存档决议已是运行时中枢，不再是可随意替换的外设
WebView2 overlay / Panel 系统启动引导、运行态 UI、小游戏已承载 UI 迁移成果，回退成本高
本地通信总线（XMLSocket / HTTP / TaskRegistry）Flash ↔ Host 的既有契约现有运行时集成依赖明确，替换风险高

Contain

栈 / 组件当前角色收敛原则
TypeScript / ClearScript V8Launcher 内嵌 GameInput DFA 与构建工具链只服务于 launcher/，不扩展成新的独立应用层；伤害数字 reducer 不回流 V8
Rust sol_parser单一 native 解析边界件保持单一职责，不把 Rust 扩成新的业务主栈
PowerShell 自动化Windows 启动、Flash smoke、诊断保留，但避免把核心业务逻辑沉到脚本层
Node 运行时TypeScript 构建、QA、developer JSONL/MCP 客户端与便利包装只作为工具/适配运行时；无人值守安全身份、session truth、策略与执行器均在受验证的 C# Core/Host，不把 Node 或 PowerShell 叙述为生产 authority
Native Audio Platform v2miniaudio 0.11.25、静态 Xiph decoder 与 Windows Media Foundation AAC 组成 Launcher 的单 DLL 音频边界固定版本/源码 SHA/许可证与构建 flags；production 只允许 WASAPI/DirectSound/WinMM，禁止 Null；外部只见版本化 caller-owned ABI/capability，不把 codec 或设备对象扩散到 C#/AS2

Retire / Stop Expanding

旧概念 / 旧叙述当前处理
“项目就是单纯的 AS2 + Flash CS6 技术栈”停止作为顶层项目概述使用
“当前运行态依赖 Node.js 本地服务器”停止扩散，仅保留历史语境说明
V8/Flash 同时维护伤害数字 renderer 或 fallback已退役；C# 是唯一 reducer/painter，AS2 只在 H1 时产出段事件
与当前架构不符的旧版本 / 旧路径 / 旧测试说明逐步清理并交给治理巡检拦截
在入口文档重复复制子系统深文档停止扩张，改为链接 canonical doc
用 FFmpeg/libVLC/GStreamer、系统 codec pack 或 loose codec DLL 扩张音频格式本轮停止；甜区固定为 WAV/MP3/FLAC/Vorbis/AAC/Opus，新增格式必须先有资产需求、依赖治理与端点资格证据

3. CF7 Agent Runtime / Wings 一期边界

边界source truth收敛原则与外部缺口
F7 C1 历史冻结最终 C1 dd84230a1d262c6478591cae2d11051b7a8aa7b1（2026-07-31）冻结 CF7A v1 当前用户命名管道、受 ACL 保护的 rendezvous、精确进程/HWND/session registry、观察 grant、独占 write lease、WGC/guarded input、结构化 action/receipt/reconcile、purpose-scoped audit，以及使用共同 owner pending marker 与同目录 atomic move 的 8 MiB Runtime-owned JSONL trace export；Wings Shell/Persona/offline backend、当时的 production window.activate、Hair transaction 与 F7 shutdown/runner 单终态闭包接入同一 Host pipeline该行只保留历史 source truth 和负向验收证据；其中 production window.activate 已由 F8 current 收紧，不得据此推导当前授权。C1 source frozen 不等于 candidate 执行、实机 E2E、v2 promotion 或标准入口验收
F8 current formal releaseimplementation source 53caabc90941826ddacf626f536b0f473adbf049 将 embedded Flash 固定为 metadata-only（observationModes=[]、inputModes=[]，pixel capture 返回 unsupported_for_surface）；production 不发布 window.activate 且 activator map 为空，WGC 只落在 Launcher、WebOverlay、NativeHud。panel.open 只对 `helpmap

一期 ADR 文件名保留首次冻结日 2026-07-30，避免 canonical 路径与链接漂移。F7 documentation-only D1 只引用父 C1 dd84230a1d262c6478591cae2d11051b7a8aa7b1；它仍是历史记录，不覆盖 F8 implementation/release source 53caabc90941826ddacf626f536b0f473adbf049 / 6f3d50a52413c747b05b74be88d6ee46650f4597，也不覆盖当前 P4/P5 formal release source bf9be8c43b223b84f487464a7e6aa9eb8211630b。

F7 的 shutdown 边界不可下沉到脚本层：LeaseDescriptor.purpose 必填、renewAfter 可选且 shutdown 必须省略；只允许 DeveloperInteractive / UnattendedTest，请求的 exact scope 恰含当前一个 RuntimeOwned Launcher target（不推导 session 全局 singleton），并固定 session.shutdown、TTL≤30 秒、one action、no renew。lease 只将 active/执行中/待交付记录保持 live；terminal tombstone FIFO 256、committed-session latch 64，后者溢出即全局 fail-closed，eviction 不得重开写。renew/release cleanup 只属于 exact active owner。成功 consume 的 owner 持有 reservation 到全部 frames 完成或显式 abort；abort false 保留 reservation 并丢失 continuity，完整写后 commit false 不回滚字节并丢失 continuity。单一 action deadline 从完整 request frame 收到时开始，覆盖 parse/admission/scheduler/performer/writer lock/全部 frame WriteAsync。

SafeExit 只先 arm；首字节前先 claim reserved audit identity，再 claim lease delivery ownership 与 human-input sequence fence。external input 撤销尚未 write-owned 的 active / execution-pending / delivery-pending / queued 工作；ownership 成功后 human override 不得回滚，terminal 只由 completion state machine 收束。action_response_written/unknown 禁止 generic append，DeliveryUnknown 固定 ReconciliationRequired；ledger replay 原样返回 retained ContractReceipt（含 Unknown）。全部 frame 的 WriteAsync 只表示 server disposition，不是 peer ack；Flush、post-write audit 或 commit failure（包括 callback 返回 false 或抛异常）均不回滚字节。

受信 runner 在每次完整/周期 surface refresh 重试 credential publication，以 single-flight 和 teardown barrier 隔离 dispose；Core 内部使用 caller 不可调、按 exact ordinal slot 固定的单调 credential-acquisition 上限：四个历史槽 30 秒，仅 A5 真实标题/固定进档栅栏 60 秒，独立于最长 10 分钟 bootstrap request/session。stdout 只承载 JSONL/MCP protocol 且无秘密；只有 adapter=0、strict receipt、exact child exit 0 且无 forced recovery 时，stderr 才输出一行 ≤16 KiB、只含 schema/runtime/process/Core hash/build identity/payload closure/PID/terminal receipt 的非秘密证据。

F7 C1 历史 source evidence 为 Launcher 全树 2678 passed + 3 explicit opt-in skipped / 2681 total，0 fail、SDK resolver 7/7（精确 .NET SDK 10.0.300）、Node client 37/37、TrustedRunner 过滤 48/48。exact C1 tree 的 production policy 26/26 达到 candidate_built / NOT_DEPLOYED（identity F67F1054E7DD19600138C3196D0798CFA487701CB7143C4DDFD2DC426D26E372 / closure 3C2CA3E6E935BF23A061228ED3D9BDA3823E81186057E8C86118FAD5C7CEBF0D）；当时严格入口在无前台会话按凭据门失败关闭且无 completion evidence，故未达到 candidate_executed、e2e_verified 或 promoted。

F8 exact candidate c-0f4c92f237ab-98ebd18146-20260731t022411220z-20da007a 先绑定 identity 0F4C92F237ABD7785C957F3CD135ABF2EFB1EB5D9AB5671B869F39D00970675C、closure 54FBCCBA7C90ACF407B09E38FFB874C13DE3CDFB80CF62D0F8D4E239A42962F0 与 Core EXE SHA-256 86DF1F5DC611037DB3A85FD9BA0D43490394F232D25A4F62B59AA4F2B4B6E4FD 达到 e2e_verified / NOT_DEPLOYED。其后 release source 6f3d50a52413c747b05b74be88d6ee46650f4597 由 tag runtime-build-v2/20260731-agent-runtime-wings-f8-v1、request A9B33601805709DBB5EAE6DAF312C2B7B0B502096FDD3BDCEA9CBE26D8B1299C 与 production policy 26/26 双故障域共识完成 promotion；Core DLL SHA-256 为 0CEA0C64C037090ADAB4E9C38294075E58F1D298615DD447677D0D6725A9271E。无 candidate id 的正式 pure-MCP report tmp/manual-agent-acceptance/formal-f8/agent-runtime-help-20260731T040942Z.json、同目录 transcript/completion 与 residue comparison 共同将相同单屏纵切推进到 standard_entry_verified。该运行未使用 Computer Use、browser/Chrome、privileged legacy HTTP 或任何 input.*；像素只在内存中计算 hash 后清零，没有 PNG，也没有新增残留差量。它不是 Flash pixels/input、物理双屏、完整 Hair/Wings 产品或维护者人工目视验收。

4. 为什么不是现在重写

不划算

  • 需要跨越 Flash 资产、AS2 逻辑、启动链、总线、UI、存档决议等多个边界
  • 回归面覆盖游戏行为、启动行为、工具链、数据兼容性与验证基建
  • 在没有先收敛文档与边界的前提下，重写只会把认知混乱转移到新栈

当前真正该做的

  • 先把多栈现实文档化
  • 先把 canonical doc 和验证矩阵固定下来
  • 先停止旧叙述继续污染入口文档
  • 先让“哪一层负责什么”变得可执行

5. 默认路线图

Phase 1：文档 truth restoration

  • 重写顶层入口与深文档
  • 明确 canonical doc 与职责边界
  • 引入文档基线与巡检脚本

Phase 2：边界收敛

  • 停止旧入口、旧叙述、旧协议继续扩散
  • 把子系统细节压回自己的 source of truth
  • 让验证入口与任务子栈对齐

Phase 3：受控演进

  • 只在收益明确时做 containment 级收敛
  • 默认优先“小边界替换”而不是“全栈替换”
  • 任何新的技术栈引入都必须先说明：它服务哪个既有边界，如何验证，如何被文档接纳

6. 决策默认值

  • 默认保留现有核心多栈架构
  • 默认优先治理认知复杂度，而不是减少语言数量本身
  • 默认把 Node / Rust / PowerShell 视为受控边界件
  • 默认不把“代码层全栈重写”作为后续工程的前提条件

7. SteamOS 安装与更新器长期方向

最后核对代码基线：commit bcab5ac3dbcc32c3665dad1411f6158cd751b5b0（2026-09-07，本节路由与职责核对；实测每日包身份独立记录）。采用公共更新核心 + Windows / SteamOS 平台适配层，版本清单描述依赖，GUI / CLI / Agent 共用安装逻辑；保留每日包，运行时依赖按需下载并复用，不随每个游戏版本复制一套更新器。该方向待实现，不新增当前生产子栈或通用发布门。

Steam Deck 已完成指定历史包的 .NET / WebView2 安装与混合前门运行，Flash 连接仍阻塞；不能据此声称 SteamOS 可玩，也不据此启动游戏主体重写。实测摘录、中文文件名编码线索、WebView2 分发成本与后续阶段统一见 Steam Deck 实机验证与更新器长期路线。