@zxh126/pi-qqbot 1.2.0 → 1.2.1

package/README.md

@@ -221,7 +221,7 @@ The QQ gateway keeps only one active connection per bot. The extension uses a `p
 
 ## Logs
 
-Debug logs are written to `~/.pi/agent/pi-qqbot.log`.
+Debug logs are written to `~/.pi/agent/pi-qqbot.log`. Each line starts with a **local** timestamp that carries the UTC offset, e.g. `[2026-10-24T07:39:09.762+08:00]`, so it lines up with file mtimes and process start times without mental arithmetic.
 
 ## License
 

package/docs/README.zh-CN.md

@@ -211,7 +211,7 @@ QQ 网关对同一 bot 只保留一个活跃连接。插件用 `proper-lockfile`
 
 ## 日志
 
-调试日志写入 `~/.pi/agent/pi-qqbot.log`。
+调试日志写入 `~/.pi/agent/pi-qqbot.log`。每行开头是**本地时间 + 时区偏移**（如 `[2026-10-24T07:39:09.762+08:00]`），和文件 mtime、进程启动时间直接对得上，不需要再拿 UTC 换算。
 
 ## License
 

package/logger.ts

@@ -4,12 +4,28 @@ import path from "node:path";
 
 const LOG_PATH = path.join(os.homedir(), ".pi", "agent", "pi-qqbot.log");
 
-function ts() {
-  return new Date().toISOString();
+const pad = (value: number, width = 2): string =>
+  String(Math.trunc(Math.abs(value))).padStart(width, "0");
+
+/**
+ * 本地时间戳 + 时区偏移，例如 `2026-10-24T07:39:09.762+08:00`。
+ *
+ * 以前用 `toISOString()`（UTC），看日志要和文件 mtime、进程启动时间（都是本地）
+ * 来回换算，容易对不上；北京时间直接读即可，同时又保留偏移，跨时区不会歧义。
+ */
+export function timestamp(date = new Date()): string {
+  const offsetMinutes = -date.getTimezoneOffset(); // 东八区 = +480
+  const sign = offsetMinutes >= 0 ? "+" : "-";
+  const offset = `${sign}${pad(offsetMinutes / 60)}:${pad(offsetMinutes % 60)}`;
+  const local =
+    `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` +
+    `T${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` +
+    `.${pad(date.getMilliseconds(), 3)}`;
+  return `${local}${offset}`;
 }
 
 export function log(...args: unknown[]) {
-  const line = `[${ts()}] ${args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ")}\n`;
+  const line = `[${timestamp()}] ${args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ")}\n`;
   try {
     fs.appendFileSync(LOG_PATH, line, "utf8");
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zxh126/pi-qqbot",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "Bridge the Pi coding agent into QQ private chats, with remote tool-call approval",
   "license": "MIT",
@@ -27,7 +27,7 @@
     ]
   },
   "scripts": {
-    "test": "node test/queue.test.mjs"
+    "test": "node test/queue.test.mjs && node test/logger.test.mjs"
   },
   "files": [
     "*.ts",