koishi-plugin-kkk 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 更新日志
 
+## 1.0.1
+
+### 修复
+- 生产环境下 `/kkk` 配置面板报「assets/web/index.html 缺失」：插件根目录不再只按 `lib/` 的位置推断，
+  改为从入口所在目录逐级向上找带 `assets/web/index.html` 的那一层（并兜底按包名解析、cwd / cwd/node_modules），
+  启动日志里会打印解析结果，找不到时会给出警告。
+- 配置面板不再强制登录：生产环境装了 auth 插件时，面板原本要求先登录 Koishi 控制台，现在默认免登录；
+  需要恢复登录校验时把配置项 `webUiAuth` 打开即可。
+
 ## 1.0.0
 
 首个公开版本：**karin-plugin-kkk 的 Koishi 移植版**，把上游的解析 / 推送 / 面板能力完整搬到 Koishi 生态。

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="./assets/readme/banner-d-render-gallery.svg" width="100%" alt="koishi-plugin-kkk 的视频详情、抖音评论、B站动态推送和解析统计动画成果墙">
+  <img src="./banner-d-render-gallery.svg" width="100%" alt="koishi-plugin-kkk 的视频详情、抖音评论、B站动态推送和解析统计动画成果墙">
 </p>
 
 <p align="center">

package/lib/index.js

@@ -60,8 +60,42 @@ const webui_1 = require("./webui");
 const configBridge_1 = require("./configBridge");
 const QqCardResolve_1 = require("./karin/module/utils/QqCardResolve");
 const schema_1 = require("./schema");
-/** 插件根目录（编译产物在 lib/ 下，向上一级即包根） */
-const pluginRootDir = node_path_1.default.resolve(__dirname, '..');
+/**
+ * 插件根目录。
+ *
+ * 通常编译产物在 `lib/index.js`，向上一级就是包根；但生产环境不一定按这个位置加载
+ * （打包 / 转译缓存 / pnpm 的不同布局 / 直接跑源码都会让 `__dirname` 落到别处），
+ * 一旦猜错，`/kkk` 面板就会报「assets/web/index.html 缺失」。
+ *
+ * 所以这里从 `__dirname` 逐级向上找，直到找到带 `assets/web/index.html` 的那一层，
+ * 再兜底试「按包名解析」和「cwd / cwd/node_modules」。
+ */
+function resolvePluginRoot() {
+    const marker = node_path_1.default.join('assets', 'web', 'index.html');
+    const candidates = [];
+    let dir = __dirname;
+    for (let i = 0; i < 6; i++) {
+        candidates.push(dir);
+        const parent = node_path_1.default.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    try {
+        candidates.push(node_path_1.default.dirname(require.resolve('koishi-plugin-kkk/package.json')));
+    }
+    catch { /* 本地链接安装时解析不到，正常 */ }
+    candidates.push(process.cwd(), node_path_1.default.join(process.cwd(), 'node_modules', 'koishi-plugin-kkk'));
+    for (const candidate of candidates) {
+        try {
+            if (node_fs_1.default.existsSync(node_path_1.default.join(candidate, marker)))
+                return candidate;
+        }
+        catch { /* 权限之类的问题跳过 */ }
+    }
+    return node_path_1.default.resolve(__dirname, '..');
+}
+const pluginRootDir = resolvePluginRoot();
 /**
  * 网络兜底：优先 IPv4。
  *
@@ -98,7 +132,7 @@ exports.inject = {
  * 这里能改的项会被写回数据目录的 config.json（见 configBridge），在那之前 config.json 仍是权威来源。
  */
 /** 摊平后由「Koishi 原生设置」分组提供的字段 */
-const NATIVE_KEYS = ['masters', 'dataPath', 'debug', 'autoParse'];
+const NATIVE_KEYS = ['masters', 'dataPath', 'debug', 'autoParse', 'webUiAuth'];
 exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
         webuiGuide: koishi_1.Schema.const('').description('**QQ 相关的开关都在下面的「QQ 适配器」分组里**（解析面板、画质档、图片切片、番剧选集表格、卡片识别）。' +
@@ -109,6 +143,7 @@ exports.Config = koishi_1.Schema.intersect([
             dataPath: koishi_1.Schema.string().default('data').description('数据目录：配置、数据库、临时文件都放在这里'),
             debug: koishi_1.Schema.boolean().default(false).description('在日志里输出调试信息，排查问题时才需要打开'),
             autoParse: koishi_1.Schema.boolean().default(true).description('群里有人发链接（或回复一条带链接的消息）就自动解析，不用打指令'),
+            webUiAuth: koishi_1.Schema.boolean().default(false).description('配置面板 /kkk 是否要求先登录 Koishi 控制台。默认关（免登录，打开就能改配置）；装了 auth 插件且希望面板也走登录时再打开'),
         }).collapse().description('Koishi 原生设置（一般不用改，已折叠）'),
     }),
     koishi_1.Schema.object({
@@ -612,6 +647,10 @@ function registerCommands(ctx, logger, autoParse) {
 async function apply(ctx, rawConfig) {
     const logger = ctx.logger('kkk');
     (0, logger_1.setLogger)(logger);
+    {
+        const ok = node_fs_1.default.existsSync(node_path_1.default.join(pluginRootDir, 'assets', 'web', 'index.html'));
+        logger.info('[kkk] 插件根目录: ' + pluginRootDir + (ok ? '' : '（警告：这里没有 assets/web/index.html，/kkk 面板会打不开）'));
+    }
     /**
      * 控制台表单把选项分成两个折叠组（「QQ 适配器」和「Koishi 原生设置」），
      * 这里统一摊平回顶层 —— 代码里照旧读 config.qqPanel / config.sliceImageOnDemand 等。

package/lib/webui.js

@@ -98,8 +98,13 @@ function registerWebUi({ ctx, config, rawConfig, logger, pluginRoot }) {
         return Buffer.from(text.includes('</body>') ? text.replace('</body>', autoLoginScript + '</body>') : text + autoLoginScript);
     };
     /* ---------------- 登录策略 ---------------- */
-    /** 只有启用 auth 插件才需要登录；当前部署是关的 → 免登录 */
-    const authRequired = () => !!ctx.get?.('auth');
+    /**
+     * 面板（/kkk）是否需要登录。
+     *
+     * 默认**免登录**：装了 auth 插件的生产环境也会直接进界面（否则用户要先登控制台才能改配置，很别扭）。
+     * 要恢复成「必须登录控制台」，把配置里的 `webUiAuth` 打开即可。
+     */
+    const authRequired = () => config?.webUiAuth === true;
     /** 控制台登录态：auth 插件的 cookie 形如 name=id:token，用它查 token 表 */
     const consoleAuthed = async (request) => {
         if (!authRequired())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -51,9 +51,9 @@
     "koishi": "^4.18.7"
   },
   "dependencies": {
+    "@icons-pack/react-simple-icons": "^13.15.1",
     "@ikenxuan/amagi": "6.6.0",
     "@ikenxuan/qrcode": "1.5.0",
-    "@icons-pack/react-simple-icons": "^13.15.1",
     "@outpacelabs/avatars": "0.6.0",
     "@phosphor-icons/react": "^2.1.10",
     "@thesvg/icons": "^3.3.7",

package/src/index.ts

@@ -23,8 +23,40 @@ import { applyUpstreamOverrides } from './configBridge'
 import { resolveQqCardContent } from './karin/module/utils/QqCardResolve'
 import { buildUpstreamSchema } from './schema'
 
-/** 插件根目录（编译产物在 lib/ 下，向上一级即包根） */
-const pluginRootDir = path.resolve(__dirname, '..')
+/**
+ * 插件根目录。
+ *
+ * 通常编译产物在 `lib/index.js`，向上一级就是包根；但生产环境不一定按这个位置加载
+ * （打包 / 转译缓存 / pnpm 的不同布局 / 直接跑源码都会让 `__dirname` 落到别处），
+ * 一旦猜错，`/kkk` 面板就会报「assets/web/index.html 缺失」。
+ *
+ * 所以这里从 `__dirname` 逐级向上找，直到找到带 `assets/web/index.html` 的那一层，
+ * 再兜底试「按包名解析」和「cwd / cwd/node_modules」。
+ */
+function resolvePluginRoot (): string {
+  const marker = path.join('assets', 'web', 'index.html')
+  const candidates: string[] = []
+  let dir = __dirname
+  for (let i = 0; i < 6; i++) {
+    candidates.push(dir)
+    const parent = path.dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  try {
+    candidates.push(path.dirname(require.resolve('koishi-plugin-kkk/package.json')))
+  } catch { /* 本地链接安装时解析不到，正常 */ }
+  candidates.push(process.cwd(), path.join(process.cwd(), 'node_modules', 'koishi-plugin-kkk'))
+
+  for (const candidate of candidates) {
+    try {
+      if (fs.existsSync(path.join(candidate, marker))) return candidate
+    } catch { /* 权限之类的问题跳过 */ }
+  }
+  return path.resolve(__dirname, '..')
+}
+
+const pluginRootDir = resolvePluginRoot()
 
 /**
  * 网络兜底：优先 IPv4。
@@ -63,6 +95,8 @@ export interface Config {
   debug: boolean
   /** 消息里的链接自动解析 */
   autoParse: boolean
+  /** 配置面板（/kkk）是否要求先登录 Koishi 控制台（默认关，即免登录） */
+  webUiAuth: boolean
   /** QQ 平台解析前先发交互面板（Markdown + 按钮）让用户选解析内容和画质 */
   qqPanel: boolean
   /** QQ 面板里隐藏超过该体积（MB）的画质按钮 */
@@ -91,7 +125,7 @@ export interface Config {
  * 这里能改的项会被写回数据目录的 config.json（见 configBridge），在那之前 config.json 仍是权威来源。
  */
 /** 摊平后由「Koishi 原生设置」分组提供的字段 */
-const NATIVE_KEYS = ['masters', 'dataPath', 'debug', 'autoParse']
+const NATIVE_KEYS = ['masters', 'dataPath', 'debug', 'autoParse', 'webUiAuth']
 
 export const Config: Schema<Config> = Schema.intersect([
   Schema.object({
@@ -105,6 +139,7 @@ export const Config: Schema<Config> = Schema.intersect([
     dataPath: Schema.string().default('data').description('数据目录：配置、数据库、临时文件都放在这里'),
     debug: Schema.boolean().default(false).description('在日志里输出调试信息，排查问题时才需要打开'),
     autoParse: Schema.boolean().default(true).description('群里有人发链接（或回复一条带链接的消息）就自动解析，不用打指令'),
+    webUiAuth: Schema.boolean().default(false).description('配置面板 /kkk 是否要求先登录 Koishi 控制台。默认关（免登录，打开就能改配置）；装了 auth 插件且希望面板也走登录时再打开'),
     }).collapse().description('Koishi 原生设置（一般不用改，已折叠）'),
   }),
   Schema.object({
@@ -612,6 +647,10 @@ function registerCommands (
 export async function apply (ctx: Context, rawConfig: Config) {
   const logger = ctx.logger('kkk')
   setLogger(logger)
+  {
+    const ok = fs.existsSync(path.join(pluginRootDir, 'assets', 'web', 'index.html'))
+    logger.info('[kkk] 插件根目录: ' + pluginRootDir + (ok ? '' : '（警告：这里没有 assets/web/index.html，/kkk 面板会打不开）'))
+  }
 
   /**
    * 控制台表单把选项分成两个折叠组（「QQ 适配器」和「Koishi 原生设置」），

package/src/webui.ts

@@ -107,8 +107,13 @@ export function registerWebUi ({ ctx, config, rawConfig, logger, pluginRoot }: W
 
   /* ---------------- 登录策略 ---------------- */
 
-  /** 只有启用 auth 插件才需要登录；当前部署是关的 → 免登录 */
-  const authRequired = () => !!(ctx as any).get?.('auth')
+  /**
+   * 面板（/kkk）是否需要登录。
+   *
+   * 默认**免登录**：装了 auth 插件的生产环境也会直接进界面（否则用户要先登控制台才能改配置，很别扭）。
+   * 要恢复成「必须登录控制台」，把配置里的 `webUiAuth` 打开即可。
+   */
+  const authRequired = () => (config as any)?.webUiAuth === true
 
   /** 控制台登录态：auth 插件的 cookie 形如 name=id:token，用它查 token 表 */
   const consoleAuthed = async (request: any): Promise<boolean> => {