Files
hold-baby b874d3c582 docs: extend agent auth code validity from 5 to 10 minutes (#1232)
## Merge Verdict

**[APPROVE]** — Docs-only copy change; auth code TTL updated from 5 to
10 minutes, consistently applied across all three locales.

> 3 files · +9 / -9 · `docs/en` `docs/zh-CN` `docs/zh-HK`

---

## Change Summary

- Updates the AI Agent auth code TTL from **5 minutes** to **10
minutes** on the `agent-auth` page.
- All 3 mentions per file are covered: the intro statement, the Security
bullet (`10-minute TTL`), and the "code has expired" troubleshooting
note.
- Applied identically in `en` / `zh-CN` / `zh-HK`, satisfying the repo's
trilingual sync rule.

---

## Risk Analysis

| Risk | Level | Mitigation |
|------|-------|------------|
| Docs drift from backend TTL | 🟡 | Requires the server-side auth code
TTL to actually be 10 minutes; otherwise users will hit an expiry
earlier than documented |
| Missed occurrences |  | `grep` over `docs/` confirms no remaining "5
minutes / 5 分钟 / 5 分鐘" reference to the auth code TTL |
| Locale divergence |  | Same 3 edits in all three locale files,
verified line by line |

---

## Design Decisions

- **Terminology kept intact**: only the number changed; wording, bold
markers and links are untouched, so translation parity is preserved.
- **Device-flow polling left alone**:
`docs/{lang}/skill/install/index.md` mentions "~5 minutes" for the `auth
login` device-code polling window — a different mechanism from the
one-time auth code, correctly not modified.

---

## Code Concerns

1. **[需判断]** Docs change assumes the backend TTL is already 10 minutes
(`docs/en/docs/agent-auth.md:37`)
Docs are not the source of truth here; confirm the auth service has
shipped the 10-minute TTL before merging, otherwise the page
over-promises.

---

## Verification Status

 Markdown-only change ·  Trilingual sync verified · 📋 To verify:
backend auth code TTL is actually 10 minutes

Co-authored-by: 袁昌瑞 <changrui.yuan@longbridge-inc.com>
2026-08-28 19:31:42 +08:00
..
2025-07-18 16:36:28 +08:00

vitepress 常用语法

  • // [!code focus] 可以使得代码块聚焦某一行
  • ts{2-3,5} 使得第 2-3 行和第 5 行显示高亮
  • 在某一行上添加 // [!code --]// [!code ++] 注释将创建该行的差异,同时保留代码块的颜色
    • // [!code warning]// [!code error] 错误和警告
  • ::: code-group 实现代码组
  • :::tabs key:language 实现记忆组切换