From db881d0f85c72ae9044ec22e24b3de823b87569b Mon Sep 17 00:00:00 2001 From: kicer Date: Tue, 8 Sep 2026 09:43:09 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=EF=BC=9A=E5=A4=9A=E6=A0=87?= =?UTF-8?q?=E7=AD=BE=E9=A1=B5=E5=88=87=E5=8F=B7=E5=90=8E=20/api/me=20?= =?UTF-8?q?=E4=B8=8E=E4=BC=9A=E8=AF=9D=E5=88=97=E8=A1=A8=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E4=B8=8D=E4=B8=80=E8=87=B4=EF=BC=88=E8=BA=AB=E4=BB=BD=E7=BB=9F?= =?UTF-8?q?=E4=B8=80=20cookie=20=E4=BC=98=E5=85=88=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 前端 req() 不再附加 sessionStorage 的 Basic 头:sessionStorage 按标签页隔离、刷新后残留,而 cookie 是浏览器全局,多用户切号后两者指向不同用户 - 服务端新增 authUser():cookie 优先于 Basic,中间件与 /api/me 共用同一解析顺序,杜绝显示身份与数据身份分裂;Basic 仅供 curl/脚本无 cookie 时使用 - 登录页不再往 sessionStorage 写明文口令(旧标签页残留值由 logout/启动检查顺带清理) - ARCHITECTURE.md 同步:§5.7 中间件优先级、§10.3 登录时序、§14.16 新陷阱 --- app/server/auth.js | 15 ++++++++++++--- app/server/public/index.html | 13 ++++++------- app/server/public/login.html | 5 ++--- docs/ARCHITECTURE.md | 5 +++-- 4 files changed, 23 insertions(+), 15 deletions(-) diff --git a/app/server/auth.js b/app/server/auth.js index d2e792a..e47a995 100644 --- a/app/server/auth.js +++ b/app/server/auth.js @@ -120,6 +120,15 @@ function createAuth(cfg) { return null; } + // 统一身份解析:cookie 优先于 Authorization: Basic。 + // cookie 是浏览器全局的(切号登录立即覆盖、SSE 导航下载都带它),而 Basic 头可能来自 + // 旧标签页残留的 sessionStorage 凭据——两者取用时若 Basic 优先,会出现 /api/me(读 cookie) + // 与业务路由(读 Basic)身份分裂。统一 cookie 优先保证同一浏览器内所有请求认定同一用户, + // Basic 仅作为无 cookie 场景(curl / API 脚本)的兜底。 + function authUser(req) { + return sessionUser(req) || basicAuthUser(req, users); + } + // ----- 登录/登出 API ----- router.post('/api/login', (req, res) => { const { user, password } = req.body || {}; @@ -188,7 +197,8 @@ function createAuth(cfg) { }); router.get('/api/me', (req, res) => { - res.json({ user: sessionUser(req) }); + // 与中间件同一解析顺序(cookie 优先),保证 /api/me 显示的用户与业务路由认定的用户一致 + res.json({ user: authUser(req) }); }); // ----- 登录页 / 登出跳转 ----- @@ -205,8 +215,7 @@ function createAuth(cfg) { // ----- 全局认证中间件:cookie 或 Basic 任一通过;否则 API 回 401、页面跳登录页 ----- const middleware = (req, res, next) => { - const fromBasic = basicAuthUser(req, users); - const user = fromBasic || sessionUser(req); + const user = authUser(req); if (user) { req.user = user; return next(); } if (isPublicPath(req.path) || isSignedDownload(req)) return next(); if (req.path.startsWith('/api/')) return res.status(401).json({ error: '未登录' }); diff --git a/app/server/public/index.html b/app/server/public/index.html index 4e21540..b6273fb 100644 --- a/app/server/public/index.html +++ b/app/server/public/index.html @@ -427,9 +427,9 @@ // ---------- API(与 core.js 的 req 保持一致) ---------- async function req(method, url, body, isForm) { const opt = { method, headers: {} }; - // 从 sessionStorage 取登录凭据,自动加 Basic auth 头,确保 cookie 残留时认证也不出错 - const creds = sessionStorage.getItem('agent_creds'); - if (creds) opt.headers['Authorization'] = 'Basic ' + creds; + // 浏览器身份只认 HttpOnly cookie:服务端所有路由(含 /api/me、SSE)统一按 cookie 认定用户。 + // 不要在此附加 sessionStorage 里的 Basic 头——sessionStorage 按标签页隔离、刷新后残留, + // 而 cookie 是浏览器全局的;两者并用会在多用户切号后出现 /api/me 是 A、列表数据是 B 的分裂。 if (body && !isForm) { opt.headers['Content-Type'] = 'application/json'; opt.body = JSON.stringify(body); @@ -3936,7 +3936,7 @@ // 账户 changePassword: changePassword, logout: async function () { - sessionStorage.removeItem('agent_creds'); // 清 Basic auth 凭据 + sessionStorage.removeItem('agent_creds'); // 旧版本遗留的 Basic 凭据,顺带清理 localStorage.removeItem('agent_token'); // 清 autoRestore token,防止自动恢复旧用户 try { await fetch('/api/logout', { method: 'POST' }); } catch (_) {} location.href = '/logout'; @@ -3987,16 +3987,15 @@ openDrawer(drawerMQ.matches); // 桌面端:侧边栏默认展开;跨断点缩放窗口时同步切换开合态 drawerMQ.addEventListener('change', e => openDrawer(e.matches)); // 页面加载时校验 cookie 身份:防止 localStorage 旧 token 通过 autoRestore 恢复错误用户 - // 仅用 cookie 认证(不带 Basic auth),检测服务端实际认定的用户身份 (async () => { try { - const res = await fetch('/api/me', { credentials: 'include', headers: { Authorization: '' } }); + const res = await fetch('/api/me', { credentials: 'include' }); if (res.ok) { const j = await res.json(); if (!j.user) { // cookie 无效或用户已从配置中移除 → 彻底清理所有前端凭据并跳登录 localStorage.removeItem('agent_token'); - sessionStorage.removeItem('agent_creds'); + sessionStorage.removeItem('agent_creds'); // 旧版本遗留的 Basic 凭据,顺带清理 location.href = '/logout'; return; } diff --git a/app/server/public/login.html b/app/server/public/login.html index 46503ce..6d9cf95 100644 --- a/app/server/public/login.html +++ b/app/server/public/login.html @@ -96,10 +96,9 @@ } const j = await res.json().catch(() => ({})); if (j && j.token) { + // 仅存签名 token 供 WebView 场景 login_restore 恢复; + // 不再往 sessionStorage 写明文口令——Basic 头与 cookie 作用域不同,会引发多标签页身份分裂 localStorage.setItem(TOKEN_KEY, j.token); - // 持久化凭据供 req() 使用 Basic auth,避免 cookie 残留导致切换用户后认证错乱 - const creds = btoa(encodeURIComponent((document.getElementById('login-user').value || '') + ':' + (document.getElementById('login-pass').value || ''))); - sessionStorage.setItem('agent_creds', creds); } location.replace('/'); // 替换而非压栈:历史里不留 /login 条目,登录后侧滑不会退回登录页 } catch (e2) { diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 1a0eab5..75c2dc6 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -292,7 +292,7 @@ stateDiagram-v2 - `POST /api/login_restore`(Authorization: Bearer)→ 验签 + 重新签发。 - `POST /api/password`(认证中)→ 校验 + 改写 config.yml(保留注释 + 校验失败不动文件) + 内存同步生效。 - `POST /api/logout` / `GET /logout`。 -- 中间件:cookie 或 Authorization: Basic 任一通过;公开路径白名单(`/login`, `/api/login` 等)+ 签名下载链接(`?t=...`)放行;其余 API 401、页面重定向 `/login`。 +- 中间件:cookie 或 Authorization: Basic 任一通过(**cookie 优先**,见 §14.16;`/api/me` 与中间件同一解析顺序,保证显示身份 = 数据身份);公开路径白名单(`/login`, `/api/login` 等)+ 签名下载链接(`?t=...`)放行;其余 API 401、页面重定向 `/login`。 - `req.user` 在中间件通过后挂上,**业务路由不要信客户端传的 user/body 里的 user**。 ### 5.8 `config.js` —— 配置加载与读写 @@ -509,7 +509,7 @@ sequenceDiagram A->>A: timingEqual(密码) A-->>U: 200 Set-Cookie: agent_token=+ JSON {user, token} Note over U: localStorage 存 token(APK 兜底) - U->>M: GET /api/* (Cookie 或 Authorization: Bearer) + U->>M: GET /api/* (Cookie;curl/脚本用 Authorization: Basic) M->>M: parseCookie / readToken / timingSafeEqual M->>M: req.user = username M-->>U: 业务路由 @@ -643,6 +643,7 @@ sequenceDiagram 13. **模型 tool_calls 不带 id** —— `runLoopInner` 兜底补 `'call_' + 随机串`(与 `tool_call_id` 落库一致,`buildMessages` 按 id 配对丢弃 errAck 关联回执)。 14. **编辑 SKILL.md 不会立即生效** —— 不需要重启,但需要 `routes/skills.js` 的 `refreshSkillPrompt()` 异步重建 system prompt 段落(fire-and-forget,扫描失败不影响 API 响应)。 15. **`pids_limit` 与 `ulimit` 区别** —— 前者是 cgroup pids 控制器算整个容器的进程+线程;后者是 per-process `RLIMIT_FSIZE` 等。被杀时 OOM kill vs SIGXFSZ 行为不同。 +16. **浏览器内双凭据身份分裂** —— 前端 `req()` 曾附加 sessionStorage 里的 Basic 头兜底 cookie,但 sessionStorage 按标签页隔离、刷新后残留(新标签页不继承,复制标签页则继承),cookie 是浏览器全局:A/B 切号登录后刷新旧标签页,会出现 `/api/me`(读 cookie)是 A、会话列表(Basic 优先于 cookie)是 B 的不一致,SSE(EventSource 只能带 cookie)又跟着 A。现已统一:浏览器身份只认 cookie(`req()` 不带 Basic 头,登录页不再存明文口令),服务端 `authUser` 也是 cookie 优先;Basic 仅供 curl/脚本无 cookie 时使用。 ---