feat(utils): 时间码芯片补毫秒与 data-ts-ms

Author: Aparencia

app/src/utils/html.test.ts

@@ -75,9 +75,12 @@ describe("renderTimestampAnchors", () => {
     expect(out).not.toContain("]]([[");
   });
 
-  it("无锚点文本原样返回", () => {
+  it("无锚点文本原样返回（且不产生任何芯片属性）", () => {
     const out = renderTimestampAnchors(escapeHtml(`普通文本没有锚点 123`));
     expect(out).toBe("普通文本没有锚点 123");
+    // 批 7 T15（Y8 加宽）：无芯片 ⇒ 不得出现任何芯片定名属性（反"空真"）
+    expect(out).not.toContain("data-ts-ms");
+    expect(out).not.toContain("data-ts-chip");
   });
 
   it("先转义再替换——恶意 HTML 不产生可解析标签（注入面为零）", () => {
@@ -99,5 +102,28 @@ describe("renderTimestampAnchors", () => {
     // Act：正则要求分钟为数字——仿形态不匹配，保持转义原文
     const out = renderTimestampAnchors(input);
     expect(out).toBe(input);
+    // 批 7 T15（Y8 加宽）：仿形态**不得**产出芯片属性（反"误判"）
+    expect(out).not.toContain("data-ts-ms");
+    expect(out).not.toContain("data-ts-chip");
+  });
+
+  it("芯片带 data-ts-ms 且值 = 锚点里的 ms（T15：跳转目标不再被丢弃）· 两种形态", () => {
+    // Arrange：段落锚点 + 章节锚点（外带包裹括号）——两条正则都要捕获 ms
+    // Act
+    const para = renderTimestampAnchors(escapeHtml(`[⏱ 00:05]([[ts:5000]]) 内容`));
+    const chapter = renderTimestampAnchors(escapeHtml(`标题 [[⏱ 00:09]([[ts:9000]])]`));
+    // Assert：段落形态——ms 逐字进 data-ts-ms（`5000` 而非 `00:05`），原始锚点不残留
+    expect(para).toContain('data-ts-ms="5000"');
+    expect(para).toContain("data-ts-chip");
+    expect(para).toContain("⏱ 00:05");
+    expect(para).not.toContain("[[ts:5000]]");
+    // Assert：章节形态——第二条正则同样捕获 ms（原实现两条正则都丢 ms）
+    expect(chapter).toContain('data-ts-ms="9000"');
+    expect(chapter).toContain("data-ts-chip");
+    expect(chapter).toContain("⏱ 00:09");
+    expect(chapter).not.toContain("[[ts:9000]]");
+    // Assert：视觉与 title 文案**一字未改**（C10.2 的零观感变化要求）
+    expect(para).toContain('title="⏱ 00:05 跳转到会话对应片段"');
+    expect(para).toContain("border-bottom:1px dashed #14b8a6");
   });
 });

app/src/utils/html.ts

@@ -28,13 +28,21 @@ export function escapeHtml(s: string): string {
  *              （无注入面——写入的是我们自己的 HTML）。
  * @ai-context: 两种形态：章节锚点 `## 标题 [[⏱ 00:09]([[ts:9000]])]`（外带
  *              `[...]` 包裹）先匹配，段落锚点 `[⏱ 00:00]([[ts:233]])` 兜底。
+ * @ai-context: 批 7 T15（C10.2）—— 本函数是 `[[ts:ms]]` 芯片的**唯一实现**（两条手写链
+ *              `NotePreviewView` 与 `refineDiff` 都经它）⇒ 修复只需做一次：① **正则补 ms 捕获组**
+ *              （原实现把 `[[ts:ms]]` 的 ms 整个丢掉 ⇒ 芯片没有跳转目标）；② 芯片带
+ *              `data-ts-ms`（毫秒整数，与 `NoteMarkdown` 的 `onOpenSessionAt(sessionId, ms)` 同口径）
+ *              + `data-ts-chip`（定名选择器；`pages/NotesPage.test.tsx` 原按 `title*="跳转到会话"`
+ *              选元素，唯一性会被稀释）。容器侧用**事件委托** `closest("[data-ts-ms]")` 取目标 ⇒
+ *              保持串渲染、不需要 React 上下文。视觉样式与 `title` 文案**一字未改**。
+ *              边界：定位精度受音频对齐的块粒度 **±200 ms** 限制（不得声称毫秒级定位）。
  */
 export function renderTimestampAnchors(escaped: string): string {
-  const chip = (_m: string, mm: string, ss: string): string =>
-    `<span style="color:#0d9488;border-bottom:1px dashed #14b8a6;background:#f0fdfa;border-radius:3px;padding:0 4px" title="⏱ ${mm}:${ss} 跳转到会话对应片段">⏱ ${mm}:${ss}</span>`;
+  const chip = (_m: string, mm: string, ss: string, ms: string): string =>
+    `<span data-ts-ms="${ms}" data-ts-chip style="color:#0d9488;border-bottom:1px dashed #14b8a6;background:#f0fdfa;border-radius:3px;padding:0 4px" title="⏱ ${mm}:${ss} 跳转到会话对应片段">⏱ ${mm}:${ss}</span>`;
   return escaped
     // 章节形态（含包裹括号）：`[[⏱ MM:SS]([[ts:ms]])]`
-    .replace(/\[\[⏱ (\d+):(\d{2})\]\(\[\[ts:\d+\]\]\)\]/g, chip)
+    .replace(/\[\[⏱ (\d+):(\d{2})\]\(\[\[ts:(\d+)\]\]\)\]/g, chip)
     // 段落形态：`[⏱ MM:SS]([[ts:ms]])`
-    .replace(/\[⏱ (\d+):(\d{2})\]\(\[\[ts:\d+\]\]\)/g, chip);
+    .replace(/\[⏱ (\d+):(\d{2})\]\(\[\[ts:(\d+)\]\]\)/g, chip);
 }