@koishi-ce/koishi 1.0.6 → 1.0.8

package/README.md

@@ -33,11 +33,11 @@ bunx create-koishi-ce my-app
 | `--log-level [level]` | 2 | 日志等级 |
 | `--log-time [format]` | - | 日志时间戳格式 |
 
-不带子命令运行 `koishi` 时输出帮助。
+不带子命令运行 `koishi` 时输出帮助。交互终端中启动时还会打印 Koishi-CE 启动横幅与字符画（仅 TTY，输出被重定向时不打印）。
 
 ## 守护进程机制
 
-`koishi start` 是守护父进程：以 Bun.spawn 拉起工作进程并保持 IPC 心跳，心跳超时强制终止。退出码约定：51 = 工作进程请求整体重启（配置文件或框架依赖变更），52 = 请求退出。工作进程内由 loader 读取配置、预检服务器端口（被占则干净退出）、创建应用并挂载 daemon 插件。
+`koishi start` 是守护父进程：以 Bun.spawn 拉起工作进程，工作进程运行时崩溃后默认自动重启；IPC 心跳为可选配置（默认关闭，开启后超时未收到心跳将强制终止工作进程）。退出码约定：51 = 工作进程请求整体重启（配置文件或框架依赖变更），52 = 请求退出。工作进程内由 loader 读取配置、预检服务器端口（被占则干净退出）、创建应用并挂载 daemon 插件。
 
 ## 编程式用法
 
@@ -72,9 +72,9 @@ bunx create-koishi-ce my-app
 
 ## CLI
 
-`koishi start [file]` (alias `run`) starts the app, with options `--debug [namespace]`, `--log-level [level]` (default 2) and `--log-time [format]`. Running `koishi` without a subcommand prints help.
+`koishi start [file]` (alias `run`) starts the app, with options `--debug [namespace]`, `--log-level [level]` (default 2) and `--log-time [format]`. Running `koishi` without a subcommand prints help. When started in an interactive terminal, a Koishi-CE startup banner with ASCII art is printed (TTY only, suppressed when output is redirected).
 
-The `start` command is a daemon parent: it spawns the worker via Bun.spawn with IPC heartbeats. Exit code 51 asks for a full restart, 52 asks to quit. The worker reads the config through the loader, prechecks server ports, creates the app and mounts the daemon plugin.
+The `start` command is a daemon parent: it spawns the worker via Bun.spawn and restarts it by default after runtime crashes; IPC heartbeats are optional (off by default — once enabled, a missed heartbeat force-kills the worker). Exit code 51 asks for a full restart, 52 asks to quit. The worker reads the config through the loader, prechecks server ports, creates the app and mounts the daemon plugin.
 
 ## Programmatic usage
 

package/lib/cli/index.mjs

@@ -7,7 +7,7 @@ var package_default = {
 	name: "@koishi-ce/koishi",
 	type: "module",
 	description: "Cross-Platform Chatbot Framework Made with Love",
-	version: "1.0.6",
+	version: "1.0.8",
 	main: "lib/index.mjs",
 	module: "lib/index.mjs",
 	types: "lib/index.d.ts",

package/lib/worker/index.d.ts

@@ -2,7 +2,9 @@ import { t as Loader } from "../index-B9rkkFue.js";
 import { Context, Dict, Schema } from "@koishi-ce/core";
 export * from "@koishi-ce/core";
 export * from "@koishi-ce/loader";
-//#region src/worker/daemon.d.ts
+declare namespace daemon_d_exports {
+  export { Config$1 as Config, apply, name };
+}
 /** 守护设置 */
 interface Config$1 {
   /** 运行时崩溃后是否自动重启 */
@@ -13,8 +15,11 @@ interface Config$1 {
   heartbeatTimeout?: number;
 }
 declare const Config$1: Schema<Config$1>;
-//#endregion
-//#region src/worker/logger.d.ts
+declare const name = "daemon";
+declare function apply(ctx: Context, config?: Config$1): void;
+declare namespace logger_d_exports {
+  export { Config, prepare };
+}
 /**
  * 配置文件形态的日志等级表。
  * 与 @koishi-ce/utils 中的实现略有差异：此处不强制用户提供 base 等级，
@@ -37,6 +42,15 @@ interface Config {
   showTime?: string | boolean;
 }
 declare const Config: Schema<Config>;
+/**
+ * 在应用启动前应用日志配置。
+ *
+ * 处理顺序：配置文件中的等级表 → 时间格式与时间差显示 → CLI 环境变量覆盖 →
+ * 补全所有分组的 base 等级 → KOISHI_DEBUG 指定的命名空间设为 DEBUG 级。
+ *
+ * @param config 来自配置文件 logger 节点的设置
+ */
+declare function prepare(config?: Config): void;
 //#endregion
 //#region src/worker/index.d.ts
 declare module "@koishi-ce/core" {

package/lib/worker/index.mjs

@@ -2,6 +2,7 @@ import { t as __exportAll } from "../rolldown-runtime-BBjsoOtd.mjs";
 import { t as Loader } from "../src-BnUZO8R-.mjs";
 import { Context, Logger, Schema, Time, defineProperty } from "@koishi-ce/core";
 import Loader$1, { resolvePlugin } from "@koishi-ce/loader";
+import pc from "picocolors";
 import { existsSync, readFileSync } from "node:fs";
 import net from "node:net";
 import { dirname, resolve } from "node:path";
@@ -210,12 +211,31 @@ async function checkPorts(plugins, baseDir) {
 		process.exit(1);
 	}
 }
+/** 启动字符画（ANSI Shadow 字体的 KOISHI CE） */
+const banner = [
+	"██╗  ██╗ ██████╗ ██╗███████╗██╗  ██╗██╗       ██████╗███████╗",
+	"██║ ██╔╝██╔═══██╗██║██╔════╝██║  ██║██║      ██╔════╝██╔════╝",
+	"█████╔╝ ██║   ██║██║███████╗███████║██║█████╗██║     █████╗",
+	"██╔═██╗ ██║   ██║██║╚════██║██╔══██║██║╚════╝██║     ██╔══╝",
+	"██║  ██╗╚██████╔╝██║███████║██║  ██║██║      ╚██████╗███████╗",
+	"╚═╝  ╚═╝ ╚═════╝ ╚═╝╚══════╝╚═╝  ╚═╝╚═╝       ╚═════╝╚══════╝"
+].join("\n");
+/**
+* 输出启动字符画。直走 stdout 而非 Logger 通道（多行消息会被日志器
+* 统一缩进、首行混入时间戳前缀，破坏字符画对齐），因此以 isTTY 收敛：
+* 测试与重定向/CI 等非交互环境自动跳过，不产生输出噪音。
+*/
+function printBanner() {
+	if (!process.stdout.isTTY) return;
+	console.log(pc.white(banner));
+}
 /** 应用启动主流程 */
 async function start() {
 	const loader = new Loader$1();
 	await loader.init(process.env["KOISHI_CONFIG_FILE"]);
 	const config = await loader.readConfig(true);
 	prepare(config.logger);
+	printBanner();
 	await checkPorts(config.plugins ?? {}, loader.baseDir);
 	if (config.timezoneOffset !== void 0) Time.setTimezoneOffset(config.timezoneOffset);
 	if (config.stackTraceLimit !== void 0) Error.stackTraceLimit = config.stackTraceLimit;

package/package.json

@@ -2,7 +2,7 @@
     "name": "@koishi-ce/koishi",
     "type": "module",
     "description": "Cross-Platform Chatbot Framework Made with Love",
-    "version": "1.0.6",
+    "version": "1.0.8",
     "main": "lib/index.mjs",
     "module": "lib/index.mjs",
     "types": "lib/index.d.ts",
@@ -61,10 +61,10 @@
         }
     },
     "dependencies": {
-        "@koishi-ce/core": "^1.0.1",
-        "@koishi-ce/loader": "^1.0.5",
-        "@koishi-ce/plugin-http": "^1.0.0",
-        "@koishi-ce/plugin-proxy-agent": "^1.0.0",
+        "@koishi-ce/core": "^1.1.0",
+        "@koishi-ce/loader": "^1.0.6",
+        "@koishi-ce/plugin-http": "^1.0.1",
+        "@koishi-ce/plugin-proxy-agent": "^1.0.1",
         "@koishi-ce/plugin-server": "^1.0.1",
         "@koishi-ce/utils": "^1.0.0",
         "cac": "^7.0.0",

package/src/worker/index.ts

@@ -22,6 +22,7 @@ import {
 	Time,
 } from "@koishi-ce/core";
 import Loader, { resolvePlugin } from "@koishi-ce/loader";
+import pc from "picocolors";
 import * as daemon from "./daemon.ts";
 import * as logger from "./logger.ts";
 
@@ -200,12 +201,33 @@ async function checkPorts(plugins: Dict, baseDir: string) {
 	}
 }
 
+/** 启动字符画（ANSI Shadow 字体的 KOISHI CE） */
+const banner = [
+	"██╗  ██╗ ██████╗ ██╗███████╗██╗  ██╗██╗       ██████╗███████╗",
+	"██║ ██╔╝██╔═══██╗██║██╔════╝██║  ██║██║      ██╔════╝██╔════╝",
+	"█████╔╝ ██║   ██║██║███████╗███████║██║█████╗██║     █████╗",
+	"██╔═██╗ ██║   ██║██║╚════██║██╔══██║██║╚════╝██║     ██╔══╝",
+	"██║  ██╗╚██████╔╝██║███████║██║  ██║██║      ╚██████╗███████╗",
+	"╚═╝  ╚═╝ ╚═════╝ ╚═╝╚══════╝╚═╝  ╚═╝╚═╝       ╚═════╝╚══════╝",
+].join("\n");
+
+/**
+ * 输出启动字符画。直走 stdout 而非 Logger 通道（多行消息会被日志器
+ * 统一缩进、首行混入时间戳前缀，破坏字符画对齐），因此以 isTTY 收敛：
+ * 测试与重定向/CI 等非交互环境自动跳过，不产生输出噪音。
+ */
+function printBanner() {
+	if (!process.stdout.isTTY) return;
+	console.log(pc.white(banner));
+}
+
 /** 应用启动主流程 */
 async function start() {
 	const loader = new Loader();
 	await loader.init(process.env["KOISHI_CONFIG_FILE"]);
 	const config = await loader.readConfig(true);
 	logger.prepare(config.logger);
+	printBanner();
 
 	// 端口预检须在日志配置生效后、应用创建前执行
 	await checkPorts(config.plugins ?? {}, loader.baseDir);