feat(ui): 代码预览接入 Prism 语法高亮,md 代码块与 Git diff 共用一套配色

js/json/yml/sh/py 这类文件原来只有行号、没有颜色。vendor 里加 prism.min.js
(core + 20 种常用语言,52KB / gzip 18.7KB),UMD 直接 <script> 引入,与
marked 同一种加载方式,不需要构建。

代码预览是整块高亮后再按行拆:pvSplitHighlighted 维护一个打开的 span 栈,
行尾补 </span>、下一行行首重开同名标签。逐行调 Prism.highlight 会把多行注释、
三引号字符串、模板字符串切花;拆完行数与原文对不上时退回纯文本,保证行号不错位。

配色(GitHub 亮色系)用 :is(.pv-code, .pv-doc, .vcs-line) 覆盖三处:
- 代码预览 .pv-code
- md 里的围栏代码块:pvHighlightMdCode 用 highlightElement,只处理标了
  language-xx 且语言已打包的块,没有语言标记的保持纯文本
- Git 面板 diff:逐行着色(diff 是片段,跨行 token 本来也拼不完整),
  超过 2000 行的 patch 不上色,避免同步高亮把面板卡住
This commit is contained in:
2026-11-13 15:53:46 +08:00
parent baec30398a
commit 95047678f3
5 changed files with 105 additions and 6 deletions
+12
View File
@@ -1674,6 +1674,18 @@ body.pv-max .pv-pre { max-width: none; } /* 放大时源码面板同样铺满 */
}
/* 放大预览时铺满:#pv-pane 已经是全屏,内容别再卡在 920px 的阅读宽度里 */
body.pv-max .pv-code { max-width: none; padding-left: 16px; padding-right: 16px; }
/* Prism token 配色(GitHub 亮色系):代码预览、md 围栏代码块、Git 面板 diff 共用 */
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.comment, .token.prolog, .token.doctype, .token.cdata) { color: #6a737d; font-style: italic; }
:is(.pv-code, .pv-doc, .vcs-line) .token.punctuation { color: #24292e; }
:is(.pv-code, .pv-doc, .vcs-line) .token.namespace { opacity: .7; }
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.property, .token.tag, .token.boolean, .token.number, .token.constant, .token.symbol, .token.deleted) { color: #005cc5; }
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.selector, .token.attr-name, .token.string, .token.char, .token.builtin, .token.inserted) { color: #032f62; }
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.operator, .token.entity, .token.url) { color: #d73a49; }
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.atrule, .token.attr-value, .token.keyword) { color: #d73a49; }
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.function, .token.class-name) { color: #6f42c1; }
:is(.pv-code, .pv-doc, .vcs-line) :is(.token.regex, .token.important, .token.variable) { color: #e36209; }
:is(.pv-code, .pv-doc, .vcs-line) .token.bold { font-weight: 600; }
:is(.pv-code, .pv-doc, .vcs-line) .token.italic { font-style: italic; }
.pv-trunc { max-width: 880px; margin: 12px auto 0; padding: 0 20px; font-size: 12px; color: var(--gray-light); }
.pv-loading.inline { position: static; background: transparent; padding: 56px 0; }
.pv-none { margin: auto; display: flex; flex-direction: column; align-items: center; gap: 10px; padding: 44px 24px; text-align: center; }
+1
View File
@@ -8,6 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover, interactive-widget=resizes-content">
<title>Agent 任务台</title>
<script src="/vendor/marked.min.js"></script>
<script src="/vendor/prism.min.js"></script>
<meta name="theme-color" content="#3964FE">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+72 -1
View File
@@ -16,6 +16,58 @@ const PV_PLAIN = /\.(txt|log)$/i;
const PV_TEXT = /\.(md|markdown|txt|log|csv|tsv|json|jsonl|xml|yml|yaml|toml|ini|conf|cfg|properties|env|py|pyw|js|mjs|cjs|ts|tsx|jsx|java|kt|c|h|cpp|hpp|cc|cs|go|rs|rb|php|swift|sh|bash|zsh|bat|ps1|sql|lua|r|dart|vue|css|less|scss|srt|vtt)$/i;
const PV_TEXT_MAX = 512 * 1024; // 文本预览截断阈值(字符),超出提示下载看全文
const PV_CODE_MAX = 5000; // 代码预览最多逐行渲染的行数:行号要逐行建节点,几万行会把面板拖死
// 扩展名 → Prism 语言 id。只映射打包进来的语言(见 vendor/prism.min.js),命中不了就当纯文本
const PV_LANG = {
js: 'javascript', mjs: 'javascript', cjs: 'javascript', jsx: 'jsx',
ts: 'typescript', mts: 'typescript', cts: 'typescript', tsx: 'tsx',
json: 'json', jsonl: 'json', json5: 'json',
yml: 'yaml', yaml: 'yaml',
sh: 'bash', bash: 'bash', zsh: 'bash', ksh: 'bash', env: 'bash',
py: 'python', pyw: 'python',
go: 'go', rs: 'rust', java: 'java',
c: 'c', h: 'c', cpp: 'cpp', hpp: 'cpp', cc: 'cpp', cxx: 'cpp', hh: 'cpp',
sql: 'sql', css: 'css', wxss: 'css',
html: 'markup', htm: 'markup', xml: 'markup', svg: 'markup', vue: 'markup',
md: 'markdown', markdown: 'markdown',
toml: 'toml', ini: 'ini', conf: 'ini', cfg: 'ini', properties: 'ini',
diff: 'diff', patch: 'diff',
};
// 整块高亮;Prism 没加载、语言没打包、或抛异常都返回 null,调用方退回纯文本
function pvHighlightCode(text, name) {
if (typeof Prism === 'undefined' || !Prism.languages) return null;
const ext = (String(name).match(/\.([^.\\/]+)$/) || [])[1];
const lang = PV_LANG[String(ext || '').toLowerCase()];
const grammar = lang && Prism.languages[lang];
if (!grammar) return null;
try { return Prism.highlight(text, grammar, lang); } catch (_) { return null; }
}
// 把整块高亮 HTML 按行拆开:跨行的 <span> 在行尾补 </span>、下一行行首重开。
// 逐行调用 Prism.highlight 会把多行注释/三引号字符串切花,所以必须先整块高亮再拆。
// Prism 输出的文本已转义(&lt; 等),不存在裸 '<',因此只匹配标签与换行就够了。
function pvSplitHighlighted(html) {
const out = [];
const stack = [];
let cur = '';
let last = 0;
const re = /(\n|<span\b[^>]*>|<\/span>)/g;
let m;
while ((m = re.exec(html))) {
cur += html.slice(last, m.index);
last = m.index + m[0].length;
if (m[0] === '\n') {
out.push(cur + '</span>'.repeat(stack.length));
cur = stack.join('');
} else if (m[0] === '</span>') {
stack.pop();
cur += '</span>';
} else {
stack.push(m[0]);
cur += m[0];
}
}
out.push(cur + html.slice(last)); // 末尾无条件留一行:文本以 \n 结尾时最后是空行
return out;
}
const PV_SRC_MAX = 2 * 1024 * 1024; // 源码面板的显示上限,超过就只给前 2MB(大文件塞 pre 会卡)
let pvSeq = 0; // 预览序号:快速连点时旧请求不许再动 DOM
// reload: 当前内容的"重新载入"动作(文本类无 iframe,按名重开);为 null 时回退到 reload iframe
@@ -114,6 +166,20 @@ function pvToggleSrc() {
btn.setAttribute('aria-label', lbl);
}
// md 里的围栏代码块上色:marked 输出 <pre><code class="language-xx">,命中 PV_LANG 才处理。
// highlightElement 会重写 code 的 innerHTML,复制按钮挂在父级 .code-wrap 上,不受影响。
function pvHighlightMdCode(root) {
if (typeof Prism === 'undefined' || !Prism.languages) return;
root.querySelectorAll('pre code').forEach((el) => {
if (el.dataset.hl) return; // 幂等:同一节点被重复装饰时不再处理
const m = /language-([\w-]+)/.exec(String(el.className || ''));
const lang = m && PV_LANG[m[1].toLowerCase()];
if (!lang || !Prism.languages[lang]) return;
el.dataset.hl = '1';
try { Prism.highlightElement(el); } catch (_) {}
});
}
// 每次展示内容都过一遍:标题显示相对路径(子目录可见),右上角下载钮随文件走
function pvHeader(name, sizeText) {
pvState.name = name;
@@ -460,6 +526,7 @@ async function pvTextNode(name, sizeText, r) {
wrap.className = 'msg other';
wrap.innerHTML = '<div class="' + cls + ' pv-doc">' + html + '</div>';
decorateCodePre(wrap);
pvHighlightMdCode(wrap); // 围栏代码块上色(与代码预览同一套配色)
const n = wrap.firstChild;
// q.fmt=false 表示 marked 不可用、面板就是原文排版:新窗口也按纯文本开,避免空白被折叠
n.__tb = q.fmt
@@ -493,9 +560,12 @@ async function pvTextNode(name, sizeText, r) {
code.className = 'pv-code';
code.style.setProperty('--nw', Math.max(2, String(shown.length).length) + 'ch'); // 行号列宽按最大行号位数
const rows = [];
const hl = pvHighlightCode(shown.join('\n'), name); // 整块高亮再按行拆,跨行 token 才不会花
const parts = hl ? pvSplitHighlighted(hl) : null;
const useHl = parts && parts.length === shown.length; // 行数对不上就退回纯文本,不让行号错位
for (let i = 0; i < shown.length; i++) {
// 行号交给 CSS counter(.pv-cl::before)生成:伪元素不进选区,复制不会把行号带走
rows.push('<div class="pv-cl">' + esc(shown[i]) + '</div>');
rows.push('<div class="pv-cl">' + (useHl ? parts[i] : esc(shown[i])) + '</div>');
}
code.innerHTML = rows.join('');
frag.appendChild(code);
@@ -564,6 +634,7 @@ async function pvRenderLegacy(name, r, my) {
wrap.className = 'msg other';
wrap.innerHTML = '<div class="' + cls + '">' + html + '</div>';
decorateCodePre(wrap);
pvHighlightMdCode(wrap);
pvOverlayShow(wrap.firstChild, { bar: true, name: name, source: text }); // 全宽沉浸,eye/复制看原文
}
}
+19 -5
View File
@@ -75,9 +75,21 @@
}
// ---------- 详情(提交 / 未提交共用)----------
function lineHtml(cls, oldNo, newNo, text) {
// 语法高亮:与预览共用 PV_LANG(preview.js)。只能逐行高亮:diff 是片段,多行注释/三引号串
// 本来就拼不完整;逐行反而不会把行号与红绿底色搞乱。
function prismLang(path) {
if (typeof PV_LANG === 'undefined' || typeof Prism === 'undefined' || !Prism.languages) return null;
const m = /\.([^.\\/]+)$/.exec(String(path || ''));
const lang = m && PV_LANG[m[1].toLowerCase()];
return lang && Prism.languages[lang] ? lang : null;
}
function codeEsc(text, lang) {
if (!lang) return esc(text);
try { return Prism.highlight(text, Prism.languages[lang], lang); } catch (_) { return esc(text); }
}
function lineHtml(cls, oldNo, newNo, text, lang) {
return '<div class="vcs-line' + (cls ? ' ' + cls : '') + '"><span class="n">' + (oldNo == null ? '' : oldNo) +
'</span><span class="n">' + (newNo == null ? '' : newNo) + '</span><span class="c">' + esc(text) + '</span></div>';
'</span><span class="n">' + (newNo == null ? '' : newNo) + '</span><span class="c">' + codeEsc(text, lang) + '</span></div>';
}
// 行号自己推:@@ -a,b +c,d @@ 之后的上下文/+/- 分别推进两个计数器
@@ -86,6 +98,8 @@
if (!f.patch) return '<div class="vcs-nodiff">没有可显示的差异</div>';
const out = [];
const lines = String(f.patch).split('\n');
// 大 patch 不上色:逐行跑 Prism 是同步的,几千行会把面板卡一下
const lang = lines.length <= 2000 ? prismLang(f.path) : null;
let oldNo = 0, newNo = 0, inHunk = false, rows = 0;
for (let i = 0; i < lines.length; i++) {
const line = lines[i];
@@ -99,9 +113,9 @@
if (!inHunk) continue; // 文件头(diff --git / index / --- / +++)由文件行本身表达,不重复渲染
if (line.charAt(0) === '\\') { out.push('<div class="vcs-line meta"><span class="n"></span><span class="n"></span><span class="c">' + esc(line) + '</span></div>'); continue; }
const c = line.charAt(0);
if (c === '+') out.push(lineHtml('a', null, newNo++, line.slice(1)));
else if (c === '-') out.push(lineHtml('d', oldNo++, null, line.slice(1)));
else out.push(lineHtml('', oldNo++, newNo++, line.slice(1)));
if (c === '+') out.push(lineHtml('a', null, newNo++, line.slice(1), lang));
else if (c === '-') out.push(lineHtml('d', oldNo++, null, line.slice(1), lang));
else out.push(lineHtml('', oldNo++, newNo++, line.slice(1), lang));
if (++rows > 3000) { out.push('<div class="vcs-nodiff">行数过多,剩余部分已隐藏</div>'); break; }
}
return out.join('') || '<div class="vcs-nodiff">仅改名或模式变更,没有内容差异</div>';
File diff suppressed because one or more lines are too long