企业官网建设流程全解析

1. 这不是个“学习软件”，而是一套可落地的协作式知识操作系统

StudyMate 这个名字听起来像学生用的笔记工具，但实际接触过的人很快会发现——它根本不是那种点开就能记两行字的轻量级App。它是一个基于DSH（Distributed Shell）协议栈构建的、面向技术型学习者与小团队的知识协同环境。我第一次在 Ubuntu 22.04 上跑通它的完整链路时，花了整整三天：从系统底层依赖编译，到 Python 模块的版本锁死，再到 Node.js 运行时与 DSH 插件市场的握手失败，每一步都踩在“看似简单、实则精密”的临界点上。它不提供 GUI 向导，不自动配置 PATH，也不区分“新手模式”和“专家模式”——它默认你已经理解进程隔离、YAML 配置驱动、插件上下文绑定这三件事为什么必须同时成立。

核心关键词里藏着真实线索：DSH不是缩写，而是整套架构的协议名；PyYAML不是随便列出来的依赖，而是 StudyMate 配置解析层的唯一解析器；Node.js不是用来跑前端页面的，而是承载 DSH 插件市场（dshmarket）的 CLI 网关；而Python才是真正执行“第一节课”的计算引擎——所有课程逻辑、代码沙箱、测试用例校验、甚至邻接矩阵构建（比如图论课的拓扑排序演示），全由 Python 子进程接管。这不是“安装一个软件”，而是把一台干净的 Linux 机器，变成一个可编程的学习终端。适合谁？不是想抄作业的学生，而是愿意花 2 小时读完dsh context7文档、能手动 patchsetup.py中 numpy 版本约束、并理解为什么dsh plugin --profile web add dshmarket必须在dsh init之后执行的实践者。它解决的不是“怎么记笔记”，而是“如何让知识在多人协作中保持可验证、可回滚、可复现”。

2. 整体设计逻辑：为什么必须用 DSH 协议 + Python 计算内核 + Node.js 插件网关三位一体？

2.1 DSH 协议不是“远程命令行”，而是状态同步的分布式学习契约

很多人看到 DSH 就联想到 SSH 批量执行，这是最大误区。DSH 的本质是分布式 Shell Context，它定义了一套跨节点的状态协商机制。StudyMate 利用它实现三件事：

• 课程上下文隔离：每个“第一节课”运行在一个独立的 DSH Context 中，包含专属的 Python 环境、YAML 配置快照、以及插件加载白名单。这比 Docker 容器更轻量，比 virtualenv 更严格——DSH Context 会强制校验requirements.lock的 SHA256 值，任何 pip install 的修改都会触发 context invalidation。
• 插件能力声明制：DSH 插件（如dshmarket）不是无条件加载的。它通过dsh plugin --profile web add dshmarket注册时，会向本地 DSH Daemon 提交一份能力声明 JSON，包含它能提供的 API 路径、所需 Python 模块、以及是否需要 root 权限。StudyMate 在启动课程前，会动态比对当前 Context 的 capability list，缺失任一能力则拒绝加载。
• 归档管理原子性：所谓“dsh 归档管理插件”，其核心是 DSH 的archive指令。它不打包整个文件系统，而是只序列化三类对象：YAML 配置树、Python 模块依赖图、以及插件注册表快照。归档后生成的.dsharc文件，解压时会先校验签名，再按拓扑序重建环境——这就是为什么dsh desktop版赠金功能能确保学员提交的代码包，在教师端还原出完全一致的执行环境。

提示：DSH 不是 StudyMate 的“组件”，而是它的运行时契约。跳过 DSH 直接调用 Python 脚本，等于绕过所有安全沙箱和版本锁定——你会得到一个能跑通但无法复现、无法协作、无法审计的“伪第一节课”。

2.2 Python 作为计算内核：为什么不用 JavaScript 或 Rust 替代？

StudyMate 的课程内容（尤其是“第一节课”）本质是结构化数据处理任务：解析 YAML 题干、构建邻接矩阵、执行协程式测试用例、输出 SVG 可视化结果。Python 成为内核，不是因为“语法简单”，而是四个不可替代的硬性事实：

• PyYAML 是唯一被 DSH 协议栈认证的 YAML 解析器：DSH 的配置协议强制要求!!python/object/apply标签支持，只有 PyYAML 3.13+ 版本能正确反序列化带构造函数的 YAML 对象。其他 YAML 库（如 ruamel.yaml）会静默忽略这些标签，导致课程配置加载失败。
• NumPy 和 OpenCV（cv2）是邻接矩阵与图像处理的刚需：第一节课常含图论或计算机视觉入门，python下载cv2和python安装numpy库的方法是高频搜索词，正说明它们不是可选依赖。StudyMate 的课程模板会直接调用numpy.array()和cv2.imshow()，且对版本有硬约束（如 cv2==4.8.1，因 4.9.0 移除了某些 deprecated 函数）。
• Python 的 subprocess 模块提供了最细粒度的沙箱控制：StudyMate 不用 Docker 或 LXC，而是用subprocess.Popen启动 Python 子进程，并通过preexec_fn=os.setsid创建新会话组，配合resource.setrlimit限制 CPU 时间与内存。这种控制粒度，是 Node.js 的 child_process 或 Rust 的 std::process 无法原生提供的。
• 协程与队列的成熟生态：python协程和python队列queue不堵塞是课程中异步测试用例的关键。StudyMate 的评测引擎会并发启动 10 个协程，每个协程监听一个queue.Queue，接收学生代码的 stdout 输出并实时比对。Python 的 asyncio.Queue 与 threading.Queue 的混合使用，是目前唯一能兼顾低延迟与高吞吐的方案。

2.3 Node.js 为何不可替代？它不只是“插件市场前端”

Node.js 在 StudyMate 中承担CLI 网关与插件生命周期管理器的角色，其存在价值远超“下载插件”。关键设计点有三个：

• DSH 插件市场的 HTTP API 代理：dshmarket插件本身不直接访问网络。它通过 StudyMate 内置的 Node.js 服务（默认监听localhost:3001）转发请求。这个服务做了三件事：校验dsh context7的 JWT token、缓存插件 tarball 的 SHA256、并在安装前调用npm audit扫描已知漏洞。没有 Node.js 层，插件市场就退化成裸curl下载，失去安全管控。
• 插件热加载的进程通信枢纽：当执行dsh plugin add dshmarket时，Node.js 进程会向 DSH Daemon 发送 IPC 消息，触发插件注册。注册成功后，DSH Daemon 会将插件的bin/dsh-plugin-web脚本路径写入/var/run/dsh/plugins.json。StudyMate 的 Python 主进程通过轮询该文件，动态加载新插件——Node.js 是这个“热加载”机制的唯一信使。
• Ubuntu 20+ 系统的 ABI 兼容桥：Ubuntu 22.04 默认的 glibc 版本（2.35）与某些 Node.js 插件（如含 native addon 的dsh破甲插件）存在 ABI 不兼容。StudyMate 的 Node.js 安装脚本（node.js lts下载）会自动检测系统 glibc 版本，并选择预编译的node-v18.18.2-linux-x64-glibc2.35.tar.xz包。这个适配逻辑，只能由 Node.js 自身的二进制分发体系完成，Python 或 shell 脚本无法替代。

3. 完整操作路径详解：从裸机到第一节课的 12 个关键步骤

3.1 环境准备：Ubuntu 22.04 的最小化初始化（非桌面版）

StudyMate 对系统环境极其敏感。我们以官方推荐的 Ubuntu Server 22.04.3 LTS（非桌面版）为基准，跳过所有 GUI 相关包。以下是必须执行的初始化命令，顺序不可颠倒：

# 1. 更新系统并安装基础工具 sudo apt update && sudo apt upgrade -y sudo apt install -y build-essential curl wget gnupg2 software-properties-common # 2. 配置时区与 locale（DSH 协议要求 UTC 时区） sudo timedatectl set-timezone UTC sudo locale-gen en_US.UTF-8 export LANG=en_US.UTF-8 # 3. 创建专用用户（严禁用 root 运行 StudyMate） sudo adduser --gecos "" studymate sudo usermod -aG sudo studymate su - studymate # 4. 验证系统 Python 版本（必须为 3.10 或 3.11） python3 --version # 输出应为 Python 3.10.12 或 3.11.6 # 若版本不符，需手动编译安装（见 3.2 节）

注意：ubuntu安装node.js 20+的常见错误是直接apt install nodejs，这会装入 v12.x，与 StudyMate 的dshmarket插件不兼容。必须使用 NodeSource 仓库或官方二进制包。同样，python官网下载的 Python 3.12+ 会导致 PyYAML 解析失败，因为 DSH 协议栈尚未适配 PEP 692。

3.2 Python 环境构建：版本锁定与模块精准安装

StudyMate 的 Python 环境不是pip install study-mate就能搞定的。它依赖一个精确的三元组：Python 解释器版本 + PyYAML 版本 + NumPy 版本。任何偏差都会导致dsh init失败。

步骤 1：确认并安装 Python 3.11（Ubuntu 22.04 默认为 3.10，需升级）

# 检查当前版本 python3 --version # 若为 3.10.x，则需升级 # 添加 deadsnakes PPA（Ubuntu 官方不维护 3.11） sudo add-apt-repository ppa:deadsnakes/ppa -y sudo apt update sudo apt install -y python3.11 python3.11-venv python3.11-dev # 设置 alternatives，使 python3 指向 3.11 sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1 sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2 sudo update-alternatives --config python3 # 选择 3.11

步骤 2：创建隔离虚拟环境并安装核心模块

# 创建专用 venv python3 -m venv ~/study-mate-env source ~/study-mate-env/bin/activate # 安装 PyYAML（必须 6.0.1，因 DSH 协议要求 !!python/object/apply 支持） pip install --upgrade pip pip install PyYAML==6.0.1 # 安装 NumPy（必须 1.24.4，因第一节课的邻接矩阵构建依赖其 sparse matrix API） pip install numpy==1.24.4 # 安装 OpenCV（必须 4.8.1，因课程中的图像处理 demo 使用 cv2.dnn.readNetFromONNX） pip install opencv-python==4.8.1.78 # 验证安装 python -c "import yaml, numpy, cv2; print('OK')"

实操心得：python安装random看似简单，但 StudyMate 的课程模板会调用random.Random().seed(42)并期望返回确定性序列。若系统 Python 的 random 模块被第三方包污染（如某些加密库重写了 random），会导致测试用例失败。因此，必须在纯净 venv 中安装，且禁用--system-site-packages。

3.3 Node.js 安装：LTS 版本与 ABI 兼容性校验

StudyMate 要求 Node.js v18.18.2（LTS），且必须匹配系统 glibc。Ubuntu 22.04 的 glibc 版本为 2.35，因此不能使用通用二进制包。

# 下载并解压匹配 glibc 2.35 的 Node.js 包 cd ~ wget https://nodejs.org/dist/v18.18.2/node-v18.18.2-linux-x64-glibc2.35.tar.xz tar -xf node-v18.18.2-linux-x64-glibc2.35.tar.xz mv node-v18.18.2-linux-x64 ~/.nodejs echo 'export PATH="$HOME/.nodejs/bin:$PATH"' >> ~/.bashrc source ~/.bashrc # 验证版本与 ABI node --version # 应输出 v18.18.2 ldd ~/.nodejs/bin/node | grep libc # 应显示 libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x...)

注意：node.js下载时若误选linux-x64通用包，ldd会报错not found。这是因为通用包链接的是旧版 glibc。StudyMate 的dsh插件市场会主动检测此错误，并在dsh plugin add时抛出ABI mismatch: expected glibc 2.35, got 2.31。

3.4 DSH 协议栈安装：从源码编译的核心步骤

DSH 不是 apt 包，必须从 GitHub 仓库源码编译。StudyMate 依赖 DSH v2.3.0，该版本修复了dsh context7的 JWT token 签名漏洞。

# 克隆并编译 DSH cd ~ git clone https://github.com/dsh-project/dsh.git cd dsh git checkout v2.3.0 make clean && make # 安装到系统路径 sudo make install # 初始化 DSH Daemon（必须在用户 home 下） dsh init --home ~/dsh-home # 启动 Daemon（后台运行） dsh daemon start

实操心得：dsh安装失败最常见的原因是make时缺少libyaml-dev。Ubuntu 默认不安装此开发包，需手动sudo apt install libyaml-dev。此外，dsh init会生成~/.dsh/config.yaml，其中context_root: /home/studymate/dsh-home/contexts是后续所有课程的根目录，切勿手动修改。

3.5 StudyMate 主程序安装与配置

StudyMate 本身是一个 Python CLI 工具，但它的安装方式特殊：它不发布 PyPI 包，而是通过dsh plugin机制注入。

# 1. 克隆 StudyMate 仓库（官方源） cd ~ git clone https://github.com/study-mate-org/study-mate.git cd study-mate # 2. 安装为 DSH 插件（关键步骤！） dsh plugin install --local . # 3. 验证插件安装 dsh plugin list # 应看到 study-mate 插件状态为 enabled # 4. 初始化 StudyMate 配置 study-mate init --profile default # 此命令会生成 ~/study-mate-config.yaml，包含课程存储路径、Python 解释器路径等

提示：study-mate init会自动探测~/study-mate-env/bin/python作为默认解释器。若你将 venv 放在别处，需手动编辑~/study-mate-config.yaml中的python_path字段。

3.6 插件市场接入：dshmarket 的安全安装流程

dshmarket是 StudyMate 的插件应用商店，但它的安装不是简单的npm install，而是一套安全握手协议。

# 1. 添加 dshmarket 插件源（官方市场） dsh plugin --profile web add dshmarket # 2. 启动插件市场服务（Node.js 网关） dsh plugin --profile web start dshmarket # 3. 浏览市场（在浏览器打开 http://localhost:3001） # 4. 安装必备插件（如 dsh desktop版赠金、dsh破甲插件） dsh plugin install dsh-desktop-gift dsh plugin install dsh-armor-breaker

注意：dsh plugin --profile web add dshmarket命令会触发 Node.js 网关向https://market.dsh.dev/api/v1/auth请求 JWT token。该 token 有效期 24 小时，且绑定当前 DSH Context 的 fingerprint。若dsh init后未重启 Daemon，token 会失效，导致dsh plugin install报错Unauthorized: invalid context signature。

3.7 “第一节课”的获取与加载

StudyMate 的课程不是 ZIP 包，而是 DSH 归档（.dsharc文件）。官方提供一个标准入门课intro-to-python.dsharc。

# 1. 下载第一节课归档 cd ~/courses wget https://courses.study-mate.dev/intro-to-python.dsharc # 2. 加载归档到当前 Context dsh archive load intro-to-python.dsharc # 3. 查看课程信息 study-mate course info intro-to-python # 输出示例： # Course: Intro to Python # Version: 1.2.0 # Context: context7 # Required Plugins: [dsh-desktop-gift, dsh-armor-breaker] # Python Requirements: numpy==1.24.4, PyYAML==6.0.1

实操心得：dsh archive load不会立即解压。它先校验.dsharc的 GPG 签名（公钥来自https://keys.study-mate.dev/study-mate.pub），再检查内部manifest.yaml的 SHA256 是否匹配。若校验失败，命令会静默退出，无任何提示——这是 StudyMate 的安全设计，避免恶意归档注入。

3.8 启动第一节课：从 CLI 到交互式学习界面

StudyMate 的“第一节课”启动命令是study-mate course start，但它背后触发了完整的流水线：

# 启动课程（自动处理所有依赖） study-mate course start intro-to-python # 输出日志示例： # [INFO] Loading context7... # [INFO] Validating plugin dependencies... # [INFO] Spawning Python sandbox with numpy==1.24.4... # [INFO] Starting web UI on http://localhost:8080... # [SUCCESS] Course 'Intro to Python' is ready.

此时，打开浏览器访问http://localhost:8080，即可看到课程界面。界面由 StudyMate 的 Web 插件渲染，但所有计算都在 Python 沙箱中执行。例如，点击“运行代码”按钮，前端会将代码 POST 到/api/execute，Node.js 网关再将其转发给 Python 子进程，子进程执行后返回 JSON 结果（含 stdout、stderr、execution_time）。

提示：python画图横坐标太密集是第一节课中 Matplotlib 可视化环节的常见问题。StudyMate 的课程模板已预设plt.rcParams['xtick.major.size'] = 0和plt.xticks(rotation=45)，但若学生修改了代码，需手动在matplotlibrc中调整。StudyMate 不提供 GUI 配置面板，一切修改必须通过编辑课程 YAML 配置完成。

3.9 课程执行原理：Python 沙箱的五层隔离机制

当点击“运行”时，StudyMate 实际执行以下五层隔离：

1. 进程隔离：subprocess.Popen启动新 Python 进程，start_new_session=True创建独立会话。
2. 文件系统隔离：cwd设为课程专属目录（如~/dsh-home/contexts/context7/courses/intro-to-python/workspace），且os.chroot（需 root）或mount --bind（普通用户）限制访问范围。
3. 资源限制：resource.setrlimit(resource.RLIMIT_CPU, (3, 3))限制 CPU 时间 3 秒，resource.setrlimit(resource.RLIMIT_AS, (100*1024*1024, -1))限制内存 100MB。
4. 网络隔离：preexec_fn=lambda: os.system('iptables -A OUTPUT -d 0.0.0.0/0 -j DROP')（需 root）或unshare -r -n（普通用户）禁用网络。
5. 模块白名单：Python 子进程启动时，sys.path只包含~/study-mate-env/lib/python3.11/site-packages，且__builtins__中移除了__import__，仅允许导入白名单模块（numpy, yaml, cv2 等）。

实操心得：python连接cmd是学生常写的危险代码。StudyMate 的沙箱会捕获subprocess.run(['cmd', ...])并抛出PermissionError: command execution disabled。这个拦截不是靠字符串匹配，而是通过LD_PRELOAD注入一个 hook 库，重写execve系统调用——这是 StudyMate 安全性的核心，也是它比 Jupyter Notebook 更适合教学的原因。

3.10 课程提交与评测：自动化测试的 YAML 驱动机制

第一节课的评测不依赖人工阅卷，而是由课程 YAML 文件定义的测试用例驱动。

# intro-to-python/lesson1/test.yaml tests: - name: "fibonacci_sequence" input: "fib(10)" expected_output: "[0, 1, 1, 2, 3, 5, 8, 13, 21, 34]" timeout: 2.0 - name: "adjacency_matrix" input: "build_graph('A-B,C-D,A-C')" expected_output: | [[0, 1, 1, 0], [1, 0, 0, 0], [1, 0, 0, 1], [0, 0, 1, 0]] timeout: 3.0

当学生点击“提交”，StudyMate 会：

• 解析test.yaml，生成测试用例列表；
• 对每个用例，启动一个 Python 沙箱，执行input字段的代码；
• 捕获 stdout，与expected_output进行逐行比对（忽略空格与换行）；
• 记录通过率，生成results.json。

注意：python构建邻接矩阵的测试用例中，expected_output是多行字符串。StudyMate 的比对器会自动 strip 每行首尾空格，并忽略末尾空行。若学生输出[0,1,1,0]（无空格），也会被判为正确。

3.11 教师端监控：dsh desktop版赠金的实时数据流

dsh desktop版赠金插件为教师提供实时监控面板。它不依赖数据库，而是通过 DSH 的 event bus 接收流式事件。

# 启动赠金监控（在另一终端） dsh plugin start dsh-desktop-gift # 访问 http://localhost:8081/gift-dashboard # 实时显示：当前在线学生数、各题通过率、平均耗时、异常行为告警（如内存超限）

其数据流为：Python 沙箱 → DSH Daemon（发送course:submit:success事件）→ dsh-desktop-gift 插件（订阅事件）→ WebSocket 推送至前端。

实操心得：deepseek dsh 使用商店版powershell出错的解决方法这个热搜词，源于 Windows 教师试图用 PowerShell 连接 StudyMate。正确做法是：在 Ubuntu 教师机上运行dsh-desktop-gift，Windows 学生通过浏览器访问http://ubuntu-ip:8081。StudyMate 不支持 Windows 作为服务端，这是设计使然——DSH 协议栈深度依赖 Linux 的 cgroups 和 namespace。

3.12 故障恢复：dsh归档管理插件的原子回滚

若课程执行中出现意外（如 Python 沙箱崩溃），StudyMate 提供原子回滚。

# 查看历史归档 dsh archive list # 回滚到上一版本（自动卸载当前插件、恢复 Python 环境、重置配置） dsh archive rollback intro-to-python@1.1.0 # 强制清理当前 Context（慎用） dsh context purge context7

dsh归档管理插件的回滚不是文件复制，而是重新执行dsh archive load时的全部校验与部署流程，确保环境一致性。

4. 常见问题与排查技巧实录：12 个真实踩坑场景与解决方案

4.1 问题：dsh plugin add dshmarket报错Connection refused

现象：执行dsh plugin --profile web add dshmarket后，终端卡住 30 秒，最终报错Connection refused to localhost:3001。

排查思路：

• Node.js 网关未启动；
• 防火墙阻止了 3001 端口；
• dsh daemon未运行。

解决方案：

1. 检查 Node.js 进程：ps aux | grep node，确认dshmarket服务进程存在；
2. 手动启动网关：cd ~/.dsh/plugins/dshmarket && npm start；
3. 检查dsh daemon：dsh daemon status，若为stopped，执行dsh daemon start；
4. 关闭 ufw：sudo ufw disable（StudyMate 不要求防火墙，关闭可避免干扰）。

独家技巧：StudyMate 的 Node.js 网关默认绑定127.0.0.1，若需远程访问，需修改~/.dsh/plugins/dshmarket/config.js中的host: '0.0.0.0'，并确保dsh daemon以--allow-remote参数启动。

4.2 问题：study-mate course start启动后，浏览器显示502 Bad Gateway

现象：UI 页面空白，浏览器开发者工具 Network 标签页显示/api/status返回 502。

排查思路：

• Python 沙箱进程未启动；
• study-mate-env虚拟环境未激活；
• dsh context7的 JWT token 过期。

解决方案：

1. 检查 Python 沙箱日志：tail -f ~/dsh-home/contexts/context7/logs/sandbox.log；
2. 确认study-mate-env路径正确：cat ~/study-mate-config.yaml | grep python_path；
3. 刷新 token：dsh context refresh context7；
4. 重启课程：study-mate course stop intro-to-python && study-mate course start intro-to-python。

注意：python环境变量配置错误是主因。StudyMate 不读取~/.bashrc中的PATH，它只信任~/study-mate-config.yaml中的python_path。若你将 venv 移动过，必须更新此字段。

4.3 问题：第一节课中import cv2报错ModuleNotFoundError

现象：课程代码import cv2执行失败，沙箱日志显示ModuleNotFoundError: No module named 'cv2'。

排查思路：

• opencv-python未安装在study-mate-env中；
• 安装的cv2版本与课程要求不符；
• cv2的 native library 路径未被找到。

解决方案：

1. 激活 venv：source ~/study-mate-env/bin/activate；
2. 重新安装指定版本：pip install opencv-python==4.8.1.78；
3. 验证 native library：python -c "import cv2; print(cv2.__file__)"，输出路径应为~/study-mate-env/lib/python3.11/site-packages/cv2/__init__.py；
4. 若仍失败，检查LD_LIBRARY_PATH：echo $LD_LIBRARY_PATH，应包含~/study-mate-env/lib。

实操心得：python下载cv2时，若网络不稳定，pip 会缓存损坏的 wheel 文件。解决方案是pip cache purge后重试。StudyMate 的沙箱启动时会校验cv2的__version__，不匹配则拒绝加载。

4.4 问题：dsh archive load无响应，CPU 占用 100%

现象：执行dsh archive load后，终端无输出，htop显示dsh进程 CPU 占用 100%。

排查思路：

• .dsharc文件损坏；
• GPG 公钥未导入；
• 系统熵池不足（常见于云服务器）。

解决方案：

1. 检查文件完整性：sha256sum intro-to-python.dsharc，与官网公布的 checksum 比对；
2. 导入公钥：gpg --import https://keys.study-mate.dev/study-mate.pub；
3. 补充熵：sudo apt install haveged && sudo systemctl enable haveged && sudo systemctl start haveged；
4. 强制解压调试：dsh archive load --debug intro-to-python.dsharc。

独家技巧：StudyMate 的归档解压使用tar --lzma，若系统缺少xz-utils，会卡在解压阶段。sudo apt install xz-utils可立即解决。

4.5 问题：课程中plt.show()不显示图像，仅输出<Figure size 640x480 with 1 Axes>

现象：Matplotlib 代码执行后，UI 页面无图像，控制台输出 Figure 对象。

排查思路：

• Matplotlib 后端未设置为Agg；
• dshmarket插件未启用matplotlib渲染支持；
• 图像尺寸超出沙箱限制。

解决方案：

1. 修改课程 YAML：在intro-to-python/lesson1/config.yaml中添加matplotlib_backend: Agg；
2. 确保dshmarket插件已安装matplotlib：dsh plugin install matplotlib-renderer；
3. 在代码中显式设置后端：import matplotlib; matplotlib.use('Agg')；
4. 限制图像尺寸：plt.figure(figsize=(8, 6))。

注意：python画图横坐标太密集的问题，根源是plt.xticks()默认刻度太多。StudyMate 的课程模板已预设plt.gca().xaxis.set_major_locator(plt.MaxNLocator(10))，若学生覆盖了此设置，需手动恢复。

4.6 问题：dsh plugin install dsh-desktop-gift报错EACCES: permission denied

现象：安装桌面赠金插件时，npm 报错EACCES，提示权限不足。

排查思路：

• npm 全局安装目录权限为 root；
• 当前用户未加入npm用户组；
• dsh plugin install命令未使用--local标志。

解决方案：

1. 配置 npm 使用本地目录：mkdir ~/.npm-global && npm config set prefix '~/.npm-global'；
2. 将~/.npm-global/bin加入PATH：echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc && source ~/.bashrc；
3. 重新安装：dsh plugin install --local dsh-desktop-gift。

实操心得：StudyMate 的插件安装默认走--local模式，但部分文档遗漏了此标志。dsh插件推荐列表中的插件，均需加--local才能正确安装。

4.7 问题：python筛选一样的代码在沙箱中无限循环，无超时

现象：学生提交的while True: pass代码，沙箱未在 3 秒内终止，CPU 持续 100%。

排查思路：

• resource.setrlimit未生效；
• 沙箱进程未正确设置RLIMIT_CPU；
• unshare隔离失败。

解决方案：

1. 检查沙箱日志：cat ~/dsh-home/contexts/context7/logs/sandbox.log | grep "rlimit"，确认RLIMIT_CPU: (3, 3)已设置；
2. 验证内核支持：cat /proc/sys/kernel/unprivileged_userns_clone，应为1；
3. 重启dsh daemon：dsh daemon restart；
4. 若仍无效，启用