Fix current quests (#144)

Bumps [tar](https://github.com/isaacs/node-tar) from 6.2.0 to 6.2.1.
- [Release notes](https://github.com/isaacs/node-tar/releases)
- [Changelog](https://github.com/isaacs/node-tar/blob/main/CHANGELOG.md)
- [Commits](https://github.com/isaacs/node-tar/compare/v6.2.0...v6.2.1)

---
updated-dependencies:
- dependency-name: tar
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

.github/workflows/ci-checks.yml

@@ -35,23 +35,3 @@ jobs:
 
       - name: Test
         run: yarn test
-
-  e2e:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v3
-
-      - name: Build Test Environment, Stage 1
-        run: docker-compose -f docker-compose.testing.yml build base backend app-test cypress
-
-      - name: Build Test Quests
-        run: docker-compose -f docker-compose.testing.yml run --rm backend yarn build:quests
-
-      - name: Run Cypress Tests
-        env:
-          GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
-          GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
-          GITHUB_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
-          GITHUB_CLIENT_SECRET: ${{ secrets.GH_CLIENT_SECRET }}
-        run: docker-compose -f docker-compose.testing.yml run cypress

.github/workflows/e2e.yml

@@ -0,0 +1,24 @@
+name: E2E Tests
+
+on: [push, pull_request]
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Build Test Environment, Stage 1
+        run: docker-compose -f docker-compose.testing.yml build base backend app-test cypress
+
+      - name: Build Test Quests
+        run: docker-compose -f docker-compose.testing.yml run --rm backend yarn build:quests
+
+      - name: Run Cypress Tests
+        env:
+          GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
+          GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
+          GITHUB_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
+          GITHUB_CLIENT_SECRET: ${{ secrets.GH_CLIENT_SECRET }}
+        run: docker-compose -f docker-compose.testing.yml run cypress

README.md

@@ -19,7 +19,7 @@
 
 Run mongoDB first:
 
-    docker compose -f docker-compose.dev.yml up -d db
+    docker compose up -d
 
 The db will automatically restarts by Docker.
 

app/package.json

@@ -6,6 +6,7 @@
     "dev": "vite",
     "dev:docker": "API_TARGET=http://backend:3000 vite",
     "build": "vue-tsc -b && vite build",
+    "type-check": "vue-tsc -b",
     "preview": "vite preview"
   },
   "dependencies": {
@@ -16,13 +17,14 @@
     "@fortawesome/vue-fontawesome": "^3.0.3",
     "@linux-odyssey/constants": "*",
     "@linux-odyssey/file-graph": "*",
-    "@linux-odyssey/utils": "*",
     "@linux-odyssey/models": "*",
+    "@linux-odyssey/utils": "*",
     "@types/dompurify": "^3.0.5",
     "axios": "^1.6.0",
     "dompurify": "^3.0.6",
     "echarts": "^5.4.3",
     "marked": "^10.0.0",
+    "pinia": "^2.1.7",
     "socket.io-client": "^4.7.1",
     "validator": "^13.11.0",
     "vue": "^3.3.4",

app/src/components/AuthForm.vue

@@ -83,6 +83,16 @@ const handleChange = () => {
     errorMessage.value = 'Something went wrong'
   }
 }
+
+const registerGuest = async () => {
+  try {
+    await api.post('/auth/register-guest')
+    router.push({ name: 'map' })
+  } catch (err) {
+    console.error(err)
+    toast.error('Something went wrong.')
+  }
+}
 </script>
 <template>
   <!-- login page -->
@@ -219,6 +229,13 @@ const handleChange = () => {
           </RouterLink></span
         >
       </p>
+      <button
+        id="register-guest"
+        class="rounded-lg py-2 mt-3 bg-bg-primary text-text-secondary w-full border-text-secondary border-2"
+        @click="registerGuest()"
+      >
+        以訪客身分繼續
+      </button>
     </form>
   </div>
 </template>

app/src/components/GameHeaderPart.vue

@@ -1,142 +0,0 @@
-<script setup lang="ts">
-import { defineProps, onMounted } from 'vue'
-import { useRouter } from 'vue-router'
-import { useToast } from 'vue-toastification'
-import { logout } from '../utils/auth'
-import { bugReportUrl, surveyUrl } from '../config'
-import { reset } from '../store/session'
-import userProfileStore, {
-  loadUserProfile,
-  resetUserProfile,
-} from '../store/userProfile'
-
-const router = useRouter()
-
-const toast = useToast()
-
-const handleLogout = async () => {
-  try {
-    await logout()
-    resetUserProfile()
-    reset()
-    router.push({ name: 'login' })
-  } catch (err) {
-    toast.error('登出失敗')
-    console.error(err)
-  }
-}
-
-defineProps({
-  title: {
-    type: String,
-    required: false,
-  },
-})
-
-onMounted(async () => {
-  try {
-    await loadUserProfile()
-  } catch (err) {
-    console.error(err)
-    toast.error('無法讀取使用者資料')
-  }
-})
-</script>
-
-<template>
-  <div id="header" class="bg-bg-secondary content-center h-full w-full p-1">
-    <div class="h-full flex items-center justify-center mx-3">
-      <div class="flex items-center gap-3">
-        <!-- <button id="stream" class="flex items-center h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'bars']"
-            class="text-text-primary h-full w-full"
-          />
-        </button>
-        <button id="backward" class="flex items-center h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'arrow-left']"
-            class="text-border h-full w-full"
-          />
-        </button> -->
-        <img src="../img/icon_totem.svg" class="h-5" />
-        <button
-          id="GameTitle"
-          class="text-text-primary inline-block font-bold whitespace-nowrap"
-          style="font-size: 2vh"
-        >
-          Linux Odyssey
-        </button>
-        <p
-          id="QuestTitle"
-          class="text-text inline-block font-bold whitespace-nowrap"
-          style="font-size: 2vh"
-        >
-          {{ title }}
-        </p>
-      </div>
-      <div class="h-full w-full flex gap-3 items-center justify-end">
-        <!-- <button id="warning" class="flex items-center h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'triangle-exclamation']"
-            class="text-text-primary h-full w-full"
-          />
-        </button>
-        <button id="setting" class="flex items-center h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'gear']"
-            class="text-text-primary h-full w-full"
-          />
-        </button>
-        <button id="fullscreen" class="flex items-center h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'expand']"
-            class="text-text-primary h-full w-full"
-          />
-        </button> -->
-        <p
-          id="UsernameText"
-          class="text-text inline-block whitespace-nowrap"
-          style="font-size: 2vh"
-        >
-          {{ userProfileStore.username }}
-        </p>
-        <a title="Survey" :href="surveyUrl" target="_blank" class="h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'file-invoice']"
-            class="text-text-primary h-full w-full"
-          />
-        </a>
-        <RouterLink title="LeaderBoard" to="/leaderboard" class="h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'trophy']"
-            class="text-text-primary h-full w-full"
-          />
-        </RouterLink>
-        <RouterLink title="Map" to="/map" class="h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'map']"
-            class="text-text-primary h-full w-full"
-          />
-        </RouterLink>
-        <a
-          title="Bug Report"
-          :href="bugReportUrl"
-          target="_blank"
-          class="h-5 w-5"
-        >
-          <font-awesome-icon
-            :icon="['fas', 'bug']"
-            class="text-text-primary h-full w-full"
-          />
-        </a>
-        <button title="Sign Out" @click="handleLogout" class="h-5 w-5">
-          <font-awesome-icon
-            :icon="['fas', 'arrow-right-from-bracket']"
-            class="text-text-primary h-full w-full"
-          />
-        </button>
-      </div>
-    </div>
-  </div>
-</template>

app/src/components/MarkdownText.vue

@@ -25,6 +25,9 @@ const html = computed(() => {
   line-height: 1;
 }
 
+.markdown-content :deep(p) {
+  line-height: 1.5;
+}
 .markdown-content :deep(ol) {
   list-style: decimal;
   padding-left: 1em;

app/src/components/QuestMap.vue

@@ -14,7 +14,9 @@ import {
 import { DAG } from '@linux-odyssey/utils'
 import api from '../utils/api'
 import { NodeImage } from '../img/svg.js'
+import useUserProfile from '../store/userProfile'
 
+const store = useUserProfile()
 const marginX = 500
 const marginY = 300
 const chartContainer = ref(null)
@@ -40,16 +42,6 @@ async function getQuests() {
   }
 }
 
-async function getProgress() {
-  try {
-    const res = await api.get('/users/me')
-    return res.data.progress
-  } catch (err) {
-    console.error(err)
-    throw err
-  }
-}
-
 const genOption = (nodes: any, edges: any) => ({
   renderer: 'svg',
   tooltip: {},
@@ -162,9 +154,9 @@ function initChart(option: any) {
 }
 
 onMounted(async () => {
+  await store.loadUserProfile()
   const quests = await getQuests()
-  const progress = await getProgress()
-  const option = getOption(quests, progress)
+  const option = getOption(quests, store.progress)
   initChart(option)
 })
 </script>

app/src/components/game/ControlPalette.vue

@@ -1,13 +1,14 @@
 <script setup lang="ts">
 import { useRouter } from 'vue-router'
 import { useToast } from 'vue-toastification'
-import { createSession } from '../../store/session'
+import useSession from '../../store/session'
 import { surveyUrl } from '../../config'
 
 const router = useRouter()
+const sessionStore = useSession()
 const reset = async () => {
   console.log('resetting...')
-  await createSession()
+  await sessionStore.createSession()
 }
 const continuePlay = async () => {
   try {
@@ -29,7 +30,7 @@ const continuePlay = async () => {
           :icon="['fas', 'file-invoice']"
           class="text-text-primary px-1"
         />
-        <p class="text-text-primary inline ml-1 hidden md:flex">問卷</p>
+        <p class="text-text-primary inline ml-1 md:flex">問卷</p>
       </a>
     </button>
     <button disabled id="solution" class="bg-bg-disabled rounded-lg p-2">
@@ -37,7 +38,7 @@ const continuePlay = async () => {
         :icon="['far', 'circle-question']"
         class="text-text-disabled px-1"
       />
-      <p class="text-text-disabled inline ml-1 hidden md:flex">解答</p>
+      <p class="text-text-disabled inline ml-1 md:flex">解答</p>
     </button>
     <button id="reset" class="bg-bg-secondary rounded-lg p-2" @click="reset">
       <font-awesome-icon

app/src/components/game/DescriptionPart.vue

@@ -1,16 +1,21 @@
 <script setup lang="ts">
-import { ref, watch } from 'vue'
-import sessionStore from '../../store/session'
+import { computed, ref, watch } from 'vue'
+import useSession from '../../store/session'
 import MarkdownText from '../MarkdownText.vue'
 
+const sessionStore = useSession()
 const current = ref(-1)
-watch(
-  () => sessionStore.session.hints,
-  (hints) => {
-    current.value = hints.length - 1
-  },
-  { deep: true }
-)
+const length = computed(() => {
+  return sessionStore.session?.responses.length ?? 0
+})
+
+const disabled = computed(() => {
+  return current.value === length.value - 1
+})
+
+watch(length, () => {
+  current.value = length.value - 1
+})
 
 const left = () => {
   if (current.value > 0) {
@@ -19,7 +24,7 @@ const left = () => {
 }
 
 const right = () => {
-  if (current.value < sessionStore.session.hints.length - 1) {
+  if (current.value < length.value - 1) {
     current.value += 1
   }
 }
@@ -32,7 +37,7 @@ const right = () => {
         :icon="['far', 'lightbulb']"
         class="text-yellow-200 p-2 content-center"
       />
-      <h1 class="inline text-text w-1/2 font-xl p-2 m-1">提示</h1>
+      <h1 class="inline text-text w-1/2 font-xl p-2 m-1">說明</h1>
       <div v-if="current !== -1" class="flex w-full justify-end items-end">
         <button
           class="p-2 m-1 w-1/8"
@@ -49,13 +54,13 @@ const right = () => {
         <p class="inline text-text font-xl w-1/14 p-2 m-1">{{ current + 1 }}</p>
         <p class="inline text-text font-xl w-1/14 p-2 m-1">/</p>
         <p class="inline text-text font-xl w-1/14 p-2 m-1">
-          {{ sessionStore.session.hints.length }}
+          {{ length }}
         </p>
         <button
           class="p-2 m-1 w-1/8"
           id="Rbutton"
           @click="right"
-          :disabled="current === sessionStore.session.hints.length - 1"
+          :disabled="disabled"
         >
           <font-awesome-icon :icon="['fas', 'arrow-right']" class="text-text" />
         </button>
@@ -64,7 +69,7 @@ const right = () => {
     <div id="hint" class="bg-bg p-8 overflow-y-auto">
       <ul>
         <li
-          v-for="response in sessionStore.session.responses[current]"
+          v-for="response in sessionStore.session?.responses[current]"
           :key="response.type"
           class="text-text font-xl whitespace-pre-wrap"
         >
@@ -73,7 +78,7 @@ const right = () => {
           </div>
         </li>
         <li
-          v-for="hint in sessionStore.session.hints[current]"
+          v-for="hint in sessionStore.session?.hints[current]"
           :key="hint"
           class="text-text-primary font-xl whitespace-pre-wrap"
         >

app/src/components/game/QuestPart.vue

@@ -1,11 +1,12 @@
 <script setup lang="ts">
 import { computed } from 'vue'
 import MarkdownText from '../MarkdownText.vue'
-import sessionStore from '../../store/session'
+import useSession from '../../store/session'
 import { Task } from '../../types'
 
+const sessionStore = useSession()
 const tasks = computed(() => {
-  return sessionStore.session.tasks.map((task: Task) => {
+  return sessionStore.session?.tasks.map((task: Task) => {
     const prefix = task.completed ? '✓' : '➤'
     const color = task.completed ? 'text-text-primary' : 'text-text'
     return {

app/src/components/game/StartButton.vue

@@ -0,0 +1,37 @@
+<script setup lang="ts">
+import { useToast } from 'vue-toastification'
+import { computed } from 'vue'
+import useSession from '../../store/session'
+
+const toast = useToast()
+const sessionStore = useSession()
+
+const showCover = computed(() => sessionStore.session === null)
+
+const startSession = async () => {
+  try {
+    await sessionStore.createSession()
+  } catch (err: any) {
+    console.error(err)
+    toast.error(err.message)
+  }
+}
+</script>
+<template>
+  <div
+    v-if="showCover"
+    class="bg-bg-secondary h-full w-1/2 fixed bg-opacity-50 flex justify-center items-center"
+  >
+    <button
+      id="start"
+      class="bg-bg-secondary rounded-lg p-3"
+      @click="startSession"
+    >
+      <font-awesome-icon
+        :icon="['fas', 'play']"
+        class="text-text-primary h-full px-3"
+      />
+      <p class="text-text-primary inline ml-1 md:flex">開始</p>
+    </button>
+  </div>
+</template>

app/src/components/game/TreeChart.vue

@@ -1,6 +1,8 @@
 <script setup lang="ts">
 import FileNode from '../FileNode.vue'
-import sessionStore from '../../store/session'
+import useSession from '../../store/session'
+
+const sessionStore = useSession()
 </script>
 
 <template>
@@ -8,6 +10,7 @@ import sessionStore from '../../store/session'
     <ul>
       <li>
         <FileNode
+          v-if="sessionStore.session"
           :node="sessionStore.session.graph"
           :pwd="sessionStore.session.pwd"
         />

app/src/components/header/GameHeaderComponents.vue

@@ -4,12 +4,11 @@ import { useRouter } from 'vue-router'
 import { useToast } from 'vue-toastification'
 import { logout } from '../../utils/auth'
 import { bugReportUrl, surveyUrl } from '../../config'
-import { reset } from '../../store/session'
-import userProfileStore, {
-  loadUserProfile,
-  resetUserProfile,
-} from '../../store/userProfile'
+import useSession from '../../store/session'
+import useUserProfile from '../../store/userProfile'
 
+const userStore = useUserProfile()
+const sessionStore = useSession()
 const router = useRouter()
 
 const toast = useToast()
@@ -17,8 +16,8 @@ const toast = useToast()
 const handleLogout = async () => {
   try {
     await logout()
-    resetUserProfile()
-    reset()
+    userStore.resetUserProfile()
+    sessionStore.reset()
     router.push({ name: 'login' })
   } catch (err) {
     toast.error('登出失敗')
@@ -28,7 +27,7 @@ const handleLogout = async () => {
 
 onMounted(async () => {
   try {
-    await loadUserProfile()
+    await userStore.loadUserProfile()
   } catch (err) {
     toast.error('無法讀取使用者資料')
     console.error(err)
@@ -59,7 +58,7 @@ onMounted(async () => {
     class="text-text inline-block whitespace-nowrap px-1.5"
     style="font-size: 2vh"
   >
-    {{ userProfileStore.username }}
+    {{ userStore.username }}
   </p>
   <a
     title="Survey"

app/src/library.ts

@@ -19,6 +19,7 @@ import {
   faTrophy,
   faFileInvoice,
   faEnvelope,
+  faPlay,
 } from '@fortawesome/free-solid-svg-icons'
 import {
   faLightbulb,
@@ -54,5 +55,6 @@ library.add(
   faGoogle,
   faFileInvoice,
   faFacebook,
-  faEnvelope
+  faEnvelope,
+  faPlay
 )

app/src/main.ts

@@ -1,4 +1,6 @@
 import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+
 import './style.css'
 /* import font awesome icon component */
 import { FontAwesomeIcon } from '@fortawesome/vue-fontawesome'
@@ -13,9 +15,11 @@ import App from './App.vue'
 import router from './router'
 
 const app = createApp(App)
+const pinia = createPinia()
 
 app.component('font-awesome-icon', FontAwesomeIcon)
 
+app.use(pinia)
 app.use(router)
 
 const options = {

app/src/store/session.ts

@@ -1,156 +1,98 @@
-import { reactive } from 'vue'
-import { useToast } from 'vue-toastification'
+import { defineStore } from 'pinia'
 import { FileGraph, FileObject } from '@linux-odyssey/file-graph'
 import { IQuest } from '@linux-odyssey/models'
-import api from '../utils/api'
+import { createSession, getActiveSession, getQuest } from '../utils/api'
 import Socket from '../utils/socket'
 import SocketTerminal from '../utils/terminal'
-import { LoadQuestError, LoadSessionError } from '../utils/errors'
 import { Session, StageResponse } from '../types'
 
-const toast = useToast()
-
-function newSession() {
-  const graph = new FileGraph({
-    path: '/',
-    type: 'folder',
-    discovered: false,
-  })
-  return {
-    _id: '',
-    status: 'inactive',
-    graph,
-    pwd: '',
-    hints: [],
-    tasks: [],
-    responses: [],
-  }
-}
+const socket = new Socket()
+const term = new SocketTerminal(40, 80)
+let hasSetup = false
 
 interface Store {
-  session: Session
+  session: Session | null
   questId: string
   quest: IQuest | null
 }
 
-const store = reactive<Store>({
-  session: newSession(),
-  questId: '',
-  quest: null,
+const useSession = defineStore('session', {
+  state: (): Store => ({
+    session: null,
+    questId: '',
+    quest: null,
+  }),
+  actions: {
+    async setQuest(questId: string) {
+      this.quest = await getQuest(questId)
+      this.questId = questId
+    },
+    async setSession(session: Session) {
+      this.session = session
+      this.session.graph = new FileGraph(session.graph)
+      term.reset()
+      await socket.connect(session)
+      term.focus()
+    },
+    async createSession() {
+      const session = await createSession(this.questId)
+      await this.setSession(session)
+      socket.emit('terminal', 'echo start\n')
+    },
+    async getActiveSession() {
+      const session = await getActiveSession(this.questId)
+      if (session) {
+        this.setSession(session)
+      }
+    },
+    updateGraph(event: { discover?: FileObject[]; pwd?: string }) {
+      if (!this.session) return
+      if (event.discover) {
+        this.session.graph.discover(event.discover)
+      }
+      if (event.pwd) {
+        this.session.pwd = event.pwd
+      }
+    },
+    newResponse(response: StageResponse) {
+      if (!this.session) return
+      this.session.responses.push(response.responses)
+      this.session.hints.push(response.hints)
+      if (response.tasks) {
+        this.session.tasks = response.tasks
+      }
+      this.session.status = response.status
+    },
+    reset() {
+      socket.reset()
+      term.reset()
+      this.$reset()
+    },
+    setup() {
+      if (hasSetup) return
+      socket.on('terminal', (data: string) => {
+        term.write(data)
+      })
+      term.onData((data: string) => {
+        socket.emit('terminal', data)
+      })
+      socket.on('graph', (event: { discover: FileObject[]; pwd: string }) => {
+        this.updateGraph(event)
+      })
+      socket.on('response', (response: StageResponse) => {
+        this.newResponse(response)
+      })
+      hasSetup = true
+    },
+    setStatus(status: string) {
+      if (!this.session) return
+      this.session.status = status
+    },
+  },
 })
 
-const socket = new Socket()
-const term = new SocketTerminal(40, 80)
-
-function setQuest(questId: string) {
-  return api.get(`/quests/${questId}`).then((res) => {
-    store.questId = res.data._id
-    store.quest = res.data
-  })
-}
-
-async function setSession(session: Session) {
-  try {
-    console.log('Setting session...', session)
-    store.session = session
-    store.session.graph = new FileGraph(session.graph)
-    term.reset()
-    await socket.connect(session)
-    term.focus()
-  } catch (err: any) {
-    console.error(err)
-    if (err instanceof Error) {
-      toast.error(err.message)
-    } else {
-      toast.error('Failed to connect to the session. Please try again later.')
-    }
-    throw err
-  }
-}
-
-export async function createSession() {
-  try {
-    console.log('Creating a new session...')
-    const res = await api.post('/sessions', { questId: store.questId })
-    const { data } = res
-    await setSession(data)
-  } catch (err) {
-    console.error(err)
-    toast.error('Failed to create a new session. Please try again later.')
-  }
-}
-
-async function getActiveSession(questId: string) {
-  try {
-    const res = await api.post('/sessions/active', { questId })
-    await setSession(res.data)
-  } catch (err) {
-    console.error(err)
-    toast.warning('Failed to connect previous session. Creating a new one...')
-    await createSession()
-  }
-}
-
-function updateGraph(event: { discover: FileObject[]; pwd: string }) {
-  if (event.discover) {
-    store.session.graph.discover(event.discover)
-  }
-  if (event.pwd) {
-    store.session.pwd = event.pwd
-  }
-}
-
-function newResponse(response: StageResponse) {
-  console.log('newResponse', response, 'session', store.session)
-  store.session.responses.push(response.responses)
-  store.session.hints.push(response.hints)
-  store.session.tasks = response.tasks
-  store.session.status = response.status
-}
-
 export function useTerminal() {
   return term
 }
 
-export function reset() {
-  socket.reset()
-  term.reset()
-  store.session = newSession()
-  store.quest = null
-}
-
-export async function init(questId: string) {
-  if (!questId) throw new Error('No quest ID provided')
-  reset()
-  try {
-    await setQuest(questId)
-  } catch (err) {
-    console.error(err)
-    throw new LoadQuestError('Failed to load quest', questId)
-  }
-  try {
-    await getActiveSession(questId)
-  } catch (err) {
-    console.error(err)
-    throw new LoadSessionError('Failed to load session', questId)
-  }
-}
-
-function setup() {
-  socket.on('terminal', (data: string) => {
-    term.write(data)
-  })
-  term.onData((data: string) => {
-    socket.emit('terminal', data)
-  })
-  socket.on('graph', (event: { discover: FileObject[]; pwd: string }) => {
-    updateGraph(event)
-  })
-  socket.on('response', (response: StageResponse) => {
-    newResponse(response)
-  })
-}
-
-setup()
-
-export default store
+export default useSession

app/src/store/userProfile.ts

@@ -1,30 +1,35 @@
-import { reactive } from 'vue'
-import api from '../utils/api'
+import { defineStore } from 'pinia'
+import { getUserProfile } from '../utils/api'
 
-const store = reactive({
-  username: '',
-  email: '',
-  progress: {},
+interface IProgress {
+  quest: string
+  sessions: string[]
+  completed: boolean
+  startedAt: Date
+  finishedAt?: Date
+}
+
+export interface UserProfile {
+  username: string
+  email: string
+  progress: Map<string, IProgress>
+}
+
+const useUserProfile = defineStore('userProfile', {
+  state: (): UserProfile => ({
+    username: '',
+    email: '',
+    progress: new Map<string, IProgress>(),
+  }),
+  actions: {
+    async loadUserProfile() {
+      const res = await getUserProfile()
+      this.$patch(res)
+    },
+    async resetUserProfile() {
+      this.$reset()
+    },
+  },
 })
 
-export async function loadUserProfile() {
-  try {
-    const res = await api.get('/users/me')
-    const { username, email, progress } = res.data
-    store.username = username
-    store.email = email
-    store.progress = progress
-    return store
-  } catch (err: any) {
-    console.error(err)
-    throw new Error(`Failed to load user profile: ${err.message}`)
-  }
-}
-
-export function resetUserProfile() {
-  store.username = ''
-  store.email = ''
-  store.progress = {}
-}
-
-export default store
+export default useUserProfile

app/src/utils/api.ts

@@ -1,4 +1,8 @@
 import axios from 'axios'
+import { IQuest } from '@linux-odyssey/models'
+import { GetSessionsRequest } from '@linux-odyssey/constants'
+import { Session } from '../types'
+import { UserProfile } from '../store/userProfile'
 
 const api = axios.create({
   baseURL: '/api/v1',
@@ -8,3 +12,34 @@ const api = axios.create({
   withCredentials: true,
 })
 export default api
+
+export async function getUserProfile(): Promise<UserProfile> {
+  const res = await api.get<UserProfile>('/users/me')
+  return res.data
+}
+
+export async function getQuest(id: string): Promise<IQuest> {
+  const res = await api.get<IQuest>(`/quests/${id}`)
+  return res.data
+}
+
+export async function createSession(questId: string): Promise<Session> {
+  const res = await api.post<Session>('/sessions', { questId })
+  return res.data
+}
+
+export async function getSessions(
+  request: GetSessionsRequest
+): Promise<Session[]> {
+  const res = await api.get<Session[]>('/sessions', { params: request })
+  return res.data
+}
+
+export async function getActiveSession(
+  questId: string
+): Promise<Session | null> {
+  const res = await api.get<Session | null>('/sessions/active', {
+    params: { questId },
+  })
+  return res.data
+}

app/src/utils/terminal.ts

@@ -46,7 +46,6 @@ class SocketTerminal {
 
   mount(reference: HTMLElement): void {
     this.term.open(reference)
-    this.term.focus()
     this.resizeScreen()
   }
 

app/src/views/GamePage.vue

@@ -1,20 +1,20 @@
 <script setup lang="ts">
 import { computed, onMounted } from 'vue'
-import { useToast } from 'vue-toastification'
-import sessionStore, { init } from '../store/session'
+import useSession from '../store/session'
 import HeaderPart from '../components/header/HeaderPart.vue'
 import GameHeaderComponents from '../components/header/GameHeaderComponents.vue'
-// import CommandlistPart from '../components/CommandlistPart.vue'
-import HintPart from '../components/game/HintPart.vue'
+import DescriptionPart from '../components/game/DescriptionPart.vue'
 import QuestPart from '../components/game/QuestPart.vue'
 import TerminalPart from '../components/game/TerminalPart.vue'
 import VisualizationPart from '../components/game/VisualizationPart.vue'
 import ControlPalette from '../components/game/ControlPalette.vue'
 import CompleteModal from '../components/game/CompleteModal.vue'
-import { LoadQuestError, LoadSessionError } from '../utils/errors'
+import StartButton from '../components/game/StartButton.vue'
+
+const sessionStore = useSession()
 
 const completed = computed(() => {
-  return sessionStore.session.status === 'finished'
+  return sessionStore.session?.status === 'finished'
 })
 
 const props = defineProps({
@@ -24,23 +24,11 @@ const props = defineProps({
   },
 })
 
-const toast = useToast()
-
 onMounted(async () => {
-  try {
-    await init(props.questId)
-  } catch (err: any) {
-    if (err instanceof LoadQuestError) {
-      toast.error(`無法讀取關卡: ${err.questId}，請確認網頁連結。`)
-      return
-    }
-    if (err instanceof LoadSessionError) {
-      toast.error(`無法建立工作階段: ${err.questId}，請重新登入再試一次。`)
-      return
-    }
-    console.error(err)
-    toast.error(err.message)
-  }
+  sessionStore.reset()
+  sessionStore.setup()
+  await sessionStore.setQuest(props.questId)
+  await sessionStore.getActiveSession()
 })
 </script>
 
@@ -56,7 +44,7 @@ onMounted(async () => {
   <input
     type="hidden"
     id="currentStatus"
-    :value="sessionStore.session.status"
+    :value="sessionStore.session?.status"
   />
   <!-- main -->
   <div id="main" class="h-full pt-10 w-full flex p-3 space-x-3">
@@ -72,8 +60,9 @@ onMounted(async () => {
     </div>
     <!-- Terminal and Hint -->
     <div class="bg-bg h-full rounded-lg w-1/2">
+      <StartButton :questId="$props.questId" />
       <section id="hint" class="h-3/5">
-        <HintPart />
+        <DescriptionPart />
       </section>
       <hr class="border-border border" />
       <section id="terminal" class="h-2/5 overflow-hidden">

docker-compose.dev.yml

@@ -1,95 +0,0 @@
-version: '3'
-services:
-  app:
-    depends_on:
-      - backend
-    build:
-      context: .
-      dockerfile: app/Dockerfile
-      target: dev
-    ports:
-      - 5173:5173
-    networks:
-      - internal
-    volumes:
-      - ./app:/app/app
-      - ./packages:/app/packages
-
-  backend:
-    depends_on:
-      - db
-    build:
-      context: .
-      dockerfile: server/Dockerfile
-      target: dev
-    networks:
-      - internal
-      - players
-    ports:
-      - '3000:3000'
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock
-      - ./server/src:/app/server/src
-      - ./server/dist:/app/server/dist
-      - ./server/swagger.yaml:/app/server/swagger.yaml
-      - ./packages:/app/packages
-      - ./quests:/app/quests
-      - ./logs:/app/logs
-    environment:
-      - BASE_URL=http://localhost:5173
-      - MONGO_URL=mongodb://db:27017/odyssey-test
-      - DOCKER_NETWORK=linux-odyssey-players
-      - SECRET_KEY=b1d2e917-17b9-4fce-9055-082dee6ec5d6 # Only for testing
-      - TRUSTED_PROXIES=${TRUSTED_PROXIES}
-      - SURVEY_URL=${SURVEY_URL}
-      - BUG_REPORT_URL=${BUG_REPORT_URL}
-      - GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}
-      - GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET}
-      - GITHUB_CLIENT_ID=${GITHUB_CLIENT_ID}
-      - GITHUB_CLIENT_SECRET=${GITHUB_CLIENT_SECRET}
-      - TESTING=true
-      - TESTING_USERNAME=alex
-      - TESTING_PASSWORD=Alex1234
-      - HOST_PWD=${PWD}
-      - MOUNT_QUEST=${MOUNT_QUEST}
-
-  analytics:
-    build:
-      context: .
-      dockerfile: packages/analytics/Dockerfile
-      target: dev
-    depends_on:
-      - db
-    networks:
-      - internal
-    ports:
-      - '3001:3001'
-    environment:
-      - MONGO_URL=mongodb://db:27017/odyssey-test
-      - ADMIN_USERNAME=alex
-      - ADMIN_PASSWORD=Alex1234
-    volumes:
-      - ./packages/analytics:/app/packages/analytics
-      - ./packages/models:/app/packages/models
-
-  db:
-    image: mongo
-    restart: always
-    networks:
-      - internal
-    ports:
-      - '27017:27017'
-    volumes:
-      - ./data:/data/db
-
-  base:
-    image: linuxodyssey/quest-base
-    build:
-      context: .
-      dockerfile: ./quests/Dockerfile
-
-networks:
-  internal:
-  players:
-    name: linux-odyssey-players
-    internal: true

docker-compose.yml

@@ -0,0 +1,23 @@
+version: '3'
+services:
+  db:
+    image: mongo
+    restart: always
+    networks:
+      - internal
+    ports:
+      - '27017:27017'
+    volumes:
+      - ./data:/data/db
+
+  base:
+    image: linuxodyssey/quest-base
+    build:
+      context: .
+      dockerfile: ./quests/Dockerfile
+
+networks:
+  internal:
+  players:
+    name: linux-odyssey-players
+    internal: true

packages/constants/index.ts

@@ -1,3 +1,5 @@
+import { z } from 'zod'
+
 export const passwordPolicy = {
   minLength: 8,
   minNumbers: 1,
@@ -6,6 +8,11 @@ export const passwordPolicy = {
   minSymbols: 0,
 }
 
-export default {
-  passwordPolicy,
-}
+export const getSessionsRequestSchema = z.object({
+  questId: z.string().optional(),
+  status: z.enum(['active', 'inactive', 'finished']).optional(),
+  limit: z.coerce.number().optional(),
+  order: z.enum(['asc', 'desc']).optional(),
+})
+
+export type GetSessionsRequest = z.infer<typeof getSessionsRequestSchema>

packages/constants/package.json

@@ -10,5 +10,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc -w"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
   }
 }

packages/models/src/user.ts

@@ -28,6 +28,7 @@ export interface IUser {
   socialLogins: Map<string, ISocialLogin>
   createdAt: Date
   updatedAt: Date
+  isGuest: boolean
 }
 
 export const User = model<IUser>(
@@ -51,6 +52,11 @@ export const User = model<IUser>(
         default: {},
         required: true,
       },
+      isGuest: {
+        type: Boolean,
+        default: false,
+        required: true,
+      },
     },
     {
       timestamps: true,

quests/cast/game.yml

@@ -3,23 +3,23 @@ instruction: |
   在這個關卡中，你將會學到：
   1. 如何使用 `echo` 指令
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - get-started
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始教程
+    task: 按下 `start` 按鈕開始
     condition:
-      output:
-        - ^start$
+      command:
+        - ^echo start$
     responses:
-      - content:
-          - 你剛才使用的指令叫做 `echo`。
-          - '`echo` 指令可以將後方接續的文字輸出到終端機上。'
-          - 例如你輸入 `echo Hello`，終端機就會顯示 `Hello`。
-          - 你可以試著輸入 `echo` 並在後面加上一些文字，然後按下 Enter 鍵，就可以看到終端機上顯示了你剛才輸入的文字。
+      - content: |
+          還記得第一關使用的指令 `echo` 嗎？
+          `echo` 指令可以將後方接續的文字輸出到終端機上。
+          例如你輸入 `echo Hello`，終端機就會顯示 `Hello`。
+          你可以試著輸入 `echo ` 並在後面加上一些文字，然後按下 Enter 鍵，就可以看到終端機上顯示了你剛才輸入的文字。
     hints:
       - ➤  輸入 `echo` 並在後面加上一些文字
       - ➤  例如：`echo example`
@@ -43,8 +43,8 @@ stages:
     requirements:
       - echo
     condition:
-      output:
-        - ^[Hh]ow are you\??$
+      command:
+        - ^echo [Hh]ow are you\??$
     exceptions:
       - condition:
           command:
@@ -59,17 +59,9 @@ stages:
         responses:
           - type: narrative
             content:
-              - 在 `echo` 後面還需要加上一些文字
+              - 在 `echo ` 後面還需要加上 `How are you?`
     responses:
       - content:
           - 你成功的在終端機上顯示了 `How are you?`。
           - 相信你已經了解如何使用 `echo` 指令來顯示文字了。
           - 之後如果要在終端機顯示文字，記得可以使用 `echo` 指令。
-
-exceptions:
-  - repeatable: true
-    condition:
-      command:
-        - '　'
-    hints:
-      - '!! 請勿使用全形空格 !!'

quests/cast/game_elder.yml

@@ -1,131 +0,0 @@
-title: 輸出文字
-instruction: |
-  在這個關卡中，你將會學到：
-  1. 如何使用 `echo` 指令
-  2. `echo` 指令在遊戲中的用途
-
-  準備好就輸入 `echo start` 開始吧！
-
-requirements:
-  - get-started
-
-stages:
-  - id: warning-01
-    repeatable: true
-    condition:
-      command:
-        - '　'
-    hints:
-      - '!! 請勿使用全形空格 !!'
-
-  - id: start
-    task: 輸入 `echo start` 來開始教程
-    condition:
-      output:
-        - ^start$
-    responses:
-      - content:
-          - 你剛才使用的指令叫做 `echo`。
-          - '`echo` 指令可以將後方接續的文字輸出到終端機上。'
-          - 例如你輸入 `echo Hello`，終端機就會顯示 `Hello`。
-          - 你可以試著輸入 `echo` 並在後面加上一些文字，然後按下 Enter 鍵，就可以看到終端機上顯示了你剛才輸入的文字。
-    hints:
-      - ➤  輸入 `echo` 並在後面加上一些文字
-      - ➤  例如：`echo example`
-
-  - id: echo
-    task: 在終端機上顯示顯示任意文字
-    requirements:
-      - start
-    condition:
-      command:
-        - ^echo .*
-    responses:
-      - content:
-          - 你應該可以看到終端機上顯示了你在 `echo` 指令後面的文字。
-          - 接下來，請你試著在終端機上顯示 `How are you?`。
-    hints:
-      - ➤  利用 `echo` 指令來在終端機上顯示 `How are you?`
-
-  - id: how-are-you
-    task: 在終端機上顯示 `How are you?`
-    requirements:
-      - echo
-    condition:
-      output:
-        - ^[Hh]ow are you\??$
-    exceptions:
-      - condition:
-          command:
-            - ^[Hh]ow are you\??$
-        responses:
-          - type: narrative
-            content:
-              - 在 `How are you?` 前面必須加上 `echo`
-      - condition:
-          command:
-            - ^echo$
-        responses:
-          - type: narrative
-            content:
-              - 在 `echo` 後面還需要加上一些文字
-    responses:
-      - content:
-          - 你成功的在終端機上顯示了 `How are you?`。
-          - 相信你已經了解 `echo` 指令的用法了。
-          - 接下來，要像你介紹 `echo` 在遊戲中的特殊功能，那就是詠唱咒語。
-          - 你可以通過輸入 `echo [咒語]` 來詠唱咒語，並產生對應的特殊效果。
-          - 但是要注意，詠唱咒語只有在 Linux Odyssey 中才會有特殊效果。
-          - 在真實的 Linux 環境中，詠唱咒語並不會有任何特殊效果。
-          - 現在，有一段咒語叫做 `HELP`，請你試著使用 `echo` 詠唱這段咒語。
-    hints:
-      - ➤  試著使用 `echo` 來詠唱 `HELP` 咒語
-      - ➤  注意：咒語要使用大寫
-
-  - id: help
-    task: 詠唱 `HELP` 咒語
-    requirements:
-      - how-are-you
-    condition:
-      output:
-        - ^HELP$
-    responses:
-      - content:
-          - 你詠唱了 `HELP` 咒語，一位精靈出現了。
-      - type: dialogue
-        speaker: Unix 精靈
-        content:
-          - 你好，我是 Unix 精靈。
-          - 既然你使用了 `HELP` 咒語呼喚我，就讓我來教你一個咒語吧。
-          - 讓我想想... 好了，我想到了一個咒語，叫做 `WATER`。
-          - 這是施展水魔法的咒語。詠唱這個咒語可以施展水魔法，產生少量的水。
-          - 試著使用 `echo` 詠唱這個咒語吧。
-    hints:
-      - ➤  詠唱 `WATER` 咒語
-
-  - id: END
-    task: 詠唱 `WATER` 咒語
-    requirements:
-      - help
-    condition:
-      output:
-        - ^WATER$
-    responses:
-      - content:
-          - 你施展了水魔法，一個水球出現在你的手中。
-      - type: dialogue
-        speaker: Unix 精靈
-        content:
-          - 很好，你已經學會了水魔法。
-      - content:
-          - 真厲害，你已經了解如何使用 `echo` 指令，並且學會了詠唱咒語的方法。
-          - 最後複習一下，你可以通過輸入 `echo [文字]` 來在終端機上顯示文字。
-          - 你也可以通過輸入 `echo [咒語]` 來詠唱咒語，並產生對應的特殊效果。
-          - 不要忘了，詠唱咒語只有在 Linux Odyssey 中才會有特殊效果。
-          - 在真實的 Linux 環境中，咒語只會被視為一串文字顯示出來而已。
-          - 以上就是 `echo` 指令的用法，請繼續努力，完成接下來的關卡吧！
-    hints: |
-      複習：
-        通過輸入 `echo [文字]` 來在終端機上顯示文字
-        通過輸入 `echo [咒語]` 來詠唱咒語
-        咒語只有在 Linux Odyssey 中才會有特殊效果

quests/copy/answer.sh

@@ -1,4 +1,5 @@
 echo start
+ls
 cat hello.txt
 cat world.txt
 echo continue

quests/copy/game.yml

@@ -3,120 +3,185 @@ instruction: |
   在這個關卡中，你將會學到：
   1. 如何用 `cp` 指令複製檔案
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - create
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始
+    task: 按下 `start` 按鈕開始
     condition:
-      output:
-        - start
-    exceptions:
-      - condition:
-          command:
-            - ^echo$
-        responses:
-          - type: narrative
-            content:
-              - 你忘記輸入 `start` 了嗎？
-              - 請輸入 `echo start` 來開始
-      - catchAll: true
-        responses:
-          - type: narrative
-            content:
-              - 請輸入 `echo start` 來開始
+      command:
+        - ^echo start$
     responses:
       - type: narrative
-        content:
-          - 今天我們要學習如何複製檔案。
-          - 現在資料夾裡有一個 `hello.txt` 跟一個 `world.txt`，請使用 `ls` 與 `cat` 來查看它們的內容。
-          - 看完之後，使用 `echo continue` 來繼續吧！
+        content: |
+          今天我們要學習如何複製檔案。
+          先用 `ls` 指令查看目前資料夾裡有哪些檔案。
+    hints:
+      - ➤  使用 `ls` 來查看目前資料夾裡有哪些檔案
+
+  - id: ls
+    task: 查看目前資料夾裡的檔案
+    requirements:
+      - start
+    condition:
+      pwd:
+        - ^/home/commander$
+      command:
+        - ^ls$
+      output:
+        - (^|\s)hello.txt($|\s)
+        - (^|\s)world.txt($|\s)
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
+    responses:
+      - type: narrative
+        content: 可以看到現在資料夾裡有 `hello.txt` 跟 `world.txt`。
+          請使用 `cat` 來查看它們的內容。
+          看完之後，使用 `echo next` 來繼續吧！
     hints:
-      - ➤  使用 `ls` 來查看資料夾內的檔案
       - ➤  使用 `cat hello.txt` 以及 `cat world.txt` 來查看檔案內容
       - ➤  如果終端機卡在某個指令無法輸入，請按下 `Ctrl + C` 來取消該指令
 
   - id: cat-hello
     task: 查看 `hello.txt` 的內容
     requirements:
-      - start
+      - ls
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cat hello.txt$
       output:
         - Hello
     exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾
       - condition:
           command:
             - ^cat$
         responses:
           - type: narrative
-            content:
-              - 你忘記輸入 `cat` 了嗎？
-              - 請輸入 `cat hello.txt` 來查看 `hello.txt` 的內容
+            content: |
+              你忘記輸入 `cat` 了嗎？
+              請輸入 `cat hello.txt` 來查看 `hello.txt` 的內容
       - condition:
           command:
             - ^cat hello$
         responses:
           - type: narrative
-            content:
-              - 你忘記輸入 `.txt` 了嗎？
-              - 請輸入 `cat hello.txt` 來查看 `hello.txt` 的內容
+            content: |
+              你忘記輸入 `.txt` 了嗎？
+              請輸入 `cat hello.txt` 來查看 `hello.txt` 的內容
     responses:
       - type: narrative
-        content:
-          - 你成功查看到 `hello.txt` 的內容了！
+        content: |
+          你成功查看到 `hello.txt` 的內容了！
 
   - id: cat-world
     task: 查看 `world.txt` 的內容
     requirements:
-      - start
+      - ls
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cat world.txt$
       output:
         - World
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾
+      - condition:
+          command:
+            - ^cat$
+        responses:
+          - type: narrative
+            content: |
+              你忘記輸入 `cat` 了嗎？
+              請輸入 `cat world.txt` 來查看 `world.txt` 的內容
+      - condition:
+          command:
+            - ^cat world$
+        responses:
+          - type: narrative
+            content: |
+              你忘記輸入 `.txt` 了嗎？
+              請輸入 `cat world.txt` 來查看 `world.txt` 的內容
     responses:
       - type: narrative
-        content:
-          - 你成功查看到 `world.txt` 的內容了！
+        content: |
+          你成功查看到 `world.txt` 的內容了！
 
-  - id: cat-continue
-    task: 使用 `echo continue` 來繼續
+  - id: cat-next
+    task: 輸入 `echo next` 來繼續
     requirements:
       - cat-hello
       - cat-world
     condition:
       command:
-        - echo
+        - ^echo next$
     responses:
       - type: narrative
-        content:
-          - 接下來我們要來學習複製檔案。
-          - '`cp` 這個指令，是 copy 的縮寫，就是複製的意思。'
-          - 我們可以用 `cp [來源檔案] [目的檔案]` 的方式來複製檔案。
-          - 請你使用 `cp` 來複製 `hello.txt` 到 `hello2.txt`。
+        content: |
+          接下來我們要來學習如何複製檔案。
+          `cp` 這個指令，是 copy 的縮寫，就是複製的意思。
+          我們可以用 `cp [來源檔案] [目的檔案]` 的方式來複製檔案。
+          請你使用 `cp` 來複製 `hello.txt` 的內容到 `hello2.txt`。
     hints:
       - ➤  使用 `cp hello.txt hello2.txt` 來複製 `hello.txt` 到 `hello2.txt`
 
   - id: cp-hello
     task: 複製 `hello.txt` 到 `hello2.txt`
     requirements:
-      - cat-continue
+      - cat-next
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cp hello.txt hello2.txt$
       files:
         - path: hello2.txt
           type: file
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - 你成功複製 `hello.txt` 到 `hello2.txt` 了！
-          - 我們打開來確認一下 `hello2.txt` 的內容吧！
+        content: |
+          你成功複製 `hello.txt` 到 `hello2.txt` 了！
+          我們打開來確認一下 `hello2.txt` 的內容吧！
     hints:
       - ➤  使用 `cat hello2.txt` 來查看 `hello2.txt` 的內容
 
@@ -125,16 +190,28 @@ stages:
       - cp-hello
     task: 查看 `hello2.txt` 的內容
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cat hello2.txt$
       output:
         - Hello
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - 你成功查看到 `hello2.txt` 的內容了！
-          - 正如我們所見，`hello2.txt` 的內容跟 `hello.txt` 一模一樣。
-          - 那我們再來試試看複製 `world.txt` 到 `world2.txt` 吧！
+        content: |
+          你成功查看到 `hello2.txt` 的內容了！
+          正如我們所見，`hello2.txt` 的內容跟 `hello.txt` 一模一樣。
+          那我們再來試試看複製 `world.txt` 到 `world2.txt` 吧！
     hints:
       - ➤  使用 `cp world.txt world2.txt` 來複製 `world.txt` 到 `world2.txt`
 
@@ -143,16 +220,28 @@ stages:
       - cat-hello2
     task: 複製 `world.txt` 到 `world2.txt`
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cp world.txt world2.txt$
       files:
         - path: world2.txt
           type: file
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - 你成功複製 `world.txt` 到 `world2.txt` 了！
-          - 我們打開來確認一下 `world2.txt` 的內容吧！
+        content: |
+          你成功複製 `world.txt` 到 `world2.txt` 了！
+          我們打開來確認一下 `world2.txt` 的內容吧！
     hints:
       - ➤  使用 `cat world2.txt` 來查看 `world2.txt` 的內容
 
@@ -161,23 +250,35 @@ stages:
       - cp-world
     task: 查看 `world2.txt` 的內容
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cat world2.txt$
       output:
         - World
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - 你成功查看到 `world2.txt` 的內容了！
-          - '`world2.txt` 的內容跟 `world.txt` 一模一樣。'
-          - 接下來我們要來學習如何複製資料夾。
-          - 現在目錄下有一個 `notes` 資料夾，裡面有一個 `note.txt` 的檔案。
-          - 我們要能整個資料夾包含裡面的檔案一起複製到 `notes2`。
-          - 跟複製單一檔案不一樣的是，複製資料夾時，我們要加上 `-r` 的選項（recursive）代表將資料夾中的所有檔案都一起複製。
-          - 在使用指令時，如果想要調整指令的行為，可以在指令後面加上選項。
-          - 選項的格式通常是 `-` 加上一個字母，例如 `-r`。
-          - 選項擺放的位置沒有特別的限制，通常會跟在指令的後面，置於檔案名稱的前面。
-          - 請你使用 `cp -r notes notes2` 來複製 `notes` 資料夾到 `notes2`。
+        content: |
+          你成功查看到 `world2.txt` 的內容了！
+          `world2.txt` 的內容跟 `world.txt` 一模一樣。
+          接下來我們要來學習如何複製資料夾。
+          現在目錄下有一個 `notes` 資料夾，裡面有一個 `note.txt` 的檔案。
+          我們要能整個資料夾包含裡面的檔案一起複製到 `notes2`。
+          跟複製單一檔案不一樣的是，複製資料夾時，我們要加上 `-r` 的選項（recursive）代表將資料夾中的所有檔案都一起複製。
+          在使用指令時，如果想要調整指令的行為，可以在指令後面加上選項。
+          選項的格式通常是 `-` 加上一個字母，例如 `-r`。
+          選項擺放的位置沒有特別的限制，通常會跟在指令的後面，置於檔案名稱的前面。
+          請你使用 `cp -r notes notes2` 來複製 `notes` 資料夾到 `notes2`。
     hints:
       - ➤  使用 `cp -r notes notes2` 來複製 `notes` 資料夾到 `notes2`
       - ➤  記得要加上 `-r` 的選項來複製所有檔案
@@ -187,6 +288,8 @@ stages:
       - cat-world2
     task: 複製 `notes` 資料夾到 `notes2`
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cp
       files:
@@ -194,38 +297,59 @@ stages:
           type: directory
         - path: notes2/note.txt
           type: file
-    responses:
-      - type: narrative
-        content:
-          - 你成功複製 `notes` 資料夾到 `notes2` 了！
-          - 我們打開來確認一下 `notes2` 資料夾的內容吧！
-    hints:
-      - ➤  使用 `ls notes2` 來查看 `notes2` 資料夾的內容
     exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
       - condition:
           error:
             - 'cp: omitting directory'
         responses:
           - type: narrative
-            content:
-              - 你忘記加上 `-r` 的參數了嗎？
-              - 請輸入 `cp -r notes notes2` 來複製 `notes` 資料夾到 `notes2`
+            content: |
+              你忘記加上 `-r` 的參數了嗎？
+              請輸入 `cp -r notes notes2` 來複製 `notes` 資料夾到 `notes2`
+    responses:
+      - type: narrative
+        content: |
+          你成功複製 `notes` 資料夾到 `notes2` 了！
+          我們打開來確認一下 `notes2` 資料夾的內容吧！
+    hints:
+      - ➤  使用 `ls notes2` 來查看 `notes2` 資料夾的內容
 
   - id: ls-notes2
     requirements:
       - cp-notes
     task: 查看 `notes2` 資料夾的內容
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^ls notes2$
       output:
         - note.txt
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - 你成功查看到 `notes2` 資料夾的內容了！
-          - 我們可以看到，整個 `notes` 資料夾包含裡面的檔案，都被複製到 `notes2` 資料夾了。
-          - 那麼最後我們要來試試看，如果複製一個檔案到已經存在的檔案會發生什麼事。
+        content: |
+          你成功查看到 `notes2` 資料夾的內容了！
+          我們可以看到，整個 `notes` 資料夾包含裡面的檔案，都被複製到 `notes2` 資料夾了。
+          那麼最後我們要來試試看，如果複製一個檔案到已經存在的檔案會發生什麼事。
     hints:
       - ➤  使用 `cp hello.txt world.txt` 來複製 `hello.txt` 到 `world.txt`
 
@@ -234,13 +358,25 @@ stages:
       - ls-notes2
     task: 複製 `hello.txt` 到 `world.txt`
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cp hello.txt world.txt$
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - 你成功複製 `hello.txt` 到 `world.txt` 了！
-          - 我們打開來確認一下 `world.txt` 的內容吧！
+        content: |
+          你成功複製 `hello.txt` 到 `world.txt` 了！
+          我們打開來確認一下 `world.txt` 的內容吧！
     hints:
       - ➤  使用 `cat world.txt`
 
@@ -249,14 +385,26 @@ stages:
       - cp-overwrite
     task: 檢查 `world.txt` 的內容
     condition:
+      pwd:
+        - ^/home/commander$
       command:
         - ^cat world.txt$
       output:
         - Hello
+    exceptions:
+      - condition:
+          not:
+            pwd:
+              - ^/home/commander$
+        responses:
+          - type: narrative
+            content: |
+              你不在 `/home/commander` 資料夾裡。
+              請使用 `cd /home/commander` 來返回 `/home/commander` 資料夾。
     responses:
       - type: narrative
-        content:
-          - '`world.txt` 的內容變成 `Hello` 了！'
-          - 這是因為，當我們複製檔案時，如果目的檔案已經存在，那麼目的檔案的內容就會被覆蓋掉。
-          - 所以在複製檔案的時候，要特別注意目的檔案是否已經存在，否則可能會不小心把資料弄丟。
-          - 以上就是複製檔案的基本操作！
+        content: |
+          `world.txt` 的內容變成 `Hello` 了！
+          這是因為，當我們複製檔案時，如果目的檔案已經存在，那麼目的檔案的內容就會被覆蓋掉。
+          所以在複製檔案的時候，要特別注意目的檔案是否已經存在，否則可能會不小心把資料弄丟。
+          以上就是複製檔案的基本操作！

quests/create/answer.sh

@@ -1,4 +1,5 @@
 echo start
+ls
 touch hello.txt
 ls
 cat hello.txt

quests/create/game.yml

@@ -4,40 +4,66 @@ instruction: |
   1. 如何使用 `touch` 建立檔案
   2. 如何使用 `mkdir` 建立資料夾
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - read
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始
+    task: 按下 `start` 按鈕開始
     condition:
       command:
-        - ^echo start
+        - ^echo start$
     responses:
       - type: narrative
-        content:
-          - 這次要學習的指令是 `touch` 指令。
-          - '`touch` 指令可以建立一個檔案。'
-          - 接下來，請你試著在終端機上建立一個檔案，檔名為 `hello.txt`。
+        content: |
+          這次要學習的指令是 `touch` 指令。
+          請你先用 `ls` 指令查看目前所在資料夾中有哪些檔案。
+          你應該會發現目前所在資料夾中沒有任何檔案。
+    hints:
+      - ➤  輸入 `ls` 指令來查看目前所在資料夾中有哪些檔案
+
+  - id: ls
+    task: 查看資料夾中的檔案
+    requirements:
+      - start
+    condition:
+      command:
+        - ^ls$
+    responses:
+      - type: narrative
+        content: |
+          你應該可以看到終端機上沒有任何回應，這表示目前所在資料夾中沒有任何檔案。
+          而我們可以使用 `touch [檔案名稱]` 指令來建立一個檔案。
+          接下來，請你試著在終端機上建立一個檔案，檔名為 `hello.txt`。
     hints:
       - ➤  輸入 `touch hello.txt` 來建立一個檔案
 
   - id: touch
     task: 使用 `touch` 指令來建立一個檔案
     requirements:
-      - start
+      - ls
     condition:
       files:
         - path: hello.txt
           type: file
+    exceptions:
+      - condition:
+          files:
+            - path: hello$
+              type: file
+        responses:
+          - type: narrative
+            content: |
+              你似乎忘記輸入副檔名 `txt` 了。
+              請再試一次，並確保檔名為 `hello.txt`。
     responses:
       - type: narrative
-        content:
-          - 你應該可以看到終端機上沒有任何回應。
-          - 這表示 `touch` 指令已經成功建立了一個檔案。
-          - 接下來，請你用之前學過的 `ls` 指令來查看目前所在資料夾中有哪些檔案。
+        content: |
+          你應該可以看到終端機上沒有任何回應。
+          然而實際上 `touch` 指令已經成功建立了一個檔案。
+          請你用之前學過的 `ls` 指令來查看目前所在資料夾中有哪些檔案。
     hints:
       - ➤  輸入 `ls` 指令來查看目前所在資料夾中有哪些檔案
 
@@ -52,26 +78,28 @@ stages:
         - hello.txt
     responses:
       - type: narrative
-        content:
-          - 你應該可以看到終端機上顯示了 `hello.txt` 這個檔案。
-          - 我們來看看 `hello.txt` 檔案的內容吧！
-          - 我們可以使用之前學過的 `cat` 指令來查看檔案內容。
+        content: |
+          你應該可以看到終端機上顯示了 `hello.txt` 這個檔案。
+          我們來看看 `hello.txt` 檔案的內容吧！
+          我們可以使用之前學過的 `cat` 指令來查看檔案內容。
     hints:
       - ➤  輸入 `cat hello.txt` 來查看 `hello.txt` 檔案的內容
 
   - id: cat
     task: 使用 `cat` 指令來查看 `hello.txt` 檔案的內容
+    requirements:
+      - ls-touch
     condition:
       command:
         - ^cat hello.txt$
     responses:
       - type: narrative
-        content:
-          - 咦？竟然什麼都沒有！
-          - 沒錯，使用 `touch` 指令建立的檔案是空的。
-          - 我們在未來會學習如何編輯檔案的內容。
-          - 再來試試建立其他的檔案吧！
-          - 請你試著在終端機上建立另一個檔案，檔名為 `world.txt`。
+        content: |
+          咦？竟然什麼都沒有！
+          沒錯，使用 `touch` 指令建立的檔案是空的。
+          我們在未來會學習如何編輯檔案的內容。
+          再來試試建立其他的檔案吧！
+          請你試著在終端機上建立另一個檔案，檔名為 `world.txt`。
     hints:
       - ➤  輸入 `touch world.txt` 來建立一個檔案
 
@@ -83,11 +111,21 @@ stages:
       files:
         - path: world.txt
           type: file
+    exceptions:
+      - condition:
+          files:
+            - path: world$
+              type: file
+        responses:
+          - type: narrative
+            content: |
+              你似乎忘記輸入副檔名 `txt` 了。
+              請再試一次，並確保檔名為 `world.txt`。
     responses:
       - type: narrative
-        content:
-          - 非常好，你已經成功建立了第二個檔案。
-          - 接下來，請你用之前學過的 `ls` 指令來查看剛剛建立的兩個檔案。
+        content: |
+          非常好，你已經成功建立了第二個檔案。
+          接下來，請你用之前學過的 `ls` 指令來查看剛剛建立的兩個檔案。
     hints:
       - ➤  輸入 `ls` 指令來查看目前所在資料夾中有哪些檔案
 
@@ -99,16 +137,16 @@ stages:
       command:
         - ^ls$
       output:
-        - hello.txt
-        - world.txt
+        - (^|\s)hello.txt($|\s)
+        - (^|\s)world.txt($|\s)
     responses:
       - type: narrative
-        content:
-          - 你應該可以看到終端機上顯示了 `hello.txt` 和 `world.txt` 這兩個檔案。
-          - 接下來，我們來試試看建立資料夾吧！
-          - '`mkdir` 指令可以建立一個空的資料夾。'
-          - 使用方式是 `mkdir [資料夾名稱]`。
-          - 請你試著在終端機上建立一個資料夾，名稱為 `notes`。
+        content: |
+          你應該可以看到終端機上顯示了 `hello.txt` 和 `world.txt` 這兩個檔案。
+          接下來，我們來試試看建立資料夾吧！
+          `mkdir` 指令可以建立一個空的資料夾。
+          使用方式是 `mkdir [資料夾名稱]`。
+          請你試著在終端機上建立一個資料夾，名稱為 `notes`。
     hints:
       - ➤  輸入 `mkdir notes` 來建立一個資料夾
 
@@ -122,9 +160,9 @@ stages:
           type: folder
     responses:
       - type: narrative
-        content:
-          - 非常好，你已經成功建立了 `notes` 資料夾。
-          - 接下來，請你用 `ls` 指令來查看剛剛建立的資料夾。
+        content: |
+          非常好，你已經成功建立了 `notes` 資料夾。
+          接下來，請你用 `ls` 指令來查看剛剛建立的資料夾。
 
   - id: ls-mkdir
     task: 使用 `ls` 查看剛建立的資料夾
@@ -137,11 +175,11 @@ stages:
         - notes
     responses:
       - type: narrative
-        content:
-          - 你應該可以看到終端機上顯示了 `notes` 這個資料夾。
-          - 接下來，我們要在 `notes` 資料夾中建立一個 `note.txt` 的檔案。
-          - 首先，我們要先進入 `notes` 資料夾。
-          - 還記得之前的 `cd` 指令嗎？請你試著使用 `cd` 指令來進入 `notes` 資料夾。
+        content: |
+          你應該可以看到終端機上顯示了 `notes` 這個資料夾。
+          接下來，我們要在 `notes` 資料夾中建立一個 `note.txt` 的檔案。
+          首先，我們要先進入 `notes` 資料夾。
+          還記得之前的 `cd` 指令嗎？請你試著使用 `cd` 指令來進入 `notes` 資料夾。
     hints:
       - ➤  輸入 `cd notes` 來進入 `notes` 資料夾
       - ➤  可以在輸入到 `cd n` 時按下 `Tab` 鍵來自動補齊資料夾名稱
@@ -155,9 +193,9 @@ stages:
         - ^/home/commander/notes$
     responses:
       - type: narrative
-        content:
-          - 你已經成功進入了 `notes` 資料夾。
-          - 接下來，請你試著在 `notes` 資料夾裡建立一個檔案，檔名為 `note.txt`。
+        content: |
+          你已經成功進入了 `notes` 資料夾。
+          接下來，請你試著在 `notes` 資料夾裡建立一個檔案，檔名為 `note.txt`。
     hints:
       - ➤  輸入 `touch note.txt` 來建立一個檔案
 
@@ -171,9 +209,9 @@ stages:
           type: file
     responses:
       - type: narrative
-        content:
-          - 非常好，你已經成功建立了 `note.txt` 檔案。
-          - 跟之前一樣，你可以使用 `ls` 指令來查看目前所在資料夾中有哪些檔案。
+        content: |
+          非常好，你已經成功建立了 `note.txt` 檔案。
+          跟之前一樣，你可以使用 `ls` 指令來查看目前所在資料夾中有哪些檔案。
 
   - id: END
     task: 使用 `ls` 指令來查看目前所在資料夾中有哪些檔案
@@ -186,7 +224,7 @@ stages:
         - note.txt
     responses:
       - type: narrative
-        content:
-          - 你應該可以看到終端機上顯示了 `note.txt` 這個檔案。
-          - 恭喜你完成了這個關卡！
-          - 在下一個關卡中，你將學習如何複製檔案與資料夾。
+        content: |
+          你應該可以看到終端機上顯示了 `note.txt` 這個檔案。
+          恭喜你完成了這個關卡！
+          在下一個關卡中，你將學習如何複製檔案與資料夾。

quests/exceptions.yml

@@ -4,139 +4,96 @@ exceptions:
         - '[\uff21-\uff3a\uff41-\uff5a]'
     responses:
       - type: narrative
-        content:
-          - '!! 請使用半形英文字母 !!'
+        content: |
+          !! 請使用半形英文字母 !!
 
   - condition:
       command:
         - '　'
     responses:
       - type: narrative
-        content:
-          - '!! 請使用半形空格 !!'
-
-  - condition:
-      or:
-        - command:
-            - '`'
-        - command:
-            - \'
-    responses:
-      - type: narrative
-        content:
-          - '!! 不需要輸入上下引號 !!'
+        content: |
+          !! 請使用半形空格 !!
 
   - condition:
       command:
-        - ^echo\S$
+        - ^echo\S
     responses:
       - type: narrative
-        content:
-          - '!! `echo` 後面要加空格 !!'
+        content: |
+          !! `echo` 後面要加空格 !!
 
   - condition:
       command:
-        - ^cd\S$
+        - ^cd\S
     responses:
       - type: narrative
-        content:
-          - '!! `cd` 後面要加空格 !!'
+        content: |
+          !! `cd` 後面要加空格 !!
 
   - condition:
       command:
-        - ^ls\S$
+        - ^ls\S
     responses:
       - type: narrative
-        content:
-          - '!! `ls` 後面要加空格 !!'
+        content: |
+          !! `ls` 後面要加空格 !!
 
   - condition:
       command:
-        - ^cat\S$
+        - ^cat\S
     responses:
       - type: narrative
-        content:
-          - '!! `cat` 後面要加空格 !!'
+        content: |
+          !! `cat` 後面要加空格 !!
 
   - condition:
       command:
-        - ^touch\S$
+        - ^touch\S
     responses:
       - type: narrative
-        content:
-          - '!! `touch` 後面要加空格 !!'
+        content: |
+          !! `touch` 後面要加空格 !!
 
   - condition:
       not:
         command:
-          - ^rmdir$
+          - ^rmdir
       command:
-        - ^rm\S$
+        - ^rm\S
     responses:
       - type: narrative
-        content:
-          - '!! `rm` 後面要加空格 !!'
+        content: |
+          !! `rm` 後面要加空格 !!
 
   - condition:
       command:
-        - ^mv\S$
+        - ^mv\S
     responses:
       - type: narrative
-        content:
-          - '!! `mv` 後面要加空格 !!'
+        content: |
+          !! `mv` 後面要加空格 !!
 
   - condition:
       command:
-        - ^mkdir\S$
+        - ^mkdir\S
     responses:
       - type: narrative
-        content:
-          - '!! `mkdir` 後面要加空格 !!'
+        content: |
+          !! `mkdir` 後面要加空格 !!
 
   - condition:
       command:
-        - ^rmdir\S$
+        - ^rmdir\S
     responses:
       - type: narrative
-        content:
-          - '!! `rmdir` 後面要加空格 !!'
+        content: |
+          !! `rmdir` 後面要加空格 !!
 
   - condition:
       command:
-        - ^cp\S$
+        - ^cp\S
     responses:
       - type: narrative
-        content:
-          - '!! `cp` 後面要加空格 !!'
-
-  - condition:
-      command:
-        - ^[Ii1]s$
-    responses:
-      - type: narrative
-        content:
-          - '!! `ls` 的首字母是小寫的 `L` !!'
-
-  - condition:
-      command:
-        - 嗨
-    responses:
-      - type: narrative
-        content:
-          - '嗨～'
-
-  - condition:
-      command:
-        - folderl
-    responses:
-      - type: narrative
-        content:
-          - '`folder1` 的 `1` 是數字 `1`，不是小寫的 `L` !!'
-
-  - condition:
-      command:
-        - filel
-    responses:
-      - type: narrative
-        content:
-          - '`file1` 的 `1` 是數字 `1`，不是小寫的 `L` !!'
+        content: |
+          !! `cp` 後面要加空格 !!

quests/explore/game.yml

@@ -4,24 +4,24 @@ instruction: |
   1. 如何使用 `ls` 查看資料夾的內容
   2. 如何使用 `cd` 在資料夾之間移動
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - get-started
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始教程
+    task: 按下 `start` 按鈕開始教程
     condition:
-      output:
-        - ^start$
+      command:
+        - ^echo start$
     responses:
-      - content:
-          - 在終端機中，並沒有圖形介面可以讓你查看資料夾的內容。
-          - 但是你可以透過 `ls` 指令來查看資料夾的內容。
-          - '`ls` 指令是 list 的縮寫，也就是列出檔案的意思。'
-          - 在輸入 `ls` 指令後，終端機會輸出資料夾中包含的檔案和資料夾，右邊的檔案樹也會隨之改變。
-          - 現在，請你輸入 `ls` 指令，查看資料夾中有什麼東西。
+      - content: |
+          在終端機中，並沒有圖形介面可以讓你查看資料夾的內容。
+          但是你可以透過 `ls` 指令來查看資料夾的內容。
+          `ls` 指令(第一個字是小寫L)是 list 的簡寫，也就是列出檔案的意思。
+          在輸入 `ls` 指令後，終端機會輸出資料夾中包含的檔案和資料夾。
+          現在，請你輸入 `ls` 指令，查看資料夾中有什麼東西。
     hints:
       - ➤  輸入 `ls` 並查看資料夾的內容
 
@@ -36,24 +36,23 @@ stages:
       - condition:
           not:
             pwd:
-              - ^/home/commander$
+              - /home/commander
         responses:
           - type: narrative
-            content:
-              - 請先回到 `/home/commander/` 資料夾
-              - 輸入 `cd ~` 來返回 `/home/commander/` 資料夾
+            content: |
+              請先回到 `/home/commander/` 資料夾
+              輸入 `cd ~` 來返回 `/home/commander/` 資料夾
     responses:
-      - content:
-          - 你應該能看到資料夾中的內容了。
-          - 在畫面右邊的檔案樹也有了改變。
-          - 可以看出，在這個資料夾中包含了兩個資料夾，分別是 `folder1` 和 `folder2`。
-      - content:
-          - 接下來，我要教你如何進入資料夾。
-          - '`cd` 指令是 change directory 的縮寫，也就是改變路徑的意思。'
-          - 你可以通過輸入 `cd [資料夾名稱]` 來進入資料夾。
-          - 例如你要進入 `folder1` 資料夾，你可以輸入
-          - '`cd folder1`。'
-          - 現在，請你進入 `folder1` 資料夾。
+      - content: |
+          你應該能看到資料夾中的內容了。
+          在畫面右邊的檔案樹也有了改變。
+          可以看出，在這個資料夾中包含了兩個資料夾，分別是 `folder1` 和 `folder2` 。
+      - content: |
+          接下來，我要教你如何進入資料夾。
+          `cd` 指令是 change directory 的縮寫，也就是改變路徑的意思。
+          你可以通過輸入 `cd [資料夾名稱]` 來進入資料夾。
+          例如你要進入 `folder1` 資料夾，你可以輸入 `cd folder1` 。
+          現在，請你進入 `folder1` 資料夾。
     hints:
       - ➤  輸入 `cd folder1` 來進入 `folder1` 資料夾
 
@@ -65,30 +64,37 @@ stages:
       pwd:
         - ^/home/commander/folder1$
     exceptions:
+      - condition:
+          command:
+            - folderl
+        responses:
+          - type: narrative
+            content: |
+              `folder1` 的最後是數字 `1` 不是字母 `l`。
       - condition:
           pwd:
             - ^/home/commander$
         responses:
           - type: narrative
-            content:
-              - 輸入 `cd folder1` 來進入 `folder1` 資料夾
+            content: 輸入 `cd folder1` 來進入 `folder1` 資料夾
       - condition:
           not:
             pwd:
               - ^/home/commander$
         responses:
           - type: narrative
-            content:
-              - 請先回到 `/home/commander/` 資料夾
-              - 輸入 `cd ~` 來返回 `/home/commander/` 資料夾
+            content: |
+              請先回到 `/home/commander/` 資料夾
+              輸入 `cd ~` 來返回 `/home/commander/` 資料夾
+              再輸入 `cd folder1` 來進入 `folder1` 資料夾
     responses:
-      - content:
-          - 你成功的進入 `folder1` 資料夾了。
-          - 你可以發現指令提示符從原本的
-          - '`commander:~ $` 變成了'
-          - '`commander:~/folder1 $` 。'
-          - 這表示你現在正位在 `folder1` 資料夾中。
-          - 現在，請查看 `folder1` 資料夾的內容。
+      - content: |
+          你成功的進入 `folder1` 資料夾了。
+          你可以發現指令提示符從原本的
+          `commander:~ $` 變成了
+          `commander:~/folder1 $` 。
+          這表示你現在正位在 `folder1` 資料夾中。
+          現在，請查看 `folder1` 資料夾的內容。
     hints:
       - ➤  輸入 `ls` 查看資料夾的內容
 
@@ -102,11 +108,11 @@ stages:
       command:
         - ^ls$
     responses:
-      - content:
-          - 你現在可以看到 `folder1` 資料夾中有兩的檔案，分別是 `file1.txt` 跟 `file2.txt`。
-          - 現在我們可以離開 `folder1` 回到原本的資料夾了。
-          - 你可以使用 `cd ..` 回到上一層資料夾。
-          - 這裡的 `..` 代表的是上一層的資料夾。
+      - content: |
+          你現在可以看到 `folder1` 資料夾中有兩個檔案，分別是 `file1.txt` 跟 `file2.txt`。
+          現在我們可以離開 `folder1` 回到原本的資料夾了。
+          你可以使用 `cd ..` 回到上一層資料夾。
+          這裡的 `..` 代表的是上一層的資料夾。
     hints:
       - ➤  輸入 `cd ..` 回到上一層資料夾
 
@@ -118,9 +124,9 @@ stages:
       pwd:
         - ^/home/commander$
     responses:
-      - content:
-          - 你成功的回到上一層資料夾了。
-          - 現在，請你剛才所學的指令，進入 `folder2` 資料夾，檢查 `folder2` 資料夾的內容，最後回到這個資料夾。
+      - content: |
+          你成功的回到上一層資料夾了。
+          現在，請你剛才所學的指令，進入 `folder2` 資料夾，檢查 `folder2` 資料夾的內容，最後回到這個資料夾。
     hints:
       - ➤  使用 `cd` 指令進出資料夾
       - ➤  使用 `ls` 指令查看資料夾的內容
@@ -133,9 +139,9 @@ stages:
       pwd:
         - ^/home/commander/folder2$
     responses:
-      - content:
-          - 你成功的進入 `folder2` 資料夾了。
-          - 現在，請你查看 `folder2` 資料夾的內容。
+      - content: |
+          你成功的進入 `folder2` 資料夾了。
+          現在，請你查看 `folder2` 資料夾的內容。
     hints:
       - ➤  使用 `ls` 查看資料夾的內容
 
@@ -147,11 +153,11 @@ stages:
       pwd:
         - ^/home/commander/folder2$
       command:
-        - ls
+        - ^ls$
     responses:
-      - content:
-          - 你看到了 `folder2` 資料夾中的檔案，分別是 `file3.txt` 跟 `file4.txt`。
-          - 現在你可以離開 `folder2` 回到原本的資料夾了。
+      - content: |
+          你看到了 `folder2` 資料夾中的檔案，分別是 `file3.txt` 跟 `file4.txt`。
+          現在你可以離開 `folder2` 回到原本的資料夾了。
     hints:
       - ➤  使用 `cd ..` 回到上一層資料夾
 
@@ -163,9 +169,9 @@ stages:
       pwd:
         - ^/home/commander$
     responses:
-      - content:
-          - 你成功的回到原本的資料夾了。
-          - 恭喜你學會了 `ls` 和 `cd` 指令的用法。
+      - content: |
+          你成功的回到原本的資料夾了。
+          恭喜你學會了 `ls` 和 `cd` 指令的用法。
     hints:
       - ➤  使用 `cd` 指令進出資料夾
       - ➤  使用 `ls` 指令查看資料夾的內容

quests/get-started/answer.sh

@@ -1,3 +1,4 @@
 echo start
 echo hello
+echo next
 echo finish

quests/get-started/game.yml

@@ -5,30 +5,22 @@ instruction: |
   1. 如何使用這個網站
   2. 如何使用終端機
 
-  在畫面的中間可以看到終端機和提示兩個區塊。
-  請你在終端機中的 `commander:~ $` 後面輸入 `echo start` 並按下 Enter 來開始教程。
-  !! 注意：不需要輸入上下引號 !!
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始教程
+    task: 按下 `start` 按鈕開始
     condition:
-      output:
-        - ^start$
+      command:
+        - ^echo start$
     responses:
-      - content:
-          - 你好，我是你的 Unix 助手，我叫做 Ada。我將會在之後協助你了解如何使用終端機。
-          - 現在所在的這個區塊就是終端機，你可以在這裡輸入指令來操作電腦。
-          - 在終端機中，你所看到的
-          - '`commander:~ $` 是指令提示符號，它能讓你知道現在可以輸入指令了。'
-          - 你必須將指令輸入在它的後方。
-          - 當你輸入完指令並按下 Enter 之後，終端機會執行你輸入的指令。
-          - 並且會將執行結果輸出在終端機的下一行。
-          - 這個終端機的功能和你在 Linux 電腦上看到的終端機是一樣的。
-          - 唯一的差別是，在這裡會有劇情和提示來協助你學習如何使用終端機。
-          - 在輸入指令之後，如果你看到用綠色 `=====` 組成的分隔線，代表在分隔線下方的內容是添加的內容，在真實的終端機中不會出現。
-          - 而終端機的輸出，是在綠色 `=====` 分隔線上方的白色內容。
-          - 現在請你輸入 `echo hello` 來看看會發生什麼事。
+      - content: |
+          在畫面的中下方的區塊是終端機，你可以在終端機裡輸入指令來操作電腦。
+          在終端機中，你所看到的 `commander:~ $` 叫做命令提示字串。
+          命令提示字串最後的錢字號 `$` 叫命令提示符，你必須將指令輸入在它的後方。
+          當你輸入完指令並按下 Enter 之後，終端機會執行你輸入的指令，並且會從終端機的下一行開始輸出指令的執行結果。
+          直到你看到新的 `commander:~ $` 出現時，代表你可以輸入下一個指令了。
+          現在請你輸入 `echo hello` 來看看會發生什麼事。
     hints:
       - ➤  在 `commander:~ $` 後面輸入 `echo hello` 並按下 Enter
 
@@ -40,38 +32,41 @@ stages:
       command:
         - ^echo hello$
     responses:
-      - content:
-          - 你應該可以看到終端機上顯示了：
-          - commander:~ $ echo hello
-          - hello
-          - 第一行的 `commander:~ $` 是指令提示符， `echo hello` 是你輸入的指令。
-          - 第二行的 `hello` 則是終端機的輸出。
-      - content:
-          - 現在你知道如何在終端機上輸入指令，以及查看終端機輸出的位置。
-          - 指令必須輸入在指令提示符號的後面，然而當指令提示符消失時，你就無法輸入指令了。
-          - 這時候你可以按下 `Ctrl + C` 來嘗試解決這個問題。
-          - 在終端機中， `Ctrl + C` 並不能用來複製，而是用來中斷目前正在執行的指令。
-          - 因此，如果你前一次的指令執行時卡住了，或是執行很久沒有反應，你可以按下 `Ctrl + C` 來中斷指令，讓你可以繼續輸入指令。
-          - 如果 `Ctrl + C` 也沒有辦法解決問題，可以按按看 `esc` 或 `q` 鍵。如果都沒用的話，按下畫面右下角的 `重來` 按鈕重新開始關卡。
-      - content:
-          - 在終端機下方會顯示提示，你可以用提示右上角的箭頭來查看之前的提示。
-          - 在畫面左邊的區域是關卡說明，你可以在這裡看到關卡的介紹，以及現在需要完成的任務。
-          - 在畫面右邊的區域是檔案樹，它會根據你所探索的資料夾發生變化，讓你更清楚檔案之間的位置關係。
-          - 畫面右上角的圖示分別是 `查看地圖`、`回報錯誤` 以及 `登出` 按鈕。
-      - content:
-          - 第一關的文字內容比較多，可以慢慢讀沒關係。
-          - 如果忘記了也可以隨時回來複習。
-          - 需要的話可以按下 `Enter` 來快速跳過劇情說明。
-          - 如果你已經讀完了上述內容，請輸入 `echo finish` 來結束這一關。
+      - content: |
+          你應該可以看到終端機上顯示了以下內容：
+          ```
+          commander:~ $ echo hello
+          hello
+          ```
+          第一行的 `commander:~ $` 是命令提示字串，接在後方的 `echo hello` 是你輸入的指令。
+          第二行的 `hello` 則是終端機的輸出結果。
+          你現在知道了如何在終端機上輸入指令，以及查看終端機輸出的位置。
+          現在請輸入 `echo next` 來繼續下一個步驟。
     hints:
-      - ➤  按下 `Ctrl + C` 能夠中斷指令
-      - ➤  劇情進行時可以按下 `Enter` 來快速跳過
+      - ➤  輸入 `echo next` 繼續下一個步驟
+
+  - id: echo-next
+    task: 在終端機輸入 `echo next`
+    requirements:
+      - echo-hello
+    condition:
+      command:
+        - ^echo next$
+    responses:
+      - content: |
+          `Ctrl + C` 在終端機中是一個很重要的快捷鍵，它可以用來中斷正在執行的指令，並產生一個新的命令提示字串，讓你可以繼續輸入指令。
+          如果指令執行很久沒有反應，或你因為其他原因想要中斷指令，你可以按下 `Ctrl + C` 來中斷指令。
+          又或者你輸入了錯誤的指令，卻懶得慢慢刪除，你也可以按下 `Ctrl + C` 來產生新的命令提示字串重新輸入指令。
+          如果你已經理解了剛才的說明，請輸入 `echo finish` 來結束這一關。
+    hints:
+      - ➤  按下 `Ctrl + C` 能夠中斷正在執行的指令
+      - ➤  按下 `Ctrl + C` 能夠產生新的命令提示字串
       - ➤  輸入 `echo finish` 來結束這一關
 
   - id: END
     task: 結束關卡
     requirements:
-      - echo-hello
+      - echo-next
     condition:
       command:
         - ^echo finish$

quests/helloworld/game.yml

@@ -21,17 +21,17 @@ stages:
           - 你聽到了一個聲音：
       - type: dialogue
         speaker: Unix 精靈
-        content:
-          - 你好，指令官，我是你的 Unix 精靈。我已在此恭候多時。
-          - 這個世界是在 3560000 時脈以前，由初代王建立了 Unix 律法，所形成的世界。然而在經過了好幾世代的王後，終於誕生了永恆之王——薩加（Saga），她比歷代的君王都更為強大，且從來不會衰老，使得這個世界變得前所未有的強大。
-          - 然而，外在世界一直不斷在改變，同時在面臨外敵的不斷攻擊，而薩加卻始終用同一套治理的手段。最終，在 160000 時脈前的一次入侵中，根部遭到攻陷，薩加遭到封印，而這個國家也陷入了黑暗。
-          - 由於長久以來依賴於薩加，世人已失去了「指令」的力量，即將走向衰敗和滅亡的命運。
-          - 你的任務，就是找回被世人遺忘的指令，奪回 Linux 之根，成為 Linux 之王。
-          - 首先，你必須要學會如何使用指令。
-          - 你要學習的第一個指令，是「搜索」的指令：`ls` (list)。 `ls` 可以用來查看一個目錄中有哪些檔案。
-          - 現在，請你輸入 `ls` 來查看目前的目錄下有哪些檔案。
-    hints: |
-      ➤  使用 `ls` 指令來查看目前的目錄下有哪些檔案。
+        content: |
+          你好，指令官，我是你的 Unix 精靈。我已在此恭候多時。
+          這個世界是在 3560000 時脈以前，由初代王建立了 Unix 律法，所形成的世界。然而在經過了好幾世代的王後，終於誕生了永恆之王——薩加（Saga），她比歷代的君王都更為強大，且從來不會衰老，使得這個世界變得前所未有的強大。
+          然而，外在世界一直不斷在改變，同時在面臨外敵的不斷攻擊，而薩加卻始終用同一套治理的手段。最終，在 160000 時脈前的一次入侵中，根部遭到攻陷，薩加遭到封印，而這個國家也陷入了黑暗。
+          由於長久以來依賴於薩加，世人已失去了「指令」的力量，即將走向衰敗和滅亡的命運。
+          你的任務，就是找回被世人遺忘的指令，奪回 Linux 之根，成為 Linux 之王。
+          首先，你必須要學會如何使用指令。
+          你要學習的第一個指令，是「搜索」的指令：`ls` (list)。 `ls` 可以用來查看一個目錄中有哪些檔案。
+          現在，請你輸入 `ls` 來查看目前的目錄下有哪些檔案。
+    hints:
+      - ➤  使用 `ls` 指令來查看目前的目錄下有哪些檔案。
 
   - id: find-scroll
     task: 搜索卷軸
@@ -44,20 +44,20 @@ stages:
         - ^ls$
     responses:
       - type: narrative
-        content:
-          - 一瞬間，視野變得清晰起來，你發現自己身處在一個石頭建築的房間裡。
-          - 你發現了一個檔案，檔名是 `forgotten-scroll.txt`。
+        content: |
+          一瞬間，視野變得清晰起來，你發現自己身處在一個石頭建築的房間裡。
+          你發現了一個檔案，檔名是 `forgotten-scroll.txt`。
       - type: dialogue
         speaker: Unix 精靈
-        content:
-          - 你找到了一個被遺忘的卷軸，上面寫著解除封印的咒語。
-          - 使用指令 `cat [ 檔案名稱 ]` (concatenate)來查看檔案內容。
-          - 我可以為你提供一些指令的提示，只要輸入指令的前幾個字元，然後按下 `Tab` 鍵，就可以看到提示了。
-          - 例如你只要輸入檔案名稱的前幾個字元，然後按下 `Tab` 鍵，就可以看到提示了。
-    hints: |
-      ➤  使用 `cat [ 檔案名稱 ]` 指令來查看檔案內容。
-      ➤  使用 `Tab` 鍵來取得指令提示。
-      ➤  如果卡在未知的情況，按下 `Ctrl + C` 嘗試離開。
+        content: |
+          你找到了一個被遺忘的卷軸，上面寫著解除封印的咒語。
+          使用指令 `cat [ 檔案名稱 ]` (concatenate)來查看檔案內容。
+          我可以為你提供一些指令的提示，只要輸入指令的前幾個字元，然後按下 `Tab` 鍵，就可以看到提示了。
+          例如你只要輸入檔案名稱的前幾個字元，然後按下 `Tab` 鍵，就可以看到提示了。
+    hints:
+      - ➤  使用 `cat [ 檔案名稱 ]` 指令來查看檔案內容。
+      - ➤  使用 `Tab` 鍵來取得指令提示。
+      - ➤  如果卡在未知的情況，按下 `Ctrl + C` 嘗試離開。
 
   - id: read-forgotten-scroll
     task: 查看卷軸
@@ -71,11 +71,11 @@ stages:
     responses:
       - type: dialogue
         speaker: Unix 精靈
-        content:
-          - 你找到的是一個被遺忘的卷軸，上面寫著解除封印的咒語。
-          - 使用你已經知道的 `echo [ 咒語 ]` 指令來詠唱咒語。
-    hints: |
-      ➤  輸入 `echo Hello World` 來詠唱咒語。
+        content: |
+          你找到的是一個被遺忘的卷軸，上面寫著解除封印的咒語。
+          使用你已經知道的 `echo [ 咒語 ]` 指令來詠唱咒語。
+    hints:
+      - ➤  輸入 `echo Hello World` 來詠唱咒語。
 
   - id: END
     task: 解除封印
@@ -92,6 +92,6 @@ stages:
           - 突然之間，你感覺到一股強大的力量從你的身體中湧出，你的身體開始發光，你的手中出現了一把魔法之劍。
       - type: dialogue
         speaker: Unix 精靈
-        content:
-          - 恭喜您，我的指令官，您已成功解除了封印。
-          - 請跟著在接下來的關卡，一步步取回 Linux 之根吧！
+        content: |
+          恭喜您，我的指令官，您已成功解除了封印。
+          請跟著在接下來的關卡，一步步取回 Linux 之根吧！

quests/move/game.yml

@@ -3,49 +3,49 @@ instruction: |
   在這個關卡中，你將會學到：
   1. 如何用 `mv` 移動檔案與資料夾
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - create
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始
+    task: 按下 `start` 按鈕開始
     condition:
       command:
         - ^echo start$
     responses:
       - type: narrative
-        content:
-          - 今天我們要學習如何移動檔案與資料夾。
-          - 現在資料夾裡有一個 `hello.txt` 跟一個 `world.txt`，以及一個 `notes` 資料夾。
-          - 請先用 `ls` 與 `cat` 來查看它們的內容。
-          - 看完之後，使用 `echo continue` 來繼續吧！
+        content: |
+          今天我們要學習如何移動檔案與資料夾。
+          現在資料夾裡有一個 `hello.txt` 跟一個 `world.txt`，以及一個 `notes` 資料夾。
+          請先用 `ls` 與 `cat` 來查看它們的內容。
+          看完之後，使用 `echo next` 來繼續吧！
     hints:
       - ➤  用 `ls`、`ls notes` 來查看資料夾內的檔案
       - ➤  用 `cat hello.txt` 以及 `cat world.txt` 來查看檔案內容
-      - ➤  完成後輸入 `echo continue` 來繼續
+      - ➤  完成後輸入 `echo next` 來繼續
 
-  - id: continue
+  - id: next
     requirements:
       - start
-    task: 查看檔案內容，完成後輸入 `echo continue` 來繼續
+    task: 查看檔案內容，完成後輸入 `echo next` 來繼續
     condition:
       command:
-        - ^echo continue$
+        - ^echo next$
     responses:
       - type: narrative
-        content:
-          - 現在我們要來學習如何移動檔案與資料夾。
-          - '`mv` 指令是移動 move 的縮寫，可以用來移動檔案與資料夾。'
-          - 使用方式為 `mv [來源] [目的地]`。
-          - 我們先來將 `hello.txt` 移動到 `notes` 資料夾中吧！
+        content: |
+          現在我們要來學習如何移動檔案與資料夾。
+          `mv` 指令是移動 move 的縮寫，可以用來移動檔案與資料夾。
+          使用方式為 `mv [來源] [目的地]`。
+          我們先來將 `hello.txt` 移動到 `notes` 資料夾中吧！
     hints:
       - ➤  使用 `mv hello.txt notes` 來將 `hello.txt` 移動到 `notes` 資料夾中
 
   - id: mv-hello
     requirements:
-      - continue
+      - next
     task: 將 `hello.txt` 移動到 `notes` 資料夾中
     condition:
       command:
@@ -57,9 +57,9 @@ stages:
           exists: false
     responses:
       - type: narrative
-        content:
-          - 你做得很好！
-          - 我們用 `ls` 跟 `ls notes` 來查看一下資料夾內的檔案吧！
+        content: |
+          你做得很好！
+          我們用 `ls` 跟 `ls notes` 來查看一下資料夾內的檔案吧！
     hints:
       - ➤  使用 `ls`、`ls notes` 來查看資料夾內的檔案
 
@@ -74,8 +74,8 @@ stages:
         - ^ls$
     responses:
       - type: narrative
-        content:
-          - '`hello.txt` 已經不在資料夾中了！'
+        content: |
+          `hello.txt` 已經不在資料夾中了！
 
   - id: ls-notes-hello
     requirements:
@@ -90,29 +90,19 @@ stages:
         - hello.txt
     responses:
       - type: narrative
-        content:
-          - '`hello.txt` 出現在 `notes` 資料夾中了！'
-
-  - id: continue-mv
-    requirements:
-      - ls-no-hello
-      - ls-notes-hello
-    task: 輸入 `echo continue` 來繼續
-    condition:
-      command:
-        - ^echo continue$
-    responses:
+        content: |
+          `hello.txt` 出現在 `notes` 資料夾中了！
       - type: narrative
-        content:
-          - '`mv` 指令也可以用來更改檔案名稱。'
-          - '只要將目的地改成新的檔案名稱就可以了。'
-          - 現在我們要將 `world.txt` 更名為 `wow.txt`。
+        content: |
+          `mv` 指令也可以用來更改檔案名稱。
+          只要將目的地改成新的檔案名稱就可以了。
+          現在我們要將 `world.txt` 更名為 `wow.txt`。
     hints:
       - ➤  使用 `mv world.txt wow.txt` 來將 `world.txt` 更名為 `wow.txt`
 
   - id: mv-world
     requirements:
-      - continue-mv
+      - ls-notes-hello
     task: 將 `world.txt` 更名為 `wow.txt`
     condition:
       command:
@@ -124,9 +114,9 @@ stages:
           exists: false
     responses:
       - type: narrative
-        content:
-          - 你做得很好！
-          - 我們用 `ls` 來確認一下資料夾內的檔案吧！
+        content: |
+          你做得很好！
+          我們用 `ls` 來確認一下資料夾內的檔案吧！
     hints:
       - ➤  使用 `ls` 來查看資料夾內的檔案
 
@@ -143,12 +133,12 @@ stages:
         - wow.txt
     responses:
       - type: narrative
-        content:
-          - '`world.txt` 現在已經變成 `wow.txt` 了。'
-          - 接下來我們來學習如何移動資料夾吧！
-          - 移動資料夾非常簡單，方法跟移動檔案一樣。
-          - '`mv` 指令會自動將資料夾內的所有檔案一起移動'
-          - 我們先來將 `notes` 資料夾改名叫作 `docs` 吧！
+        content: |
+          `world.txt` 現在已經變成 `wow.txt` 了。
+          接下來我們來學習如何移動資料夾吧！
+          移動資料夾非常簡單，方法跟移動檔案一樣。
+          `mv` 指令會自動將資料夾內的所有檔案一起移動
+          我們先來將 `notes` 資料夾改名叫作 `docs` 吧！
     hints:
       - ➤  使用 `mv notes docs` 來將 `notes` 資料夾改名叫作 `docs`
 
@@ -166,9 +156,9 @@ stages:
           exists: false
     responses:
       - type: narrative
-        content:
-          - 你做得很好！
-          - 我們用 `ls` 來確認一下資料夾內的檔案吧！
+        content: |
+          你做得很好！
+          我們用 `ls` 來確認一下資料夾內的檔案吧！
     hints:
       - ➤  使用 `ls` 來查看資料夾內的檔案
 
@@ -185,11 +175,11 @@ stages:
         - docs
     responses:
       - type: narrative
-        content:
-          - '`notes` 資料夾已經變成 `docs` 了。'
-          - 那麼最後來考考你：
-          - 試著將 `docs/hello.txt` 移動到家目錄底下的 `hi.txt`。
-          - 如果你不知道怎麼做，可以輸入 `echo hint` 來取得提示。
+        content: |
+          `notes` 資料夾已經變成 `docs` 了。
+          那麼最後來考考你：
+          試著將 `docs/hello.txt` 移動到家目錄底下的 `hi.txt`。
+          如果你不知道怎麼做，可以輸入 `echo hint` 來取得提示。
 
   - id: END
     requirements:
@@ -209,12 +199,12 @@ stages:
             - ^echo hint$
         responses:
           - type: narrative
-            content:
-              - 你可以使用 `mv docs/hello.txt hi.txt` 來完成這個任務。
+            content: |
+              你可以使用 `mv docs/hello.txt hi.txt` 來完成這個任務。
         hints:
           - ➤  使用 `mv docs/hello.txt hi.txt` 來將 `docs/hello.txt` 移動到家目錄底下的 `hi.txt`
     responses:
       - type: narrative
-        content:
-          - 你做得很好！
-          - 你已經學會如何移動檔案與資料夾了！
+        content: |
+          你做得很好！
+          你已經學會如何移動檔案與資料夾了！

quests/path/game.yml

@@ -4,7 +4,7 @@ instruction: |
   1. 絕對路徑和相對路徑
   2. 如何使用 `pwd` 顯示目前的路徑
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - cast
@@ -12,16 +12,16 @@ requirements:
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始教程
+    task: 按下 `start` 按鈕開始教程
     condition:
-      output:
-        - ^start$
+      command:
+        - ^echo start$
     responses:
-      - content:
-          - 在 Linux 系統中，每個資料夾和檔案都有獨一無二的路徑。
-          - 而路徑又分為相對路徑和絕對路徑。
-          - 相對路徑是從目前所在的資料夾開始的路徑，而絕對路徑則是從根目錄開始的路徑。
-          - 請你先用 `ls` 指令查看這個資料夾中的檔案。
+      - content: |
+          在 Linux 系統中，每個資料夾和檔案都有獨一無二的路徑。
+          而路徑又分為相對路徑和絕對路徑。
+          相對路徑是從目前所在的資料夾開始的路徑，而絕對路徑則是從根目錄開始的路徑。
+          請你先用 `ls` 指令查看這個資料夾中的檔案。
 
   - id: ls
     task: 查看資料夾中的檔案
@@ -33,8 +33,8 @@ stages:
       command:
         - ^ls$
     responses:
-      - content:
-          - 現在你使用 `cd` 指令進入 `folder1` 資料夾。
+      - content: |
+          現在你使用 `cd` 指令進入 `folder1` 資料夾。
 
   - id: cd-folder1
     task: 進入 `folder1` 資料夾
@@ -44,14 +44,14 @@ stages:
       pwd:
         - ^/home/commander/folder1$
     responses:
-      - content:
-          - 你進入了 `folder1` 資料夾。
-          - 在進入 `folder1` 資料夾時，使用的 `cd folder1` 中的 `folder1` 就是相對路徑。
-          - 相同的道理 `cd ..` 中的 `..` 也是相對路徑。
-          - 相對路徑可以不只有一層資料夾。
-          - 例如：現在想要進入 `folder2` 資料夾的話，可以使用 `cd ..` 回到上一層資料夾，再使用 `cd folder2` 進入 `folder2` 資料夾。
-          - 然而，你也可以用 `/` 將 `..` 和 `folder2` 依序連接起來，使用 `cd ../folder2` 來一次進入 `folder2` 資料夾。
-          - 現在試著用這個方式進入 `folder2` 資料夾看看吧。
+      - content: |
+          你進入了 `folder1` 資料夾。
+          在進入 `folder1` 資料夾時，使用的 `cd folder1` 中的 `folder1` 就是相對路徑。
+          相同的道理 `cd ..` 中的 `..` 也是相對路徑。
+          相對路徑可以不只有一層資料夾。
+          例如：現在想要進入 `folder2` 資料夾的話，可以使用 `cd ..` 回到上一層資料夾，再使用 `cd folder2` 進入 `folder2` 資料夾。
+          然而，你也可以用 `/` 將 `..` 和 `folder2` 依序連接起來，使用 `cd ../folder2` 來一次進入 `folder2` 資料夾。
+          現在試著用這個方式進入 `folder2` 資料夾看看吧。
     hints:
       - ➤  請輸入 `cd ../folder2` 來進入 `folder2` 資料夾。
 
@@ -68,14 +68,14 @@ stages:
             - ^/home/commander$
         responses:
           - type: narrative
-            content:
-              - 輸入 `cd folder2` 來進入 `folder2` 資料夾
+            content: |
+              輸入 `cd folder2` 來進入 `folder2` 資料夾
     responses:
-      - content:
-          - 你成功的用相對路徑進入了 `folder2` 資料夾。
-          - 而你也能夠在 `ls` 後加上相對路徑來查看其他資料夾的內容。
-          - 例如：現在你想要查看 `folder1` 資料夾中有哪些檔案，你可以使用 `ls ../folder1` 來查看。
-          - 試著用這個方式查看 `folder1` 資料夾中的檔案吧。
+      - content: |
+          你成功的用相對路徑進入了 `folder2` 資料夾。
+          而你也能夠在 `ls` 後加上相對路徑來查看其他資料夾的內容。
+          例如：現在你想要查看 `folder1` 資料夾中有哪些檔案，你可以使用 `ls ../folder1` 來查看。
+          試著用這個方式查看 `folder1` 資料夾中的檔案吧。
     hints:
       - ➤  請輸入 `ls ../folder1` 來查看 `folder1` 資料夾中的檔案。
 
@@ -93,16 +93,16 @@ stages:
               - ^/home/commander/folder2$
         responses:
           - type: narrative
-            content:
-              - 進到 `folder1` 資料夾並用 `ls` 查看內容。
+            content: |
+              進到 `folder1` 資料夾並用 `ls` 查看內容。
     responses:
-      - content:
-          - 很好，你現在知道如何運用相對路徑了。
-          - 接下來要介紹的是絕對路徑。
-          - 絕對路徑是從根目錄開始的路徑，根目錄是位於檔案樹的最上層的資料夾。
-          - 你可以使用 `pwd` 來查看目前所在的絕對路徑。
-          - '`pwd` 的意思是 `print working directory`，也就是顯示目前所在的路徑。'
-          - 現在請你使用 `pwd` 來查看目前所在的絕對路徑。
+      - content: |
+          很好，你現在知道如何運用相對路徑了。
+          接下來要介紹的是絕對路徑。
+          絕對路徑是從根目錄開始的路徑，根目錄是位於檔案樹的最上層的資料夾。
+          你可以使用 `pwd` 來查看目前所在的絕對路徑。
+          `pwd` 的意思是 `print working directory`，也就是顯示目前所在的路徑。
+          現在請你使用 `pwd` 來查看目前所在的絕對路徑。
     hints:
       - ➤  輸入 `pwd` 查看目前所在的絕對路徑
 
@@ -122,17 +122,17 @@ stages:
               - ^/home/commander/folder2$
         responses:
           - type: narrative
-            content:
-              - 請先回到 `folder2` 資料夾，並用 `pwd` 來查看目前所在的絕對路徑
+            content: |
+              請先回到 `folder2` 資料夾，並用 `pwd` 來查看目前所在的絕對路徑
     responses:
-      - content:
-          - 你可以看到你現在的絕對路徑是 `/home/commander/folder2`。
-          - 而絕對路徑其實也顯示在你的命令提示符中。
-          - '`commander:~/folder2 $` 中的 `~/folder2` 就是你的絕對路徑。'
-          - 而 `~` 則是 `/home/commander` 這個絕對路徑的縮寫，又稱為家目錄，你每次遊戲都會從這裡開始。
-          - '`ls` 和 `cd` 指令也可以使用絕對路徑。'
-          - 例如：你可以使用 `ls ~` 來查看家目錄的內容，或使用 `cd ~` 來回到家目錄。
-          - 現在請你使用 `ls ~` 來查看家目錄的內容。
+      - content: |
+          你可以看到你現在的絕對路徑是 `/home/commander/folder2`。
+          而絕對路徑其實也顯示在你的命令提示符中。
+          `commander:~/folder2 $` 中的 `~/folder2` 就是你的絕對路徑。
+          而 `~` 則是 `/home/commander` 這個絕對路徑的縮寫，又稱為家目錄，你每次遊戲都會從這裡開始。
+          `ls` 和 `cd` 指令也可以使用絕對路徑。
+          例如：你可以使用 `ls ~` 來查看家目錄的內容，或使用 `cd ~` 來回到家目錄。
+          現在請你使用 `ls ~` 來查看家目錄的內容。
     hints:
       - ➤  輸入 `ls ~` 來查看家目錄的內容
 
@@ -144,8 +144,8 @@ stages:
       command:
         - ^ls ~$
     responses:
-      - content:
-          - 現在請使用 `cd ~` 回到家目錄。
+      - content: |
+          現在請使用 `cd ~` 回到家目錄。
     hints:
       - ➤  輸入 `cd ~` 來回到家目錄
 
@@ -162,9 +162,9 @@ stages:
             - ^/home/commander$
         responses:
           - type: narrative
-            content:
-              - 請使用 `cd ~` 回到家目錄
+            content: |
+              請使用 `cd ~` 回到家目錄
     responses:
-      - content:
-          - 你回到家目錄了。
-          - 恭喜！現在你已經知道如何運用絕對路徑和相對路徑，以及查看目前所在的絕對路徑了。
+      - content: |
+          你回到家目錄了。
+          恭喜！現在你已經知道如何運用絕對路徑和相對路徑，以及查看目前所在的絕對路徑了。

quests/read/game.yml

@@ -3,24 +3,24 @@ instruction: |
   在這個關卡中，你將會學到：
   1. 如何使用 `cat` 查看檔案的內容
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - path
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始教程
+    task: 按下 `start` 按鈕開始教程
     condition:
-      output:
-        - ^start$
+      command:
+        - ^echo start$
     responses:
-      - content:
-          - 在終端機中，並沒有圖形介面可以讓你查看檔案的內容。
-          - 但是你可以透過 `cat` 指令來查看檔案的內容。
-          - '`cat` 指令是 concatenate 的縮寫，也就是串接的意思。'
-          - 在輸入 `cat [檔案名稱]` 指令後，終端機會輸出檔案的內容。
-          - 請你先查看這個資料夾中哪些檔案。
+      - content: |
+          在終端機中，並沒有圖形介面可以讓你查看檔案的內容。
+          但是你可以透過 `cat` 指令來查看檔案的內容。
+          `cat` 指令是 concatenate 的縮寫，也就是串接的意思。
+          在輸入 `cat [檔案名稱]` 指令後，終端機會輸出檔案的內容。
+          請你先查看這個資料夾中哪些檔案。
     hints:
       - ➤  請輸入 `ls` 來查看這個資料夾中的檔案。
 
@@ -34,9 +34,9 @@ stages:
       command:
         - ^ls$
     responses:
-      - content:
-          - 這個資料夾中有一個檔案和一個資料夾。
-          - 現在你可以使用 `cat` 指令來查看 `file1.txt` 的內容。
+      - content: |
+          這個資料夾中有一個檔案和一個資料夾。
+          現在你可以使用 `cat` 指令來查看 `file1.txt` 的內容。
     hints:
       - ➤  請輸入 `cat file1.txt` 來查看檔案的內容。
 
@@ -50,10 +50,10 @@ stages:
       command:
         - ^cat file1.txt$
     responses:
-      - content:
-          - 你應該能看到檔案的內容了。
-          - '`cat` 指令也可以使用路徑來查看檔案內容'
-          - 請你先用 `ls folder` 查看資料夾內的檔案。
+      - content: |
+          你應該能看到檔案的內容了。
+          `cat` 指令也可以使用路徑來查看檔案內容
+          請你先用 `ls folder` 查看資料夾內的檔案。
     hints:
       - ➤  輸入 `ls folder` 查看資料夾內的檔案
 
@@ -71,13 +71,13 @@ stages:
           not:
             pwd:
               - ^/home/commander$
-        content:
-          - 請留在 `/home/commander` 資料夾中。
-          - 請輸入 `cd ~` 回到 `/home/commander` 資料夾。
+        content: |
+          請留在 `/home/commander` 資料夾中。
+          請輸入 `cd ~` 回到 `/home/commander` 資料夾。
     responses:
-      - content:
-          - 你現在知道 `folder` 資料夾的內容了。
-          - 請用 `cat` 指令來查看 `folder` 資料夾中的 `file.txt` 檔案。
+      - content: |
+          你現在知道 `folder` 資料夾的內容了。
+          請用 `cat` 指令來查看 `folder` 資料夾中的 `file.txt` 檔案。
     hints:
       - ➤  輸入 `cat folder/file.txt` 查看 `file.txt` 檔案的內容。
 
@@ -95,10 +95,12 @@ stages:
           not:
             pwd:
               - ^/home/commander$
-        content:
-          - 請留在 `/home/commander` 資料夾中。
-          - 請輸入 `cd ~` 回到 `/home/commander` 資料夾。
+        responses:
+          - type: narrative
+            content: |
+              請留在 `/home/commander` 資料夾中。
+              請輸入 `cd ~` 回到 `/home/commander` 資料夾。
     responses:
-      - content:
-          - 你成功地查看到 `file.txt` 的內容了。
-          - 你已經會使用 `cat` 指令查看檔案的內容了。
+      - content: |
+          你成功地查看到 `file.txt` 的內容了。
+          你已經會使用 `cat` 指令查看檔案的內容了。

quests/remove/answer.sh

@@ -1,4 +1,5 @@
 echo start
+ls
 rm hello.txt
 ls
 rm world.txt wow.txt

quests/remove/game.yml

@@ -6,7 +6,7 @@ instruction: |
   3. 用 `rm -r` 刪除資料夾與它的所有檔案
   現在資料夾裡有一些檔案與資料夾，請你使用 `ls` 跟 `cat` 來查看它們的內容。
 
-  準備好就輸入 `echo start` 開始吧！
+  按下中間的 `start` 按鈕來開始這個關卡。
 
 requirements:
   - copy
@@ -14,33 +14,44 @@ requirements:
 
 stages:
   - id: start
-    task: 輸入 `echo start` 來開始
+    task: 按下 `start` 按鈕開始
     condition:
       command:
-        - ^echo
-      output:
-        - start
+        - ^echo start$
     responses:
-      - content:
-          - 今天我們要學習如何刪除檔案與資料夾。
-          - '首先要來學習 `rm` 指令。`rm` 指令可以用來刪除檔案。使用方式是 `rm [檔案名稱]`。'
-          - '現在請你使用 `rm` 指令刪除 `hello.txt`。'
+      - content: |
+          今天我們要學習如何刪除檔案與資料夾。
+          請先使用 `ls` 指令查看資料夾內容。
+    hints:
+      - ➤  使用 `ls` 來查看資料夾內容。
+
+  - id: ls
+    requirements:
+      - start
+    task: 使用 `ls` 查看資料夾內容
+    condition:
+      command:
+        - ^ls$
+    responses:
+      - content: |
+          首先要來學習 `rm` 指令。`rm` 指令可以用來刪除檔案。使用方式是 `rm [檔案名稱]`。
+          現在請你使用 `rm` 指令刪除 `hello.txt`。
     hints:
       - ➤  使用 `rm hello.txt` 來刪除 `hello.txt`。
 
   - id: rm-hello
     requirements:
-      - start
+      - ls
     task: 使用 `rm` 刪除 `hello.txt`
     condition:
       command:
-        - ^rm
+        - ^rm\s
       files:
         - path: hello.txt
           exists: false
     responses:
-      - content:
-          - '很好！現在請你使用 `ls` 指令來查看資料夾內容。'
+      - content: |
+          很好！現在請你使用 `ls` 指令來查看資料夾內容。
 
   - id: ls-no-hello
     requirements:
@@ -48,15 +59,15 @@ stages:
     task: 使用 `ls` 查看資料夾內容
     condition:
       command:
-        - ^ls
+        - ^ls$
       files:
         - path: hello.txt
           exists: false
     responses:
-      - content:
-          - '你會發現 `hello.txt` 已經不見了。'
-          - '`rm` 也可以同時刪除多個檔案，只要把檔案名稱用空白隔開就可以了，也就是 `rm [檔案1] [檔案2] ...`。'
-          - 現在請你使用 `rm` 刪除 `world.txt` 與 `wow.txt`。
+      - content: |
+          你會發現 `hello.txt` 已經不見了。
+          `rm` 也可以同時刪除多個檔案，只要把檔案名稱用空白隔開就可以了，也就是 `rm [檔案1] [檔案2] ...`。
+          現在請你使用 `rm` 刪除 `world.txt` 與 `wow.txt`。
     hints:
       - ➤  使用 `rm world.txt wow.txt` 來刪除 `world.txt` 與 `wow.txt`。
       - ➤  檔案名稱之間要用空白隔開。
@@ -75,8 +86,8 @@ stages:
         - path: wow.txt
           exists: false
     responses:
-      - content:
-          - '很好！我們一樣用 `ls` 指令確認一下資料夾內容。'
+      - content: |
+          很好！我們一樣用 `ls` 指令確認一下資料夾內容。
     hints:
       - ➤  使用 `ls` 來查看資料夾內容。
 
@@ -88,10 +99,10 @@ stages:
       command:
         - ^ls$
     responses:
-      - content:
-          - '你會發現 `world.txt` 與 `wow.txt` 已經不見了。'
-          - '現在我們來學習 `rmdir` 指令。`rmdir` 指令可以用來刪除資料夾。使用方式是 `rmdir [資料夾名稱]`。'
-          - '現在請你使用 `rmdir` 指令刪除 `empty` 資料夾。'
+      - content: |
+          你會發現 `world.txt` 與 `wow.txt` 已經不見了。
+          現在我們來學習 `rmdir` 指令。`rmdir` 指令可以用來刪除資料夾。使用方式是 `rmdir [資料夾名稱]`。
+          現在請你使用 `rmdir` 指令刪除 `empty` 資料夾。
     hints:
       - ➤  使用 `rmdir empty` 來刪除 `empty` 資料夾。
 
@@ -101,13 +112,13 @@ stages:
     task: 使用 `rmdir` 刪除 `empty` 資料夾
     condition:
       command:
-        - ^rmdir
+        - ^rmdir empty$
       files:
         - path: empty
           exists: false
     responses:
-      - content:
-          - '很好！現在請你使用 `ls` 指令來查看資料夾內容。'
+      - content: |
+          很好！現在請你使用 `ls` 指令來查看資料夾內容。
 
   - id: ls-no-empty
     requirements:
@@ -117,9 +128,9 @@ stages:
       command:
         - ^ls$
     responses:
-      - content:
-          - '你會發現 `empty` 資料夾已經不見了。'
-          - '現在請你試試看 `rmdir` 指令刪除 `notes` 資料夾。'
+      - content: |
+          你會發現 `empty` 資料夾已經不見了。
+          現在請你試試看 `rmdir` 指令刪除 `notes` 資料夾。
     hints:
       - ➤  使用 `rmdir notes` 來刪除 `notes` 資料夾
 
@@ -135,12 +146,12 @@ stages:
           type: folder
           exists: true
     responses:
-      - content:
-          - 指令執行失敗了！
-          - '你會發現 `notes` 資料夾還在。'
-          - '這是因為 `rmdir` 指令只能刪除空的資料夾。'
-          - 我們先來將 `notes` 資料夾的檔案刪除再來試一次。
-          - '現在請你使用 `rm` 指令刪除 `notes` 資料夾內的檔案。'
+      - content: |
+          指令執行失敗了！
+          你會發現 `notes` 資料夾還在。
+          這是因為 `rmdir` 指令只能刪除空的資料夾。
+          我們先來將 `notes` 資料夾的檔案刪除再來試一次。
+          現在請你使用 `rm` 指令刪除 `notes` 資料夾內的檔案。
     hints:
       - ➤  使用 `rm notes/[檔案名稱]` 來刪除 `notes` 資料夾內的檔案。
       - ➤  你可能需要使用 `ls notes` 來查看 `notes` 資料夾內有哪些檔案。
@@ -163,31 +174,29 @@ stages:
           command:
             - ^rm notes/\[.*\]
         responses:
-          - content:
-              - '你好像理解錯了。'
-              - 這邊中括號包起來 `[檔案名稱]` 是參數的意思，需要你自己填入檔案的名稱。
-              - 實際打指令的時候，不要打中括號 `[]` 喔！
-              - '例如，如果要刪除 `notes` 資料夾內的 `note.txt` 檔案，指令應該要是 `rm notes/note.txt`。'
-              - 請先用 `ls notes` 確認 `notes` 資料夾內有哪些檔案，再來試試看吧！
+          - content: |
+              你好像理解錯了。
+              這邊中括號包起來 `[檔案名稱]` 是參數的意思，需要你自己填入檔案的名稱。
+              實際打指令的時候，不要打中括號 `[]` 喔！
+              例如，如果要刪除 `notes` 資料夾內的 `note.txt` 檔案，指令應該要是 `rm notes/note.txt`。
+              請先用 `ls notes` 確認 `notes` 資料夾內有哪些檔案，再來試試看吧！
       - condition:
           command:
-            - ^rm
-          error:
-            - 'No such file or directory'
+            - ^rmdir notes$
         responses:
-          - content:
-              - 這個錯誤的意思是找不到檔案
-              - '請先用 `ls notes` 確認 `notes` 資料夾內有哪些檔案，再來試試看吧！'
+          - content: |
+              這個錯誤的意思是找不到檔案
+              請先用 `ls notes` 確認 `notes` 資料夾內有哪些檔案，再來試試看吧！
       - condition:
           command:
             - ^ls notes$
         responses:
-          - content:
-              - '`notes` 資料夾中有著 `note.txt` 檔案。'
-              - 那我們就使用 `rm notes/note.txt` 來刪除 `note.txt` 檔案吧！
+          - content: |
+              `notes` 資料夾中有著 `note.txt` 檔案。
+              那我們就使用 `rm notes/note.txt` 來刪除 `note.txt` 檔案吧！
     responses:
-      - content:
-          - '很好！現在我們再使用 `rmdir` 指令刪除 `notes` 資料夾。'
+      - content: |
+          很好！現在我們再使用 `rmdir` 指令刪除 `notes` 資料夾。
     hints:
       - ➤  使用 `rmdir notes` 來刪除 `notes` 資料夾。
 
@@ -196,16 +205,14 @@ stages:
       - rm-notes-content
     task: 使用 `rmdir` 刪除 `notes` 資料夾
     condition:
-      command:
-        - ^rmdir
       files:
         - path: notes
           exists: false
     responses:
-      - content:
-          - '很好！`notes` 資料夾已經被刪除了。'
-          - 接下來我們來刪除 `trash` 資料夾。
-          - 先使用 `ls` 指令查看一下 `trash` 資料夾內容。
+      - content: |
+          很好！`notes` 資料夾已經被刪除了。
+          接下來我們來刪除 `trash` 資料夾。
+          先使用 `ls` 指令查看一下 `trash` 資料夾內容。
     hints:
       - ➤  使用 `ls trash` 來查看 `trash` 中的檔案。
 
@@ -215,16 +222,14 @@ stages:
     task: 使用 `ls` 查看 `trash` 資料夾內容
     condition:
       command:
-        - ^ls
-      output:
-        - garbage.txt
+        - ^ls trash$
     responses:
-      - content:
-          - 天啊！`trash` 資料夾裡有好多檔案，甚至還有其他的資料夾！
-          - 如果今天資料夾中有很多檔案與資料夾，我們不想一個一個刪除，該怎麼辦呢？
-          - 跟 `cp` 的時候一樣，這時候我們可以加上 `-r` 的選項來刪除資料夾與它的所有檔案。
-          - '`-r` 的意思是遞迴（recursive），也就是會把資料夾中的所有檔案都刪除。'
-          - 我們來試試看吧！
+      - content: |
+          天啊！`trash` 資料夾裡有好多檔案，甚至還有其他的資料夾！
+          如果今天資料夾中有很多檔案與資料夾，我們不想一個一個刪除，該怎麼辦呢？
+          跟 `cp` 的時候一樣，這時候我們可以加上 `-r` 的選項來刪除資料夾與它的所有檔案。
+          `-r` 的意思是遞迴（recursive），也就是會把資料夾中的所有檔案都刪除。
+          我們來試試看吧！
     hints:
       - ➤  使用 `rm -r trash` 來刪除 `trash` 資料夾。
 
@@ -234,13 +239,13 @@ stages:
     task: 使用 `rm -r` 刪除 `trash` 資料夾
     condition:
       command:
-        - ^rm -r
+        - ^rm -r trash$
       files:
         - path: trash
           exists: false
     responses:
-      - content:
-          - '很好！現在請你使用 `ls` 指令查看資料夾內容。'
+      - content: |
+          很好！現在請你使用 `ls` 指令查看資料夾內容。
     hints:
       - ➤  使用 `ls` 來查看資料夾內容。
 
@@ -252,6 +257,6 @@ stages:
       command:
         - ^ls$
     responses:
-      - content:
-          - '`trash` 資料夾已經不見了。'
-          - 恭喜你！你已經學會如何刪除檔案與資料夾了！
+      - content: |
+          `trash` 資料夾已經不見了。
+          恭喜你！你已經學會如何刪除檔案與資料夾了！

server/migrations/0001-add-isGuest.ts

@@ -0,0 +1,23 @@
+import connectDB, { User } from '@linux-odyssey/models'
+
+async function migrate() {
+  await connectDB(
+    process.env.MONGO_URL || 'mongodb://localhost:27017/odyssey-test'
+  )
+  await User.updateMany(
+    {
+      isGuest: { $exists: false },
+    },
+    { $set: { isGuest: false } }
+  )
+}
+
+migrate()
+  .then(() => {
+    console.log('Migration completed')
+    process.exit(0)
+  })
+  .catch((err) => {
+    console.error(err)
+    process.exit(1)
+  })

server/package.json

@@ -9,7 +9,8 @@
     "clean": "node dist/cli/clean.js",
     "build": "tsc -b",
     "dev": "nodemon",
-    "build:quests": "node dist/cli/build.js"
+    "build:quests": "node dist/cli/build.js",
+    "ts-node": "node --loader ts-node/esm"
   },
   "dependencies": {
     "@linux-odyssey/constants": "*",
@@ -20,6 +21,7 @@
     "commander": "^11.0.0",
     "connect-mongo": "^5.0.0",
     "cookie-parser": "^1.4.6",
+    "date-fns": "^3.6.0",
     "dockerode": "^3.3.5",
     "dotenv": "^16.4.1",
     "express": "^4.19.2",

server/src/api/controllers/authController.ts

@@ -1,7 +1,7 @@
 import type { Request, Response, NextFunction, Express } from 'express'
 import { matchedData } from 'express-validator'
 import { genJWT } from '../../utils/auth.js'
-import { createUser } from '../../models/userManager.js'
+import { createUser, createGuestUser } from '../../models/userManager.js'
 import { asyncHandler } from '../../middleware/error.js'
 import logger from '../../utils/logger.js'
 
@@ -39,6 +39,30 @@ export const register = asyncHandler(
   }
 )
 
+export const registerGuest = asyncHandler(
+  async (req: Request, res: Response) => {
+    const user = await createGuestUser()
+    req.login(
+      {
+        id: user.id,
+        username: user.username,
+        email: user.email,
+      },
+      (err) => {
+        if (err) {
+          res.status(500).json({
+            message: 'error logging in',
+          })
+          return
+        }
+        res.status(201).json({
+          message: 'user created',
+        })
+      }
+    )
+  }
+)
+
 export function logout(req: Request, res: Response) {
   req.logout((err) => {
     if (err) {

server/src/api/controllers/commandController.ts

@@ -49,8 +49,6 @@ export const newCommand = asyncHandler(async (req: Request, res: Response) => {
     c.stage = response.stage
     await c.save()
 
-    session.responses.push(response.responses)
-
     if ((session.status as string) === 'finished') {
       await finishSession(session)
     }

server/src/api/controllers/sessionController.ts

@@ -3,7 +3,6 @@ import type { Express, Request, Response } from 'express'
 import { User, Session, ISession } from '@linux-odyssey/models'
 import {
   createNewSession,
-  getOrCreateActiveSession,
   isQuestUnlocked,
 } from '../../models/sessionManager.js'
 import { asyncHandler } from '../../middleware/error.js'
@@ -56,7 +55,6 @@ export const createSession = asyncHandler(
 export const getSessionById = asyncHandler(
   async (req: Request, res: Response) => {
     const { sessionId } = matchedData(req)
-    console.log(sessionId)
     const session = await Session.findOne({
       _id: sessionId,
       user: (req.user as Express.ExistingUser).id,
@@ -71,7 +69,7 @@ export const getSessionById = asyncHandler(
   }
 )
 
-export const getOrCreateSession = asyncHandler(
+export const getActiveSessionHandler = asyncHandler(
   async (req: Request, res: Response) => {
     const { questId } = matchedData(req)
     const user = await User.findById((req.user as Express.ExistingUser).id)
@@ -79,8 +77,12 @@ export const getOrCreateSession = asyncHandler(
       user &&
       ((await isQuestUnlocked(user, questId)) || config.testing.enabled)
     ) {
-      const session = await getOrCreateActiveSession(user, questId)
-      res.json(sessionDetail(session))
+      const session = await Session.findOne({
+        user: user.id,
+        quest: questId,
+        status: 'active',
+      })
+      res.json(session ? sessionDetail(session) : null)
     } else {
       res.status(403).json({ message: 'Quest is locked.' })
     }

server/src/api/routes/authRouter.ts

@@ -9,6 +9,7 @@ import {
   logout,
   registerFromSession,
   socialLoginHandler,
+  registerGuest,
 } from '../controllers/authController.js'
 import {
   checkUsernameValidators,
@@ -32,6 +33,8 @@ router.post(
 
 router.post('/register', authenticateRateLimit, registerValidators, register)
 
+router.post('/register-guest', authenticateRateLimit, registerGuest)
+
 router.post('/logout', logout)
 
 router.get(

server/src/api/routes/sessionRouter.ts

@@ -17,10 +17,10 @@ router.post(
   sessionRateLimit,
   sessionController.createSession
 )
-router.post(
+router.get(
   '/active',
   activeSessionValidator,
-  sessionController.getOrCreateSession
+  sessionController.getActiveSessionHandler
 )
 router.get(
   '/:sessionId',

server/src/api/socket.ts

@@ -8,7 +8,6 @@ import SessionMiddleware from '../middleware/session.js'
 import { genJWT } from '../utils/auth.js'
 import logger from '../utils/logger.js'
 
-// eslint-disable-next-line no-unused-vars
 type SocketCallback = (event: string, ...args: any[]) => void
 
 const sessions = new Map<string, SocketCallback[]>()
@@ -44,7 +43,6 @@ async function connectContainer(socket: Socket, next: (err?: Error) => void) {
     next(new Error('User not found.'))
     return
   }
-  // console.log(socket.handshake)
   const { sessionId } = socket.handshake.query
   if (
     !sessionId ||
@@ -79,7 +77,7 @@ async function connectContainer(socket: Socket, next: (err?: Error) => void) {
       stream,
     }
     next()
-  } catch (err) {
+  } catch {
     next(new Error('Failed to start container.'))
   }
 }

server/src/containers/docker.ts

@@ -82,7 +82,7 @@ export async function deleteContainer(id: string) {
   }
   try {
     await container.stop()
-  } catch (error) {
+  } catch {
     logger.warn('Failed to stop container', id)
   }
   await container.remove()

server/src/game/commandHandler.ts

@@ -112,7 +112,7 @@ export default class CommandHandler extends SessionHandler {
         )
       )
       return checks.every((c) => c === true)
-    } catch (e) {
+    } catch {
       return false
     }
   }

server/src/models/sessionManager.ts

@@ -79,21 +79,6 @@ export async function createNewSession(
   return session
 }
 
-export async function getOrCreateActiveSession(
-  user: HydratedDocument<IUser>,
-  questId: string
-): Promise<ISession> {
-  const session = await Session.findOne({
-    user,
-    quest: questId,
-    status: 'active',
-  })
-  if (session) {
-    return session
-  }
-  return createNewSession(user, questId)
-}
-
 export async function finishSession(
   session: HydratedDocument<ISession>
 ): Promise<void> {

server/src/models/userManager.ts

@@ -1,4 +1,5 @@
 import { Express } from 'express'
+import { format } from 'date-fns'
 import { User, UserProfile } from '@linux-odyssey/models'
 import { hashPassword } from '../utils/auth.js'
 
@@ -31,6 +32,23 @@ export async function createUser(
   return user
 }
 
+export async function createGuestUser() {
+  const username = `guest_${format(new Date(), 'yyyyMMddHHmmss')}`
+  const user = new User({
+    username,
+    email: `${username}@example.com`,
+    isGuest: true,
+  })
+  await user.save()
+
+  const profile = new UserProfile({
+    user,
+  })
+  await profile.save()
+
+  return user
+}
+
 export function leaderboard() {
   return UserProfile.aggregate([
     {

server/swagger.yaml

@@ -1,14 +1,14 @@
 openapi: 3.0.0
 servers:
   - url: /api/v1
-  - url: https://odyssey.wancat.cc/api/v1
+  - url: https://linuxodyssey.xyz/api/v1
   - url: http://localhost:3000/api/v1
 info:
   description: Linux Odyssey API
   version: '1.0.0'
   title: Session API
   contact:
-    email: wancat@wancat.cc
+    email: contact@linuxodyssey.xyz
   license:
     name: Apache 2.0
     url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
@@ -37,6 +37,19 @@ paths:
           schema:
             type: string
             enum: [active, finished, inactive]
+        - in: query
+          name: limit
+          description: limit the number of sessions to return
+          schema:
+            type: number
+            example: 10
+        - in: query
+          name: order
+          description: order the sessions by createdAt
+          schema:
+            type: string
+            enum: [asc, desc]
+            example: desc
       responses:
         '200':
           description: list of existing session
@@ -233,6 +246,22 @@ paths:
                 type: string
                 example: connect.sid=s%3Aq1Z; Path=/; HttpOnly; SameSite=Strict; Secure
 
+  /auth/register-guest:
+    post:
+      summary: Register a new guest user
+      responses:
+        201:
+          description: User created
+          headers:
+            Set-Cookie:
+              schema:
+                type: string
+                example: connect.sid=s%3Aq1Z; Path=/; HttpOnly; SameSite=Strict; Secure
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/User'
+
   /auth/login:
     post:
       summary: Log in a user

yarn.lock

@@ -2479,6 +2479,11 @@
     "@vue/compiler-dom" "3.4.19"
     "@vue/shared" "3.4.19"
 
+"@vue/devtools-api@^6.5.0":
+  version "6.6.3"
+  resolved "https://registry.yarnpkg.com/@vue/devtools-api/-/devtools-api-6.6.3.tgz#b23a588154cba8986bba82b6e1d0248bde3fd1a0"
+  integrity sha512-0MiMsFma/HqA6g3KLKn+AGpL1kgKhFWszC9U29NfpWK5LE7bjeXxySWJrOJ77hBz+TBrBQ7o4QJqbPbqbs8rJw==
+
 "@vue/devtools-api@^6.5.1":
   version "6.6.1"
   resolved "https://registry.yarnpkg.com/@vue/devtools-api/-/devtools-api-6.6.1.tgz#7c14346383751d9f6ad4bea0963245b30220ef83"
@@ -3594,6 +3599,11 @@ date-fns@^2.30.0:
   dependencies:
     "@babel/runtime" "^7.21.0"
 
+date-fns@^3.6.0:
+  version "3.6.0"
+  resolved "https://registry.yarnpkg.com/date-fns/-/date-fns-3.6.0.tgz#f20ca4fe94f8b754951b24240676e8618c0206bf"
+  integrity sha512-fRHTG8g/Gif+kSh50gaGEdToemgfj74aRX3swtiouboip5JDLAyDE9F11nHMIcvOaXeOC6D7SpNhi7uFyB7Uww==
+
 dayjs@^1.10.4:
   version "1.11.10"
   resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.10.tgz#68acea85317a6e164457d6d6947564029a6a16a0"
@@ -6768,6 +6778,14 @@ pify@^2.2.0, pify@^2.3.0:
   resolved "https://registry.yarnpkg.com/pify/-/pify-2.3.0.tgz#ed141a6ac043a849ea588498e7dca8b15330e90c"
   integrity sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==
 
+pinia@^2.1.7:
+  version "2.1.7"
+  resolved "https://registry.yarnpkg.com/pinia/-/pinia-2.1.7.tgz#4cf5420d9324ca00b7b4984d3fbf693222115bbc"
+  integrity sha512-+C2AHFtcFqjPih0zpYuvof37SFxMQ7OEG2zV9jRI12i9BOy3YQVAHwdKtyyc8pDcDyIc33WCIsZaCFWU7WWxGQ==
+  dependencies:
+    "@vue/devtools-api" "^6.5.0"
+    vue-demi ">=0.14.5"
+
 pirates@^4.0.1, pirates@^4.0.4:
   version "4.0.6"
   resolved "https://registry.yarnpkg.com/pirates/-/pirates-4.0.6.tgz#3018ae32ecfcff6c29ba2267cbf21166ac1f36b9"
@@ -8155,6 +8173,11 @@ vite@^4.5.3:
   optionalDependencies:
     fsevents "~2.3.2"
 
+vue-demi@>=0.14.5:
+  version "0.14.8"
+  resolved "https://registry.yarnpkg.com/vue-demi/-/vue-demi-0.14.8.tgz#00335e9317b45e4a68d3528aaf58e0cec3d5640a"
+  integrity sha512-Uuqnk9YE9SsWeReYqK2alDI5YzciATE0r2SkA6iMAtuXvNTMNACJLJEXNXaEy94ECuBe4Sk6RzRU80kjdbIo1Q==
+
 vue-eslint-parser@^9.4.2:
   version "9.4.2"
   resolved "https://registry.yarnpkg.com/vue-eslint-parser/-/vue-eslint-parser-9.4.2.tgz#02ffcce82042b082292f2d1672514615f0d95b6d"
@@ -8452,6 +8475,11 @@ yocto-queue@^0.1.0:
   resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b"
   integrity sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==
 
+zod@^3.23.8:
+  version "3.23.8"
+  resolved "https://registry.yarnpkg.com/zod/-/zod-3.23.8.tgz#e37b957b5d52079769fb8097099b592f0ef4067d"
+  integrity sha512-XBx9AXhXktjUqnepgTiE5flcKIYWi/rme0Eaj+5Y0lftuGBq+jyRu/md4WnuxqgP1ubdpNCsYEYPxrzVHD8d6g==
+
 zrender@5.5.0:
   version "5.5.0"
   resolved "https://registry.yarnpkg.com/zrender/-/zrender-5.5.0.tgz#54d0d6c4eda81a96d9f60a9cd74dc48ea026bc1e"