用途:ThreadWave Preflight 是 ThreadWave 工作流中唯一的强制预检、安装与恢复契约技能。发布索引名册中的每个操作技能在执行任何 tw 命令前都必须按名称调用它。失败后的分类、方案检索与报告生成由 threadwave-error-support 负责。
主要能力:读取 references/preflight-contract.md 并执行技能更新检查与常规 CLI 预检;支持 receipt-aware CLI 在滚动不活跃时间低于 12 小时时复用就绪/能力凭据,过期或失效时执行完整检查;在首次 CLI 就绪调用前选定并保留平台调用适配器;Windows 打包安装仅对固定就绪模板使用绝对路径 system cmd.exe 与规范 tw.cmd;打包 Windows 就绪后,含动态值的下游命令使用逐参数进程形式(PowerShell/.NET 上为 ProcessStartInfo.ArgumentList);原生 Windows Codex 主机上通过已可用的非沙箱本地进程能力运行固定就绪模板。
依赖方向:twitter 操作技能 -> threadwave-preflight -> threadwave-update;失败工作流 -> threadwave-preflight -> threadwave-error-support。预检期间不得调用操作技能,检查通过后把就绪状态返回发起技能。
安装归属:当所需技能、CLI 或 Chrome 扩展模块缺失或不兼容时,保留原始请求并使用 https://www.threadwave.xyz/cli/setup/agent.md;HTML 版 https://www.threadwave.xyz/cli/setup 与 Markdown 指南等价。范围标签 skills_only、cli_only、skills_and_cli 描述组件范围而非安装顺序,full_setup 保留给初始安装或核心运行时就绪状态缺失/未知。更新后按契约选择一次预检并恢复被保留的请求。用户权限、登录与付款仍归用户所有。
语言:支持英文与简体中文,优先显式用户偏好,其次最新消息,再次会话语言,默认英文;技能名、命令、JSON 键、引用、模式与稳定错误码保持英文,不翻译或规范化确切的帖子/回复内容。
错误支持交接:直接错误、方案检索与报告请求会激活 threadwave-error-support 而不经预检;可能值得报告的工作流失败应停止工作流并仅传递预检契约定义的已净化交接字段。issue-report-only 模式仅作为兼容路由,接受已净化诊断元数据,跳过更新/预检循环,并交给单独的 threadwave-error-support 任务。
返回格式:State、Completed、Versions、Preflight、Problem、Waiting for you、Next、Error support。
限制:greeting-balance 模式是唯一轻量例外,仅运行固定的 tw credits --format json 查询,跳过更新与就绪检查;legacy 完整检查模式下不得调用 --force;预检成功不等于对策略、内容、发帖、回复或其他 X 变更的批准。具体收费、价格与平台支持范围暂未提供。