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:
@@ -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), '请求失败')
|
||||
})
|
||||
|
||||
@@ -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 })
|
||||
})
|
||||
Reference in New Issue
Block a user