Repository navigation
Releases: wildcat430524/STG-Desk
Release list
v0.3.9 · 作答区扩容与专注作答
v0.3.9 · 作答工作区布局更新
本次更新重排了教学旁的作答工作区:顶部与底部固定区更窄,正文可用高度明显增加,当前轮改为一次一题,题干不再单独滚动,并新增「专注作答」。按题追加保存、写入前备份、版本校验、完整文档编辑与独立学生窗口都保持原有实现,保存格式与学习文档内容未改动。
作答栏与可用高度
- 作答栏默认宽 420px;DSH 停靠打开时为 360px,更窄的窗口下为 330px。
- 顶部标题收成两行、约 76px,保存区收成单行、约 62px;实测 1460×960 下中间可用高度由 306.5px 增至 431px,约增加 41%。
- 窄栏内的状态文字可以换行,保存按钮仍在同一行,互不重叠。
一题一屏与逐题切换
- 当前轮的题目按题号导航逐题显示,切题不会丢失已输入的内容;草稿按题保留。
- 已填写的题在题号旁显示
✓,没有填写的题不显示。 - 切到「作答记录」或「完整文档」页签时题号导航隐藏,切回「本轮作答」后仍停留在原题。
- 提交时整轮已填写的答案一起追加到学生文档,隐藏题的答案同样会被提交。
题干展开与收起
- 长题干默认折叠,短题干默认展开;展开与收起状态由题干长度决定,不是记住上次选择。
- 题干不再有独立滚动区域,题干与回答随整列统一滚动;代码块仍可横向滚动。
文本框高度
- 文本框最小高度 240px,按作答内容区的实际尺寸自适应,普通布局上限 380px,专注作答上限 560px。
- 文本框仍可手动纵向拖拽调整。
专注作答与键盘
- 点「专注作答」隐藏教学文档、上方工作区头部与文档操作按钮,把答题列居中,最大宽 900px;按钮文字改为「返回对照」。
- 按
Esc返回普通布局;此时旧的窄窗口隐藏规则恢复原样,作答栏重新按原有条件显示或隐藏。 - 专注作答中按
Ctrl+S保存整轮答案(完整文档页则保存回答文档)。 - 普通布局下的
Ctrl+S仍保持原有行为:保存当前文档,完整回答文档处于编辑状态时保存回答文档。 - 专注作答在 1050×760 窄窗口下不出现横向溢出,输入框与保存按钮完整可见;夜间主题、系统「减少动态效果」和键盘焦点样式均适配。
保持不变的实现
按题追加保存、自动草稿、写入前备份与备份保留数量、版本校验与外部修改提醒、历史版本恢复、完整回答文档编辑,以及独立教学/回答窗口都沿用原有实现;作答栏仍是可选的评估入口,提交不会自动修改掌握表或交接状态。
验证与下载
- 162 项单元测试全部通过。
- Electron 完整桌面冒烟验收 25 条通过,渲染进程无报错。
- 作答界面验收覆盖长代码题、切题保留答案、重载恢复两道题的草稿、三个页签、1050×760 专注作答、夜间主题,以及
Ctrl+S保存隐藏题的原答并保留最终复评栏目。 - 实际 Windows 便携版通过 25 项桌面冒烟检查,渲染进程无报错;打包业务模块、页面资源、许可证、图标及内置演示已与已验收源码核对一致。
- 中英文 README 已补充操作说明,并更新工作台截图与新版作答区预览。
Windows x64 下载:STG-Desk-0.3.9-Windows.exe。SHA256SUMS.txt 提供发布附件的 SHA-256 校验值。
复杂内容演示另附 STG-Desk-0.3.9-EditorShowcase.zip,解压后导入 EditorShowcase 根目录即可查看代码、公式、表格和嵌套清单。
English
This release rearranges the answer workspace beside the lesson: less fixed chrome at the top and bottom, a noticeably taller content area, one question at a time in the current round, prompts that no longer scroll on their own, and a new focused answering mode. Appending answers by question, backups before writes, version checks, full-document editing, and detached student windows keep their existing implementation; the save format and the learning documents are unchanged.
-
The answer column is 420px wide by default, 360px while the DSH panel is docked, and 330px in narrower windows.
-
The heading is two lines at about 76px and the save footer is a single row at about 62px; measured at 1460×960, the usable content height grows from 306.5px to 431px, about 41% more.
-
In a narrow column, status text can wrap while the save button stays beside it without overlapping.
-
The current round shows one question at a time with a question-number navigation strip; switching questions never loses typed text, and drafts are kept per question.
-
Questions that have been filled in show
✓next to their number; empty ones do not. -
The strip is hidden on the answer-records and full-document tabs and returns to the same question when the current-round tab comes back.
-
Submitting appends every filled-in answer of the round, including answers to questions that are not currently on screen.
-
Long prompts start folded and short prompts start expanded, decided by prompt length rather than by remembering the last choice.
-
Prompts and answers scroll together instead of using a separate prompt scroll area; code blocks can still scroll horizontally.
-
The textarea is at least 240px tall, follows the real size of the answer content area, caps at 380px in the normal layout and 560px in focused mode, and can still be resized vertically by hand.
-
「专注作答」 (Focused answering) hides the teaching document, the workspace header, and the document actions, and centres the answer column at up to 900px; the button then reads 「返回对照」.
-
Press
Escto return; the previous narrow-window hiding rules apply again and the answer column shows or hides exactly as before. -
In focused answering,
Ctrl+Ssaves the whole round (or the answer document on the full-document tab). -
In the normal layout
Ctrl+Skeeps its existing behaviour: it saves the current document, or the answer document while that is being edited. -
Focused answering shows no horizontal overflow at a narrow 1050×760 window and keeps the textarea and save button fully visible; the dark theme, the system reduced-motion setting, and keyboard focus rings are all covered.
Appending answers by question, automatic drafts, backups before writes and their retention count, version checks and external-change alerts, history restoration, full answer-document editing, and the detached teaching and answer windows are unchanged. The answer workspace remains an optional evaluation entry and never updates mastery tables or handoff status by itself.
All 162 unit tests passed. Answer UI acceptance covers long code prompts, question switching, restoring both drafts after a reload, the three tabs, focused answering at 1050×760, the dark theme, and saving hidden answers while retaining final-reassessment text. The actual Windows portable executable passed 25 desktop smoke checks with no renderer errors. Packaged business modules, page assets, licenses, icons, and bundled demos match the accepted source. Both READMEs include updated instructions, the current workspace screenshot, and a new answer-area preview.
Download STG-Desk-0.3.9-Windows.exe for Windows x64; SHA256SUMS.txt provides SHA-256 checksums. The optional STG-Desk-0.3.9-EditorShowcase.zip contains complex-content examples; extract it and import the EditorShowcase root folder.
v0.3.8 · 修复注释轮次误识别
v0.3.8 · 轮次识别与题面截断修复
本次更新修复了学生回答文档中「被注释预留的后续轮次」被误识别为当前正式轮次与历史记录的问题,并修正按题作答的题面截断。真实课件仍显示第二轮的问题 3、4,注释里预留的第三轮不再参与作答。学习文档历史、备份与保存保护保持原有实现。
轮次识别
- 学生回答文档常用 HTML 注释预留后续轮次,例如
<!-- 第三轮 · 问题 5:综合练习 -->。 - 此前题目解析按普通 Markdown 处理这些行,注释里的
## 第三轮 · 问题 5会被当成真实标题。 - 由此产生的错误行为是:作答区跳到尚未发布的第三轮,而该「题目」的题面只剩注释结束标记
-->,作答记录里也多出一个以注释内标题为名的第三轮区块。 - 现在解析先按 HTML 块处理文档,注释整体作为不可见内容:只有已发布轮次参与轮次与题目识别。
- 真实课件的当前轮次为第二轮、含问题 3 与问题 4,界面正确显示第二轮 2 题;注释中预留的第三轮不再出现。
- 注释原文与其在文档中的位置逐字保留,保存不会改写或删除预留内容。
题面截断
- 作答输入占位标记
**你的代码:**现在与**你的回答:**一样结束题面。 - 此前代码类题目只会在
**你的回答:**处截断,**你的代码:**之后的模板代码块会被并入题面。 - 现在题面在占位标记处结束,模板与预留内容不再混入题目。
- 题面本身包含 fenced 代码块时仍按原有规则处理,代码围栏内的伪标题不受影响。
历史与保存保护
作答记录(历轮原答、导师评估与最终复评)、历史版本备份与恢复、写入前版本校验与备份、外部修改提醒均保持原有实现,保存格式与备份策略未改动。章节轮次与课程状态也会忽略注释中的预留内容;掌握表和课程路线里的注释占位行不再计入进度统计。
验证与下载
- 单元回归范围:注释内预留轮次不进入当前轮次与作答记录、
**你的代码:**截断题面、按题保存只追加到当前轮且注释与最终复评栏逐字保留。 - 便携版验证范围:导入真实课件后应显示第二轮问题 3、4;作答记录不出现预留的第三轮;保存后预留注释与文档尾部导师栏目保持原样。
- 162 项单元测试通过,覆盖注释内的轮次、状态、掌握表与路线单元,以及按题保存和代码题面截断。
- 源码版完成 25 条桌面冒烟检查,渲染进程无报错;新增注释预留轮次的作答与历史记录界面回归。
- 打包代码与验收源码一致;真实课件只读验证确认作答区为第二轮问题 3、4,章节进度为第二轮,学习文档内容未改变。
Windows x64 下载:STG-Desk-0.3.8-Windows.exe。SHA256SUMS.txt 提供发布附件的 SHA-256 校验值。
复杂内容演示另附 STG-Desk-0.3.8-EditorShowcase.zip,解压后导入 EditorShowcase 根目录即可查看代码、公式、表格和嵌套清单。
English
This release fixes future rounds reserved inside HTML comments being mistaken for the current published round and for history, and corrects where the prompt of a question ends. Real courseware still shows round two with questions 3 and 4, and a round three reserved in a comment no longer takes part in answering. Document history, backups, and save protection are unchanged.
- Answer documents often reserve later rounds in HTML comments, for example
<!-- 第三轮 · 问题 5:综合练习 -->. - The question parser used to treat those lines as ordinary Markdown, so
## 第三轮 · 问题 5inside the comment was read as a real heading. - The visible symptom was that the answer workspace jumped to an unpublished round three, that question's prompt was left as the lone comment terminator
-->, and the answer records gained a round-three block named after the heading inside the comment. - The parser now resolves HTML blocks first, so a comment is opaque: only published rounds take part in round and question detection.
- The real courseware's current round is round two with questions 3 and 4, and the interface now shows those 2 questions; the reserved round three no longer appears.
- Comment text and its offsets are preserved byte for byte, and saving never rewrites or deletes reserved content.
The input placeholder **你的代码:** now ends the prompt, exactly like **你的回答:**.
- Previously only
**你的回答:**stopped the prompt, so a template code block after**你的代码:**was folded into the question. - The prompt now ends at the placeholder, and template or reserved content no longer leaks into a question.
- Fenced code inside a prompt keeps the existing rules, and pseudo-headings inside code fences are still ignored.
Answer records (previous answers, tutor evaluations, and final reassessments), history backups and restoration, version checks and backups before writes, and external-change alerts keep their existing implementation; the save format and backup policy are unchanged. Chapter rounds and course status also ignore commented placeholders, and commented mastery tables or route units no longer contribute to progress counts.
All 162 unit tests passed, including commented rounds, status, mastery tables and route units, code prompt boundaries, and question-based saving. The source build passed 25 desktop smoke checks with no renderer errors, including a commented future-round regression in answer cards and history. Packaged modules match the accepted source; a read-only check of real courseware confirms round two with questions 3 and 4 and chapter progress at round two, without changing learning files.
Download STG-Desk-0.3.8-Windows.exe for Windows x64; SHA256SUMS.txt provides SHA-256 checksums. The optional STG-Desk-0.3.8-EditorShowcase.zip contains complex-content examples; extract it and import the EditorShowcase root folder.
v0.3.7 · 界面字号与可读性优化
v0.3.7 · 界面字号与可读性优化
本次更新统一调整整个应用的界面字号:信息文字不再过小,常用按钮和输入区更好读,文档表格跟随正文字号缩放。界面配色、学习数据与 DSH 账号模型保持不变。
字号与可读性
- 统一了工具栏、状态提示、作答区和 DSH 的字号层级。
- 元信息与辅助说明文字由 9–11px 提升到 12px。
- 常用按钮由 10–12px 提升到 13–14px,底部文档操作按钮与作答页签为 13px,阅读设置与 DSH 标题为 14px。
- 作答文本框与 DSH 输入框使用 15px,文档栏标题为 16px,作答说明为 13px。
- 欢迎页、进度辅助、阅读设置、历史版本、公式与代码工具、DSH 面板与小窗使用同一字号梯度。
- 文档表格此前固定为 12px,现改为继承正文;实测正文 16px 时表格为 16px,正文 21px 时表格为 21px。
- 文档正文字号仍由「阅读设置」控制,默认 16px,可在 13–24px 之间调整;各级标题与正文的比例关系保持不变。
- 仅有的布局微调是收紧标题区按钮的内边距,并允许作答页签在窄窗口下换行。
原有设置与保存保护
阅读设置、夜间主题与专注模式行为不变,导入目录、草稿、版本校验、写入前备份、外部修改提醒与历史恢复保持原有实现,未保存的输入仍由自动草稿恢复。
验证与下载
- 154 项单元测试通过。
- 真实 Electron 字号与布局验收通过 13 个状态:欢迎页、课程页、DSH 停靠、1050×720 窄窗口停靠、夜间、系统「减少动态效果」、约 400×600 DSH 浮窗、作答记录与完整文档、阅读设置、21px 正文,以及 550px 独立教学窗与回答窗。
- 完整桌面冒烟验收 24 条证据全部通过,渲染进程无报错。
- Windows 便携 EXE 已完成隔离桌面冒烟,24 条证据通过。
- 发布所用的 CSS 与 JS 构建产物与验收版本逐字节一致。
- 各状态实测容器无横向溢出,按下作答页签与底部按钮均保持完整可点。
Windows x64 下载:STG-Desk-0.3.7-Windows.exe。SHA256SUMS.txt 提供发布附件的 SHA-256 校验值。
复杂内容演示另附 STG-Desk-0.3.7-EditorShowcase.zip,解压后导入 EditorShowcase 根目录即可查看代码、公式、表格和嵌套清单。
English
This release raises the interface type scale across the whole app: small metadata is no longer hard to read, common buttons and inputs are more legible, and document tables now scale with the body text. Interface colours, learning data, and the DSH account model are unchanged.
- Toolbars, status text, the answer workspace, and DSH use a consistent type scale.
- Metadata and helper text moved from 9–11px to 12px.
- Common buttons moved from 10–12px to 13–14px; document action buttons and answer tabs are 13px, and reading settings and DSH headings are 14px.
- The answer textarea and the DSH input use 15px, the document heading is 16px, and answer help text is 13px.
- The welcome screen, progress helpers, reading settings, version history, formula and code tools, and the DSH panel and floating window share the same scale.
- Document tables previously used a fixed 12px and now inherit the body text: measured 16px at a 16px body size and 21px at 21px.
- Body text is still controlled by 「阅读设置」 (Reading settings) — 16px by default, adjustable from 13 to 24px — and heading-to-body ratios are unchanged.
- The only layout tweaks are tighter header-button padding and answer tabs that wrap in narrow windows.
Reading settings, the night theme, and focus mode behave as before. Import, drafts, version checks, backups before writes, external-change alerts, and history restoration are unchanged, and unsaved input is still recovered from automatic drafts. All 154 unit tests passed, along with 13 real Electron typography and layout states (welcome, lesson, docked DSH, 1050×720 narrow dock, night, reduced motion, a roughly 400×600 floating DSH window, answer records and full document, reading settings, 21px body text, and the 550px detached teaching and answer windows). The full desktop smoke run passed 24 evidence items with no renderer errors, and the shipped CSS/JS build is byte-identical to the accepted version. No state showed horizontal container overflow, and the answer tabs and footer buttons remained fully clickable.
The Windows portable EXE also passed all 24 desktop smoke checks with an isolated profile. Download STG-Desk-0.3.7-Windows.exe; SHA256SUMS.txt provides SHA-256 checksums. The optional STG-Desk-0.3.7-EditorShowcase.zip contains complex-content examples; extract it and import the EditorShowcase root folder.
v0.3.6 · Markdown 编辑体验升级
v0.3.6 · Markdown 编辑体验升级
本次更新集中在 Markdown 文档区域:更舒适的阅读配色、更清楚的内容层级,以及可以直接操作的代码与公式。
编辑器
- 浅色纸面、白底细边框代码块、标题层级提示、轻量引用线;同时完善深色文档样式。
- 复用 highlight.js 的 Atom One Light / Dark 主题,支持 Java、Python、JavaScript、TypeScript、SQL 等 17 种语法语言及纯文本。
- 代码块可选择语言并复制当前代码;高亮与工具条不写入 Markdown 内容。
- 行内与块级数学公式使用 KaTeX 渲染。通过公式按钮插入、实时预览,双击已有公式修改。
- 修复公式与行内代码混排,代码中的美元符号保留为代码。
- 统一编辑器 SVG 工具图标,改善表格、任务清单与窄窗口阅读。
应用其他区域的颜色保持原样。未修改区块继续保留原 Markdown,包括 CRLF、BOM、元数据与引用定义;保留撤销、组合输入和外部修改保护。
复杂内容演示
下载并解压 STG-Desk-0.3.6-EditorShowcase.zip,在应用中「导入学习文件夹」选择 EditorShowcase 根目录。
演示包含 Java 17+ Stream / CompletableFuture、Python 梯度下降、TypeScript 异步重试、SQL 窗口函数、矩阵与梯度公式,以及表格、嵌套清单和任务框。演示记录仅用于查看界面效果。
验证与下载
- 154 项单元测试通过。
- 真实 Electron 编辑器验收覆盖高亮、选区、组合输入、代码复制参数、语言切换与撤销、公式插入和修改、混排、原文保存、深色与窄窗口。
- Windows 便携包完成桌面烟测与打包内容核对。
- Python 演示已运行;Java 示例要求 Java 17+,本机 Java 11 环境未编译该示例。
Windows x64 下载:STG-Desk-0.3.6-Windows.exe。SHA256SUMS.txt 提供发布附件的 SHA-256 校验值。
English
This release improves Markdown reading and editing with neutral light/dark document styles, scoped Atom One syntax themes, selectable code languages and copy actions, live KaTeX formula insertion/editing, and consistent SVG controls. Colors outside the Markdown editor remain unchanged.
The separate EditorShowcase ZIP contains complex Java 17+, Python, TypeScript and SQL examples, matrices, gradients, tables and nested checklists. Extract it and import the EditorShowcase root folder. All 154 unit tests and the Windows packaged desktop smoke test passed. The Python example was executed; the Java 17+ example was reviewed but not compiled on the local Java 11 environment.
STG Desk v0.3.5
本次更新
- 教学、学生回答、当前章节进度和总体进度分别提供入口,从学习档案继续当前课程。
- 文档采用单栏所见即所得编辑,简化控件并将文档操作集中到底部;未修改区块保留原始 Markdown。
- 新增全局夜间主题与专注模式,并可调整字号、行距和阅读宽度。
- 教学与回答支持独立窗口;关闭后恢复主窗口中的文档和草稿。
- DSH 学习会话按工作区绑定,面板启动时默认收起,可按需展开或切换到独立小窗。
- 修复 Windows exe、主窗口与独立窗口的项目图标,更新中英文 README 和界面截图。
下载与使用
下载 STG-Desk-0.3.5-Windows.exe 后直接运行,无需另装 Node.js 或 Electron。
学习资料保存在原目录;自动草稿与应用设置保存在系统应用目录。已有学习目录可以继续导入使用。升级后若未自动恢复旧 DSH 会话,可从当前学习目录的会话菜单重新选择;旧对话仍保留在 DSH 历史中。
阅读、编辑和作答无需 DSH。AI 对话需要本机 DeepSeek Harness 桌面端及可用模型配置,连接时请保持 DSH 主窗口打开;学习管理插件为可选。
当前支持 Windows 与 UTF-8 Markdown/TXT,单文件上限 8 MB。应用尚未代码签名,下载后可用 SHA256SUMS.txt 核对文件。
验证
- 125 项逻辑测试通过。
- 真实 Electron 桌面验收通过,覆盖编辑、草稿恢复、保存冲突、备份、DSH 窗口与独立文档窗口。
- 正式下载 exe 的 24 项桌面验收通过,渲染错误为零。
- Windows 便携版来自发布提交
b4bd675的 成功构建,下载后已核对 SHA256。
STG Desk 0.3.3
STG Desk 0.3.3
- 作答工作区提供「本轮作答 / 作答记录 / 完整文档」,可直接阅读、编辑、保存学生文档并恢复历史备份。
- 查看历轮原答、导师评估和最终复评,保留文档中的未识别段落。
- 教学文档和学生文档均可打开原生独立窗口,学生窗口直接答题。
- 主窗口切换课程或关闭后,独立窗口保持原学习文件夹并可继续保存。
- 跨窗口保存共用写入队列和版本校验,防止覆盖其他窗口或外部修改;各窗口保留独立本地草稿。
- 更新圆角卡片、灰色文字、输入区与记录展示,遵循减少动态效果设置。
验证:102 项自动测试通过;真实 Electron 桌面测试通过,包含作答记录、完整文档编辑、备份、冲突与主窗口关闭后继续答题。
下载 STG-Desk-0.3.3-Windows.exe,双击运行。无需另装 Node.js 或 Electron。
独立 DSH 插件:https://github.com/wildcat430524/dsh-stg-learning/releases/latest
STG Desk 0.3.2
STG Desk 0.3.2 的首个公开版本。
- Windows 本地 Markdown 阅读、编辑与答题工作台。
- 顶部按当前课程显示需要读写的文档,支持草稿、版本检查与备份恢复。
- 连接已打开的 DSH,共用原生会话和模型,支持侧边对话与独立浮窗。
- MIT 开源;第三方许可证随程序提供。
下载 STG-Desk-0.3.2-Windows.exe 后双击运行,无需单独安装 Node.js。此 Windows 程序尚未签名。
DSH 插件独立安装:https://github.com/wildcat430524/dsh-stg-learning/releases/latest
验证:源码自动测试与 Vite 构建通过;发布包中的 Electron/业务模块与公开源码逐文件一致。DSH 桌面协作已在 Windows、DSH Desktop 0.2.0-rc.2 验证,其他平台未覆盖。