Files
crawler-plugin/frontend-vue/src/shared/auth/user-token-bridge.ts
T
huangzd1997 d538935146 feat(A1/A3+C8): 客户端令牌链路打通(按人鉴权就绪)+ 快照 JSON 写入节流
A1/A3 客户端令牌链路(服务端守卫已能按 JWT 鉴权,缺口在客户端不带身份)
- 前端:新增 user-token-bridge(纯逻辑,值变化才推送)+ user-token-sync(启动安装,
  pywebviewready/storage/60s 轮询补推),main.ts 接入;桥接口补 set_user_token
- 客户端:新增 crawler_core/user_token.py(持有 + 对自家 Java 端点注入
  Authorization: Bearer <jwt>,Session.request 包装,第三方域名不注入、已有头不覆盖、
  登出清空、SHUFUAI_DISABLE_USER_TOKEN_HOOK 可关);main.py 暴露桥方法并在启动安装钩子
- 服务端:守卫契约测试补 5 个用户态前缀用例(开关关闭放行 / 打开后匿名 401 /
  用户令牌通过 / 内部令牌仍放行 / /api/ziniao 第二层)
- 翻开关的前置条件(客户端铺开后置 aiimage.security.user-tool-guard-enabled=true)写入报告

C8 快照 JSON 写入节流
- 读端改以 biz_task_result_item 行为准、JSON 仅兜底(历史任务 JSON 仍是唯一副本时可用)
- 整档 JSON 改 30s 节流写,终态路径 force 立即写;新增 2 个契约测试钉住语义

验证:mvn test 2888 全绿;npm test 741 全绿;user_token 钩子自测(注入/归一/第三方跳过/不覆盖/登出)通过
2026-09-14 10:20:15 +08:00

57 lines
1.9 KiB
TypeScript

/**
* 登录态令牌 → 桌面端 Python 的同步(全维度审查 A1/A3)。
*
* 桌面端页面登录后令牌只存在 localStorage 里,Python 侧的采集/回传调用不带身份,
* 服务端只能匿名放行(内部令牌硬编码在客户端源码里,等同公开)。
* 这里把**变化过**的令牌推给桌面桥,Python 侧据此给自家 Java 请求带上 Authorization 头,
* 服务端即可按登录用户鉴权。
*
* 本模块刻意不 import 任何桥/运行时模块(纯逻辑,可在 Node 下单测);
* 真实推送目标由 user-token-sync.ts 在应用启动时注入。
*/
/** 推送目标(真实实现走桌面桥;测试可注入替身) */
export interface TokenPushTarget {
push: (value: string) => void
}
/** 上次推送给桥的值;null 表示尚未推送过(首次空值也推一次,便于清空上一轮会话) */
let lastPushed: string | null = null
/** 当前生效的推送目标(由 user-token-sync.ts 安装) */
let installedTarget: TokenPushTarget | null = null
/** 安装/替换推送目标;传 null 表示当前没有可用的桥。 */
export function setUserTokenPushTarget(target: TokenPushTarget | null): void {
installedTarget = target
}
/**
* 把登录态令牌同步给 Python(值变化才推送)。返回是否真的推送了。
*
* @param target 省略时用已安装的目标;显式传 null 表示"没有可用的桥"(不推送)
*/
export function syncUserTokenToBridge(token: string, target?: TokenPushTarget | null): boolean {
const value = (token || '').trim()
if (value === lastPushed) {
return false
}
const resolved = target === undefined ? installedTarget : target
if (!resolved) {
return false
}
lastPushed = value
try {
resolved.push(value)
return true
} catch {
return false
}
}
/** 仅供测试:重置状态 */
export function resetUserTokenBridgeStateForTest(): void {
lastPushed = null
installedTarget = null
}