bilisum 1.20.0-alpha.4 → 1.20.0

package/README.md

@@ -87,7 +87,24 @@ npm install -g bilisum          # 或 npx bilisum ...
 ```
 
 包内包含构建独立环境所需的 Python 源码；首次执行 `bilisum env setup` 仍要求系统已有 Python 3.12。
+## Agent 视频理解 Skill
 
+安装 CLI 后，可以把随包提供的 `bilisum-video-understanding` skill 安装给 Agent：
+
+```bash
+# 从 GitHub 安装到当前项目或指定 Agent
+npx skills add https://github.com/lycohana/BiliSum --skill bilisum-video-understanding
+
+# 使用 BiliSum CLI 自带的交互式安装器
+bilisum skill install
+
+# 非交互环境下显式指定目标
+bilisum skill install --project
+bilisum skill install --global
+bilisum skill install --path ./agent-skills/bilisum-video-understanding
+```
+
+`bilisum skill install` 在终端中会让你选择当前项目、Codex 全局目录或自定义目录；被 Agent/CI 调用且未指定目标时只打印路径，不会写入文件。已有 skill 需要更新时加 `--force`。安装后，Agent 可以根据用户请求调用 `summarize`、`brief`、`transcribe` 和 `status` 理解视频。
 ## 常用选项
 
 | 选项 | 说明 |
@@ -122,4 +139,5 @@ node "<安装目录>\resources\cli\bin\bilisum.js" summarize "https://..."
 ```bash
 npm test --prefix packages/npx   # node:test 单元测试
 npm run npx:test                 # 版本 + 单测 + npm pack 校验（根目录）
+node packages/npx/bin/bilisum.js --setting  # 可直接从仓库运行；自动使用仓库内 runtime/web 资源
 ```

package/bin/bilisum.js

@@ -18,6 +18,7 @@ const {
 const { UsageError, parseTaskCommandArgs } = require("../lib/args");
 const { formatTasks, emit } = require("../lib/output");
 const { readVersion, locateBilisumDataRoot, findPython, cliHomeDir, ensureCliVenv, cliVenvPython, findSystemPython } = require("../lib/runtime");
+const { runSkillCommand } = require("../lib/skill");
 const { readToken } = require("../lib/token");
 const {
   ensureService,
@@ -56,6 +57,7 @@ function printHelp() {
   console.log("  npx bilisum start [options]                 Start the service");
   console.log("  npx bilisum stop                            Stop the CLI-started BiliSum service");
   console.log("  npx bilisum doctor                          Check environment/service/Python setup");
+  console.log("  npx bilisum skill [path|install]            Install the Agent video-understanding skill");
   console.log("  npx bilisum --version                       Print package version");
   console.log("  npx bilisum release                         Open the latest GitHub release");
   console.log("");
@@ -205,7 +207,8 @@ async function ensureAuthenticatedService(options, log) {
   if (!token) {
     throw new UsageError(
       "无法获取访问令牌：请用 --token 指定，或设置 VIDEO_SUM_ACCESS_TOKEN，" +
-      "或先启动一次桌面端 BiliSum 生成令牌。",
+      "或先启动一次桌面端 BiliSum 生成令牌；没有桌面端时可使用 --environment cli。",
+      { showHelp: false },
     );
   }
   return token;
@@ -647,6 +650,10 @@ async function main() {
       await doctor(args);
       return;
     }
+    if (command === "skill") {
+      await runSkillCommand(args);
+      return;
+    }
     if (command === "help" || command === "-h" || command === "--help") {
       printHelp();
       return;
@@ -667,7 +674,7 @@ async function main() {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(message);
-    if (error instanceof UsageError) {
+    if (error instanceof UsageError && error.showHelp) {
       console.error("");
       printHelp();
     }

package/lib/args.js

@@ -8,9 +8,10 @@ const { locateBilisumDataRoot } = require("./runtime");
 const { ENV_NAMES } = require("./env");
 
 class UsageError extends Error {
-  constructor(message) {
+  constructor(message, { showHelp = true } = {}) {
     super(message);
     this.name = "UsageError";
+    this.showHelp = showHelp;
   }
 }
 

package/lib/runtime.js

@@ -12,7 +12,7 @@
  */
 
 const { existsSync, mkdirSync, readFileSync, writeFileSync } = require("node:fs");
-const { join } = require("node:path");
+const { join, resolve } = require("node:path");
 const { spawnSync } = require("node:child_process");
 
 const PACKAGE_ROOT = join(__dirname, "..");
@@ -139,9 +139,47 @@ function findPython(dataRoot) {
   return findSystemPython();
 }
 
-/** Bundled Python sources inside the npm package (prepack copies these). */
+function isRuntimeSourceRoot(path) {
+  return existsSync(join(path, "apps", "service", "pyproject.toml"));
+}
+
+/**
+ * Python/runtime sources for both supported layouts:
+ * - published package: packages/npx/runtime (created by prepack)
+ * - repository checkout: repository root (runtime is removed by postpack)
+ */
 function runtimeSourceDir() {
-  return join(PACKAGE_ROOT, "runtime");
+  const packagedRoot = join(PACKAGE_ROOT, "runtime");
+  if (isRuntimeSourceRoot(packagedRoot)) {
+    return packagedRoot;
+  }
+
+  const repositoryRoot = resolve(PACKAGE_ROOT, "..", "..");
+  if (isRuntimeSourceRoot(repositoryRoot)) {
+    return repositoryRoot;
+  }
+
+  // Keep the packaged path in error messages for an incomplete npm install.
+  return packagedRoot;
+}
+
+/**
+ * Resolve the installable Agent Skill from the published package or the
+ * repository checkout used during development.
+ */
+function skillSourceDir() {
+  const packagedSkill = join(PACKAGE_ROOT, "skill", "bilisum-video-understanding");
+  if (existsSync(join(packagedSkill, "SKILL.md"))) {
+    return packagedSkill;
+  }
+
+  const repositoryRoot = resolve(PACKAGE_ROOT, "..", "..");
+  const repositorySkill = join(repositoryRoot, ".agents", "skills", "bilisum-video-understanding");
+  if (existsSync(join(repositorySkill, "SKILL.md"))) {
+    return repositorySkill;
+  }
+
+  return packagedSkill;
 }
 
 /** CLI venv lives under CLI_HOME/venv. */
@@ -225,6 +263,7 @@ module.exports = {
   findSystemPython,
   findPython,
   runtimeSourceDir,
+  skillSourceDir,
   cliVenvDir,
   cliVenvPython,
   ensureRuntime,

package/lib/skill.js

@@ -0,0 +1,223 @@
+"use strict";
+
+const { copyFileSync, existsSync, mkdirSync, statSync } = require("node:fs");
+const { homedir } = require("node:os");
+const { createInterface } = require("node:readline/promises");
+const { dirname, join, resolve } = require("node:path");
+
+const { UsageError } = require("./args");
+const { skillSourceDir } = require("./runtime");
+
+const SKILL_NAME = "bilisum-video-understanding";
+const MANAGED_FILES = ["SKILL.md", join("agents", "openai.yaml")];
+
+function projectSkillDir(cwd = process.cwd()) {
+  return resolve(cwd, ".agents", "skills", SKILL_NAME);
+}
+
+function globalSkillDir() {
+  const codexHome = String(process.env.CODEX_HOME || "").trim();
+  const codexRoot = codexHome || join(homedir(), ".codex");
+  return resolve(codexRoot, "skills", SKILL_NAME);
+}
+
+function destinationForMode(mode, cwd = process.cwd()) {
+  if (mode === "project") {
+    return projectSkillDir(cwd);
+  }
+  if (mode === "global") {
+    return globalSkillDir();
+  }
+  throw new UsageError(`未知 skill 安装范围：${mode}`);
+}
+
+function parseInstallArgs(args) {
+  const options = {
+    mode: "",
+    path: "",
+    force: false,
+    help: false,
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--project") {
+      if (options.mode || options.path) {
+        throw new UsageError("--project、--global 与 --path 只能选择一个。");
+      }
+      options.mode = "project";
+    } else if (arg === "--global") {
+      if (options.mode || options.path) {
+        throw new UsageError("--project、--global 与 --path 只能选择一个。");
+      }
+      options.mode = "global";
+    } else if (arg === "--path") {
+      const value = args[++index];
+      if (!value || value.startsWith("--")) {
+        throw new UsageError("--path requires a value");
+      }
+      if (options.mode || options.path) {
+        throw new UsageError("--project、--global 与 --path 只能选择一个。");
+      }
+      options.path = value;
+    } else if (arg === "--force") {
+      options.force = true;
+    } else if (arg === "--help" || arg === "-h") {
+      options.help = true;
+    } else {
+      throw new UsageError(`未知 skill 安装选项：${arg}`);
+    }
+  }
+
+  return options;
+}
+
+function printSkillHelp() {
+  console.log("Usage:");
+  console.log("  bilisum skill path");
+  console.log("  bilisum skill install [--project | --global | --path <dir>] [--force]");
+  console.log("");
+  console.log("Commands:");
+  console.log("  path       Print the bundled video-understanding skill directory");
+  console.log("  install    Install the skill interactively or copy to an explicit target");
+  console.log("");
+  console.log("Install behavior:");
+  console.log("  TTY        Choose project, Codex global, or a custom path interactively");
+  console.log("  non-TTY    Preview source and destinations without writing files");
+  console.log("  --project  Install to ./.agents/skills/ in the current project");
+  console.log("  --global   Install to $CODEX_HOME/skills/ or ~/.codex/skills/");
+  console.log("  --path     Install to the exact directory supplied");
+  console.log("  --force    Overwrite managed files in an existing skill directory");
+}
+
+function assertSkillSource(source) {
+  if (!existsSync(join(source, "SKILL.md"))) {
+    throw new Error(`Bundled BiliSum skill is missing: ${source}`);
+  }
+  for (const relativePath of MANAGED_FILES) {
+    if (!existsSync(join(source, relativePath))) {
+      throw new Error(`Bundled BiliSum skill file is missing: ${join(source, relativePath)}`);
+    }
+  }
+}
+
+function installSkill(target, { source = skillSourceDir(), force = false } = {}) {
+  assertSkillSource(source);
+  const destination = resolve(target);
+  if (existsSync(destination)) {
+    if (!statSync(destination).isDirectory()) {
+      throw new UsageError(`skill 安装目标不是目录：${destination}`);
+    }
+    if (!force) {
+      throw new UsageError(`skill 安装目标已存在：${destination}。如需更新请加 --force。`);
+    }
+  }
+
+  for (const relativePath of MANAGED_FILES) {
+    const targetPath = join(destination, relativePath);
+    mkdirSync(dirname(targetPath), { recursive: true });
+    copyFileSync(join(source, relativePath), targetPath);
+  }
+  return destination;
+}
+
+function printInstallPreview(source) {
+  console.log(`Bundled skill: ${source}`);
+  console.log(`Project target: ${projectSkillDir()}`);
+  console.log(`Global target:  ${globalSkillDir()}`);
+  console.log("");
+  console.log("Non-interactive mode: no files were written.");
+  console.log("Use --project, --global, or --path <dir> to install explicitly.");
+}
+
+async function chooseInteractiveTarget() {
+  const readline = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log("选择 BiliSum 视频理解 skill 的安装位置：");
+    console.log(`  1) 当前项目  ${projectSkillDir()}`);
+    console.log(`  2) Codex 全局 ${globalSkillDir()}`);
+    console.log("  3) 自定义目录");
+    console.log("  q) 取消");
+    const choice = (await readline.question("请输入选项 [1/2/3/q]: ")).trim().toLowerCase();
+    if (choice === "1") {
+      return projectSkillDir();
+    }
+    if (choice === "2") {
+      return globalSkillDir();
+    }
+    if (choice === "3") {
+      const customPath = (await readline.question("请输入 skill 目标目录: ")).trim();
+      if (!customPath) {
+        throw new UsageError("自定义 skill 目录不能为空。");
+      }
+      return resolve(customPath);
+    }
+    if (choice === "q" || choice === "quit" || choice === "cancel") {
+      return null;
+    }
+    throw new UsageError("无效的 skill 安装选项。");
+  } finally {
+    readline.close();
+  }
+}
+
+async function installCommand(args) {
+  const options = parseInstallArgs(args);
+  if (options.help) {
+    printSkillHelp();
+    return;
+  }
+
+  const source = resolve(skillSourceDir());
+  let destination = "";
+  if (options.mode) {
+    destination = destinationForMode(options.mode);
+  } else if (options.path) {
+    destination = resolve(options.path);
+  } else if (process.stdin.isTTY && process.stdout.isTTY) {
+    destination = await chooseInteractiveTarget();
+  } else {
+    printInstallPreview(source);
+    return;
+  }
+
+  if (!destination) {
+    console.log("已取消 skill 安装。");
+    return;
+  }
+
+  const installed = installSkill(destination, { source, force: options.force });
+  console.log(`BiliSum 视频理解 skill 已安装到：${installed}`);
+}
+
+async function runSkillCommand(args) {
+  const [subcommand, ...rest] = args;
+  if (!subcommand || subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
+    printSkillHelp();
+    return;
+  }
+  if (subcommand === "path") {
+    if (rest.length > 0) {
+      throw new UsageError("用法：bilisum skill path");
+    }
+    console.log(resolve(skillSourceDir()));
+    return;
+  }
+  if (subcommand === "install") {
+    await installCommand(rest);
+    return;
+  }
+  throw new UsageError(`未知 skill 子命令：${subcommand}`);
+}
+
+module.exports = {
+  SKILL_NAME,
+  MANAGED_FILES,
+  projectSkillDir,
+  globalSkillDir,
+  destinationForMode,
+  parseInstallArgs,
+  installSkill,
+  printSkillHelp,
+  runSkillCommand,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bilisum",
-  "version": "1.20.0-alpha.4",
+  "version": "1.20.0",
   "description": "BiliSum CLI: control the installed BiliSum app, or run standalone with its own runtime.",
   "bin": {
     "bilisum": "bin/bilisum.js"
@@ -9,6 +9,7 @@
     "bin",
     "lib",
     "runtime",
+    "skill",
     "README.md"
   ],
   "scripts": {

package/runtime/VERSION

@@ -1 +1 @@
-1.20.0-alpha.4
+1.20.0

package/runtime/apps/service/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "video-sum-service"
-version = "1.20.0-alpha.4"
+version = "1.20.0"
 description = "Local backend service for the video summarizer."
 requires-python = ">=3.12"
 dependencies = [

package/runtime/apps/service/src/video_sum_service/app.py

@@ -27,6 +27,7 @@ from video_sum_service import cli_idle
 from video_sum_service.context import CACHE_STATIC_DIR, WEB_STATIC_DIR, access_token_manager, app_info, logger, settings_manager
 from video_sum_service.integrations import probe_asr_connection, probe_llm_connection
 from video_sum_service.repository import SqliteTaskRepository
+from video_sum_service.knowledge.job_coordinator import KnowledgeJobCoordinator
 from video_sum_service.routers.system import router as system_router
 from video_sum_service.routers.knowledge import router as knowledge_router
 from video_sum_service.routers.tasks import router as tasks_router
@@ -113,6 +114,9 @@ async def lifespan(app: FastAPI):
     app.state.task_repository = repository
     app.state.db_connection = connection
     app.state.settings_manager = settings_manager
+    knowledge_job_coordinator = KnowledgeJobCoordinator(repository, current_settings)
+    knowledge_job_coordinator.start()
+    app.state.knowledge_job_coordinator = knowledge_job_coordinator
     initialize_runtime_startup_state(app.state, current_settings)
     cli_idle.start_watchdog(repository)
     start_runtime_startup(app.state, repository, current_settings, recover_incomplete_tasks)
@@ -121,6 +125,7 @@ async def lifespan(app: FastAPI):
         yield
     finally:
         request_runtime_startup_shutdown(app.state)
+        knowledge_job_coordinator.stop()
         startup_thread = getattr(app.state, "runtime_startup_thread", None)
         if startup_thread is not None and startup_thread.is_alive():
             startup_thread.join(timeout=10)