C# 本机运行时 API

适用：C# Bridge 1.4.9。此协议是 XFEWarframe 桌面端与 C# 运行时的契约，不声明兼容原版 OpenWF 的所有 6155 请求。功能边界见实现进度。

发现与连接

组件在游戏进程中监听 127.0.0.1，首选端口 6155，冲突时使用空闲端口。实例信息写到当前用户 %LOCALAPPDATA%/XFEWarframe/Runtime/<游戏目录散列>/<实例 ID>.json。记录含 PID、启动时间、规范化游戏目录、端点及 256 位随机令牌。桌面端匹配游戏目录并校验进程仍存活、启动时间及返回的实例身份。

所有请求需要 Authorization: Bearer <本次实例令牌>，令牌不会出现在状态和日志响应里。HTTP Host 必须匹配实例端点；带 Origin、重复头或分块编码的请求被拒绝。不接受远程主机，也不自动跟随重定向。

路由

方法	路径	行为
GET	`/ping`、`/status`、`/runtime/v1/status`	实例、PID、版本、游戏版本、目标服务器、启动时间、内存、设置和能力列表
GET	`/runtime/v1/logs?after=<游标>`	返回 `cursor`、`reset` 与日志数组；缓冲溢出或清空后 `reset=true`
POST	`/runtime/v1/settings`	设置 `disableOverlay` 和 `clientHttpLogging`；未知键或非布尔值被拒绝
POST	`/runtime/v1/save`	原子保存当前设置到游戏副本 `XFEWarframe/runtime-settings.json`，保留未知字段并创建 `.bak`
POST	`/runtime/v1/logs/clear`	仅清空当前内存日志，不删除磁盘日志
GET	`/runtime/v1/visuals/cards`	原生卡面缓存状态：可用性、待绘制/写入数量、累计完成/失败数量、语言、版本、来源、`reason` 与说明；绑定不可用时仍返回状态
POST	`/runtime/v1/visuals/cards`	请求缓存 `language` 对应的 `cards` 数组，每项含 `type` 与 `fingerprint`；一次 1–200 项，总队列最多 4096 项
POST	`/runtime/v1/visuals/cancel`	清空待绘制卡面并取消当前帧；已进入原子写入的 PNG 可完成，临时电影在下一次引擎更新时关闭

先应用设置，再显式调用保存才会持久化。关闭覆盖层不更改游戏账号或存档。clientHttpLogging 记录本机运行时控制 API 的方法与路径，不记录查询参数、请求正文或令牌；已有游戏网络兼容诊断独立保留。

并发连接最多 8 个，每次请求限时 4 秒，请求头上限 8 KB、请求体上限 64 KB；客户端响应读取上限 1 MB。日志限制条数、单条长度与总字符数，桌面列表最多展示 200 条。

original_mod_cards 能力需要本次启动建立 DirectX 11 绑定。其 available 与 reason 随绑定状态变化，不以接口委托是否存在代替可用性。reason 包括 compatible-binding-required、direct3d11-required、graphics-binding-failed、native-render-failed；正常状态为 automatic-native-render。单张失败记录为 card-capture-failed，不阻止其他卡片绘制；再次提交该资源与指纹可重试。completed 为本次启动成功写入数，failed 为失败的不同卡面数。绑定不可用的 POST 返回 HTTP 409 与对应消息，GET 诊断及取消仍可调用，仍需鉴权。

缓存请求只选择资源与 JSON 对象指纹（最多 16,384 字符），不接收任意脚本、文件路径或客户端图像。请求与渲染异步分离；组件使用原版卡片模块在自己拥有的临时电影中每帧绘制最多 20 张卡，共用两次黑/白背景 GPU 读取并行生成透明 PNG。无需打开游戏 MOD 页面，不依赖开启游戏测试适配器。请求组包同时遵守 200 项及 64 KB 限制，采用 NativeCardCacheRequest.Batches 可以正确处理长紫卡数据。渲染会临时占用游戏画面，完成、取消或出错后返回原画面。版本限制与验证范围见配装说明。

请求可选 refreshExisting=true，重新生成已有卡面。旧 PNG 保留到新图片通过验证后才原子替换；刷新失败不会清空已有缓存。默认只排队未缓存的卡面。

pet_fetch_300m 能力表示当前版本已绑定「吸回·超域」的原生宠物拾取触发器。它沿用经过审计的 2026.08.19.11.06 引擎线程绑定，与测试控制开关无关。实际效果只在当前兽型宠物配置装备该 MOD 时启用；组件逐帧识别已装备 UID 和专用指纹，卸下或切换后恢复原半径。ExperimentalAbilityRuntime.AbilitySnapshot 中的 fetchOverdrive 返回 equipped、目标 radius、受管理的 triggers 数量和状态 message；这是诊断信息，不是拾取结算成功的证明。

脚本、镜头、传送、元数据和热修复能力当前为不可用，缺少的命令返回错误。应用不能将 status/保存设置成功当作上述引擎能力已实现。