@bilibili-notify/extension 0.0.0-stage → 0.1.0-alpha.0
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/AGENT_GUIDE.md +34 -0
- package/DEVELOPMENT.md +137 -0
- package/LICENSE +21 -0
- package/README.md +45 -2
- package/build.d.mts +25 -0
- package/build.mjs +4430 -0
- package/index.d.mts +2222 -0
- package/index.mjs +19 -0
- package/package.json +37 -3
- package/result-DVdiITy4.mjs +22 -0
- package/skills/bn-extension-development/SKILL.md +31 -0
package/AGENT_GUIDE.md
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# BN 拓展:agent 契约指引
|
|
2
|
+
|
|
3
|
+
实现细节查[作者指南](DEVELOPMENT.md)。准确的接口字段以当前安装版本的 `index.d.mts` 和 `build.d.mts` 为准;SDK 的 npm 版本与清单中的宿主 API 版本分别管理。
|
|
4
|
+
|
|
5
|
+
## 入口与构建
|
|
6
|
+
|
|
7
|
+
- 运行入口具名导出 `activate(ctx: ExtensionContext)`。默认对象里的 `activate` 不是宿主入口。
|
|
8
|
+
- 运行代码只从 `@bilibili-notify/extension` 获取 BN 契约;`/build` 只用于根构建配置。使用公开类型,不从私有宿主模块补接口。
|
|
9
|
+
- 模块顶层只定义规则和函数。构建插件会导入入口,副作用在激活或来源、适配器生命周期中开始。
|
|
10
|
+
- `settingsSchema`、`connectionSettingsSchema` 由入口导出,构建插件生成清单字段;同一套设置规则同时交给 ctx,不维护第二份字段表。
|
|
11
|
+
- 产物是自包含的 `index.mjs`,运行时没有独立的 `node_modules`。增加依赖后核对构建产物是否仍能独立导入。
|
|
12
|
+
- 联调按作者指南的“源码拓展联调”:通过`vp dlx @bilibili-notify/bn@alpha dev`启动开发宿主,从拓展页挂载已安装依赖的源码工程;BN直接读取src/index.ts并负责监听、局部重载和收尾。拓展工程没有独立dev/start命令,生产才构建;自动重载不会替你启用停用项。
|
|
13
|
+
|
|
14
|
+
## 契约查找
|
|
15
|
+
|
|
16
|
+
| 任务 | 从公开类型开始 |
|
|
17
|
+
| ------------------------------ | ---------------------------------------------------------------- |
|
|
18
|
+
| 搜索创作者、获取资料、轮询订阅 | `SourceDef`、`ExtensionSourceContext` |
|
|
19
|
+
| 作品和直播上报 | `ExtensionPostReport`、`ExtensionLiveSignalReport` |
|
|
20
|
+
| 推送出口、探测和发送 | `PlatformAdapterDef`、`PlatformAdapterContext`、`DeliveryResult` |
|
|
21
|
+
| 设置及设置页动作 | `SettingsReader`、`ExtensionContext`、`ExtensionView` |
|
|
22
|
+
|
|
23
|
+
## 容易误用的边界
|
|
24
|
+
|
|
25
|
+
- `settings.get()` 返回 `Result<{ settings }>`;先处理失败,再读 `result.settings`。
|
|
26
|
+
- 请求、WebSocket、图片、定时器、状态、凭据与日志经 ctx;状态写入也返回 Result,检查写入结果。凭据存 `ctx.secrets`,临时凭据先交 `ctx.redact`。
|
|
27
|
+
- 来源只持有 `externalId`,用上报接口交给宿主;订阅 UUID、规则、路由、发送和历史由宿主负责。上报返回 `void`,不是发送回执;直播 `status` 不触发推送。
|
|
28
|
+
- `stop()` 先停止新工作与上报;宿主随后中止上下文信号并收尾。不要在 `stop()` 里无限等待只能靠后续中止信号结束的任务。
|
|
29
|
+
- 成功用 `ok`,预期失败用 `fail` 和标准失败码。发送结果不明用 `indeterminate`,不能当作未发送而自动重试。
|
|
30
|
+
- 展示文字由 `ctx.i18n.t` 现取;用户输入、创作者原文及上游诊断不改写成翻译键。
|
|
31
|
+
|
|
32
|
+
## 能力缺口
|
|
33
|
+
|
|
34
|
+
当前 SDK 没有的能力先说明具体使用场景和缺少的契约,不借私有 import、直接修改宿主配置或伪造成功结果绕过。拓展清单、SDK 类型和宿主版本需要共同满足兼容性。
|
package/DEVELOPMENT.md
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# 拓展作者指南
|
|
2
|
+
|
|
3
|
+
本指南随SDK的npm包分发,安装后可直接读取,不需要访问BN主仓。公开类型的完整字段和注释在`index.d.mts`,构建辅助在`build.d.mts`。
|
|
4
|
+
|
|
5
|
+
## 版本与工程
|
|
6
|
+
|
|
7
|
+
当前宿主契约是`apiVersion: 1`、`apiRevision: 0`。SDK的npm版本、拓展自己的`version`与这两个契约数字各自独立。历史设计中的“v3”不是当前可安装的清单版本。
|
|
8
|
+
|
|
9
|
+
创建器默认生成独立Git工程、示例来源、完整vp命令、锁文件、提交hooks与GitHub Actions:
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
pnpm create bn-ext@alpha
|
|
13
|
+
# 也可用 npm create bn-ext@alpha
|
|
14
|
+
cd my-extension
|
|
15
|
+
vp run verify
|
|
16
|
+
git add .
|
|
17
|
+
git commit -m "feat: create extension"
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
创建器使用`.node-version`固定Node,`packageManager`固定包管理器,开发依赖也固定版本。后续克隆用`vp install --frozen-lockfile`。若使用`--no-git`,先在工程根初始化自己的Git仓库,再运行`vp hooks enable`;安装过程会避开外层仓库。
|
|
21
|
+
|
|
22
|
+
终端向导依次询问工程目录、拓展ID、GitHub仓库和显示名;回车可用目录和显示名的默认值,输错会在当前项重问。脚本仍可用`vp dlx create-bn-ext@alpha my-extension --id example.demo --repository owner/repository --name "Example"`完整传参;非终端缺参数时直接退出。发布到`latest`后可省略`@alpha`,生成工程的开发命令仍统一用vp。
|
|
23
|
+
|
|
24
|
+
`example.demo`里的`example`是市场命名空间,与GitHub的`owner`无关。第三方清单id必须包含这个命名空间;无点的id留给官方源。作者可选择自己的命名空间,但同一BN实例不允许两个不同来源占用同一命名空间。
|
|
25
|
+
|
|
26
|
+
## 源码拓展联调
|
|
27
|
+
|
|
28
|
+
`create-bn-ext`生成独立拓展;`@bilibili-notify/bn`直接取得并运行宿主成品。工具发布后:
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
vp dlx @bilibili-notify/bn@alpha dev
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
无需检出BN主仓或在隐藏目录构建宿主。正式运行使用`npx @bilibili-notify/bn@alpha web`;alpha发行期间入口带`@alpha`,本地审阅归档不代表已经发布。开发BN本体仍克隆主仓、按主仓指引使用vp。
|
|
35
|
+
|
|
36
|
+
启动器按版本与用途校验、缓存官方宿主。默认数据分别在`~/.bilibili-notify/dev-data`与`~/.bilibili-notify/data`,配置与凭据保存在该数据目录的`bn.config.yaml`。可用`--data-dir <绝对目录>`明确指定;缓存删除不影响持久数据,其他实例的数据需要通过`--data-dir`显式指定。端口可用`--port`调整,离线运行使用`--offline`及已经校验的缓存。
|
|
37
|
+
|
|
38
|
+
拓展工程由创建器安装好依赖;已有工程先运行`vp install --frozen-lockfile`。只需启动BN,打开拓展页,点击“挂载开发拓展”,输入源码工程在BN机器上的绝对路径,再沿原开关启用。BN直接加载`src/index.ts`,负责运行、监听源码与子依赖、局部重载和收尾。工程不需要`dist/`,也没有独立的dev/start命令;`build`与打包用于生产。多个工程可同时挂载,保存一个只重载对应项。
|
|
39
|
+
|
|
40
|
+
源码及其导入依赖、设置规则与清单预检通过后,BN沿原生命周期停止旧实例、启动新版;预检失败会在卡片显示错误,旧实例继续运行,修正后恢复更新。停用项不会因保存而自动启用。需要开发场景时,在清单声明`contributes.devtools: {}`,具名导出`src/devtools/index.ts`中的`devtools()`。解除或关闭BN时停止实例与监听,保留源工程;本次挂载不持久化,下次启动后重新指定。
|
|
41
|
+
|
|
42
|
+
手动挂载存在于源码开发版和`bn dev`专用成品。`bn web`、Docker、桌面及普通生产构建没有此入口;运行期环境变量不能打开它。两个宿主使用相同默认端口时需先停止其中一个;多个拓展应挂到同一台开发BN。
|
|
43
|
+
|
|
44
|
+
## 包与入口
|
|
45
|
+
|
|
46
|
+
根目录保留`extension.json`,`.bn/marketplace.json`只保存作者与仓库配置。发行ZIP包含构建后的`extension.json`、单文件`index.mjs`,可选`README.md`、`CHANGELOG.md`及`locales/<语言码>.json`;开发入口`devtools.mjs`不进入发行ZIP。
|
|
47
|
+
|
|
48
|
+
生产拓展运行时没有自己的`node_modules`。生成配置把SDK与第三方依赖内联到入口;增加依赖后仍需保持单入口、自包含构建。源码开发使用工程已安装的依赖,不能据此假定生产也能读取它们;发布前仍需实际构建与装包校验。原生插件和运行时额外读文件的依赖需要另行设计,不能只凭构建成功判断可运行。
|
|
49
|
+
|
|
50
|
+
SDK有两个入口:
|
|
51
|
+
|
|
52
|
+
| 入口 | 使用处 |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| `@bilibili-notify/extension` | `src/`中的类型、`ok`、`fail`、平台描述辅助 |
|
|
55
|
+
| `@bilibili-notify/extension/build` | 根构建配置中的`extensionPackageFiles`、`manifestWithSettingsFields` |
|
|
56
|
+
|
|
57
|
+
不要从宿主或私有`internal`取模块,也不要把`/build`导入运行源码。模块顶层只定义类型、规则和函数;宿主及构建插件可能多次导入入口,实际副作用在`activate`或来源/适配器的生命周期里开始。
|
|
58
|
+
|
|
59
|
+
## 先做一个订阅来源
|
|
60
|
+
|
|
61
|
+
清单的`contributes.subscription`描述外观、接受的搜索输入与支持的推送特性,运行入口通过`ctx.registerSource(def)`交给宿主。一个拓展只能登记一个订阅来源。
|
|
62
|
+
|
|
63
|
+
```ts
|
|
64
|
+
import type { ExtensionContext, SourceDef } from "@bilibili-notify/extension";
|
|
65
|
+
import { ok } from "@bilibili-notify/extension";
|
|
66
|
+
import { z } from "zod";
|
|
67
|
+
|
|
68
|
+
export const settingsSchema = z.object({
|
|
69
|
+
greeting: z.string().default("Hello").meta({ label: "Greeting" }),
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
export function activate(ctx: ExtensionContext): void {
|
|
73
|
+
const settings = ctx.settings(settingsSchema);
|
|
74
|
+
const source: SourceDef = {
|
|
75
|
+
start() {},
|
|
76
|
+
stop() {},
|
|
77
|
+
async searchCreators(query) {
|
|
78
|
+
const read = settings.get();
|
|
79
|
+
if (!read.ok) return read;
|
|
80
|
+
const name = query.trim();
|
|
81
|
+
return ok({ candidates: name ? [{ externalId: name, name }] : [] });
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
ctx.registerSource(source);
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
`searchCreators`最多返回10个候选;查不到是成功的空数组。可选`fetchProfile(identity, signal)`拉取资料,`fetchLiveStatus(identity, signal)`提供在播状态;声明周期直播时必须实现后者。按每次调用的`signal`尽快中止请求。
|
|
89
|
+
|
|
90
|
+
`start(sourceCtx)`得到运行中的来源上下文:从`subscriptions()`读取自己平台的创作者名单,监听`onSubscriptionsChanged`,以`externalId`上报。`reportProfile`更新资料,`reportPost`交作品,`reportLive`交开播、状态或下播信号;具体载荷使用SDK的`ExtensionPostReport`、`ExtensionLiveSignalReport`等公开类型。直播`status`只更新状态,不触发推送。
|
|
91
|
+
|
|
92
|
+
拓展不持有BN内部订阅id,也不自己发送通知。宿主处理订阅开关、去重、规则、卡片、推送目标和历史。上报返回`void`,不把它当作发送回执;不合规的上报会留在宿主的上报问题记录里。
|
|
93
|
+
|
|
94
|
+
## 设置与副作用
|
|
95
|
+
|
|
96
|
+
设置规则只维护一份。入口导出`settingsSchema`并在`activate`交给`ctx.settings`;生成的构建配置用`extensionPackageFiles`把字段、默认值和说明写进`dist/extension.json`。推送连接的设置规则同理导出`connectionSettingsSchema`,写入`contributes.push.settingsFields`。
|
|
97
|
+
|
|
98
|
+
`settings.get()`返回`Result<{ settings }>`。规则不能通过时处理失败分支,不把错误当空对象。没有配置时,可通过默认值的规则仍可读取;需要主人补字段时返回`not_configured`。当前契约在激活期发现坏设置会拒绝启动;不要捕获后继续伪装成正常运行。
|
|
99
|
+
|
|
100
|
+
| 能力 | 使用方式 |
|
|
101
|
+
| --- | --- |
|
|
102
|
+
| 网络 | `ctx.http.fetch` / `websocket`,接上传入的中止信号;明确不需要浏览器身份及cookie时才选`bare` |
|
|
103
|
+
| 状态 | `ctx.state`存公开业务状态,`ctx.secrets`存凭据;`http.`前缀由宿主保留 |
|
|
104
|
+
| 图片 | 通过`fetchImage`或`storeImage`得到图库引用,再交给上报载荷;不要把任意远端图地址冒充引用 |
|
|
105
|
+
| 定时与收尾 | `ctx.setTimeout` / `setInterval`、`signal`、`onDispose`;保存自己需要等待的任务并收尾 |
|
|
106
|
+
| 诊断 | `ctx.logger`、`reportProblem` / `resolveProblem`;日志的拓展id与级别由宿主处理 |
|
|
107
|
+
| 设置页 | `publishView`、`onAction`、`statusChanged`;动作名先在根清单声明 |
|
|
108
|
+
| 私有服务入口 | `mount` / `onUpgrade`申请宿主分配的入口,使用其实际前缀 |
|
|
109
|
+
|
|
110
|
+
宿主先调用来源/适配器的`stop`,随后中止上下文信号并执行收尾。`stop`先停止派发新工作,避免等待一个只能靠后续宿主中止信号结束的无限任务。长期请求、连接和循环必须能退出。
|
|
111
|
+
|
|
112
|
+
推送适配器通过`ctx.registerPlatformAdapter`登记,并在清单声明`contributes.push`。自己的连接及入站能力由适配器`start`收到的上下文提供;适配器键由宿主填成拓展id。它与订阅来源是两套接口,具体使用`PlatformAdapterDef`及其公开注释。
|
|
113
|
+
|
|
114
|
+
## 失败与译文
|
|
115
|
+
|
|
116
|
+
可预期失败返回`fail(code, message)`,成功返回`ok(...)`。`code`使用SDK的标准失败码;上游自己的错误码放`upstreamCode`。超时、限流、凭据失效与确实不存在分别处理;不要把所有错误都变成“找不到”。发送结果不明用`indeterminate`,不能自动重发。
|
|
117
|
+
|
|
118
|
+
给人看的拓展文字放在`locales/zh-CN.json`、`zh-TW.json`、`en.json`、`ja.json`,使用`ctx.i18n.t(key, values)`现取,不缓存翻译结果。未提供译文的语言按宿主回落规则处理。作者、创作者、输入和上游诊断原文不作为翻译键。
|
|
119
|
+
|
|
120
|
+
## 检查、安装与发布
|
|
121
|
+
|
|
122
|
+
```sh
|
|
123
|
+
vp run lint
|
|
124
|
+
vp run format
|
|
125
|
+
vp run format:check
|
|
126
|
+
vp run typecheck
|
|
127
|
+
vp run test
|
|
128
|
+
vp run build
|
|
129
|
+
vp run pack:extension
|
|
130
|
+
vp run release --tag v0.1.0 --dry-run
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
`verify`串起代码门禁、构建和打包;发布命令还复验Conventional Commits。ZIP与SHA256在`artifacts/`,可在BN拓展页上传安装。SDK版本变化不替你更改清单的宿主契约要求。
|
|
134
|
+
|
|
135
|
+
发布前更新根清单版本,提交修改,再打匹配的`v<版本>`标签并推送到自己的GitHub仓库。生成的Release工作流先以读取权限跑dry-run,成功后发布作业才取得`contents: write`;手动触发默认只验证。完整流程、`.bn/`字段和中断重跑方法见生成工程的README。
|
|
136
|
+
|
|
137
|
+
用户在BN“拓展 → 市场源”输入`owner/repository`或GitHub仓库网址,即定位到固定`bn-marketplace` Release上的`marketplace.json`。只支持公开可读取的索引和ZIP;第三方来源仍需用户信任,SDK和创建器不会赋予官方身份。
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Akokko
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,46 @@
|
|
|
1
|
-
#
|
|
1
|
+
# bilibili-notify extension SDK
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
BN拓展的公开契约与构建辅助。仅支持ESM和Node.js 24及以上;宿主兼容性按拓展清单的`apiVersion` / `apiRevision`判断,与SDK的npm版本号分开。
|
|
4
|
+
|
|
5
|
+
## 入口
|
|
6
|
+
|
|
7
|
+
- `@bilibili-notify/extension`:拓展运行代码使用的类型、`ok()` / `fail()`及中性平台描述辅助。
|
|
8
|
+
- `@bilibili-notify/extension/build`:只给构建配置使用的清单导出与文件复制插件。
|
|
9
|
+
|
|
10
|
+
拓展从SDK这一处获取BN契约,第三方依赖由拓展自己声明。SDK不提供宿主内部模块、MessageBus或订阅配置的写路径;副作用和收尾经宿主交给拓展的ctx执行。
|
|
11
|
+
|
|
12
|
+
```ts
|
|
13
|
+
import type { ExtensionContext, SourceDef } from "@bilibili-notify/extension";
|
|
14
|
+
import { ok } from "@bilibili-notify/extension";
|
|
15
|
+
|
|
16
|
+
const source: SourceDef = {
|
|
17
|
+
start() {},
|
|
18
|
+
stop() {},
|
|
19
|
+
async searchCreators() {
|
|
20
|
+
return ok({ candidates: [] });
|
|
21
|
+
},
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
export function activate(ctx: ExtensionContext) {
|
|
25
|
+
ctx.registerSource(source);
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
完整拓展还需根目录的`extension.json`声明来源外观与能力。`settingsSchema`和`connectionSettingsSchema`可由构建辅助生成清单设置字段。创建工程、当前1/0契约、生命周期、上报、设置、译文和发布见[作者指南](./DEVELOPMENT.md),此文件也包含在npm包里,可在安装目录直接读取。
|
|
30
|
+
|
|
31
|
+
## Agent 开发入口
|
|
32
|
+
|
|
33
|
+
[Agent 契约指引](./AGENT_GUIDE.md)和[开发 skill](./skills/bn-extension-development/SKILL.md)随包提供。创建器会在新工程生成 `AGENTS.md`、`CLAUDE.md`,并为 Codex 与 Claude 准备共享正文的 skill 入口。手工搭建工程时,可把包里的 `skills/bn-extension-development` 复制到项目的 `.agents/skills/`,再将本包的 agent 指引接入已有项目说明。
|
|
34
|
+
|
|
35
|
+
## 源码与发行目录
|
|
36
|
+
|
|
37
|
+
仓内SDK仍是私有workspace包,源码从internal转出唯一契约定义。构建会内联所需实现和类型,并在`lib/`生成独立的公开npm清单、说明和许可证;仓外消费者不需要internal。
|
|
38
|
+
|
|
39
|
+
在主仓根执行:
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
vp run -F @bilibili-notify/extension build
|
|
43
|
+
vp -C packages/extension pm pack --out sdk.tgz
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
`publishConfig.directory`使归档使用`lib/`中的公开清单。SDK与创建器各自的版本保存在对应`package.json`,与主程序的开发占位版本、宿主API档位分开。发行前先完成仓外工程验证,再发布已验过的归档。
|
package/build.d.mts
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/** 入口里这两个名字交的是规则;别的导出构建不看。 */
|
|
2
|
+
interface ExtensionEntrySchemas {
|
|
3
|
+
settingsSchema?: unknown;
|
|
4
|
+
connectionSettingsSchema?: unknown;
|
|
5
|
+
}
|
|
6
|
+
type Json = Record<string, unknown>;
|
|
7
|
+
/**
|
|
8
|
+
* 源码清单 + 入口导出的规则 → 包里那份清单。一栏都不出的不写;导出完过一遍加载时的对表与清单格式,
|
|
9
|
+
* 错在构建时就报、点名到那一格。
|
|
10
|
+
*/
|
|
11
|
+
export declare function manifestWithSettingsFields(source: unknown, entry: ExtensionEntrySchemas): Json;
|
|
12
|
+
/**
|
|
13
|
+
* 打包插件:入口那份打包配置写完 `dist/index.mjs` 之后,把**清单 + 译文**放进 `dist/`,让它原样就是一个
|
|
14
|
+
* 能装的包目录(ADR-0012 决策 8、ADR-0037 决策 14)。清单是源码根的 `extension.json` 加上从规则导出的设置项;
|
|
15
|
+
* `locales/` 有才拷。
|
|
16
|
+
*
|
|
17
|
+
* 规则从刚打好的 `index.mjs` 里取:那份里内联的 zod 就是拓展跑起来用的那份,`.meta()` 读得到。
|
|
18
|
+
* 🔴 拓展的模块顶层不许有副作用(装载器也会反复 import 它,ADR-0012 决策 10),这里 import 一次也一样安全。
|
|
19
|
+
* 监听重打时每次换一个查询串,否则 import 拿到的是第一次的缓存。
|
|
20
|
+
*/
|
|
21
|
+
export declare function extensionPackageFiles(root: string): {
|
|
22
|
+
name: string;
|
|
23
|
+
closeBundle(): Promise<void>;
|
|
24
|
+
};
|
|
25
|
+
export type { ExtensionEntrySchemas };
|