/** 构建入口页 HTML。token 非空时内嵌(跳转 URL 带 #token=,面板读 hash 握手 cookie 后清 URL, * 首次即过鉴权;token 不进 query/服务器日志);形状不符 SHARED_TOKEN_RE 一律按空处理(插值安全:hex 字符集,JSON.stringify 再兜底)。 * preferredPort(根治批 2026-10-08):写入方(server 实例)内嵌自身端口——新实例启动必重写 * 入口页,start() 即写,故 preferred = 最近启动的实例;打开时探测活着优先跳它,死了或未内嵌 * (CLI/registry 层重写,无实例上下文)回退挑最大端口(顺延语义下后占高位的多为新实例)。 * 修复前挑 found[0](第一个活实例):9550 旧实例常驻时新实例永远轮不到(真机验收发现)。 */ export declare function buildPortalHtml(token?: string, preferredPort?: number): string; /** 幂等写入口页到 registry 目录,返回绝对路径(dashboard --web 与 server.start 共用)。 * preferredPort 由 server 侧传入(自身端口);CLI 调用方无实例上下文,缺省不内嵌(回退最大端口)。 */ export declare function ensurePortalPage(dir?: string, preferredPort?: number): string; /** 项目目录入口文件名(中文,用户在项目文件夹一眼可辨;双击即扫描跳转活实例)。 */ export declare const PROJECT_ENTRY_NAME = "\u9762\u677F\u5165\u53E3.html"; /** 幂等写入口页到 Godot 项目目录(2026-09-16 项目入口批)。不内嵌 token。 * 动机:registry 深路径(~/.godot-mcp/web-gui/portal.html)真机反馈难找——入口直接放 * 项目文件夹,资源管理器双击即用。护栏:dir/project.godot 存在才写,非 Godot 目录 * 返回 null 不留文件;内容与 portal.html 同源(同一模板)。 */ export declare function ensureProjectPortalEntry(dir: string, preferredPort?: number): string | null; /** 幂等写入口页到 server 包根目录,内嵌 token(2026-09-16 零门槛授权,用户裁决)。 * 双击即带 ?token= 跳转——首次访问即过鉴权并种 cookie,免 CLI/bat 首授权。 * 开发模式即本仓库根(已 gitignore),npm 模式为 node_modules 内(不入用户 git)。 * token 落盘按 registry 同款收紧:0o600 + Windows icacls(同机多用户防读)。 */ export declare function ensurePackageRootEntry(root: string, token: string, preferredPort?: number): string;