开发调试与发布

从创建到上架的完整链路：创建/导入 → IDE 编辑 → 编译同步 → 目标页验证 → 提交审核 → 上架。

开发与调试

1. 创建或导入

   「创建新项目」提供 Plain JavaScript 和 Vue 3 + TypeScript 模板，新建的项目默认未启用；「从本地导入」支持文件夹或多文件，默认选文件名为 main / index / entry 的脚本作入口（与元信息头无关，找不到时取第一个脚本），可在导入对话框里改选。导入后请在 IDE 的入口下拉框或终端 entryFile status 确认入口。所有应用都走同一条编译流程。

   元信息头（@name / @match / @require / @intercept 等）只从入口文件读取，切换入口后请把头部一并迁到新入口。非入口文件头部的 @require 只在终端直接 run <该文件> 时生效，编辑器会在该行给出 Warning；插件用到的内置库须在入口声明（见元信息）。

2. IDE 编辑

   开发中的应用可直接打开 IDE：编辑、保存、编译一体化，还内置 AI 编程助手与终端。

3. 编译与同步

   保存（Ctrl+S）只把源码写入本地存储，不编译。点击顶部「编译」（有未保存改动时会自动先保存）才会生成编译产物，并同步注册到 chrome.userScripts；从未编译过的新草稿不会被注册。终端 app enable 作用于当前项目时，也会先保存并在产物过期时自动重新编译。

4. 页面验证

   在 IDE 终端执行 liveDebug on，系统会编译并注入当前匹配页；之后源码及 @/、~/ 别名依赖的每次编辑（无需保存）都会在停止输入片刻后自动软热重载。liveDebug 编译的是编辑器里的当前内容，只作用于调试页，不更新已注册的产物，调好后仍需点「编译」。重复执行 liveDebug on 可在当前 document 内强制重新编译注入；执行 liveDebug reload 则会整页刷新目标页面后干净重注入（上一代所有残留一并销毁）。liveDebug status 的 injectionHealthy: true 表示当前目标 document 已成功注入。

启用应用：即时生效

从任意入口启用应用（应用管理页 / 对话头部开关 / 「本页应用」弹层 / 终端 app enable）都会注册正式编译产物，并由扩展后台把产物即时热注入到所有已打开且命中匹配规则的页面（Chrome 135+）——无需刷新即可生效；新打开或刷新后的页面走正常注册注入，两者由运行时防重守卫保证不会重复执行。若该应用正处于 liveDebug 状态，启用会先自动停止实时调试（两者互斥），调试页在拆除干净后无缝切换为正式实例；若调试实例没有登记任何清理逻辑，为避免双实例并存，该页不热注入并提示刷新后生效。

• 已打开页面上的两条已知限制：@run-at document_start / document_end 的时机语义无法复现——代码在注入那一刻的已加载文档上执行；LFRuntime.network 只能拦截注入之后发起的请求，页面更早的请求无法回放。刷新页面即可获得与注册注入完全一致的语义
• 停用方向仍需刷新才能在已打开页面生效（正式实例不登记清理逻辑，没有卸载路径）；对话模式下停用会按设置自动刷新贴附页面

云端源码

「保存源码至云端」把当前源码快照上传到服务端；换设备或误删后可用「同步云端源码」恢复。应用列表的「源码云端保存 / 和云端源码差异」两列展示当前状态。

提交审核与上架

1. 提交审核

   在应用列表点「提交审核」，填写轮播图（最多 5MB/张）、定价方案（免费 / 按月 / 按年）、试用方案和版本更新说明。

2. 等待审核

   提交后应用出现在「审核中」Tab；审核员通过后自动上架。被驳回时驳回原因会显示在列表里，修改后可重新提交。

3. 上架后

   应用出现在应用商城，其他用户可以查看详情、安装、评分。你可以在「销售数据」里查看安装量、收入与订单。

文件权限

如果应用需要通过 LFHttp.client.fs 读写用户本地文件（IDE 工作区之外），在应用列表的「文件权限」里配置授权范围，用户安装时会看到相应提示。