@dongfangw/study-kit 0.0.0-stage → 0.1.1

package/lib/git.js

@@ -0,0 +1,305 @@
+/**
+ * 工作台 Git 集成（宿主侧）。
+ *
+ * 通过 spawn('git') 对「知识库四仓」提供只读/安全写操作：
+ *   - repos  五仓概况（分支/远端/ahead/behind/脏标记/最新提交）
+ *   - status 单仓详情（porcelain 改动清单 + 最近提交）
+ *   - fetch / pull / push / commit
+ *
+ * 安全约定：
+ *   - 仓库清单由 libraries.yaml 注入（见 setGitRepos），插件不含课程仓库名；
+ *     不接受任何用户提供的路径；
+ *   - 所有参数走 spawn args（不经过 shell）；
+ *   - GIT_TERMINAL_PROMPT=0 + SSH BatchMode=yes：认证失败立即报错，绝不挂起等口令；
+ *   - pull 使用 --ff-only：脏工作区 / 分叉时安全中止；
+ *   - 每仓库一把并发锁，同一时间只允许一个 git 操作。
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+const SSH_COMMAND = 'ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new -o ConnectTimeout=15';
+export let REPO_DEFS = [];
+/** 把 REPO_DEFS 绑定到实际目录（KB 根 + 插件包目录），过滤不存在的仓库。 */
+/**
+ * 仓库清单**由调用方注入**（来自 libraries.yaml 里各库的根目录 + 名字），
+ * 本插件源码里不出现任何课程仓库名。没注入过就是空 → Git 面板自动隐藏。
+ */
+export function setGitRepos(defs) {
+    REPO_DEFS = defs.filter((r) => r.dir !== '' && existsSync(path.join(r.dir, '.git')));
+}
+/** 当前生效的仓库清单（只读）。 */
+export function getGitRepos() {
+    return REPO_DEFS;
+}
+/** 兼容旧调用：返回已注入的仓库清单。 */
+export function resolveRepos(_kbRoot, _pkgDir) {
+    return [...REPO_DEFS];
+}
+function runGit(dir, args, timeoutMs = 60_000) {
+    return new Promise((resolve) => {
+        const child = spawn('git', ['-C', dir, ...args], {
+            env: {
+                ...process.env,
+                GIT_TERMINAL_PROMPT: '0',
+                GIT_SSH_COMMAND: SSH_COMMAND,
+                GIT_OPTIONAL_LOCKS: '0',
+                LC_ALL: 'C',
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let output = '';
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, timeoutMs);
+        const onData = (c) => {
+            output += c.toString('utf8');
+            if (output.length > 256 * 1024)
+                output = output.slice(output.length - 256 * 1024);
+        };
+        child.stdout.on('data', onData);
+        child.stderr.on('data', onData);
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({ code: -1, output: `无法启动 git：${err.message}`, timedOut: false });
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({ code: code ?? -1, output, timedOut });
+        });
+    });
+}
+/** 单仓库并发锁：串行化同一仓库的 git 操作。 */
+const locks = new Map();
+function withLock(dir, fn) {
+    const prev = locks.get(dir) ?? Promise.resolve();
+    const next = prev.then(fn, fn);
+    locks.set(dir, next.catch(() => undefined));
+    return next;
+}
+// ---------------------------------------------------------------------------
+// 状态解析
+// ---------------------------------------------------------------------------
+/** 解析 `git status --porcelain=v1 -b` 首行（`## main...origin/main [ahead 1, behind 2]`）。 */
+function parseBranchLine(line) {
+    const clean = line.replace(/^##\s+/, '').trim();
+    const ahead = /ahead\s+(\d+)/.exec(clean)?.[1] ?? '0';
+    const behind = /behind\s+(\d+)/.exec(clean)?.[1] ?? '0';
+    const main = clean.split('[')[0]?.trim() ?? '';
+    const [branch, upstream] = main.split('...');
+    return {
+        branch: branch || 'HEAD',
+        upstream: upstream ?? '',
+        ahead: Number(ahead),
+        behind: Number(behind),
+    };
+}
+/** 解析 `git status --porcelain=v1 --untracked-files=normal` 的改动清单。 */
+function parseChanges(text) {
+    const out = [];
+    for (const line of text.split('\n')) {
+        if (line.length < 4)
+            continue;
+        const x = line[0] ?? ' ';
+        const y = line[1] ?? ' ';
+        let p = line.slice(3);
+        if ((x === 'R' || y === 'R' || x === 'C' || y === 'C') && p.includes(' -> ')) {
+            p = p.split(' -> ').join(' → ');
+        }
+        out.push({
+            path: p,
+            status: `${x === ' ' ? '' : x}${y === ' ' ? '' : y}`,
+            staged: x !== ' ',
+        });
+    }
+    return out;
+}
+const LOG_FORMAT = '%x1f%H%x1f%s%x1f%an%x1f%cI';
+function parseLog(output) {
+    const commits = [];
+    const parts = output.split('\x1f').filter((s) => s !== '');
+    for (let i = 0; i + 3 < parts.length; i += 4) {
+        const hash = parts[i];
+        if (hash === undefined)
+            break;
+        commits.push({
+            hash: hash.slice(0, 10),
+            message: (parts[i + 1] ?? '').trim(),
+            author: (parts[i + 2] ?? '').trim(),
+            date: (parts[i + 3] ?? '').trim(),
+        });
+    }
+    return commits;
+}
+async function repoHeadInfo(dir) {
+    const st = await runGit(dir, ['-c', 'core.quotePath=false', 'status', '--porcelain=v1', '-b'], 15_000);
+    if (st.code !== 0) {
+        return { branch: '?', upstream: '', ahead: 0, behind: 0, dirty: false, lastCommit: null };
+    }
+    const firstLine = st.output.split('\n')[0] ?? '';
+    const { branch, upstream, ahead, behind } = parseBranchLine(firstLine);
+    const dirty = st.output.split('\n').filter((l) => l.trim() !== '').length > 1;
+    const log = await runGit(dir, ['log', '-1', `--pretty=format:${LOG_FORMAT}`], 15_000);
+    const lastCommit = log.code === 0 ? parseLog(log.output)[0] ?? null : null;
+    return { branch, upstream, ahead, behind, dirty, lastCommit };
+}
+function sendJson(res, code, body) {
+    res.statusCode = code;
+    res.setHeader('Content-Type', 'application/json; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-store');
+    res.end(JSON.stringify(body));
+}
+function readBody(req, limit = 256 * 1024) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (c) => {
+            size += c.length;
+            if (size > limit) {
+                reject(new Error('请求体过大'));
+                req.destroy();
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+}
+export function createGitHandler(opts) {
+    return async (req, res) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        const parts = url.pathname.split('/').filter(Boolean);
+        // parts: ['aero-kb', 'git', <repoId?>, <action?>]
+        const hintCwd = url.searchParams.get('cwd') ?? undefined;
+        const repoId = parts[2] ?? '';
+        const action = parts[3] ?? '';
+        try {
+            if (repoId === '' || (action === '' && req.method !== 'GET')) {
+                sendJson(res, 400, { ok: false, error: '缺少仓库 id' });
+                return;
+            }
+            const repos = resolveRepos(opts.resolveKbRoot(hintCwd), opts.pkgDir);
+            const repo = repos.find((r) => r.id === repoId);
+            // GET /aero-kb/git/repos —— 四仓概况
+            if (repoId === 'repos') {
+                const summaries = await Promise.all(repos.map(async (r) => {
+                    const info = await repoHeadInfo(r.dir);
+                    const remoteRes = await runGit(r.dir, ['remote', 'get-url', 'origin'], 10_000);
+                    return {
+                        id: r.id,
+                        name: r.name,
+                        dir: r.dir,
+                        branch: info.branch,
+                        remote: remoteRes.code === 0 ? remoteRes.output.trim().split('\n')[0] ?? '' : '',
+                        ahead: info.ahead,
+                        behind: info.behind,
+                        dirty: info.dirty,
+                        lastCommit: info.lastCommit,
+                    };
+                }));
+                sendJson(res, 200, { ok: true, repos: summaries });
+                return;
+            }
+            if (repo === undefined) {
+                sendJson(res, 404, { ok: false, error: `未知仓库：${repoId}` });
+                return;
+            }
+            // GET /aero-kb/git/<id>/status
+            if (action === 'status' && req.method === 'GET') {
+                const [head, st, log] = await Promise.all([
+                    repoHeadInfo(repo.dir),
+                    runGit(repo.dir, ['-c', 'core.quotePath=false', 'status', '--porcelain=v1', '--untracked-files=normal'], 15_000),
+                    runGit(repo.dir, ['log', '-5', `--pretty=format:${LOG_FORMAT}`], 15_000),
+                ]);
+                const body = {
+                    ok: true,
+                    id: repo.id,
+                    branch: head.branch,
+                    upstream: head.upstream,
+                    ahead: head.ahead,
+                    behind: head.behind,
+                    changes: st.code === 0 ? parseChanges(st.output) : [],
+                    log: log.code === 0 ? parseLog(log.output) : [],
+                };
+                sendJson(res, 200, body);
+                return;
+            }
+            if (req.method !== 'POST') {
+                sendJson(res, 405, { ok: false, error: '仅支持 GET status/repos 与 POST fetch/pull/push/commit' });
+                return;
+            }
+            const ops = ['fetch', 'pull', 'push', 'commit'];
+            if (!ops.includes(action)) {
+                sendJson(res, 404, { ok: false, error: `未知操作：${action}` });
+                return;
+            }
+            const op = action;
+            const run = async () => {
+                let result;
+                if (op === 'commit') {
+                    let msg = '';
+                    try {
+                        const parsed = JSON.parse(await readBody(req));
+                        msg = typeof parsed.message === 'string' ? parsed.message.trim() : '';
+                    }
+                    catch {
+                        /* 无效 JSON → msg 为空 */
+                    }
+                    if (msg === '') {
+                        return { ok: false, op: 'commit', id: repo.id, output: '', error: '提交信息不能为空' };
+                    }
+                    const add = await runGit(repo.dir, ['add', '-A'], 60_000);
+                    if (add.code !== 0) {
+                        return { ok: false, op: 'commit', id: repo.id, output: add.output, error: `git add 失败（exit ${add.code}）` };
+                    }
+                    result = await runGit(repo.dir, ['commit', '-m', msg], 60_000);
+                    if (result.code !== 0) {
+                        return { ok: false, op: 'commit', id: repo.id, output: result.output, error: `git commit 失败（exit ${result.code}）` };
+                    }
+                }
+                else {
+                    const args = [];
+                    if (op === 'fetch')
+                        args.push('fetch', '--prune', 'origin');
+                    if (op === 'pull')
+                        args.push('pull', '--ff-only');
+                    if (op === 'push')
+                        args.push('push');
+                    result = await runGit(repo.dir, args, 120_000);
+                }
+                const failMsg = () => result.timedOut ? '操作超时（已终止）' : `操作失败（exit ${result.code}）`;
+                if (result.code !== 0) {
+                    return { ok: false, op, id: repo.id, output: result.output, error: failMsg() };
+                }
+                if (op === 'pull')
+                    opts.onPullSuccess(repo.id);
+                // 操作后回传最新状态（commit 后 ahead 计数变化、pull 后 behind 清零等）。
+                const head = await repoHeadInfo(repo.dir);
+                return {
+                    ok: true,
+                    op,
+                    id: repo.id,
+                    output: result.output,
+                    summary: {
+                        ok: true,
+                        id: repo.id,
+                        branch: head.branch,
+                        upstream: head.upstream,
+                        ahead: head.ahead,
+                        behind: head.behind,
+                        changes: [],
+                        log: [],
+                    },
+                };
+            };
+            const body = await withLock(repo.dir, run);
+            sendJson(res, body.ok ? 200 : 400, body);
+        }
+        catch (err) {
+            sendJson(res, 500, { ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    };
+}
+//# sourceMappingURL=git.js.map

package/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type CatalogNode } from '@dongfangW/library-core';
+export declare const name = "aero-study-kit";
+export declare const inject: string[];
+/** 插件包目录（`slidev` 构建缓存、`ext/adoc-convert` 定位都基于它）。 */
+export declare const PKG_DIR: string;
+export declare function apply(ctx: Context): void;
+/** 供测试/调试：把目录树摊平成路径（不导出到客户端契约里）。 */
+export declare function flattenCatalogPaths(nodes: readonly CatalogNode[]): string[];
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAcpE,eAAO,MAAM,IAAI,mBAAmB,CAAA;AACpC,eAAO,MAAM,MAAM,UAAmC,CAAA;AAqQtD,sDAAsD;AACtD,eAAO,MAAM,OAAO,QAAsG,CAAA;AAE1H,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqCxC;AAED,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,EAAE,CAO3E"}

package/lib/index.js

@@ -0,0 +1,324 @@
+/**
+ * `@dongfangW/study-kit` 宿主侧入口：把"一个工作区里的多个库"变成可读、可搜、可问的学习台。
+ *
+ * 路由（`/kb/*`，并且 `/aero-kb/*` 作为别名继续可用）：
+ *   GET  health · libraries · catalog · doc · asset · katex · slidev/… · git/…
+ *
+ * 设计边界（见 ADR-001）：
+ * - **不认磁盘布局**：路径只来自库清单（R4）；
+ * - **不出现课程专名**（R3）；
+ * - **不含仿真、不含备课写回**：那是 sim-kit / prep-kit 的事。
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { isInside } from '@dongfangW/library-core';
+import { createGitHandler, setGitRepos } from "./git.js";
+import { DEFAULT_SEGMENT_TARGET_BYTES, SEGMENT_HARD_MAX_BYTES, mapSegmentIndex, splitDocument } from "./docsplit.js";
+import { createSlidevHandler, disposeSlidev } from "./slidev.js";
+import { handleSlidevEnv } from "./slidevEnv.js";
+import { gitDefsOf } from "./libraries.js";
+import { buildCatalogForClient } from "./libraries.js";
+import { invalidate, resolveFor } from "./session.js";
+import { katexDistDir, readKbText, renderAsciidocAsync, renderMarkdown, renderSlidesMd } from "./render.js";
+import { sendFile } from "./static.js";
+import { registerKbTools } from "./tools.js";
+import { registerBundledSkills } from "./skills.js";
+export const name = 'aero-study-kit';
+export const inject = ['tools', 'agents', 'webServer'];
+const CONTENT_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.txt': 'text/plain; charset=utf-8',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.bmp': 'image/bmp',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.woff2': 'font/woff2',
+    '.woff': 'font/woff',
+    '.ttf': 'font/ttf',
+    '.css': 'text/css; charset=utf-8',
+};
+function sendJson(res, code, body) {
+    res.statusCode = code;
+    res.setHeader('Content-Type', 'application/json; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-store');
+    res.end(JSON.stringify(body));
+}
+function sendText(res, code, text) {
+    res.statusCode = code;
+    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-store');
+    res.end(text);
+}
+function safeAbs(root, rel) {
+    const abs = path.resolve(root, rel);
+    if (!isInside(root, abs))
+        throw new Error('非法路径');
+    return abs;
+}
+/** 从请求里取"会话 cwd"线索。 */
+function hintCwd(url) {
+    const v = url.searchParams.get('cwd');
+    return v === null || v === '' ? undefined : v;
+}
+/** 渲染一篇文档（超长自动分段；分段失败时回落到单段）。 */
+async function renderDoc(text, kind, ctx, segParam) {
+    const render = (source) => kind === 'adoc' ? renderAsciidocAsync(source, ctx) : renderMarkdown(source, ctx);
+    let plan = splitDocument(text, kind);
+    let seg = 0;
+    const rawSeg = segParam === null ? 0 : Number(segParam);
+    if (Number.isInteger(rawSeg) && rawSeg >= 0 && rawSeg < plan.segments.length)
+        seg = rawSeg;
+    let source = plan.segments.length > 1 ? `${plan.header}\n${plan.segments[seg].text}` : text;
+    let result = await render(source);
+    for (let guard = 0; guard < 3; guard++) {
+        if (!result.ok || result.html.length <= SEGMENT_HARD_MAX_BYTES || plan.segments.length <= 1)
+            break;
+        const next = splitDocument(text, kind, Math.max(300_000, Math.round(DEFAULT_SEGMENT_TARGET_BYTES / 2)));
+        if (next.segments.length <= plan.segments.length)
+            break;
+        seg = mapSegmentIndex(next, plan.segments[seg].from);
+        plan = next;
+        source = `${plan.header}\n${plan.segments[seg].text}`;
+        result = await render(source);
+    }
+    if (plan.segments.length <= 1)
+        return result;
+    return {
+        ...result,
+        seg,
+        segments: plan.segments.map((s, i) => ({ index: i, title: s.title, chars: s.text.length })),
+    };
+}
+/** 从 `p` / `lib` 参数里定位"哪个库 + 库内相对路径"。`p` 形如 `<库id>/<rel>` 或 `<rel>`。 */
+function pickLibrary(r, p, libParam) {
+    const norm = p.replaceAll('\\', '/');
+    if (libParam !== '') {
+        const lib = r.workspace.libraries.find((l) => l.manifest.id === libParam);
+        if (lib === undefined)
+            return null;
+        const prefix = `${libParam}/`;
+        return { lib, rel: norm.startsWith(prefix) ? norm.slice(prefix.length) : norm };
+    }
+    for (const lib of r.workspace.libraries) {
+        const prefix = `${lib.manifest.id}/`;
+        if (norm.startsWith(prefix))
+            return { lib, rel: norm.slice(prefix.length) };
+    }
+    const first = r.workspace.libraries[0];
+    return first === undefined ? null : { lib: first, rel: norm };
+}
+async function handle(req, res) {
+    const url = new URL(req.url ?? '/', 'http://localhost');
+    const parts = url.pathname.split('/').filter(Boolean);
+    const seg = parts[1] ?? '';
+    const cwd = hintCwd(url);
+    try {
+        if (seg === 'health') {
+            const r = resolveFor(cwd);
+            sendJson(res, 200, { ok: true, kit: 'study', root: r?.workspace.root ?? null, legacy: r?.workspace.legacy ?? null, viewer: r?.viewer ?? null, libraries: r?.workspace.libraries.length ?? 0 });
+            return;
+        }
+        if (seg === 'libraries') {
+            const r = resolveFor(cwd);
+            if (r === null) {
+                sendJson(res, 200, { ok: false, root: '', libraries: [], error: '未找到知识库：放一份 libraries.yaml 或 library.yaml，或设置 AERO_WORKSPACE。' });
+                return;
+            }
+            sendJson(res, 200, {
+                ok: true,
+                root: r.workspace.root,
+                legacy: r.workspace.legacy,
+                viewer: r.viewer,
+                libraries: r.workspace.libraries.map((l) => ({
+                    id: l.manifest.id,
+                    title: l.manifest.title,
+                    kind: l.manifest.kind,
+                    visibility: l.manifest.visibility,
+                    root: l.root,
+                    groups: l.manifest.groups.length,
+                    ...(l.manifest.outline !== undefined ? { outline: l.manifest.outline } : {}),
+                })),
+            });
+            return;
+        }
+        if (seg === 'catalog') {
+            const r = resolveFor(cwd, url.searchParams.get('refresh') === '1');
+            if (r === null) {
+                sendJson(res, 200, { root: '', generatedAt: 0, groups: [], error: '未找到知识库：放一份 libraries.yaml 或 library.yaml，或设置 AERO_WORKSPACE。' });
+                return;
+            }
+            const body = buildCatalogForClient(r.workspace, r.viewer);
+            sendJson(res, 200, body);
+            return;
+        }
+        if (seg === 'doc') {
+            const relIn = url.searchParams.get('p') ?? '';
+            const rootParam = url.searchParams.get('lib') ?? '';
+            const r = resolveFor(cwd);
+            if (r === null || relIn === '') {
+                sendJson(res, 400, { ok: false, kind: 'md', title: '', html: '', sections: [], error: '缺少 p 参数或未配置知识库' });
+                return;
+            }
+            const picked = pickLibrary(r, relIn, rootParam);
+            if (picked === null) {
+                sendJson(res, 404, { ok: false, kind: 'md', title: relIn, html: '', sections: [], error: `未知库：${rootParam}` });
+                return;
+            }
+            const lib = picked.lib;
+            const rel = picked.rel;
+            const abs = safeAbs(lib.root, rel);
+            const text = readKbText(lib.root, rel, 8 * 1024 * 1024);
+            if (text === null) {
+                sendJson(res, 404, { ok: false, kind: 'md', title: rel, html: '', sections: [], error: '文件不存在或过大' });
+                return;
+            }
+            const kind = rel.toLowerCase().endsWith('.adoc') ? 'adoc' : 'md';
+            const out = await renderDoc(text, kind, { kbRoot: lib.root, srcDir: path.dirname(abs), relPath: rel }, url.searchParams.get('seg'));
+            sendJson(res, out.ok ? 200 : 500, out);
+            return;
+        }
+        if (seg === 'slides') {
+            const relIn = url.searchParams.get('p') ?? '';
+            const rootParam = url.searchParams.get('lib') ?? '';
+            const r = resolveFor(cwd);
+            const picked = r === null || relIn === '' ? null : pickLibrary(r, relIn, rootParam);
+            if (picked === null) {
+                sendJson(res, 400, { ok: false, title: '', slides: [], error: '缺少 p 参数或未配置知识库' });
+                return;
+            }
+            const lib = picked.lib;
+            const rel = picked.rel;
+            const abs = safeAbs(lib.root, rel);
+            const text = readKbText(lib.root, rel, 8 * 1024 * 1024);
+            if (text === null) {
+                sendJson(res, 404, { ok: false, title: rel, slides: [], error: 'slides.md 不存在或过大' });
+                return;
+            }
+            const result = renderSlidesMd(text, { kbRoot: lib.root, srcDir: path.dirname(abs), relPath: rel });
+            sendJson(res, result.ok ? 200 : 500, result);
+            return;
+        }
+        if (seg === 'asset') {
+            // 渲染期已把图片地址写成 `?p=<库根相对路径>&root=<库根绝对路径>`，这里按 root 取库根。
+            const rootParam = url.searchParams.get('root') ?? '';
+            const rel = url.searchParams.get('p') ?? '';
+            if (rootParam === '' || rel === '' || !existsSync(rootParam)) {
+                sendText(res, 400, 'missing p/root');
+                return;
+            }
+            const abs = safeAbs(rootParam, rel);
+            const ext = path.extname(abs).toLowerCase();
+            const ct = CONTENT_TYPES[ext];
+            if (ct === undefined || (!ct.startsWith('image') && !ct.startsWith('video') && !ct.startsWith('font'))) {
+                sendText(res, 403, 'forbidden asset type');
+                return;
+            }
+            if (statSync(abs).size > 64 * 1024 * 1024) {
+                sendText(res, 403, 'asset too large');
+                return;
+            }
+            res.setHeader('Cache-Control', 'no-store');
+            sendFile(req, res, abs, ct);
+            return;
+        }
+        if (seg === 'katex') {
+            const file = parts.slice(2).join('/');
+            const dist = katexDistDir();
+            const abs = path.resolve(dist, file);
+            if (!abs.startsWith(dist + path.sep) && abs !== dist) {
+                sendText(res, 403, 'forbidden');
+                return;
+            }
+            const ext = path.extname(abs).toLowerCase();
+            res.statusCode = 200;
+            res.setHeader('Content-Type', CONTENT_TYPES[ext] ?? 'application/octet-stream');
+            res.end(readFileSync(abs));
+            return;
+        }
+        if (seg === 'slidev') {
+            const slidevCtx = { resolveKbRoot: (hint) => resolveFor(hint)?.workspace.root ?? null };
+            if ((parts[2] ?? '') === 'env') {
+                await handleSlidevEnv(req, res, slidevCtx);
+                return;
+            }
+            createSlidevHandler(slidevCtx)(req, res);
+            return;
+        }
+        if (seg === 'git') {
+            const r = resolveFor(cwd);
+            if (r !== null)
+                setGitRepos(gitDefsOf(r.workspace.libraries));
+            const handler = createGitHandler({
+                resolveKbRoot: (hint) => resolveFor(hint)?.workspace.root ?? null,
+                pkgDir: PKG_DIR,
+                onPullSuccess: () => invalidate(),
+            });
+            void handler(req, res);
+            return;
+        }
+        sendText(res, 404, 'not found');
+    }
+    catch (err) {
+        sendJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
+    }
+}
+/** 插件包目录（`slidev` 构建缓存、`ext/adoc-convert` 定位都基于它）。 */
+export const PKG_DIR = path.resolve(path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')), '..');
+export function apply(ctx) {
+    const handler = (req, res) => {
+        void handle(req, res);
+    };
+    // 正式前缀 `/kb`；`/aero-kb` 作为别名保留一个 minor 周期（老客户端/老技能仍可用）。
+    ctx.webServer.register({ kind: 'prefix', path: '/kb', handler });
+    ctx.webServer.register({ kind: 'prefix', path: '/aero-kb', handler });
+    ctx.effect(() => () => disposeSlidev(), 'aero-study-kit.slidev.dispose()');
+    // 随包技能：装完即用，不依赖 .dsh/skills 的符号链接（ADR-002 / P5）
+    ctx.effect(() => {
+        const registered = registerBundledSkills(ctx, path.join(PKG_DIR, 'skills'));
+        return () => registered.dispose();
+    }, 'aero-study-kit.skills()');
+    let stopping = false;
+    const cleanups = new Map();
+    ctx.effect(() => {
+        const stopCreated = ctx.on('agent/created', ({ agent }) => {
+            if (stopping || cleanups.has(agent) || !ctx.agents.roots().includes(agent))
+                return;
+            const cleanup = agent.ctx.effect(() => registerKbTools(ctx, agent), 'aero-study-kit.tools()');
+            cleanups.set(agent, cleanup);
+        });
+        return async () => {
+            stopping = true;
+            stopCreated();
+            for (const c of [...cleanups.values()]) {
+                try {
+                    c();
+                }
+                catch {
+                    /* 忽略清理异常 */
+                }
+            }
+            cleanups.clear();
+        };
+    }, 'aero-study-kit.lifecycle()');
+}
+/** 供测试/调试：把目录树摊平成路径（不导出到客户端契约里）。 */
+export function flattenCatalogPaths(nodes) {
+    const out = [];
+    for (const n of nodes) {
+        if (n.type === 'group')
+            out.push(...flattenCatalogPaths(n.children ?? []));
+        else
+            out.push(n.path);
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map