🗺 你的 7 站小旅行
每一站都是一件小事。做完打勾，下一站會更輕鬆。你現在在起點，不用跑，用走的就好。
😮💨
0.先安心3分鐘消除緊張
→
🍱
1.三個名詞便當比喻一聽就懂
→
🎒
2.準備檢查3樣東西
→
📲
3.安裝一直按下一步→
🔑
4.登入拿免費通關密碼
→
💬
5.說話複製3句話貼上就好
→
☕
6.每天用喝咖啡等它做完
→
第 7 章是「急救箱」，卡住才看，沒事不用看。
第 0 章 ・ 先深呼吸
😮💨 開始之前，先跟你說 4 件事
1. 你不會弄壞電腦。
這篇的做法都是「先問過你才動手」。小幫手要改東西之前，會先亮出清單問你可不可以。你說不要，它就不會動。
這篇的做法都是「先問過你才動手」。小幫手要改東西之前，會先亮出清單問你可不可以。你說不要，它就不會動。
2. 不用會英文、不用會寫程式。
你可以用全中文跟它說話。像是跟店員說「我要一個排骨便當，不要辣」一樣，直接說你想要什麼就好。
你可以用全中文跟它說話。像是跟店員說「我要一個排骨便當，不要辣」一樣，直接說你想要什麼就好。
3. 免費是什麼意思？
這一課用的大腦叫做 Muse Spark 1.3 免費體驗版。現在在 OpenCode 的商店裡是 0 元。就像試吃，不用先付錢。但試吃有時會換口味，如果以後要錢了，畫面會先告訴你。
這一課用的大腦叫做 Muse Spark 1.3 免費體驗版。現在在 OpenCode 的商店裡是 0 元。就像試吃，不用先付錢。但試吃有時會換口味，如果以後要錢了，畫面會先告訴你。
4. 一個小提醒：不要給它密碼和私密照片。
就像你不會把存摺密碼告訴工讀生一樣。給它工作用的文件就好，銀行密碼、身分證不要貼上去。
就像你不會把存摺密碼告訴工讀生一樣。給它工作用的文件就好，銀行密碼、身分證不要貼上去。
小測驗：小幫手會不會偷偷亂改你的檔案？
第 1 章 ・ 只認識 3 個名字就好
🍱 用一個便當店來比喻
以前的教學一下丟出 20 個名詞，難怪會晕。這篇你只要記 3 個，而且都用便當店來想：
🤖 OpenCode ＝ 店員小幫手
你負責出一張嘴，他負責跑腿、切菜、打包。
白話：一個住在電腦裡的視窗，你打中文，它幫你做事。
你負責出一張嘴，他負責跑腿、切菜、打包。
白話：一個住在電腦裡的視窗，你打中文，它幫你做事。
🏪 Zen ＝ 便當街 / 模型超市
裡面有很多種大腦可以選，有的要錢，有的免費試吃。
白話：OpenCode 官方開的商店，幫你挑好不會拉肚子的版本。
裡面有很多種大腦可以選，有的要錢，有的免費試吃。
白話：OpenCode 官方開的商店，幫你挑好不會拉肚子的版本。
🧠 Muse Spark 1.3 免費版 ＝ 今天免費試吃的排骨便當
它就是其中一顆大腦，現在免費。你跟店員說「我要免費那個」，他就裝那顆給你。
正式名字很長：muse-spark-1.3-contributor-free，看到這串不要怕，就是它。
它就是其中一顆大腦，現在免費。你跟店員說「我要免費那個」，他就裝那顆給你。
正式名字很長：muse-spark-1.3-contributor-free，看到這串不要怕，就是它。
你說：
「幫我把這份文件整理成表格」
小幫手做：
打開文件 → 整理 → 問你「這樣可以嗎？」
「幫我把這份文件整理成表格」
小幫手做：
打開文件 → 整理 → 問你「這樣可以嗎？」
你不需要會：
❌ 不用背指令
❌ 不用懂程式
❌ 不用算錢（免費版 0 元）
✅ 只要會打中文、會按 Enter
❌ 不用背指令
❌ 不用懂程式
❌ 不用算錢（免費版 0 元）
✅ 只要會打中文、會按 Enter
Zen 是什麼？
第 2 章 ・ 打開背包檢查
🎒 出發前檢查 3 樣東西（2分鐘）
- 一台 Windows 電腦 + 可以上網
Windows 10 或 11 都可以。網路要通，因為小幫手的大腦住在雲端，就像你要打電話叫外送，電話要通。 - 一個工作資料夾（放東西的桌子）
在桌面按右鍵 → 新增 → 資料夾，取名叫 小幫手練習。以後所有練習都丟進去，才不會跟重要檔案混在一起。
為什麼要這樣？就像叫工讀生整理桌子，你要先清出一張桌子給他，才不會動到你重要的東西。 - 一個瀏覽器（Chrome 或 Edge 都可以）
等一下要登入拿免費通關密碼，會用到。不用下載新的，用你平常開網頁那個就好。
💡 家裡網路慢怎麼辦？沒關係，第一次安裝會等比較久（約 5～10 分鐘），之後就很快了。去倒杯水，回來就好了。
第 3 章 ・ 安裝（最重要，但最簡單）
📲 安裝：選一條路就好
👉 怕黑畫面的人，走 A 路。敢複製貼上的人，走 B 路。兩條路終點一樣，選一條就好。
- 下載 OpenCode 桌面版
打開瀏覽器，輸入 opencode.ai → 找到 Download / 桌面版 → 下一步、 下一步、完成。跟安裝 LINE 電腦版一模一樣。
你要看到：桌面多一個 OpenCode 圖示。沒看到就去「下載」資料夾找。 - 點兩下打開它
第一次會問你要打開哪個資料夾，選剛剛建的 桌面 → 小幫手練習。
你要看到：一個可以打字的白色視窗，下面有輸入框。這就是店員的櫃台。 - 先停在這裡，不要再按了
下一章我們再拿通關密碼。先去喝水。
黑畫面是什麼？就是一個黑黑的視窗，工程師叫它「終端機」。你把它想成「跟電腦傳簡訊的地方」。我們只會用它做兩件事：安裝、開門。
- 先裝 Node（小幫手的電池）
打開瀏覽器搜尋 Node.js 官網 → 下載寫著 LTS 的版本 → 一直按下一步。
裝完後這樣檢查：按鍵盤 Win + R，輸入 powershell 按確定，貼上這行按 Enter：node -v你要看到：出現 v22 或 v20 開頭的數字（例如 v22.1.0）。有數字就是成功。如果說找不到，去把 Node 重裝一次。 - 安裝 OpenCode（貼上一行就好）
在同一個黑畫面貼上這行，按 Enter，等它跑完：npm install -g opencode-ai你要看到：最後出現很多行，中間沒有紅色大大的 ERROR。等約 3～5 分鐘是正常的。 - 開門測試
先進到你的練習桌子，再開門。把下面兩行 一行一行 貼上，每貼一行按一次 Enter。注意把「你的名字」換成你電腦的使用者名稱：cd $HOME\Desktop\小幫手練習opencode你要看到：黑畫面變成小幫手的聊天畫面，下面可以打字。恭喜，門開了！關掉就按 Ctrl+C。
⚠️ 如果貼上後說「無法辨識 opencode」：把黑畫面整個關掉重開，再貼一次 npm install -g opencode-ai，九成是這樣就好了。
第 4 章 ・ 拿免費通關密碼
🔑 登入 + 點名「我要免費那個」
這章有點像「辦會員卡 + 告訴店員你要試吃」。做一次就好，以後都不用重做。
- 打開拿密碼的網頁
瀏覽器輸入：opencode.ai/auth → 用 Google 或 GitHub 登入（跟登入其他網站一樣）。
登入後它會給你一串很長的英文+數字，那就是 通關密碼（人家叫 API Key）。按旁邊的複製鈕把它複製起來。
你要看到：一串 opencode 開頭的長密碼。不要截圖傳給別人，這是你的會員卡。 - 把密碼交給小幫手
回到 OpenCode 的打字框，輸入這 8 個字母，按 Enter：/connect然後用上下鍵選 OpenCode Zen，把剛剛複製的長密碼貼上，再按 Enter。
你要看到：出現 Successfully connected 或打勾。這就是店員說「收到！」的意思。 - 點名要免費大腦
再打這行，按 Enter：/models會跑出一整排名字，用鍵盤往下找，找到這串：opencode/muse-spark-1.3-contributor-free選它，按 Enter。
你要看到：左下角或右下角顯示 muse-spark-1.3-contributor-free。以後每次打開，確認是這個名字，就是免費的。
💡 為什麼名字這麼長？前面 opencode/ 是商店名，後面才是便當名。你只要認得後面有 free 這個字，就是免費的意思。
| 你打的字 | 白話意思 | 成功長什麼樣 |
|---|---|---|
| /connect | 我要交會員卡 | 出現打勾、成功 |
| /models | 菜單拿來我要點菜 | 跑出一排大腦名字 |
| 選 free 那個 | 我要試吃免費的 | 角落顯示 free |
通關密碼（API Key）是什麼？
第 5 章 ・ 第一次開口（複製貼上就好）
💬 跟小幫手說話：3 句萬用句型
你不用想金句。剛開始就用這三句，複製、貼上、改幾個字就好。
① 請它介紹環境
「請用中文告訴我，這個資料夾裡有什麼檔案？一個一個簡單介紹。」
「請用中文告訴我，這個資料夾裡有什麼檔案？一個一個簡單介紹。」
② 請它做小事
「請幫我在這裡新增一個記事本叫 練習.txt，裡面寫：今天是我第一次用AI小幫手。」
「請幫我在這裡新增一個記事本叫 練習.txt，裡面寫：今天是我第一次用AI小幫手。」
③ 做錯了請它收回
「剛剛那個不是我要的，請復原。」或直接打這行：
「剛剛那個不是我要的，請復原。」或直接打這行：
/undo你要看到：它把剛剛做的事收回去，就像 Ctrl+Z。✅ 說話小撇步（跟店員講話一樣）：
1. 一次只說一件事，不要一次叫五樣菜。
2. 要說清楚放在哪：「在這個資料夾裡」。
3. 要說用中文回：「請用中文回答我」。
4. 它做完一定要看一下，再說「好」或「再改一下」。
1. 一次只說一件事，不要一次叫五樣菜。
2. 要說清楚放在哪：「在這個資料夾裡」。
3. 要說用中文回：「請用中文回答我」。
4. 它做完一定要看一下，再說「好」或「再改一下」。
🛑 它問你可不可以改檔案時：
它會跳出 Yes / No。第一次先選 No 看看發生什麼事也沒關係。確定是你想要的，再選 Yes。這就是你的安全煞車。
它會跳出 Yes / No。第一次先選 No 看看發生什麼事也沒關係。確定是你想要的，再選 Yes。這就是你的安全煞車。
第 6 章 ・ 變成日常
☕ 以後每天就是這 4 步（喝咖啡等它做）
- 先打開你的練習桌子
桌面版：打開 App → 選「小幫手練習」。黑畫面版：先 cd 進去再打 opencode。
養成習慣：一次只做一張桌子，不要在重要資料夾裡練習。 - 先讓它認識環境
第一次在新資料夾，打這行：/init白話：請店員先繞一圈看看店裡有什麼。它會生出一張小抄，以後就更懂你。 - 出一張嘴，等它做
例如：「請幫我把這三個檔案的名字列出來」「請幫我寫一封請假信，存在請假.txt」。做完它會問你好不好。
你要做：檢查一下內容，說「可以」或「這裡幫我改成…」。 - 離開就跟它說掰掰
直接關掉視窗就好，紀錄會自動留著，下次回來還在。
💡 三個常用按鈕，記這三個就夠：
・ Tab ＝ 換模式（想一想 vs 直接做）。剛開始不用管它。
・ /undo ＝ 收回上一步。
・ /models ＝ 換大腦。記得換回 free 的。
・ Tab ＝ 換模式（想一想 vs 直接做）。剛開始不用管它。
・ /undo ＝ 收回上一步。
・ /models ＝ 換大腦。記得換回 free 的。
第 7 章 ・ 急救箱（卡住才看）
🆘 卡住了？先找這一排
Q1：貼上指令後說「找不到、不是命令」？
→ 黑畫面關掉重開一次，再裝一次 npm install -g opencode-ai。多半是安裝時沒跑完，路還沒鋪好。
Q2：英文看不懂，它回英文怎麼辦？
→ 直接跟它說：「請以後都用繁體中文回答我。」它會記住。選單上的英文按鈕，記位置就好，不用每個字都懂。
Q3：它一直轉圈圈、很久沒回？
→ 網路在忙。等 1～2 分鐘，真的不行就關掉重開，再問一次。免費試吃人多時會慢一點，是正常的。
Q4：不小心讓它改錯檔案了？
→ 馬上打 /undo，它會收回去。以後記得：它問 Yes/No 時，先看清楚它要改哪個檔案再按 Yes。
Q5：免費的以後會收錢嗎？
→ 試吃品有可能換菜單。用之前看一下角落是不是還顯示 free。如果變成要錢的名字，畫面會先顯示金額，不會偷扣。真的擔心，就先不要按 Yes。
Q6：我可不可以拿公司的重要資料給它？
→ 練習階段先不要。等你熟了，問過公司規定再說。免費版的試吃單，店家可能會拿去改進食譜（官方說會拿來訓練）。私密的先不要貼。
最後一題：看到 Yes / No 問你要不要改檔案，正確做法是？