@shiqianjiang/ceru-plugin-cli 0.2.6 → 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 +59 -11
  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 +71 -71
  10. package/schemas/config.schema.json +131 -0
  11. package/templates/connected-library/js/package.json +22 -22
  12. package/templates/connected-library/ts/package.json +22 -22
  13. package/templates/guest-adapter/js/package.json +22 -22
  14. package/templates/guest-adapter/ts/package.json +22 -22
  15. package/templates/importer/js/package.json +22 -22
  16. package/templates/importer/ts/package.json +22 -22
  17. package/templates/react/js/package.json +26 -26
  18. package/templates/react/ts/package.json +26 -26
  19. package/templates/snapshot.json +1 -1
  20. package/templates/source/js/package.json +22 -22
  21. package/templates/source/ts/package.json +22 -22
  22. package/templates/vue/js/package.json +23 -23
  23. package/templates/vue/ts/package.json +23 -23
  24. package/templates/vue-tsx/js/package.json +23 -23
  25. package/templates/vue-tsx/ts/package.json +23 -23
  26. package/templates/web-dist/js/package.json +22 -22
  27. package/templates/web-dist/ts/package.json +22 -22
  28. package/templates/web-surface/js/ceru.plugin.json +31 -2
  29. package/templates/web-surface/js/package.json +22 -22
  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 +22 -22
  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 d(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.format!=="crlyric"||r.version!==1||!Number.isFinite(r.offsetMs)||!Array.isArray(r.lines)||r.lines.length>2e4)throw new Error("Invalid lyrics document");if(l(r.track),r.track.kind!=="track")throw new Error("Lyrics must reference a 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 c={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(c).find(e=>c[e].permissions.includes(r))}export{c as PERMISSION_GROUPS,d 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.
@@ -324,6 +342,26 @@ function renderSchema(node, values, container) {
324
342
  container.append(text)
325
343
  }
326
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) {
327
365
  viewId = id
328
366
  for (const [key, frame] of frames)
329
367
  if (frame.kind !== 'logic') {
@@ -332,7 +370,12 @@ function showView(id, mountInfo = { kind: 'page' }) {
332
370
  }
333
371
  $('preview').replaceChildren()
334
372
  const view = state.manifest.modules.surfaces?.find((v) => v.id === id)
335
- 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
+ }
336
379
  else if (view?.kind === 'schema')
337
380
  renderSchema(
338
381
  state.resources[view.entry]?.value?.root,
@@ -478,7 +521,7 @@ window.addEventListener('message', async (event) => {
478
521
  post(frame, 'init', {
479
522
  generation: frame.generation,
480
523
  kind: frame.kind,
481
- manifest: state.manifest,
524
+ manifest: frame.kind === 'web' ? { ...state.manifest, config: {} } : state.manifest,
482
525
  catalog: state.catalog,
483
526
  resources: state.resources,
484
527
  mount: frame.mountInfo,
@@ -493,6 +536,10 @@ window.addEventListener('message', async (event) => {
493
536
  $('status').textContent = '运行中'
494
537
  log('info', frame.moduleId + ' activated')
495
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)
496
543
  }
497
544
  if (message.type === 'failed') {
498
545
  frame.failed = true
@@ -506,7 +553,7 @@ window.addEventListener('message', async (event) => {
506
553
  }
507
554
  if (message.type === 'log') log(data.level, data.values)
508
555
  if (message.type === 'notify') log(data.level, data.message)
509
- if (message.type === 'open-view') showView(data.surfaceId)
556
+ if (message.type === 'open-view' && frame.kind === 'logic') void showView(data.surfaceId)
510
557
  if (message.type === 'register') {
511
558
  if (frame.kind !== 'logic') return
512
559
  const valid =
@@ -527,7 +574,7 @@ window.addEventListener('message', async (event) => {
527
574
  }
528
575
  if (message.type === 'state' && frame.kind === 'logic') {
529
576
  surfaceStates.set(data.surfaceId, data.state)
530
- 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)
531
578
  if (
532
579
  viewId === data.surfaceId &&
533
580
  state.manifest.modules.surfaces?.find((v) => v.id === viewId)?.kind === 'schema'
@@ -547,7 +594,7 @@ window.addEventListener('message', async (event) => {
547
594
  try {
548
595
  let value
549
596
  if (data.method === 'surface.invoke' && frame.kind === 'web')
550
- value = showResult(await runAction(data.data.action, data.data.input))
597
+ value = await frame.session.invoke(data.data.action, data.data.input ?? {})
551
598
  else if (frame.kind !== 'logic')
552
599
  throw new Error('This Surface/Guest cannot call a logic Host API directly')
553
600
  else if (data.method === 'permissions.requestGroup') {
@@ -670,6 +717,7 @@ $('stop').onclick = () => {
670
717
  $('status').textContent = '已停止'
671
718
  }
672
719
  $('clear-log').onclick = () => $('logs').replaceChildren()
720
+ $('close-view').onclick = () => { void closeView().catch(error => log('error', error.message)) }
673
721
  $('apply-config').onclick = async () => {
674
722
  try {
675
723
  await api('config', JSON.parse($('config').value))