From 8b394078fce47fab91f7b86862d7b2c4260ef7d0 Mon Sep 17 00:00:00 2001 From: ranxianglei Date: Sun, 25 Oct 2026 00:32:48 +0800 Subject: [PATCH 1/7] =?UTF-8?q?feat:=20panel-embedded=20blog=20&=20article?= =?UTF-8?q?s=20view=20=E2=80=94=20bundled=20markdown=20rendered=20in=20the?= =?UTF-8?q?=20panel's=20own=20style=20(#4587)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per owner feedback the panel does NOT serve the whole website; it renders a few posts/articles with its own look instead: - src/web/blogfeed.ts: GET /__bili/blog JSON feed (website/blog/posts/*.md + website/articles.json manifest, both EN/ZH) rendered server-side with web/markdown.ts; images ride guarded GET /__bili/blog-assets/ (traversal/encoding/extension gates); fail-soft, no config surface - web/markdown.ts gains image refs (http(s)/panel asset route only) and GFM pipe tables rendered with the panel's .data classes — additive, kernel handoff output unaffected - panel gets a 博客/Blog page (card list, click to expand, bilingual via the existing language toggle which reloads) + nav entry + CSS - package.json files ships only the needed markdown + figures (+~100KB, not the whole site) --- CHANGELOG.md | 4 + README.md | 4 +- README.zh-CN.md | 2 +- package.json | 6 +- reference/architecture.md | 2 + src/server/admin.ts | 12 ++ src/web/blogfeed.ts | 332 +++++++++++++++++++++++++++++++++++++ src/web/client.ts | 66 +++++++- src/web/i18n.ts | 12 ++ src/web/markdown.ts | 24 ++- src/web/page.ts | 6 +- src/web/styles.ts | 16 ++ tests/web-blogfeed.test.ts | 147 ++++++++++++++++ website/docs/index.html | 1 + website/main.js | 2 + 15 files changed, 629 insertions(+), 7 deletions(-) create mode 100644 src/web/blogfeed.ts create mode 100644 tests/web-blogfeed.test.ts diff --git a/CHANGELOG.md b/CHANGELOG.md index ff50df9720..ca9d9c4d52 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -20,6 +20,10 @@ Versions follow the merge of a `*_release-v*` branch; CI publishes to npm on tag - **fork 克隆保号**:`cloneSessionRows`(store+mysql 双后端)把父会话行整段复制到子(session,seq) 保号 + lineage 列(parentSessionId/forkPointSeq 真值)+content/media CAS refcount 提升 + 幂等重放;子 append 自然从父 maxSeq+1(remapPlanToAbsolute)。fork 端点接线,存储不可用降级=kernel-only 克隆(现行为)。 - **验收桩**:kernel 4 测(BLOCKED 偏移重排/交换原子性/无行引用保留+被夺号重安居+死 ref 不动/已对齐幂等)+host 4 测(整段克隆保号+lineage+幂等+子续号/部分分支/superseded 拒绝+当前号通过/冷加载纯视图+服务触达对齐一次+二次幂等)。 +### 面板内置博客与长文(#4587) + +- **`/__bili/blog` JSON feed + `/__bili/blog-assets/*` 图片路由**:随 npm 包内置的 markdown(website/blog/posts/*.md + website/articles.json 清单列出的仓库长文,paper 中英文)由服务端 `web/markdown.ts`(转义优先、XSS-safe)渲染进面板自己的「博客 Blog」页——卡片列表点展正文,双语随面板语言切换,离线可读;`web/markdown.ts` 顺带支持了图片引用(http(s)/面板资产路由以外的一律丢弃)和 GFM 管道表格(复用 .data 表格样式)。图片路由带穿越/编码/扩展名三重门。内容随自更新前进,GitHub Pages(#4561)仍是永远最新的完整文库。零新配置键/env/磁盘缓存。 + ### 修复 master 回归(搭乘) - **#4525 合并把 `sidScope` 改名 `dispatchScope` 漏改一处**:dsh fork-blind-spot 日志(C10b,#4215)仍读旧名 → master tsc 红(`TS2304: Cannot find name 'sidScope'`,dsh-native.ts:1287,CI run 40093629255 failure 同因)。修复=读 `dispatchScope.getStore()` 并按 `{sid,msgIds}` 形状取 `.sid`,语义不变(作用域归因活跃判定)。 diff --git a/README.md b/README.md index 01cef318a1..604bfa942a 100644 --- a/README.md +++ b/README.md @@ -378,7 +378,9 @@ report above. **Can I query sessions and config over the web?** Yes — open [http://localhost:8787](http://localhost:8787): an overview dashboard, session list with per-session detail, live logs, a config editor, and an upstream -connectivity test. Everything is also plain JSON for scripting +connectivity test. A Blog view renders a few bundled notes and long-form +articles inside the panel itself (offline-readable; the full always-fresh +library lives on GitHub Pages). Everything else is also plain JSON for scripting (`/__bili/stats`, `/__bili/sessions`, `/__bili/config`, …). **When does compression happen?** It is model-driven: the injected context diff --git a/README.zh-CN.md b/README.zh-CN.md index 59aa0cf060..353bbdc3ab 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -285,7 +285,7 @@ bili --version **`/acp` 显示什么?** 带原生插件的客户端(opencode、dsh)里,`/acp` 直接从代理取当前会话的 ACP 状态面板(会话、块、可压缩区间、用量);首个模型请求到来前显示空闲提示。`/acp-cache [full]` 打印上面的缓存报告。 -**能用网页查会话和配置吗?** 能 —— 打开 [http://localhost:8787](http://localhost:8787):总览仪表盘、会话列表(含逐会话详情)、实时日志、配置编辑器、上游连通性测试。全部功能同样以纯 JSON 提供(`/__bili/stats`、`/__bili/sessions`、`/__bili/config`、…),方便脚本化。 +**能用网页查会话和配置吗?** 能 —— 打开 [http://localhost:8787](http://localhost:8787):总览仪表盘、会话列表(含逐会话详情)、实时日志、配置编辑器、上游连通性测试。「博客」页还在面板内直接渲染几篇随装内置的发布笔记与长文(离线可看;完整文库在 GitHub Pages)。其余功能同样以纯 JSON 提供(`/__bili/stats`、`/__bili/sessions`、`/__bili/config`、…),方便脚本化。 **压缩什么时候发生?** 由模型驱动:注入的上下文工具由模型在上下文增长时自行调用,温和的增长 nudge(按设计固定约 50K token 步长,可用 `compress.nudgeGrowthTokens` 调整)沿途提醒它,仅输入就超窗时预检作为硬兜底触发(#470)。用 `/acp` 或网页界面实时观察。 diff --git a/package.json b/package.json index 1e6ea3d534..ae5864a507 100644 --- a/package.json +++ b/package.json @@ -103,8 +103,10 @@ "dist", "dsh.bundle.patch.yml", "hermes-plugin", - "paper/model-driven-incremental-hierarchical-compression-training-free-multi-generational-context-management-for-long-lived-coding-agents.md", - "paper/figures/*.png" + "paper/*.md", + "paper/figures/*.png", + "website/articles.json", + "website/blog/posts" ], "pi": { "image": "https://raw.githubusercontent.com/ranxianglei/billion-context/master/docs/logo.png", diff --git a/reference/architecture.md b/reference/architecture.md index 465c26f7ea..bfe16b9e51 100644 --- a/reference/architecture.md +++ b/reference/architecture.md @@ -179,6 +179,8 @@ billion-context/ │ │ └── native.ts # Routing scope/exemptions policy (#1622) │ └── web/ # Web UI (config editor, sessions, logs) │ ├── api.ts # REST handlers (config get/put with parse-state guard) +│ ├── blogfeed.ts # Panel blog/articles feed from bundled markdown (#4587) +│ ├── changelog.ts # GitHub Releases feed for the panel changelog (#3719) │ ├── sessions-data.ts # Read-only session browsing (live pool + on-disk, #1420); tier tree + lazy block content (#3917) │ ├── logs-query.ts # GET /__bili/logs selection engine │ ├── markdown.ts # Escape-safe Markdown → HTML (#1420) diff --git a/src/server/admin.ts b/src/server/admin.ts index 6f57a24bf2..89d251f0e3 100644 --- a/src/server/admin.ts +++ b/src/server/admin.ts @@ -33,6 +33,7 @@ import { getPlannedUpgrade, getUpdatePolicyState } from "../update-policy.js"; import { PACKAGE_NAME, VERSION, BUILD_COMMIT } from "../version.js"; import { buildBlockContent, buildMessageContent, buildOverview, buildSessionDetail, buildSessionList, buildSessionPage, buildSessionTree, handleConfigGet, handleConfigPut, hiddenEmptyCount, renderUI, type BlockContentView } from "../web/index.js"; import { handleChangelogGet } from "../web/changelog.js"; +import { handleBlogAssetGet, handleBlogGet } from "../web/blogfeed.js"; import { buildSessionReportMd, buildSessionReportSvg } from "../web/report.js"; import { queryLogLines } from "../web/logs-query.js"; import { buildDiagnostics } from "../web/diagnostics.js"; @@ -332,6 +333,17 @@ export async function handleAdminRoute(req: http.IncomingMessage, res: http.Serv // read-only admin gating as every other /__bili/ GET above (the gates run // before dispatch). Always answers 200; offline degrades to empty+error. if (req.method === "GET" && req.url === "/__bili/changelog") return handleChangelogGet(res); + // #4587: panel-embedded blog/articles — bundled markdown rendered server-side + // into a JSON feed, plus its images under a guarded asset route. Read-only, + // fail-soft, no config surface; same gating as every other /__bili/ GET above. + if (req.method === "GET" && req.url === "/__bili/blog") { + handleBlogGet(res); + return; + } + if (req.method === "GET" && req.url !== undefined && req.url.startsWith("/__bili/blog-assets/")) { + handleBlogAssetGet(res, req.url); + return; + } // #3719: dedicated 更新/Updates tab — self-update state plus manual // check/install actions. Same gating as every /__bili/ route above (the // gates run before dispatch); an unwired process (autoUpdate off) answers diff --git a/src/web/blogfeed.ts b/src/web/blogfeed.ts new file mode 100644 index 0000000000..e3636de3f9 --- /dev/null +++ b/src/web/blogfeed.ts @@ -0,0 +1,332 @@ +/** + * Panel-embedded blog & articles (#4587): the few long-form markdown pieces we + * ship INSIDE the install (website/blog/posts/*.md + the curated list in + * website/articles.json) are rendered server-side with web/markdown.ts and + * served to the panel as a JSON feed (GET /__bili/blog); their images ride + * GET /__bili/blog-assets/. The panel renders them with its own look — + * no full site is served. Content is frozen per package release and advances + * with self-update; GitHub Pages stays the always-fresh canonical copy. + * + * Fail-soft like web/changelog.ts: missing folders/manifest → empty feed or + * plain 404s, never an exception out of the handler. No config keys, no env + * vars, no disk cache — it reads static bytes from the install itself. + */ +import { existsSync, readFileSync, readdirSync, statSync } from "node:fs"; +import { dirname, join, resolve, sep } from "node:path"; +import { fileURLToPath } from "node:url"; +import type { ServerResponse } from "node:http"; +import { markdownToHtml } from "./markdown.js"; + +export const BLOG_ASSET_PREFIX = "/__bili/blog-assets"; + +const ASSET_TYPES: Record = { + ".png": "image/png", + ".jpg": "image/jpeg", + ".jpeg": "image/jpeg", + ".gif": "image/gif", + ".svg": "image/svg+xml", + ".webp": "image/webp", +}; + +let rootOverride: string | undefined; +let probedRoot: string | undefined; +let state: { items: BlogItem[] } | undefined; + +export type BlogItem = { + id: string; + kind: "post" | "article"; + /** "" when the source carries no usable date. */ + date: string; + title: string; + titleZh: string; + excerpt: string; + excerptZh: string; + /** Rendered via web/markdown.ts — escaped by construction. */ + html: string; + htmlZh: string; +}; + +function probeRoot(): string | undefined { + // dist/index.js → ../package.json (installed layout) + // src/web/blogfeed.ts → ../../package.json (repository layout) + const here = dirname(fileURLToPath(import.meta.url)); + for (const cand of [join(here, ".."), join(here, "..", ".."), join(here, "..", "..", "..")]) { + try { + if (statSync(join(cand, "package.json")).isFile()) return cand; + } catch { + // keep probing + } + } + return undefined; +} + +function pkgRoot(): string | undefined { + if (rootOverride !== undefined) return rootOverride; + if (probedRoot === undefined) probedRoot = probeRoot(); + return probedRoot; +} + +/** Test seam (same pattern as _resetChangelogForTest): point at a fixture + * package root, or pass null to restore probing. Also clears the feed cache. */ +export function _setBlogRootForTest(root: string | null): void { + rootOverride = root ?? undefined; + probedRoot = undefined; + state = undefined; +} + +/** Mirror of the website tools' frontmatter parser (key: value between --- fences). */ +function parseFrontmatter(text: string): { fm: Record; body: string } { + const fm: Record = {}; + let body = text; + if (text.startsWith("---\n")) { + const end = text.indexOf("\n---\n", 4); + if (end !== -1) { + for (const line of text.slice(4, end).split("\n")) { + const j = line.indexOf(":"); + if (j > 0) fm[line.slice(0, j).trim()] = line.slice(j + 1).trim().replace(/^["']|["']$/g, ""); + } + body = text.slice(end + 5); + } + } + return { fm, body }; +} + +const validDate = (s: string): boolean => /^\d{4}-\d{2}-\d{2}$/.test(s); + +/** Rewrite relative image targets onto the panel asset route when the file + * actually ships inside the package root; drop references that would 404 so + * the rendered article carries no broken images. Absolute http(s) pass through. */ +function rewriteImages(md: string, srcDirAbs: string, root: string): string { + return md.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_m, _alt: string, target: string) => { + if (/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(target)) return `![${_alt}](${target})`; + let abs: string; + try { + abs = resolve(srcDirAbs, decodeURIComponent(target)); + } catch { + return ""; + } + if (!abs.startsWith(root + sep)) return ""; + const ext = abs.slice(abs.lastIndexOf(".")).toLowerCase(); + if (ASSET_TYPES[ext] === undefined || !statSyncSafe(abs)) return ""; + const rel = abs.slice(root.length + sep.length).split(sep).join("/"); + return `![${_alt}](${BLOG_ASSET_PREFIX}/${rel})`; + }); +} + +function statSyncSafe(p: string): boolean { + try { + return statSync(p).isFile(); + } catch { + return false; + } +} + +/** Strip a leading H1 line; returns [titleTextOrEmpty, rest]. */ +function splitH1(body: string): [string, string] { + const m = body.match(/^#[ \t]+([^ \t\n][^\n]*)\r?\n?/); + if (!m) return ["", body]; + return [m[1].replace(/[*_`]/g, "").trim(), body.slice(m[0].length)]; +} + +function renderBody(absFile: string, root: string): { html: string; h1: string } { + const { body } = parseFrontmatter(readFileSync(absFile, "utf8")); + const [h1, rest] = splitH1(body); + const srcDir = dirname(absFile); + return { html: markdownToHtml(rewriteImages(rest, srcDir, root)), h1 }; +} + +function collectPosts(root: string): BlogItem[] { + const postsDir = join(root, "website", "blog", "posts"); + let names: string[] = []; + try { + names = readdirSync(postsDir).filter((f) => f.endsWith(".md")).sort(); + } catch { + return []; + } + const pairs = new Map(); + for (const f of names) { + const base = f.endsWith(".zh.md") ? f.slice(0, -".zh.md".length) : f.slice(0, -".md".length); + if (!pairs.has(base)) pairs.set(base, {}); + pairs.get(base)![f.endsWith(".zh.md") ? "zh" : "en"] = f; + } + const items: BlogItem[] = []; + for (const [base, pair] of pairs) { + const slug = base.replace(/^\d{4}-\d{2}-\d{2}_/, "") || base; + const renderOne = (kind: "en" | "zh"): { html: string; h1: string; fm: Record } | undefined => { + const name = pair[kind]; + if (!name) return undefined; + let raw: string; + try { + raw = readFileSync(join(postsDir, name), "utf8"); + } catch { + return undefined; + } + const { fm, body } = parseFrontmatter(raw); + const [h1, rest] = splitH1(body); + return { html: markdownToHtml(rewriteImages(rest, postsDir, root)), h1, fm }; + }; + const en = renderOne("en"); + const zh = renderOne("zh"); + if (!en && !zh) continue; + items.push({ + id: slug, + kind: "post", + date: validDate(en?.fm.date || "") ? en!.fm.date : validDate(zh?.fm.date || "") ? zh!.fm.date : base.slice(0, 10), + title: en?.fm.title || en?.h1 || slug, + titleZh: zh?.fm.title_zh || zh?.fm.title || zh?.h1 || "", + excerpt: en?.fm.excerpt || "", + excerptZh: zh?.fm.excerpt_zh || "", + html: en?.html || "", + htmlZh: zh?.html || "", + }); + } + return items; +} + +function collectArticles(root: string): BlogItem[] { + const manifestPath = join(root, "website", "articles.json"); + if (!statSyncSafe(manifestPath)) return []; + let manifest: unknown; + try { + manifest = JSON.parse(readFileSync(manifestPath, "utf8")); + } catch { + return []; + } + const list = Array.isArray((manifest as { articles?: unknown })?.articles) ? (manifest as { articles: unknown[] }).articles : []; + const items: BlogItem[] = []; + for (const entryRaw of list) { + const entry = entryRaw as { file?: unknown; zh_file?: unknown; slug?: unknown; title?: unknown; title_zh?: unknown; date?: unknown }; + const file = typeof entry.file === "string" ? entry.file : ""; + if (!file || file.includes("\0")) continue; + let abs: string; + try { + abs = resolve(root, decodeURIComponent(file)); + } catch { + continue; + } + if (!abs.startsWith(root + sep) || !statSyncSafe(abs)) continue; + let raw: string; + try { + raw = readFileSync(abs, "utf8"); + } catch { + continue; + } + const { fm, body } = parseFrontmatter(raw); + const [h1, rest] = splitH1(body); + const slugIn = typeof entry.slug === "string" && entry.slug ? entry.slug : file.replace(/\.md$/, "").split("/").pop()!; + let zhHtml = ""; + let zhTitle = ""; + if (typeof entry.zh_file === "string") { + const zhAbs = resolve(root, entry.zh_file); + if (zhAbs.startsWith(root + sep) && statSyncSafe(zhAbs)) { + try { + const zparsed = parseFrontmatter(readFileSync(zhAbs, "utf8")); + const [zhH1, zhRest] = splitH1(zparsed.body); + zhHtml = markdownToHtml(rewriteImages(zhRest, dirname(zhAbs), root)); + zhTitle = (typeof entry.title_zh === "string" && entry.title_zh ? entry.title_zh : "") || zparsed.fm.title_zh || zparsed.fm.title || zhH1 || ""; + } catch { + zhHtml = ""; + } + } + } + const date = (typeof entry.date === "string" ? entry.date : "") || fm.date || ""; + items.push({ + id: `${slugIn}`, + kind: "article", + date: validDate(date) ? date : "", + title: (typeof entry.title === "string" && entry.title ? entry.title : "") || fm.title || h1 || slugIn, + titleZh: zhTitle, + excerpt: fm.excerpt || "", + excerptZh: fm.excerpt_zh || "", + html: markdownToHtml(rewriteImages(rest, dirname(abs), root)), + htmlZh: zhHtml, + }); + } + return items; +} + +function collect(): BlogItem[] { + const root = pkgRoot(); + if (!root) return []; + const items = [...collectPosts(root), ...collectArticles(root)]; + // Dated entries newest-first; undated ones keep a stable id-ordered tail. + items.sort((a, b) => { + if (a.date && b.date) return a.date === b.date ? a.id.localeCompare(b.id) : a.date < b.date ? 1 : -1; + if (a.date !== b.date) return a.date ? -1 : 1; + return a.id.localeCompare(b.id); + }); + return items; +} + +/** Cached feed (content only changes across package updates → one compute per + * process). Never throws: any surprise degrades to an empty list. */ +export function getBlogFeed(): { items: BlogItem[]; error?: string } { + if (state === undefined) { + try { + state = { items: collect() }; + } catch { + state = { items: [] }; + } + } + return state; +} + +/** GET /__bili/blog — always 200 JSON; the panel degrades on an empty list. */ +export function handleBlogGet(res: ServerResponse): void { + const data = getBlogFeed(); + res.writeHead(200, { "content-type": "application/json; charset=utf-8", "cache-control": "no-cache" }); + res.end(JSON.stringify(data)); +} + +/** One decoded-and-validated path segment list, or undefined for every + * rejection class: bad percent-encoding, empty/"."/".."/NUL segments. */ +function safeSegments(urlPath: string): string[] | undefined { + const raw = urlPath.slice(BLOG_ASSET_PREFIX.length + 1); + const parts = raw === "" ? [] : raw.split("/"); + const out: string[] = []; + for (const segRaw of parts) { + if (segRaw === "") continue; + let seg: string; + try { + seg = decodeURIComponent(segRaw); + } catch { + return undefined; + } + if (seg === "" || seg === "." || seg === ".." || seg.includes("\0")) return undefined; + out.push(seg); + } + return out; +} + +/** GET /__bili/blog-assets/ — bundled image bytes only (extension gate + + * traversal gate); anything else is a plain-text 404. */ +export function handleBlogAssetGet(res: ServerResponse, urlPath: string): void { + const notFound = () => { + res.writeHead(404, { "content-type": "text/plain; charset=utf-8", "cache-control": "no-cache" }); + res.end(`404 Not Found: ${urlPath}\n`); + }; + const clean = urlPath.split(/[?#]/)[0]; + if (!clean.startsWith(BLOG_ASSET_PREFIX + "/")) { + notFound(); + return; + } + const root = pkgRoot(); + const segments = safeSegments(clean); + if (!root || segments === undefined) { + notFound(); + return; + } + const file = resolve(root, ...segments); + if (!file.startsWith(root + sep)) { + notFound(); + return; + } + const ext = file.slice(file.lastIndexOf(".")).toLowerCase(); + const type = ASSET_TYPES[ext]; + if (type === undefined || !statSyncSafe(file)) { + notFound(); + return; + } + res.writeHead(200, { "content-type": type, "cache-control": "no-cache" }); + res.end(readFileSync(file)); +} diff --git a/src/web/client.ts b/src/web/client.ts index 419a216ef9..1f4809a717 100644 --- a/src/web/client.ts +++ b/src/web/client.ts @@ -479,7 +479,7 @@ export const WEB_CLIENT = `(function () { if (tog) tog.textContent = locale === "zh-CN" ? "English" : "中文"; } - const PAGES = ["overview", "sessions", "config", "updates", "connect", "logs"]; + const PAGES = ["overview", "sessions", "config", "updates", "connect", "logs", "blog"]; let current = "overview"; let sessionsCache = []; // #1682: last overview alert payload — lets a dismiss re-render without refetching. @@ -865,6 +865,69 @@ function changelogCatOf(rawLine) { // the snapshot — keep the buttons held down until it settles. if (st.checking || st.installing) upSetButtons(true); } + // #4587: panel-embedded blog & articles — the server renders the bundled + // markdown with web/markdown.ts (escaped by construction), so this side only + // lays out cards and expands bodies. Language rides the page-level locale; + // switching languages reloads the page, so no incremental re-render hook. + let blogCache = null; + async function loadBlog() { + const host = $("bl-list"); + if (!host) return; + let data = blogCache; + if (!data) { + try { + data = blogCache = await json(API_ROOT + "/blog"); + } catch (e) { + host.innerHTML = ""; + toast(t("toast.failed", { msg: e.message }), "err"); + return; + } + } + const items = (data && Array.isArray(data.items)) ? data.items : []; + if (!items.length) { + const wrap = document.createElement("div"); + wrap.className = "card"; + const box = document.createElement("div"); + box.className = "card-b"; + box.textContent = t("bl.empty"); + wrap.appendChild(box); + host.innerHTML = ""; + host.appendChild(wrap); + return; + } + host.innerHTML = items.map((it) => { + const zhOn = locale === "zh-CN"; + const title = zhOn && it.titleZh ? it.titleZh : (it.title || ""); + const otherTitle = zhOn ? (it.title || "") : (it.titleZh || ""); + const ex = zhOn ? (it.excerptZh || it.excerpt || "") : (it.excerpt || ""); + let kindLabel; + if (it.kind === "post") kindLabel = t("bl.kind_post"); + else kindLabel = t("bl.kind_article"); + + return '
' + + '
' + escapeHtml(it.date || "\u2014") + '' + + '' + escapeHtml(kindLabel) + '' + + '' + escapeHtml(title) + (otherTitle ? ' ' + escapeHtml(otherTitle) + "" : "") + "" + + '▾
' + + (ex ? '
' + escapeHtml(ex) + "
" : "") + + '
'; + }).join(""); + host.querySelectorAll(".bl-item").forEach((el) => { + const head = el.querySelector(".bl-head"); + const bodyEl = el.querySelector(".bl-body"); + if (!head || !bodyEl) return; + head.addEventListener("click", () => { + bodyEl.hidden = !bodyEl.hidden; + const caret = el.querySelector(".bl-caret"); + if (caret) caret.textContent = bodyEl.hidden ? "\u25BE" : "\u25B4"; + if (bodyEl.hidden || bodyEl.dataset.filled === "1") return; + const item = items.find((x) => String(x.id) === el.getAttribute("data-bl-id")); + if (!item) return; + bodyEl.innerHTML = locale === "zh-CN" ? (item.htmlZh || item.html) : item.html; + bodyEl.dataset.filled = "1"; + }); + }); + } async function loadUpdates() { try { const [st, cl] = await Promise.all([json(API_ROOT + "/update/state"), json(API_ROOT + "/changelog")]); @@ -4090,6 +4153,7 @@ if (d.keepalive) kv(parts, t("det.keepalive"), d.keepalive.tierLabel + " · " + else if (name === "sessions") loadSessions(detailId); else if (name === "config") loadConfig(); else if (name === "updates") loadUpdates(); + else if (name === "blog") loadBlog(); else if (name === "logs") loadLogs(); } window.addEventListener("hashchange", route); diff --git a/src/web/i18n.ts b/src/web/i18n.ts index cd941b96ab..8ba7487e2c 100644 --- a/src/web/i18n.ts +++ b/src/web/i18n.ts @@ -31,6 +31,12 @@ export const MESSAGES: Record> = { "nav.sessions": "会话", "nav.config": "配置", "nav.updates": "版本", + "nav.blog": "博客", + "bl.title": "博客 / 文库", + "bl.sub": "几篇发布笔记与长文在面板内直接渲染——随安装包内置,离线可读;永远最新的完整文库在 GitHub Pages。", + "bl.kind_post": "发布笔记", + "bl.kind_article": "长文", + "bl.empty": "这个版本还没内置文章。", "nav.connect": "接入", "nav.logs": "日志", "logs.title": "运行日志", @@ -635,6 +641,12 @@ export const MESSAGES: Record> = { "nav.sessions": "Sessions", "nav.config": "Configuration", "nav.updates": "Versions", + "nav.blog": "Blog", + "bl.title": "Blog & Articles", + "bl.sub": "A few release notes and long-form pieces rendered right here — shipped inside your install, readable offline; the always-fresh full library lives on GitHub Pages.", + "bl.kind_post": "Post", + "bl.kind_article": "Article", + "bl.empty": "No bundled articles in this build.", "nav.connect": "Connect", "nav.logs": "Logs", "logs.title": "Run log", diff --git a/src/web/markdown.ts b/src/web/markdown.ts index dacfba897c..6570c83e3f 100644 --- a/src/web/markdown.ts +++ b/src/web/markdown.ts @@ -3,7 +3,8 @@ * reaches the output unescaped), then transform structure only. Supports the * subset kernel renderHandoff actually emits: headings, paragraphs, fenced * code, inline code, bold/italic, lists, blockquotes, links (sanitized), - * horizontal rules. No external dependency — dist/index.js stays dep-free. */ + * horizontal rules, pipe tables and image refs (http(s)/panel asset routes + * only). No external dependency — dist/index.js stays dep-free. */ function escapeHtml(s: string): string { return s.replace(/&/g, "&").replace(//g, ">").replace(/"/g, """); @@ -12,6 +13,14 @@ function escapeHtml(s: string): string { function inlineMd(s: string): string { let out = escapeHtml(s); out = out.replace(/`([^`]+)`/g, (_m, code: string) => `${code}`); + // ![alt](url) — must run before the link rule so the image syntax is consumed + // whole. Only published image sources survive: http(s), or the panel's own + // bundled-asset route (/__bili/blog-assets/*, see web/blogfeed.ts). Quotes are + // already escaped by escapeHtml, so attribute injection is impossible. + out = out.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_m, alt: string, url: string) => { + if (/^(?:https?:\/\/|\/__bili\/blog-assets\/)/i.test(url)) return `${alt}`; + return ""; + }); out = out.replace(/\*\*([^*]+)\*\*/g, "$1"); out = out.replace(/(^|[^*])\*([^*\n]+)\*/g, "$1$2"); // [text](url) — only http/https/relative URLs survive; anything else @@ -48,6 +57,19 @@ export function markdownToHtml(md: string): string { continue; } if (/^\s*(---+|\*\*\*+)\s*$/.test(line)) { html.push("
"); i += 1; continue; } + // Pipe tables (header + dash separator row + body rows). The kernel + // handoff never emits these; bundled articles do. Rendered with the + // panel's own .data table classes so they match every other table. + if (/^\s*\|.*\|\s*$/.test(line) && i + 1 < lines.length && /^\s*\|[\s:|-]+\|\s*$/.test(lines[i + 1])) { + const cells = (row: string): string[] => row.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => inlineMd(c.trim())); + const head = cells(line); + i += 2; + const rows: string[][] = []; + while (i < lines.length && /^\s*\|.*\|\s*$/.test(lines[i])) { rows.push(cells(lines[i])); i += 1; } + html.push(`${head.map((c) => ``).join("")}` + + `${rows.map((r) => `${r.map((c) => ``).join("")}`).join("")}
${c}
${c}
`); + continue; + } // Indented runs (machine-emitted tool arguments, nested lists) stay verbatim in //
 instead of being merged into one run-on paragraph by space-joining.
         if (/^\s{2,}\S/.test(line)) {
diff --git a/src/web/page.ts b/src/web/page.ts
index 6df33d1844..52f2866671 100644
--- a/src/web/page.ts
+++ b/src/web/page.ts
@@ -23,7 +23,7 @@ export function renderPage(origin: string, version: string, embed = false, theme
     // that request used to miss every admin route and get relayed onto the
     // configured upstream (a wasted request + 403 noise in the log).
     return `billion-context
-
billion-contextv${version}
+
billion-contextv${version}
@@ -228,6 +228,10 @@ rendering/linkify in client.js into #changelog-body (collapsed by default). -->

${zh("zcode.hint_a")} ~ ${zh("zcode.hint_b")} ~/... ${zh("zcode.hint_c")}

+
diff --git a/src/web/styles.ts b/src/web/styles.ts index e575c80671..43a3b0b0f6 100644 --- a/src/web/styles.ts +++ b/src/web/styles.ts @@ -537,4 +537,20 @@ pre.tool-args, pre.tool-out { margin: 6px 0 0; padding: 8px; background: var(--b embed face a little breathing room instead of zero gutter. */ .embed main { max-width: none; padding: 8px 10px 16px; } .embed .banner { margin: 8px 0 0; } + +/* #4587: panel-embedded blog & article view */ +.bl-head { cursor: pointer; user-select: none; } +.bl-head:hover .bl-title { color: var(--accent); } +.bl-date { color: var(--text-faint); font-size: 12px; } +.bl-title { flex: 1; font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.bl-title-alt { color: var(--text-faint); font-weight: 400; } +.bl-caret { color: var(--text-faint); font-size: 12px; } +.bl-ex { color: var(--text-muted); font-size: 13px; } +.post-body p { line-height: 1.7; } +.post-body pre { background: var(--bg-elev); border: 1px solid var(--border-soft); border-radius: 8px; padding: 12px; overflow-x: auto; } +.post-body code { font-family: var(--mono); font-size: 0.92em; background: var(--bg-elev); padding: 1px 5px; border-radius: 4px; } +.post-body pre code { background: none; padding: 0; } +.post-body blockquote { border-left: 3px solid var(--accent); margin: 12px 0; padding: 4px 14px; color: var(--text-muted); background: var(--bg-elev); border-radius: 0 8px 8px 0; } +.post-body h2 { margin-top: 22px; } +.post-body .md-img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border-soft); } `; diff --git a/tests/web-blogfeed.test.ts b/tests/web-blogfeed.test.ts new file mode 100644 index 0000000000..9ed1860443 --- /dev/null +++ b/tests/web-blogfeed.test.ts @@ -0,0 +1,147 @@ +/** + * Panel blog/articles feed (#4587, src/web/blogfeed.ts) — bundled markdown → + * server-rendered JSON feed + guarded image assets. Covers both directions of + * every gate: dated/undated ordering, bilingual pairing, frontmatter titles, + * XSS-escaped rendering, image rewrite vs drop (incl. traversal refs), + * GFM tables, asset route (png allowed / md denied / traversal / encoding / + * missing), malformed manifest degradation, absent-root empty feed, and the + * real-tree probe finding the repository's website/blog/posts. + */ +import { test, beforeEach, afterEach } from "node:test"; +import assert from "node:assert/strict"; +import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs"; +import { tmpdir } from "node:os"; +import { join } from "node:path"; +import type { ServerResponse } from "node:http"; +import { getBlogFeed, handleBlogGet, handleBlogAssetGet, _setBlogRootForTest } from "../src/web/blogfeed.ts"; + +let pkgRoot = ""; +let outsideDir = ""; + +function fakeRes(): { res: ServerResponse; status: number | undefined; headers: Record; body: string } { + const out: { res: ServerResponse; status: number | undefined; headers: Record; body: string } = + { res: undefined as unknown as ServerResponse, status: undefined, headers: {}, body: "" }; + out.res = { + writeHead(_status: number, headers?: Record) { out.status = _status; out.headers = headers ?? {}; }, + end(chunk?: string | Uint8Array) { if (chunk !== undefined) out.body += Buffer.from(chunk).toString("utf8"); }, + } as unknown as ServerResponse; + return out; +} + +function buildFixture(): void { + mkdirSync(join(pkgRoot, "website", "blog", "posts"), { recursive: true }); + mkdirSync(join(pkgRoot, "website", "blog", "posts", "figures"), { recursive: true }); + mkdirSync(join(pkgRoot, "paper", "figures"), { recursive: true }); + writeFileSync(join(pkgRoot, "package.json"), "{}"); + writeFileSync(join(pkgRoot, "outside-secret.yaml"), "nope"); + const posts = join(pkgRoot, "website", "blog", "posts"); + writeFileSync(join(posts, "2026-10-08_demo.md"), + "---\ntitle: \"Demo post\"\nexcerpt: \"EN excerpt.\"\n---\n\n## Body\n\nText with inline.\n\n![shot](figures/shot.png)\n\n![escape](../../outside-secret.yaml)\n"); + writeFileSync(join(posts, "2026-10-08_demo.zh.md"), + "---\ntitle_zh: \"演示文章\"\nexcerpt_zh: \"中文摘要。\"\n---\n\n## 正文\n\n中文内容。\n"); + writeFileSync(join(posts, "2026-10-09_new.md"), "# Undated-by-frontmatter post\n\nNewer content.\n"); + writeFileSync(join(posts, "figures", "shot.png"), "POSTPNG"); + writeFileSync(join(pkgRoot, "website", "articles.json"), JSON.stringify({ articles: [ + { file: "paper/a.md", zh_file: "paper/b.md", slug: "alpha" }, + { file: "paper/missing.md" }, + ] })); + writeFileSync(join(pkgRoot, "paper", "a.md"), + "# Article Alpha\n\nTable below:\n\n| k | v |\n|---|---|\n| 1 | two |\n\n![fig](figures/p.png)\n"); + writeFileSync(join(pkgRoot, "paper", "b.md"), "# 文章 Alpha(中文)\n\n中文正文。\n"); + writeFileSync(join(pkgRoot, "paper", "figures", "p.png"), "PAPERPNG"); +} + +beforeEach(() => { + outsideDir = mkdtempSync(join(tmpdir(), "bili-blogroot-")); + pkgRoot = join(outsideDir, "pkg"); + buildFixture(); + _setBlogRootForTest(pkgRoot); +}); + +afterEach(() => { + _setBlogRootForTest(null); + rmSync(outsideDir, { recursive: true, force: true }); +}); + +test("feed composes posts + manifest articles, dated newest-first, undated tail", () => { + const data = getBlogFeed(); + assert.equal(data.items.length, 3); // demo(newer-twin) + new(10-09) + alpha(article, undated) + assert.deepEqual(data.items.map((i) => i.id), ["new", "demo", "alpha"]); + assert.equal(data.items[1].kind, "post"); + assert.equal(data.items[2].kind, "article"); + assert.equal(data.items[2].date, ""); + assert.equal(data.items[1].title, "Demo post"); + assert.equal(data.items[1].titleZh, "演示文章"); + assert.ok(data.items[1].excerpt.endsWith("EN excerpt.")); + assert.equal(data.items[1].excerptZh, "中文摘要。"); + assert.ok(data.items[2].title === "Article Alpha", "article title falls back to H1"); + assert.equal(data.items[2].titleZh, "文章 Alpha(中文)"); + assert.ok(!JSON.stringify(data.items).includes("missing.md"), "unresolvable manifest entry is skipped, not fatal"); +}); + +test("rendering is escape-first: script tags survive only escaped; tables become panel data tables", () => { + const data = getBlogFeed(); + const demo = data.items.find((i) => i.id === "demo")!; + assert.ok(demo.html.includes("<script>alert(1)</script>")); + assert.ok(!demo.html.includes("