@zxh126/pi-qqbot 1.3.0 → 1.3.1

package/constants.ts

@@ -16,5 +16,7 @@ export const DISPATCH_RETRY_MS = 3000;
 export const CANCEL_SETTLE_GRACE_MS = 8000;
 
 const PI_DIR = path.join(os.homedir(), ".pi", "agent");
+/** pi 的 agent 目录（其他扩展也往里写东西，如 pi-usage-report） */
+export const PI_AGENT_DIR = PI_DIR;
 export const CONFIG_PATH = () => path.join(PI_DIR, "pi-qqbot.json");
 export const LOCK_PATH = (appId: string) => path.join(PI_DIR, `pi-qqbot-${appId}.lock`);

package/docs/README.zh-CN.md

@@ -117,10 +117,10 @@ TUI/RPC 前端。在 QQ 里的表现就是「已派发，然后没下文」。
 |---|---|
 | `/usage [范围]`、`/cost [范围]` | 改派为 `/qq usage <范围>`：桥接先重跑原 `/usage` 命令，再从 session 里读出新的 `customType: "usage-report"` 条目，渲染成文本回 QQ（请求数/总 token/缓存比/费用/按模型）。**用法不变**，照旧发 `/usage today` |
 | `/mcp`、`/llama` | 直接回执：它们需要主机 TUI 的选择框 / 浏览器登录，不会派发 |
+| `/usage rate <值>`、`/usage rate auto` | 会真的执行（写 `~/.pi/agent/pi-usage-report.json` / 刷新汇率缓存），桥接再读回该文件确认新汇率；只发 `/usage rate` 与 `/usage help` 则本地直接回执 |
 
-`/usage rate ...` 与 `/usage help` 会改汇率或打印帮助（只在 TUI 可见），桥接会明确告知。
-桥接与 [`pi-usage-report`](https://gitee.com/zxh126/pi-usage-report) 的唯一耦合是 `usage-report` 这个
-custom entry 类型名。
+桥接与 [`pi-usage-report`](https://gitee.com/zxh126/pi-usage-report) 的耦合只有两处：`usage-report` 这个
+custom entry 类型名，以及它写在 `~/.pi/agent/` 下的两个配置文件。
 
 约束：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zxh126/pi-qqbot",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "description": "Bridge the Pi coding agent into QQ private chats, with remote tool-call approval",
   "license": "MIT",

package/slash.ts

@@ -26,6 +26,8 @@
 import fs from "node:fs";
 import path from "node:path";
 
+import { PI_AGENT_DIR } from "./constants";
+
 export interface SlashCommandText {
 	/** command name without the leading slash, lower-cased (`skill:name` keeps its colon) */
 	name: string;
@@ -380,6 +382,51 @@ export function pickerExpired(picker: PickerState | null): boolean {
 /** pi-usage-report 写入 session 的 custom entry 类型（耦合点，约定值） */
 const USAGE_ENTRY_TYPE = "usage-report";
 
+/** pi-usage-report 的配置/汇率缓存（读回来确认：命令真的生效了，而不是口头应下） */
+const USAGE_SETTINGS_FILE = "pi-usage-report.json";
+const USAGE_RATE_FILE = "pi-usage-report-rate.json";
+
+const USAGE_HELP = [
+	"/usage（默认 today）",
+	"/usage today | yesterday | week | lastweek | month | lastmonth | all",
+	"/usage 7d | 12h | 2w | 3m | 10天        滚动窗口",
+	"/usage 2026-09-01..2026-09-30       本地日期区间（含首尾）",
+	"/usage 今天 | 昨天 | 本周 | 上周 | 本月 | 上月 | 全部",
+	"/usage rate <值> | rate auto        固定 USD→本币汇率，或恢复自动（会真的写配置）",
+].join("\n");
+
+function readAgentJson(file: string): any {
+	try {
+		return JSON.parse(fs.readFileSync(path.join(PI_AGENT_DIR, file), "utf8"));
+	} catch {
+		return undefined;
+	}
+}
+
+const CURRENCY_SYMBOLS: Record<string, string> = { CNY: "¥", USD: "$", EUR: "€", JPY: "¥", GBP: "£", HKD: "HK$" };
+
+/** 复刻 pi-usage-report 的 readSettings 优先级：fixed(usdRate) > 缓存的发布汇率 > 无 */
+function usageMoney(): { code: string; symbol: string; rate: number | null; source: string } {
+	const raw = readAgentJson(USAGE_SETTINGS_FILE) ?? {};
+	const code = String(raw.currency ?? "CNY").toUpperCase();
+	const symbol = typeof raw.symbol === "string" ? raw.symbol : (CURRENCY_SYMBOLS[code] ?? code);
+	const pinned = typeof raw.usdRate === "number" && raw.usdRate > 0 ? raw.usdRate : undefined;
+	const fixed = raw.rateMode === "auto" ? undefined : pinned;
+	if (fixed !== undefined) return { code, symbol, rate: fixed, source: "fixed，/usage rate 手动固定" };
+	const cache = readAgentJson(USAGE_RATE_FILE);
+	if (cache && cache.code === code && typeof cache.rate === "number" && cache.rate > 0) {
+		const ageMinutes = Math.max(0, Math.round((Date.now() - Number(cache.fetchedAt ?? 0)) / 60000));
+		return { code, symbol, rate: cache.rate, source: `cache，${ageMinutes} 分钟前抓取` };
+	}
+	return { code, symbol, rate: null, source: "无，可用 /usage rate <值>" };
+}
+
+function moneyText(money: { code: string; rate: number | null; source: string }): string {
+	return money.rate === null
+		? `USD/${money.code}：无可用汇率（${money.source}）`
+		: `USD/${money.code} = ${money.rate}（${money.source}）`;
+}
+
 function sessionEntries(ctx: any): any[] {
 	try {
 		return ctx?.sessionManager?.getEntries?.() ?? [];
@@ -536,17 +583,41 @@ export async function runBridge(
 		}
 		case "usage": {
 			// /qq usage [...]：重跑原 /usage 命令，再从 session 里读回它写的 custom entry
-			if (first === "rate" || first === "help" || first === "?") {
-				reply(
-					`/usage ${arg} 会修改汇率或打印帮助，那些输出只在主机 TUI 可见；\n发 /usage today|week|month|all|7d 可在 QQ 里看统计。`,
-				);
+			const rest = arg.slice(first.length).trim();
+
+			// help：不执行命令（它在 TUI 打文本），直接回本地帮助
+			if (first === "help" || first === "?") {
+				reply(USAGE_HELP);
 				return;
 			}
+
 			const commands = (pi?.getCommands?.() ?? []) as { name: string }[];
-			if (!commands.some((c) => ["usage", "cost"].includes(String(c.name).toLowerCase()))) {
+			const hasUsage = commands.some((c) => ["usage", "cost"].includes(String(c.name).toLowerCase()));
+			if (!hasUsage) {
 				reply("主机上没有 /usage 命令（需要安装 pi-usage-report），无法统计。");
 				return;
 			}
+
+			// rate：会写配置/联网刷新汇率，必须真的执行，再读回状态确认（不能只回一句“TUI 可见”）
+			if (first === "rate") {
+				if (!rest) {
+					reply(moneyText(usageMoney()));
+					return;
+				}
+				const rateCommand = `/usage rate ${rest}`;
+				try {
+					await pi.sendUserMessage(rateCommand, { expandPromptTemplates: true });
+				} catch (error) {
+					reply(`执行 ${rateCommand} 失败：${String((error as any)?.message ?? error).slice(0, 200)}`);
+					return;
+				}
+				const after = usageMoney();
+				reply(
+					`已执行 ${rateCommand}\n${moneyText(after)}\n（下一步 /usage today 的 ¥/USD 换算就用它；无效值会被忽略）`,
+				);
+				return;
+			}
+
 			const command = `/usage${arg ? ` ${arg}` : ""}`;
 			const before = new Set(sessionEntries(ctx).map((entry: any) => entry?.id));
 			reply(`正在统计用量（${command}）…`);