写一个插件

/*
 * parser.demo - 最小可用示例：demo://<path>[?name=<文件名>]
 *   demo://share/hello.bin           -> https://example.com/share/hello.bin
 *   demo://share/hello.bin?name=a.txt -> 同一个 URL，保存为 a.txt
 * 其它链接返回 null（不是我的，交给下一个解析器）。
 */

// 1) 声明要用到的能力。没声明的能力在运行时不可用，而且"声明了但宿主没授予"会让插件加载失败。
//    这里只声明真正用到的：crypto 用来算 stableKey。加一条网络查询就再补 'http'。
plugin.requires({ permissions: ['crypto'], abiMajor: 1 });

// 2) 自报身份。id 会被云取用来定位插件，version 是市场更新判据，name 是界面上显示的名字。
plugin.defineMeta({ id: 'parser.demo', name: 'Demo 解析器', version: '1.0.0' });

var SCHEME = 'demo://';
var BASE = 'https://example.com';

/** 链接里的文件名是不可信输入：只留一个裸文件名，丢掉路径与危险字符。 */
function safeName(raw) {
  var last = String(raw || '').split('/').pop().split('\\').pop();
  var cleaned = '';
  for (var i = 0; i < last.length; i++) {
    var c = last.charAt(i);
    var code = last.charCodeAt(i);
    if (code < 32 || code === 127) continue;
    if ('<>:"|?*/\\'.indexOf(c) >= 0) continue;
    cleaned += c;
  }
  cleaned = cleaned.replace(/^[.\s]+/, '').replace(/[.\s]+$/, '').replace(/\.\./g, '_');
  return cleaned.slice(0, 80);   // 80 个字符，不是字节：中文名也能留下
}

plugin.registerParser({
  priority: 300,
  parse: function (input) {
    // 宿主传进来的是一个对象：{ input: '<原始链接>' }
    var raw = String((input && input.input !== undefined) ? input.input : input).trim();
    if (raw.slice(0, SCHEME.length).toLowerCase() !== SCHEME) return null;  // 不是我的链接

    var rest = raw.slice(SCHEME.length);
    var query = '';
    var q = rest.indexOf('?');
    if (q >= 0) { query = rest.slice(q + 1); rest = rest.slice(0, q); }

    var path = rest.replace(/^\/+/, '');
    if (path === '') return null;

    var wanted = '';
    var pairs = query.split('&');
    for (var i = 0; i < pairs.length; i++) {
      var eq = pairs[i].indexOf('=');
      if (eq > 0 && pairs[i].slice(0, eq) === 'name') {
        wanted = pairs[i].slice(eq + 1).replace(/\+/g, ' ');
        try { wanted = decodeURIComponent(wanted); } catch (e) { /* 编码坏了就用原文 */ }
      }
    }

    var url = BASE + '/' + path;
    return [{
      url: url,
      fileName: safeName(wanted) || safeName(path) || 'demo.bin',
      stableKey: 'demo-' + host.crypto.digest('SHA-256', url).hex.slice(0, 16),
      connections: 8,
      tags: { scheme: 'demo', plugin: 'parser.demo' }
    }];
  }
});

plugin.onInit(function () {
  host.log.info('demo 解析器就绪，id=' + plugin.id);
});

Demo 解析器                          粘贴  未验证
运行中 · 注册 1 项 · 占用 1.2 MB              [开关]

// 声明需要什么。permissions 可以是数组，也可以是 "http,crypto" 这样的字符串。
// 声明了宿主没授予的能力 -> 加载失败（比下载到一半才被拒好）。
plugin.requires({ permissions: ['http', 'crypto'], abiMajor: 1 });

// 自报身份。name 显示给人看，id/version 是市场校验用的（见「自报版本」一节）。
plugin.defineMeta({ id: 'parser.demo', name: 'Demo 解析器', version: '1.0.0' });

// 解析器：(链接) -> 请求描述符数组 | 单个描述符 | null
plugin.registerParser({ priority: 300, parse: function (input) { /* ... */ } });

// 提交前钩子：(请求描述符) -> 新描述符 | null/undefined（表示不改）
plugin.registerTaskPreHook({ beforeSubmit: function (payload) { /* payload.request */ } });

// 结束后钩子：只观察，返回值被忽略
plugin.registerTaskPostHook({ afterFinish: function (payload) { /* {request, success, detail} */ } });

// 事件监听：只观察，抛错被吞掉
plugin.onEvent(function (event) { /* {type, taskId, ...} */ });

// 生命周期：各只能注册一次
plugin.onInit(function () { /* 加载时跑，抛错会导致加载失败 */ });
plugin.onDestroy(function () { /* 卸载时跑，这是唯一允许在停止之后进入 JS 的调用 */ });

parse: function (input) {
  var raw = String((input && input.input !== undefined) ? input.input : input);
  ...
}

return null;                      // 不是我的链接，交给下一个解析器
return { url: 'https://…' };      // 单个描述符（引擎会当成只含一条的数组）
return [{ url: 'https://…' }, …]; // 描述符数组

{
  url:        'https://cdn.example/a.bin',  // 必填，http/https，最长 8192 字符
  fileName:   'a.bin',                      // 建议填：文件名，不是路径
  headers:    { 'Referer': 'https://…' },   // 可选，字符串表
  knownSize:  12345678,                     // 可选，已知的文件大小
  connections: 8,                           // 可选，1..256
  stableKey:  'demo-abc123',                // 可选，去重键，最长 200 字符
  tags:       { scheme: 'demo' }            // 可选，字符串表，给后续钩子/日志看
}

return [{ url: url, fileName: 'a.bin' }];        // 对：宿主把它放进插件的 downloads/ 沙箱
return [{ url: url, destination: 'a.bin' }];     // 也对：等价于 fileName
return [{ url: url, destination: '/sdcard/a.bin' }];  // 被拒：含分隔符/绝对路径

plugin.defineMeta({ ... });
// 忘了 plugin.requires
var sig = host.crypto.hmac('HmacSHA256', key, data);  // 抛 permission 错

plugin.requires({ permissions: ['http', 'storage'] });   // 加载会失败

return { url: url, fileName: name };     // 引擎接受：会当成单条
return { files: [{ url: url }] };        // 不行：这不是描述符，缺 url -> validation 失败