日志模块拆分 category 参数:log.xxx(category, ...args) 输出 timestamp [level] [category]

- log.js 签名改为 log.xxx(category, ...args);头三段为时间戳 [level] [category],后续参数(含 Error/对象)透传 console 走 util.format
- 所有调用点迁移:从 log.info('[msg] xxx') → log.info('msg', 'xxx');server 启动行无前缀,统一归入 startup
- 实测输出:2026-09-05 09:27:12.068 [debug] [sse] task-20260904-012 event: ping
This commit is contained in:
2026-09-05 09:27:23 +08:00
parent 3538526c41
commit 734039d917
12 changed files with 67 additions and 61 deletions
+2 -2
View File
@@ -97,7 +97,7 @@ function createAuth(cfg) {
const secret = (cfg.auth.secret && String(cfg.auth.secret)) || crypto.randomBytes(32).toString('hex');
if (!cfg.auth.secret) {
log.warn('[auth] 未配置 auth.secret,已使用随机密钥:进程重启后所有登录态失效');
log.warn('auth', '未配置 auth.secret,已使用随机密钥:进程重启后所有登录态失效');
}
const ttlMs = Number(cfg.auth.ttl_ms) || DEFAULT_TTL_MS;
const validUsers = new Map(users.map(u => [String(u.user), String(u.password)]));
@@ -174,7 +174,7 @@ function createAuth(cfg) {
// 内存同步:users 与 engine.cfg 是同一对象,Basic 认证实时生效;cookie 登录查 validUsers
users[idx].password = newP;
validUsers.set(me, newP);
log.info('[auth] 用户 ' + me + ' 修改了密码');
log.info('auth', '用户 ' + me + ' 修改了密码');
res.json({ ok: true });
} catch (e) {
res.status(500).json({ error: String(e && e.message || e) });
+2 -2
View File
@@ -122,7 +122,7 @@ function parseAndValidate(rawText, configPath) {
// 每项继承所属平台的 url/type 与 key 的 api_key/concurrency,并携带位置下标(前端 PATCH 定位用)。
if ((!Array.isArray(raw.platforms) || !raw.platforms.length) && Array.isArray(raw.models) && raw.models.length) {
raw = Object.assign({}, raw, { platforms: migrateLegacyModels(raw.models) });
log.info('[config] 检测到旧配置 models[] 扁平格式,已自动迁移为 platforms 层级;建议改写 config.yml 为 platforms 格式');
log.info('config', '检测到旧配置 models[] 扁平格式,已自动迁移为 platforms 层级;建议改写 config.yml 为 platforms 格式');
}
if (!Array.isArray(raw.platforms) || !raw.platforms.length) {
throw new Error('配置缺少 platforms:至少需要一个平台 {name, url, keys:[{api_key, models:[{id}]}]}')
@@ -181,7 +181,7 @@ function parseAndValidate(rawText, configPath) {
url: ws.url,
headers: ws.authorization ? { Authorization: ws.authorization } : {},
}];
log.info('[config] 检测到旧配置 web_search.*,已自动转为一条 mcp_servers;建议更新 config.yml 为 mcp_servers 格式');
log.info('config', '检测到旧配置 web_search.*,已自动转为一条 mcp_servers;建议更新 config.yml 为 mcp_servers 格式');
}
// MCP 服务规范化:url 必填;name 缺省取主机名首段;headers 为普通键值对象(如 Authorization)
+21 -21
View File
@@ -92,7 +92,7 @@ function saveMessage(sessionId, msg) {
}
toolDesc = ',工具调用:' + [...counts].map(([name, n]) => (n > 1 ? name + '×' + n : name)).join('、');
}
log.info('[msg] ' + sessionId + ' AI 回复:文本 ' + String(msg.content || '').length + ' 字' + toolDesc);
log.info('msg', sessionId + ' AI 回复:文本 ' + String(msg.content || '').length + ' 字' + toolDesc);
}
return info.lastInsertRowid;
}
@@ -240,7 +240,7 @@ function bindToSession(sessionId, modelId) {
emitStatus(sessionId);
// 手动选好模型后立即注入/刷新会话上下文(换绑时更新为当前模型,避免陈旧信息)
ensureSessionContext(sessionId);
log.info('[model] ' + sessionId + ' 手动绑定模型 ' + model.id);
log.info('model', sessionId + ' 手动绑定模型 ' + model.id);
if (pending) runLoop(sessionId);
return { ok: true, model_id: model.id };
}
@@ -386,7 +386,7 @@ async function runLoop(sessionId) {
try {
await runLoopInner(sessionId, run);
} catch (err) {
log.error('[engine] runLoop ' + sessionId + ' 异常:', err && err.stack || err);
log.error('engine', 'runLoop ' + sessionId + ' 异常:', err && err.stack || err);
bus.emit(sessionId, 'error', { message: String(err && err.message || err) });
} finally {
run.looping = false;
@@ -458,7 +458,7 @@ async function runLoopInner(sessionId, run) {
for (const tc of result.tool_calls) {
const fixed = unwrapToolArgs(tools, tc.name, tc.arguments);
if (fixed) {
log.info('[tool] ' + sessionId + ' ' + tc.name + ' 参数包裹外层已自动解包');
log.debug('tool', sessionId + ' ' + tc.name + ' 参数包裹外层已自动解包');
tc.arguments = JSON.stringify(fixed);
}
}
@@ -487,7 +487,7 @@ async function runLoopInner(sessionId, run) {
})) : null,
};
const assistantId = saveMessage(sessionId, msgRow);
if (isErrAck) log.info('[msg] ' + sessionId + ' 本轮 tool call 参数错误,assistant 标记 errAck(不再进入模型上下文)');
if (isErrAck) log.info('msg', sessionId + ' 本轮 tool call 参数错误,assistant 标记 errAck(不再进入模型上下文)');
recordModelUsage(sessionId, session.model_id, result.usage);
bus.emit(sessionId, 'assistant_message', { id: assistantId, content: msgRow.content, reasoning: msgRow.reasoning, tool_calls: msgRow.tool_calls, type: msgRow.type });
@@ -502,7 +502,7 @@ async function runLoopInner(sessionId, run) {
for (const tc of msgRow.tool_calls) {
if (run.cancelled) break;
const id = tc.id;
log.debug('[tool] ' + sessionId + ' 调用 ' + tc.function.name + ' 参数: ' + String(tc.function.arguments || ''));
log.debug('tool', sessionId + ' 调用 ' + tc.function.name + ' 参数: ' + String(tc.function.arguments || ''));
bus.emit(sessionId, 'tool_call', { id, name: tc.function.name, arguments: tc.function.arguments });
let output;
let isError = false;
@@ -533,7 +533,7 @@ async function runLoopInner(sessionId, run) {
outText = String(output == null ? '' : output);
}
if (run.cancelled && !isError) outText = (outText ? outText + '\n' : '') + '(用户已终止任务)';
log.debug('[tool] ' + sessionId + ' ' + tc.function.name + (isError ? ' 失败: ' : ' 完成: ') + outText);
log.debug('tool', sessionId + ' ' + tc.function.name + (isError ? ' 失败: ' : ' 完成: ') + outText);
const toolContent = imageDataUrl
? encodeBlocks([
{ type: 'text', text: outText },
@@ -577,14 +577,14 @@ function makeSseMetaHandler(sessionId) {
} else if (k === 'retry') {
retry_time = v;
} else if (k === 'event') {
log.debug('[sse] ' + sessionId + ' event: ' + v);
} else if (k === '' && v === 'ping') {
log.debug('[sse] ' + sessionId + ' event: ' + v);
} else if (k === '') {
log.debug('[sse] ' + sessionId + ' comment: ' + v);
} else {
log.debug('[sse] ' + sessionId + ' meta: ' + line);
}
log.debug('sse', sessionId + ' event: ' + v);
} else if (k === '' && v === 'ping') {
log.debug('sse', sessionId + ' event: ' + v);
} else if (k === '') {
log.debug('sse', sessionId + ' comment: ' + v);
} else {
log.debug('sse', sessionId + ' meta: ' + line);
}
};
}
@@ -602,17 +602,17 @@ async function streamAssistant(sessionId, run, session, messages, tools) {
// 本轮是否启用深度思考;由 postUserMessage 从消息 POST 参数写进 run
deepThink: !!run.deepThink,
onMeta: handleSseMeta,
onBadData: raw => log.warn('[sse] ' + sessionId + ' 坏帧:' + raw.slice(0, 200)),
onBadData: raw => log.warn('sse', sessionId + ' 坏帧:' + raw.slice(0, 200)),
// data 解析成功但没有 choices(如 event: error 帧):上游发了非正常响应,
// 之前会伪装成"0 字"沉默忽略,这里 warn 把原始 evt 打出来便于定位。
onBadEvent: evt => log.warn('[sse] ' + sessionId + ' 上游错误帧:' + JSON.stringify(evt).slice(0, 500)),
onBadEvent: evt => log.warn('sse', sessionId + ' 上游错误帧:' + JSON.stringify(evt).slice(0, 500)),
});
// 本轮上游响应总览:帧数 + 文本长度 + 工具调用 + finish + aborted。
// sseFrames=0 且 aborted=false 表示上游未发任何 data(疑似流异常);其他情况可快速区分
// “上游发了一堆帧但 content 为空” 与 “根本没调用成功”。
log.info('[sse] ' + sessionId + ' 本轮汇总:帧 ' + (result && result.sseFrames || 0) +
',finish=' + (result && result.finish_reason || '-') +
',aborted=' + (result && result.aborted || false));
log.info('sse', sessionId + ' 本轮汇总:帧 ' + (result && result.sseFrames || 0) +
',finish=' + (result && result.finish_reason || '-') +
',aborted=' + (result && result.aborted || false));
return result;
} finally {
run.abortController = null;
@@ -853,7 +853,7 @@ function renameSession(sessionId, title) {
if (!t) throw Object.assign(new Error('名称不能为空'), { status_code: 400 });
if (t.length > 100) throw Object.assign(new Error('名称不能超过 100 字'), { status_code: 400 });
touch(sessionId, { title: t });
log.info('[task] ' + sessionId + ' 重命名为「' + t + '」');
log.info('task', sessionId + ' 重命名为「' + t + '」');
return { ok: true, title: t };
}
+12 -6
View File
@@ -1,8 +1,11 @@
// 统一日志接口:log.debug/info/warn/error(...),所有输出自带本地时间戳。
// 统一日志接口:log.debug/info/warn/error(category, ...args)
// 输出格式:<timestamp> [<level>] [<category>] <args...>
// category 作为该条日志的标签(原 "[xxx]" 前缀的独立参数化版本),便于日志分类/过滤。
// 等级阈值由 config.yml 的 log_level 控制(debug < info < warn < error),
// 只有 消息等级 >= 阈值 才输出;配成 none(或 off)则全部静默,含 error。
// 启动时 server.js 调 setLevel(cfg.log_level) 注入;改配置需重启生效(与其他配置一致,无热重载)。
// 约定:关键动作 info;可预期的异常状况 warn;未预期异常 error;排查细节 debug。
// Error 对象等原生参数透传给 console 走 util.format,不会被字符串化。
const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
let threshold = LEVELS.info;
@@ -21,10 +24,13 @@ function stamp() {
function emit(fn, level, args) {
if (LEVELS[level] < threshold) return;
// 时间戳并入首个字符串参数:不影响 %s 占位符,后续参数(含 Error 对象)保持原生格式化
if (typeof args[0] === 'string') args[0] = stamp() + ' ' + args[0];
else args.unshift(stamp());
fn.apply(console, args);
// 第一个参数固定为 category(允许为空串但不建议);其余原样透传 console
const category = String(args[0] == null ? '' : args[0]);
const rest = Array.prototype.slice.call(args, 1);
const head = stamp() + ' [' + level + '] [' + category + ']';
if (typeof rest[0] === 'string') rest[0] = head + ' ' + rest[0];
else rest.unshift(head);
fn.apply(console, rest);
}
module.exports = {
@@ -33,4 +39,4 @@ module.exports = {
info() { emit(console.log, 'info', arguments); },
warn() { emit(console.warn, 'warn', arguments); },
error() { emit(console.error, 'error', arguments); },
};
};
+3 -3
View File
@@ -42,7 +42,7 @@ async function rpc(server, method, params, timeoutMs) {
// 不调 tools/list —— 工具表在 init() 时已经发现并固化,运行期间不需要重新发现。
if (method !== 'initialize' && res.status === 400 && /session/i.test(raw)) {
clearTimeout(timer);
log.warn('[mcp] ' + server.name + ' session 疑似过期,重新握手: ' + raw.slice(0, 200));
log.warn('mcp', server.name + ' session 疑似过期,重新握手: ' + raw.slice(0, 200));
server.sessionId = null;
// 重新跑 initialize,递归走当前函数,method=initialize 不会再触发重连逻辑
try {
@@ -130,9 +130,9 @@ async function init(cfg) {
},
});
}
log.info('[mcp] ' + s.name + ': 发现 ' + tools.length + ' 个工具' + (s.sessionId ? ' (session)' : ''));
log.info('mcp', s.name + ': 发现 ' + tools.length + ' 个工具' + (s.sessionId ? ' (session)' : ''));
} catch (err) {
log.warn('[mcp] ' + s.name + ' 工具发现失败(本轮运行该服务不可用): ' + (err && err.message || err));
log.warn('mcp', s.name + ' 工具发现失败(本轮运行该服务不可用): ' + (err && err.message || err));
}
}
}
+2 -2
View File
@@ -162,7 +162,7 @@ router.put('/', wrap((req, res) => {
let next;
try { next = loadConfigFromText(restored, cfg.config_path); } catch (e) { return badRequest(res, e); }
writeConfigText(cfg, restored);
log.info('[config] ' + (req.user || '-') + ' 整文件保存配置,变更段:' + (diffTop(cfg, next).join(',') || '无'));
log.info('config', (req.user || '-') + ' 整文件保存配置,变更段:' + (diffTop(cfg, next).join(',') || '无'));
res.json({ ok: true, changed: diffTop(cfg, next), restart_required: true });
}));
@@ -186,7 +186,7 @@ router.patch('/', wrap((req, res) => {
let next;
try { next = loadConfigFromText(nextText, cfg.config_path); } catch (e) { return badRequest(res, e); }
writeConfigText(cfg, nextText);
log.info('[config] ' + (req.user || '-') + ' 修改配置项 ' + pathArr.join('.') + (body.op === 'delete' ? '(删除)' : '') + ',变更段:' + (diffTop(cfg, next).join(',') || '无'));
log.info('config', (req.user || '-') + ' 修改配置项 ' + pathArr.join('.') + (body.op === 'delete' ? '(删除)' : '') + ',变更段:' + (diffTop(cfg, next).join(',') || '无'));
res.json({ ok: true, changed: diffTop(cfg, next), restart_required: true });
}));
+3 -3
View File
@@ -66,8 +66,8 @@ router.post('/:id/files', upload.array('files', 10), function (req, res) {
}
// 不再自动通知 AI:附件随用户下一条消息统一告知(见 routes/messages.js 的 attachments)
if (uploaded.length) {
log.info('[file] ' + (req.user || '-') + ' ' + req.params.id + ' 上传 ' + uploaded.length + ' 个文件:' +
uploaded.map(f => f.filename + '(' + f.size + 'B)').join('、'));
log.info('file', (req.user || '-') + ' ' + req.params.id + ' 上传 ' + uploaded.length + ' 个文件:' +
uploaded.map(f => f.filename + '(' + f.size + 'B)').join('、'));
}
res.json({ uploaded });
} catch (err) {
@@ -191,7 +191,7 @@ router.delete('/:id/files', function (req, res) {
fs.rmSync(abs, { recursive: true, force: true });
engine.getDb().prepare('DELETE FROM files WHERE session_id = ? AND filename = ?')
.run(req.params.id, rel);
log.info('[file] ' + (req.user || '-') + ' ' + req.params.id + ' 删除文件 ' + rel);
log.info('file', (req.user || '-') + ' ' + req.params.id + ' 删除文件 ' + rel);
res.json({ ok: true });
} catch (err) {
res.status(404).json({ error: '文件不存在' });
+5 -5
View File
@@ -44,8 +44,8 @@ router.post('/:id/messages', wrap((req, res) => {
// deepThink:是否启用模型该「深度思考」参数(thinking_params 合并进上游请求体)
const deepThink = !!(req.body && req.body.deepThink);
const r = engine.postUserMessage(req.params.id, content, { deepThink });
log.info('[msg] ' + (req.user || '-') + ' ' + req.params.id + ' 用户消息(' + (r && r.delivered || '?') + '):' +
content.slice(0, 60).replace(/\s+/g, ' '));
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 用户消息(' + (r && r.delivered || '?') + '):' +
content.slice(0, 60).replace(/\s+/g, ' '));
res.json(r);
}));
@@ -66,7 +66,7 @@ router.post('/:id/release', wrap((req, res) => {
// 状态收尾为已完成并释放模型/出队;正在执行的回合会被拒绝(需先「终止」)。
router.delete('/:id/messages', wrap((req, res) => {
const r = engine.clearSessionMessages(req.params.id);
log.info('[msg] ' + (req.user || '-') + ' ' + req.params.id + ' 清空会话内容(文件保留)');
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 清空会话内容(文件保留)');
res.json(r);
}));
@@ -75,8 +75,8 @@ router.delete('/:id/messages', wrap((req, res) => {
// 库中没了,后续发给模型的消息里自然也没有;执行中删除会在下一轮组装历史时生效。
router.delete('/:id/messages/:messageId', wrap((req, res) => {
const r = engine.deleteMessage(req.params.id, Number(req.params.messageId));
log.info('[msg] ' + (req.user || '-') + ' ' + req.params.id + ' 删除消息 ' + req.params.messageId +
(r.removed > 1 ? '(连带 ' + (r.removed - 1) + ' 条工具回执)' : ''));
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 删除消息 ' + req.params.messageId +
(r.removed > 1 ? '(连带 ' + (r.removed - 1) + ' 条工具回执)' : ''));
res.json(r);
}));
+2 -2
View File
@@ -64,7 +64,7 @@ router.post('/', wrap((req, res) => {
// 创建者取认证中间件的 req.user(不信客户端传参);未启用认证时为空串
const user = String(req.user || '').trim().slice(0, 64);
const session = engine.createSession(title, modelId, assistantType, user);
log.info('[task] ' + (req.user || '-') + ' 新建任务 ' + session.id + '「' + (session.title || '未命名') + '」model=' + (modelId || '自动') + ' type=' + (session.assistant_type || 'secretary'));
log.info('task', (req.user || '-') + ' 新建任务 ' + session.id + '「' + (session.title || '未命名') + '」model=' + (modelId || '自动') + ' type=' + (session.assistant_type || 'secretary'));
res.json(session);
}));
@@ -147,7 +147,7 @@ router.patch('/:id', wrap((req, res) => {
router.delete('/:id', wrap((req, res) => {
const delDir = req.query.delete_dir === 'true' || req.query.delete_dir === '';
log.info('[task] ' + (req.user || '-') + ' 删除任务 ' + req.params.id + (delDir ? '(含任务目录)' : ''));
log.info('task', (req.user || '-') + ' 删除任务 ' + req.params.id + (delDir ? '(含任务目录)' : ''));
res.json(engine.deleteSession(req.params.id, delDir));
}));
+1 -1
View File
@@ -65,7 +65,7 @@ router.post('/restart', wrap((req, res) => {
try { loadConfig(cfg.config_path); } catch (e) {
return res.status(409).json({ error: '配置文件当前内容不合法,重启将无法启动:' + String(e && e.message || e) });
}
log.info('[system] 收到重启请求(force=' + force + ',打断 ' + running.length + ' 个回合),进程退出,等待 Docker 拉起');
log.info('system', '收到重启请求(force=' + force + ',打断 ' + running.length + ' 个回合),进程退出,等待 Docker 拉起');
res.json({ ok: true, restarting: true });
// 稍候再退出,确保响应已发出;容器由 Docker restart 策略自动重启
setTimeout(() => process.exit(0), 300);
+8 -8
View File
@@ -62,12 +62,12 @@ const PORT = process.env.PORT || cfg.port;
// 启动时先发现各 MCP 服务的工具(单个服务失败只警告,不阻止启动),发现完成后再开始监听。
mcp.init(cfg).then(() => {
server.listen(PORT, () => {
log.info('Agent server listening on ' + PORT);
log.info(' workspace_root=' + cfg.workspace_root);
log.info(' models=' + cfg.models.map(m => m.id + '@' + m.url).join(', '));
const mcpList = (cfg.mcp_servers || []).map(s => s.name + '@' + s.url).join(', ');
log.info(' mcp_servers=' + (mcpList || '(none)'));
log.info(' auth=' + (auth.enabled ? 'login (' + cfg.auth.users.map(u => u.user).join(', ') + ')' : '(disabled)'));
log.info(' log_level=' + cfg.log_level);
});
log.info('startup', 'Agent server listening on ' + PORT);
log.info('startup', ' workspace_root=' + cfg.workspace_root);
log.info('startup', ' models=' + cfg.models.map(m => m.id + '@' + m.url).join(', '));
const mcpList = (cfg.mcp_servers || []).map(s => s.name + '@' + s.url).join(', ');
log.info('startup', ' mcp_servers=' + (mcpList || '(none)'));
log.info('startup', ' auth=' + (auth.enabled ? 'login (' + cfg.auth.users.map(u => u.user).join(', ') + ')' : '(disabled)'));
log.info('startup', ' log_level=' + cfg.log_level);
});
});
+6 -6
View File
@@ -53,7 +53,7 @@ function extractDescription(content) {
async function listSkills(ctx) {
const root = skillsRoot(ctx);
if (!fs.existsSync(root)) {
log.warn('[skills] 技能根目录不存在:' + root);
log.warn('skills', '技能根目录不存在:' + root);
return [];
}
const out = [];
@@ -142,7 +142,7 @@ async function ensureDeps(ctx, dir, skillName) {
const need = 'req:' + hashFile(reqPath) + '|install:' + hashFile(installPath);
const markerPath = path.join(dir, '.deps_installed');
if (fs.existsSync(markerPath) && fs.readFileSync(markerPath, 'utf8') === need) {
log.debug('[skills] ' + skillName + ' 依赖已安装(命中缓存)');
log.debug('skills', skillName + ' 依赖已安装(命中缓存)');
return;
}
@@ -150,11 +150,11 @@ async function ensureDeps(ctx, dir, skillName) {
if (hasReq) {
const target = depsRoot(ctx);
fs.mkdirSync(target, { recursive: true });
log.debug('[skills] ' + skillName + ':pip install --target ' + target);
log.debug('skills', skillName + ':pip install --target ' + target);
await execSyncCapture('python3', ['-m', 'pip', 'install', '--target', target, '-r', reqPath], dir);
}
if (hasInstall) {
log.debug('[skills] ' + skillName + ':执行 install.sh');
log.debug('skills', skillName + ':执行 install.sh');
await execSyncCapture('bash', ['install.sh'], dir);
}
} catch (e) {
@@ -162,7 +162,7 @@ async function ensureDeps(ctx, dir, skillName) {
throw new DependencyInstallError('依赖安装失败:' + e.message, -1);
}
fs.writeFileSync(markerPath, need, 'utf8');
log.debug('[skills] ' + skillName + ':依赖安装完成');
log.debug('skills', skillName + ':依赖安装完成');
}
// ---------- 参数路径预处理 ----------
@@ -283,7 +283,7 @@ async function runSkill(ctx, skillName, inputArgs) {
}
const timeoutMs = (ctx.cfg && ctx.cfg.skills && ctx.cfg.skills.timeout_ms) || 120000;
log.info('[skills] 执行 ' + skillName + ':' + entry + ' ' + cmdArgs.join(' '));
log.info('skills', '执行 ' + skillName + ':' + entry + ' ' + cmdArgs.join(' '));
return runEntry(ctx, entry, cmdArgs, dir, timeoutMs);
}