v1.0.0

我们很高兴的宣布 KWDB Playground v1.0.0 版本正式发布！🎉🎉🎉 KWDB Playground 是一款专为学习和演示 KWDB 开源多模数据库而设计的轻量级交互式课程平台，它的核心价值只有一句话：打开浏览器，即刻开始学习。

v1.0.0 全貌一览

功能维度	当前能力
环境隔离	基于 Docker 容器，每用户独立沙箱，用完即焚
终端类型	Shell / SQL / Code 三种模式，覆盖主流学习场景
多语言支持	Python、Bash、Java 代码实时执行
进度管理	容器状态暂停与恢复，支持跨会话续学
镜像加速	多源智能选择，自动连通性测试，国内环境友好
在线升级	导航栏版本提示，一键升级，无需手动替换文件
环境诊断	可视化检查面板，覆盖 Docker、端口、镜像、课程加载
新手引导	交互式引导教程，可随时重新触发
安装方式	一键脚本 / Homebrew / Docker Compose / 手动下载

新增 Code 终端

Playground 最核心的交互界面是终端，而终端能力的演进，也最能说明这个平台在课程覆盖面上的野心。

之前，平台支持两种终端模式：

• Shell 终端：适合命令行操作、环境配置、包管理类课程
• SQL 终端：适合数据库实操、查询练习、建模演示类课程

这两种模式已经能覆盖大多数数据库相关课程的需求，但有一类场景始终缺失——当课程需要演示如何通过代码访问数据库、调用 SDK、处理查询结果时，用户只能在课程页面看文字描述，然后自己在本地搭环境运行。这个跳转本身就打断了学习的连贯性。

新版本引入了第三种模式：Code 终端。

Code 终端支持在课程页面内直接编写并运行 Python、Bash、Java 代码，执行结果实时呈现，无需切换任何窗口。这一改变的意义，远不止"多了几种语言"。它真正打通了从"数据库操作演示"到"应用开发实践"的完整链路——用户现在可以在同一个课程页面内，完成数据建模、数据写入、SDK 调用、结果处理的全流程。

容器状态暂停与恢复

用户可以随时点击"暂停容器"，将当前环境的完整状态保存下来；下次重新进入课程时，环境会从上次离开的节点无缝恢复，之前执行过的命令、创建的数据、配置的参数，一切都还在。跨会话续学，在 Playground 里终于成为现实。

多镜像源切换

新版本引入了多镜像源智能选择机制来正面解决这个问题。平台在启动课程前会自动对 Docker Hub、ghcr.io、阿里云镜像等多个来源进行连通性检测，用户可以根据偏好设置镜像源，该设置会持久化保存，避免每次重复配置。

诊断、升级体验增强

环境诊断面板: 用户只需点击导航栏的"环境检查"按钮，就能看到一个可视化的诊断看板，覆盖 Docker 服务状态、镜像源连通性、端口占用情况、课程加载状态等关键指标。过去需要打开终端、执行命令才能排查的问题，现在几秒钟就能定位。

在线升级: 当有新版本发布时，导航栏会出现"有更新"的提示，点击即可触发一键升级流程，全程在页面内完成。过去手动下载、替换二进制文件的繁琐步骤，被彻底简化掉了。

交互式引导

用户第一次访问各主要页面时，可以通过导航栏的帮助按钮启动一段步骤式的引导流程，依次了解课程选择、终端操作、进度管理等核心功能。引导可以随时中止，也可以随时重新触发，不存在"只能看一次"的限制。

安装体验增强

随着平台功能的完善，安装方式也经历了系统性的梳理与扩充。v1.0.0 提供四种安装路径，覆盖不同场景和用户习惯：

方式一：一键安装脚本（macOS / Linux / Windows，推荐首选）

方式二：Homebrew（macOS 用户）

方式三：Docker Compose

方式四：手动下载二进制

页面样式重构

早期版本的 Playground 在 UI 上更像一个功能原型——够用，但不够精致。页面布局以信息展示为主，交互反馈偏弱，整体风格也缺乏统一的设计语言。随着课程内容和功能模块的不断增加，原有的界面开始显得拥挤，信息层级也变得模糊。

这次重构从几个方向入手：

布局与信息层级的重新梳理。 课程列表页、课程详情页和终端交互区域的空间分配做了重新规划。课程卡片的排版更加清晰，关键操作入口的视觉权重得到强化，减少了用户在页面上"找按钮"的时间成本。

导航栏的整合与统一。 环境检查、在线升级提示、帮助引导等功能入口被整合进统一的顶部导航，既减少了页面上的零散控件，也让这些功能更容易被发现和使用。

交互状态的细节打磨。 容器启动中、镜像拉取进度、代码执行等待等中间状态，在新版本中都有了更明确的视觉反馈。用户不再需要盯着一个静止的页面猜测"系统是否还在工作"。