@dongfangw/study-kit 0.0.0-stage → 0.1.1

package/lib/session.js

@@ -0,0 +1,35 @@
+import { resolveWorkspace } from "./libraries.js";
+const TTL_MS = 30_000;
+const cache = new Map();
+/** 当前身份：教师 profile 还是学生。旧环境变量 `AERO_TEACHER_MODE` 继续认（兼容期）。 */
+export function currentViewer() {
+    const explicit = (process.env.AERO_VIEWER ?? '').trim().toLowerCase();
+    if (explicit === 'teacher' || explicit === 'student')
+        return explicit;
+    const legacy = (process.env.AERO_TEACHER_MODE ?? '').trim().toLowerCase();
+    return legacy === '1' || legacy === 'true' || legacy === 'yes' ? 'teacher' : 'student';
+}
+/** 取（或重算）某会话 cwd 的解析结果。解析不到返回 null。 */
+export function resolveFor(cwd, force = false) {
+    const key = cwd === null || cwd === undefined || cwd === '' ? '<process>' : cwd;
+    const cached = cache.get(key);
+    if (!force && cached !== undefined && Date.now() - cached.at < TTL_MS)
+        return cached;
+    const workspace = resolveWorkspace(cwd);
+    if (workspace === null) {
+        cache.delete(key);
+        return null;
+    }
+    const resolved = { cwd: key, viewer: currentViewer(), workspace, at: Date.now() };
+    cache.set(key, resolved);
+    return resolved;
+}
+/** 只读缓存（工具里用；不触发解析）。 */
+export function lookResolved(cwd) {
+    return resolveFor(cwd, false);
+}
+/** 强制清空（`libraries.yaml` 被改动、或 pull 成功后调用）。 */
+export function invalidate() {
+    cache.clear();
+}
+//# sourceMappingURL=session.js.map

package/lib/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,gBAAgB,CAAA;AASzE,MAAM,MAAM,GAAG,MAAM,CAAA;AACrB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;AAEzC,+DAA+D;AAC/D,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACrE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAkB,CAAA;IAC/E,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACzE,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;AACxF,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,UAAU,CAAC,GAA8B,EAAE,KAAK,GAAG,KAAK;IACtE,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAA;IAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;QAAE,OAAO,MAAM,CAAA;IACpF,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IACvC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;IAC3F,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACxB,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,YAAY,CAAC,GAA8B;IACzD,OAAO,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAA;AACf,CAAC"}

package/lib/skills.d.ts

@@ -0,0 +1,24 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** 从 SKILL.md 抽 frontmatter（只认 `key: value`，够用且不引 YAML）。 */
+export declare function parseSkillFrontmatter(source: string): {
+    name?: string;
+    description?: string;
+    body: string;
+};
+export interface BundledSkill {
+    name: string;
+    description: string;
+    content: string;
+    file: string;
+}
+/** 读包内 `skills/` 目录。 */
+export declare function loadBundledSkills(skillsDir: string): BundledSkill[];
+/**
+ * 注册技能。返回已注册的名字数组（供冒烟与日志用）。
+ * 注意：调用方应把它放进 `ctx.effect()`，返回的 disposer 负责注销。
+ */
+export declare function registerBundledSkills(ctx: Context, skillsDir: string): {
+    names: string[];
+    dispose: () => void;
+};
+//# sourceMappingURL=skills.d.ts.map

package/lib/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAc3G;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAwB;AACxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAkBnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA6C/G"}

package/lib/skills.js

@@ -0,0 +1,111 @@
+/**
+ * 运行时技能注册：把包内 `skills/<name>/SKILL.md` 注册进 DSH 的技能注册表。
+ *
+ * 为什么不靠 `.dsh/skills` 的符号链接：
+ * - 链接是**本地状态**，学生 clone 下来没有；随包注册则装完即用；
+ * - Windows 上创建 junction 需要脚本与权限，学校机房常常卡在这一步；
+ * - 优先级 `project(100) > runtime > user(400)`：项目里的同名技能仍可覆盖我们，
+ *   所以"套件自带 + 课程本地改写"能共存（P5 师生共创的机制基础）。
+ *
+ * 失败策略：**best-effort**。`ctx.skills` 不存在（老 profile）或某份技能解析失败时只告警，
+ * 绝不让插件 apply 失败——阅读器比技能重要。
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+/** 从 SKILL.md 抽 frontmatter（只认 `key: value`，够用且不引 YAML）。 */
+export function parseSkillFrontmatter(source) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(source);
+    if (m === null)
+        return { body: source };
+    const out = { body: source.slice((m[0] ?? '').length) };
+    for (const line of (m[1] ?? '').split(/\r?\n/)) {
+        const kv = /^([A-Za-z_][A-Za-z0-9_]*):\s*(.*)$/.exec(line);
+        if (kv === null)
+            continue;
+        const key = kv[1] ?? '';
+        const raw = kv[2] ?? '';
+        const value = raw.replace(/^['"]|['"]$/g, '').trim();
+        if (key === 'name')
+            out.name = value;
+        if (key === 'description')
+            out.description = value;
+    }
+    return out;
+}
+/** 读包内 `skills/` 目录。 */
+export function loadBundledSkills(skillsDir) {
+    if (!existsSync(skillsDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const file = path.join(skillsDir, entry.name, 'SKILL.md');
+        if (!existsSync(file))
+            continue;
+        const fm = parseSkillFrontmatter(readFileSync(file, 'utf8'));
+        const name = fm.name ?? entry.name;
+        if (!/^[a-z0-9][a-z0-9-]*$/.test(name))
+            continue;
+        out.push({
+            name,
+            description: fm.description ?? '',
+            content: fm.body,
+            file,
+        });
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * 注册技能。返回已注册的名字数组（供冒烟与日志用）。
+ * 注意：调用方应把它放进 `ctx.effect()`，返回的 disposer 负责注销。
+ */
+export function registerBundledSkills(ctx, skillsDir) {
+    const skills = loadBundledSkills(skillsDir);
+    const registry = (() => {
+        try {
+            return ctx.get?.('skills');
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    if (registry === undefined || typeof registry.register !== 'function') {
+        console.warn(`[study-kit] 当前 profile 没有 skills 服务，跳过随包技能注册（${skills.length} 个）；阅读器不受影响`);
+        return { names: [], dispose: () => { } };
+    }
+    const disposers = [];
+    const names = [];
+    for (const s of skills) {
+        try {
+            const dispose = registry.register({
+                name: s.name,
+                description: s.description,
+                content: s.content,
+                path: s.file,
+                invocation: { modelInvocable: true, userInvocable: true },
+            });
+            disposers.push(dispose);
+            names.push(s.name);
+        }
+        catch (e) {
+            console.warn(`[study-kit] 技能注册失败：${s.name}（${e instanceof Error ? e.message : String(e)}）`);
+        }
+    }
+    if (names.length > 0)
+        console.log(`[study-kit] 已注册随包技能 ${names.length} 个：${names.join(', ')}`);
+    return {
+        names,
+        dispose: () => {
+            for (const d of disposers) {
+                try {
+                    d();
+                }
+                catch {
+                    /* 忽略注销异常 */
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=skills.js.map

package/lib/skills.js.map

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

package/lib/slidev.d.ts

@@ -0,0 +1,13 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface SlidevHandlerOptions {
+    resolveKbRoot: (hint: string | undefined) => string | null;
+}
+/**
+ * /aero-kb/slidev 路由：
+ *  - GET /aero-kb/slidev/meta?p=<rel>&cwd=…&rebuild=1  → 状态/触发构建
+ *  - GET /aero-kb/slidev/<key>/<file…>                  → 构建产物静态托管
+ */
+export declare function createSlidevHandler(opts: SlidevHandlerOptions): (req: IncomingMessage, res: ServerResponse) => void;
+/** 插件卸载时终止所有构建子进程。 */
+export declare function disposeSlidev(): void;
+//# sourceMappingURL=slidev.d.ts.map

package/lib/slidev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slidev.d.ts","sourceRoot":"","sources":["../src/slidev.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAgpBhE,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,CAAA;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAInH;AAiFD,sBAAsB;AACtB,wBAAgB,aAAa,IAAI,IAAI,CAapC"}