教训：在API受限的平台上，"外包给外部工具"听起来很好，但跨进程边界的每一步都是脆弱点。
所以在完成中将 Agent 的登录拆成了异步的两阶段。第一阶段立即返回，返回的 JSON 除了验证 URL 和设备码，还带一个给 Agent 看的 next_action，明确告诉它下一步该跑什么命令： linkai auth login --no-wait --json 第二阶段开始轮询，每次最多等待若干秒后返回，超时未完成时 Agent 可以通过下一次工具调用再次轮询： linkai auth login --device-code --wait 60 --json 这里使用 --wait 参数区分了两类用户：不传（默认阻塞到设备码过期）走人类的交互式登录；传 --wait 则切到 Agent 的有界轮询路径。
config.ts（别名 @ + 代理 /api + 分包）+ .env 多环境 ↓ 封装 request.
为什么是 CLI Agent 访问外部能力主要有三种方式：调用 API、通过 MCP、以及在终端执行命令。
MongoDB 增加数据库所有权守卫。一个 database 只能归属一个 bounded context；历史混库和不兼容的受管索引必须在启动前迁移。
Excel 文件本质上是一个 ZIP 包。无论读取还是写入，DEFLATE 压缩/解压都是绕不开的热路径。