@yunzai-ng/core 0.1.0 → 0.2.0

package/src/kernel/policy.ts

@@ -1,120 +1,120 @@
-/**
- * 模块职责：内核策略 —— 主人、命令前缀、昵称、维护模式
- * 依赖方向：依赖 config/core-config 与类型包；不依赖任何子系统
- * 生命周期：与应用同寿，无需回收
- * 注意事项：所有取值均**即时读取配置**而不缓存，故改完主人号对下一条消息即生效，不必重启。
- *          `ConfigFile.get()` 在配置未变更时返回同一个对象，故"即时读取"只是一次属性访问。
- *
- *          此处刻意**不做鉴权**：`addMaster` 对任何调用方均开放。凭据校验是入口的职责
- *          （WebUI 经由令牌，命令经由 `isMaster`），策略层仅负责"名单的内容"。
- *          两者混于一层将导致"经由修改配置绕过鉴权"这类漏洞。
- */
-import type { PolicyView } from "@yunzai-ng/types"
-import type { CoreConfigHandle } from "../config/core-config.js"
-
-/**
- * 内核策略
- *
- * 实现类型包里的 `PolicyView`（适配器与插件只看得到那个只读接口），
- * 另外多给内核自己用的几项：前缀、昵称、维护模式。
- */
-export class KernelPolicy implements PolicyView {
-  /** 内核配置句柄 */
-  readonly #config: CoreConfigHandle
-
-  /**
-   * @param config 内核配置句柄
-   */
-  constructor(config: CoreConfigHandle) {
-    this.#config = config
-  }
-
-  /** 主人账号列表 */
-  get masters(): readonly string[] {
-    return this.#config.get().bot.masterQQ
-  }
-
-  /**
-   * 命令前缀
-   *
-   * 空数组表示不限制前缀。命令路由据此分桶，见 pipeline 层。
-   */
-  get prefixes(): readonly string[] {
-    return this.#config.get().bot.prefix
-  }
-
-  /** 机器人昵称（群里以昵称开头等同于 @ 机器人） */
-  get nicknames(): readonly string[] {
-    return this.#config.get().bot.nickname
-  }
-
-  /** 是否忽略自身发出的消息 */
-  get ignoreSelf(): boolean {
-    return this.#config.get().bot.ignoreSelf
-  }
-
-  /** 是否处于维护模式（只响应主人） */
-  get maintenance(): boolean {
-    return this.#config.get().bot.onlyMaster
-  }
-
-  /**
-   * 判断是否主人
-   *
-   * 主人名单为空时一律返回 false —— 不存在"没配主人就人人是主人"的默认，
-   * 那会让首次启动的机器人对全世界开放管理命令。
-   * @param uid 用户 id
-   * @returns 是否主人
-   */
-  isMaster(uid: string): boolean {
-    if (uid === "") return false
-    return this.masters.includes(uid)
-  }
-
-  /**
-   * 判断该用户当前是否应被响应
-   *
-   * 维护模式下只放行主人。这是**唯一**的全局开关判定点，管线里不要再各自判一次。
-   * @param uid 用户 id
-   * @returns 是否响应
-   */
-  canRespond(uid: string): boolean {
-    return !this.maintenance || this.isMaster(uid)
-  }
-
-  /**
-   * 添加主人并落盘
-   * @param uid 用户 id（纯数字）
-   * @returns 是否真的添加了（已在名单里时 false）
-   * @throws SchemaError uid 不是合法 id 时；此时配置与文件都不变
-   */
-  async addMaster(uid: string): Promise<boolean> {
-    const current = this.masters
-    if (current.includes(uid)) return false
-    // 整个数组一起写：deepMerge 对数组是整体替换而非追加，
-    // 只传新增项会把原有主人全冲掉
-    await this.#config.patch({ bot: { masterQQ: [...current, uid] } })
-    return true
-  }
-
-  /**
-   * 移除主人并落盘
-   * @param uid 用户 id
-   * @returns 是否真的移除了
-   */
-  async removeMaster(uid: string): Promise<boolean> {
-    const current = this.masters
-    if (!current.includes(uid)) return false
-    await this.#config.patch({ bot: { masterQQ: current.filter(id => id !== uid) } })
-    return true
-  }
-}
-
-/**
- * 创建内核策略
- * @param config 内核配置句柄
- * @returns 内核策略
- */
-export function createPolicy(config: CoreConfigHandle): KernelPolicy {
-  return new KernelPolicy(config)
-}
+/**
+ * 模块职责：内核策略 —— 主人、命令前缀、昵称、维护模式
+ * 依赖方向：依赖 config/core-config 与类型包；不依赖任何子系统
+ * 生命周期：与应用同寿，无需回收
+ * 注意事项：所有取值均**即时读取配置**而不缓存，故改完主人号对下一条消息即生效，不必重启。
+ *          `ConfigFile.get()` 在配置未变更时返回同一个对象，故"即时读取"只是一次属性访问。
+ *
+ *          此处刻意**不做鉴权**：`addMaster` 对任何调用方均开放。凭据校验是入口的职责
+ *          （WebUI 经由令牌，命令经由 `isMaster`），策略层仅负责"名单的内容"。
+ *          两者混于一层将导致"经由修改配置绕过鉴权"这类漏洞。
+ */
+import type { PolicyView } from "@yunzai-ng/types"
+import type { CoreConfigHandle } from "../config/core-config.js"
+
+/**
+ * 内核策略
+ *
+ * 实现类型包里的 `PolicyView`（适配器与插件只看得到那个只读接口），
+ * 另外多给内核自己用的几项：前缀、昵称、维护模式。
+ */
+export class KernelPolicy implements PolicyView {
+  /** 内核配置句柄 */
+  readonly #config: CoreConfigHandle
+
+  /**
+   * @param config 内核配置句柄
+   */
+  constructor(config: CoreConfigHandle) {
+    this.#config = config
+  }
+
+  /** 主人账号列表 */
+  get masters(): readonly string[] {
+    return this.#config.get().bot.masterQQ
+  }
+
+  /**
+   * 命令前缀
+   *
+   * 空数组表示不限制前缀。命令路由据此分桶，见 pipeline 层。
+   */
+  get prefixes(): readonly string[] {
+    return this.#config.get().bot.prefix
+  }
+
+  /** 机器人昵称（群里以昵称开头等同于 @ 机器人） */
+  get nicknames(): readonly string[] {
+    return this.#config.get().bot.nickname
+  }
+
+  /** 是否忽略自身发出的消息 */
+  get ignoreSelf(): boolean {
+    return this.#config.get().bot.ignoreSelf
+  }
+
+  /** 是否处于维护模式（只响应主人） */
+  get maintenance(): boolean {
+    return this.#config.get().bot.onlyMaster
+  }
+
+  /**
+   * 判断是否主人
+   *
+   * 主人名单为空时一律返回 false —— 不存在"没配主人就人人是主人"的默认，
+   * 那会让首次启动的机器人对全世界开放管理命令。
+   * @param uid 用户 id
+   * @returns 是否主人
+   */
+  isMaster(uid: string): boolean {
+    if (uid === "") return false
+    return this.masters.includes(uid)
+  }
+
+  /**
+   * 判断该用户当前是否应被响应
+   *
+   * 维护模式下只放行主人。这是**唯一**的全局开关判定点，管线里不要再各自判一次。
+   * @param uid 用户 id
+   * @returns 是否响应
+   */
+  canRespond(uid: string): boolean {
+    return !this.maintenance || this.isMaster(uid)
+  }
+
+  /**
+   * 添加主人并落盘
+   * @param uid 用户 id（纯数字）
+   * @returns 是否真的添加了（已在名单里时 false）
+   * @throws SchemaError uid 不是合法 id 时；此时配置与文件都不变
+   */
+  async addMaster(uid: string): Promise<boolean> {
+    const current = this.masters
+    if (current.includes(uid)) return false
+    // 整个数组一起写：deepMerge 对数组是整体替换而非追加，
+    // 只传新增项会把原有主人全冲掉
+    await this.#config.patch({ bot: { masterQQ: [...current, uid] } })
+    return true
+  }
+
+  /**
+   * 移除主人并落盘
+   * @param uid 用户 id
+   * @returns 是否真的移除了
+   */
+  async removeMaster(uid: string): Promise<boolean> {
+    const current = this.masters
+    if (!current.includes(uid)) return false
+    await this.#config.patch({ bot: { masterQQ: current.filter(id => id !== uid) } })
+    return true
+  }
+}
+
+/**
+ * 创建内核策略
+ * @param config 内核配置句柄
+ * @returns 内核策略
+ */
+export function createPolicy(config: CoreConfigHandle): KernelPolicy {
+  return new KernelPolicy(config)
+}

package/src/kernel/runtime.ts

@@ -16,7 +16,7 @@
  *
  *          **配置一律取 getter 或取值函数，不缓存快照。** 面板改了 `message.splitLength` 应当自下
  *          一条消息即生效。唯一的例外是 `message.concurrency` —— 信号量容量在创建时固定，这一点
- *          已写进它的配置说明。
+ *          已写进它的配置说明。
  */
 import type { Disposer, Logger } from "@yunzai-ng/types"
 import { AccountManager } from "../adapter/accounts.js"

package/src/pipeline/event.ts

@@ -12,7 +12,7 @@
  *          实例**刻意不 freeze、不 seal**：`EventExtensions` 的正规用法就是插件在事件上挂自有字段。
  *
  *          `e.render()` 依赖「当前执行的是哪个插件」（模板根随插件而定），故该绑定由 dispatch 在调
- *          每个 handler 之前经 `bind()` 替换，而不写进事件的构造参数 —— 一条消息会依次流经多个插件。
+ *          每个 handler 之前经 `bind()` 替换，而不写进事件的构造参数 —— 一条消息会依次流经多个插件。
  */
 import type {
   BotApi,

package/src/platform/paths.test.ts

@@ -0,0 +1,166 @@
+/**
+ * 模块职责：主目录探测顺序的测试
+ * 依赖方向：测试文件，依赖 platform/paths.ts
+ * 生命周期：每个用例一个临时目录，用后即弃
+ * 注意事项：本文件固定的是「数据放在哪里」这一条 —— 它错了的表现不是报错，而是
+ *          使用者的配置、账号与历史记录**看起来凭空消失**（实则仍在旧位置）。
+ *          因此这里既覆盖「新装落在当前目录」，也覆盖「既有安装不被静默搬家」。
+ *
+ *          用 `process.chdir` 而非注入一个 cwd 参数：被测对象正是「读取进程工作目录」
+ *          这一行为，参数化会把它测成一个纯函数，那样恰好绕过了要测的东西。
+ *          vitest 的 forks 池令每个测试文件独占一个进程，chdir 不会波及其他文件。
+ */
+import { mkdtemp, mkdir, writeFile } from "node:fs/promises"
+import { tmpdir } from "node:os"
+import { join, resolve } from "node:path"
+import { afterEach, beforeEach, describe, expect, it } from "vitest"
+import { legacyInstance, resolvePaths } from "./paths.js"
+
+/** 进入用例前的工作目录与环境变量，用后还原 */
+let origin: string
+let env: NodeJS.ProcessEnv
+/** 本用例的临时根目录 */
+let base: string
+
+/**
+ * 推出 `defaultHome()` 在本平台会给出的位置
+ *
+ * 仅 Windows 与 Linux 可经环境变量改写；macOS 固定在 `~/Library`，无从在测试中挪动，
+ * 故相应用例在该平台上跳过。
+ * @param root 充当 `LOCALAPPDATA` / `XDG_DATA_HOME` 的目录
+ * @returns 系统默认位置；本平台无法改写时 undefined
+ */
+function legacyHomeFor(root: string): string | undefined {
+  if (process.platform === "win32") return join(root, "YunzaiNG")
+  if (process.platform === "linux") return join(root, "yunzai-ng")
+  return undefined
+}
+
+beforeEach(async () => {
+  origin = process.cwd()
+  env = { ...process.env }
+  base = await mkdtemp(join(tmpdir(), "yzng-paths-"))
+  // 三者都会参与探测，逐一清掉，否则用例会读到开发机上真实的取值
+  delete process.env["YZNG_HOME"]
+  delete process.env["LOCALAPPDATA"]
+  delete process.env["XDG_DATA_HOME"]
+})
+
+afterEach(() => {
+  process.chdir(origin)
+  process.env = env
+})
+
+describe("主目录探测", () => {
+  it("什么都不给时落在当前目录", async () => {
+    const dir = join(base, "新装")
+    await mkdir(dir)
+    process.chdir(dir)
+
+    // resolve 而非直接比较：macOS 的 /var 是 /private/var 的符号链接，
+    // mkdtemp 给出前者而 cwd 给出后者
+    expect(resolvePaths().home).toBe(resolve(process.cwd()))
+    expect(resolvePaths().config).toBe(join(resolve(process.cwd()), "config"))
+  })
+
+  it("显式参数为相对路径时按当前目录解析", async () => {
+    process.chdir(base)
+    const got = resolvePaths({ home: "./实例甲" }).home
+
+    expect(got).toBe(join(resolve(base), "实例甲"))
+  })
+
+  it("YZNG_HOME 压过当前目录", async () => {
+    const other = join(base, "另一处")
+    await mkdir(other)
+    process.chdir(base)
+    process.env["YZNG_HOME"] = other
+
+    expect(resolvePaths().home).toBe(resolve(other))
+  })
+
+  it("显式参数压过 YZNG_HOME", async () => {
+    const a = join(base, "参数")
+    const b = join(base, "环境变量")
+    await mkdir(a)
+    await mkdir(b)
+    process.chdir(base)
+    process.env["YZNG_HOME"] = b
+
+    expect(resolvePaths({ home: a }).home).toBe(resolve(a))
+  })
+
+  it("便携标记压过当前目录", async () => {
+    const install = join(base, "便携根")
+    // runtime 传 <install>/node_modules/@yunzai-ng/core，与真实安装的层级一致：
+    // findPortableRoot 自该处上溯三级才回到 install
+    const runtime = join(install, "node_modules", "@yunzai-ng", "core")
+    await mkdir(runtime, { recursive: true })
+    await writeFile(join(install, ".portable"), "")
+    const cwd = join(base, "别处")
+    await mkdir(cwd)
+    process.chdir(cwd)
+
+    expect(resolvePaths({ runtime }).home).toBe(resolve(install))
+  })
+})
+
+describe("旧默认位置上的实例", () => {
+  /** 在 `dir` 下造出一个看起来已在用的实例 */
+  const makeInstance = async (dir: string): Promise<void> => {
+    await mkdir(join(dir, "config"), { recursive: true })
+    await writeFile(join(dir, "config", "core.yaml"), "server:\n  port: 2536\n")
+  }
+
+  /**
+   * 把系统默认位置指到临时目录下
+   * @returns 系统默认位置；本平台无法改写时 undefined
+   */
+  const pointLegacyAt = (): string | undefined => {
+    const root = join(base, "系统默认位置")
+    const legacy = legacyHomeFor(root)
+    if (legacy === undefined) return undefined
+    if (process.platform === "win32") process.env["LOCALAPPDATA"] = root
+    else process.env["XDG_DATA_HOME"] = root
+    return legacy
+  }
+
+  it.skipIf(legacyHomeFor("x") === undefined)("旧位置有实例也不影响主目录 —— 不做静默回落", async () => {
+    const legacy = pointLegacyAt()
+    if (legacy === undefined) return
+    await makeInstance(legacy)
+    const cwd = join(base, "空目录")
+    await mkdir(cwd)
+    process.chdir(cwd)
+
+    // 回落会让「默认在当前目录」在任何装过旧版的机器上都不成立
+    expect(resolvePaths().home).toBe(resolve(cwd))
+  })
+
+  it.skipIf(legacyHomeFor("x") === undefined)("legacyInstance 报出旧实例，供 CLI 提示", async () => {
+    const legacy = pointLegacyAt()
+    if (legacy === undefined) return
+    await makeInstance(legacy)
+    const cwd = join(base, "新家")
+    await mkdir(cwd)
+
+    expect(legacyInstance(cwd)).toBe(legacy)
+  })
+
+  it.skipIf(legacyHomeFor("x") === undefined)("旧位置没有实例时不提示", async () => {
+    const legacy = pointLegacyAt()
+    if (legacy === undefined) return
+    // 目录存在但没有 config/：这是"随手建过一个空目录"，不是一个实例
+    await mkdir(legacy, { recursive: true })
+
+    expect(legacyInstance(join(base, "新家"))).toBeUndefined()
+  })
+
+  it.skipIf(legacyHomeFor("x") === undefined)("本次用的就是旧位置时不提示 —— 没有可搬的家", async () => {
+    const legacy = pointLegacyAt()
+    if (legacy === undefined) return
+    await makeInstance(legacy)
+
+    expect(legacyInstance(legacy)).toBeUndefined()
+  })
+})

package/src/platform/paths.ts

@@ -2,13 +2,18 @@
  * 模块职责：确定并创建运行时目录布局
  * 依赖方向：依赖 util/fs、platform/detect
  * 生命周期：启动时解析一次，之后只读
- * 注意事项：全程不使用 `process.cwd()` —— 以 Windows 服务、开机自启或 pm2 启动时
- *          工作目录并非项目目录。启动时把八个目录一次性定死成绝对路径，
- *          其余模块只准通过 `app.paths` 取。
+ * 注意事项：优先级：显式参数 > `YZNG_HOME` > 便携模式标记 > 当前目录。
+ *          启动时把八个目录一次性定死成绝对路径，其余模块只准通过 `app.paths` 取。
  *
- *          优先级：显式参数 > `YZNG_HOME` 环境变量 > 便携模式标记 > 系统默认位置。
- *          便携模式（安装目录下有 `.portable` 文件）让 ZIP 解压即用、
- *          换机拷走整个文件夹就能迁移 —— Windows 用户最常见的诉求。
+ *          **默认落在当前目录**：解压或克隆到一个文件夹、在其中 `yzng init`，数据就在
+ *          眼前，拷走整个文件夹即完成迁移。代价是本模块必须读 `process.cwd()`，而以
+ *          Windows 服务、开机自启或 pm2 启动时工作目录并非项目目录 —— 那些场景必须
+ *          显式给出 `YZNG_HOME` 或启动器的工作目录，否则数据会落在启动器所在之处。
+ *
+ *          0.1.1 及更早的默认位置是系统目录（Windows 的 `%LOCALAPPDATA%\YunzaiNG` 等）。
+ *          此处**不**为其保留静默回落 —— 那会使「默认在当前目录」在任何装过旧版的机器上
+ *          都不成立。改由 {@link legacyInstance} 把旧实例报给 CLI 显式提示：换目录应当是
+ *          使用者看得见的一步，而不是内核悄悄替他挑一个。
  */
 import { homedir } from "node:os"
 import { dirname, isAbsolute, join, resolve } from "node:path"
@@ -63,6 +68,8 @@ function findPortableRoot(runtimeDir: string): string | undefined {
 
 /**
  * 系统默认的数据根目录
+ *
+ * 已不再是缺省取值，仅由 {@link legacyInstance} 用于查找旧实例，见文件头第 3 条。
  * @returns 绝对路径
  */
 function defaultHome(): string {
@@ -85,6 +92,44 @@ function defaultHome(): string {
   return join(home, APP_DIR_NAME_UNIX)
 }
 
+/**
+ * 判断一个目录里是否已有实例
+ *
+ * 以 `config/` 是否存在为准：`ensurePaths` 建的七个目录中只有它必定装着文件
+ * （`ConfigStore` 会把缺省配置落盘），而空的 `data/`、`logs/` 无从区分
+ * 「一个实例」与「随手建的空目录」。
+ * @param dir 待判断的目录
+ * @returns 是否已有实例
+ */
+function hasInstance(dir: string): boolean {
+  return existsSync(join(dir, "config"))
+}
+
+/**
+ * 未显式指定、也无便携标记时的主目录
+ *
+ * 见文件头第 2、3 条。
+ * @returns 绝对路径
+ */
+function autoHome(): string {
+  return process.cwd()
+}
+
+/**
+ * 0.1.1 及更早的默认位置上是否还留着一个实例
+ *
+ * 供 CLI 提示使用：默认位置自 0.2.0 起改为当前目录，装过旧版的机器上那个实例仍在原处，
+ * 而使用者多半以为「配置全没了」。内核只负责报出位置，是否搬家由使用者决定 ——
+ * 自动迁移会在两个目录都有内容时无从判断该以谁为准。
+ * @param home 本次实际使用的主目录
+ * @returns 旧实例所在目录；不存在、或恰好就是本次所用的目录时 undefined
+ */
+export function legacyInstance(home: string): string | undefined {
+  const legacy = defaultHome()
+  if (resolve(legacy) === resolve(home)) return undefined
+  return hasInstance(legacy) ? legacy : undefined
+}
+
 /**
  * 解析目录布局
  *
@@ -97,7 +142,7 @@ export function resolvePaths(opts: ResolvePathsOptions = {}): RuntimePaths {
   const runtime = opts.runtime ? resolve(opts.runtime) : detectRuntimeDir()
 
   const explicit = opts.home ?? process.env.YZNG_HOME
-  const home = explicit ? resolve(process.cwd(), explicit) : (findPortableRoot(runtime) ?? defaultHome())
+  const home = explicit ? resolve(process.cwd(), explicit) : (findPortableRoot(runtime) ?? autoHome())
 
   return Object.freeze({
     home,

package/src/platform/system.ts

@@ -17,7 +17,7 @@
  *          返回空数组：空数组会被前端读成「确实有 0 块显卡」，而 0% 会被读成「GPU 空闲」。
  *
  *          **`nvidia-smi` 不存在这件事只查一次。** 没有 N 卡的机器上每 5 秒 spawn 一个必然
- *          ENOENT 的进程，一天是一万七千次。
+ *          ENOENT 的进程，一天是一万七千次。
  */
 import { constants as fsConstants } from "node:fs"
 import { access, readFile, statfs } from "node:fs/promises"

package/src/plugin/market.ts

@@ -623,7 +623,7 @@ export class PluginMarket {
       await this.#move(root, target)
       this.#deps.logger.info(`插件 ${name}@${version} 已安装至 ${target}`)
       if (needsDependencies) this.#deps.logger.warn(`插件 ${name} 声明了运行时依赖，需在其目录内自行执行包管理器安装`)
-      // 带 `.git` 的目录此后可就地拉取；归档装出来的每次更新都要整目录重下
+      // 带 `.git` 的目录此后可就地拉取；归档装出来的每次更新都要整目录重下
       return { name, dir: target, via, version, needsDependencies, updatable: via === "git" ? "pull" : "reinstall" }
     } finally {
       await rm(staging, { recursive: true, force: true })

package/src/plugin/services.ts

@@ -11,7 +11,7 @@
  *          且无从知道谁在用谁）。
  *
  *          键的所有者被记录下来，插件卸载时它提供的服务一起消失 —— 使用方拿到的是 undefined，
- *          而不是一个指向已卸载模块的失效引用。
+ *          而不是一个指向已卸载模块的失效引用。
  */
 import type { Disposer, DurationLike } from "@yunzai-ng/types"
 import { defer, type Deferred } from "../util/defer.js"

package/src/render/registry.ts

@@ -17,7 +17,7 @@
  *          抛出 —— 只报最后一个的话，真实原因常在第一个里。
  *
  *          **此处不限并发。** 同时渲染多张图会不会耗尽内存，取决于渲染器自己页面池的大小，
- *          只有渲染器插件知道那个数。内核再加一层信号量只会与插件内部的池互相干扰。
+ *          只有渲染器插件知道那个数。内核再加一层信号量只会与插件内部的池互相干扰。
  */
 import type {
   Disposer,

package/src/scheduler/index.ts

@@ -17,7 +17,7 @@
  *          停止等待，并记 error。
  *
  *          **执行出错同样计为已执行。** `lastRun` 在开始时就写，不等成功 —— 隐去失败的那次会让
- *          人误认为调度器没工作。
+ *          人误认为调度器没工作。
  */
 import type { Disposer, Logger, TaskFn, TaskInfo, TaskOptions } from "@yunzai-ng/types"
 import { Cron } from "croner"

package/src/server/auth.ts

@@ -16,7 +16,7 @@
  *          等于把「长度对不对」变成一个旁路信号；先摘要则两边恒为 32 字节。
  *
  *          **没设令牌时只放行本机**，判据是 TCP 对端地址，且服务器强制 `trustProxy: false` ——
- *          否则任何人都能靠一个 `X-Forwarded-For: 127.0.0.1` 把自己伪装成本机。
+ *          否则任何人都能靠一个 `X-Forwarded-For: 127.0.0.1` 把自己伪装成本机。
  */
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto"
 

package/src/server/files.ts

@@ -13,7 +13,7 @@
  *          这类服务器最致命的漏洞，值得两道锁。
  *
  *          **本文件不定位面板前端产物。** 面板是插件，产物目录由它自己解析并经 `ctx.panel()` 传入
- *          —— 内核一旦掌握前端的目录约定，「替换面板」就退化成必须改内核。
+ *          —— 内核一旦掌握前端的目录约定，「替换面板」就退化成必须改内核。
  */
 import { isDirectory, isFile, safeJoin } from "../util/fs.js"
 

package/src/server/index.ts

@@ -17,7 +17,7 @@
  *          等进了 `wsHandler` 再关连接，对方只看到一次没有理由的断线。
  *
  *          **静态资源刻意不鉴权。** 浏览器请求文档时设不了请求头，要鉴权就只剩 Cookie 一条路，
- *          那会把 auth.ts 刻意避开的 CSRF 面重新引进来。HTML/JS 本身不是机密，要保护的是 API。
+ *          那会把 auth.ts 刻意避开的 CSRF 面重新引进来。HTML/JS 本身不是机密，要保护的是 API。
  */
 import { isAbsolute } from "node:path"
 import type { IncomingMessage } from "node:http"