@dongfangw/study-kit 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# @dongfangw/study-kit · AI 学伴
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+把任意"带清单的内容库"变成一个可读、可搜、可标注、可问的学习台。可同时挂多个库：
+自己的课程、自学的另一门课、私人笔记，互不干扰。
+
+> **你的阅读位置、标注、提问和 AI 对话都只存在这台电脑上。** 没有账号、没有云同步、没有遥测。
+
+## 安装（计划）
+
+```bash
+dsh plugin install @dongfangw/study-kit
+```
+
+## 能力
+
+- 书籍版式读 adoc / md，公式走 KaTeX；超长文档自动分段
+- 荧光笔 / 重点线 / 便签提问（标注只落本机）
+- 阅读位置记住（按文档、按段）
+- 「我的库」：加库向导、库隔离（`visibility: private` 三出口全隐）、每库 Git 状态
+- 4 个工具：`kb_libraries` / `kb_catalog` / `kb_read` / `kb_search`
+- 5 个技能：学习导航、学习路径、概念答疑、物理直觉、建库向导
+
+## 状态
+
+施工中（阶段 2）。本仓从 `student-pack` 的阅读器部分拆出并去课程化。
+
+## 许可
+
+MIT。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: aero-study-kit
+      name: '@dongfangw/study-kit'

package/ext/adoc-convert/index.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * AsciiDoc → HTML 转换的**隔离执行器**（供 src/render.ts 以子进程方式调用）。
+ *
+ * 为什么必须隔离（血泪教训，勿改回进程内 require）：
+ *   `@asciidoctor/core` 内含 Opal（Ruby 的 JS 实现）运行时，加载后会把内建原型链改写掉
+ *   （实测：`Object.getPrototypeOf(Array.prototype) !== Object.prototype`）。而 DSH 宿主用
+ *   `@deepseek-ai/dsh-util-values` 的「无损 JSON」校验（snapshotJsonValue/isJsonValue）来把关
+ *   会话事件落盘，该校验会逐层核对内建原型（hasPlainArrayPrototype/hasIntrinsicObjectPrototype）。
+ *   原型链一旦被 Opal 改写，**宿主进程里所有数组都不再算合法 JSON**：
+ *     · 任何 prompt 都无法写入会话日志 → 上层把错误包装成 session/agent-busy "prompt rejected"
+ *       → 学生端看到的就是「提问报错 agent busy」；
+ *     · 新会话的 api-session/added 事件也无法转发 → 新建会话失败。
+ *   触发时机：学生首次打开任意 `.adoc` 教案（本插件的渲染库是惰性加载的）之后，进程即"中毒"。
+ *
+ *   注意：事后恢复原型链（Object.setPrototypeOf 回退）虽然能让 DSH 校验恢复正常，但会让
+ *   Opal 自身的后续调用崩溃（Ruby 方法沿被改写后的原型链查找）。所以唯一稳妥的做法是
+ *   把整个 asciidoctor 运行时挡在宿主进程之外——本文件的子进程就是这层隔离。
+ *
+ * 协议：stdin 收 JSON `{ text, options }`，stdout 回 JSON `{ ok: true, html }` 或
+ *      `{ ok: false, error }`；退出码 0/1 仅作辅助，调用方以 JSON 为准。
+ */
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+function readStdin() {
+    try {
+        return readFileSync(0, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+
+function main() {
+    // 容忍 UTF-8 BOM（手工用 `< file` / Get-Content 喂请求时会带上）。
+    const raw = readStdin().replace(/^\uFEFF/u, '');
+    if (raw.trim() === '')
+        return { ok: false, error: 'asciidoctor 隔离执行器：stdin 为空' };
+    let request;
+    try {
+        request = JSON.parse(raw);
+    }
+    catch (error) {
+        return { ok: false, error: `请求不是合法 JSON：${error instanceof Error ? error.message : String(error)}` };
+    }
+    try {
+        const factory = require('@asciidoctor/core');
+        const api = factory();
+        const doc = api.load(String(request.text ?? ''), request.options ?? {});
+        return { ok: true, html: String(doc.convert()) };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+
+const result = main();
+process.stdout.write(JSON.stringify(result));
+process.exitCode = result.ok ? 0 : 1;