mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +00:00
- 受管插件静态事实表(v2ray-plugin v1.3.2,来源/许可证/版本/重签)与 BundleManagedPluginProvider:受管集内且 bundle 内可执行文件在位才返回 绝对路径;与 Vendor 清单双向锚定(D6/D10) - 服务器编辑器插件区:受管选择器(无 + 受管列表),选中受管项才显示 供应链事实与参数输入;集外引用显式「本版本未提供」并原样保留 - updateServer 插件落盘语义:「无」整体清除、参数写删钥匙串、集外不漂移 - wrapper 监听建立判定:3 秒未建立本地监听记 error 日志,监管继续(D10) - 诊断导出新增受管插件清单(名称/版本/提供状态,无参数) - 功能级兼容实测记录(docs/research/plugin-compat-record.md)与端到端 冒烟:契约插件路径 → sslocal 拉起 → v2ray-plugin 进程建立 → 停止链
71 lines
3.2 KiB
Swift
71 lines
3.2 KiB
Swift
import Foundation
|
||
|
||
/// 受管插件提供缝(spec #21 D10,CONTEXT.md「Managed plugin」):给定服务器
|
||
/// 持有的插件程序引用,返回本版本提供的 bundle 内绝对路径;返回 nil 即
|
||
/// 「本版本未提供」,该引用使叶子成为无效激活候选(激活点名拒绝)。
|
||
protocol ManagedPluginProviding {
|
||
func executablePath(forProgram program: String) -> String?
|
||
}
|
||
|
||
/// 受管插件静态事实(#38):来源项目、许可证、固定版本与重签标识,供编辑器
|
||
/// 插件区与诊断导出展示。事实只随发版变更(D6「升级前重做静态清单」):新增
|
||
/// 或升级插件须同步 `Vendor/<name>/manifest.json` 与锚点测试
|
||
/// `ManagedPluginCatalogTests`,两处漂移即构建期失败。
|
||
struct ManagedPluginInfo: Equatable, Sendable {
|
||
/// SIP003 程序名,同时是 bundle 内二进制名与目录里的引用键。
|
||
let program: String
|
||
/// 来源项目(GitHub owner/repo)。
|
||
let project: String
|
||
let projectURL: String
|
||
/// 固定版本 tag(禁止 latest 漂移)。
|
||
let release: String
|
||
let license: String
|
||
/// 构建期 Developer ID 重签的 identifier(`<bundle-id>.plugin.<name>`)。
|
||
let signIdentifier: String
|
||
}
|
||
|
||
/// 本版本受管集(D10):首版仅 v2ray-plugin v1.3.2;shadow-tls、Cloak 暂缓,
|
||
/// simple-obfs、kcptun、GoQuiet、simple-tls 明确不支持(「不支持某插件」是
|
||
/// 显式产品状态,不是可扩展的用户自备通道)。
|
||
enum ManagedPluginCatalog {
|
||
static let plugins: [ManagedPluginInfo] = [
|
||
ManagedPluginInfo(
|
||
program: "v2ray-plugin",
|
||
project: "shadowsocks/v2ray-plugin",
|
||
projectURL: "https://github.com/shadowsocks/v2ray-plugin",
|
||
release: "v1.3.2",
|
||
license: "MIT",
|
||
signIdentifier: "com.qiuyuzhou.ShadowsocksX-NG.plugin.v2ray-plugin")
|
||
]
|
||
|
||
static func info(forProgram program: String) -> ManagedPluginInfo? {
|
||
plugins.first { $0.program == program }
|
||
}
|
||
}
|
||
|
||
/// 生产实现:受管集内且 bundle 内可执行文件在位才返回绝对路径。D10——GUI
|
||
/// 仅在生成配置时检查可执行文件存在,运行时不逐次哈希复验(bundle 签名 +
|
||
/// 公证即信任边界);受管集外引用一律视为「本版本未提供」,路径只从静态表
|
||
/// 派生,不拼接任何用户输入。
|
||
struct BundleManagedPluginProvider: ManagedPluginProviding {
|
||
/// 插件宿主 bundle 根;生产为应用 bundle,测试注入临时目录。
|
||
var bundleURL: URL = Bundle.main.bundleURL
|
||
var fileManager: FileManager = .default
|
||
|
||
func executablePath(forProgram program: String) -> String? {
|
||
guard let info = ManagedPluginCatalog.info(forProgram: program) else { return nil }
|
||
let url =
|
||
bundleURL
|
||
.appendingPathComponent("Contents/Helpers/Plugins")
|
||
.appendingPathComponent(info.program)
|
||
guard fileManager.isExecutableFile(atPath: url.path) else { return nil }
|
||
return url.path
|
||
}
|
||
}
|
||
|
||
/// 显式「本版本什么都不提供」的实现(测试与不涉插件的场景注入用):任何插件
|
||
/// 引用都是无效激活候选(点名原因),不是静默失败。
|
||
struct NoManagedPluginProvider: ManagedPluginProviding {
|
||
func executablePath(forProgram program: String) -> String? { nil }
|
||
}
|