feat(lua)!: 插件只通过 modelrouter SDK 与内核交互，且不再随内核安装

- 新增唯一公开接口表 `modelrouter`（sdk_version=1.0）：http / secrets /
  kernel / adapters / plugin_dir。成员与内部桥是**同一对象**而非副本 ——
  复制会让凭据保险库分叉（插件写 A、内核读 B）。
- `llmsproxy` 与 `__llmsproxy_*` 降为同对象兼容别名，只为已装插件继续可用。
  仓库内 4 个插件（channels / billing / quota / usage）全部改用
  `modelrouter.*`：此前它们直接依赖内核私有全局，内核无法在不炸插件的前提下
  改实现（重命名、加守卫、换实现都算破坏性变更）。
- 插件不再由网关安装：`SeedBundled()` 变彻底 no-op，`core.New` 不再调用；
  `ReadBundledPlugin` 改为按源文件定位（脱离 cwd），只服务测试与开发工具。
- 桌面端删除 `BUILTIN_PLUGINS` 与 `syncBundledPluginsOnUpgrade`：升级不再
  删除、改名或覆盖用户插件文件。插件是运维资产，不是内核资源。
- `Builtin` 不再靠"源码与仓库示例逐字节相同"推断，插件一律视为外部文件。
- 判据：SDK 存在/版本/形状、别名与内部桥同一张表、适配器 VM 拿不到 SDK、
  经 SDK 真实写读凭据并驱动内核动作、GUI 升级不动插件文件、release 包不含插件。

说明：channels.lua / quota.lua 同时带有此前的渠道与额度改动（含 OpenCode 免费池
监控），与 SDK 改名同处一个文件，无法文件级拆分，故一并纳入。

docs/plugins.md

@@ -15,6 +15,37 @@ ModelRouter 的插件是**单个 `.lua` 文件**，放在 `config.yaml` 的 `plu
 
 ---
 
+## 0. 插件 SDK：唯一的公开接口
+
+插件与网关之间**只有一个**公开接口表 `modelrouter`。它不是 Go 包的导出符号，
+而是内核在启动插件 VM 时注入的 Lua 表；插件通过它调用内核能力，永远不需要
+（也不应该）依赖任何 `__llmsproxy_*` 全局、Go 结构体或内部函数名。
+
+```lua
+modelrouter.sdk_version   -- 字符串，契约版本；SDK 形状变化才递增
+modelrouter.http(spec)    -- 受出站白名单约束的 HTTP 请求
+modelrouter.secrets       -- 本插件专用的凭据保险库（set/get/delete/keys）
+modelrouter.kernel        -- 内核动作面（actions/call，受运维授权约束）
+modelrouter.adapters      -- 安装/更新/删除本插件自己的适配器
+modelrouter.plugin_dir    -- 本插件所在目录（内核给出的 ground truth）
+```
+
+规则：
+
+- **只依赖上表**。内核重命名内部全局、改实现或加守卫时，插件不受影响；
+  这正是把六个散落的全局收进一张表的原因。
+- **能力可能缺失**。未授予的能力（例如出站 HTTP 全禁）在表里是 `nil` 而不是
+  "存在但一调用就报错"，插件应先判断再使用。
+- **`sdk_version` 用来做兼容分支**。增量字段不递增版本；字段删除或调用约定
+  变化才递增。
+- **历史别名**：`llmsproxy`（旧产品名）与 `__llmsproxy_{http,secrets,kernel,
+  adapters,plugin_dir}` 仍然指向同一批对象，只为已安装的插件继续可用而保留，
+  已废弃；新插件使用 `modelrouter.*`。
+- 环境变量：插件目录优先读 `MODELROUTER_PLUGIN_DIR`，回退旧名
+  `MODELROUTER_PLUGIN_DIR`。
+
+---
+
 ## 1. 快速上手
 
 一个最小的插件：
@@ -65,16 +96,14 @@ return plugin   -- 必须返回一个 table
 core.New
   └─ lua.NewVM(adapter_dir).Start()        适配器状态
   └─ lua.NewPlugins(vm, plugin_dir)
-       ├─ SeedBundled()                    仅当目录不存在时写入内置插件（目前是 billing）
-       └─ LoadDir()                        按文件名字典序逐个加载
+`plugin_dir` 中的 Lua 文件由网关逐个加载；安装包不携带业务插件，也不会自动创建或写入插件文件。首次启用时，先把需要的 `.lua` 插件放入该目录，再启动网关。
 ```
 
 **加载失败不影响网关启动。** 一个语法错误的插件会被记录在 `GET /api/plugins`
 的 `error` 字段里，永远不会被调用。这与适配器一致，但理由更强：插件是可选的
 第三方扩展，因为一个 `.lua` 打错字就让网关起不来是错误的取舍。
 
-**目录一旦存在就是权威的。** 与适配器同规则：首启会 seed 内置插件，之后目录里
-的文件说了算，删除或编辑内置插件都是真实生效的操作。
+插件目录由运维独立管理。网关不会 seed、覆盖或删除其中的插件；目录缺失时只会跳过插件加载，不影响网关启动。
 
 ### 2.1 热更新
 
@@ -294,7 +323,7 @@ PUT    /api/plugins/{name}/state     替换状态（admin）
     "loaded": true
   }],
   "hook_errors": { "request_end": { "count": 3, "last_error": "billing: ..." } },
-  "plugin_dir": "/etc/llmsproxy/plugins"
+  "plugin_dir": "/etc/modelrouter/plugins"
 }
 ```
 
@@ -428,7 +457,7 @@ Cookie 鉴权都自然生效，无需暴露额外端口。
 -- 每小时的定时任务：轮换 token 并重写适配器
 function plugin.refresh_token()
   local tok = fetch_new_token()          -- 插件自己的取 token 逻辑
-  local name, err = __llmsproxy_adapters.install(
+  local name, err = modelrouter.adapters.install(
     "myauth",
     'return { name = "myauth", endpoint = "/chat/completions",' ..
     ' headers = { ["Authorization"] = "Bearer ' .. tok .. '" } }'
@@ -439,9 +468,9 @@ end
 
 | 调用 | 参数 | 返回 |
 |---|---|---|
-| `__llmsproxy_adapters.install(name, source)` | 适配器名 + Lua 源码 | `(生效名, nil)` 或 `(nil, err)` |
-| `__llmsproxy_adapters.update(name, source)` | 同上（只限自己装的） | `(true, nil)` 或 `(nil, err)` |
-| `__llmsproxy_adapters.remove(name)` | 适配器名（只限自己装的） | `(true, nil)` 或 `(nil, err)` |
+| `modelrouter.adapters.install(name, source)` | 适配器名 + Lua 源码 | `(生效名, nil)` 或 `(nil, err)` |
+| `modelrouter.adapters.update(name, source)` | 同上（只限自己装的） | `(true, nil)` 或 `(nil, err)` |
+| `modelrouter.adapters.remove(name)` | 适配器名（只限自己装的） | `(true, nil)` 或 `(nil, err)` |
 
 出错时不抛异常，而是返回 `(nil, err)`——与钩子/HTTP 处理器同一套约定，
 一个手滑的插件错误不会带走网关。
@@ -494,14 +523,14 @@ end
 
 ### 6.4 命名
 
-- 全局 `__llmsproxy_plugin` 存放插件返回的 table，**不要占用**
+- 全局 `__llmsproxy_plugin` 是内核存放插件返回 table 的**内部位置**，不属于 SDK，**不要占用**
 - 插件间状态完全隔离，一个插件改不了另一个的全局
 
 ---
 
-## 7. 内置计费插件
+## 7. Billing 插件示例
 
-`plugins/billing.lua`，默认随首启 seed 进来，开箱可用。
+`internal/lua/plugins/billing.lua` 是仓库中的可选插件示例，不随核心安装包分发，也不会在启动时自动安装。需要使用计费功能时，应将该脚本单独复制到配置的 `plugin_dir` 后再重启网关。
 
 ### 7.0 分层：billing 完全在插件里，内核没有任何 billing 代码
 
@@ -704,7 +733,7 @@ cached = cache_hit_tokens                   → 全价 × cache_discount
 插件的 `log(level, msg)` 输出到网关的日志：
 
 ```
-journalctl -u llmsproxy -f | grep -i plugin
+journalctl -u modelrouter -f | grep -i plugin
 ```
 
 ---