docs: annotate all shared frontend modules in Chinese

This commit is contained in:
cieanyau committed 2026-11-06 00:30:15 +08:00
1 parent 2be21c1c62
commit 408f8e5c98
55 files changed
+349

No files matched your search

+5
View File
@@ -1,3 +1,5 @@
/** 工单附件展示适配;文件名、存储名与可访问 URL 分开,不把存储键直接当链接。 */
// 允许 HTTP(S) 和显式相对路径,拒绝控制字符、反斜杠及脚本/data 等协议。
function e(e) {
if (
!/^(?:https?:\/\/|\/(?!\/)|\.\.?\/)/i.test(e) ||
@@ -11,6 +13,7 @@ function e(e) {
return !1;
}
}
// 仅在地址合法且文件名为支持的位图扩展名时启用图片预览,SVG 不走内嵌预览。
function t(t) {
return (
!!t.href &&
@@ -18,6 +21,7 @@ function t(t) {
/\.(?:avif|bmp|gif|ico|jpe?g|png|webp)$/i.test(t.name)
);
}
// 历史存储名使用 ^ 分隔前缀,展示时取末段;URI 解码失败仍保留可读的原名。
function n(e, t) {
let n =
e
@@ -30,6 +34,7 @@ function n(e, t) {
} catch {}
return n.split(`^`).at(-1) || t;
}
/** 兼容字符串及对象附件;无地址仍保留名称/存储名和明确占位,不伪造下载链接。 */
function r(t) {
return Array.isArray(t)
? t.map((t, r) => {