@gobing-ai/knowledge-kit 0.0.17 → 0.0.18

package/plugins/publishings/podcast-pub/src/show-notes.ts

@@ -30,6 +30,106 @@ function renderInline(escaped: string): string {
     return (out + rest).replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
 }
 
+/**
+ * Normalizes text for title↔transcription matching: lowercase, strip everything
+ * that is not a CJK char, letter, or digit. ASR drops punctuation and case, and the
+ * intro segment enumerates every title, so matching must be punctuation-blind and
+ * monotonic (each item searches forward from the previous match).
+ */
+function normalizeForMatch(text: string): string {
+    return text.toLowerCase().replace(/[^\p{Script=Han}\p{L}\p{N}]+/gu, '');
+}
+
+/** `m:ss` audio offset, or `--:--` when unknown. */
+function formatOffset(seconds: number): string {
+    if (!Number.isFinite(seconds) || seconds < 0) return '--:--';
+    const m = Math.floor(seconds / 60);
+    const s = Math.round(seconds % 60);
+    return s === 60 ? `${m + 1}:00` : `${m}:${String(s).padStart(2, '0')}`;
+}
+
+/**
+ * Per-item audio offsets (seconds) from the generated segments. Exact mode: walk
+ * segments after the intro (index 0), matching each item title inside a segment
+ * transcription, monotonic forward. Proportional fallback (any title unmatched or no
+ * segments): distribute total duration by body length — monotonic and close enough
+ * for jump navigation. `ponytail`: no word-level alignment; segment starts are
+ * accurate to one segment (~10–30s), fine for chapter jumps.
+ */
+export function computeAudioOffsets(
+    docs: Doc[],
+    segments: Array<{ duration?: number; transcription?: string }> | undefined,
+): number[] {
+    const fallback = (): number[] => {
+        const chars = docs.map((d) => Math.max((d.body ?? '').trim().length, 1));
+        const total = chars.reduce((a, b) => a + b, 0);
+        const sumDuration = (segments ?? []).reduce((a, s) => a + (s.duration ?? 0), 0);
+        let acc = 0;
+        return chars.map((c) => {
+            const at = acc;
+            acc += (c / total) * sumDuration;
+            return at;
+        });
+    };
+    if (!segments || segments.length < 2) return fallback();
+    const starts: number[] = [];
+    let elapsed = 0;
+    const marks = segments.map((s) => {
+        const at = elapsed;
+        elapsed += s.duration ?? 0;
+        return { at, text: normalizeForMatch(s.transcription ?? '') };
+    });
+    let cursor = 1; // segment 0 is the intro, which recites every title
+    for (const d of docs) {
+        const title = normalizeForMatch(d.title ?? '');
+        const needle = title.slice(0, 12);
+        const hit = needle.length >= 4 ? marks.findIndex((m, i) => i >= cursor && m.text.includes(needle)) : -1;
+        if (hit >= 0) {
+            starts.push(marks[hit]?.at ?? 0);
+            cursor = hit + 1;
+        } else {
+            starts.push(Number.NaN); // any miss degrades the whole run to proportional
+        }
+    }
+    if (starts.some((v) => !Number.isFinite(v))) return fallback();
+    return starts;
+}
+
+/**
+ * Brief-mode timeline block: two-column HTML (offset left, title + briefing right),
+ * marked `<!--kk:timeline-->` so {@link renderShowNotesHtml} passes it through
+ * verbatim — everything inside is built here from escaped doc values, never user
+ * input. `ponytail`: no JS — timestamp deep-linking depends on the theme's player
+ * API; add when microfeed exposes one.
+ */
+function renderTimelineHtml(docs: Doc[], offsets: number[], articleUrl: string): string {
+    const rows = docs
+        .map((d, i) => {
+            const title = escapeHtml(d.title ?? `条目 ${i + 1}`);
+            const brief = escapeHtml(itemBrief(d));
+            const at = formatOffset(offsets[i] ?? Number.NaN);
+            const link = d.sourceUri
+                ? ` <a href="${escapeHtml(d.sourceUri)}" target="_blank" rel="noopener">来源</a>`
+                : '';
+            return `
+    <div class="kk-tl-row"><div class="kk-tl-t">${at}</div><div class="kk-tl-body"><div class="kk-tl-title">${i + 1}. ${title}${link}</div><p class="kk-tl-brief">${brief}</p></div></div>`;
+        })
+        .join('');
+    return `<!--kk:timeline-->
+<style>
+.kk-tl{margin:1em 0}
+.kk-tl-row{display:flex;gap:12px;padding:10px 0;border-bottom:1px solid rgba(128,128,128,.25)}
+.kk-tl-t{flex:0 0 56px;font-variant-numeric:tabular-nums;font-weight:700;color:#0969da}
+.kk-tl-body{flex:1;min-width:0}
+.kk-tl-title{font-weight:600}
+.kk-tl-brief{margin:4px 0 0;color:#666;font-size:.95em}
+</style>
+<div class="kk-tl">${rows}
+</div>
+<p>完整图文版：<a href="${escapeHtml(articleUrl)}" target="_blank" rel="noopener">${escapeHtml('本期完整文章')}</a></p>
+<!--/kk:timeline-->`;
+}
+
 /**
  * Renders show-notes markdown to sanitized HTML.
  * The leading `# ` heading is dropped: the episode `title` is rendered
@@ -39,6 +139,8 @@ function renderInline(escaped: string): string {
  */
 export function renderShowNotesHtml(markdown: string): string {
     const blocks: string[] = [];
+    const timeline: string[] = [];
+    let inTimeline = false;
     let paragraph: string[] = [];
 
     const flush = () => {
@@ -50,6 +152,19 @@ export function renderShowNotesHtml(markdown: string): string {
 
     for (const rawLine of markdown.split('\n')) {
         const line = rawLine.trim();
+        if (line === '<!--kk:timeline-->') {
+            flush();
+            inTimeline = true;
+            continue;
+        }
+        if (inTimeline) {
+            if (line === '<!--/kk:timeline-->') {
+                inTimeline = false;
+                continue;
+            }
+            timeline.push(rawLine);
+            continue;
+        }
         if (line.length === 0) {
             flush();
             continue;
@@ -67,6 +182,7 @@ export function renderShowNotesHtml(markdown: string): string {
         paragraph.push(line);
     }
     flush();
+    if (timeline.length > 0) blocks.push(timeline.join('\n'));
     return blocks.join('\n');
 }
 
@@ -96,6 +212,24 @@ export interface ShowNotesRenderOptions {
      * slug construction, which stays the fallback.
      */
     articlePostPath?: string;
+    /**
+     * Audio segment metadata from the generated episode content
+     * (`metadata.segments[]`: per-segment `duration` seconds + ASR `transcription`).
+     * When present, per-item timestamps are real audio offsets (listener jump-to-item),
+     * matched monotonically against segment transcriptions; otherwise `--:--`.
+     */
+    audioSegments?: Array<{ duration?: number; transcription?: string }>;
+}
+
+/** Per-item 1–2-sentence briefing: `metadata.brief` first, body sentences as fallback. */
+function itemBrief(d: Doc): string {
+    const meta = d.metadata ?? {};
+    if (typeof meta.brief === 'string' && meta.brief.trim().length > 0) return meta.brief.trim();
+    return (d.body ?? '')
+        .trim()
+        .split(/(?<=[。！？])\s*/)
+        .slice(0, 2)
+        .join('');
 }
 
 /**
@@ -136,44 +270,29 @@ export function renderShowNotesMarkdown(docs: Doc[], opts: ShowNotesRenderOption
             return '来源';
         }
     };
-    const itemBrief = (d: Doc): string => {
-        const meta = d.metadata ?? {};
-        if (typeof meta.brief === 'string' && meta.brief.trim().length > 0) return meta.brief.trim();
-        return (d.body ?? '')
-            .trim()
-            .split(/(?<=[。！？])\s*/)
-            .slice(0, 2)
-            .join('');
-    };
-    const itemTimestamp = (d: Doc): string => {
-        const meta = d.metadata ?? {};
-        const raw = meta.publishAt;
-        const t = typeof raw === 'string' ? Date.parse(raw) : typeof raw === 'number' ? raw : Number.NaN;
-        if (!Number.isFinite(t)) return '--:--';
-        const at = new Date(t);
-        return `${String(at.getHours()).padStart(2, '0')}:${String(at.getMinutes()).padStart(2, '0')}`;
-    };
+    const offsets = computeAudioOffsets(docs, opts.audioSegments);
     const lines: string[] = [`# ${opts.title}`, ''];
-    docs.forEach((d, i) => {
-        const body = (d.body ?? '').trim();
-        const sentences = body
-            .split(/(?<=[。！？])\s*/)
-            .slice(0, 2)
-            .join('');
-        lines.push(`## ${i + 1}. ${d.title ?? `条目 ${i + 1}`}`, '');
-        if (briefMode) {
-            // Timeline entry: HH:MM + 1–2-sentence briefing; the trailing link pair
-            // ends with the surfdash article URL (task 0118 R2.1–R2.4).
+    if (briefMode) {
+        // Timeline layout (2026-09-16 feedback): real audio offsets left, title + briefing
+        // right, article link last — the whole brief body is one pre-built HTML block.
+        lines.push(renderTimelineHtml(docs, offsets, articleUrl), '');
+    } else {
+        docs.forEach((d, i) => {
+            const body = (d.body ?? '').trim();
+            const sentences = body
+                .split(/(?<=[。！？])\s*/)
+                .slice(0, 2)
+                .join('');
             lines.push(
-                `${itemTimestamp(d)} · ${itemBrief(d)}`,
+                `## ${i + 1}. ${d.title ?? `条目 ${i + 1}`}`,
+                '',
+                sentences,
                 '',
-                `[来源：${sourceLabel(d)}](${d.sourceUri ?? ''}) · [文章](${articleUrl})`,
+                `[来源：${sourceLabel(d)}](${d.sourceUri ?? ''})`,
                 '',
             );
-        } else {
-            lines.push(sentences, '', `[来源：${sourceLabel(d)}](${d.sourceUri ?? ''})`, '');
-        }
-    });
-    lines.push(`详情见本期完整文章：[ ${opts.title} ](${articleUrl})`, '');
+        });
+        lines.push(`详情见本期完整文章：[ ${opts.title} ](${articleUrl})`, '');
+    }
     return lines.join('\n');
 }

package/plugins/publishings/qiita-pub/dist/index.js

@@ -14642,72 +14642,6 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/errors.js
-var ErrorCode;
-var init_errors3 = __esm(() => {
-  ErrorCode = {
-    NotFound: "NOT_FOUND",
-    Validation: "VALIDATION",
-    Conflict: "CONFLICT",
-    Internal: "INTERNAL"
-  };
-});
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/api-response.js
-var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
-var init_api_response = __esm(() => {
-  init_errors3();
-  API_ERROR_CODES = {
-    SUCCESS: 0,
-    NOT_FOUND: 404,
-    VALIDATION_ERROR: 422,
-    BAD_REQUEST: 400,
-    UNAUTHORIZED: 401,
-    FORBIDDEN: 403,
-    CONFLICT: 409,
-    INTERNAL_ERROR: 500
-  };
-  ERROR_CODE_TO_HTTP = {
-    [ErrorCode.NotFound]: API_ERROR_CODES.NOT_FOUND,
-    [ErrorCode.Validation]: API_ERROR_CODES.VALIDATION_ERROR,
-    [ErrorCode.Conflict]: API_ERROR_CODES.CONFLICT,
-    [ErrorCode.Internal]: API_ERROR_CODES.INTERNAL_ERROR
-  };
-  CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
-});
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/cursor.js
-var init_cursor = () => {};
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
-var init_event_severity = () => {};
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/output.js
-function processStream(name) {
-  const proc = globalThis.process;
-  const stream = proc?.[name];
-  if (stream === undefined) {
-    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
-  }
-  return stream;
-}
-function writeLine(message, target) {
-  target.write(`${message}
-`);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-var defaultStderrTarget;
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/index.js
-var init_dist = __esm(() => {
-  init_api_response();
-  init_cursor();
-  init_errors3();
-  init_event_severity();
-});
-
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -17612,15 +17546,15 @@ var require_timestamp = __commonJS((exports) => {
         throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
       const [, year, month, day, hour, minute, second] = match.map(Number);
       const millisec = match[7] ? Number((match[7] + "00").substr(1, 3)) : 0;
-      let date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date5 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
       const tz = match[8];
       if (tz && tz !== "Z") {
         let d = parseSexagesimal(tz, false);
         if (Math.abs(d) < 30)
           d *= 60;
-        date6 -= 60000 * d;
+        date5 -= 60000 * d;
       }
-      return new Date(date6);
+      return new Date(date5);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19480,7 +19414,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19531,9 +19465,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors4.YAMLParseError(pos, code, message));
+          this.errors.push(new errors3.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19619,7 +19553,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19629,7 +19563,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19644,7 +19578,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19670,7 +19604,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19679,7 +19613,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21559,7 +21493,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21576,8 +21510,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21592,13 +21526,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21650,12 +21584,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors4, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist2 = __esm(() => {
+var composer, Document, Schema, errors3, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
+var init_dist = __esm(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors4 = require_errors();
+  errors3 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21671,9 +21605,9 @@ var init_dist2 = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors4.YAMLError;
-  $YAMLParseError = errors4.YAMLParseError;
-  $YAMLWarning = errors4.YAMLWarning;
+  $YAMLError = errors3.YAMLError;
+  $YAMLParseError = errors3.YAMLParseError;
+  $YAMLWarning = errors3.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21701,7 +21635,7 @@ var init_dist2 = __esm(() => {
 // ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
-  init_dist2();
+  init_dist();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21887,6 +21821,24 @@ var PluginManifestSchema = exports_external.object({
 init_file_system_node();
 init_config();
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.67/node_modules/@gobing-ai/ts-utils/dist/output.js
+var defaultStderrTarget;
+function processStream(name) {
+  const proc = globalThis.process;
+  const stream = proc?.[name];
+  if (stream === undefined) {
+    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
+  }
+  return stream;
+}
+function writeLine(message, target) {
+  target.write(`${message}
+`);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
 // ../../packages/publish-harness/src/index.ts
@@ -21926,7 +21878,6 @@ class FakeFileCliTransport {
 }
 
 // ../../plugins/publishings/qiita-pub/src/index.ts
-init_dist();
 var QIITA_ITEMS_URL = "https://qiita.com/api/v2/items";
 function slugify2(str) {
   return str.toLowerCase().replace(/[^\w\s-]/g, "").trim().replace(/[\s_]+/g, "-");