fix(proxy): 青果检测改真探并按供应商分码,三面收口凭据外漏与「无法判定」

用户报「青果也要加检测」,往下挖出四层假象,一次收口:

- 后端:probeProxy 的青果短路(过去无条件回「提取成功(青果隧道端点,连接鉴权在客户端)」,
  依据的注释已过期——存下来的链接里就带 key/pwd)删掉,改成真打一次提取,按供应商返回码
  分档出独立 check_code:channel_busy / invalid_key / forbidden / rate_limited /
  insufficient_balance / tunnel_unverified。文案出口一律抹 key/pwd。
- 后端:巡检遇 channel_busy 不落库也不推通知。通道被占不是「密钥坏了」而是「此刻问不出
  结论」,而巡检自己那一发真提取就要占掉唯一一条通道——落库等于把用户早上看到的
  「代理异常」写成我们自己造成的。
- 后端:余量口径按供应商分档。青果账号此前会落进「否则查平台套餐」那条,界面显示的是
  别人家的 jikip 余量(串档);青果不提供可鉴权的余量/余额查询(余额接口是控制台
  appid/appkey 签名档),这一档宁可返回「查不了」也不借极客的数。
- 后端:SecretMasking.maskProxy 的脏值回落不再套 mask()——它保后 4 字符,而青果的 pwd=
  恰好挂在末尾,等于把口令尾 4 位交给界面与日志;改成只交「像 host 的那一段」。
- 用户端:去掉「青果账密直连,无需检测」的 disabled 例外,未保存账密现拼链接送检;
  「无法判定」回落改成后端文案原样显示+可重试语义;代理卡不再套 LLM 渠道字典
  (「龙抬头」错标的真根因就在这行)。
- 后管:货源标签拆成两张互不相通的字典,代理列只读 masked 且不回落到原文,删掉
  user-select:all 的全选复制旁路,「修改代理」改成重填 Authkey/Authpwd 的弹窗。

判据:SecretMaskingTest(5)、UserProxyBalanceServiceTest(6)、UserApiSecretServiceTest
(+1 巡检不落库)、UserApiSecretCheckServiceTest(+138 行分码)、ProxyLinkKeyTest、
用户端 node 5 支+mount 10 支、后管 node 9 支+mount 8 支。后端整量 5187/0 失败,
full 闸门四面绿。
This commit is contained in:
2026-11-02 15:18:41 +08:00
parent 7f5437d012
commit 7e64c12dd6
24 changed files with 2062 additions and 204 deletions
+23 -4
View File
@@ -5,10 +5,20 @@ import { unwrap } from './envelope'
export interface AdminUserSecretModule {
moduleKey: string
moduleLabel: string
/** 货源:LLM 行为渠道(longtaitou/t8star),代理行为供应商(qingguo/jikip)。 */
/**
* 货源:按模块分域,后端 `UserSecretModule.channelOrDefault` 已归一——
* LLM 行为渠道(longtaitou/t8star),代理行为供应商(qingguo/jikip)。
* ⚠ 界面不得用一张合表渲染这两域(代理行贴出「龙抬头」就是这么来的),
* 走 `user-secret-model.ts` 的 `moduleSourceLabel`。
*/
channel?: string | null
/** 脱敏值:代理列为 `scheme://host`,不含提取链接里的 key/pwd。 */
masked: string
/** 完整明文值:仅代理列有值(后端对密钥列不下发明文)。 */
/**
* 完整明文值:后台侧**恒为空**(2026-11-02 `SecretMasking.maskProxy` 收口,代理链接里带着账密)。
* 字段保留只为接口兼容;界面**不得**读它、更不得拿它做"masked 空就回落原文"的兜底,
* 也不许有任何复制/导出整条链接的旁路。
*/
full: string
exists: boolean
/** 是否由后台代填并锁定:锁定时客户端不可修改或清空。 */
@@ -100,13 +110,22 @@ export async function deleteUserSecret(userId: number): Promise<void> {
unwrap<unknown>(data)
}
/** 代填并锁定该用户某模块配置(当前仅代理):PUT /api/admin/user-secrets/{userId}/modules/{moduleKey} */
/**
* 代填并锁定该用户某模块配置(当前仅代理):PUT /api/admin/user-secrets/{userId}/modules/{moduleKey}
* `value` 是**一次性写载荷**(代理为现拼的提取链接,带着 key/pwd):调用方不得把它渲染回界面、
* 不得打进日志;`channel` 是同一单的货源(代理=供应商 key),后端据此选解析分支——
* 不给则由后端按链接域名识别,识别不出回落默认供应商,会静默换执行方,所以本面一律显式带上。
*/
export async function saveUserSecretModule(
userId: number,
moduleKey: string,
value: string,
channel?: string,
): Promise<AdminUserSecretModule> {
const { data } = await http.put(`/api/admin/user-secrets/${userId}/modules/${moduleKey}`, { value })
const { data } = await http.put(`/api/admin/user-secrets/${userId}/modules/${moduleKey}`, {
value,
...(channel ? { channel } : {}),
})
return unwrap<AdminUserSecretModule>(data)
}
@@ -0,0 +1,248 @@
<script setup lang="ts">
import { reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { saveUserSecretModule } from '@/api/user-secrets'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { actionableErrorText } from '@/components/admin-feedback'
import {
PROXY_MODULE_KEY,
buildProxyEntryPayload,
emptyProxyEntryDraft,
validateProxyEntry,
type ProxyEntryDraft,
} from './user-secret-model.ts'
/**
* 后台代填/改代理(2026-11-02 脱敏后重做的交互)。
*
* 旧交互是 `window.prompt` 预填 `row.proxy.full` 整条提取链接——后端把这条读路套上
* `SecretMasking.maskProxy` 之后 `full` 恒空,预填必然是空的,照旧保存等于把空串顶上去、
* 或让管理员去别处翻原文。现在收**账密**、链接在本机现拼现发:
* - 青果:填 Authkey + Authpwd,`composeQingguoLink` 拼(青果产品页没有可复制的链接);
* - 极客:填极客自己的提取链接(它有可复制的链接)。
* 拼好的链接是一次性写载荷,只进 PUT 请求体:不回显、不回填、不进 tooltip、不给复制/导出旁路;
* 保存成功即清空输入位,重开必然要从头再填(这是脱敏的应然后果,界面直接把它说出来)。
*/
const props = defineProps<{
modelValue: boolean
userId: number | null
username: string
/** 后端已登记的供应商(只是预选中的单选框,不是凭据)。 */
provider?: string | null
locked?: boolean
}>()
const emit = defineEmits<{ (e: 'update:modelValue', v: boolean): void; (e: 'saved'): void }>()
const draft = reactive<ProxyEntryDraft>(emptyProxyEntryDraft())
const errorText = ref('')
const busy = ref(false)
function resetDraft() {
Object.assign(draft, emptyProxyEntryDraft(props.provider))
errorText.value = ''
}
// 开与关都重刷:关的时候把已经打进内存的账密/链接抹掉,不留到下一次。
watch(() => props.modelValue, resetDraft)
function close() {
emit('update:modelValue', false)
}
async function save() {
if (props.userId == null) return
errorText.value = validateProxyEntry(draft)
if (errorText.value) return
const payload = buildProxyEntryPayload(draft)
if (!payload) {
errorText.value = '代理配置不完整,请重新填写'
return
}
busy.value = true
try {
await saveUserSecretModule(props.userId, PROXY_MODULE_KEY, payload.value, payload.channel)
showAdminFeedback(props.locked ? '已更新锁定代理' : '已代填并锁定代理', 'success')
emit('saved')
close()
} catch (error) {
// 文案以接口返回的 message 为准,前端不解释后端状态码
errorText.value = actionableErrorText(error)
showAdminFeedback(errorText.value, 'error')
} finally {
busy.value = false
Object.assign(draft, { authkey: '', authpwd: '', link: '' })
}
}
</script>
<template>
<div v-if="modelValue" class="modal-mask" @click.self="close">
<div class="modal" role="dialog" aria-modal="true" aria-labelledby="proxy-entry-title">
<h3 id="proxy-entry-title">{{ locked ? '改代理' : '代填代理' }}</h3>
<p class="modal-note">
为「{{ username || '该用户' }}」写入代理。出于凭据保护,后台不再下发已存的提取链接原文,
这里每次都重新填写;保存后界面只显示脱敏后的地址(不含 key/pwd)。
</p>
<div class="form-group">
<label>代理供应商</label>
<div class="radio-row">
<label class="radio-item">
<input v-model="draft.provider" type="radio" value="qingguo" />
<span>青果</span>
</label>
<label class="radio-item">
<input v-model="draft.provider" type="radio" value="jikip" />
<span>极客</span>
</label>
</div>
</div>
<template v-if="draft.provider === 'qingguo'">
<div class="form-group">
<label>Authkey</label>
<input v-model="draft.authkey" type="text" autocomplete="off" placeholder="青果产品页的 Authkey" />
</div>
<div class="form-group">
<label>Authpwd</label>
<input v-model="draft.authpwd" type="password" autocomplete="new-password" placeholder="青果产品页的 Authpwd" />
<span class="field-hint">青果只填 Authkey 会被判鉴权拒绝,两把都要填。</span>
</div>
</template>
<template v-else>
<div class="form-group">
<label>极客提取链接</label>
<input
v-model="draft.link"
type="password"
autocomplete="new-password"
placeholder="https://api.jikip.com/ip-get?..."
/>
<span class="field-hint">极客有可复制的提取链接,整条粘贴进来即可。</span>
</div>
</template>
<p v-if="errorText" class="modal-error">{{ errorText }}</p>
<div class="modal-actions">
<button class="btn" type="button" :disabled="busy" @click="save">
{{ busy ? '保存中…' : '保存' }}
</button>
<button class="btn btn-ghost" type="button" :disabled="busy" @click="close">取消</button>
</div>
</div>
</div>
</template>
<style scoped>
/* 与密钥列表页同一视觉语言(本页不用 el-* 标签:新增 el-* 要同步改按需注册表)。 */
.modal-mask {
position: fixed;
inset: 0;
z-index: 3000;
display: flex;
align-items: center;
justify-content: center;
padding: 40px 20px;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(6px);
}
.modal {
display: flex;
flex-direction: column;
width: min(520px, 100%);
max-height: 84vh;
padding: 22px 24px;
border: 1px solid #c7d7e5;
border-radius: 14px;
background: #ffffff;
box-shadow: 0 22px 60px rgba(39, 67, 94, 0.2);
overflow-y: auto;
color: #24384d;
font-family: inherit;
}
.modal h3 {
margin: 0 0 10px;
font-size: 15px;
font-weight: 650;
}
.modal-note {
margin: 0 0 14px;
color: #5b6f83;
font-size: 12.5px;
line-height: 1.65;
}
.form-group {
display: flex;
flex-direction: column;
gap: 7px;
margin-bottom: 14px;
}
.form-group label {
color: #5b6f83;
font-size: 12.5px;
font-weight: 600;
}
.form-group input[type='text'],
.form-group input[type='password'] {
min-width: 0;
min-height: 42px;
padding: 8px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13.5px;
font-family: inherit;
outline: none;
}
.radio-row {
display: flex;
gap: 18px;
}
.radio-item {
display: inline-flex;
align-items: center;
gap: 6px;
font-size: 13.5px;
font-weight: 500;
color: #24384d;
}
.field-hint {
color: #7d8fa1;
font-size: 12px;
line-height: 1.6;
}
.modal-error {
margin: 0 0 10px;
color: #b04a5a;
font-size: 12.5px;
line-height: 1.6;
}
.modal-actions {
display: flex;
gap: 10px;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 42px;
padding: 9px 18px;
border: 1px solid #4f78a5;
border-radius: 9px;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
font-family: inherit;
font-size: 13.5px;
cursor: pointer;
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.55;
}
.btn-ghost {
background: #ffffff;
border-color: #c7d7e5;
color: #4f78a5;
}
</style>
@@ -3,16 +3,22 @@ import { computed, onMounted, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { formatDateTime } from '@/utils/datetime'
import OldPagination from '@/components/OldPagination.vue'
import ProxyEntryDialog from './ProxyEntryDialog.vue'
import {
checkUserSecret,
clearUserSecretModule,
deleteUserSecret,
fetchUserSecretList,
saveUserSecretModule,
type AdminUserSecretModule,
type AdminUserSecretRow,
type GroupOption,
} from '@/api/user-secrets'
import {
PROXY_MODULE_KEY,
llmSourceLabel,
proxyDisplayText,
proxySourceLabel,
} from './user-secret-model.ts'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
@@ -37,8 +43,10 @@ const groupFilter = ref<number | null>(null)
const groupOptions = ref<GroupOption[]>([])
/** 正在检测的行 userId,用于按钮 loading 态。 */
const checkingId = ref<number | null>(null)
/** 正在代填/解锁代理的行 userId,避免重复点击。 */
/** 正在解锁代理的行 userId,避免重复点击(代填在弹窗里自己管 busy)。 */
const proxyBusyId = ref<number | null>(null)
/** 代填/改代理弹窗的目标行(脱敏后没有原文可预填,只能重填账密)。 */
const proxyDialog = ref<{ userId: number; username: string; provider: string | null; locked: boolean } | null>(null)
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
@@ -87,32 +95,28 @@ function moduleStatusMeta(module: AdminUserSecretModule | undefined) {
}
}
/** 单格悬停详情:完整值(代理为全量地址)+ 锁定说明 + 检测消息 + 检测时间 + 耗时。 */
/**
* 单格悬停详情:后端下发的**脱敏值** + 锁定说明 + 检测消息 + 检测时间 + 耗时。
* ⚠ 只读 `masked`:`full` 在后台侧恒空(2026-11-02 `SecretMasking.maskProxy` 收口),
* 这里不做任何「masked 空就回落原文」的兜底,也不给复制整条链接的旁路。
*/
function moduleTooltip(module: AdminUserSecretModule | undefined) {
if (!module || !module.exists) return '未配置'
const parts: string[] = []
if (module.full) parts.push(module.full)
if (module.locked) parts.push('已由后台代填并锁定:客户端不可修改或清空')
const display = String(module.masked || '').trim()
if (display) {
parts.push(isProxyModule(module) ? `代理地址(已脱敏,不含 key/pwd):${display}` : `密钥:${display}`)
}
if (module.locked) parts.push('已由后台代填并锁定:客户端不可修改或清空,改代理需重新填写账密')
if (module.checkMessage) parts.push(module.checkMessage)
if (module.checkedAt) parts.push(`检测时间:${formatDateTime(module.checkedAt)}`)
if (module.checkLatencyMs != null) parts.push(`耗时:${module.checkLatencyMs}ms`)
return parts.join(';') || '暂无检测记录'
}
/** 货源标签:LLM 密钥显示渠道(龙抬头/贞贞),代理显示供应商(青果/极客)。 */
function sourceLabel(channel: string | null | undefined) {
switch (String(channel || '').trim().toLowerCase()) {
case 'longtaitou':
return '龙抬头'
case 't8star':
return '贞贞'
case 'qingguo':
return '青果'
case 'jikip':
return '极客'
default:
return '—'
}
/** 该格是不是代理模块:按后端下发的 moduleKey 判,货源标签与文案都走这一条口径。 */
function isProxyModule(module: AdminUserSecretModule) {
return String(module.moduleKey || '').trim().toLowerCase() === PROXY_MODULE_KEY
}
/** 分组列文案:优先分组名;未建分组的用户回退展示所属主管,便于判断归属。 */
@@ -206,38 +210,33 @@ async function remove(row: AdminUserSecretRow) {
}
}
/** 代填并锁定代理:写入后客户端只能查看,修改/清空会被服务端拒绝。 */
async function fillProxy(row: AdminUserSecretRow) {
const who = row.username || `UID ${row.userId}`
const value = window.prompt(
`代填「${who}」的代理地址(保存后客户端不可修改或清空,如需变更先解锁):`,
row.proxy?.full || '',
)
if (value == null) return
const trimmed = value.trim()
if (!trimmed) {
ElMessage.warning('代理地址不能为空')
return
}
proxyBusyId.value = row.userId
try {
await saveUserSecretModule(row.userId, 'proxy', trimmed)
ElMessage.success(row.proxy?.locked ? '已更新锁定代理' : '已代填并锁定代理')
load()
} catch (error) {
showAdminFeedback(error instanceof Error ? error.message : '代填失败', 'error')
} finally {
proxyBusyId.value = null
/**
* 打开代填/改代理弹窗。
* ⚠ 不预填任何已有值:后台侧 `full` 恒空(代理链接里带着 key/pwd,2026-11-02 收口后不再下发),
* 所以这一单的语义就是「重新填账密」,界面上也没有把原文取回来的旁路。
*/
function openProxyDialog(row: AdminUserSecretRow) {
proxyDialog.value = {
userId: row.userId,
username: row.username || `UID ${row.userId}`,
provider: row.proxy?.channel ?? null,
locked: Boolean(row.proxy?.locked),
}
}
/** 弹窗保存成功:关掉并重新取数(列表只拿脱敏值,不参与拼装)。 */
function onProxySaved() {
proxyDialog.value = null
load()
}
/** 解锁代理:清空后台代填值,该用户恢复自行配置。 */
async function unlockProxy(row: AdminUserSecretRow) {
const who = row.username || `UID ${row.userId}`
if (!(await openAdminConfirm({ message: `确定解除「${who}」的代理锁定吗?解锁后当前后台代理值会被清空,客户端恢复自行配置。`, danger: true }))) return
proxyBusyId.value = row.userId
try {
await clearUserSecretModule(row.userId, 'proxy')
await clearUserSecretModule(row.userId, PROXY_MODULE_KEY)
ElMessage.success('已解锁')
load()
} catch (error) {
@@ -328,7 +327,7 @@ onMounted(load)
<span v-if="row.similarAsin?.exists" class="mono-mask" :title="moduleTooltip(row.similarAsin)">{{ row.similarAsin.masked }}</span>
<span v-else class="empty-value">未配置</span>
<span v-if="row.similarAsin?.exists" class="wh-pill is-source" title="该用户这把密钥所属渠道">
{{ sourceLabel(row.similarAsin.channel) }}
{{ llmSourceLabel(row.similarAsin.channel) }}
</span>
<span class="wh-pill" :class="moduleStatusMeta(row.similarAsin).tone" :title="moduleTooltip(row.similarAsin)">
{{ moduleStatusMeta(row.similarAsin).label }}
@@ -340,7 +339,7 @@ onMounted(load)
<span v-if="row.appearancePatent?.exists" class="mono-mask" :title="moduleTooltip(row.appearancePatent)">{{ row.appearancePatent.masked }}</span>
<span v-else class="empty-value">未配置</span>
<span v-if="row.appearancePatent?.exists" class="wh-pill is-source" title="该用户这把密钥所属渠道">
{{ sourceLabel(row.appearancePatent.channel) }}
{{ llmSourceLabel(row.appearancePatent.channel) }}
</span>
<span class="wh-pill" :class="moduleStatusMeta(row.appearancePatent).tone" :title="moduleTooltip(row.appearancePatent)">
{{ moduleStatusMeta(row.appearancePatent).label }}
@@ -349,11 +348,11 @@ onMounted(load)
</td>
<td>
<div class="module-cell module-cell--stack">
<span v-if="row.proxy?.exists" class="mono-mask mono-full" :title="moduleTooltip(row.proxy)">{{ row.proxy.full || row.proxy.masked }}</span>
<span v-if="row.proxy?.exists" class="mono-mask" :title="moduleTooltip(row.proxy)">{{ proxyDisplayText(row.proxy) }}</span>
<span v-else class="empty-value">未配置</span>
<span class="module-cell-pills">
<span v-if="row.proxy?.exists" class="wh-pill is-source" title="该用户代理所属供应商">
{{ sourceLabel(row.proxy.channel) }}
{{ proxySourceLabel(row.proxy.channel) }}
</span>
<span class="wh-pill" :class="moduleStatusMeta(row.proxy).tone" :title="moduleTooltip(row.proxy)">
{{ moduleStatusMeta(row.proxy).label }}
@@ -387,8 +386,7 @@ onMounted(load)
<button
class="btn btn-sm btn-ghost"
type="button"
:disabled="proxyBusyId === row.userId"
@click="fillProxy(row)"
@click="openProxyDialog(row)"
>
{{ row.proxy?.locked ? '改代理' : '代填代理' }}
</button>
@@ -416,6 +414,16 @@ onMounted(load)
</div>
<OldPagination :total="total" :page="page" :page-size="pageSize" @change="changePage" @size-change="changeSize" />
</section>
<ProxyEntryDialog
:model-value="proxyDialog != null"
:user-id="proxyDialog?.userId ?? null"
:username="proxyDialog?.username ?? ''"
:provider="proxyDialog?.provider ?? null"
:locked="Boolean(proxyDialog?.locked)"
@update:model-value="(open: boolean) => { if (!open) proxyDialog = null }"
@saved="onProxySaved"
/>
</div>
</template>
@@ -601,7 +609,7 @@ h3 {
gap: 8px;
min-width: 0;
}
/* 代理列:完整地址独占一行,状态药丸另起一行,避免长地址被药丸挤压折行 */
/* 代理列:脱敏地址独占一行,状态药丸另起一行(列宽按最长药丸文案留的,不按整条链接) */
.module-cell--stack {
flex-direction: column;
align-items: flex-start;
@@ -612,18 +620,9 @@ h3 {
overflow: hidden;
text-overflow: ellipsis;
}
/* 代理列展示完整明文:允许折行显示,不截断、不省略 */
.module-cell .mono-full {
flex: 1 1 auto;
min-width: 0;
overflow: visible;
text-overflow: clip;
white-space: normal;
overflow-wrap: anywhere;
line-height: 1.45;
cursor: text;
user-select: all;
}
/* 代理列只显示后端脱敏后的 scheme://host(短串,单行足够)。
这里**不许**再出现"允许折行展示完整明文 + user-select:all"那套样式:
它等于给整条带 key/pwd 的链接做了一键全选复制的旁路(2026-11-02 脱敏收口时一并拆掉)。 */
.mono-mask {
font-family: Consolas, "Cascadia Mono", monospace;
font-size: 12.5px;
@@ -0,0 +1,151 @@
/**
* 密钥管理页的纯逻辑模型(货源标签 + 代理重填)。
*
* 两条收口都在这个文件里,页模板只调这里导出的函数,不各写各的字典:
*
* 1. **货源标签按模块分字典**(2026-11-02 修):原先 `UserSecretsPage.vue` 里是一整张
* `sourceLabel()`,把 LLM 渠道(longtaitou/t8star)与代理供应商(qingguo/jikip)混在同一个
* switch 上,于是「按值匹配」的字典会把它认识的**任何**值贴到**任何**列上——代理行因此能长出
* 「龙抬头」这种标签。后端 VO 的 `channel` 本来就是按模块归一的(`UserSecretModule.channelOrDefault`
* 代理走 `ProxyProvider`、密钥走 `LlmChannel`),所以错标只会来自前端这张合表。
* 现在两张表互不相通:代理列只认供应商、密钥列只认渠道,跨域的值一律落到「—」而不是被硬认下来。
*
* 2. **代理列不再显示、也不再回传原文**(2026-11-02 后端 `SecretMasking.maskProxy` 收口):
* `AdminUserSecretModuleVo.full` 后台侧恒为空,界面只读 `masked`(`scheme://host`,不含
* key/pwd)。因此原先「代填/改代理」用 `window.prompt` 预填整条链接的交互已失效
* (预填必然是空的,保存还会把空串顶上去)——改成重新填账密:青果填 Authkey/Authpwd、
* 由 `composeQingguoLink` 现拼;极客按其产品口径填自家提取链接。
* ⚠ 拼出来的链接是一次性写请求的载荷,**不得**回显、回填、进 tooltip、进剪贴板。
*
* 零 `@/` 别名依赖:本文件被 `node --test` 直测(那颗 runner 不认 Vite 别名)。
*/
import { composeQingguoLink } from '../../shared/utils/qingguo-link.ts'
export type LlmChannelKey = 'longtaitou' | 't8star'
export type ProxyProviderKey = 'qingguo' | 'jikip'
/** 代理模块 key(与后端 `UserSecretModule.PROXY.key()` 同值):写请求的路径段与「这一格是代理」的判据。 */
export const PROXY_MODULE_KEY = 'proxy'
/** 后端 `ProxyProvider.DEFAULT`=极客:新建默认极客,青果手动切(2026-10-30 拍板)。 */
export const DEFAULT_PROXY_PROVIDER: ProxyProviderKey = 'jikip'
/** 认不出的货源一律这个占位,不许回退成"某个具体渠道名"(那正是错标的来源)。 */
export const UNKNOWN_SOURCE_LABEL = '—'
const LLM_CHANNEL_LABELS: Record<LlmChannelKey, string> = {
longtaitou: '龙抬头',
t8star: '贞贞',
}
const PROXY_PROVIDER_LABELS: Record<ProxyProviderKey, string> = {
qingguo: '青果',
jikip: '极客',
}
function normalizeKey(raw: unknown): string {
return String(raw ?? '').trim().toLowerCase()
}
function known<T extends string>(table: Record<T, string>, raw: unknown): string | null {
const key = normalizeKey(raw)
return Object.prototype.hasOwnProperty.call(table, key)
? table[key as T]
: null
}
/** LLM 密钥列的渠道名:只查 LLM 字典,代理供应商的值在这里认不出。 */
export function llmSourceLabel(channel: string | null | undefined): string {
return known(LLM_CHANNEL_LABELS, channel) ?? UNKNOWN_SOURCE_LABEL
}
/**
* 代理列的供应商名:只查供应商字典。
* 传进 LLM 渠道值(`longtaitou`/`t8star`)必须返回占位——这条是"代理行贴龙抬头"的直接判据。
*/
export function proxySourceLabel(channel: string | null | undefined): string {
return known(PROXY_PROVIDER_LABELS, channel) ?? UNKNOWN_SOURCE_LABEL
}
/**
* 归一为可选供应商;未知值不猜,返回 null 让调用方保持原选择。
*/
export function asProxyProvider(raw: unknown): ProxyProviderKey | null {
const key = normalizeKey(raw)
return key === 'qingguo' || key === 'jikip' ? key : null
}
/**
* 代理列的唯一显示文本:后端下发的 `masked`(青果形状 `https://overseas.proxy.qg.net`)。
* 刻意**不读** `full`,也不做任何"masked 空就回落到原文"的兜底——回落等于把脱敏前的行为留在界面里。
*/
export function proxyDisplayText(module: { masked?: string | null } | null | undefined): string {
const masked = String(module?.masked ?? '').trim()
return masked || UNKNOWN_SOURCE_LABEL
}
/** 代填/改代理的表单草稿:青果用前三个字段,极客用 `link`。 */
export interface ProxyEntryDraft {
provider: ProxyProviderKey
authkey: string
authpwd: string
link: string
}
/**
* 空草稿:`provider` 用后端已登记的那一列预置(只是选中的单选框,不是凭据),
* 三个输入位**一律空**——脱敏后没有任何原文可回填。
*/
export function emptyProxyEntryDraft(currentProvider?: string | null): ProxyEntryDraft {
return {
provider: asProxyProvider(currentProvider) ?? DEFAULT_PROXY_PROVIDER,
authkey: '',
authpwd: '',
link: '',
}
}
/** 与后端 `PROXY_FORMAT_HINT` 同一句口径:本函数只做前置提示,真判仍在服务端。 */
const PROXY_LINK_FORMAT_HINT =
'代理地址格式不正确,请填写 http://host:port 形式的代理地址,或代理服务商的提取链接(https://...)'
/** http(s) + 有主机名:镜像后端 `validateProxyValue`,不在前端扩大判死范围。 */
function isHttpUrl(raw: string): boolean {
try {
const parsed = new URL(raw)
return (parsed.protocol === 'http:' || parsed.protocol === 'https:') && Boolean(parsed.hostname)
} catch {
return false
}
}
/**
* 校验草稿,返回给界面显示的文案(空串=可以提交)。
* 点名"缺哪把":缺 pwd 时青果回 `API_AUTH_DENY`,所以两把都得填,不能只填 key 就当配好了。
*/
export function validateProxyEntry(draft: ProxyEntryDraft): string {
if (!asProxyProvider(draft.provider)) return '请选择代理供应商'
if (draft.provider === 'qingguo') {
if (!String(draft.authkey || '').trim()) return '请填写青果 Authkey'
if (!String(draft.authpwd || '').trim()) return '请填写青果 Authpwd(只填 Authkey 青果会判鉴权拒绝)'
return ''
}
const link = String(draft.link || '').trim()
if (!link) return '请填写极客提取链接'
if (!isHttpUrl(link)) return PROXY_LINK_FORMAT_HINT
return ''
}
/**
* 组装 PUT `/api/admin/user-secrets/{userId}/modules/proxy` 的请求体。
* 不合法返回 null(调用方不得把 null 顶上去,更不得拿旧值凑数)。
*/
export function buildProxyEntryPayload(
draft: ProxyEntryDraft,
): { value: string; channel: ProxyProviderKey } | null {
if (validateProxyEntry(draft)) return null
if (draft.provider === 'qingguo') {
return { value: composeQingguoLink(draft.authkey, draft.authpwd), channel: 'qingguo' }
}
return { value: String(draft.link || '').trim(), channel: 'jikip' }
}
@@ -0,0 +1,26 @@
/**
* 青果提取链接的拼装(后管侧镜像)。
*
* 正本在**用户端那棵前端树**的同名文件 `src/shared/utils/qingguo-link.ts`。两棵前端树各自独立构建
* (各自的 vite root 与 tsconfig include),跨树 import 会把用户端拖进后管的产物图(本仓
* `src/config/workspace.ts` 的边界尺子也判这种耦合为违规),所以这里按**同名同形**镜像一份,
* 而不是另起一套新逻辑:口径只有一条
* `https://overseas.proxy.qg.net/get?key=<Authkey>&pwd=<Authpwd>`
* 改这一条 URL 时必须两边同改(用户端那份有 `node --test` 判据钉着)。
*
* 业务背景(2026-10-31 用户口径、2026-11-02 后台脱敏收口):青果**没有**可填的提取链接,
* 产品页只给 Authkey / Authpwd 两个值;后台「代填/改代理」因此改成收这两个值、在这里拼,
* 界面上任何时候都不再把拼好的链接回显或留档(链接里带着 pwd)。
*
* ⚠ 本文件保持**零依赖**:`node --test` 不认 Vite 的 `@/` 别名,带别名的模块进不了
* `tests/*.test.ts`,这条拼装规则就没法被用例钉住。
*/
export const QINGGUO_EXTRACT_URL = 'https://overseas.proxy.qg.net/get'
export function composeQingguoLink(account: string, password: string): string {
const key = (account || '').trim()
if (!key) return ''
const pwd = (password || '').trim()
const query = `key=${encodeURIComponent(key)}` + (pwd ? `&pwd=${encodeURIComponent(pwd)}` : '')
return `${QINGGUO_EXTRACT_URL}?${query}`
}