@shiqianjiang/ceru-plugin-cli 0.2.5 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.md +6 -0
  2. package/assets/core-contracts.js +1 -1
  3. package/assets/index.html +94 -94
  4. package/assets/playground.js +64 -12
  5. package/assets/sandbox.js +21 -21
  6. package/dist/dev.js +7 -13
  7. package/dist/storage.d.ts +12 -0
  8. package/dist/storage.js +65 -0
  9. package/package.json +3 -3
  10. package/schemas/config.schema.json +209 -0
  11. package/templates/connected-library/js/package.json +2 -2
  12. package/templates/connected-library/ts/package.json +2 -2
  13. package/templates/guest-adapter/js/package.json +2 -2
  14. package/templates/guest-adapter/ts/package.json +2 -2
  15. package/templates/importer/js/package.json +2 -2
  16. package/templates/importer/ts/package.json +2 -2
  17. package/templates/react/js/package.json +2 -2
  18. package/templates/react/ts/package.json +2 -2
  19. package/templates/snapshot.json +1 -1
  20. package/templates/source/js/package.json +2 -2
  21. package/templates/source/ts/package.json +2 -2
  22. package/templates/vue/js/package.json +2 -2
  23. package/templates/vue/ts/package.json +2 -2
  24. package/templates/vue-tsx/js/package.json +2 -2
  25. package/templates/vue-tsx/ts/package.json +2 -2
  26. package/templates/web-dist/js/package.json +2 -2
  27. package/templates/web-dist/ts/package.json +2 -2
  28. package/templates/web-surface/js/ceru.plugin.json +31 -2
  29. package/templates/web-surface/js/package.json +2 -2
  30. package/templates/web-surface/js/src/index.js +7 -0
  31. package/templates/web-surface/ts/ceru.plugin.json +31 -2
  32. package/templates/web-surface/ts/package.json +2 -2
  33. package/templates/web-surface/ts/src/index.ts +7 -0
package/README.md CHANGED
@@ -12,6 +12,12 @@ npm run build
12
12
 
13
13
  Dev 启动独立 Electron 工作台,实际执行插件并支持 TS 源码断点、日志、搜索/解析、页面预览、权限模拟和宿主资源。VS Code 配置由脚手架生成。
14
14
 
15
+ 0.3.1 的播放解析结果可返回 `requestHeaders`。适用于要求 `Referer`、`Origin`、`User-Agent` 或认证头的临时媒体 URL;这些值由 Host 按完整 URL 注入,不应写入页面状态、日志或分享数据。
16
+
17
+ 0.3.0 的 `web-surface` 模板包含通用页面生命周期示例。`modules.surfaces[]` 可声明 `title`、`presentation: { kind: 'drawer', placement: 'right', size: 480 }` 和 `lifecycle: { openAction: 'page.open', closeAction: 'page.close' }`。生命周期动作须在 `contributes.commands` 声明;打开完成后执行 openAction,关闭时取消页面请求并执行 closeAction。扫码、轮询、账号表单和校验全部写在插件工程中,Vue/React 也打包进最终单文件。
18
+
19
+ 预览的“关闭页面”可验证清理逻辑。`ctx.ui.setState(id, state)` 只发送给对应页面;`ctx.subscribe` 接收最新状态。开发存储保存在工程 `.ceru-dev/storage/`,重启保留且不打入产物;修改 `manifest.id` 会使用独立存储。生产宿主提供自己的隔离存储和通用播放器服务,开发无需启动澜音。
20
+
15
21
  ```text
16
22
  ceru-plugin list-templates
17
23
  ceru-plugin build --out dist/plugin.js
@@ -1 +1 @@
1
- var i=r=>!!r&&typeof r=="object"&&!Array.isArray(r),s=(r,e=4096)=>typeof r=="string"&&r.length<=e,o=r=>Number.isFinite(r)&&Number(r)>=0;function l(r){if(!i(r)||!["pluginId","providerId","kind","id"].every(e=>s(r[e],2048)&&r[e].length>0))throw new Error("Invalid resource reference");if(r.data!==void 0){if(!i(r.data))throw new Error("Invalid resource private data");let e;try{e=JSON.stringify(r.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(e).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function c(r){if(!i(r)||!Array.isArray(r.items)||r.items.length>1e4)throw new Error("Invalid content page");if(r.nextCursor!=null&&(!s(r.nextCursor,2048)||!r.nextCursor.length))throw new Error("Invalid pagination cursor");for(let e of r.items){if(!i(e)||!s(e.title)||!Array.isArray(e.capabilities)||!e.capabilities.every(t=>s(t,128)))throw new Error("Invalid content item");if(l(e.ref),e.ref.kind==="track"){if(!i(e.metadata)||!Array.isArray(e.metadata.artists)||!e.metadata.artists.every(t=>s(t)))throw new Error("Track metadata must contain artists");if(e.metadata.durationMs!==void 0&&!o(e.metadata.durationMs))throw new Error("Invalid track duration")}if(e.ref.kind==="playlist"&&e.playlist!==void 0){if(!i(e.playlist))throw new Error("Invalid playlist metadata");if(e.playlist.trackCount!==void 0&&(!Number.isInteger(e.playlist.trackCount)||e.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(e.ref.kind==="chart"&&e.chart!==void 0&&!i(e.chart))throw new Error("Invalid chart metadata")}}function p(r){if(!i(r)||typeof r.ok!="boolean")throw new Error("Invalid resolve result");if(r.ok){if(!s(r.url,8192))throw new Error("Invalid playback URL");let e=new URL(r.url);if(!["http:","https:"].includes(e.protocol))throw new Error("Invalid playback protocol");if(r.expiresAt!==void 0&&!o(r.expiresAt))throw new Error("Invalid playback expiry");return}if(!i(r.error)||!s(r.error.code,128)||!s(r.error.message,65536))throw new Error("Invalid music fault")}function m(r){if(!i(r)||r.version!==1||!Number.isFinite(r.offsetMs)||!Array.isArray(r.lines)||r.lines.length>2e4)throw new Error("Invalid lyrics document");l(r.track);let e=-1;for(let t of r.lines){if(!i(t)||!o(t.startTimeMs)||t.startTimeMs<e||!s(t.text,65536))throw new Error("Invalid lyric line");if(e=t.startTimeMs,t.endTimeMs!==void 0&&(!o(t.endTimeMs)||t.endTimeMs<t.startTimeMs))throw new Error("Invalid lyric line end");for(let a of["translation","romanization"])if(t[a]!==void 0&&!s(t[a],65536))throw new Error("Invalid lyric translation");if(t.words!==void 0){if(!Array.isArray(t.words)||t.words.length>1e4)throw new Error("Invalid lyric words");let a=t.startTimeMs;for(let n of t.words){if(!i(n)||!o(n.startTimeMs)||!o(n.endTimeMs)||n.endTimeMs<n.startTimeMs||n.startTimeMs<a||!s(n.text,65536))throw new Error("Invalid lyric word");a=n.startTimeMs}}}if(r.plainText!==void 0&&!s(r.plainText,1048576))throw new Error("Invalid plain lyrics")}var d={network:{title:"\u8BBF\u95EE\u516C\u7F51\u670D\u52A1",permissions:["network.request","network.socket"]},localNetwork:{title:"\u8BBF\u95EE\u5C40\u57DF\u7F51\u4E0E\u672C\u673A\u670D\u52A1",permissions:["network.private","network.discovery"]},account:{title:"\u8BFB\u53D6\u767B\u5F55\u72B6\u6001\u4E0E\u57FA\u672C\u8D26\u53F7\u8D44\u6599",permissions:["account.profile"]},libraryRead:{title:"\u8BFB\u53D6\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.read"]},libraryManage:{title:"\u521B\u5EFA\u548C\u4FEE\u6539\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.write"]},libraryDelete:{title:"\u5220\u9664\u6B4C\u5355\u4E0E\u6B4C\u66F2\u8BB0\u5F55",permissions:["library.delete"]},playbackRead:{title:"\u8BFB\u53D6\u64AD\u653E\u72B6\u6001\u548C\u961F\u5217",permissions:["player.read"]},playbackControl:{title:"\u63A7\u5236\u64AD\u653E\u548C\u64AD\u653E\u961F\u5217",permissions:["player.control","playback.fallback.hold"]},downloads:{title:"\u7BA1\u7406\u4E0B\u8F7D\u4EFB\u52A1",permissions:["downloads.create","downloads.manage"]},files:{title:"\u4F7F\u7528\u7528\u6237\u9009\u5B9A\u7684\u6587\u4EF6",permissions:["files.read","files.write"]},localMusic:{title:"\u7D22\u5F15\u672C\u5730\u97F3\u4E50\u548C\u7F16\u8F91\u6807\u7B7E",permissions:["localMusic.read","localMusic.write"]},clipboardRead:{title:"\u8BFB\u53D6\u526A\u8D34\u677F",permissions:["clipboard.read"]},clipboardWrite:{title:"\u5199\u5165\u526A\u8D34\u677F",permissions:["clipboard.write"]},notifications:{title:"\u53D1\u9001\u7CFB\u7EDF\u901A\u77E5",permissions:["notifications.system"]},external:{title:"\u5728\u7CFB\u7EDF\u6D4F\u89C8\u5668\u6253\u5F00\u94FE\u63A5",permissions:["external.open"]},settingsRead:{title:"\u8BFB\u53D6\u8F6F\u4EF6\u504F\u597D",permissions:["settings.read"]},settingsWrite:{title:"\u4FEE\u6539\u8F6F\u4EF6\u504F\u597D",permissions:["settings.write"]},window:{title:"\u63A7\u5236\u8F6F\u4EF6\u7A97\u53E3",permissions:["window.control"]},hotkeys:{title:"\u6CE8\u518C\u5168\u5C40\u5FEB\u6377\u952E",permissions:["hotkeys.register"]},sharing:{title:"\u53D1\u5E03\u548C\u64A4\u9500\u5206\u4EAB",permissions:["sharing.publish","sharing.revoke"]},roomsRead:{title:"\u8BFB\u53D6\u4E00\u8D77\u542C\u623F\u95F4\u72B6\u6001",permissions:["rooms.read"]},roomsControl:{title:"\u52A0\u5165\u623F\u95F4\u548C\u63A7\u5236\u4E00\u8D77\u542C",permissions:["rooms.control"]},ai:{title:"\u4F7F\u7528\u8F6F\u4EF6 AI \u670D\u52A1",permissions:["ai.use"]},devices:{title:"\u63A7\u5236\u97F3\u9891\u8BBE\u5907\u4E0E\u6295\u653E",permissions:["devices.control"]},uiAppearance:{title:"\u4FEE\u6539\u8F6F\u4EF6\u5168\u5C40\u5916\u89C2",permissions:["ui.styles.global"]},background:{title:"\u540E\u53F0\u4EFB\u52A1",permissions:["background.run"]},credentials:{title:"\u4F7F\u7528\u672C\u63D2\u4EF6\u5DF2\u4FDD\u5B58\u7684\u8FDE\u63A5\u51ED\u636E",permissions:["credentials.use"]},credentialExport:{title:"\u8BFB\u53D6\u672C\u63D2\u4EF6\u8FDE\u63A5\u51ED\u636E\u660E\u6587",permissions:["credentials.read"]},guestPlugins:{title:"\u5B89\u88C5\u548C\u8FD0\u884C\u517C\u5BB9\u5B50\u63D2\u4EF6",permissions:["guests.manage","guests.run"]},services:{title:"\u8C03\u7528\u5176\u4ED6\u63D2\u4EF6\u63D0\u4F9B\u7684\u670D\u52A1",permissions:["services.consume"]}};function u(r){return Object.keys(d).find(e=>d[e].permissions.includes(r))}export{d as PERMISSION_GROUPS,c as assertContentPage,m as assertLyricsDocument,p as assertResolveResult,l as assertResourceRef,u as permissionGroup};
1
+ var n=e=>!!e&&typeof e=="object"&&!Array.isArray(e),o=(e,r=4096)=>typeof e=="string"&&e.length<=r,a=e=>Number.isFinite(e)&&Number(e)>=0;function c(e){if(!n(e)||!["pluginId","providerId","kind","id"].every(r=>o(e[r],2048)&&e[r].length>0))throw new Error("Invalid resource reference");if(e.data!==void 0){if(!n(e.data))throw new Error("Invalid resource private data");let r;try{r=JSON.stringify(e.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(r).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function p(e){if(!n(e)||!Array.isArray(e.items)||e.items.length>1e4)throw new Error("Invalid content page");if(e.nextCursor!=null&&(!o(e.nextCursor,2048)||!e.nextCursor.length))throw new Error("Invalid pagination cursor");for(let r of e.items){if(!n(r)||!o(r.title)||!Array.isArray(r.capabilities)||!r.capabilities.every(t=>o(t,128)))throw new Error("Invalid content item");if(c(r.ref),r.ref.kind==="track"){if(!n(r.metadata)||!Array.isArray(r.metadata.artists)||!r.metadata.artists.every(t=>o(t)))throw new Error("Track metadata must contain artists");if(r.metadata.durationMs!==void 0&&!a(r.metadata.durationMs))throw new Error("Invalid track duration")}if(r.ref.kind==="playlist"&&r.playlist!==void 0){if(!n(r.playlist))throw new Error("Invalid playlist metadata");if(r.playlist.trackCount!==void 0&&(!Number.isInteger(r.playlist.trackCount)||r.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(r.ref.kind==="chart"&&r.chart!==void 0&&!n(r.chart))throw new Error("Invalid chart metadata")}}function f(e){if(!n(e)||typeof e.ok!="boolean")throw new Error("Invalid resolve result");if(e.ok){if(!o(e.url,8192))throw new Error("Invalid playback URL");let r=new URL(e.url);if(!["http:","https:"].includes(r.protocol))throw new Error("Invalid playback protocol");if(e.expiresAt!==void 0&&!a(e.expiresAt))throw new Error("Invalid playback expiry");if(e.requestHeaders!==void 0){if(!n(e.requestHeaders)||Object.keys(e.requestHeaders).length>32)throw new Error("Invalid playback request headers");for(let[t,s]of Object.entries(e.requestHeaders))if(!/^[!#$%&'*+.^_`|~0-9A-Za-z-]{1,128}$/.test(t)||/^(host|connection|content-length|transfer-encoding|proxy-.*|upgrade)$/i.test(t)||typeof s!="string"||s.length>8192||/[\r\n]/.test(s))throw new Error("Invalid playback request header")}return}if(!n(e.error)||!o(e.error.code,128)||!o(e.error.message,65536))throw new Error("Invalid music fault")}function m(e){if(!n(e)||e.format!=="crlyric"||e.version!==1||!Number.isFinite(e.offsetMs)||!Array.isArray(e.lines)||e.lines.length>2e4)throw new Error("Invalid lyrics document");if(c(e.track),e.track.kind!=="track")throw new Error("Lyrics must reference a track");let r=-1;for(let t of e.lines){if(!n(t)||!a(t.startTimeMs)||t.startTimeMs<r||!o(t.text,65536))throw new Error("Invalid lyric line");if(r=t.startTimeMs,t.endTimeMs!==void 0&&(!a(t.endTimeMs)||t.endTimeMs<t.startTimeMs))throw new Error("Invalid lyric line end");for(let s of["translation","romanization"])if(t[s]!==void 0&&!o(t[s],65536))throw new Error("Invalid lyric translation");if(t.words!==void 0){if(!Array.isArray(t.words)||t.words.length>1e4)throw new Error("Invalid lyric words");let s=t.startTimeMs;for(let i of t.words){if(!n(i)||!a(i.startTimeMs)||!a(i.endTimeMs)||i.endTimeMs<i.startTimeMs||i.startTimeMs<s||!o(i.text,65536))throw new Error("Invalid lyric word");s=i.startTimeMs}}}if(e.plainText!==void 0&&!o(e.plainText,1048576))throw new Error("Invalid plain lyrics")}var l={network:{title:"\u8BBF\u95EE\u516C\u7F51\u670D\u52A1",permissions:["network.request","network.socket"]},localNetwork:{title:"\u8BBF\u95EE\u5C40\u57DF\u7F51\u4E0E\u672C\u673A\u670D\u52A1",permissions:["network.private","network.discovery"]},account:{title:"\u8BFB\u53D6\u767B\u5F55\u72B6\u6001\u4E0E\u57FA\u672C\u8D26\u53F7\u8D44\u6599",permissions:["account.profile"]},libraryRead:{title:"\u8BFB\u53D6\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.read"]},libraryManage:{title:"\u521B\u5EFA\u548C\u4FEE\u6539\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.write"]},libraryDelete:{title:"\u5220\u9664\u6B4C\u5355\u4E0E\u6B4C\u66F2\u8BB0\u5F55",permissions:["library.delete"]},playbackRead:{title:"\u8BFB\u53D6\u64AD\u653E\u72B6\u6001\u548C\u961F\u5217",permissions:["player.read"]},playbackControl:{title:"\u63A7\u5236\u64AD\u653E\u548C\u64AD\u653E\u961F\u5217",permissions:["player.control","playback.fallback.hold"]},downloads:{title:"\u7BA1\u7406\u4E0B\u8F7D\u4EFB\u52A1",permissions:["downloads.create","downloads.manage"]},files:{title:"\u4F7F\u7528\u7528\u6237\u9009\u5B9A\u7684\u6587\u4EF6",permissions:["files.read","files.write"]},localMusic:{title:"\u7D22\u5F15\u672C\u5730\u97F3\u4E50\u548C\u7F16\u8F91\u6807\u7B7E",permissions:["localMusic.read","localMusic.write"]},clipboardRead:{title:"\u8BFB\u53D6\u526A\u8D34\u677F",permissions:["clipboard.read"]},clipboardWrite:{title:"\u5199\u5165\u526A\u8D34\u677F",permissions:["clipboard.write"]},notifications:{title:"\u53D1\u9001\u7CFB\u7EDF\u901A\u77E5",permissions:["notifications.system"]},external:{title:"\u5728\u7CFB\u7EDF\u6D4F\u89C8\u5668\u6253\u5F00\u94FE\u63A5",permissions:["external.open"]},settingsRead:{title:"\u8BFB\u53D6\u8F6F\u4EF6\u504F\u597D",permissions:["settings.read"]},settingsWrite:{title:"\u4FEE\u6539\u8F6F\u4EF6\u504F\u597D",permissions:["settings.write"]},window:{title:"\u63A7\u5236\u8F6F\u4EF6\u7A97\u53E3",permissions:["window.control"]},hotkeys:{title:"\u6CE8\u518C\u5168\u5C40\u5FEB\u6377\u952E",permissions:["hotkeys.register"]},sharing:{title:"\u53D1\u5E03\u548C\u64A4\u9500\u5206\u4EAB",permissions:["sharing.publish","sharing.revoke"]},roomsRead:{title:"\u8BFB\u53D6\u4E00\u8D77\u542C\u623F\u95F4\u72B6\u6001",permissions:["rooms.read"]},roomsControl:{title:"\u52A0\u5165\u623F\u95F4\u548C\u63A7\u5236\u4E00\u8D77\u542C",permissions:["rooms.control"]},ai:{title:"\u4F7F\u7528\u8F6F\u4EF6 AI \u670D\u52A1",permissions:["ai.use"]},devices:{title:"\u63A7\u5236\u97F3\u9891\u8BBE\u5907\u4E0E\u6295\u653E",permissions:["devices.control"]},uiAppearance:{title:"\u4FEE\u6539\u8F6F\u4EF6\u5168\u5C40\u5916\u89C2",permissions:["ui.styles.global"]},background:{title:"\u540E\u53F0\u4EFB\u52A1",permissions:["background.run"]},credentials:{title:"\u4F7F\u7528\u672C\u63D2\u4EF6\u5DF2\u4FDD\u5B58\u7684\u8FDE\u63A5\u51ED\u636E",permissions:["credentials.use"]},credentialExport:{title:"\u8BFB\u53D6\u672C\u63D2\u4EF6\u8FDE\u63A5\u51ED\u636E\u660E\u6587",permissions:["credentials.read"]},guestPlugins:{title:"\u5B89\u88C5\u548C\u8FD0\u884C\u517C\u5BB9\u5B50\u63D2\u4EF6",permissions:["guests.manage","guests.run"]},services:{title:"\u8C03\u7528\u5176\u4ED6\u63D2\u4EF6\u63D0\u4F9B\u7684\u670D\u52A1",permissions:["services.consume"]}};function w(e){return Object.keys(l).find(r=>l[r].permissions.includes(e))}var d=class{constructor(r,t,s){this.surface=r;this.dispatch=s;this.actions=new Set(t.contributes?.commands?.map(i=>i.action));for(let i of Object.values(r.lifecycle??{}))if(!this.actions.has(i))throw new Error("Unknown surface lifecycle action: "+i)}surface;dispatch;closed=!1;opened=!1;opening;closing;pending=new Set;actions;open(){return this.closed?Promise.reject(new Error("Surface is closed")):(this.opened||(this.opened=!0,this.opening=this.surface.lifecycle?.openAction?this.invoke(this.surface.lifecycle.openAction,{}):Promise.resolve()),this.opening)}async invoke(r,t={}){if(this.closed)throw new Error("Surface is closed");if(!this.actions.has(r))throw new Error("Undeclared surface action: "+r);if(this.pending.size>=32||JSON.stringify(t).length>128*1024)throw new Error("Surface request exceeds limit");let s=new AbortController;this.pending.add(s);try{let i=await this.dispatch(r,t,s.signal);if(this.closed)throw new Error("Surface is closed");return i}finally{this.pending.delete(s)}}close(){if(this.closing)return this.closing;this.closed=!0;for(let t of this.pending)t.abort();this.pending.clear();let r=this.surface.lifecycle?.closeAction;return this.closing=Promise.resolve().then(async()=>{r&&await this.dispatch(r,{})}),this.closing}};export{l as PERMISSION_GROUPS,d as SurfaceSession,p as assertContentPage,m as assertLyricsDocument,f as assertResolveResult,c as assertResourceRef,w as permissionGroup};
package/assets/index.html CHANGED
@@ -1,94 +1,94 @@
1
- <!doctype html>
2
- <html lang="zh-CN">
3
- <head>
4
- <meta charset="utf-8" />
5
- <meta name="viewport" content="width=device-width,initial-scale=1" />
6
- <title>Ceru Plugin Dev</title>
7
- <link rel="stylesheet" href="/style.css" />
8
- </head>
9
- <body>
10
- <header>
11
- <div>
12
- <span class="badge">CERU / DEV HOST</span>
13
- <h1 id="plugin-name">插件调试工作台</h1>
14
- <p id="plugin-meta">TypeScript · 单文件构建 · 隔离运行</p>
15
- </div>
16
- <div class="header-actions">
17
- <span id="status" class="status">启动中</span><button id="restart">重新运行</button
18
- ><button id="stop">停止</button>
19
- </div>
20
- </header>
21
- <div id="build-error" class="error hidden"></div>
22
- <main>
23
- <aside>
24
- <section>
25
- <h2>能力注册</h2>
26
- <div id="registrations"></div>
27
- </section>
28
- <section>
29
- <h2>界面与兼容模块</h2>
30
- <div id="views"></div>
31
- </section>
32
- <section>
33
- <h2>运行时配置</h2>
34
- <p class="hint">仅保存在当前开发会话中。</p>
35
- <textarea id="config" spellcheck="false">{}</textarea
36
- ><button id="apply-config">应用配置并重载</button>
37
- </section>
38
- <section>
39
- <h2>权限模拟</h2>
40
- <div id="permissions"></div>
41
- </section>
42
- </aside>
43
- <article>
44
- <section>
45
- <h2>搜索与解析</h2>
46
- <div class="row">
47
- <select id="provider" disabled aria-label="搜索来源"></select
48
- ><input id="query" placeholder="输入关键词" disabled /><button id="search" class="primary" disabled>
49
- 调用搜索</button
50
- ><button id="cancel" disabled>取消调用</button>
51
- </div>
52
- <p id="search-status" class="hint" role="status" aria-live="polite">正在读取插件能力…</p>
53
- <div id="results" class="results">
54
- <div class="empty">插件启动后可以调用已注册的搜索方法。</div>
55
- </div>
56
- <pre id="result-detail"></pre>
57
- </section>
58
- <section>
59
- <h2>界面预览</h2>
60
- <div id="preview" class="preview"><div class="empty">选择左侧的页面。</div></div>
61
- </section>
62
- <section>
63
- <h2>宿主资源</h2>
64
- <p class="hint">
65
- 平台图标可直接写入 Manifest:<code>icon: { kind: 'host', name: 'platform.tx' }</code>
66
- </p>
67
- <div id="icons" class="icons"></div>
68
- <div id="static-assets" class="static-assets"></div>
69
- <p class="hint">工具:<code>ctx.utils.lodash</code> · 64 个带类型提示的常用方法</p>
70
- </section>
71
- </article>
72
- <section class="log-column">
73
- <div class="row">
74
- <h2>运行日志</h2>
75
- <button id="clear-log">清空</button>
76
- </div>
77
- <p class="hint">
78
- 使用 VS Code 的 “Attach to Ceru plugin” 或 Electron DevTools 调试 TS
79
- 源码。日志已对常见敏感字段脱敏。
80
- </p>
81
- <div id="logs"></div>
82
- </section>
83
- </main>
84
- <div id="runners" class="hidden"></div>
85
- <footer>
86
- 这是开发 Host。实际运行逻辑与界面;网络默认拒绝。生产安装授权、凭据保险箱、Guest
87
- 安装及完整音乐业务仍由正式 Host 实现。
88
- </footer>
89
- <script nonce="{{NONCE}}">
90
- window.CERU_DEV_TOKEN={{TOKEN}};
91
- </script>
92
- <script type="module" src="/playground.js"></script>
93
- </body>
94
- </html>
1
+ <!doctype html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width,initial-scale=1" />
6
+ <title>Ceru Plugin Dev</title>
7
+ <link rel="stylesheet" href="/style.css" />
8
+ </head>
9
+ <body>
10
+ <header>
11
+ <div>
12
+ <span class="badge">CERU / DEV HOST</span>
13
+ <h1 id="plugin-name">插件调试工作台</h1>
14
+ <p id="plugin-meta">TypeScript · 单文件构建 · 隔离运行</p>
15
+ </div>
16
+ <div class="header-actions">
17
+ <span id="status" class="status">启动中</span><button id="restart">重新运行</button
18
+ ><button id="stop">停止</button>
19
+ </div>
20
+ </header>
21
+ <div id="build-error" class="error hidden"></div>
22
+ <main>
23
+ <aside>
24
+ <section>
25
+ <h2>能力注册</h2>
26
+ <div id="registrations"></div>
27
+ </section>
28
+ <section>
29
+ <h2>界面与兼容模块</h2>
30
+ <div id="views"></div>
31
+ </section>
32
+ <section>
33
+ <h2>运行时配置</h2>
34
+ <p class="hint">仅保存在当前开发会话中。</p>
35
+ <textarea id="config" spellcheck="false">{}</textarea
36
+ ><button id="apply-config">应用配置并重载</button>
37
+ </section>
38
+ <section>
39
+ <h2>权限模拟</h2>
40
+ <div id="permissions"></div>
41
+ </section>
42
+ </aside>
43
+ <article>
44
+ <section>
45
+ <h2>搜索与解析</h2>
46
+ <div class="row">
47
+ <select id="provider" disabled aria-label="搜索来源"></select
48
+ ><input id="query" placeholder="输入关键词" disabled /><button id="search" class="primary" disabled>
49
+ 调用搜索</button
50
+ ><button id="cancel" disabled>取消调用</button>
51
+ </div>
52
+ <p id="search-status" class="hint" role="status" aria-live="polite">正在读取插件能力…</p>
53
+ <div id="results" class="results">
54
+ <div class="empty">插件启动后可以调用已注册的搜索方法。</div>
55
+ </div>
56
+ <pre id="result-detail"></pre>
57
+ </section>
58
+ <section>
59
+ <div class="row"><h2>界面预览</h2><button id="close-view">关闭页面</button></div>
60
+ <div id="preview" class="preview"><div class="empty">选择左侧的页面。</div></div>
61
+ </section>
62
+ <section>
63
+ <h2>宿主资源</h2>
64
+ <p class="hint">
65
+ 平台图标可直接写入 Manifest:<code>icon: { kind: 'host', name: 'platform.tx' }</code>
66
+ </p>
67
+ <div id="icons" class="icons"></div>
68
+ <div id="static-assets" class="static-assets"></div>
69
+ <p class="hint">工具:<code>ctx.utils.lodash</code> · 64 个带类型提示的常用方法</p>
70
+ </section>
71
+ </article>
72
+ <section class="log-column">
73
+ <div class="row">
74
+ <h2>运行日志</h2>
75
+ <button id="clear-log">清空</button>
76
+ </div>
77
+ <p class="hint">
78
+ 使用 VS Code 的 “Attach to Ceru plugin” 或 Electron DevTools 调试 TS
79
+ 源码。日志已对常见敏感字段脱敏。
80
+ </p>
81
+ <div id="logs"></div>
82
+ </section>
83
+ </main>
84
+ <div id="runners" class="hidden"></div>
85
+ <footer>
86
+ 这是开发 Host。实际运行逻辑与界面;网络默认拒绝。生产安装授权、凭据保险箱、Guest
87
+ 安装及完整音乐业务仍由正式 Host 实现。
88
+ </footer>
89
+ <script nonce="{{NONCE}}">
90
+ window.CERU_DEV_TOKEN={{TOKEN}};
91
+ </script>
92
+ <script type="module" src="/playground.js"></script>
93
+ </body>
94
+ </html>
@@ -4,6 +4,7 @@ import {
4
4
  assertResolveResult,
5
5
  PERMISSION_GROUPS,
6
6
  permissionGroup,
7
+ SurfaceSession,
7
8
  } from './core-contracts.js'
8
9
  const $ = (id) => document.getElementById(id)
9
10
  let state,
@@ -12,6 +13,8 @@ let state,
12
13
  stopped = false,
13
14
  viewId = null,
14
15
  currentInvocation
16
+ let viewSession
17
+ let viewTransition = Promise.resolve()
15
18
  const frames = new Map(),
16
19
  calls = new Map(),
17
20
  registrations = new Map(),
@@ -51,9 +54,11 @@ function post(frame, type, data) {
51
54
  frame.element.contentWindow?.postMessage({ type, data, generation: frame.generation }, '*')
52
55
  }
53
56
  function removeFrames() {
57
+ void viewSession?.close().catch(error => log('error', error.message))
58
+ viewSession = undefined
54
59
  void api('rpc', { method: 'sockets.closeAll' }).catch(() => {})
55
60
  document.getElementById('host-playlist-import')?.remove()
56
- for (const frame of frames.values()) frame.element.remove()
61
+ for (const frame of frames.values()) { post(frame, 'dispose'); frame.element.remove() }
57
62
  frames.clear()
58
63
  registrations.clear()
59
64
  for (const call of calls.values()) {
@@ -61,6 +66,7 @@ function removeFrames() {
61
66
  call.reject(new Error('Plugin reloaded or stopped'))
62
67
  }
63
68
  calls.clear()
69
+ surfaceStates.clear()
64
70
  currentInvocation = null
65
71
  $('results').replaceChildren()
66
72
  $('result-detail').textContent = ''
@@ -89,7 +95,7 @@ function start() {
89
95
  $('status').textContent = '加载中'
90
96
  if (state.manifest.modules.logic) mount(state.manifest.modules.logic.entry, 'logic', $('runners'))
91
97
  else $('status').textContent = '无后台入口'
92
- if (viewId) showView(viewId)
98
+ // Views open only after logic activation, when their actions have registered.
93
99
  updateSearchControls()
94
100
  }
95
101
  function hasProtocol(providerId, protocol) {
@@ -183,14 +189,24 @@ function drawRegistrations() {
183
189
  $('registrations').textContent = stopped ? '插件已停止' : '等待后台模块注册命令或能力'
184
190
  updateSearchControls()
185
191
  }
186
- function invoke(frame, kind, target, method, args) {
192
+ function invoke(frame, kind, target, method, args, signal) {
187
193
  const id = 'call-' + ++sequence
188
194
  currentInvocation = { frame, id }
189
195
  log('info', { call: kind === 'action' ? target : target + '.' + method })
190
196
  return new Promise((resolve, reject) => {
197
+ const cancel = () => {
198
+ const call = calls.get(id)
199
+ if (!call) return
200
+ clearTimeout(call.timer)
201
+ calls.delete(id)
202
+ post(frame, 'cancel', { id })
203
+ reject(new Error('Surface invocation cancelled'))
204
+ }
205
+ signal?.addEventListener('abort', cancel, { once: true })
191
206
  calls.set(id, {
192
207
  frame,
193
208
  resolve: (value) => {
209
+ signal?.removeEventListener('abort', cancel)
194
210
  try {
195
211
  if (
196
212
  kind === 'playlist-importer' ||
@@ -203,14 +219,16 @@ function invoke(frame, kind, target, method, args) {
203
219
  resolve(value)
204
220
  } catch (error) { reject(error) }
205
221
  },
206
- reject,
222
+ reject: error => { signal?.removeEventListener('abort', cancel); reject(error) },
207
223
  timer: setTimeout(() => {
208
224
  calls.delete(id)
209
225
  updateSearchControls()
210
226
  post(frame, 'cancel', { id })
227
+ signal?.removeEventListener('abort', cancel)
211
228
  reject(new Error('Invocation timed out'))
212
229
  }, 20000),
213
230
  })
231
+ if (signal?.aborted) { cancel(); return }
214
232
  updateSearchControls()
215
233
  post(frame, 'invoke', { id, kind, target, method, args })
216
234
  })
@@ -227,10 +245,10 @@ function showResult(value) {
227
245
  }
228
246
  return value
229
247
  }
230
- function runAction(action, input) {
248
+ function runAction(action, input = {}, signal) {
231
249
  const item = registrations.get('action:' + action)
232
250
  if (!item) return Promise.reject(new Error('Action is not registered: ' + action))
233
- return invoke(item.frame, 'action', action, '', [input])
251
+ return invoke(item.frame, 'action', action, '', [input], signal)
234
252
  }
235
253
 
236
254
  // A single Host-owned preview for all importers. Plugins contribute data callbacks only.
@@ -245,6 +263,9 @@ function openPlaylistImport(importerId, initialValue = '') {
245
263
  const title = document.createElement('h3'); title.textContent = meta.title
246
264
  const description = document.createElement('p'); description.textContent = meta.description || '粘贴歌单链接或 ID'
247
265
  const input = document.createElement('input'); input.placeholder = meta.placeholder || '歌单链接或 ID'; input.value = initialValue
266
+ const examples = document.createElement('ul')
267
+ for (const example of meta.examples || []) { const li = document.createElement('li'); li.textContent = example.label + ':' + example.value; examples.append(li) }
268
+ for (const note of meta.instructions || []) { const li = document.createElement('li'); li.textContent = note; examples.append(li) }
248
269
  const load = document.createElement('button'); load.textContent = '读取歌曲'
249
270
  const close = document.createElement('button'); close.textContent = '关闭'; close.onclick = () => dialog.close()
250
271
  const detail = document.createElement('pre')
@@ -265,7 +286,7 @@ function openPlaylistImport(importerId, initialValue = '') {
265
286
  } catch (error) { detail.textContent = error.message }
266
287
  finally { load.disabled = false }
267
288
  }
268
- dialog.append(title, description, input, load, close, hint, detail)
289
+ dialog.append(title, description, input, examples, load, close, hint, detail)
269
290
  document.body.append(dialog); dialog.showModal()
270
291
  dialog.addEventListener('close', () => dialog.remove(), { once: true })
271
292
  }
@@ -321,6 +342,26 @@ function renderSchema(node, values, container) {
321
342
  container.append(text)
322
343
  }
323
344
  function showView(id, mountInfo = { kind: 'page' }) {
345
+ viewTransition = viewTransition.catch(() => {}).then(async () => {
346
+ await closeView()
347
+ if (stopped) return
348
+ mountView(id, mountInfo)
349
+ })
350
+ return viewTransition.catch(error => log('error', error.message))
351
+ }
352
+ async function closeView() {
353
+ const previous = viewSession
354
+ viewSession = undefined
355
+ viewId = null
356
+ for (const [key, frame] of frames) if (frame.kind !== 'logic') {
357
+ post(frame, 'dispose')
358
+ frame.element.remove()
359
+ frames.delete(key)
360
+ }
361
+ $('preview').replaceChildren()
362
+ await previous?.close()
363
+ }
364
+ function mountView(id, mountInfo) {
324
365
  viewId = id
325
366
  for (const [key, frame] of frames)
326
367
  if (frame.kind !== 'logic') {
@@ -329,7 +370,12 @@ function showView(id, mountInfo = { kind: 'page' }) {
329
370
  }
330
371
  $('preview').replaceChildren()
331
372
  const view = state.manifest.modules.surfaces?.find((v) => v.id === id)
332
- if (view?.kind === 'web') mount(view.entry, 'web', $('preview'), mountInfo)
373
+ if (view?.kind === 'web') {
374
+ viewSession = new SurfaceSession(view, state.manifest, runAction)
375
+ const frame = mount(view.entry, 'web', $('preview'), mountInfo)
376
+ frame.surfaceId = id
377
+ frame.session = viewSession
378
+ }
333
379
  else if (view?.kind === 'schema')
334
380
  renderSchema(
335
381
  state.resources[view.entry]?.value?.root,
@@ -475,7 +521,7 @@ window.addEventListener('message', async (event) => {
475
521
  post(frame, 'init', {
476
522
  generation: frame.generation,
477
523
  kind: frame.kind,
478
- manifest: state.manifest,
524
+ manifest: frame.kind === 'web' ? { ...state.manifest, config: {} } : state.manifest,
479
525
  catalog: state.catalog,
480
526
  resources: state.resources,
481
527
  mount: frame.mountInfo,
@@ -490,6 +536,10 @@ window.addEventListener('message', async (event) => {
490
536
  $('status').textContent = '运行中'
491
537
  log('info', frame.moduleId + ' activated')
492
538
  drawRegistrations()
539
+ if (frame.kind === 'web') {
540
+ post(frame, 'state', surfaceStates.get(frame.surfaceId) ?? {})
541
+ void frame.session.open().catch(error => log('error', error.message))
542
+ } else if (frame.kind === 'logic' && viewId) void showView(viewId)
493
543
  }
494
544
  if (message.type === 'failed') {
495
545
  frame.failed = true
@@ -503,7 +553,7 @@ window.addEventListener('message', async (event) => {
503
553
  }
504
554
  if (message.type === 'log') log(data.level, data.values)
505
555
  if (message.type === 'notify') log(data.level, data.message)
506
- if (message.type === 'open-view') showView(data.surfaceId)
556
+ if (message.type === 'open-view' && frame.kind === 'logic') void showView(data.surfaceId)
507
557
  if (message.type === 'register') {
508
558
  if (frame.kind !== 'logic') return
509
559
  const valid =
@@ -511,6 +561,7 @@ window.addEventListener('message', async (event) => {
511
561
  ? state.manifest.contributes?.providers?.some((p) => p.id === data.id)
512
562
  : data.kind === 'playlist-importer'
513
563
  ? state.manifest.contributes?.playlistImporters?.some((p) => p.id === data.id)
564
+ : data.kind === 'lyric-converter' ? state.manifest.contributes?.lyricConverters?.some((p) => p.id === data.id)
514
565
  : state.manifest.contributes?.commands?.some((p) => p.action === data.id)
515
566
  if (valid) {
516
567
  registrations.set(data.kind + ':' + data.id, { ...data, frame })
@@ -523,7 +574,7 @@ window.addEventListener('message', async (event) => {
523
574
  }
524
575
  if (message.type === 'state' && frame.kind === 'logic') {
525
576
  surfaceStates.set(data.surfaceId, data.state)
526
- for (const view of frames.values()) if (view.kind === 'web') post(view, 'state', data.state)
577
+ for (const view of frames.values()) if (view.kind === 'web' && view.surfaceId === data.surfaceId) post(view, 'state', data.state)
527
578
  if (
528
579
  viewId === data.surfaceId &&
529
580
  state.manifest.modules.surfaces?.find((v) => v.id === viewId)?.kind === 'schema'
@@ -543,7 +594,7 @@ window.addEventListener('message', async (event) => {
543
594
  try {
544
595
  let value
545
596
  if (data.method === 'surface.invoke' && frame.kind === 'web')
546
- value = showResult(await runAction(data.data.action, data.data.input))
597
+ value = await frame.session.invoke(data.data.action, data.data.input ?? {})
547
598
  else if (frame.kind !== 'logic')
548
599
  throw new Error('This Surface/Guest cannot call a logic Host API directly')
549
600
  else if (data.method === 'permissions.requestGroup') {
@@ -666,6 +717,7 @@ $('stop').onclick = () => {
666
717
  $('status').textContent = '已停止'
667
718
  }
668
719
  $('clear-log').onclick = () => $('logs').replaceChildren()
720
+ $('close-view').onclick = () => { void closeView().catch(error => log('error', error.message)) }
669
721
  $('apply-config').onclick = async () => {
670
722
  try {
671
723
  await api('config', JSON.parse($('config').value))