IS愛思 AI 助手
使用說明書
插上隨身碟、雙擊一個檔案，就能開始用 AI 對話。所有設定、手機連線、故障診斷都集中在同一個視窗裡，不需要安裝任何軟體，也不需要開命令列視窗。
1快速開始
整台機器只會用到兩個地方：一個資料夾裡的啟動檔，和瀏覽器裡長出來的對話視窗。
雙擊啟動助手
在隨身碟根目錄雙擊 啟動助手.bat，出現深色的「IS愛思 AI 助手」控制中心。
填好模型與金鑰
在「① 模型設定」選供應商、貼上你自己的 API Key，按「測試連線」看到綠色勾勾。
開啟對話介面
按最下方綠色的「▶ 開啟對話介面」，約 10 秒後瀏覽器自動打開，開始聊天。
兩條路線：只用電腦，或也用手機
「電腦對話」和「手機對話」是兩個彼此獨立的服務，互不影響。只看你要不要用手機聊天，就知道自己該走哪條路。
路線 A ｜ 只用電腦 大多數人
不用配對手機，也不用碰 Gateway。
路線 B ｜ 也想用手機聊天 選用
2控制中心總覽
整個程式只有這一個視窗。上方是三顆狀態燈，中間三個分頁，下方兩顆大按鈕。
右上角三顆狀態燈
| 狀態燈 | 代表什麼 | 什麼時候會變色 |
|---|---|---|
| 模型 已設定 | API Key 是否已填好 | 綠色＝已填寫；橙色＝尚未設定，請到 ① 分頁填入 |
| 對話 已啟動 | 網頁對話服務（127.0.0.1:8787）是否在跑 |
綠色＝可以開瀏覽器聊天；灰色＝還沒啟動，按下方大按鈕即可 |
| 手機 待啟動 | 手機（微信 / WhatsApp）連線狀態 | 綠色＝已連線收訊息；橙色＝已配對但 Gateway 沒開；灰色＝未配對（選用功能） |
三個分頁
| 分頁 | 用途 | 一定要用嗎 |
|---|---|---|
| ① 模型設定 | 選 AI 供應商、貼 API Key、測試連線 | 必要 至少要填一次 |
| ② 手機連線（選用） | 把 AI 接到微信或 WhatsApp，並控制 Gateway | 選用 不用手機可整頁跳過 |
| ③ 診斷修復 | 一鍵檢查環境、API、對話服務、錯誤記錄；右側另有「恢復出廠設定」 | 備用 出問題時再用 |
底部兩顆大按鈕
| 按鈕 | 行為 |
|---|---|
| ▶ 開啟對話介面 | 啟動網頁對話服務並自動打開瀏覽器。這是平常最常用的一顆。 |
| 📱 連接手機（選用） 未配對時 |
只是跳到「② 手機連線」分頁，不會啟動 Gateway，也不會影響電腦對話。 |
| 📱 啟動 Gateway 已配對、未啟動 |
開始接收手機訊息。按下去等於啟動 Gateway 服務。 |
| ✓ Gateway 運作中 運作中 |
綠色代表正在收手機訊息。按一下會顯示目前的 pid 與提示。 |
3① 模型設定
這裡決定「AI 要用哪一家的腦袋」。填一次就夠，之後換供應商或換金鑰也在此處理。
欄位說明
| 欄位 / 按鈕 | 說明 |
|---|---|
| 模型提供商 | 下拉選單。選好後會自動帶入 Base URL 與模型名稱，可再手動修改。 |
| Base URL | 供應商的 API 位址，一般不用動。 |
| 模型名稱 | 例如 gemini-2.5-flash、deepseek-chat。填錯會出現 404。 |
| API Key | 你自己的金鑰。右側「顯示」可把圓點換成明碼核對。 |
| 保存 | 寫入 data\config.yaml。切換分頁或關閉視窗前記得按。 |
| 測試連線 | 送一個最小請求驗證金鑰。綠色訊息＝可用。 |
| 對話服務網址 | http://127.0.0.1:8787，點一下可複製。瀏覽器沒自動開時貼上即可。 |
| 下次啟動直接進對話 | 勾選後，之後雙擊啟動檔會跳過本視窗，直接開對話介面。 |
ping 請求確認 Key 有效；不會開啟對話介面，也不會啟動 Gateway。看到「✓ 連線成功」後，仍然要按「▶ 開啟對話介面」才會進到聊天畫面。
內建供應商
| 供應商 | 預設模型 | 備註 |
|---|---|---|
| IS愛思 蝦盤雲（自家） | deepseek-v4-flash | 出廠預設，額度與計費依你的方案 |
| DeepSeek（深度求索） | deepseek-chat | 價格低、中文好 |
| OpenAI | gpt-4o-mini | 需綁定付費 |
| Google Gemini | gemini-2.5-flash | 有免費層，每日次數有限 |
| 硅基流動 SiliconFlow | deepseek-ai/DeepSeek-V3 | 中國節點，速度快 |
| MiniMax | MiniMax-Text-01 | — |
| Kimi（月之暗面） | moonshot-v1-8k | 長文本處理佳 |
| 智譜 GLM | glm-4-flash | 有免費模型 |
| 豆包（火山引擎） | doubao-1-5-pro-32k-250115 | 需開通端點 |
| 自訂 API（OpenAI 兼容） | 自行填寫 | 任何相容 /chat/completions 的服務 |
連不上時，先看錯誤碼
| 訊息 | 意思是 | 怎麼處理 |
|---|---|---|
| HTTP 401 | 金鑰無效 | 確認 Key 有完整貼上、沒被刪除或撤銷。 |
| HTTP 402 | 預付額度用完 | 這是「預付餘額」用完，跟後台的「每月支出上限」是兩個不同的池子。換一把 Key 或去儲值。 |
| HTTP 403 | 沒有權限 | 該金鑰未開通此模型，或帳戶餘額為 0。 |
| HTTP 404 | 找不到模型 | 模型名稱打錯，或這家供應商沒有這個模型。 |
| HTTP 429 | 額度用完或太頻繁 | 免費層每日次數（例：Gemini 免費層約 20 次／天）用完，需等隔天，或換模型／換金鑰。 |
| HTTP 5xx | 供應商故障 | 不是你的問題，稍後再試或暫時換一家。 |
gemini-2.5-flash 用完，改填 gemini-2.5-flash-lite 或 gemini-2.0-flash 通常可以立刻再用，因為它們各自有獨立額度。
4② 手機連線（選用）
把 AI 接到你的微信或 WhatsApp。只有「想用手機聊天」的人需要這一頁；只用電腦的人整頁跳過，不需要配對，也不需要啟動 Gateway。
先分清楚兩個服務
| 服務 | 做什麼 | 誰需要 | 怎麼開 |
|---|---|---|---|
| 對話介面 | 電腦上用瀏覽器聊天（127.0.0.1:8787） |
所有人 | 按「▶ 開啟對話介面」 |
| Gateway | 接收並回覆手機訊息（微信 / WhatsApp） | 只有要用手機的人 | 配對成功後自動啟動，或手動按「▶ 啟動 Gateway」 |
連接微信
操作步驟
① 按「連接微信」
② 左側出現 QR code
③ 手機微信掃描
④ 配對成功 → 自動啟動 Gateway
要注意
· QR code 約 4 分鐘會過期，會自動換新
· 期間請不要關閉視窗
· 配對後帳號資訊會寫入設定檔
· 之後直接傳訊息給機器人就能對話
連接 WhatsApp
操作步驟
① 按「連接 WhatsApp」
② 畫面出現 QR code
③ 手機 WhatsApp → 設定 → 已連結裝置 → 連結裝置
④ 掃描 → 配對成功 → 自動啟動 Gateway
要注意
· QR code 約 20 秒就換一次，要快
· 需要穩定的網路連線
· 手機沒網路時收不到訊息
Gateway 控制區
| 畫面元素 | 說明 |
|---|---|
| ● 運作中（pid 20300） | 綠色＝正在接收手機訊息，pid 是目前執行中的編號。 |
| ○ 未啟動 | 灰色＝沒有在收訊息，手機傳了不會有回應。 |
| ▶ 啟動 Gateway | 開始接收訊息。未配對時會顯示「（先配對）」並變暗。 |
| 停止 | 暫時關閉接收。平常不需要關它。 |
| 看日誌 | 在視窗內直接看 logs\gateway.log，每 2 秒自動更新，不用開黑色命令列。 |
| ↻ 重啟 Gateway | 跑久卡住、或手機沒回訊息時按一下，等於關掉再開。 |
•••• 2026-11-01 20:41:10 Gateway 啟動 •••• Starting Hermes Gateway (messaging platforms)... weixin: 已連線 收到訊息 → 回覆完成（1.8 秒） •••• 20:42:03 收到新訊息 ••••
5③ 診斷修復
出問題時不必猜。按一下「一鍵診斷」，它會依序檢查五件事，並把最近的重要錯誤抓出來。
這一頁右側還有一顆紅字的 恢復出廠設定，用來把整支隨身碟清回新機狀態（詳見本章最後一節）。
它檢查什麼
| 項目 | 檢查內容 |
|---|---|
| 執行環境 | 隨身碟內的 Python 是否完整、對話介面程式是否存在。 |
| 模型設定 | 目前使用的 Base URL 與模型，並實際送一次 API 請求驗證金鑰。 |
| 對話服務 | 127.0.0.1:8787 是否正在運作。 |
| 手機連線 | 已配對的平台（微信 / WhatsApp）與 Gateway 是否存活。 |
| 最近記錄 | 從 webui.log、gateway.log 挑出最近的錯誤，只列重點不刷畫面。 |
旁邊三顆按鈕
| 按鈕 | 用途 |
|---|---|
| 開啟記錄資料夾 | 需要把日誌交給客服時使用，所有記錄都在 logs\。 |
| 重啟 Gateway | 手機沒反應時的第一招：關掉再開。 |
| 恢復出廠設定 紅字 | 清掉所有個人資料，還原成新機狀態。賣出或轉手前使用。 |
恢復出廠設定（賣出 / 轉手前使用）
把這支隨身碟還原成客人第一次拿到的樣子。位置在「③ 診斷修復」分頁右上角，紅字按鈕， 平常不會誤觸；按下去會先跳一張確認表，勾選後才能執行。
會被清除
· 對話紀錄與記憶
· 排程、授權、快取、日誌
· 手機配對（微信 / WhatsApp 會解除）
· 工作區檔案 workspace\
· API Key（換回空白，需重新填寫）
會保留
· 繁體中文介面、深色主題
· AI 核心程式與官方技能
· 使用說明（含本文件）
· 授權聲明 LICENSE
操作步驟
| 步驟 | 動作 |
|---|---|
| 1 | 按「恢復出廠設定」→ 確認視窗出現。 |
| 2 | 看清單確認要清除的內容，勾選「我已了解：清除後無法復原…」。 |
| 3 | 按「清除並還原（無法復原）」。系統會先自動關閉手機連線與對話服務，再開始清除。 |
| 4 | 完成後可選「重新啟動控制中心」，介面會回到乾淨的初始狀態。 |
_客服備用\出貨重置.bat」仍然可用（命令列版，效果相同）。
正式出貨時請把 _客服備用\ 整個資料夾刪除，客人只需要介面上的這顆按鈕。
6網頁對話介面
按「▶ 開啟對話介面」後，瀏覽器會自動打開一個聊天畫面。這是平常真正在用的地方，介面已設為繁體中文。
怎麼打開
· 按控制中心下方「▶ 開啟對話介面」
· 或瀏覽器貼上 http://127.0.0.1:8787
· 服務已在跑時，再按一次只會重新開瀏覽器
畫面組成
· 左側：歷史對話清單，點一下接續
· 上方 ＋：開新對話
· 底部輸入框：打字、貼上內容
· 輸入框左側：上傳檔案、麥克風語音輸入
可以怎麼用
| 情境 | 做法 |
|---|---|
| 寫文案、翻譯、整理重點 | 直接把需求打在輸入框，或把整段文字貼進去。 |
| 看文件、讀報表 | 用輸入框左側的迴紋針上傳檔案，再問問題。 |
| 不想打字 | 按麥克風用講的，會自動轉成文字。 |
| 接續上次話題 | 左側清單點選舊對話，上下文會延續。 |
| 重新開始 | 按上方 ＋ 開新對話，避免舊內容干擾。 |
7常見問題
雙擊「啟動助手.bat」沒反應，或只有黑窗一閃就消失
① 確認整支隨身碟資料夾結構完整，特別是 hermes-agent\env\env_win\python.exe 是否存在。
② 若隨身碟剛插上，等 5～10 秒讓系統完成掛載再雙擊。
③ 換一個 USB 孔（建議插在主機後方，不要用延長線）。
④ 仍不行就開啟 logs\webui.log 看最後幾行，或連絡客服。
按了「開啟對話介面」，但瀏覽器沒有動
設定視窗上方有一行「對話服務網址 http://127.0.0.1:8787」，點一下會複製，貼到瀏覽器網址列即可。
如果貼上後顯示「無法連線」，代表服務沒起來，請回「③ 診斷修復」按「一鍵診斷」。
出現 402 額度不足，但我明明儲值了
「預付額度」和「每月支出上限」是兩個不同的池子。402 代表預付餘額用完，不是後台設定太低。
最快的解法是到供應商後台新建一把金鑰（或換一個未綁計費的專案走免費層），貼回「① 模型設定」重新測試。
測試連線成功，但聊天時回 429 或很慢
測試只發一次請求，聊天會連續發送，所以「測試過」不代表額度充足。
免費層通常有每日次數上限（例如 Gemini 每個模型約 20 次／天）。用完可換 gemini-2.5-flash-lite 等不同模型（額度分開計算），或改用付費金鑰。
手機掃不到 QR code，或掃了沒反應
WhatsApp 的 QR 約 20 秒就換一次，過期就掃不到；微信約 4 分鐘。兩者都會自動刷新，重新對準即可。
掃描時手機要連得上網路。若畫面一直停在「正在取得 QR」，請確認網路，或改用微信。
微信 / WhatsApp 配對成功了，但傳訊息沒人回
依序檢查四件事：
① 回「② 手機連線」看 Gateway 是不是「● 運作中」，不是就按「▶ 啟動 Gateway」。
② 看「① 模型設定」的額度是否用完（429）。
③ 電腦是否進入了睡眠或闔上蓋子。
④ 按「看日誌」看最後幾行有沒有紅色錯誤。
換一台電腦，金鑰還要重填嗎？
不用。金鑰與設定都存在隨身碟的 data\config.yaml，插到別台電腦直接可用。
但手機配對資料是綁定這支隨身碟的，換電腦後若 Gateway 沒自動起來，手動按一次「啟動 Gateway」即可。
介面變成英文，或看到的是舊畫面
通常是瀏覽器快取。按 Ctrl + F5 強制重新整理即可。
若重新整理後仍是舊的，代表程式版本沒更新，請連絡客服。
可以同時開很多個對話嗎？
可以。左側清單就是所有對話，切換不會中斷。但同時對同一個模型大量發問，比較容易撞到每分鐘的速率限制。
想把隨身碟轉賣／送人，怎麼清乾淨？
控制中心 →「③ 診斷修復」→ 右上角紅字「恢復出廠設定」 → 勾選同意 → 按「清除並還原」。
完成後對話、記憶、手機配對、API Key 都會清掉，介面回到第一次啟動的狀態；繁體中文與深色主題會保留。
提醒：這是不可復原的操作，清除前請先備份需要保留的對話。
按「恢復出廠設定」時有檔案刪不掉？
代表有檔案還被其他程式開著（最常見是還開著的瀏覽器分頁，或別台視窗正在跑的對話服務）。
把瀏覽器分頁關掉、其他控制中心視窗關掉，再按一次即可。系統會列出是哪幾個項目沒刪掉。
8出貨與客服（內部用）
母碟 → 成品碟
複製母碟
把母碟整份複製到新隨身碟，確認容量足夠（含 webui 約數百 MB）。
跑恢復出廠
在新碟開啟控制中心 →「③ 診斷修復」→ 右上紅字恢復出廠設定 → 勾選同意 → 清除並還原。會清掉對話、記憶、快取、配對資料，並把金鑰還原成空白。
刪內部檔案
刪除 _客服備用\、_原始OEM組件\、銷售前檢查清單.txt。
保留 reset_for_sale.py：控制中心的恢復出廠按鈕會呼叫它，刪掉按鈕就失效。
出貨前檢查清單
| # | 檢查項目 |
|---|---|
| 1 | 在一台沒裝過 Python 的 Windows 10/11 上實測一次 |
| 2 | 雙擊啟動檔會先出現「控制中心」，不是直接跳瀏覽器 |
| 3 | 貼測試金鑰 → 測試連線 → 顯示「✓ 連線成功」 |
| 4 | 按開啟對話介面 → 瀏覽器自動開啟 → 傳一句「你好」有回覆 |
| 5 | 介面為繁體中文，沒有 401／402／403 錯誤 |
| 6 | data\whatsapp\、data\weixin\ 不存在（沒有殘留配對） |
| 7 | 改過任何介面檔（static\）就要升版本號，否則客人看到舊畫面 |
| 8 | reset_for_sale.py 仍在根目錄（刪掉會讓「恢復出廠設定」按鈕失效） |
| 9 | 最後一步：跑一次恢復出廠 → 金鑰變空白、data\whatsapp\ 與 data\weixin\ 消失、重開會看到首次設定畫面 |
客服備用工具（_客服備用\）
| 檔案 | 用途 |
|---|---|
模型設定.bat | 直接開控制中心（與主啟動檔相同） |
連接手機.bat | 命令列版的手機配對，介面改版時可交叉驗證 |
診斷連線.bat | 命令列版診斷，會測多個模型並翻譯錯誤碼 |
出貨重置.bat | 命令列版恢復出廠（GUI 按鈕失效時的備援） |
9檔案與版本
隨身碟結構
F:\HermesAgent\ ├─ 啟動助手.bat← 唯一入口，客人只需要點這個├─ 使用說明.html← 本文件├─ start_launcher.py← 啟動流程（判斷要不要先開設定視窗）├─ launcher_gui.py← 控制中心本體├─ phone_connect.py← 手機掃碼配對邏輯├─ diagnose.py← 命令列診斷├─ reset_for_sale.py← 恢復出廠的執行檔（GUI 按鈕會呼叫，勿刪）├─ data\ │ ├─ config.yaml← 模型、金鑰、手機配對資料│ ├─ skills\← 62 個 AI 技能│ ├─ webui\← 介面語系與主題設定│ └─ sessions\ memories\← 對話與記憶├─ workspace\← AI 工作用的檔案區├─ logs\← webui.log / gateway.log└─ hermes-agent\ ├─ env\env_win\← 內建 Python（免安裝）├─ hermes-agent\← AI 核心└─ hermes-webui\← 網頁對話介面
版本資訊
| 項目 | 值 |
|---|---|
| 產品版本 | v1.0.0-is.3 |
| 文件更新 | 2026-11-01 |
| 對話服務埠 | 127.0.0.1:8787（只在本機，不對外開放） |
| 內建技能 | 62 個（創作、生產力、開發、資料科學等 13 類） |
| 支援平台 | Windows 10 / 11（64 位元） |