dsh-learning-quirky-stuff 4.3.1 → 4.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ARCHITECTURE.md +29 -2
- package/README.md +72 -4
- package/THIRD_PARTY_NOTICES.md +5 -0
- package/capture-server.js +4 -0
- package/client.js +2299 -1242
- package/codex-provider.js +3 -4
- package/core.js +3 -0
- package/docs/dependency-security.md +1 -1
- package/docs/install.md +5 -5
- package/docs/privacy.md +9 -1
- package/docs/user-guide.html +106 -23
- package/docs/validation.md +28 -0
- package/graph-data.js +2 -0
- package/learning.js +79 -14
- package/licenses/packages/pdfjs-dist@6.5.438.txt +181 -0
- package/model.js +1 -1
- package/package.json +11 -6
- package/pdf-assets/LICENSE +177 -0
- package/pdf-assets/cmaps/78-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/78-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/78-H.bcmap +0 -0
- package/pdf-assets/cmaps/78-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/78-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/78-V.bcmap +0 -0
- package/pdf-assets/cmaps/78ms-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/78ms-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/83pv-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/90ms-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/90ms-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/90msp-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/90msp-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/90pv-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/90pv-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/Add-H.bcmap +0 -0
- package/pdf-assets/cmaps/Add-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/Add-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/Add-V.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-0.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-1.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-3.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-4.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-5.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-6.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-CNS1-UCS2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-0.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-1.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-3.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-4.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-5.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-GB1-UCS2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-0.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-1.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-3.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-4.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-5.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-6.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Japan1-UCS2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Korea1-0.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Korea1-1.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Korea1-2.bcmap +0 -0
- package/pdf-assets/cmaps/Adobe-Korea1-UCS2.bcmap +0 -0
- package/pdf-assets/cmaps/B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/B5pc-H.bcmap +0 -0
- package/pdf-assets/cmaps/B5pc-V.bcmap +0 -0
- package/pdf-assets/cmaps/CNS-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/CNS-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/CNS1-H.bcmap +0 -0
- package/pdf-assets/cmaps/CNS1-V.bcmap +0 -0
- package/pdf-assets/cmaps/CNS2-H.bcmap +0 -0
- package/pdf-assets/cmaps/CNS2-V.bcmap +3 -0
- package/pdf-assets/cmaps/ETHK-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/ETHK-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/ETen-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/ETen-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/ETenms-B5-H.bcmap +3 -0
- package/pdf-assets/cmaps/ETenms-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/Ext-H.bcmap +0 -0
- package/pdf-assets/cmaps/Ext-RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/Ext-RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/Ext-V.bcmap +0 -0
- package/pdf-assets/cmaps/GB-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/GB-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/GB-H.bcmap +4 -0
- package/pdf-assets/cmaps/GB-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBK-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBK-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBK2K-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBK2K-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBKp-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBKp-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBT-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBT-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBT-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBT-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBTpc-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBTpc-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/GBpc-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/GBpc-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/H.bcmap +0 -0
- package/pdf-assets/cmaps/HKdla-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/HKdla-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/HKdlb-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/HKdlb-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/HKgccs-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/HKgccs-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/HKm314-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/HKm314-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/HKm471-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/HKm471-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/HKscs-B5-H.bcmap +0 -0
- package/pdf-assets/cmaps/HKscs-B5-V.bcmap +0 -0
- package/pdf-assets/cmaps/Hankaku.bcmap +0 -0
- package/pdf-assets/cmaps/Hiragana.bcmap +0 -0
- package/pdf-assets/cmaps/KSC-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/KSC-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/KSC-H.bcmap +0 -0
- package/pdf-assets/cmaps/KSC-Johab-H.bcmap +0 -0
- package/pdf-assets/cmaps/KSC-Johab-V.bcmap +0 -0
- package/pdf-assets/cmaps/KSC-V.bcmap +0 -0
- package/pdf-assets/cmaps/KSCms-UHC-H.bcmap +0 -0
- package/pdf-assets/cmaps/KSCms-UHC-HW-H.bcmap +0 -0
- package/pdf-assets/cmaps/KSCms-UHC-HW-V.bcmap +0 -0
- package/pdf-assets/cmaps/KSCms-UHC-V.bcmap +0 -0
- package/pdf-assets/cmaps/KSCpc-EUC-H.bcmap +0 -0
- package/pdf-assets/cmaps/KSCpc-EUC-V.bcmap +0 -0
- package/pdf-assets/cmaps/Katakana.bcmap +0 -0
- package/pdf-assets/cmaps/LICENSE +36 -0
- package/pdf-assets/cmaps/NWP-H.bcmap +0 -0
- package/pdf-assets/cmaps/NWP-V.bcmap +0 -0
- package/pdf-assets/cmaps/RKSJ-H.bcmap +0 -0
- package/pdf-assets/cmaps/RKSJ-V.bcmap +0 -0
- package/pdf-assets/cmaps/Roman.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UCS2-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UCS2-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UTF16-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UTF16-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UTF8-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniCNS-UTF8-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UCS2-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UCS2-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UTF16-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UTF16-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UTF8-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniGB-UTF8-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UCS2-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UCS2-HW-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UCS2-HW-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UCS2-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UTF16-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UTF16-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UTF8-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS-UTF8-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS2004-UTF16-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS2004-UTF16-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS2004-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS2004-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS2004-UTF8-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJIS2004-UTF8-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISPro-UCS2-HW-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISPro-UCS2-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISPro-UTF8-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISX0213-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISX0213-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISX02132004-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniJISX02132004-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UCS2-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UCS2-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UTF16-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UTF16-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UTF32-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UTF32-V.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UTF8-H.bcmap +0 -0
- package/pdf-assets/cmaps/UniKS-UTF8-V.bcmap +0 -0
- package/pdf-assets/cmaps/V.bcmap +0 -0
- package/pdf-assets/cmaps/WP-Symbol.bcmap +0 -0
- package/pdf-assets/iccs/CGATS001Compat-v2-micro.icc +0 -0
- package/pdf-assets/iccs/LICENSE +116 -0
- package/pdf-assets/pdf.worker.min.mjs +27 -0
- package/pdf-assets/standard_fonts/FoxitDingbats.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitFixed.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitFixedBold.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitFixedBoldItalic.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitFixedItalic.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitSerif.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitSerifBold.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitSerifBoldItalic.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitSerifItalic.pfb +0 -0
- package/pdf-assets/standard_fonts/FoxitSymbol.pfb +0 -0
- package/pdf-assets/standard_fonts/LICENSE_FOXIT +27 -0
- package/pdf-assets/standard_fonts/LICENSE_LIBERATION +363 -0
- package/pdf-assets/standard_fonts/LiberationSans-Bold.ttf +0 -0
- package/pdf-assets/standard_fonts/LiberationSans-BoldItalic.ttf +0 -0
- package/pdf-assets/standard_fonts/LiberationSans-Italic.ttf +0 -0
- package/pdf-assets/standard_fonts/LiberationSans-Regular.ttf +0 -0
- package/pdf-assets/wasm/LICENSE_JBIG2 +196 -0
- package/pdf-assets/wasm/LICENSE_OPENJPEG +39 -0
- package/pdf-assets/wasm/LICENSE_PDFJS_JBIG2 +13 -0
- package/pdf-assets/wasm/LICENSE_PDFJS_OPENJPEG +22 -0
- package/pdf-assets/wasm/LICENSE_PDFJS_QCMS +19 -0
- package/pdf-assets/wasm/LICENSE_PDFJS_QUICKJS +21 -0
- package/pdf-assets/wasm/LICENSE_QCMS +21 -0
- package/pdf-assets/wasm/LICENSE_QUICKJS +22 -0
- package/pdf-assets/wasm/jbig2.wasm +0 -0
- package/pdf-assets/wasm/jbig2_nowasm_fallback.js +2 -0
- package/pdf-assets/wasm/openjpeg.wasm +0 -0
- package/pdf-assets/wasm/openjpeg_nowasm_fallback.js +2 -0
- package/pdf-assets/wasm/qcms_bg.wasm +0 -0
- package/pdf-assets/wasm/quickjs-eval.js +16 -0
- package/pdf-assets/wasm/quickjs-eval.wasm +0 -0
- package/server/infographic-sources.js +3 -0
- package/server/modules/canvas-comments.js +270 -0
- package/server/modules/pdf.js +606 -0
- package/server/runtime.js +25 -4
- package/server/service-actions.js +9 -1
- package/server/sources.js +26 -9
- package/server/summary/prompts.js +40 -0
- package/server/task-manager.js +2 -2
- package/shared/canvas-comments.js +59 -0
- package/shared/canvas-quotes.js +50 -0
- package/shared/features.js +14 -0
- package/shared/infographics.js +5 -5
- package/shared/pdf.js +75 -0
- package/shared/version.js +1 -1
- package/summary-prompt.js +12 -36
- package/summary-sources.js +13 -1
package/codex-provider.js
CHANGED
|
@@ -46,8 +46,7 @@ export function codexArgs(
|
|
|
46
46
|
'--json',
|
|
47
47
|
'--cd',
|
|
48
48
|
dir,
|
|
49
|
-
'--output-schema',
|
|
50
|
-
schemaFile,
|
|
49
|
+
...(schemaFile ? ['--output-schema', schemaFile] : []),
|
|
51
50
|
'--output-last-message',
|
|
52
51
|
outputFile,
|
|
53
52
|
'-c',
|
|
@@ -105,10 +104,10 @@ export async function runCodex({
|
|
|
105
104
|
onMetadata({ model, reasoningEffort: reasoningEffort || 'default' });
|
|
106
105
|
const dir = await mkdtemp(join(tmpdir(), 'studyboard-codex-'));
|
|
107
106
|
try {
|
|
108
|
-
const schemaFile = join(dir, 'schema.json'),
|
|
107
|
+
const schemaFile = schema == null ? null : join(dir, 'schema.json'),
|
|
109
108
|
outputFile = join(dir, 'result.json'),
|
|
110
109
|
imagePaths = [];
|
|
111
|
-
await writeFile(schemaFile, JSON.stringify(schema), { mode: 0o600 });
|
|
110
|
+
if (schemaFile) await writeFile(schemaFile, JSON.stringify(schema), { mode: 0o600 });
|
|
112
111
|
for (let i = 0; i < images.length; i++) {
|
|
113
112
|
const p = join(dir, `board-${i}.${images[i].mimeType === 'image/png' ? 'png' : 'jpg'}`);
|
|
114
113
|
await writeFile(p, Buffer.from(images[i].data, 'base64'), { mode: 0o600 });
|
package/core.js
CHANGED
|
@@ -130,7 +130,10 @@ export class LibraryStore {
|
|
|
130
130
|
webImageCount: (webImages || []).filter((i) => !i.deletedAt).length,
|
|
131
131
|
summaryCount: active.length,
|
|
132
132
|
summaryText: active.at(-1)?.text?.slice(0, 300) || '',
|
|
133
|
+
pdfCount: b.pdfDocuments?.length || 0,
|
|
133
134
|
textIndex: (
|
|
135
|
+
(b.pdfDocuments || []).map((document) => document.title).join(' ') +
|
|
136
|
+
' ' +
|
|
134
137
|
(b.webNotes?.text || '') +
|
|
135
138
|
' ' +
|
|
136
139
|
scene.elements
|
package/docs/install.md
CHANGED
|
@@ -9,10 +9,10 @@
|
|
|
9
9
|
命令行版可在独立的 `studyboard` profile 安装:
|
|
10
10
|
|
|
11
11
|
```sh
|
|
12
|
-
dsh plugin --profile studyboard add ./dsh-learning-quirky-stuff-4.
|
|
12
|
+
dsh plugin --profile studyboard add ./dsh-learning-quirky-stuff-4.6.0.tgz
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
也可通过 DSH
|
|
15
|
+
也可通过 DSH 的添加插件入口选择安装来源。安装后启用学习画板,打开主面板。上例使用 [4.6.0 发布页](https://github.com/EndWithHyphen/dsh-learning-quirky-stuff/releases/tag/v4.6.0) 中的插件包。使用 npm 安装时可查看[已发布版本](https://www.npmjs.com/package/dsh-learning-quirky-stuff?activeTab=versions)。
|
|
16
16
|
|
|
17
17
|
## 从旧本机版本迁移
|
|
18
18
|
|
|
@@ -26,7 +26,7 @@ DSH CLI 示例(仅用于命令行 profile;桌面版请在插件页面移除
|
|
|
26
26
|
|
|
27
27
|
```sh
|
|
28
28
|
dsh plugin --profile studyboard remove @local/dsh-studyboard
|
|
29
|
-
dsh plugin --profile studyboard add ./dsh-learning-quirky-stuff-4.
|
|
29
|
+
dsh plugin --profile studyboard add ./dsh-learning-quirky-stuff-4.6.0.tgz
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
数据目录不在 npm 包或扩展目录内。卸载和升级只更换程序,不主动删除笔记。需要回滚时关闭 DSH,恢复之前保留的程序包和数据目录副本。不要将新版本产生的数据直接覆盖到无法识别它的旧版本上。
|
|
@@ -66,10 +66,10 @@ dsh plugin --profile studyboard add ./dsh-learning-quirky-stuff-4.3.1.tgz
|
|
|
66
66
|
|
|
67
67
|
## 平台与模型
|
|
68
68
|
|
|
69
|
-
macOS 13+ 的 Apple Silicon 和 Intel 发布包包含本机识别程序。Windows/Linux 可使用通用界面、文字和模型功能,但未进行完整平台验收;本机 OCR/PDF
|
|
69
|
+
macOS 13+ 的 Apple Silicon 和 Intel 发布包包含本机识别程序。Windows/Linux 可使用通用界面、文字和模型功能,但未进行完整平台验收;本机 OCR / 材料 URL 的 PDF 提取不可用时会在功能设置中说明。笔记中的 PDF.js 阅读、选文与摘录不依赖 macOS 识别组件。
|
|
70
70
|
|
|
71
71
|
Codex 是可选的外部工具。自行从官方渠道安装并登录后,在模型选择器选择具体模型。插件从 PATH 和常见安装目录查找程序,也可设置 `STUDYBOARD_CODEX_BIN` 指定路径。CLI 版本必须支持 `exec`、结构化输出和隔离用户配置的参数;版本不兼容时保留原笔记并报告错误。
|
|
72
72
|
|
|
73
73
|
## 备份恢复
|
|
74
74
|
|
|
75
|
-
应用内备份导出保留笔记和学习数据;目前没有一键导入完整备份的界面。最直接的完整恢复方式是在 DSH 关闭时恢复你自行保留的数据目录副本,再启动 DSH
|
|
75
|
+
应用内备份导出保留笔记和学习数据;目前没有一键导入完整备份的界面。最直接的完整恢复方式是在 DSH 关闭时恢复你自行保留的数据目录副本,再启动 DSH 检查笔记。只有导出备份时,请先保留原文件,在独立数据目录中完成格式校验与恢复,避免手工覆盖现有文件。包含 PDF 的备份为 ZIP:`backup.json` 的 `modules.pdf.documents[].assetFile` 指向 `pdfs/<文件哈希>.pdf`,恢复时需校验文件哈希并保留笔记关联、批注和页面索引。请同时备份整个数据目录,以便直接恢复。
|
package/docs/privacy.md
CHANGED
|
@@ -27,10 +27,18 @@ DSH 数据目录保存笔记、图片、来源链接、总结、批注、分类
|
|
|
27
27
|
|
|
28
28
|
开启「自适应信息图」后,普通 AI 总结会在同一请求中按材料需要策划配图。单独点击「配图」或「重新生成」会把所选总结主题、关联原图与改图要求交给当前选择的模型;不会因此开启联网检索。仅打开、编辑或下载已有图不会调用模型。
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
PDF 原文件、页面文字索引及每篇笔记的批注保存在本机。PDF.js 及所需字体、CMap、WASM 资源随包提供,阅读、查找和摘录不调用模型。密码仅用于当前阅读会话,不落盘;解密后解析的文字、摘录和批注按普通笔记保存,备份也包含这些内容。
|
|
31
|
+
|
|
32
|
+
在 PDF 选区点击「问 AI」时,所选原文、页码、区域图像、个人备注和这条讨论的近期历史会发送给所选模型;不会自动上传整份 PDF。已索引 PDF 文字和确认后的 OCR 可能作为你主动发起的学习任务来源,按任务的输入预算选择。
|
|
33
|
+
|
|
34
|
+
macOS 图片识别和旧材料导入的 PDF 文本提取在本机完成。Chrome 画布字体随扩展分发;DSH 画布保留 Excalidraw 的字体加载逻辑,使用某些非系统字体时可能请求其字体 CDN(esm.run)。字体请求不包含笔记正文。
|
|
31
35
|
|
|
32
36
|
## 删除与保留
|
|
33
37
|
|
|
38
|
+
画布组件讨论保存在本机模块数据中。点击「问 AI」会向所选模型提供所选组件的文字、区域图像、当前问题以及这条讨论的近期历史;只点击「留下备注」不会调用模型。讨论保留提问时的来源快照,编辑或删除原组件不会自动删除讨论,永久删除所属笔记时一并清理。
|
|
39
|
+
|
|
40
|
+
PDF 原件可以被多篇笔记引用;移除关联保留历史批注供重新关联使用。永久删除笔记时清理该笔记的批注,只有最后一篇引用(包括回收站和历史关联)消失时才清理共用原件。含 PDF 的整库备份是 ZIP,原件只保存一份。
|
|
41
|
+
|
|
34
42
|
移入回收站可以恢复。永久删除会清理对应笔记及插件管理的相关派生数据;浏览器重新连接后同步清理相应草稿和待处理操作。已导出的备份、你自行复制的文件以及模型提供方留存的数据,需要分别管理。
|
|
35
43
|
|
|
36
44
|
卸载程序不主动删除 DSH 数据目录。浏览器扩展卸载可能清除该扩展的本机草稿和设置,请先确认已同步。
|
package/docs/user-guide.html
CHANGED
|
@@ -485,11 +485,57 @@
|
|
|
485
485
|
</p>
|
|
486
486
|
</section>
|
|
487
487
|
|
|
488
|
+
<section class="chapter" id="pdf-reading">
|
|
489
|
+
<h2>03 PDF 阅读与笔记</h2>
|
|
490
|
+
<p>
|
|
491
|
+
在笔记列表点「导入 PDF」建立笔记;也可以打开已有笔记,在顶部「PDF」中导入或关联已有原件。同一 PDF
|
|
492
|
+
可以关联多篇笔记,各自保留批注,并沿用分类、标签、搜索和回收站。
|
|
493
|
+
</p>
|
|
494
|
+
<ol>
|
|
495
|
+
<li>
|
|
496
|
+
<strong>阅读与定位:</strong>左侧查看 PDF、右侧记录画布。点击 PDF 阅读区后,可按 ← / → 或 PageUp
|
|
497
|
+
/ PageDown
|
|
498
|
+
翻页;输入框、批注编辑和右侧画布保留各自的按键行为。也可使用页码、目录或搜索跳转,支持缩放和旋转。全文搜索会逐页解析文字,可随时停止。
|
|
499
|
+
</li>
|
|
500
|
+
<li>
|
|
501
|
+
<strong>划线与备注:</strong>选择原文后点「划线 /
|
|
502
|
+
批注」保存;「笔迹」用于圈画。批注列表中可定位、编辑、删除或撤销。输入中的备注和失败的保存操作都有本机草稿。
|
|
503
|
+
</li>
|
|
504
|
+
<li>
|
|
505
|
+
<strong>摘录到画布:</strong>文字用「摘录文字」,公式或图表用「框选 →
|
|
506
|
+
截取到画布」。摘录自动避让已有内容,保留文件、页码和原始选区。选中摘录后点「回到 PDF」核对原文。
|
|
507
|
+
</li>
|
|
508
|
+
<li>
|
|
509
|
+
<strong>提问:</strong>选中原文或框选区域后点「提问」,也可对右侧摘录使用「提问 / 备注」。问题与
|
|
510
|
+
AI 回答复用已有讨论,来源与个人备注分别保存。
|
|
511
|
+
</li>
|
|
512
|
+
<li>
|
|
513
|
+
<strong>扫描页:</strong>macOS
|
|
514
|
+
可点「识别当前页」,或对框选区域「识别文字」。核对并编辑识别结果,保存后可再摘录。公式与复杂表格建议保留截图。
|
|
515
|
+
</li>
|
|
516
|
+
<li>
|
|
517
|
+
<strong>整理与复习:</strong>把本次要研究的片段摘录到画布,再使用 AI 总结、系统学习和复习。AI
|
|
518
|
+
总结按画布输入范围工作。已阅读或搜索解析的页,以及核对后的识别文字,可供全内容搜索与学习来源检索使用。
|
|
519
|
+
</li>
|
|
520
|
+
</ol>
|
|
521
|
+
<p>
|
|
522
|
+
密码仅用于当前阅读会话,重新打开时需再输入。解析文字与批注作为普通笔记保存在本机。PDF 最大 128
|
|
523
|
+
MB;阅读资源随插件提供。第一版入口在 DSH,Chrome 的 PDF 入口后续接入。
|
|
524
|
+
</p>
|
|
525
|
+
<p>
|
|
526
|
+
「移除关联」保留历史批注,重新关联可恢复。永久删除最后一篇引用后才清理共用原件。顶部「导出笔记
|
|
527
|
+
PDF」导出右侧画布;保留完整阅读批注和原件请用左侧「下载备份」。
|
|
528
|
+
</p>
|
|
529
|
+
</section>
|
|
530
|
+
|
|
488
531
|
<section class="chapter" id="canvas">
|
|
489
|
-
<h2>
|
|
532
|
+
<h2>04 白板书写与贴图</h2>
|
|
490
533
|
<ol>
|
|
491
534
|
<li>点「新建笔记」,进入白板。点标题或「整理笔记」可改名。</li>
|
|
492
|
-
<li
|
|
535
|
+
<li>
|
|
536
|
+
画布打开时默认使用选择工具,点击文字或图片不会留下笔迹。选择画笔
|
|
537
|
+
<kbd>P</kbd>,用数位板或鼠标书写;文字工具 <kbd>T</kbd> 用于键入内容。
|
|
538
|
+
</li>
|
|
493
539
|
<li>复制图片后在画布中按 <kbd>⌘ V</kbd>,或使用图片工具 <kbd>9</kbd> 从本机选择文件。</li>
|
|
494
540
|
<li>切回选择工具 <kbd>V</kbd>,选中元素后移动、缩放或删除。按住空格拖动可以临时平移画布。</li>
|
|
495
541
|
<li>离开前查看保存状态。DSH 显示「已保存」,Chrome 显示已同步时,内容已经写入 DSH。</li>
|
|
@@ -537,10 +583,36 @@
|
|
|
537
583
|
<kbd>⌥ ⇧ M</kbd>。填写后保存,说明文字会排在图片附近。
|
|
538
584
|
</p>
|
|
539
585
|
<p>再次选中图片,进入同一入口可以修改备注;清空备注再保存可以移除。图片备注会参与笔记总结。</p>
|
|
586
|
+
<h3>选中组件提问与备注</h3>
|
|
587
|
+
<ol>
|
|
588
|
+
<li>用选择工具选中文字、图片、笔迹,或框选一组组件,再点画布上方「提问 / 备注」。</li>
|
|
589
|
+
<li>
|
|
590
|
+
输入问题,选择模型后点「问
|
|
591
|
+
AI」。所选区域的文字与图像会交给该模型;后续追问保存在同一条讨论中。AI 回答支持 Markdown
|
|
592
|
+
格式;失败后点「重新提问」,成功时会更新显示并收起旧失败提示。
|
|
593
|
+
</li>
|
|
594
|
+
<li>
|
|
595
|
+
只想记录自己的想法时点「留下备注」。输入草稿保存在本机,关闭面板后可从「备注」列表继续;列表中的「删除草稿」可清理未发送内容,删除后提供撤销入口。
|
|
596
|
+
</li>
|
|
597
|
+
<li>
|
|
598
|
+
组件旁的编号是讨论入口,会随组件移动。点「定位」返回关联内容;处理完可以「标记已解决」,在备注列表勾选「显示已解决」后可重新打开。
|
|
599
|
+
</li>
|
|
600
|
+
</ol>
|
|
601
|
+
<p>
|
|
602
|
+
已有回答保留提问时的来源。修改或删除组件后会提示来源变化;移动位置不影响关联。问 AI
|
|
603
|
+
会先保存画布,保存失败时保留输入并提示重试。功能开关与模型偏好位于「功能设置」。
|
|
604
|
+
</p>
|
|
605
|
+
<p>
|
|
606
|
+
讨论独立保存在笔记数据中,包含在「下载备份」里;画布图片、PDF 和 Excalidraw 文件导出的是画布内容。
|
|
607
|
+
</p>
|
|
608
|
+
<h3>长文字自动换行</h3>
|
|
609
|
+
<p>
|
|
610
|
+
新输入或粘贴的普通长文字会限制到适合阅读的宽度。内容较少的旧画布打开时也会整理过长的自由文字。已有长文字可选中后点「整理长文字」;未选择时处理画布中的普通长文字。可以撤销整理,或拖动文本框侧边调整宽度。
|
|
611
|
+
</p>
|
|
540
612
|
</section>
|
|
541
613
|
|
|
542
614
|
<section class="chapter" id="chrome">
|
|
543
|
-
<h2>
|
|
615
|
+
<h2>05 在 Chrome 边看边记</h2>
|
|
544
616
|
<p>
|
|
545
617
|
首次使用配套扩展时,在扩展设置点击「连接本机
|
|
546
618
|
DSH」,再到本应用的「浏览器快捷笔记」允许连接。之后自动连接,无需输入连接码。连接可以在该页面随时撤销。
|
|
@@ -551,7 +623,8 @@
|
|
|
551
623
|
保持 DSH 已打开,并启用学习画板。在文章或视频网页按 <kbd>⌘ ⇧ Y</kbd>,也可以点击扩展图标。
|
|
552
624
|
</li>
|
|
553
625
|
<li>
|
|
554
|
-
|
|
626
|
+
扩展会为当前标签页打开笔记,并保留网页链接。再次打开同一
|
|
627
|
+
URL(包括新标签页)时,优先复用已有笔记;有多篇时选择最近更新且未删除的一篇,找不到时才新建。当前标签页已有绑定时继续使用该绑定。侧栏的展开范围也按标签页管理:只在你主动打开过的标签页显示,切到其他标签页隐藏,返回时恢复。
|
|
555
628
|
</li>
|
|
556
629
|
<li>
|
|
557
630
|
在「手写画布」「随手记」「材料预览」之间切换。不同标签页各用一篇笔记,即使打开的是相同网址。
|
|
@@ -592,7 +665,7 @@
|
|
|
592
665
|
</section>
|
|
593
666
|
|
|
594
667
|
<section class="chapter" id="widgets">
|
|
595
|
-
<h2>
|
|
668
|
+
<h2>06 用学习控件结构化表达</h2>
|
|
596
669
|
<p>
|
|
597
670
|
绘图工具栏固定在画布上方,不覆盖内容。把鼠标移到工具按钮上可查看快捷键与操作说明,移开后提示收起。
|
|
598
671
|
</p>
|
|
@@ -619,6 +692,13 @@
|
|
|
619
692
|
<td>提问卡</td>
|
|
620
693
|
<td>分别填写问题和参考答案,把想澄清的疑问排在画布中。</td>
|
|
621
694
|
</tr>
|
|
695
|
+
<tr>
|
|
696
|
+
<td>金句摘录</td>
|
|
697
|
+
<td>
|
|
698
|
+
输入或粘贴原文,也可以先选中画布上的一段文字。出处和背诵提示可选。画布保存后,摘录自动加入左侧「今日复习」。
|
|
699
|
+
在那里先背,再点「显示原文」核对并选择掌握程度。想立即练习整张画布,也可在「学习控件」中点「背诵摘录」。
|
|
700
|
+
</td>
|
|
701
|
+
</tr>
|
|
622
702
|
<tr>
|
|
623
703
|
<td>知识点</td>
|
|
624
704
|
<td>
|
|
@@ -655,12 +735,12 @@
|
|
|
655
735
|
正在运行;可在「功能设置」的「全内容搜索」开关中开启或关闭。确认前不会向画布添加识别文字。
|
|
656
736
|
</p>
|
|
657
737
|
<p class="small">
|
|
658
|
-
|
|
738
|
+
金句摘录按原文进入间隔复习,无需 AI。画布提问卡用于排版记录。
|
|
659
739
|
</p>
|
|
660
740
|
</section>
|
|
661
741
|
|
|
662
742
|
<section class="chapter" id="organization">
|
|
663
|
-
<h2>
|
|
743
|
+
<h2>07 分类 标签与专题的区别</h2>
|
|
664
744
|
<div class="table-wrap">
|
|
665
745
|
<table>
|
|
666
746
|
<thead>
|
|
@@ -733,7 +813,7 @@
|
|
|
733
813
|
</section>
|
|
734
814
|
|
|
735
815
|
<section class="chapter" id="ai-summary">
|
|
736
|
-
<h2>
|
|
816
|
+
<h2>08 总结一篇笔记</h2>
|
|
737
817
|
<ol>
|
|
738
818
|
<li>在 DSH 打开笔记,确认画布已保存,点顶部「AI总结」。</li>
|
|
739
819
|
<li>选择模型。白板总结包含图片输入,需要支持读图的模型;可以选 DSH 已配置的模型或本机 Codex。</li>
|
|
@@ -815,7 +895,7 @@
|
|
|
815
895
|
</section>
|
|
816
896
|
|
|
817
897
|
<section class="chapter" id="annotations">
|
|
818
|
-
<h2>
|
|
898
|
+
<h2>09 划线 备注和原位拓展</h2>
|
|
819
899
|
<h3>给单篇 AI 总结做批注</h3>
|
|
820
900
|
<ol>
|
|
821
901
|
<li>在总结正文中选择一段文字,点击浮出的「划线」。</li>
|
|
@@ -835,7 +915,7 @@
|
|
|
835
915
|
</section>
|
|
836
916
|
|
|
837
917
|
<section class="chapter" id="practice-feedback">
|
|
838
|
-
<h2>
|
|
918
|
+
<h2>10 自测与理解反馈</h2>
|
|
839
919
|
<h3>先自己回答</h3>
|
|
840
920
|
<p>
|
|
841
921
|
打开总结中的自测部分,先读题干、条件和作答任务,在「我的回答」中写下理解,也可以先在心里作答。需要帮助时点「给我一点提示」;准备好后点「揭晓答案」,对照参考答案和核对要点。
|
|
@@ -858,8 +938,9 @@
|
|
|
858
938
|
</section>
|
|
859
939
|
|
|
860
940
|
<section class="chapter" id="review">
|
|
861
|
-
<h2>
|
|
941
|
+
<h2>11 间隔复习</h2>
|
|
862
942
|
<ol>
|
|
943
|
+
<li>画布中的「金句摘录」保存后自动加入。Chrome 画布同步到 DSH 后也会加入。</li>
|
|
863
944
|
<li>
|
|
864
945
|
在单篇总结、专题自测或理解反馈的问题区,点「将这道题加入复习」。单篇总结的自测区还可「全部加入复习」。
|
|
865
946
|
</li>
|
|
@@ -900,7 +981,7 @@
|
|
|
900
981
|
</section>
|
|
901
982
|
|
|
902
983
|
<section class="chapter" id="topics">
|
|
903
|
-
<h2>
|
|
984
|
+
<h2>12 专题工作台</h2>
|
|
904
985
|
<p>几篇笔记都围绕一个问题时,用专题把材料接起来。专题不会搬走原笔记。</p>
|
|
905
986
|
<ol>
|
|
906
987
|
<li>进入「专题工作台」→「新建专题」。</li>
|
|
@@ -925,7 +1006,7 @@
|
|
|
925
1006
|
</section>
|
|
926
1007
|
|
|
927
1008
|
<section class="chapter" id="explore">
|
|
928
|
-
<h2>
|
|
1009
|
+
<h2>13 拓展探索与待学清单</h2>
|
|
929
1010
|
<ol>
|
|
930
1011
|
<li>进入「拓展探索」,填写「想拓展什么」,可补充更想了解的方向。</li>
|
|
931
1012
|
<li>选择资料范围:「联网寻找资料」查找并读取外部来源;「关联我的笔记」从已有内容中寻找联系。</li>
|
|
@@ -947,7 +1028,7 @@
|
|
|
947
1028
|
</section>
|
|
948
1029
|
|
|
949
1030
|
<section class="chapter" id="search">
|
|
950
|
-
<h2>
|
|
1031
|
+
<h2>14 全内容搜索</h2>
|
|
951
1032
|
<ol>
|
|
952
1033
|
<li>进入「全内容搜索」,输入关键词,必要时选择「搜索内容类型」。</li>
|
|
953
1034
|
<li>结果可能来自画布文字、随手记、图注、总结、备注、自测题、材料正文或学习整理结果。</li>
|
|
@@ -969,7 +1050,7 @@
|
|
|
969
1050
|
</section>
|
|
970
1051
|
|
|
971
1052
|
<section class="chapter" id="material-preview">
|
|
972
|
-
<h2>
|
|
1053
|
+
<h2>15 材料预览</h2>
|
|
973
1054
|
<p>准备读一篇新材料时,先了解它解决什么问题,相对已有笔记新增什么,以及哪些位置值得细读。</p>
|
|
974
1055
|
<h3>在 DSH 导入材料</h3>
|
|
975
1056
|
<ol>
|
|
@@ -995,7 +1076,7 @@
|
|
|
995
1076
|
</section>
|
|
996
1077
|
|
|
997
1078
|
<section class="chapter" id="knowledge-graph">
|
|
998
|
-
<h2>
|
|
1079
|
+
<h2>16 知识图谱</h2>
|
|
999
1080
|
<div class="hint">
|
|
1000
1081
|
<strong>图谱表达所选材料的观点,未做独立事实核查。</strong>材料、笔记和 AI
|
|
1001
1082
|
总结可能存在偏差、误读、争议或遗漏;引用出处说明观点从哪里来,不保证观点正确或覆盖完整。
|
|
@@ -1045,7 +1126,7 @@
|
|
|
1045
1126
|
</section>
|
|
1046
1127
|
|
|
1047
1128
|
<section class="chapter" id="weekly-report">
|
|
1048
|
-
<h2>
|
|
1129
|
+
<h2>17 学习周报</h2>
|
|
1049
1130
|
<p>
|
|
1050
1131
|
从左侧「学习周报」进入。选择这一周中的任意一天,查看周一至周日的新建笔记、AI
|
|
1051
1132
|
整理、实际复习次数、卡片数与复习天数;本周尚未结束时会显示「进行中」。统计使用页面显示的时区。
|
|
@@ -1070,10 +1151,11 @@
|
|
|
1070
1151
|
</section>
|
|
1071
1152
|
|
|
1072
1153
|
<section class="chapter" id="settings-models">
|
|
1073
|
-
<h2>
|
|
1154
|
+
<h2>18 功能开关与模型</h2>
|
|
1074
1155
|
<h3>随时开启或关闭学习工具</h3>
|
|
1075
1156
|
<p>
|
|
1076
|
-
|
|
1157
|
+
点左下角「功能设置」,分别控制「PDF
|
|
1158
|
+
阅读与笔记」「学习周报」「系统学习」「专题工作台」「拓展探索」「全内容搜索」「材料预览」「理解反馈」。修改会立即保存。关闭会隐藏入口、停止相关生成或识别任务;保存的数据保留,重新开启后继续使用。Chrome
|
|
1077
1159
|
的材料预览入口也跟随设置更新。
|
|
1078
1160
|
</p>
|
|
1079
1161
|
<h3>选择模型和处理任务</h3>
|
|
@@ -1102,7 +1184,7 @@
|
|
|
1102
1184
|
</section>
|
|
1103
1185
|
|
|
1104
1186
|
<section class="chapter" id="export-backup">
|
|
1105
|
-
<h2>
|
|
1187
|
+
<h2>19 导出 备份与删除</h2>
|
|
1106
1188
|
<h3>导出白板 PDF</h3>
|
|
1107
1189
|
<p>
|
|
1108
1190
|
在 DSH 打开笔记,点「导出
|
|
@@ -1112,7 +1194,8 @@
|
|
|
1112
1194
|
<p>PDF 是白板图像页面,保留手写、图片和排版。继续编辑需要保留原笔记或画布草稿。</p>
|
|
1113
1195
|
<h3>保存完整备份</h3>
|
|
1114
1196
|
<p>
|
|
1115
|
-
|
|
1197
|
+
点左侧「下载备份」,保存包含笔记、图片、总结、批注、学习进度和新学习模块数据的备份。含 PDF 时下载
|
|
1198
|
+
ZIP,内含 backup.json 和去重后的 PDF 原件;其他情况下载 JSON。Chrome
|
|
1116
1199
|
出现同步问题时,也可以「下载画布草稿」,保留一份可编辑的 <code>.excalidraw</code> 文件。
|
|
1117
1200
|
</p>
|
|
1118
1201
|
<p class="small">
|
|
@@ -1134,7 +1217,7 @@
|
|
|
1134
1217
|
</section>
|
|
1135
1218
|
|
|
1136
1219
|
<section class="chapter" id="troubleshooting">
|
|
1137
|
-
<h2>
|
|
1220
|
+
<h2>20 常见问题</h2>
|
|
1138
1221
|
<details class="faq">
|
|
1139
1222
|
<summary>Chrome 没连上 DSH 或一直显示尚未同步</summary>
|
|
1140
1223
|
<p>
|
|
@@ -1205,7 +1288,7 @@
|
|
|
1205
1288
|
</section>
|
|
1206
1289
|
|
|
1207
1290
|
<section class="chapter" id="shortcuts">
|
|
1208
|
-
<h2>
|
|
1291
|
+
<h2>21 Mac 快捷键速查</h2>
|
|
1209
1292
|
<p>
|
|
1210
1293
|
<kbd>⌘</kbd> 是 Command,<kbd>⌥</kbd> 是 Option,<kbd>⇧</kbd> 是
|
|
1211
1294
|
Shift。绘图快捷键在点击画布后生效,正在输入文字时暂停;截图与专注组合键在 Chrome 笔记面板内生效。
|
package/docs/validation.md
CHANGED
|
@@ -10,6 +10,7 @@ npm run build
|
|
|
10
10
|
npm run test:browser
|
|
11
11
|
npm run test:system-study-browser
|
|
12
12
|
npm run test:infographics-browser
|
|
13
|
+
npm run test:pdf-browser
|
|
13
14
|
npm run test:diagram-dependencies
|
|
14
15
|
npm run test:install
|
|
15
16
|
npm audit --json --registry=https://registry.npmjs.org/
|
|
@@ -20,3 +21,30 @@ npm audit --json --registry=https://registry.npmjs.org/
|
|
|
20
21
|
发布测试验证私有文件排除、同名 ZIP 重新生成时不残留旧条目,以及安装和发布示例引用的版本。macOS 正式打包还需要 `npm run build:native` 和 `npm run release:local`。
|
|
21
22
|
|
|
22
23
|
依赖审计需要结合实际打包文件及调用路径判断。公开评估见 [依赖安全说明](dependency-security.md);原始审计 JSON、截图和测试日志放在忽略的 `dist/qa/` 下。
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
PDF 回归样例由项目生成,包含双栏、可选中文、公式、矢量图表、旋转页、扫描页和密码文件。`scripts/test-pdf-browser.mjs` 使用实际 PDF.js 及 Excalidraw,验证导入、批注、文字 / 图像摘录、共用原件、提问来源、回页、搜索与表单草稿恢复;macOS 识别程序可用时执行真实扫描 OCR。问题回答使用固定测试模型,不验证外部模型的回答质量。`tests/pdf.test.mjs` 检查分块重试、版本冲突、来源引用、去重备份与删除生命周期。测试 PDF 的生成脚本是 `scripts/make-pdf-fixture.py`(开发工具:reportlab、Pillow),正常构建不需要 Python。
|
|
27
|
+
|
|
28
|
+
PDF 横版回归还模拟 16:9 报告在视口高度临界处的加载、缩放与滚动条变化,测量加载提示出现时的页面位置,以及静置后的画布重绘次数,确保进度提示不会推移页面或触发持续重绘。
|
|
29
|
+
|
|
30
|
+
PDF 交互回归模拟 DSH 的原生窗口拖动样式,确保画布的透明 SVG 轨迹层不覆盖标题栏拖动区域,画布继续接收绘制输入;同时检查阅读区左右键翻页、首尾页边界和输入框按键隔离。
|
|
31
|
+
|
|
32
|
+
网页笔记回归检查同 URL 新标签页的复用请求、已有标签页绑定优先级、并发打开只创建一篇、已有内容保留、查询参数区分和回收站条目排除。
|
|
33
|
+
|
|
34
|
+
翻页回归还阻塞索引写入来验证页面仍能显示,并检查相邻页预读与位图复用。缓存单元测试覆盖内存预算、取消、迟到结果释放及失败重试。Chrome 浏览器测试通过真实扩展 API 的用户点击打开指定标签页侧栏,校验默认全局侧栏与未打开标签页均为禁用状态。
|
|
35
|
+
|
|
36
|
+
总结排版回归覆盖关系链在宽、窄阅读区的布局、文字与节点边界、可编辑画布导出、材料总结与系统学习切换时头部及 Tab 位置稳定,以及大屏正文使用完整内容列。Chrome 空白画布点击测试确保默认选择工具不会产生误触笔迹。
|
|
37
|
+
|
|
38
|
+
总结提示词的效果用真实模型对照评估,独立于上述代码测试。`tests/summary-evaluation-fixture.mjs` 提供实验报告、算法教程、观点评论、数据报告、虚构事件和图文笔记六类合成材料,后两类作为留出样本。评估要点随材料维护,关注信息保留、关键关系、表达效果和复习价值;字符数仅供比较,不能代替质量判断。
|
|
39
|
+
|
|
40
|
+
修改提示词前保存完整输入快照,修改后使用同一模型和推理等级生成对照:
|
|
41
|
+
|
|
42
|
+
```sh
|
|
43
|
+
node scripts/evaluate-summary.mjs --snapshot --output dist/summary-baseline
|
|
44
|
+
# 调整提示词后,先评估 development,再评估 holdout。
|
|
45
|
+
node scripts/evaluate-summary.mjs --baseline dist/summary-baseline --output dist/summary-evaluation --phase development --model YOUR_CODEX_MODEL --effort max
|
|
46
|
+
node scripts/evaluate-summary.mjs --baseline dist/summary-baseline --output dist/summary-evaluation --phase holdout --model YOUR_CODEX_MODEL --effort max
|
|
47
|
+
node scripts/render-summary-evaluation.mjs dist/summary-evaluation
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
生成命令会使用本机 Codex 登录并消耗模型额度;不纳入 `npm test`。结果、完整提示词、文字稿和图文对照页都写入已忽略的 `dist/`,不写入实际笔记。相同输入、图片、模型与推理等级的成功结果可复用;格式校验通过后仍需人工对照材料审阅,`report.html` 使用现有信息图导出与关系图布局展示结果。`preview-errors.json` 记录实际渲染失败。
|
package/graph-data.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { elementPdfReference } from './shared/pdf.js';
|
|
1
2
|
import { createHash } from 'node:crypto';
|
|
2
3
|
import { legacyStudy } from './study-schema.js';
|
|
3
4
|
import { graphSummaries, summaryScopeKey } from './summary-selection.js';
|
|
@@ -105,6 +106,7 @@ export function buildGraphInput(boards, { includeHistory = false } = {}) {
|
|
|
105
106
|
summaryId: null,
|
|
106
107
|
conceptId: null,
|
|
107
108
|
elementId: e.id,
|
|
109
|
+
...(e.customData?.studyboard?.pdfSource ? { pdfSource: elementPdfReference(e) } : {}),
|
|
108
110
|
kind: 'canvas',
|
|
109
111
|
topicIds,
|
|
110
112
|
title: '画布笔记',
|
package/learning.js
CHANGED
|
@@ -6,9 +6,11 @@ import { atomicWrite, text } from './core.js';
|
|
|
6
6
|
import { legacyStudy, blockTexts, conceptKey } from './study-schema.js';
|
|
7
7
|
import { purgeNotes, resumePurges } from './trash.js';
|
|
8
8
|
import { buildGraphInput, currentGraph, graphReferenceSources } from './graph-data.js';
|
|
9
|
+
import { canvasQuotes } from './shared/canvas-quotes.js';
|
|
9
10
|
|
|
10
11
|
const now = () => new Date().toISOString();
|
|
11
12
|
const hash = (s) => createHash('sha256').update(s).digest('hex').slice(0, 20);
|
|
13
|
+
const quotePrompt = (quote) => (quote.source.trim() ? quote.source : '请背诵这段原文');
|
|
12
14
|
export class LearningStore {
|
|
13
15
|
constructor(store) {
|
|
14
16
|
this.store = store;
|
|
@@ -192,7 +194,54 @@ export class LearningStore {
|
|
|
192
194
|
return { added: 1, card: this.data.cards[id] };
|
|
193
195
|
});
|
|
194
196
|
}
|
|
197
|
+
// The saved scene is authoritative, including for Chrome saves, undo, and existing notes.
|
|
198
|
+
// Call inside store.serial so a refresh cannot overwrite a concurrent grade or suspension.
|
|
199
|
+
async syncQuoteCards(boards) {
|
|
200
|
+
const live = new Set(),
|
|
201
|
+
changes = {},
|
|
202
|
+
date = new Date();
|
|
203
|
+
for (const board of boards) {
|
|
204
|
+
if (board.deletedAt) continue;
|
|
205
|
+
for (const quote of canvasQuotes(board.scene.elements)) {
|
|
206
|
+
const id = hash(`${board.id}/canvas-quote/${quote.id}`);
|
|
207
|
+
live.add(id);
|
|
208
|
+
const prior = this.data.cards[id],
|
|
209
|
+
question = quotePrompt(quote);
|
|
210
|
+
if (prior?.answer === quote.text && prior.question === question) continue;
|
|
211
|
+
changes[id] = {
|
|
212
|
+
...(prior || {
|
|
213
|
+
id,
|
|
214
|
+
boardId: board.id,
|
|
215
|
+
boardTitle: board.title,
|
|
216
|
+
summaryId: null,
|
|
217
|
+
quoteElementId: quote.id,
|
|
218
|
+
questionId: 'quote:' + quote.id,
|
|
219
|
+
kind: 'quote',
|
|
220
|
+
conceptIds: [],
|
|
221
|
+
createdAt: date.toISOString(),
|
|
222
|
+
suspended: false,
|
|
223
|
+
schedule: this.scheduler.newCard({ now: date }),
|
|
224
|
+
}),
|
|
225
|
+
question,
|
|
226
|
+
answer: quote.text,
|
|
227
|
+
version: prior ? prior.version + 1 : 0,
|
|
228
|
+
};
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
if (Object.keys(changes).length)
|
|
232
|
+
await this.commit({ ...this.data, cards: { ...this.data.cards, ...changes } });
|
|
233
|
+
return live;
|
|
234
|
+
}
|
|
195
235
|
async validateCardSource(card) {
|
|
236
|
+
if (card.quoteElementId) {
|
|
237
|
+
const board = await this.store.read(card.boardId);
|
|
238
|
+
const quote =
|
|
239
|
+
!board.deletedAt && canvasQuotes(board.scene.elements).find((q) => q.id === card.quoteElementId);
|
|
240
|
+
if (!quote) throw new Error('这条金句摘录已移除,请刷新复习列表');
|
|
241
|
+
if (quote.text !== card.answer || quotePrompt(quote) !== card.question)
|
|
242
|
+
throw new Error('金句原文或提示已修改,请刷新后核对最新摘录');
|
|
243
|
+
return;
|
|
244
|
+
}
|
|
196
245
|
if (card.origin && this.externalCardAvailable) {
|
|
197
246
|
if (!(await this.externalCardAvailable(card))) throw new Error('复习来源已删除或不可用');
|
|
198
247
|
return;
|
|
@@ -212,21 +261,28 @@ export class LearningStore {
|
|
|
212
261
|
return c;
|
|
213
262
|
}
|
|
214
263
|
async dashboard() {
|
|
215
|
-
const {
|
|
216
|
-
|
|
264
|
+
const { active, quotes } = await this.store.serial(async () => {
|
|
265
|
+
const { boards } = await this.store.all();
|
|
266
|
+
return {
|
|
267
|
+
active: new Map(boards.filter((b) => !b.deletedAt).map((b) => [b.id, b])),
|
|
268
|
+
quotes: await this.syncQuoteCards(boards),
|
|
269
|
+
};
|
|
270
|
+
});
|
|
217
271
|
const external = new Map();
|
|
218
272
|
for (const card of Object.values(this.data.cards))
|
|
219
273
|
if (card.origin && this.externalCardAvailable)
|
|
220
274
|
external.set(card.id, await this.externalCardAvailable(card).catch(() => false));
|
|
221
275
|
const hasSource = (c) =>
|
|
222
|
-
|
|
223
|
-
?
|
|
224
|
-
:
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
(
|
|
228
|
-
active.
|
|
229
|
-
|
|
276
|
+
c.quoteElementId
|
|
277
|
+
? quotes.has(c.id)
|
|
278
|
+
: external.has(c.id)
|
|
279
|
+
? external.get(c.id)
|
|
280
|
+
: [{ boardId: c.boardId, summaryId: c.summaryId }, ...(c.sourceRefs || [])].every(
|
|
281
|
+
(ref) =>
|
|
282
|
+
active.has(ref.boardId) &&
|
|
283
|
+
(!ref.summaryId ||
|
|
284
|
+
active.get(ref.boardId).summaries.some((s) => s.id === ref.summaryId && !s.deletedAt)),
|
|
285
|
+
);
|
|
230
286
|
const cards = Object.values(this.data.cards).filter((c) => !c.suspended && hasSource(c));
|
|
231
287
|
const date = new Date();
|
|
232
288
|
const due = cards
|
|
@@ -284,12 +340,16 @@ export class LearningStore {
|
|
|
284
340
|
throw new Error('请选择掌握程度');
|
|
285
341
|
const date = new Date(),
|
|
286
342
|
result = this.scheduler.review({ card: this.cardDates(current.schedule), grade: r.grade, now: date }),
|
|
287
|
-
next = structuredClone(this.data)
|
|
343
|
+
next = structuredClone(this.data),
|
|
344
|
+
answer =
|
|
345
|
+
current.quoteElementId && typeof r.answer === 'string'
|
|
346
|
+
? r.answer.slice(0, 8000)
|
|
347
|
+
: text(r.answer, '', 8000);
|
|
288
348
|
next.cards[r.cardId] = {
|
|
289
349
|
...current,
|
|
290
350
|
version: current.version + 1,
|
|
291
351
|
schedule: result.card,
|
|
292
|
-
lastAnswer:
|
|
352
|
+
lastAnswer: answer,
|
|
293
353
|
lastReviewedAt: date.toISOString(),
|
|
294
354
|
};
|
|
295
355
|
next.reviews.push({
|
|
@@ -297,7 +357,8 @@ export class LearningStore {
|
|
|
297
357
|
cardId: r.cardId,
|
|
298
358
|
at: date.toISOString(),
|
|
299
359
|
grade: r.grade,
|
|
300
|
-
answer
|
|
360
|
+
answer,
|
|
361
|
+
...(current.quoteElementId ? { quote: { prompt: current.question, text: current.answer } } : {}),
|
|
301
362
|
revlog: result.revlog,
|
|
302
363
|
});
|
|
303
364
|
await this.commit(next);
|
|
@@ -438,7 +499,11 @@ export class LearningStore {
|
|
|
438
499
|
case 'graphSettings':
|
|
439
500
|
return this.graphSettings(r);
|
|
440
501
|
case 'backup':
|
|
441
|
-
return
|
|
502
|
+
return this.store.serial(async () => {
|
|
503
|
+
const backup = await this.store.backup();
|
|
504
|
+
await this.syncQuoteCards(backup.boards);
|
|
505
|
+
return { ...backup, learning: structuredClone(this.data) };
|
|
506
|
+
});
|
|
442
507
|
case 'annotate':
|
|
443
508
|
return this.annotation(r);
|
|
444
509
|
case 'enroll':
|