STG Desk

读教学、写答案、看进度，在一个工作台里继续学习。

Windows 便携应用 · 本地 Markdown · DeepSeek Harness 协作

下载 Windows 便携版 · 快速开始 · 反馈问题

简体中文 | English

STG Desk 是面向 StepsToGreat 学习目录的 Windows 桌面工作台。打开本地学习文件夹，就能从档案找到当前课程，在教学旁写答案，查看历轮反馈与学习进度。需要 AI 评估或讨论时，可连接本机 DeepSeek Harness（DSH），继续使用原生学习会话。

阅读、编辑和作答可以独立使用，DSH 对话按需连接。学习资料仍保存在原目录中，便于导师或学习 Agent 接着读取和更新。

本文对应 v0.3.18，各版本变化见 发布说明。应用界面目前为中文。

v0.3.18 使用精简的对话输入区，模型选择与发送按钮保持对齐；课程资料自动关联。支持搜索模型与服务商、调整面板宽度，以及在窄区域切换教学和作答。

教学、学生回答、当前章节进度和总体进度各有入口；教学与回答文档可以移到独立窗口，DSH 支持侧边面板与独立小窗。

_{学习工作台。左边读教学，右边按题作答；需要评估或讨论时，从右上角展开 DSH 面板。}

截图使用演示课程与测试草稿，不包含真实学习记录或模型回复。

模型选择面板支持服务商分组、搜索和键盘操作；此图使用演示模型列表。

• 接着上次学：恢复最近工作区，从学习档案定位当前课，也可选择已有课程。
• 直接编辑文档：单栏所见即所得，支持代码、表格、清单、公式和本地图片；未修改区块保留原始 Markdown。
• 代码与公式就地处理：代码块带语法高亮、语言选择和复制按钮；行内与独立公式由 KaTeX 排版，可插入、预览并双击修改。
• 教学旁边作答：按题编辑当前轮答案、插入代码块并同步保存；历轮原答、评估和复评可以随时核对。
• 完整文档随时修改：回答页直接编辑全文，也能在教学旁查看与修改完整学生文档。
• 进度有据可查：读取文档中的章节进度、总体进度、交接状态和掌握记录。
• 按自己的习惯阅读：独立教学与回答窗口、字号与行距设置、阅读宽度、夜间主题和专注模式。
• 调整工作台布局：拖动分隔线分配教学、作答与 DSH 的宽度；按工作区记住布局，区域较窄时切换教学与作答。
• 沿用 DSH 会话：按服务商分组搜索模型，查看价格标记和当前选择；面板和小窗共用同一对话与输入草稿。
• 带着课程资料提问：发送时自动关联当前课程已保存的相关文档；对话支持复制消息、复制代码和回到最新回复。
• 保存可以回头核对：一键保存现有修改、写入前备份、外部修改提醒与历史恢复。

软件展示已有学习记录，掌握判断、导师评估与下一课由导师或学习 Agent 更新。

1. 从 最新发布页 下载 STG-Desk-<版本号>-Windows.exe，双击运行，无需另装 Node.js 或 Electron。
2. 点击「导入学习文件夹」，或从资源管理器把文件夹拖入窗口。选择包含学习档案和课程目录的工作区根目录。
3. 点击「继续学习」进入当前课，或通过「选择课程」打开已有课程。
4. 阅读教学，在旁边填写答案并「保存本轮作答」；也可打开回答页直接编辑，点击「保存」或按 Ctrl+S 写入文档。
5. 需要 AI 评估时，启动 DSH 桌面端，在 STG Desk 中打开 DSH 面板并连接，再发送评估请求。

暂时没有学习资料，可以从欢迎页体验 内置演示课程。导入目录会直接读取原文件；保存时写入原学习目录，不复制成另一套资料。

StepsToGreat/
├─ README.md
└─ 我的学习/
   ├─ 00-学习档案.md
   └─ 学科/
      └─ Python/
         └─ 01-认识变量/
            ├─ 01_教学引导.md
            └─ 01_学生回答.md

点击文档的标题、正文、清单或表格直接编辑；行内公式可双击修改。文档信息与操作集中在底部，可调整阅读设置、切换夜间主题或进入「专注」。按 Esc 或点击退出入口返回普通布局。

拖动教学与作答之间、工作台与 DSH 之间的分隔线调整宽度；双击分隔线恢复默认。宽度设置按学习工作区记忆，重新打开同一目录后恢复。

教学与作答所在区域较窄时，标题栏会出现「教学 / 本轮作答」切换入口。切换视图保留已输入的答案。分隔线也可以通过 Tab 聚焦，再用左右方向键微调。

代码使用中性浅灰阅读背景与白底细边框卡片，字号、行距和留白为长代码保持稳定；深色主题下整套颜色同步切换。每段代码上方有工具条，可选择语言或一键复制。

语法高亮与文档预览共用同一套 highlight.js 实例和样式，因此编辑区与阅读区的配色一致。可选语言共 17 种语法加纯文本：

Java · Python · JavaScript · TypeScript · JSON · Shell/Bash · SQL · HTML/XML · CSS
C/C++ · C# · Go · Rust · Kotlin · YAML · Markdown · Diff · 纯文本

未知语言或超过 20000 字符的代码块仍可正常编辑和保存，只是不做着色。工具条不属于文档内容，不会写入 Markdown。

行内公式写在 $...$ 中，独立公式块使用 $$...$$，两者都由 KaTeX 排版并保留原始 LaTeX。点击底部「公式」可以插入新公式；对话框会实时预览结果并检查语法，双击已有公式即可修改源式。

公式识别复用 Markdown 的代码跨度规则，行内代码中的美元符号不会被当作公式。LaTeX 无法解析时，编辑区保留原式并提示错误，不会丢失内容。

标题、清单、表格和公式按内容层级组织：标题在左侧留白处以 H1/H2/H3 标注层级，任务清单、嵌套清单和数据表格保持可编辑。

仓库内 demo/EditorShowcase 是专门的内容演示工作区，涵盖 Java 17+ Stream/CompletableFuture 泛型、Python 梯度下降、TypeScript 异步重试、SQL 窗口函数、4 组独立公式，以及表格、任务与嵌套清单。示例数据均为虚构。

导入方式：

• 从源码运行：导入 demo/EditorShowcase 目录。
• 使用便携版：下载 复杂内容演示 ZIP，解压后导入 EditorShowcase 根目录。也可以直接查看 演示源码 和 教学文档。
• 导入后「选择课程」会列出这门演示课程（路径为 我的学习/学科/Markdown/01-复杂内容演示/），与内置的 示例课程 相互独立。

演示中的 Java 示例按 Java 17+ 语法编写，仅经过审查，未在本机 Java 11 环境编译；Python 示例已实际运行。示例用于展示排版与编辑效果，不代表学习评估。

课程采用 第N轮_教学引导.md 分轮留档时，点击文档卡片左上角标题旁的箭头即可切换本章教学轮次。打开旧轮会自动展开对应的作答记录；各轮文件不再重复占用顶部标签。

教学旁的作答区提供三个入口：

按题输入支持普通轮与费曼轮，适用于当前轮有 1–3 道可识别题目的文档；题目更多或格式无法识别时，可直接编辑回答全文。答题区、回答全文和当前教学文档的修改会在一次保存中一起写入，无需分步保存。

点击题号切换当前题目，已填写的题会显示 ✓；切题保留输入，保存包含当前未显示的题目。长题干默认收起，点击「题干与示例」展开查看；展开后整列统一滚动。

点击「专注作答」放大答题区，点击「返回对照」或按 Esc 返回教学与作答并列布局。「保存本轮作答」、底部「保存」和 Ctrl+S 都保存现有修改，普通布局与专注作答中的行为一致。

点击保存即可把现有修改写入文档。 输入会在后台保留以便意外关闭后恢复，不需要管理草稿或另存。作答保存会保留已有答案与评估，不自动修改掌握表或交接状态。

点击「当前章节进度」核对当前交接记录，或打开「总体进度」查看课程路线与学习档案中已有的掌握记录。进度来自原文档，导师更新记录后会刷新。

在教学或回答页点击「开窗口 ↗」，主应用切到另一份文档，已弹出的入口暂时禁用；进度页仍可进入。关闭独立窗口后，主应用回到对应文档并恢复草稿。

主窗口切换课程、切换学习目录或关闭后，独立窗口继续使用打开时的文档与工作区。各窗口保留独立草稿，写入同一文件时共享保存队列并校验版本。

把教学移到独立窗口，可以一边阅读、一边在主窗口答题。

回答文档也可以独立打开，直接编辑全文，并保留原工作区。

先打开 DeepSeek Harness 桌面端并配置可用模型，保持其主窗口打开，再在 STG Desk 中打开 DSH 面板，点击「连接」。仅有后台进程运行时无法连接。首次连接会为当前学习目录创建专用会话，之后恢复该会话；也可选择这个目录的已有会话或新建会话。应用启动时默认不展开 DSH。

模型目录、账号和额度由你本机的 DSH 管理。保存答案后，再发送评估请求，让学习 Agent 读取文档进行评估。

模型选择。 点击输入区底部的模型名称，搜索模型名称或服务商。列表按服务商分组，显示 DSH 提供的价格标记，并以勾选标出当前模型。可用方向键选择、Enter 确认、Esc 关闭；回复生成期间不能切换模型，切换失败会保留原模型。

自动关联资料。 每次发送时自动读取当前课程相关的已保存文档，例如教学引导、学生回答、学习档案和学习规则。输入区无需额外点击引用按钮；尚未保存的编辑不会作为文档上下文发送，按题答案请先保存。

阅读与发送。 Enter 发送，Shift+Enter 换行；生成时发送按钮变为停止按钮。上翻历史消息时保持当前阅读位置，点击「回到最新 ↓」继续跟随回复。消息下方可复制整条内容，代码块可单独复制，并显示复制结果。

dsh-stg-learning 是独立的 DSH 学习管理插件，用于在 DSH 内组织工作区与会话；连接 DSH 无需安装该插件。

DSH 面板可切换为置顶小窗，继续使用同一会话、模型和输入草稿。下图使用演示会话与模型列表展示小窗中的模型选择面板。

$env:STG_DSH_DESKTOP_URL = 'http://127.0.0.1:19387'
$env:DSH_HOME = 'C:\你的DSH配置目录'
& 'C:\你的软件目录\STG-Desk-<版本号>-Windows.exe'

保存前校验文件版本，备份旧内容，再通过临时文件替换。保存时自动保留可合并的外部修改；同一段发生冲突时采用当前编辑内容，磁盘旧版本自动备份，不弹出手动合并窗口。若题目本身已更换，保留输入并提示核对，避免把答案写入另一道题。恢复历史版本前也会备份当前内容。

输入停顿约 250 毫秒后写入草稿；草稿恢复不会自动覆盖原文件。本地备份不等于云端同步，重要学习资料建议另行备份。

在历史版本中先预览旧内容，再决定是否恢复。

需要 Node.js 22.12+；CI 使用 Node.js 24。完整桌面功能需要 Electron 宿主。

git clone https://github.com/wildcat430524/STG-Desk.git
cd STG-Desk
npm ci
npm start

开发桌面界面时，先运行 npm run dev，再在另一终端设置 $env:STG_DEV_URL='http://127.0.0.1:5178' 并执行 npx electron .。

桌面冒烟验收需要在未被 ELECTRON_RUN_AS_NODE=1 污染的环境中运行；若出现 app.setPath is not a function，先清除该变量再重试。验收会在 tests/artifacts/ 留下界面截图与 desktop-smoke.json。

electron/          桌面窗口、IPC、DSH 控制与独立文档窗口
src/               学习页面、作答区、编辑器与样式
lib/               导航、文档解析、文件保存、草稿与 DSH 服务
tests/             逻辑测试与桌面验收
demo/              演示课程（StepsToGreat、EditorShowcase）
docs/screenshots/  README 界面截图
.github/workflows/ Windows 验证、构建与发布

欢迎提交 Issue 或 Pull Request。反馈时请提供软件版本、DSH 版本（如相关）、复现步骤和预期行为；文档解析问题可附脱敏的最小 Markdown 示例。

涉及保存、备份、解析或窗口行为的修改，请运行相关测试。界面修改请附演示数据截图，并检查窄窗口与系统「减少动态效果」设置。

本项目新增代码采用 MIT。第三方许可见 THIRD-PARTY-NOTICES.md 和依赖各自的 LICENSE。