Files
go-sms-V2/web/src/utils/markdown.ts
T
Tory eda275944f Issue#4: 版本号+发布日志(侧栏红点/系统管理二级菜单/运营大白话Markdown)——①单一事实源=data/releases.ts(APP_VERSION=首条;package.json 0.1.0→1.5.0 同步,releases.spec 两侧一致断言防漂移;版本线 v1.0.0~v1.5.0 六版全运营大白话);②侧栏底脚版本chip(MainLayout sidebar-foot 折叠按钮旁,点击进发布日志;红点=本地未读 localStorage gosms_seen_ver≠当前版本即亮,CSS gosms-ver-blink 脉冲闪烁,首访亮/点击或进页 markSeen 即灭/发新版全员再亮;折叠态64px 短版本 1.5+红点 badge 绝对定位——实测 monospace 渲染偏宽 v1.5 溢出 foot 55px>47px 修正);③发布日志页 views/system/ReleaseLog.vue(defineOptions name=system-release 守门)+路由 /system/release 全角色(同 faq 口径用户拍板,icon=Memo);④迷你Markdown渲染器 utils/markdown.ts 零新依赖(标题/无序有序列表 1.与1、顿号中文习惯/粗体/行内代码哨兵保护 code内**不误判/围栏代码块/链接仅http(s) javascript伪协议不渲染;先全量HTML转义再解析,v-html 零注入);⑤守门=releases.spec +14(数据一致性4:单一事实源/降序/semver/日期标签;渲染器7:格式+转义+伪协议+哨兵;store3:首访亮/markSeen灭+刷新持久/新版再亮)+guard 菜单33→34显式更+role-menu-matrix 登记 system-release:ALL+verify-layout 23→31(chip可见/文本vN.N/首访红点/点击跳转/已读即灭/卡片≥3实为6/md列表渲染/回home);⑥门禁=eslint0/vue-tsc0/vitest 179(165+14)/build 全绿;Chrome 157 实机走查4步(红点1→点击进页→已读0+localStorage=1.5.0→折叠1.5)+样式级复核(动画名gosms-ver-blink/chip几何/暗亮双主题可见);口径诚实标注:红点=本地未读语义(换浏览器/清缓存重提示一次,无服务端同步)/移动端≤900随sidebar-foot既有隐藏/发布内容=仓库静态数据;发版SOP=releases.ts头部插一条+package.json同步,部署后全员红点亮起;验收单issue4-release-notes.md+CHANGELOG+memory-bank回填;Gitea#4完成评论待用户(token)
2026-11-18 10:58:18 +08:00

90 lines
3.6 KiB
TypeScript

// utils/markdown.ts — Issue#4 迷你 Markdown 渲染器(发布日志专用,零依赖)。
//
// 支持范围(够用即止,不求 GFM 全集):
// 标题 #~####、无序列表(-/*)、有序列表(1. / 1、)、粗体 **x**、
// 行内代码 \`x\`、围栏代码块 \`\`\`、链接 [t](https://…)(仅 http/https)、
// 空行分段(段内换行 → <br>)。
// 安全口径:**输入先整体 HTML 转义再解析**——内容源虽是仓库静态数据
// (releases.ts),仍按不可信文本处理,任何标签/引号都不会进入 DOM;
// 链接仅允许 http(s) 协议(javascript: 伪协议不命中即保持原样文本)。
/** HTML 全量转义(含引号,防属性注入)。 */
function escapeHtml(s: string): string {
return s
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&#39;')
}
/** 行内格式:行内代码(哨兵保护,内部不做粗体/链接替换)→ 粗体 → 链接。 */
const CODE_SENTINEL = '@@GOSMS_MD_CODE_'
function inline(s: string): string {
const codes: string[] = []
let t = s.replace(/`([^`]+)`/g, (_m, c: string) => {
codes.push(c)
return `${CODE_SENTINEL}${codes.length - 1}@@`
})
t = t.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
t = t.replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer">$1</a>')
return t.replace(new RegExp(`${CODE_SENTINEL}(\\d+)@@`, 'g'), (_m, i: string) => `<code>${codes[Number(i)]!}</code>`)
}
/** 块级行判据(段落收集的截断条件):代码围栏 / 标题 / 列表。 */
const BLOCK_START = /^(#{1,4}\s|\s*[-*]\s|\s*\d+(?:\.\s+|、\s*)|```)/
/** 有序列表行:点号后须空格(英文习惯),顿号后空格可选(中文习惯)。 */
const OL_LINE = /^\s*\d+(?:\.\s+|、\s*)/
/** Markdown → HTML(输入不可信,输出已全量转义;v-html 挂载)。 */
export function renderMarkdown(src: string): string {
const lines = escapeHtml(src.replace(/\r\n/g, '\n')).split('\n')
const out: string[] = []
let i = 0
while (i < lines.length) {
const line = lines[i]!
// 围栏代码块:内容保持原样(不再做行内格式化)
if (line.trim().startsWith('```')) {
const buf: string[] = []
i++
while (i < lines.length && !lines[i]!.trim().startsWith('```')) buf.push(lines[i++]!)
i++ // 跳过闭合围栏(缺闭合则吞到结尾)
out.push(`<pre><code>${buf.join('\n')}</code></pre>`)
continue
}
// 标题 # ~ ####
const h = /^(#{1,4})\s+(.*)$/.exec(line)
if (h) {
const lv = h[1]!.length
out.push(`<h${lv}>${inline(h[2]!)}</h${lv}>`)
i++
continue
}
// 无序列表
if (/^\s*[-*]\s+/.test(line)) {
const items: string[] = []
while (i < lines.length && /^\s*[-*]\s+/.test(lines[i]!)) items.push(inline(lines[i++]!.replace(/^\s*[-*]\s+/, '')))
out.push(`<ul>${items.map((x) => `<li>${x}</li>`).join('')}</ul>`)
continue
}
// 有序列表(1. 或 1、)
if (OL_LINE.test(line)) {
const items: string[] = []
while (i < lines.length && OL_LINE.test(lines[i]!)) items.push(inline(lines[i++]!.replace(OL_LINE, '')))
out.push(`<ol>${items.map((x) => `<li>${x}</li>`).join('')}</ol>`)
continue
}
// 空行
if (line.trim() === '') {
i++
continue
}
// 段落:连续普通行合并,行间 <br>
const buf: string[] = [line]
i++
while (i < lines.length && lines[i]!.trim() !== '' && !BLOCK_START.test(lines[i]!)) buf.push(lines[i++]!)
out.push(`<p>${buf.map(inline).join('<br>')}</p>`)
}
return out.join('\n')
}