前三篇解决了代码交付和原生 UI 扩展。接下来,我们需要让已有企业账号进入定制后的 DSH 首页,并让部分业务页面复用登录状态。
这里有三个容易混淆的身份:业务系统里的用户、本机 DSH Host 的调用者,以及模型服务的使用者。三者会出现在同一个桌面应用里,却承担不同的授权职责。
把业务身份与模型身份分开
模型 API key 可用,只能说明模型请求可能成功。它不能证明用户可以查看某份业务资料。同样,业务账号登录成功,也不意味着模型已经配置完成。
因此在正常运行路径中,原生主页的进入条件由业务身份检查决定,模型配置由原有模型机制处理。本机 Host 还保留自己的认证边界,避免任意网页因为和客户端运行在同一台电脑上,就能调用文件或 Agent 能力。
工程另有未打包开发模式专用的主页预览入口。它可以显示界面,但不会建立业务身份,也不会授予业务权限。因此单凭"看到了主页"仍不能判断登录成功。
这一划分也改善了错误定位:业务接口返回未登录、Host 拒绝调用和模型服务认证失败,应当分别解释,不能统一归成"登录失败"。
由主进程持有登录生命周期
本次普通密码链路可以简化为:
身份服务的长期 token 由服务端保存和轮换。客户端使用隔离业务会话中的 Cookie,登录页和业务页面都不需要读取这些 token。
主进程也不会仅凭"跳到了完成地址"就放行。页面导航只是一次信号,主进程仍要查询业务身份,确认会话已经建立。
HTTP 成功、业务成功和身份有效分别判断
联调中出现过一种误导性响应:HTTP 状态是失败,响应体却带着成功业务码和"请求成功"。还有一种情况是登录接口返回成功摘要,但其中没有完整用户身份。
处理这些响应时,需要按层检查。下面是简化后的判断顺序,具体身份结构由项目定义:
javascript
if (!response.ok) {
throw new Error(`Authentication endpoint returned HTTP ${response.status}`)
}
if (body.code !== '10000' || body.success !== true) {
throw new Error('Business authentication was rejected')
}
// 登录摘要成功后,继续调用当前用户接口,验证有效身份。
await verifyCurrentBusinessIdentity()
verifyCurrentBusinessIdentity 在这里代表项目自己的复核逻辑,并非 DSH 内置 API。
Cookie 存在也不是充分条件:它可能已经过期、对应旧会话,或者并未被后端接受。进入主页的依据应来自有效身份检查。
复用业务页面时,只开放必要动作
原生主窗口需要复用已有 Web 页面,但这些页面不需要获得完整的原生桥。
项目为业务页面保留受限的认证通道,用于请求刷新登录、重新登录和退出。消息处理同时检查来源、所属框架、消息结构和允许的动作;主进程仍然验证 IPC 调用者。
这与给页面提供一个"任意 IPC 调用"方法有很大差别。受限通道的能力可以直接列举,也便于对每个动作编写测试。
同样,业务代理拥有进程内调用凭证。普通业务页面不需要拿到凭证字符串,更不需要自行构造能够访问任意 Host 接口的请求。
退出是一次状态转换
只删除页面里的用户信息,会留下明显漏洞:原生主窗口还可以从托盘重新显示,在途请求也可能把旧身份写回来。
我们的处理顺序是先隐藏主窗口并暂停相关访问,再清理本机业务登录状态和释放相关资源。远端退出失败时,应分别记录本机清理和远端吊销的结果。
重新登录后,主进程复核新身份,重载原生 Client 和业务面板,再恢复工作台。异步响应还需要检查当前认证版本,拒绝退出前或旧账号发起的迟到结果。
本地工作空间是否按账号隔离,则属于另外的产品规则。接入企业登录本身不会自动建立一套账号间数据迁移方案。
联调要覆盖整个生命周期
最小的验证范围应包括首次登录、已有会话启动、会话失效、退出与重新登录,以及退出期间到达的异步响应。涉及续登时,还要实际检查服务端部署、Cookie 配置和身份服务有效期。
历史记录中既有真实开发客户端可登录的确认,也有后续重启停在登录页、某环境路由未部署的情况。它们属于不同时间和环境,不能合并成"所有认证流程均已完成验收"。
完成身份边界之后,下一篇把认证后的能力接入本地 Agent:由 Host 注册工具、通过受控通道调用业务代理,并接入 DSH 现有审批流程。