@linkdesk/plugin-sdk 0.1.93 → 0.1.95

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.
package/README.md CHANGED
@@ -18,7 +18,7 @@ npm install -D @linkdesk/plugin-sdk
18
18
  > Auto-generated, **do not edit by hand**—produced live by `scripts/generate-api-cheatsheet.mjs` reading `linkdesk.d.ts` from `@linkdesk/contracts`;
19
19
  > `npm run check` mechanically watches for drift. For full signatures and per-method notes see `linkdesk.d.ts` itself (jump to it straight from the IDE).
20
20
 
21
- **16 domain interfaces → 47 namespaces / 260 methods**, all invoked via `window.linkdesk.<namespace>.<method>`. (plus 1 deprecated alias/es `config`, not counted twice)
21
+ **17 domain interfaces → 49 namespaces / 265 methods**, all invoked via `window.linkdesk.<namespace>.<method>`. (plus 1 deprecated alias/es `config`, not counted twice)
22
22
 
23
23
  | Namespace | Methods | Method | Notes |
24
24
  |:--|:--:|:--|:--|
@@ -32,6 +32,7 @@ npm install -D @linkdesk/plugin-sdk
32
32
  | `tabs` | 9 | `create` `openOrFocus` `focus` `close` `focusBySourceId` `updateLabelBySourceId` `closeBySourceId` `onDidChangeActiveTab` `list` | —— |
33
33
  | `keybindings` | 13 | `getKeybindings` `getConflicts` `registerKeybinding` `saveUserKeybindings` `removeKeybindingForCommand` `resetKeybindingToDefault` `clearKeybindingForCommand` `findKeybindingForCommand` `setKeybindingCaptureActive` `keyboardEventToKeyString` `onChange` `syncToMainProcess`° `onForwardedEvent`° | —— |
34
34
  | `notifications` | 3 | `show` `list` `subscribe` | Notifications — plugins raise notifications ( the only noti… |
35
+ | `toasts` | 1 | `show` | 轻 Toast(TransientToast)——2026-11-19 用户授权改判恢复的第二呈现面(同一 store… |
35
36
  | `menu` | 2 | `registerItems` `getItems` | Menus — declarative read/write for plugins |
36
37
  | `contextKey` | 1 | `set` | ContextKey — plugins SET state for the shell's when clauses… |
37
38
  | `dialog` | 5 | `confirm` `alert` `open` `openFile` `confirmContent` | Dialogs — confirm/alert/file selection |
@@ -57,7 +58,8 @@ npm install -D @linkdesk/plugin-sdk
57
58
  | `protocol` | 3 | `listProtocols` `getActiveProtocolId` `setActiveProtocolId` | protocol — protocol registry (answered directly by the main… |
58
59
  | `viewContainer` | 4 | `getViewContainer` `getViews` `getView` `registerView` | viewContainer — real IPC query/update (asks the shell-side … |
59
60
  | `plugins` | 14 | `resolvePath` `resolveEntry`° `getCompatibility`° `listDirs`° `listAll`° `listDisabledDirs`° `readManifest`° `readAllManifests`° `packageDownload`° `packageExtract`° `packageCancel`° `packageUpdateCheck`° `packageStageUpdate`° `packageCommitUpdate`° | Plugin discovery — injected on both ends: resolvePath exist… |
60
- | `pluginManager` | 13 | `list` `enable` `disable` `uninstall` `install` `installWithProgress`° `reinstall` `getDisabled` `getUninstalled` `isDisabled` `update`° `checkUpdates`° `notifyManifestChanged`° | Plugin management — bridges IpcBridgeHandler → loader funct… |
61
+ | `pluginManager` | 14 | `list` `enable` `disable` `uninstall` `install` `installFromDirectory`° `installWithProgress`° `reinstall` `getDisabled` `getUninstalled` `isDisabled` `update`° `checkUpdates`° `notifyManifestChanged`° | Plugin management — bridges IpcBridgeHandler → loader funct… |
62
+ | `licenses` | 3 | `verify` `list` `remove` | —— |
61
63
  | `bridge` ⚠️ | 4 | `onRequest` `respond` `broadcast` `notifyConfigChanged` | Shell↔plugin communication relay — shell preload only |
62
64
  | `pool` | 32 | `pushLayout` `onReady` `toggleDevTools` `onSidebarAction` `onTabAction` `onTabBarRects` `onDragPosition` `pushAdsorbHint` `onAdsorbIndex` `pushQuickPick` `onQuickPickAction` `pushDialog` `onDialogAction` `pushFloatingPanel` `onFloatingPanelAction` `onMemoryPressure` `createWindow` `closeWindow` `onWindowClosed` `onWindowBoundsChanged` `getLayout` `onLayout` `ready` `sidebarAction` `tabAction` `tabBarRects` `dragPosition` `onAdsorbHint` `adsorbIndex` `registerBeforeClose` `unregisterBeforeClose` `beforeClose` | Pool control — shell preload: pushes layout + registers poo… |
63
65
  | `window` | 11 | `minimize` `maximize` `unmaximize` `close` `setZoom` `toggleDevTools` `isMaximized` `onMaximizeChange` `setAlwaysOnTop` `isAlwaysOnTop` `onAlwaysOnTopChange` | Window control — TitleBar button mapping, injected on both … |
@@ -1,151 +1,152 @@
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.0" />
6
- <title>LinkDesk dev 宿主</title>
7
- <style>
8
- /* dev 宿主页 = SDK 工具 UI(非壳/非产品),中性配色 + 兜底主题变量让插件 var(--xxx) 不至全黑。
9
- 固定值允许——不违反壳硬约束 16(那约束壳 UI;此页不属于壳渲染树)。
10
-
11
- 🔴 :root 兜底集 = 壳仓 src/index.css 顶层 :root 块的 **token 全集照抄**(值同源,E6#134)——
12
- 真机里插件能消费的 token 面就是宿主 :root 这一份;兜底少于它 ⇒ 作者在真机能用 var(--bg-card)
13
- 在预览里解析为空、被迫写「中间兜底层」真机死代码。防手抄漂移 = src/dev-host.test.ts 的
14
- 生成式对账(两块 token 名集合必须相等,壳加减 token 当场红)。⛔ 手改值前先对齐壳真源。 */
15
- :root {
16
- --bg-window: #1E1E1E;
17
- --bg-card: #2D2D2D;
18
- --bg-input: #3C3C3C;
19
- --text-primary: #D4D4D4;
20
- --text-secondary: #9D9D9D;
21
- --text-muted: #8A8A8A;
22
- --tone-surface-deep: #1A1A1A;
23
- --tone-ink-on-deep: #FFFFFF;
24
- --tone-surface-light: #F2F2F2;
25
- --tone-ink-on-light: #1A1A1A;
26
- --accent: #0078D4;
27
- --accent-hover: #1A8CE8;
28
- --border: #3C3C3C;
29
- --separator: #474747;
30
- --icon-inactive: #858585;
31
- --icon-ink: color-mix(in srgb, var(--text-primary) 78%, transparent);
32
- --icon-ink-hover: color-mix(in srgb, var(--text-primary) 92%, transparent);
33
- --icon-ink-active: var(--text-primary);
34
- --system-log: #6A6A6A;
35
- --sent-echo: #0078D4;
36
- --status-connected: #4EC9B0;
37
- --status-disconnected: #6A6A6A;
38
- --scrollbar-thumb: rgba(255, 255, 255, 0.15);
39
- --scrollbar-thumb-hover: rgba(255, 255, 255, 0.25);
40
- --tab-hover-bg: #353535;
41
- --drop-glass-bg: rgba(255, 255, 255, 0.08);
42
- --drop-glass-border: rgba(255, 255, 255, 0.10);
43
- --drop-glass-inner: inset 0 0 0 1px rgba(255, 255, 255, 0.06);
44
- --dirty-dot: #CCA700;
45
- --context-menu-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
46
- --drag-preview-shadow: 0 4px 16px rgba(0, 0, 0, 0.35);
47
- --tab-active-shadow: 0 1px 4px rgba(0, 0, 0, 0.18);
48
- --floating-panel-backdrop: rgba(0, 0, 0, 0.35);
49
- --floating-panel-shadow: 0 12px 40px rgba(0, 0, 0, 0.5);
50
- --floating-panel-shadow-dragging: 0 18px 60px rgba(0, 0, 0, 0.6);
51
- --scrim-dialog: rgba(0, 0, 0, 0.5);
52
- --scrim-overlay: rgba(0, 0, 0, 0.3);
53
- --bg-mask-color: #000;
54
- --font-ui: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
55
- --font-mono: "JetBrains Mono", Consolas, monospace;
56
- /* W7b(T12):品牌字标字体(壳 EmptyStage 的 LinkDesk 字标)——与 src/index.css :root 同值
57
- (dev-host.test.ts 生成式对账:兜底集必须 === 壳 :root 全集) */
58
- --font-mark: 'Newsreader', 'Lyon Text', Georgia, 'Songti SC', 'SimSun', serif;
59
- --ui-scale: 1;
60
- --font-size-2xs: 11px;
61
- --font-size-xs: 12px;
62
- --font-size-sm: 13px;
63
- --font-size-md: 14px;
64
- --font-size-lg: 16px;
65
- --font-size-xl: 18px;
66
- --font-size-2xl: 22px;
67
- --font-size-3xl: 28px;
68
- --font-size-4xl: 30px;
69
- --radius-xs: 2px;
70
- --radius-sm: 4px;
71
- --radius-md: 6px;
72
- --radius-lg: 8px;
73
- --radius-2xl: 16px;
74
- --radius-pill: 999px;
75
- --radius-full: 50%;
76
- --shadow-hairline: 0 0 1px rgba(0, 0, 0, 0.2);
77
- --shadow-tiny: 0 0 2px rgba(0, 0, 0, 0.5);
78
- --shadow-float: 0 4px 16px rgba(0, 0, 0, 0.25);
79
- --shadow-pop: 0 4px 12px rgba(0, 0, 0, 0.4);
80
- --shadow-tooltip: 0 2px 8px rgba(0, 0, 0, 0.3);
81
- --shadow-dialog: 0 8px 32px rgba(0, 0, 0, 0.5);
82
- --shadow-dialog-soft: 0 8px 32px rgba(0, 0, 0, 0.35);
83
- --shadow-lift: 0 8px 24px rgba(0, 0, 0, 0.4);
84
- --error: #E06C75;
85
- --warning: #CCA700;
86
- --success: #4CAF50;
87
- --badge-text: var(--text-on-accent);
88
- --badge-background: var(--accent);
89
- --badge-foreground: var(--badge-text);
90
- --bg-titlebar: #252526;
91
- --bg-icon-bar: #18181B;
92
- --bg-side-panel: #1E1E22;
93
- --bg-toolbar: #1E1E22;
94
- --titlebar-close-hover: #c42b1c;
95
- --toggle-knob: #FFFFFF;
96
- --hover-overlay: rgba(255, 255, 255, 0.06);
97
- --icon-btn-hover-bg: rgba(255, 255, 255, 0.1);
98
- --kbd-bg: rgba(128, 128, 128, 0.1);
99
- --kbd-border: rgba(128, 128, 128, 0.12);
100
- --kbd-hover-bg: rgba(255, 255, 255, 0.2);
101
- --kbd-hover-border: rgba(255, 255, 255, 0.35);
102
- --bg-selection: color-mix(in srgb, var(--accent) 20%, transparent);
103
- --cm-timestamp: #8A8A8A;
104
- --z-dropdown: 650;
105
- --z-sticky: 200;
106
- --z-overlay-backdrop: 500;
107
- --z-overlay: 600;
108
- --z-drag-preview: 1000;
109
- --z-sidebar-sticky-header: 10;
110
- --warning-text: #E8AB3E;
111
- --warning-bg: rgba(255, 200, 0, 0.12);
112
- --text-on-accent: #FFFFFF;
113
- --danger: #EF4444;
114
- }
115
- * { box-sizing: border-box; }
116
- html, body { margin: 0; height: 100%; }
117
- body {
118
- background: var(--bg-window);
119
- color: var(--text-primary);
120
- font-family: var(--font-ui);
121
- }
122
- #ld-topbar {
123
- position: sticky; top: 0; z-index: 10;
124
- display: flex; align-items: center; gap: 8px;
125
- padding: 5px 12px; font-size: 12px;
126
- background: var(--bg-input); border-bottom: 1px solid var(--border);
127
- user-select: none;
128
- }
129
- #ld-topbar .dot { width: 8px; height: 8px; border-radius: 50%; background: var(--accent); }
130
- #ld-topbar .sep { opacity: 0.4; }
131
- #ld-topbar code { color: var(--sent-echo); font-family: var(--font-mono); }
132
- #ld-topbar .hint { color: var(--text-muted); margin-left: auto; }
133
- /* 🔴 挂载点必须有确定高度(E6#134)——真壳的标签页容器有确定高度,插件 height:100% 依赖它;
134
- 这里 flex 链拉伸(html/body 100% → body 纵向 flex → #ld-root 吃满剩余),等价真机形态。
135
- 少了它插件画布塌陷,作者被迫写 ResizeObserver 自愈真机死代码。防漂移 = src/dev-host.test.ts。 */
136
- body { display: flex; flex-direction: column; }
137
- #ld-root { flex: 1 1 auto; min-height: 0; padding: 0; }
138
- </style>
139
- </head>
140
- <body>
141
- <div id="ld-topbar">
142
- <span class="dot"></span>
143
- <span>LinkDesk dev 宿主</span>
144
- <span class="sep">·</span>
145
- <code id="ld-plugin-id"></code>
146
- <span class="hint">本地预览 · 无 Electron/IPC · 改码 HMR</span>
147
- </div>
148
- <div id="ld-root"></div>
149
- <script type="module" src="/dev-main.tsx"></script>
150
- </body>
151
- </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.0" />
6
+ <title>LinkDesk dev 宿主</title>
7
+ <style>
8
+ /* dev 宿主页 = SDK 工具 UI(非壳/非产品),中性配色 + 兜底主题变量让插件 var(--xxx) 不至全黑。
9
+ 固定值允许——不违反壳硬约束 16(那约束壳 UI;此页不属于壳渲染树)。
10
+
11
+ 🔴 :root 兜底集 = 壳仓 src/index.css 顶层 :root 块的 **token 全集照抄**(值同源,E6#134)——
12
+ 真机里插件能消费的 token 面就是宿主 :root 这一份;兜底少于它 ⇒ 作者在真机能用 var(--bg-card)
13
+ 在预览里解析为空、被迫写「中间兜底层」真机死代码。防手抄漂移 = src/dev-host.test.ts 的
14
+ 生成式对账(两块 token 名集合必须相等,壳加减 token 当场红)。⛔ 手改值前先对齐壳真源。 */
15
+ :root {
16
+ --bg-window: #1E1E1E;
17
+ --bg-card: #2D2D2D;
18
+ --bg-input: #3C3C3C;
19
+ --text-primary: #D4D4D4;
20
+ --text-secondary: #9D9D9D;
21
+ --text-muted: #8A8A8A;
22
+ --tone-surface-deep: #1A1A1A;
23
+ --tone-ink-on-deep: #FFFFFF;
24
+ --tone-surface-light: #F2F2F2;
25
+ --tone-ink-on-light: #1A1A1A;
26
+ --accent: #0078D4;
27
+ --accent-hover: #1A8CE8;
28
+ --border: #3C3C3C;
29
+ --separator: #474747;
30
+ --icon-inactive: #858585;
31
+ --icon-ink: color-mix(in srgb, var(--text-primary) 78%, transparent);
32
+ --icon-ink-hover: color-mix(in srgb, var(--text-primary) 92%, transparent);
33
+ --icon-ink-active: var(--text-primary);
34
+ --system-log: #6A6A6A;
35
+ --sent-echo: #0078D4;
36
+ --status-connected: #4EC9B0;
37
+ --status-disconnected: #6A6A6A;
38
+ --scrollbar-thumb: rgba(255, 255, 255, 0.15);
39
+ --scrollbar-thumb-hover: rgba(255, 255, 255, 0.25);
40
+ --tab-hover-bg: #353535;
41
+ --drop-glass-bg: rgba(255, 255, 255, 0.08);
42
+ --drop-glass-border: rgba(255, 255, 255, 0.10);
43
+ --drop-glass-inner: inset 0 0 0 1px rgba(255, 255, 255, 0.06);
44
+ --dirty-dot: #CCA700;
45
+ --context-menu-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
46
+ --drag-preview-shadow: 0 4px 16px rgba(0, 0, 0, 0.35);
47
+ --tab-active-shadow: 0 1px 4px rgba(0, 0, 0, 0.18);
48
+ --floating-panel-backdrop: rgba(0, 0, 0, 0.35);
49
+ --floating-panel-shadow: 0 12px 40px rgba(0, 0, 0, 0.5);
50
+ --floating-panel-shadow-dragging: 0 18px 60px rgba(0, 0, 0, 0.6);
51
+ --scrim-dialog: rgba(0, 0, 0, 0.5);
52
+ --scrim-overlay: rgba(0, 0, 0, 0.3);
53
+ --bg-mask-color: #000;
54
+ --font-ui: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
55
+ --font-mono: "JetBrains Mono", Consolas, monospace;
56
+ /* W7b(T12):品牌字标字体(壳 EmptyStage 的 LinkDesk 字标)——与 src/index.css :root 同值
57
+ (dev-host.test.ts 生成式对账:兜底集必须 === 壳 :root 全集) */
58
+ --font-mark: 'Newsreader', 'Lyon Text', Georgia, 'Songti SC', 'SimSun', serif;
59
+ --ui-scale: 1;
60
+ --statusbar-height: 22px;
61
+ --font-size-2xs: 11px;
62
+ --font-size-xs: 12px;
63
+ --font-size-sm: 13px;
64
+ --font-size-md: 14px;
65
+ --font-size-lg: 16px;
66
+ --font-size-xl: 18px;
67
+ --font-size-2xl: 22px;
68
+ --font-size-3xl: 28px;
69
+ --font-size-4xl: 30px;
70
+ --radius-xs: 2px;
71
+ --radius-sm: 4px;
72
+ --radius-md: 6px;
73
+ --radius-lg: 8px;
74
+ --radius-2xl: 16px;
75
+ --radius-pill: 999px;
76
+ --radius-full: 50%;
77
+ --shadow-hairline: 0 0 1px rgba(0, 0, 0, 0.2);
78
+ --shadow-tiny: 0 0 2px rgba(0, 0, 0, 0.5);
79
+ --shadow-float: 0 4px 16px rgba(0, 0, 0, 0.25);
80
+ --shadow-pop: 0 4px 12px rgba(0, 0, 0, 0.4);
81
+ --shadow-tooltip: 0 2px 8px rgba(0, 0, 0, 0.3);
82
+ --shadow-dialog: 0 8px 32px rgba(0, 0, 0, 0.5);
83
+ --shadow-dialog-soft: 0 8px 32px rgba(0, 0, 0, 0.35);
84
+ --shadow-lift: 0 8px 24px rgba(0, 0, 0, 0.4);
85
+ --error: #E06C75;
86
+ --warning: #CCA700;
87
+ --success: #4CAF50;
88
+ --badge-text: var(--text-on-accent);
89
+ --badge-background: var(--accent);
90
+ --badge-foreground: var(--badge-text);
91
+ --bg-titlebar: #252526;
92
+ --bg-icon-bar: #18181B;
93
+ --bg-side-panel: #1E1E22;
94
+ --bg-toolbar: #1E1E22;
95
+ --titlebar-close-hover: #c42b1c;
96
+ --toggle-knob: #FFFFFF;
97
+ --hover-overlay: rgba(255, 255, 255, 0.06);
98
+ --icon-btn-hover-bg: rgba(255, 255, 255, 0.1);
99
+ --kbd-bg: rgba(128, 128, 128, 0.1);
100
+ --kbd-border: rgba(128, 128, 128, 0.12);
101
+ --kbd-hover-bg: rgba(255, 255, 255, 0.2);
102
+ --kbd-hover-border: rgba(255, 255, 255, 0.35);
103
+ --bg-selection: color-mix(in srgb, var(--accent) 20%, transparent);
104
+ --cm-timestamp: #8A8A8A;
105
+ --z-dropdown: 650;
106
+ --z-sticky: 200;
107
+ --z-overlay-backdrop: 500;
108
+ --z-overlay: 600;
109
+ --z-drag-preview: 1000;
110
+ --z-sidebar-sticky-header: 10;
111
+ --warning-text: #E8AB3E;
112
+ --warning-bg: rgba(255, 200, 0, 0.12);
113
+ --text-on-accent: #FFFFFF;
114
+ --danger: #EF4444;
115
+ }
116
+ * { box-sizing: border-box; }
117
+ html, body { margin: 0; height: 100%; }
118
+ body {
119
+ background: var(--bg-window);
120
+ color: var(--text-primary);
121
+ font-family: var(--font-ui);
122
+ }
123
+ #ld-topbar {
124
+ position: sticky; top: 0; z-index: 10;
125
+ display: flex; align-items: center; gap: 8px;
126
+ padding: 5px 12px; font-size: 12px;
127
+ background: var(--bg-input); border-bottom: 1px solid var(--border);
128
+ user-select: none;
129
+ }
130
+ #ld-topbar .dot { width: 8px; height: 8px; border-radius: 50%; background: var(--accent); }
131
+ #ld-topbar .sep { opacity: 0.4; }
132
+ #ld-topbar code { color: var(--sent-echo); font-family: var(--font-mono); }
133
+ #ld-topbar .hint { color: var(--text-muted); margin-left: auto; }
134
+ /* 🔴 挂载点必须有确定高度(E6#134)——真壳的标签页容器有确定高度,插件 height:100% 依赖它;
135
+ 这里 flex 链拉伸(html/body 100% → body 纵向 flex → #ld-root 吃满剩余),等价真机形态。
136
+ 少了它插件画布塌陷,作者被迫写 ResizeObserver 自愈真机死代码。防漂移 = src/dev-host.test.ts。 */
137
+ body { display: flex; flex-direction: column; }
138
+ #ld-root { flex: 1 1 auto; min-height: 0; padding: 0; }
139
+ </style>
140
+ </head>
141
+ <body>
142
+ <div id="ld-topbar">
143
+ <span class="dot"></span>
144
+ <span>LinkDesk dev 宿主</span>
145
+ <span class="sep">·</span>
146
+ <code id="ld-plugin-id"></code>
147
+ <span class="hint">本地预览 · 无 Electron/IPC · 改码 HMR</span>
148
+ </div>
149
+ <div id="ld-root"></div>
150
+ <script type="module" src="/dev-main.tsx"></script>
151
+ </body>
152
+ </html>
@@ -116,6 +116,9 @@ export const linkdeskMock: Record<string, unknown> = {
116
116
  list: async (..._args: unknown[]) => { console.info("[linkdesk-mock] notifications.list", ..._args); },
117
117
  subscribe: (..._args: unknown[]) => { console.info("[linkdesk-mock] notifications.subscribe", ..._args); return () => {}; },
118
118
  },
119
+ toasts: {
120
+ show: async (..._args: unknown[]) => { console.info("[linkdesk-mock] toasts.show", ..._args); },
121
+ },
119
122
  menu: {
120
123
  registerItems: async (..._args: unknown[]) => { console.info("[linkdesk-mock] menu.registerItems", ..._args); },
121
124
  getItems: async (..._args: unknown[]) => { console.info("[linkdesk-mock] menu.getItems", ..._args); return []; },
@@ -286,6 +289,7 @@ export const linkdeskMock: Record<string, unknown> = {
286
289
  disable: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.disable", ..._args); },
287
290
  uninstall: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.uninstall", ..._args); },
288
291
  install: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.install", ..._args); },
292
+ installFromDirectory: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.installFromDirectory", ..._args); },
289
293
  installWithProgress: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.installWithProgress", ..._args); },
290
294
  reinstall: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.reinstall", ..._args); },
291
295
  getDisabled: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.getDisabled", ..._args); return []; },
@@ -295,6 +299,11 @@ export const linkdeskMock: Record<string, unknown> = {
295
299
  checkUpdates: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.checkUpdates", ..._args); },
296
300
  notifyManifestChanged: (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.notifyManifestChanged", ..._args); },
297
301
  },
302
+ licenses: {
303
+ verify: async (..._args: unknown[]) => { console.info("[linkdesk-mock] licenses.verify", ..._args); },
304
+ list: async (..._args: unknown[]) => { console.info("[linkdesk-mock] licenses.list", ..._args); return []; },
305
+ remove: async (..._args: unknown[]) => { console.info("[linkdesk-mock] licenses.remove", ..._args); },
306
+ },
298
307
  bridge: {
299
308
  onRequest: (..._args: unknown[]) => { console.info("[linkdesk-mock] bridge.onRequest", ..._args); return () => {}; },
300
309
  respond: (..._args: unknown[]) => { console.info("[linkdesk-mock] bridge.respond", ..._args); },
package/dist/publish.d.ts CHANGED
@@ -35,6 +35,18 @@ export interface CatalogPluginEntry {
35
35
  marketIcon?: string;
36
36
  marketIconSource?: string;
37
37
  category?: string;
38
+ /** Marketplace-Store v2:主分类下的副标签 slug(喂搜索/小类 chips;抽屉归属只看 category,防双重陈列) */
39
+ categories?: string[];
40
+ /** v2:作者身份聚合键——接 `authors/<authorId>.json` 作者块与 `vendors.json` 注册表(判定链:命中 ⇒ 官方 ✓) */
41
+ authorId?: string;
42
+ /** v2:画廊媒体——string = 图片(旧数据原样);视频项至多 1 段且必须排第一(解析期丢越位视频并记声明提示) */
43
+ screenshots?: CatalogScreenshot[];
44
+ /** 作者声明的许可证(展示字段) */
45
+ license?: string;
46
+ /** 作者显式声明的插件主页(完整 URL;非 GitHub 托管/自有官网的唯一出口) */
47
+ repository?: string;
48
+ /** v2:定价声明——只展示不裁决(购买走外链、验签在壳;09 §三·补3) */
49
+ pricing?: PricingDecl;
38
50
  downloadUrl: string;
39
51
  size?: number;
40
52
  publishedAt?: string;
@@ -46,9 +58,144 @@ export interface CatalogPluginEntry {
46
58
  versions: CatalogVersion[];
47
59
  }
48
60
  export interface MarketplaceCatalog {
61
+ /** $schema 引用——kit init 写入(编辑器补全);publish 根级保全原样带过,不拥有它 */
62
+ $schema?: string;
49
63
  version?: string;
50
64
  updatedAt?: string;
51
65
  plugins: CatalogPluginEntry[];
66
+ /** v2:官方目录的已审核第三方源清单(只有官方运营者可写;收录 = 背书不复制条目) */
67
+ sources?: SourceLink[];
68
+ /** v2:合集声明(可声明于任意仓的 marketplace.json——推荐落点;成员按 id 引用,缺失静默跳过) */
69
+ collections?: CollectionDecl[];
70
+ /** v2:分类 rail 展示顺序(未注册 slug 落「其他」桶,不报错) */
71
+ categoryRail?: CategoryRailDecl;
72
+ }
73
+ /** 画廊媒体项:string = 图片 URL(旧形态);视频对象至多 1 段且必须排第一(06 §二·2 媒体契约) */
74
+ export type CatalogScreenshot = string | {
75
+ type: "video";
76
+ url: string;
77
+ poster?: string;
78
+ };
79
+ /** 定价声明(v1 只展示:外链收钱+壳 Ed25519 离线验签;subscription/channel 为 B3 预留枚举位) */
80
+ export interface PricingDecl {
81
+ model: "paid" | "subscription";
82
+ price?: number;
83
+ currency?: string;
84
+ period?: string;
85
+ /** 销售页——购买流 openExternal 的目标;model:"paid" 时必填(schema if/then 钉住) */
86
+ licenseUrl?: string;
87
+ refundUrl?: string;
88
+ /** 试用天数=详情页静态说明(真试用门在作者代码,壳不管) */
89
+ trialDays?: number;
90
+ /** B3 双轨预留:self = 自销(离线签名 0 抽成)· managed = 托管(我们签发/收款/抽成) */
91
+ channel?: "self" | "managed";
92
+ }
93
+ /** 已审核第三方源清单条目(官方目录根级;收录 = 背书,⛔ 不收条目副本) */
94
+ export interface SourceLink {
95
+ url: string;
96
+ authorId: string;
97
+ addedAt: string;
98
+ }
99
+ /** 合集声明(06 §二·3;作者数据直显不走 t()——先例:目录条目标题/作者/来源仓库名) */
100
+ export interface CollectionDecl {
101
+ id: string;
102
+ title: string;
103
+ subtitle?: string;
104
+ /** 板块副题说明字——不声明不渲染(09 §五) */
105
+ hint?: string;
106
+ cover?: string;
107
+ /** 卡片原型映射:banner→hero · strip→sm 横排 · duo→lg×2 · grid→md 网格(05 §四) */
108
+ layout?: "banner" | "strip" | "duo" | "grid";
109
+ /** 成员 pluginId 引用——缺失条目静默跳过(照目录 merge 防御语义) */
110
+ items: string[];
111
+ /** 环境光晕开关——市场侧板块级/合集级「两处都认」(08 §三·v3.57 U4;缺省开) */
112
+ glow?: boolean;
113
+ /** 合集标题跳转字——封闭 target 集合(与板块 more 同规) */
114
+ more?: SectionMore;
115
+ order?: number;
116
+ }
117
+ /** 分类 rail 展示顺序声明(06 §二·3) */
118
+ export interface CategoryRailDecl {
119
+ order: string[];
120
+ icons?: Record<string, string>;
121
+ }
122
+ /** 作者块内单个仓段——多仓归属(同 authorId 跨仓聚合;intro/image 仅显示于店内仓卡) */
123
+ export interface AuthorRepo {
124
+ id: string;
125
+ name: string;
126
+ intro?: string;
127
+ image?: string;
128
+ /** 本仓 marketplace.json URL——仓切换拉取目标 */
129
+ sourceUrl: string;
130
+ }
131
+ /** 板块跳转字——label 文案完全归作者;target 封闭集合(category:<slug> / rank / repo:<id>) */
132
+ export interface SectionMore {
133
+ label: string;
134
+ target: string;
135
+ }
136
+ /** hero 轮播单张(作者自选哪几张上大屏,上限 5 同官方) */
137
+ export interface HeroSlide {
138
+ plugin: string;
139
+ tag?: string;
140
+ }
141
+ /** 作者主页板块声明——「UI 界面必须有对应的指令」(09 §二)。type 封闭四件;标题/副题/跳转字全归作者,
142
+ * ⛔ 渲染器不自动造任何板块名与「更多」;「按分类浏览」渲染器硬保留、不在可声明清单。 */
143
+ export type HomepageSection = {
144
+ type: "hero";
145
+ slides: HeroSlide[];
146
+ title?: string;
147
+ hint?: string;
148
+ glow?: boolean;
149
+ more?: SectionMore;
150
+ } | {
151
+ type: "collection";
152
+ collection: string;
153
+ /** 卡片原型(整块统一,⛔ 卡级混排——想混 = 拆两个板块) */
154
+ layout?: "small" | "mega" | "duo";
155
+ title?: string;
156
+ hint?: string;
157
+ glow?: boolean;
158
+ more?: SectionMore;
159
+ } | {
160
+ type: "grid";
161
+ title: string;
162
+ hint?: string;
163
+ glow?: boolean;
164
+ more?: SectionMore;
165
+ } | {
166
+ type: "rank";
167
+ top?: number;
168
+ scope?: "self";
169
+ title?: string;
170
+ hint?: string;
171
+ glow?: boolean;
172
+ more?: SectionMore;
173
+ };
174
+ /** 作者块(authors/<authorId>.json)——authorId 去中心化聚合键(推荐 GitHub 用户名=身份正典) */
175
+ export interface AuthorBlock {
176
+ authorId: string;
177
+ name: string;
178
+ /** 非 GitHub 作者兜底(GitHub 正典可解时优先取 GitHub) */
179
+ avatar?: string;
180
+ introImage?: string;
181
+ intro?: string;
182
+ /** 作者店名,缺省「〈作者名〉的 Plugin Store」 */
183
+ storeTitle?: string;
184
+ /** Ed25519 公钥(kit keygen 生成)——壳离线验签许可密钥 */
185
+ publicKey?: string;
186
+ repos: AuthorRepo[];
187
+ homepage?: {
188
+ sections?: HomepageSection[];
189
+ };
190
+ }
191
+ /** 厂商注册表条目(vendors.json 独立文件,官方目录仓根;判定链唯一:authorId 命中 ⇒ 官方 ✓) */
192
+ export interface VendorDecl {
193
+ vendorId: string;
194
+ name: string;
195
+ domains?: string[];
196
+ githubOrgs?: string[];
197
+ verifiedBy: "domain" | "github-org" | "manual";
198
+ verifiedAt?: string;
52
199
  }
53
200
  export interface PublishOptions {
54
201
  /** 跳过确认(CI) */
@@ -131,6 +278,14 @@ export interface ManifestView {
131
278
  * ⚠️ 字段缺省 ⇒ **不写该键**(沿用本仓「缺省即不写」纪律;市场侧对 undefined 天然放行)。
132
279
  */
133
280
  minAppVersion?: string;
281
+ /**
282
+ * 🔴 R4-0.2(Marketplace-Store v2):分类声明透传——plugin.json `category`(主分类 slug)与
283
+ * `categories[]`(副标签)复制进目录条目。04-分类体系 §四声明链路的环①→②:分类页/搜索/chips
284
+ * 读的是**目录条目**(插件侧 parse 白名单已收这两键),生产端此前从不写 ⇒ 作者声明了也静默丢
285
+ * (E6#106/E6#77乙 同一类「静默丢」坑)。缺省不写键;存量条目等下次发布带上。
286
+ */
287
+ category?: string;
288
+ categories?: string[];
134
289
  }
135
290
  export declare function collectManifestView(manifest: unknown, sourceDirName: string): ManifestView;
136
291
  /** 条目补充字段——**缺省即不写该键**(字段缺省比填空串/空对象诚实,渲染层两条路走同一兜底) */
@@ -1 +1 @@
1
- {"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"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"}
package/dist/publish.js CHANGED
@@ -320,6 +320,11 @@ export function collectManifestView(manifest, sourceDirName) {
320
320
  marketIconSource: str(m.marketIconSource),
321
321
  // 🔴 E6#109p-b(1.28):最低宿主版本随条目走——市场「拒装」腿的唯一数据源(见 ManifestView 该字段说明)
322
322
  minAppVersion: str(m.minAppVersion),
323
+ // 🔴 R4-0.2:分类声明透传(manifest → 条目;声明链路环①→②,见 ManifestView 该字段说明)
324
+ category: str(m.category),
325
+ categories: Array.isArray(m.categories)
326
+ ? m.categories.filter((v) => typeof v === "string" && v.trim())
327
+ : undefined,
323
328
  };
324
329
  }
325
330
  /** 单条 catalog 条目构造——versions[] 只有当前一版(合并时与既有历史拼接)。author 缺失时回落 owner。 */
@@ -337,6 +342,9 @@ export function buildCatalogEntry(v, downloadUrl, size, owner, publishedAt, extr
337
342
  ...(v.marketIconSource !== undefined ? { marketIconSource: v.marketIconSource } : {}),
338
343
  // 🔴 E6#109p-b(1.28):最低宿主版本——**市场「拒装」腿的输入**(缺省不写键,市场侧对 undefined 放行)
339
344
  ...(v.minAppVersion !== undefined ? { minAppVersion: v.minAppVersion } : {}),
345
+ // 🔴 R4-0.2:分类声明随条目走(缺省不写键;分类页/搜索/chips 的唯一数据源)
346
+ ...(v.category !== undefined ? { category: v.category } : {}),
347
+ ...(v.categories !== undefined ? { categories: v.categories } : {}),
340
348
  ...(extras.readmeUrl !== undefined ? { readmeUrl: extras.readmeUrl } : {}),
341
349
  downloadUrl,
342
350
  size,
@@ -384,11 +392,16 @@ export function upsertCatalogEntry(catalog, entry) {
384
392
  marketIconSource: entry.marketIconSource ?? existing.marketIconSource,
385
393
  description: entry.description ?? existing.description,
386
394
  category: entry.category ?? existing.category,
395
+ // R4-0.2:分类副标签同待遇(作者漏写 categories 时不抹掉历史值)
396
+ categories: entry.categories ?? existing.categories,
387
397
  minAppVersion: entry.minAppVersion ?? existing.minAppVersion,
388
398
  };
389
399
  next[idx] = merged;
390
400
  }
391
- return { version: catalog.version ?? "1", updatedAt: now, plugins: next };
401
+ // 🔴 R4-0.2:**根级字段原样带过**(sources/collections/categoryRail 及任何未知根键)——publish 只拥有
402
+ // version/updatedAt/plugins 三键;此前整根重建会把官方目录仓根级的 `sources`/`collections` 等静默抹掉
403
+ // (目录仓 v2 骨架 R4-0.3 恰恰往根上放这些键,下次收录发布就会丢——先例级坑,同笔修)。
404
+ return { ...catalog, version: catalog.version ?? "1", updatedAt: now, plugins: next };
392
405
  }
393
406
  /** release tag = v{version} */
394
407
  export function releaseTagForVersion(version) {