feat: 引入运行时日志体系和存储配置,配置文件改为必填

- 新增 pino/pino-pretty/pino-roll 依赖,实现结构化日志(console pretty + file JSONL rolling)
- 新增 Logger 接口及 PinoLoggerWrapper/ConsoleFallbackLogger/NoopLogger/MemoryLogger 实现
- 新增 src/pino-roll.d.ts 类型声明
- 新增 server.storage.dataDir 配置(默认 ./data,相对路径基于配置文件目录)
- 新增 server.logging 配置(level/console/file/rotation,支持变量引用)
- 配置文件从可选改为必填,parseRuntimeArgs 无参数时抛错
- bootstrap 创建 logger、确保 dataDir、shutdown flush、失败路径 fallback
- startServer 接收 logger 并输出结构化监听日志
- ESLint 新增 no-restricted-syntax 禁止 src/server 直接 console.*(排除 logger.ts)
- 更新 config.example.yaml、README.md、DEVELOPMENT.md 同步配置和日志文档
- 完善测试覆盖:logger、config、schema、bootstrap 共 150 个测试通过
This commit is contained in:
2026-05-25 14:44:37 +08:00
parent c592f2b97c
commit 60d50afad1
22 changed files with 1658 additions and 219 deletions

View File

@@ -37,7 +37,41 @@ describe("Authoring schema 校验", () => {
expect(validate({ variables: { HOST: "127.0.0.1" } })).toBe(true);
});
test("拒绝未知字段 server.host", () => {
test("接受 server.storage.dataDir", () => {
expect(validate({ server: { storage: { dataDir: "./data" } } })).toBe(true);
});
test("接受 server.logging 合法配置", () => {
expect(
validate({
server: {
logging: {
console: { level: "debug" },
file: {
level: "warn",
path: "/var/log/app.log",
rotation: { frequency: "daily", maxFiles: 14, size: "50MB" },
},
level: "info",
},
},
}),
).toBe(true);
});
test("接受 server.logging.level 变量引用", () => {
expect(validate({ server: { logging: { level: "${LOG_LEVEL|info}" } } })).toBe(true);
});
test("拒绝 server.logging 中未知字段", () => {
expect(validate({ server: { logging: { unknownField: true } } })).toBe(false);
});
test("拒绝 server.logging.level 非法枚举值", () => {
expect(validate({ server: { logging: { level: "verbose" } } })).toBe(false);
});
test("拒绝 unknown 字段 server.host", () => {
expect(validate({ server: { host: "127.0.0.1" } })).toBe(false);
const issues = issuesFromAjvErrors(validate.errors ?? [], {});
expect(issues.some((i) => i.code === "unknown-field")).toBe(true);
@@ -82,6 +116,28 @@ describe("Normalized schema 校验", () => {
expect(validate({ server: { listen: { port: "${PORT|3000}" } } })).toBe(false);
});
test("接受 server.storage.dataDir", () => {
expect(validate({ server: { storage: { dataDir: "./data" } } })).toBe(true);
});
test("接受 server.logging 合法配置", () => {
expect(
validate({
server: {
logging: {
console: { level: "debug" },
file: {
level: "warn",
path: "/var/log/app.log",
rotation: { frequency: "daily", maxFiles: 14, size: "50MB" },
},
level: "info",
},
},
}),
).toBe(true);
});
test("接受空对象", () => {
expect(validate({})).toBe(true);
});