feat(密钥管理): 后台可代填并锁定用户代理设置,客户端只读并回填本地配置

代理是选配、不进 items 也不参与门禁,但客户端各任务链读的是本地 app.json 的
proxy_url,用户自填值与后台不一致时排查成本高。改法:

- 后台 PUT/DELETE /api/admin/user-secrets/{userId}/modules/{moduleKey} 代填/解锁,
  写入后该行 source=admin;数据权限走 resolveVisibleUserIds,超管不限;
- 客户端 save/clear 命中锁定行时服务端直接拒绝并给出原因(只置灰挡不住直接调接口);
- 密钥包把代理单独放 proxy 字段下发(仍不进 items、不影响 complete 判定),
  锁定时带 full 明文,客户端据此幂等地对齐本地配置;解锁 = 删除该行。

只开放代理代填:密钥模块要客户端提交任务时携带本地明文,代填会把用户卡死。
This commit is contained in:
2026-09-28 19:39:08 +08:00
parent 5dd11f7048
commit 8b4425dcbf
12 changed files with 583 additions and 20 deletions
+80
View File
@@ -3,8 +3,10 @@ import assert from 'node:assert/strict'
import { http } from '../src/shared/api/http.ts'
import {
clearApiSecretCache,
getServerProxySnapshot,
getStoredApiSecret,
getStoredApiSecretSnapshot,
listApiSecretModules,
loadApiSecrets,
saveApiSecret,
} from '../src/shared/utils/api-secret-store.ts'
@@ -70,6 +72,26 @@ function bundleResponse(items: unknown[]) {
const LEGACY_MIRROR_KEY = 'brand:api-secret:42:appearance-patent'
/** 桌面桥(pywebview)模拟:后台锁定代理回填本地配置依赖 read_config/save_config。 */
function attachDesktopBridge(
readConfig: () => Record<string, unknown>,
saveConfig: (patch: Record<string, unknown>) => Record<string, unknown>,
) {
const win = (globalThis as Record<string, unknown>).window as Record<string, unknown>
win.pywebview = {
api: { read_config: readConfig, save_config: saveConfig },
}
}
function lockedProxyBundle(proxy: Record<string, unknown>) {
return {
items: [serverItem('appearance-patent'), serverItem('similar-asin')],
requiredModules: ['appearance-patent', 'similar-asin'],
complete: false,
proxy: { ...serverItem('proxy'), ...proxy },
}
}
test('test_secret_store_reads_legacy_value_before_load', () => {
const { localStorage } = setupWindow()
clearApiSecretCache()
@@ -130,3 +152,61 @@ test('test_secret_store_save_rejects_empty_value', async () => {
clearApiSecretCache()
await assert.rejects(() => saveApiSecret('similar-asin', ' '), /密钥不能为空/)
})
test('test_secret_store_locked_proxy_aligns_local_config_once', async (t) => {
setupWindow()
clearApiSecretCache()
const fullUrl = 'https://api.jikip.com/ip-get?num=1&key=abc'
let config: Record<string, unknown> = { proxy_users: { '42': { proxy_url: '', proxy_mode: 2 } } }
const saveCalls: Array<Record<string, unknown>> = []
attachDesktopBridge(
() => config,
(patch) => {
saveCalls.push(patch)
const patchUsers = patch.proxy_users as Record<string, unknown> | undefined
config = {
...config,
...patch,
proxy_users: { ...(config.proxy_users as Record<string, unknown>), ...(patchUsers || {}) },
}
return config
},
)
mockRequest(t, (req) => {
if ((req.url || '').includes('/migrate')) return okResponse({ migrated: 0 })
return okResponse(lockedProxyBundle({ exists: true, locked: true, full: fullUrl, masked: 'https://api.jikip.com' }))
})
await loadApiSecrets({ force: true })
assert.equal(saveCalls.length, 1, '首次加载应把后台锁定代理写入本地配置')
const users = saveCalls[0].proxy_users as Record<string, { proxy_url: string; proxy_mode: number }>
assert.equal(users['42'].proxy_url, fullUrl)
assert.equal(users['42'].proxy_mode, 2, '写入时应保留用户原有的代理模式')
const snapshot = getServerProxySnapshot()
assert.equal(snapshot?.locked, true)
assert.equal(snapshot?.full, fullUrl)
await loadApiSecrets({ force: true })
assert.equal(saveCalls.length, 1, '本地配置已一致时不应重复写入')
})
test('test_secret_store_locked_proxy_not_in_module_cards', async (t) => {
setupWindow()
clearApiSecretCache()
mockRequest(t, () =>
okResponse(lockedProxyBundle({ exists: true, locked: true, full: 'https://api.jikip.com/ip-get?num=1&key=abc' })),
)
const state = await loadApiSecrets({ force: true })
assert.equal(state, 'incomplete')
assert.equal(getServerProxySnapshot()?.locked, true)
assert.deepEqual(
listApiSecretModules().map((item) => item.moduleKey),
['appearance-patent', 'similar-asin'],
'代理不进模块卡片(不占门禁)',
)
clearApiSecretCache()
assert.equal(getServerProxySnapshot(), null, '登出清理应重置服务端代理状态')
})