Weftale 源码阅读指南

用户打开外壳后，框架必须确认运行的插件与构建清单一致，才能交出可操作界面。本指南跟随一次启动校验，解释校验、宿主选择、根插件装载和失败清理之间的关系。

阅读路径

读者目标	从这里开始	读完后获得什么
理解一次真实运行	主流程与拒绝边界	能解释输入、交接和结果，知道失败在哪里出现
定位修改入口	按职责找代码	在已声明范围内找到入口、依赖和验证位置
审核解释依据	源码证据与两遍调查	区分直接证据、范围限制和未执行验证
复核文档质量	读者模拟与剩余风险	看懂本指南能回答什么，哪些问题仍需验证
查看同步边界	指南变更记录	找到源码锚点与本轮验证范围

覆盖范围

仅覆盖公开源码中的启动与根插件交接：boot、RPM 形状与哈希、Kernel 入口和撤销机制。其余大插件、战斗、剧本、翻译隔离、资源、编辑器、存档与完整信任交互留给既有文档站。不引用本机设计原文、内部编号、指纹或快照；未提交界面变更不写成已交付。旧文档站内容基线保留，本次不宣称完成全站增量审核或双端验收。

本包采用 Lite 加代码地图：主流程先建立行为模型，地图用于定位，证据页用于审计。源码和脚本是实现事实的依据；旧文档或测试文件的存在不代表本轮实跑通过。

运行与验证入口

Weftale 使用新的应用与网页存储命名空间；旧数据保留在原位置，不自动迁移或删除。启动后没有旧存档或信任记录时，先按安装说明（仓库文件：docs-site/guide/install.md#%E5%BA%94%E7%94%A8%E6%A0%87%E8%AF%86%E4%B8%8E%E5%B7%B2%E6%9C%89%E6%95%B0%E6%8D%AE）确认所运行的构建。

以下命令在仓库根运行；启动命令会占用开发端口，构建命令可能写业务产物，请先阅读根规则。

npm ci
npm run dev
# 维护者验证命令，本轮未运行
npm run typecheck
npm run test:node -- test/unit/boot-deadline.test.ts test/unit/rpm.test.ts
# 双端验收仍需按根规则分别运行 npm run test:web / npm run test:tauri

文档站的启动与构建命令见根 README 的文档入口。文档构建只验证说明页面，不证明业务可用或已部署。

证据状态：除特别标注外，本页基于当前源码已确认。

独立网页构建会把文档目录之外的仓库链接显示为精确文件路径，避免产生失效跳转；原始 Markdown 仍保留可核对的源码链接。站点只发布指南，源码和本机资源不会随文档打包。