Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 11 additions & 6 deletions docs/prototype/buddy-switch-prototype.html
Original file line number Diff line number Diff line change
Expand Up @@ -3695,20 +3695,25 @@ <h3 id="confirm-title">确认</h3>

/* ── 剩余时长的展示粒度(与产品 `lib/credit-expiry.ts::remainingSpan` 同规则)──
*
* ≤ 48 小时说小时(向上取整、≥1):25 小时与 47 小时都能各自说准;
* > 48 小时才折算成天(向上取整,宁可说晚不说早 —— 49 小时算「3 天」)。
* ⚠️ 别在调用点另写 `<= 48` 的边界:产品侧就因为「徽章改了、表格没改」出过
* < 1 小时说分钟(向下取整):最后一小时里「1 小时」会停滞,看不出还剩多少;
* 1 分钟以内向下取整到 0 分钟(刻意不设秒档 —— 0 分钟就是「马上到期」);
* ≤ 48 小时说小时(向下取整):25 小时与 47 小时都能各自说准;
* > 48 小时才折算成天(向上取整 —— 49 小时算「3 天」,宁可说晚不说早)。
* ⚠️ 别在调用点另写边界:产品侧就因为「徽章改了、表格没改」出过
* 「2 小时 / 1 天」同屏两句话(#189 后的回归,2026-11-09 修)。 */
const expirySpan = (ms) => {
const MINUTE = 60000;
const HOUR = 3600000;
const DAY = 86400000;
if (ms < HOUR) return { value: Math.max(0, Math.floor(ms / MINUTE)), unit: "minutes" };
return ms <= 48 * HOUR
? { value: Math.max(1, Math.ceil(ms / HOUR)), unit: "hours" }
? { value: Math.max(1, Math.floor(ms / HOUR)), unit: "hours" }
: { value: Math.max(1, Math.ceil(ms / DAY)), unit: "days" };
};
const spanUnitText = (unit) => (unit === "hours" ? "小时" : "天");
const spanUnitText = (unit) =>
unit === "minutes" ? "分钟" : unit === "hours" ? "小时" : "天";

/** 卡片徽章:「最近到期 {N天|N小时} · {金额} 积分」—— 数值与金额同批(`soonestExpire`)。 */
/** 卡片徽章:「最近到期 {N分钟|N小时|N天} · {金额} 积分」—— 数值与金额同批(`soonestExpire`)。 */
function expiringChipText(a) {
if (!a.soonestExpire) return "";
const span = expirySpan(a.soonestExpire.ms - Date.now());
Expand Down
17 changes: 11 additions & 6 deletions docs/prototype/demo-app.js
Original file line number Diff line number Diff line change
Expand Up @@ -185,20 +185,25 @@ const fmtTok = (n) => (n >= 1e6 ? (n / 1e6).toFixed(1) + "M" : n >= 1e3 ? (n / 1

/* ── 剩余时长的展示粒度(与产品 `lib/credit-expiry.ts::remainingSpan` 同规则)──
*
* ≤ 48 小时说小时(向上取整、≥1):25 小时与 47 小时都能各自说准;
* > 48 小时才折算成天(向上取整,宁可说晚不说早 —— 49 小时算「3 天」)。
* ⚠️ 别在调用点另写 `<= 48` 的边界:产品侧就因为「徽章改了、表格没改」出过
* < 1 小时说分钟(向下取整):最后一小时里「1 小时」会停滞,看不出还剩多少;
* 1 分钟以内向下取整到 0 分钟(刻意不设秒档 —— 0 分钟就是「马上到期」);
* ≤ 48 小时说小时(向下取整):25 小时与 47 小时都能各自说准;
* > 48 小时才折算成天(向上取整 —— 49 小时算「3 天」,宁可说晚不说早)。
* ⚠️ 别在调用点另写边界:产品侧就因为「徽章改了、表格没改」出过
* 「2 小时 / 1 天」同屏两句话(#189 后的回归,2026-11-09 修)。 */
const expirySpan = (ms) => {
const MINUTE = 60000;
const HOUR = 3600000;
const DAY = 86400000;
if (ms < HOUR) return { value: Math.max(0, Math.floor(ms / MINUTE)), unit: "minutes" };
return ms <= 48 * HOUR
? { value: Math.max(1, Math.ceil(ms / HOUR)), unit: "hours" }
? { value: Math.max(1, Math.floor(ms / HOUR)), unit: "hours" }
: { value: Math.max(1, Math.ceil(ms / DAY)), unit: "days" };
};
const spanUnitText = (unit) => (unit === "hours" ? "小时" : "天");
const spanUnitText = (unit) =>
unit === "minutes" ? "分钟" : unit === "hours" ? "小时" : "天";

/** 卡片徽章:「最近到期 {N天|N小时} · {金额} 积分」—— 数值与金额同批(`soonestExpire`)。 */
/** 卡片徽章:「最近到期 {N分钟|N小时|N天} · {金额} 积分」—— 数值与金额同批(`soonestExpire`)。 */
function expiringChipText(a) {
if (!a.soonestExpire) return "";
const span = expirySpan(a.soonestExpire.ms - Date.now());
Expand Down
13 changes: 9 additions & 4 deletions docs/specs/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -960,10 +960,15 @@ webview 里属 HTTPS 页面发起的回环 HTTP 请求 —— 依赖平台把 lo
Trae 从 7 放宽到 14(理由:多数人一周才开一次工具,7 天窗口常在下一次打开前滑过)。
那条理由单独看仍成立,但它**只在 Trae 一侧生效**,代价是口径分裂 —— 本次判定
**同口径优先于单平台的宽松度**。要改就三处一起改,别再单边放宽。
- **徽章只报最快那一批**:`最近到期 {N天|N小时} · {金额} 积分`,时间与金额同批(`batches[0]`);
≤ 48 小时说小时(25 小时与 47 小时不能都说成「1 天」),超过 48 小时才折算成天、
向上取整(宁可说晚不说早)。粒度判据只有一处:`credit-expiry.ts::remainingSpan`
(卡片徽章与账号表格列共用;2026-11-09 修过一次「徽章说 2 小时、表格说 1 天」)。
- **徽章只报最快那一批**:`最近到期 {N分钟|N小时|N天} · {金额} 积分`,时间与金额同批(`batches[0]`);
**< 1 小时说分钟**(最后一小时里「1 小时」会停滞,看不出还剩多少),≤ 48 小时说小时
(25 小时与 47 小时不能都说成「1 天」),超过 48 小时才折算成天;分钟与小时档向下取整
(61 秒显示「1分钟」),天档仍向上取整(49 小时显示「3天」,宁可说晚不说早)。
**不设秒档**:1 分钟以内向下取整为「0分钟」—— 那是「马上到期」的读数,允许出现。
分钟值是**渲染时快照**,随积分数据刷新或组件重渲染更新;不做秒级倒计时,也不为它增设定时器。
粒度判据只有一处:`credit-expiry.ts::remainingSpan`
(卡片徽章与账号表格列共用;2026-11-09 修过一次「徽章说 2 小时、表格说 1 天」,
2026-11-17 补了「分钟」档)。
- **余额改可用口径**:后端 `totalRemaining` / `totalCapacity` 剔除已过期包,浪费量由
`expiredRemaining` 单独报告;WB 抽屉 / 聚合详情的资源包明细同步剔过期,
Trae / Qoder 的抽屉**仍保留**过期包(它们的账号级余额口径没改,不能一刀切)。
Expand Down
4 changes: 3 additions & 1 deletion docs/specs/P4-ARCH.md
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,9 @@ export interface DetailPack {
> Trae `trae/credits.rs::EXPIRING_SOON_SECS`、前端两个镜像常量(`TRAE_EXPIRING_SOON_MS` /
> `EXPIRING_SOON_MS`)四处必须相等 —— 跨语言不能共享常量,由 `check-credit-packs.mjs` 钉住。
> 同一文件还钉住「剩余时长的粒度」只有一处判据 `credit-expiry.ts::remainingSpan`
> (≤ 48 小时说小时;卡片徽章与账号表格列共用,别再长出只到天的第二个函数)。
> (< 1 小时说分钟、≤ 48 小时说小时;分钟与小时档向下取整,天档向上取整;
> **不设秒档**,1 分钟以内显示「0 分钟」;分钟值是渲染时快照,随数据刷新或重渲染更新,
> 不做秒级倒计时;卡片徽章与账号表格列共用,别再长出只到天的第二个函数)。
>
> ★ **余额是可用口径**(同 D57):`credit_result` 的 `totalRemaining` / `totalCapacity`
> **剔除已过期包**,浪费量走 `expiredRemaining`;因此 WB 侧的资源包明细也必须剔过期包
Expand Down
68 changes: 63 additions & 5 deletions scripts/check-credit-packs.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -299,31 +299,89 @@ check("★ 临期窗口只剩两档:后端标记,或镜像后端的 7 天常
* 仍用只到天的 `daysUntil()` ⇒ 2 小时后到期的批在徽章上「2小时」、在同一行的表格里
* 「1 天」。这类分叉不会被 tsc 抓(两个函数都合法),只能靠行为断言把「同源」钉住。
*
* 2026-11-17:补 **< 1 小时 ⇒ 分钟**,分钟与小时档改为向下取整;天档继续向上取整
* (宁可说晚不说早)。**不设秒档**:1 分钟以内显示 0 分钟(「马上到期」的读数)。
*
* 可证伪点:
* ① 边界:48 小时(含等号)仍算小时,49 小时才是 3 天(向上取整、宁可说晚);
* ① 边界:59.5 秒向下取整到 0 分钟(不足 1 分钟即 0);60 秒正好 1 分钟;
* 59.5 分钟向下取整到 59 分钟;60 分钟(含等号)说 1 小时;48 小时(含等号)仍算小时,
* 49 小时按天向上取整成 3 天;
* ② 同源:`summarizeExpiring().soonestUnit` 必须等于 `remainingSpan()` 对同一剩余时长的
* 结论 —— 变异:把 summarizeExpiring 里的 `remainingSpan(remaining).unit` 换回
* 内联三元 ⇒ 这一组仍可能过,所以还要 ③;
* ③ 用法:表格列读 `remainingSpan`,且 `daysUntil` 这个「只到天」的旧出口已删除
* (留着它,下一个人一定会再用一次)。
* ③ 用法:表格列读 `remainingSpan`;四个展示点(三张卡片 + 表格列)都接了「分钟」档
* (漏接时 tsc 不报,界面会把 20 分钟渲染成「1小时」);
* `daysUntil` 这个「只到天」的旧出口已删除(留着它,下一个人一定会再用一次)。
*/
check("★ 剩余时长粒度只有一处判据(remainingSpan):徽章与表格列同源", () => {
const MINUTE = 60_000;
const HOUR = 3_600_000;
eq(remainingSpan(999), { unit: "minutes", value: 0 }, "不足 1 分钟显示 0 分钟(不设秒档)");
eq(remainingSpan(45 * 1_000), { unit: "minutes", value: 0 }, "45 秒是 0 分钟");
eq(remainingSpan(59_500), { unit: "minutes", value: 0 }, "59.5 秒向下取整到 0 分钟");
eq(remainingSpan(MINUTE), { unit: "minutes", value: 1 }, "正好 60 秒是 1 分钟");
eq(remainingSpan(20 * MINUTE), { unit: "minutes", value: 20 }, "20 分钟");
eq(remainingSpan(59 * MINUTE), { unit: "minutes", value: 59 }, "59 分钟");
eq(remainingSpan(59 * MINUTE + 30_000), { unit: "minutes", value: 59 }, "59.5 分钟向下取整到 59 分钟");
eq(remainingSpan(HOUR), { unit: "hours", value: 1 }, "正好 60 分钟不再算分钟档,进入小时档");
eq(remainingSpan(2 * HOUR), { unit: "hours", value: 2 }, "2 小时");
eq(remainingSpan(48 * HOUR), { unit: "hours", value: 48 }, "48 小时(边界含等号)");
eq(remainingSpan(49 * HOUR), { unit: "days", value: 3 }, "49 小时应向上取整成 3 天");
eq(remainingSpan(48 * HOUR + 1), { unit: "days", value: 3 }, "48 小时 + 1 毫秒进入天档(向上取整)");
eq(remainingSpan(49 * HOUR), { unit: "days", value: 3 }, "49 小时向上取整成 3 天");
eq(remainingSpan(72 * HOUR), { unit: "days", value: 3 }, "72 小时正好 3 天");
eq(remainingSpan(3 * DAY), { unit: "days", value: 3 }, "3 天");
const only = (hours) => [
{ expireAt: NOW + hours * HOUR, remaining: 10, expired: false, expiringSoon: true },
];
for (const hours of [1, 47, 48, 49, 72]) {
for (const hours of [0.5, 1, 47, 48, 49, 72]) {
const summary = summarizeExpiring(only(hours), { now: NOW });
eq(summary.soonestUnit, remainingSpan(hours * HOUR).unit, `${hours} 小时后徽章的单位`);
}
eq(summarizeExpiring(only(0.5), { now: NOW }).soonestMinutes, 30, "半小时徽章要拿到 30 分钟");
eq(summarizeExpiring(only(49), { now: NOW }).soonestDays, 3, "49 小时徽章要拿到 3 天");
eq(
summarizeExpiring(
[{ expireAt: NOW + 30_000, remaining: 10, expired: false, expiringSoon: true }],
{ now: NOW },
).soonestMinutes,
0,
"不足 1 分钟徽章要拿到 0 分钟",
);
const page = readFileSync(path.join(root, "src/pages/AccountsPage.tsx"), "utf8");
if (!/remainingSpan\(/.test(page)) {
throw new Error("AccountsPage 的「积分到期」列没读 remainingSpan —— 会与卡片徽章的粒度分叉");
}
/* 漏接「分钟」档不会报编译错误,只会把 20 分钟渲染成「1小时」。 */
const displays = {
"src/pages/AccountsPage.tsx": {
key: "wbAccounts.table.creditExpiryMinutes",
branch: /span\.unit\s*===\s*["']minutes["']/,
},
"src/components/account-card.tsx": {
key: "wbAccounts.card.expiringChipMinutes",
branch: /expiring\.soonestUnit\s*===\s*["']minutes["']/,
},
"src/components/trae-account-card.tsx": {
key: "trae.comp.card.chip.expiringMinutes",
branch: /expiring\.soonestUnit\s*===\s*["']minutes["']/,
},
"src/components/qoder/qoder-account-card.tsx": {
key: "qoder.page.accounts.metric.expiringChipMinutes",
branch: /expiring\.soonestUnit\s*===\s*["']minutes["']/,
},
};
for (const [rel, { key, branch }] of Object.entries(displays)) {
const code = readFileSync(path.join(root, rel), "utf8")
.split("\n")
.filter((line) => !/^\s*(\*|\/\/|\/\*)/.test(line))
.join("\n");
const keyPattern = new RegExp(
`["']${key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']`,
);
if (!branch.test(code) || !keyPattern.test(code)) {
throw new Error(`${rel} 没有真正接「分钟」档(缺分钟分支或 ${key})`);
}
}
const pageCode = page
.split("\n")
.filter((line) => !/^\s*(\*|\/\/|\/\*)/.test(line))
Expand Down
26 changes: 16 additions & 10 deletions src/components/account-card.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -684,31 +684,37 @@ const isCurrentAccount = programSlots.some((slot) => slot.active);
);

/**
* 「最近到期 {N天|N小时} · {金额} 积分」——原型 `.acct-chips` 的第三条
* 「最近到期 {N分钟|N小时|N天} · {金额} 积分」——原型 `.acct-chips` 的第三条
* (`demo-app.js` 的 `expiringChipText()`;徽章只在**最快那批**存在时渲染)。
*
* ★ 2026-11-09 **口径修正**:徽章只报**最快到期的那一批** —— 天数与金额同批
* (`summarizeExpiring` 的 `soonestDays` / `soonestAmount`)。
* 此前「金额 = 全部临期之和」配「天数 = 最晚那一刻」会让徽章说成「2 天内过期」,
* 而实际上明天就有一批要作废。逐批明细(最快排第一、绝对时刻)放进 tooltip。
* ★ 粒度(≤48 小时说小时)由 `remainingSpan` 唯一决定,卡片与账号表格列同源。
* ★ 粒度(<1 小时用分钟、≤48 小时用小时)由 `remainingSpan` 唯一决定,
* 卡片与账号表格列同源。1 分钟以内显示 0 分钟(刻意:不设秒档)。
*
* ⚠️ 窗口不再是前端自设的 3 天,而是**后端的 `expiringSoon`(7 天)**——统计页 / 总览页
* 读的就是同一口径(`expiringSoonRemaining`),卡片若另设窗口,同一件事会出现两个数字。
* 拿不到临期批次 ⇒ **整条不渲染**(绝不写一个猜出来的「N 天」标签)。
*/
const expiring = credit?.ok ? summarizeExpiring(metricResources, { now: expiryNow }) : null;
/* 徽章文案:≤ 48 小时用小时,超过才用天(与 `summarizeExpiring.soonestUnit` 同源)。 */
/* 徽章文案:<1 小时用分钟、≤ 48 小时用小时,超过才用天(与 `summarizeExpiring.soonestUnit` 同源)。 */
const expiringChipText = expiring
? expiring.soonestUnit === "hours"
? t("wbAccounts.card.expiringChipHours", {
? expiring.soonestUnit === "minutes"
? t("wbAccounts.card.expiringChipMinutes", {
amount: formatCredits(expiring.soonestAmount),
hours: expiring.soonestHours,
})
: t("wbAccounts.card.expiringChip", {
amount: formatCredits(expiring.soonestAmount),
days: expiring.soonestDays,
minutes: expiring.soonestMinutes,
})
: expiring.soonestUnit === "hours"
? t("wbAccounts.card.expiringChipHours", {
amount: formatCredits(expiring.soonestAmount),
hours: expiring.soonestHours,
})
: t("wbAccounts.card.expiringChip", {
amount: formatCredits(expiring.soonestAmount),
days: expiring.soonestDays,
})
: "";
const expiringChip = expiring ? (
<Tooltip>
Expand Down
22 changes: 14 additions & 8 deletions src/components/qoder/qoder-account-card.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -556,17 +556,23 @@ export function QoderAccountCard({
</>
);

/* 徽章文案:≤ 48 小时用小时,超过才用天(与 `summarizeExpiring.soonestUnit` 同源)。 */
/* 徽章文案:<1 小时用分钟、≤ 48 小时用小时,超过才用天
(与 `summarizeExpiring.soonestUnit` 同源)。 */
const expiringChipText = expiring
? expiring.soonestUnit === "hours"
? t("qoder.page.accounts.metric.expiringChipHours", {
? expiring.soonestUnit === "minutes"
? t("qoder.page.accounts.metric.expiringChipMinutes", {
amount: formatCredits(expiring.soonestAmount),
hours: expiring.soonestHours,
})
: t("qoder.page.accounts.metric.expiringChip", {
amount: formatCredits(expiring.soonestAmount),
days: expiring.soonestDays,
minutes: expiring.soonestMinutes,
})
: expiring.soonestUnit === "hours"
? t("qoder.page.accounts.metric.expiringChipHours", {
amount: formatCredits(expiring.soonestAmount),
hours: expiring.soonestHours,
})
: t("qoder.page.accounts.metric.expiringChip", {
amount: formatCredits(expiring.soonestAmount),
days: expiring.soonestDays,
})
: "";
const expiryChip = expiring ? (
<Tooltip>
Expand Down
22 changes: 14 additions & 8 deletions src/components/trae-account-card.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -424,17 +424,23 @@ export function TraeAccountCard({
</>
);

/* 徽章文案:≤ 48 小时用小时,超过才用天(与 `summarizeExpiring.soonestUnit` 同源)。 */
/* 徽章文案:<1 小时用分钟、≤ 48 小时用小时,超过才用天
(与 `summarizeExpiring.soonestUnit` 同源)。 */
const expiringChipText = expiring
? expiring.soonestUnit === "hours"
? t("trae.comp.card.chip.expiringHours", {
? expiring.soonestUnit === "minutes"
? t("trae.comp.card.chip.expiringMinutes", {
amount: formatCredits(expiring.soonestAmount),
hours: expiring.soonestHours,
})
: t("trae.comp.card.chip.expiring", {
amount: formatCredits(expiring.soonestAmount),
days: expiring.soonestDays,
minutes: expiring.soonestMinutes,
})
: expiring.soonestUnit === "hours"
? t("trae.comp.card.chip.expiringHours", {
amount: formatCredits(expiring.soonestAmount),
hours: expiring.soonestHours,
})
: t("trae.comp.card.chip.expiring", {
amount: formatCredits(expiring.soonestAmount),
days: expiring.soonestDays,
})
: "";
const expiringChip = expiring ? (
<Tooltip>
Expand Down
Loading
Loading