<!-- Generated by scripts/export-user-manual.mjs from the rendered manual. Do not edit. -->

# 認識編輯器

編輯器用來修改模擬訓練的內容。你可以改人物說的話、換背景、增加學員可以選的答案，以及設定選了之後會出現哪段回覆。

## 三種修改方式，依你想做的事選擇

### 對話告訴 AI 你想怎麼改

例如：「請把顧客的開場改得更客氣。」在編輯器左側選「對話」，送出修改要求。

### 代碼直接修改整份流程文字

開啟編輯器時預設在「代碼」頁籤，可直接編輯流程語法。適合熟悉語法的人；修改後按「驗證」檢查並更新流程圖。

### 圖形編輯自己改台詞、背景與答案

在左側選「圖形編輯」，點選中央的方塊，再改右側的內容。適合不寫代碼、直接動手修改。

從哪裡開啟編輯器？

在自己的專案：流程 → 查看產出 → 編輯 / 詳情 → 圖形編輯。編輯器開啟時停在「代碼」頁籤，切到「圖形編輯」後才會出現節點表單與「新增節點」。本頁已準備好退貨情境，可以直接練習。

[先看流程圖導覽](doc2sim-flow.md) 

## 選一件事開始練習

[增加一個答案，安排後續回覆](doc2sim-editor-branches.md) [檢查並儲存修改](doc2sim-editor-save.md) 

<a id="editor-practice"></a>

## 練習：修改顧客的台詞與背景

下面是已準備好的退貨情境，操作方式與「圖形編輯」頁籤相同。先改顧客說的話，再看看換背景後的畫面。

1. ### 展開後，找到要修改的那一步

   

   按「展開操作」。左側是教學與新增節點工具，中央是流程圖，右側是選中節點的欄位。點中央 V\_start，先看右側標頭。

   

   **核對畫面：**右側標頭顯示 VIEW · V\_start，下面有「場景設定」與「對話內容」。V\_start 是這個方塊的名稱；VIEW 表示它用來呈現場景與對話。
2. ### 改顧客說的話，不要改節點 ID

   

   在右側往下找到「對話內容」，保留說話者「顧客」，把文字改成「我昨天買的商品有問題，請問可以怎麼處理？」。

   

   **核對畫面：**圖上 V\_start 的台詞摘要跟著改變。V\_start 仍是同一節點，原本通往 I\_response 的連線仍在。
3. ### 再加一句旁白

   

   按「新增對話」，將新句子的說話者選為「旁白」，輸入「請先確認商品狀況，再決定如何回覆。」。每句左側 ▲、▼ 可調整順序，右側 × 可移除。每句台詞上方的「+ 角色動作」可安排角色在這句之前出現在左側／中央／右側或退場；清單最後的「對話結束後」用於全部台詞之後。本練習不需要加角色動作。

   

   **核對畫面：**「對話內容」顯示兩句：先是顧客提問，再是旁白提示。新增一句台詞不會新增流程節點。
4. ### 換背景，逐句看舞台

   

   保持選中 V\_start，按中央工具列的「舞台預覽」（舞台圖示）。點舞台下方目前的「服務櫃台」，改選「辦公室」；用台詞旁的 ▼ 看第二句。

   

   **核對畫面：**背景換成辦公室，第一句是剛改的顧客提問；下一句是旁白。這裡只預覽 V\_start，不會自動走到學員選項。
5. ### 回到圖上，確認接下來去哪裡

   

   按「返回流程圖」，再點 I\_response。查看右側「選項列表」，對照兩個選項的目標節點；按最上方「返回手冊」，再按「展開操作」，檢查剛才的修改仍在。

   

   **核對畫面：**I\_response 仍有原本兩個選項。換背景和改台詞不會替你改選項的去向；下一章才練習新增路線。

每章使用獨立範例；修改與儲存只留在本頁。展開後，左側仍有本章步驟，可邊看邊做。

操作時看到的方塊名稱是什麼？

圖上的方塊稱為「節點」。V\_start、I\_response 是各個方塊的名稱：在「目標節點」選哪個名稱，接下來就會前往那個方塊。VIEW 表示這裡放場景與對話，INTERACT 表示這裡讓學員作答。

1. ### V\_start · 顧客先說話

   

   這是 VIEW。點它查看「我想退貨，可以直接退款嗎？」；它的下一步是 I\_response。
2. ### I\_response · 學員選擇回覆

   

   這是 INTERACT。「先查清事實與退款政策」通往 V\_help；「立即承諾退款」通往 V\_retry。每個選項都有自己的目標。
3. ### V\_retry · 給提示，再試一次

   

   這是另一個 VIEW，顯示「先查核政策，再向顧客承諾。」後回到 I\_response。同一節點可以被再次走到。

其他方塊：什麼時候需要 LOGIC 與 ROUTE？

先用 VIEW 與 INTERACT 就能安排情境、選擇和回饋。要記錄狀態或自動判斷時，再加入 LOGIC 與 ROUTE。

| 類型 | 這一步發生什麼 | 退貨訓練中的用法 |
| --- | --- | --- |
| `VIEW` | 呈現場景、角色與台詞；閱讀後繼續。 | 顧客說明商品問題，或主管說明處理方式。右側編輯場景設定、對話內容與流程控制。 |
| `INTERACT` | 等待學員選擇或輸入。 | 本例是 choice 單選：學員選「查核政策」或「承諾退款」，各自前往對應目標。其他互動模式在下一章說明。 |
| `LOGIC` | 執行資料或變數操作，再自動繼續。 | 需要記錄「已完成查核」或調整分數時使用。它不是讓學員點的答案；需按專案變數與命令規則設定。 |
| `ROUTE` | 依條件自動選路；由上而下走第一個符合的分支。 | 依「是否已完成查核」決定接續回覆。右側設定 if／elif／else 與各分支目標；else 用來接住前面條件都不符合的情況。 |

想把對話改成整頁文字呈現？

這是 VIEW 的 dialogue\_mode，與編輯器頁籤、INTERACT 的作答模式不同。預設會依角色對話或旁白呈現；在右側「屬性」新增 dialogue\_mode，值填 parchment，可改成背景上的大幅文字呈現。需要到「模擬」建構並試玩查看；本頁舞台預覽仍使用原本的對話框。

找不到台詞、舞台按鈕或背景？

台詞在右側欄位較下方，捲動右側即可找到。先確認標頭是 VIEW；選中 INTERACT 時沒有舞台預覽。正式專案若未替這個 VIEW 指定背景，可能沿用前序場景；若來自多條路徑且背景不同，舞台會提示依路徑而定。

完成核對後，你應能指出：哪一步呈現台詞、哪一步等待選擇，以及改過的台詞和背景在哪裡。接著練習讓一個新選項通往自己的回覆。

[前往下一章](doc2sim-editor-branches.md)