dsh-learning-quirky-stuff 4.3.1 → 4.4.2

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 CHANGED
@@ -25,6 +25,8 @@
25
25
  | `src/system-study-*` | AI 总结中的系统学习入口、语义网格排版、可编辑白板、来源检查与独立草稿 |
26
26
  | `shared/infographics.js`、`server/infographic-sources.js` | 按需配图提示词、声明式版面 Schema、规范化与生成时来源快照 |
27
27
  | `server/modules/infographics.js`、`src/infographic-*` | 单独配图与版本管理、原生画布排版、阅读预览、编辑与统一导出 |
28
+ | `server/modules/canvas-comments.js`、`shared/canvas-comments.js`、`src/canvas-comments.*` | 主画布、系统学习和信息图的组件讨论,来源快照、选择校验、幂等提问、跟随标记与草稿 |
29
+ | `src/canvas-text-layout.js`、`src/canvas-text-wrap.jsx` | 普通长文字的宽度和换行规则、避让布局、撤销与手动整理入口 |
28
30
  | `server/integrations/`、`native/` | 网页正文 / PDF 提取、macOS Vision 图片与手写识别 |
29
31
  | `server/lib/` | 存储仓库、值校验和小型工具函数 |
30
32
  | `docs/user-guide.html`、`scripts/build-guide.mjs` | 使用说明的单一来源,生成 DSH 内嵌文档及 Chrome 离线说明 |
@@ -61,10 +63,13 @@ router.register('topics.generate', request => this.generate(request), 'topics');
61
63
  | 反馈 | `feedback.context` / `feedback.start` / `feedback.history` / `feedback.get` / `feedback.resolve` / `feedback.enroll` |
62
64
  | 系统学习 | `systemStudy.start` / `systemStudy.list` / `systemStudy.get` / `systemStudy.saveCanvas` / `systemStudy.deleted` / `systemStudy.enroll` |
63
65
  | 信息图 | `infographics.list` / `infographics.get` / `infographics.start` / `infographics.saveCanvas` / `infographics.visibility` |
66
+ | 组件讨论 | `canvasComments.list` / `canvasComments.send` / `canvasComments.resolve` / `canvasComments.model` |
64
67
  | 周报 | `weekly.overview` / `weekly.generate` / `weekly.list` / `weekly.get` / `weekly.deleted` / `weekly.reviewSession` / `weekly.enroll` / `weekly.grade` |
65
68
  | 共用 | `tasks.get` / `tasks.list` / `tasks.cancel` / `sources.catalog` / `sources.get` / `reports.get` |
66
69
 
67
- Chrome `/module` 只开放所需的配置读取、材料读取 / 分析及任务状态 / 取消动作,沿用本机随机令牌和来源校验。
70
+ Chrome `/module` 只开放所需的配置读取、材料读取 / 分析、组件讨论及任务状态 / 取消动作,沿用本机随机令牌和来源校验。
71
+
72
+ 组件讨论按笔记和画布类型隔离,元素编号负责定位,内容哈希负责识别来源变化,移动位置不使讨论失效。发送前保存画布并校验服务端内容;问题使用独立请求编号及 `tasks.start({once: true})`,丢失响应后的重试复用任务。关闭讨论面板不会取消后台回答,手动停止或关闭功能会取消任务。讨论和来源快照纳入模块备份与永久删除流程。
68
73
 
69
74
  ## 来源与模型约定
70
75
 
package/README.md CHANGED
@@ -6,6 +6,7 @@ Studyboard is a local learning workspace for DeepSeek Harness: handwritten notes
6
6
 
7
7
  - **自由白板**:触控笔、图片、形状、箭头、文字、自动保存、PDF 导出。
8
8
  - **结构化记录**:提问卡、编号知识点、对比卡、步骤卡、图片备注;选定区域后自动排版,双击卡片编辑。
9
+ - **组件提问与备注**:选中文字、图片或一组组件向模型提问,继续追问或留下自己的备注。讨论标记跟随组件,支持已解决、重新打开和来源变化提示。
9
10
  - **AI 总结**:按主题组织图文内容,保留原图,支持批注、拓展、互动自测和可选的间隔复习。
10
11
  - **自适应信息图**:总结时按内容决定是否配图、复用原图或重新组织。生成的文字、图片与关系可编辑,支持来源对照、独立重做、历史版本和图片 / PDF / 可编辑画布导出。
11
12
  - **系统学习**:在 AI 总结中选择系统学习,按主题决定机制图、论证关系、比较图或时间线;连接相关笔记、按需联网补充资料,生成可编辑论证白板。时间旅行研究区分当时的知识、解释边界与后来的修正。
@@ -18,14 +19,16 @@ Studyboard is a local learning workspace for DeepSeek Harness: handwritten notes
18
19
 
19
20
  ## 安装
20
21
 
21
- 当前版本 **4.3.1** 适配 DSH **0.2.2-rc.1**。macOS 13+ 为完整功能的首批验证平台;发布包附带 Apple Silicon / Intel 本机识别程序。Linux、Windows 的通用功能可运行,但尚未完成完整平台验收,图片识别与本机 PDF 提取会明确提示不支持。
22
+ 当前版本 **4.4.2** 适配 DSH **0.2.2-rc.1**。macOS 13+ 为完整功能的首批验证平台;发布包附带 Apple Silicon / Intel 本机识别程序。Linux、Windows 的通用功能可运行,但尚未完成完整平台验收,图片识别与本机 PDF 提取会明确提示不支持。
22
23
 
23
- 桌面版通过 DSH「插件」页面添加 npm 包 `dsh-learning-quirky-stuff@4.3.1`。离线安装可从 [Releases](https://github.com/EndWithHyphen/dsh-learning-quirky-stuff/releases) 下载 `.tgz`,解压后选择 `package` 目录。`desktop` profile 由 Electron 应用管理,CLI 不允许直接修改。
24
+ 4.4.2 修复组件提问、自动换行、回答 Markdown 和重试状态,并支持删除备注草稿。
25
+
26
+ 桌面版通过 DSH「插件」页面添加 npm 包 `dsh-learning-quirky-stuff@4.4.2`。离线安装可从 [Releases](https://github.com/EndWithHyphen/dsh-learning-quirky-stuff/releases) 下载 `.tgz`,解压后选择 `package` 目录。`desktop` profile 由 Electron 应用管理,CLI 不允许直接修改。
24
27
 
25
28
  命令行版使用独立 profile 安装:
26
29
 
27
30
  ```sh
28
- dsh plugin --profile studyboard add dsh-learning-quirky-stuff@4.3.1
31
+ dsh plugin --profile studyboard add dsh-learning-quirky-stuff@4.4.2
29
32
  ```
30
33
 
31
34
  在 DSH 中启用「自定义插件市场」,打开「插件 → 发现 → 添加索引源」,可使用本项目的发布索引:
@@ -40,6 +43,36 @@ Chrome 配套为 [Release 中的独立 ZIP](https://github.com/EndWithHyphen/dsh
40
43
 
41
44
  详细步骤:[安装与迁移](docs/install.md) · [使用说明](docs/user-guide.html) · [数据处理说明](docs/privacy.md)
42
45
 
46
+ ## Chrome 扩展:边看边记
47
+
48
+ 连接后,在文章或视频页按 **⌘⇧Y**(Windows / Linux:**Ctrl⇧Y**)打开笔记侧栏。每个标签页各自绑定一篇笔记,自动保存网页链接;切换标签页可继续记录对应内容。
49
+
50
+ **侧栏随手记**适合快速留下主线、联系和疑问,写入内容后自动同步到本机 DSH。
51
+
52
+ <img src="https://raw.githubusercontent.com/EndWithHyphen/dsh-learning-quirky-stuff/main/docs/images/chrome-sidepanel.png" alt="Chrome 侧栏:网页来源、截图入口和随手记" width="460">
53
+
54
+ **截图与画布**:点「区域截图」拖选关键部分,截图会放到当前笔记。切换「手写画布」即可圈画、添加图注、放置知识点或提问卡;「专注画布」让画布占满插件面板。
55
+
56
+ <img src="https://raw.githubusercontent.com/EndWithHyphen/dsh-learning-quirky-stuff/main/docs/images/chrome-canvas.png" alt="专注画布:截图、手写圈画、编号知识点与提问卡" width="1000">
57
+
58
+ **选中组件后讨论**:点「提问 / 备注」,选模型并点「问 AI」,或点「留下备注」保存自己的想法。点击组件旁的编号再次展开;「备注」列表可查找讨论和已解决记录。DSH 主画布、系统学习白板与信息图编辑器也支持这一入口。
59
+
60
+ <img src="https://raw.githubusercontent.com/EndWithHyphen/dsh-learning-quirky-stuff/main/docs/images/chrome-comments.png" alt="选中截图后留下备注,并针对该图输入问题" width="1000">
61
+
62
+ **底部打开**:侧栏顶部点「底部打开」,笔记面板会从当前网页下方展开,适合保留较宽的文章或视频区域。拖动面板上沿调整高度,也可切回侧栏。
63
+
64
+ <img src="https://raw.githubusercontent.com/EndWithHyphen/dsh-learning-quirky-stuff/main/docs/images/chrome-bottom.png" alt="文章下方的底部笔记面板,包含截图和随手记" width="1000">
65
+
66
+ | 操作 | macOS | Windows / Linux |
67
+ | --- | --- | --- |
68
+ | 打开当前标签页笔记 | ⌘⇧Y | Ctrl⇧Y |
69
+ | 区域截图 | ⌥⇧S | Alt⇧S |
70
+ | 可见页截图 | ⌥⇧V | Alt⇧V |
71
+ | 专注画布 | ⌥⇧F | Alt⇧F |
72
+ | 取消区域截图 | Esc | Esc |
73
+
74
+ 截图和专注快捷键需要先让插件面板获得焦点;打开笔记的快捷键可在 `chrome://extensions/shortcuts` 修改。以上截图使用独立的演示文章和笔记。
75
+
43
76
  ## 模型与本机能力
44
77
 
45
78
  DSH 中配置的模型负责 AI 功能,按所选账户的额度或计费规则使用。也可使用已安装并登录的本机 Codex CLI;模型列表显示实际模型和推理强度。普通总结关闭工具执行和联网;用户选择「联网寻找资料」时才开启搜索。
package/capture-server.js CHANGED
@@ -261,6 +261,10 @@ export class CaptureServer {
261
261
  ![
262
262
  'features.get',
263
263
  'features.models',
264
+ 'canvasComments.list',
265
+ 'canvasComments.send',
266
+ 'canvasComments.resolve',
267
+ 'canvasComments.model',
264
268
  'system.capabilities',
265
269
  'search.recognizeImage',
266
270
  'search.confirmImage',