fix(界面文案): 前端两棵树加 userNotice 闸——非中文提示语一律换成中文句

后端仍有出口把底层异常原文写进 error_message / fileError / 匹配原因 / 响应 message,逐条翻译
跟不上新增;用户 2026-10-09 要求整个项目的提示语都用中文,所以把规矩做进界面出口。

规则:原文含中文照原样透出;整条无中文换成中文兜底句;**含中文但冒号后是纯英文尾巴的剥掉尾巴**
("转换结果打包失败: No space left on device" 只留主干)。被隐去的原文进 console 供核对日志。

闸口:用户端 http.ts 的 extractErrorMessage 五条返回路径与 unwrapJavaResponse、后台 envelope 的
textOf/errorTextOf、13 处任务卡 `错误:${item.error}`、2 处 fileError 兜底句、发布页文件错误与
匹配原因函数、dispatch-guard 的解析失败原因清单、22 处 ElMessage.error(result.error) 型展示、
后台看板与数字人详情页两处模板。

尺子:frontend-vue/tests/user-notice-chinese-only-guard.test.ts、admin-frontend-vue/tests/user-notice-chinese-only.test.ts
(分母硬钉+内存造违例自证+摘壳写法仍计入分母);source-pin 台账只登记本轮新增那一个文件,
别人的在飞格子没重算。node --test 用户端 782/782、后台 1782/1782,两棵树 vue-tsc 均 rc=0。
This commit is contained in:
2026-10-09 19:34:54 +08:00
parent 9ecc9f30fb
commit 0bf21b84f0
34 changed files with 396 additions and 78 deletions
@@ -43,21 +43,21 @@ test('legacy success shape keeps msg-compatible fields', () => {
test('extractErrorMessage reads error field first', () => {
const err = new AxiosError('http', undefined, undefined, undefined,
{ status: 500, data: { error: 'E1', message: 'M', msg: 'm' } } as never)
assert.equal(extractErrorMessage(err), 'E1')
{ status: 500, data: { error: '错误一', message: '消息一', msg: '兜底一' } } as never)
assert.equal(extractErrorMessage(err), '错误一')
})
test('extractErrorMessage falls back to message/msg/string/generic', () => {
const withMessage = new AxiosError('http', undefined, undefined, undefined,
{ status: 500, data: { message: 'M', msg: 'm' } } as never)
assert.equal(extractErrorMessage(withMessage), 'M')
{ status: 500, data: { message: '消息一', msg: '兜底一' } } as never)
assert.equal(extractErrorMessage(withMessage), '消息一')
const withMsg = new AxiosError('http', undefined, undefined, undefined,
{ status: 500, data: { msg: 'm' } } as never)
assert.equal(extractErrorMessage(withMsg), 'm')
{ status: 500, data: { msg: '兜底一' } } as never)
assert.equal(extractErrorMessage(withMsg), '兜底一')
const stringBody = new AxiosError('http', undefined, undefined, undefined,
{ status: 500, data: 'plain-body' } as never)
assert.equal(extractErrorMessage(stringBody), 'plain-body')
const messageOnly = new AxiosError('boom')
assert.equal(extractErrorMessage(messageOnly), 'boom')
{ status: 500, data: '纯文本响应体' } as never)
assert.equal(extractErrorMessage(stringBody), '纯文本响应体')
const messageOnly = new AxiosError('网络请求失败')
assert.equal(extractErrorMessage(messageOnly), '网络请求失败')
assert.equal(extractErrorMessage(null), '请求失败')
})
+20 -6
View File
@@ -29,21 +29,35 @@ test('test_extract_msg_field', () => {
})
test('test_extract_error_precedence', () => {
const error = makeAxiosError(400, { error: 'e1', message: 'm1', msg: 'm2' })
assert.equal(extractErrorMessage(error), 'e1', 'error 应优先')
const error = makeAxiosError(400, { error: '错误字段优先', message: '消息字段', msg: 'msg 字段' })
assert.equal(extractErrorMessage(error), '错误字段优先', 'error 应优先')
const noError = makeAxiosError(400, { message: 'm1', msg: 'm2' })
assert.equal(extractErrorMessage(noError), 'm1', '无 error 时 message 优先于 msg')
const noError = makeAxiosError(400, { message: '消息字段', msg: 'msg 字段' })
assert.equal(extractErrorMessage(noError), '消息字段', '无 error 时 message 优先于 msg')
})
test('test_extract_string_body', () => {
const error = makeAxiosError(502, 'Bad Gateway 网关错误')
assert.equal(extractErrorMessage(error), 'Bad Gateway 网关错误')
assert.equal(extractErrorMessage(error), 'Bad Gateway 网关错误', '带中文的响应体照原样透出')
})
test('test_extract_fallback_message', () => {
const error = makeAxiosError(500, {})
assert.equal(extractErrorMessage(error), 'Request failed with status code 500')
assert.equal(extractErrorMessage(error), '请求失败',
'axios 自带的英文原文不许给用户看,回退到中文默认句')
})
test('test_extract_english_payload_is_replaced_by_chinese', () => {
const cases = [
makeAxiosError(400, { error: 'Similar ASIN result rows are empty' }),
makeAxiosError(500, { message: 'transient storage is not configured' }),
makeAxiosError(500, 'Internal Server Error'),
]
for (const error of cases) {
const shown = extractErrorMessage(error)
assert.ok(!/^[A-Za-z]/.test(shown), '英文提示语不该出现在界面上: ' + shown)
assert.ok(/[一-鿿]/.test(shown), '兜底必须是中文: ' + shown)
}
})
test('test_extract_axios_non_error', () => {
@@ -0,0 +1,139 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { readFileSync, readdirSync } from 'node:fs'
import { fileURLToPath } from 'node:url'
import { resolve, dirname, join } from 'node:path'
import { userNotice } from '../src/shared/utils/user-notice.ts'
/**
* 全项目中文文案尺子(用户端):界面拿到的提示语必须是中文。
*
* 起因是 2026-10-09 那张货源查询截图,卡片上出现
* `Similar ASIN result rows are empty; please retry result generation`——那不是写错的文案,
* 而是后端把底层异常原文存进了 error_message,前端不加转换地渲染。后端逐条翻译追不上新增,
* 所以这条规矩做进界面出口:`userNotice()` 只放行含中文的串,英文一律换成中文兜底句,原文进 console。
*
* 三把尺子:① 行为钉子;② 任务卡 `错误:${...}` 与 payload 展示必须走 userNotice;
* ③ http.ts 的每条返回路径都要过闸。分母硬钉,防止扫描器失明后"零违规"是假的。
*/
const here = dirname(fileURLToPath(import.meta.url))
const SRC = resolve(here, '../src')
function sourceFiles(dir: string): string[] {
const out: string[] = []
for (const entry of readdirSync(dir, { withFileTypes: true })) {
if (entry.name === 'node_modules' || entry.name === 'dist') continue
const full = join(dir, entry.name)
if (entry.isDirectory()) {
out.push(...sourceFiles(full))
} else if (entry.name.endsWith('.vue') || entry.name.endsWith('.ts')) {
out.push(full)
}
}
return out
}
const CALL = /(ElMessage\.(?:error|warning)\(|showStatus\()/
const ARG = /^((?:res|result|payload|data|resp|response)\??\.(?:error|message))/
function read(path: string): string {
return readFileSync(path, 'utf-8')
}
test('userNotice 放行中文、替换英文、空串交回调用方默认句', () => {
assert.equal(userNotice('这份文件没有解析到可导出的行'), '这份文件没有解析到可导出的行')
assert.equal(userNotice('Similar ASIN result rows are empty'), '操作未能完成,请稍后重试')
assert.equal(userNotice('network timeout', '任务没能跑完,请稍后重试'), '任务没能跑完,请稍后重试')
assert.equal(userNotice(' ', '没填'), '没填')
assert.equal(userNotice(null, '没填'), '没填')
// 全角标点不算中文,否则 ":()" 这类残句会被当成可读文案透出
assert.equal(userNotice(':()', '兜底'), '兜底')
})
test('中文主干后面的英文尾巴只进 console,不上界面', () => {
// 后端历史写法:new BusinessException("转换结果打包失败: " + ex.getMessage())
assert.equal(userNotice('转换结果打包失败: No space left on device'), '转换结果打包失败')
assert.equal(userNotice('生成跟价 Excel 失败:Cannot parse column'), '生成跟价 Excel 失败')
// 带中文尾巴的要留着,那是给用户看的证据
assert.equal(userNotice('仅完成 102/112 行,其余 10 行未采到数据(未检测)'),
'仅完成 102/112 行,其余 10 行未采到数据(未检测)')
assert.equal(userNotice('Coze 工作流已结束,状态 FAILED'), 'Coze 工作流已结束,状态 FAILED')
})
test('任务卡与看板上的错误行一律经 userNotice 把关', () => {
const FIELDISH = /(error|Error|message|Message)/
const INTERP = /\$\{([^{}]+)\}|\{\{\s*([^{}]+?)\s*\}\}/g
const offenders: string[] = []
let sites = 0
for (const file of sourceFiles(SRC)) {
const rel = file.slice(SRC.length + 1).replace(/\\/g, '/')
const lines = read(file).split(/\r?\n/)
for (const line of lines) {
if (!line.includes('错误')) continue
for (const m of line.matchAll(INTERP)) {
const expr = m[1] ?? m[2] ?? ''
if (!FIELDISH.test(expr)) continue
sites++
if (!expr.includes('userNotice(')) {
offenders.push(`${rel}: ${line.trim().slice(0, 120)}`)
}
}
}
}
assert.ok(sites >= 15, `只扫到 ${sites} 处错误行插值(下限 15)——扫描器或目录树坏了,此刻的"零违规"不作数`)
assert.deepEqual(offenders, [], '这些错误行把后端原文直接拼进了界面')
})
/** 一行 payload 错误展示 → { 是否算一处出口, 是否已把关 };判据与自证共用同一个函数。 */
function payloadDisplay(line: string): { site: boolean; guarded: boolean } {
const m = line.match(CALL)
if (!m || m.index === undefined) return { site: false, guarded: true }
const raw = line.slice(m.index + m[0].length)
const guarded = raw.startsWith('userNotice(')
const rest = guarded ? raw.slice('userNotice('.length) : raw
return { site: ARG.test(rest), guarded }
}
test('payload 上的 error/message 展示一律经 userNotice 把关', () => {
const offenders: string[] = []
let sites = 0
for (const file of sourceFiles(SRC)) {
const rel = file.slice(SRC.length + 1).replace(/\\/g, '/')
for (const line of read(file).split(/\r?\n/)) {
if (!CALL.test(line)) continue
const found = payloadDisplay(line)
if (!found.site) continue
sites++
if (!found.guarded) {
offenders.push(`${rel}: ${line.trim().slice(0, 120)}`)
}
}
}
assert.ok(sites >= 20, `只扫到 ${sites} 处 payload 错误展示(下限 20)——分母缩水说明抽取器失明`)
assert.deepEqual(offenders, [], '这些提示语把响应体原文交给了界面')
})
test('http.ts 的每条取文案路径都过闸', () => {
const http = read(resolve(SRC, 'shared/api/http.ts'))
const guarded = (http.match(/userNotice\(/g) ?? []).length
assert.ok(guarded >= 5, `http.ts 里只有 ${guarded} 处 userNotice 把关(下限 5)——兜底路径漏了`)
// 反向钉:extractErrorMessage 不许再裸返回响应体字段或 axios 原文
const body = http.slice(http.indexOf('export function extractErrorMessage'), http.indexOf('/** 从 axios 错误对象里取响应体'))
assert.ok(!/\breturn data\b/.test(body), '响应体字符串不该原样透出')
assert.ok(!/return error\.message \|\|/.test(body), 'axios 英文原文不该原样透出')
})
test('判据抓得住自己造的违例', () => {
const planted = ' ...(item.error ? [`错误:${item.error}`] : []),'
assert.ok(planted.includes('错误'), '样本行该带错误标记')
assert.ok(/\$\{item\.error\}/.test(planted) && !planted.includes('userNotice('), '违例样本必须被判成未把关')
const guardedLine = ' ...(item.error ? [`错误:${userNotice(item.error)}`] : []),'
assert.ok(guardedLine.includes('userNotice('), '把关写法不能被误判成违例')
// payload 抽取器:摘壳前后都要认得出是一处出口,否则分母会静默缩水成 0
assert.deepEqual(payloadDisplay(' ElMessage.error(result.error)'), { site: true, guarded: false })
assert.deepEqual(payloadDisplay(' ElMessage.error(userNotice(result.error))'), { site: true, guarded: true })
// 常量文案不是这型出口,不计进分母
assert.deepEqual(payloadDisplay(' ElMessage.error(\'请先登录\')'), { site: false, guarded: false })
})