![]()
各位社区小伙伴：
历经三个月对于先行版的升级，我们很高兴地宣布：KaiwuDB 社区（即KWDB）Playground v1.0.0 版本正式发布！🎉🎉🎉
KWDB Playground 是一款专为学习和演示 KaiwuDB 社区版 KWDB 开源多模数据库而设计的轻量级交互式课程平台，它的核心价值只有一句话：打开浏览器，即刻开始学习。
过去，想要上手体验 KWDB用户往往要先闯过一道"环境关"------安装 Docker、配置网络、准备数据集等等，每一步都可能成为劝退的理由。Playground 的出现彻底改变了这一局面：平台基于 Docker 容器技术，为每位用户按需分配完全隔离的沙箱环境，随开随用、用完即焚，将原本高耸的准入门槛压至近乎为零。
安装体验：多种方式，按需选择
![]()
随着平台功能的完善，安装方式也经历了系统性的梳理与扩充。Playground v1.0.0 提供四种安装路径，覆盖不同场景和用户习惯：
方式一：一键安装脚本（macOS / Linux / Windows，推荐首选）
# 安装最新版本
curl -fsSL https://kwdb.tech/playground.sh * bash
# 安装指定版本，并指定下载源
curl -fsSL https://kwdb.tech/playground.sh * bash -s -- --version v1.0.0 --source atomgit
--source 参数支持 github、atomgit 和 auto（默认），后者在 GitHub 不可达时自动回退到 AtomGit，为网络受限的企业内网环境提供了可靠的备选通道。
方式二：Homebrew（macOS 用户）
brew tap kwdb/tap
brew install kwdb-playground
kwdb-playground start
方式三：Docker Compose
git clone https://github.com/kwdb/playground.git
cd playground
docker compose -f docker/playground/docker-compose.yml up -d
方式四：手动下载二进制
在 GitHub Releases 或 **AtomGit Releases **页面获取适合你平台的预编译版本，授权后放入 PATH 即可运行。
• GitHub Releases：https://github.com/kwdb/playground/releases
• AtomGit Releases：https://atomgit.com/kwdb/playground/releases
无论选择哪种方式，启动后访问 http://localhost:3006 即可进入课程列表，开始学习。
终端能力：从两种模式到三种模式
Playground 最核心的交互界面是终端，而终端能力的演进，也最能说明这个平台在课程覆盖面上的野心。
在 v0.X 先行版时，平台支持两种终端模式：
• Shell 终端：适合命令行操作、环境配置、包管理类课程
• SQL 终端：适合数据库实操、查询练习、建模演示类课程
这两种模式已经能覆盖大多数数据库相关课程的需求，但有一类场景始终缺失------课程并不能很好的演示如何通过代码访问数据库、调用 SDK、处理查询结果等开发者更关心的内容。
新版本引入了第三种模式：Code 终端。
Code 终端支持在课程页面内直接编写并运行 Python、Bash、Java 代码，执行结果实时呈现，无需切换任何窗口。这一改变的意义，远不止"多了几种语言"。它真正打通了从"数据库操作演示"到"应用开发实践"的完整链路------用户现在可以在同一个课程页面内，完成数据建模、数据写入、SDK 调用、结果处理的全流程。
在浏览器里完成数据库应用开发，这是 Playground 在课程场景上迈出的关键一步。
![]()
学习体验：进度不再从零开始
对于时长较短的入门课程，用完即焚的容器机制没有任何问题。但当课程涉及较复杂的实战场景，动辄需要几十分钟甚至跨天完成时，一个根本性的缺陷就会暴露出来：关闭页面，所有进度清零。
新版本为此引入了容器状态暂停与恢复机制。用户可以随时点击"暂停容器"，将当前环境的完整状态保存下来；下次重新进入课程时，环境会从上次离开的节点无缝恢复，之前执行过的命令、创建的数据、配置的参数，一切都还在。跨会话续学，在 Playground 里终于成为现实。
![]()
网络体验：国内环境下的镜像加速
以往课程体验的另一个隐患，是镜像拉取速度。每次启动课程环境时，Playground 都需要从镜像仓库拉取对应的 Docker 镜像。在国内网络环境下，如果直连 Docker Hub，等待时间较长且可能失败，严重影响学习体验。
新版本引入了多镜像源智能选择 机制来正面解决这个问题。平台在启动课程前会自动对 Docker Hub、ghcr.io、阿里云镜像等多个来源进行连通性检测，用户可以根据偏好设置镜像源，该设置会持久化保存，避免每次重复配置。
![]()
运维体验：诊断、升级，都在页面内完成
一个面向广泛用户群体的平台，必须正视这样一个现实：并非每个用户都有能力在遇到问题时自行排查。新版本专门为此增加了两项面向运维层面的能力，而且都遵循同一个设计原则------不离开浏览器，就地解决。
环境诊断面板是其中之一。用户只需点击导航栏的"环境检查"按钮，就能看到一个可视化的诊断看板，覆盖 Docker 服务状态、镜像源连通性、端口占用情况、课程加载状态等关键指标。过去需要打开终端、执行命令才能排查的问题，现在几秒钟就能定位。
在线升级是另一项。当有新版本发布时，导航栏会出现"有更新"的提示，点击即可触发一键升级流程，全程在页面内完成。过去手动下载、替换二进制文件的繁琐步骤，被彻底简化掉了。
![]()
![]()
![]()
上手体验：第一次使用不再需要摸索
功能再强大，如果用户第一次打开不知道从哪里开始，也会流失。新版本为此加入了交互式引导教程。
用户第一次访问各主要页面时，可以通过导航栏的帮助按钮启动一段步骤式的引导流程，依次了解课程选择、终端操作、进度管理等核心功能。引导可以随时中止，也可以随时重新触发，不存在"只能看一次"的限制。
![]()
页面样式：一次从里到外的 UI 重构
功能层面的积累之外，v1.0.0 还带来了一次较为彻底的视觉与交互重构。
早期版本的 Playground 在 UI 上更像一个功能原型------够用，但不够精致。页面布局以信息展示为主，交互反馈偏弱，整体风格也缺乏统一的设计语言。随着课程内容和功能模块的不断增加，原有的界面开始显得拥挤，信息层级也变得模糊。
这次重构从几个方向入手：
• 布局与信息层级的重新梳理。课程列表页、课程详情页和终端交互区域的空间分配做了重新规划。课程卡片的排版更加清晰，关键操作入口的视觉权重得到强化，减少了用户在页面上"找按钮"的时间成本。
• 导航栏的整合与统一。环境检查、在线升级提示、帮助引导等功能入口被整合进统一的顶部导航，既减少了页面上的零散控件，也让这些功能更容易被发现和使用。
• 交互状态的细节打磨。容器启动中、镜像拉取进度、代码执行等待等中间状态，在新版本中都有了更明确的视觉反馈。用户不再需要盯着一个静止的页面猜测"系统是否还在工作"。
这些改动不会出现在任何功能列表里，但它们共同决定了用户每次打开 Playground 时的第一印象，以及在平台上停留时的整体舒适度。
Playground v1.0.0 功能全貌一览
![]()
写在最后
在v1.0.0中，我们用镜像加速解决了网络问题，用进度保存解决了续学问题，用环境诊断解决了排障问题，用在线升级解决了维护问题，用引导教程解决了上手问题，用 Code 终端解决了场景边界问题。每一项更新背后，都是一个真实存在的摩擦点被消除掉的努力。
我们所有的改动并不是在堆砌功能列表，而是在沿着同一条线索推进------让更多人能用，让会用的人用得更好，让出了问题的人能自己解决。
在这里，感谢所有使用了 Playground 并给我们提出反馈的社区伙伴。如果在新版本的使用中，你有任何问题或建议，欢迎前往 GitHub/AtomGit 提交 Issue 或加入社区参与讨论。
开源仓库地址：
• Gitee：https://gitee.com/kwdb/kwdb
• Github：https://github.com/kwdb/kwdb
• Atomgit：https://atomgit.com/kwdb/kwdb
官网地址：
• https://www.kaiwudb.com/
