docs: AGENTS.md 补正式前端口径与最新测试基线；portal.py 标注为调试工具

- 新增前端一节：app/static/portal/ 挂载在 /portal/，四套页面，端点表在 common/api-client.js，
  启动用 uvicorn app.main:app（模块级变量是 app 不是 application）
- 测试基线更新为 2026-09-13 实测：mypy 249 文件 0 错 / 单元+契约 1376 passed / 集成 104 passed
- tools/portal.py 文件头标注降级为跨角色联调工具

tools/portal.py

@@ -1,4 +1,15 @@
-"""统一登录门户：一个登录入口，按角色分流到不同的工作台。
+"""统一登录门户（**调试/联调工具**，不是产品前端）。
+
+> ⚠️ **定位说明（2026-09-13）**：正式前端已由组员交付并合入主干，位于
+> `app/static/portal/`，通过 **`/portal/`** 访问（访客 / 客户 / 员工 / 风控四套页面；
+> 端点表见 `app/static/portal/common/api-client.js`）。
+> **本文件不是产品的一部分**，它是平台侧保留的**跨角色快速联调工具**：
+> 一个页面里用五个演示账号登录、直接点各模块接口、看原始响应与错误码。
+> 涉及具体页面与交互的工作请改正式前端，不要再往这里加功能。
+
+---
+
+一个登录入口，按角色分流到不同的工作台。
 
 **和 `tools/chat_console.py` 的区别**：那个控制台没有登录、身份写死在命令行里；
 本门户**走真实的 `POST /api/v1/auth/tokens`**，令牌只存活在本进程，浏览器拿不到，