EchoPace 使用手冊

適用於桌面程式 EchoPace（目前版本 2.7.7）。

EchoPace 把日常設計與資料處理收進同一個視窗：畫路徑、跑工作流程、查表格、連資料庫、發 HTTP、本機 AI 助手，以及資料夾裡的音訊切片與合成。模組名稱保持英文，介面語言可在偏好設定切換。

1. 怎麼開啟

Windows

1. 按兩下 EchoPace.exe。不需要安裝，也不需要解壓。
2. 若出現「Windows 已保護你的電腦」：點 更多資訊 → 仍要執行。這是未做數位簽章的常見提示，不是程式損壞。
3. 程式沒有黑色主控台視窗。關閉視窗即結束。

可以把 exe 放到任意資料夾。建議固定位置，不要每次換路徑，以免捷徑失效。

macOS

1. 開啟 DMG，把 EchoPace 拖到 Applications（應用程式）。
2. 若首次開啟被攔截：系統設定 → 隱私權與安全性 → 仍要打開（目前為 ad-hoc 簽章，未公證）。
3. 從啟動台或「應用程式」開啟。這是正式的 .app，不會出現黑色終端機視窗。

2. 視窗怎麼看

視窗
├── 視窗頂欄    EchoPace 標誌 · 模組頁籤（側欄隱藏時出現）· 次區開關 · 偏好設定
├── 模組側欄    左側約 200px 的模組清單
├── 工作區
│   ├── 左欄     目前模組的資源清單（可按左欄頁籤切換）
│   ├── 主區     畫布 / 表格 / 圖 / 對話 等主體
│   └── 次區     檢查、匯出、節點屬性等；可從視窗頂欄關閉
└── 狀態列      視窗最底一行：授權與更新、提示文字

• 在 模組側欄 點模組名稱即可切換。側欄收合後，同樣入口會出現在視窗頂欄的模組頁籤。
• 每個主區 / 次區都有自己的區頂欄、區頁籤、中區、區底欄。
• 視窗頂欄的齒輪是 偏好設定。
• 狀態列右側的鈴鐺 / 盾牌開啟 授權、已開通、開通更多。

3. 第一次使用：授權

尚未填寫授權時，只能使用 GeoCanvas 與 OtterDrive。其餘模組在模組側欄會顯示為未開通。

1. 點狀態列上的授權入口，開啟對話框。
2. 在 授權（或 開通更多）頁籤點 申請 5 天試用/續期：程式會把本機網卡位址與平台上報，自動取得 App ID / App Secret 並加密儲存，再向伺服器校驗。同一憑證自建立起半年內可無限次自助續 5 天。
3. 也可直接填入管理員提供的 App ID 與 App Secret 後儲存。
4. 校驗通過後，已開通 頁籤會列出本版本全部模組：已解鎖的可點，未解鎖的會鎖住。
5. App ID / App Secret 會加密寫入本機，不會以明文保存。

離線時：會沿用上次成功的校驗結果，已開通模組仍可用。若超過約兩週未能連線校驗，啟動時會再次提示，請連線驗證，或再點 申請 5 天試用/續期。

長期授權、或自助視窗（憑證建立起半年）結束後，到同一對話框的 開通更多 頁籤寄信 support@mossboat.dev，信中請附上本機的 App ID（頁內可複製；若還沒有，請先申請試用）。管理員要用 App ID 在伺服器上找到你的帳號才能開通。

4. 偏好設定

視窗頂欄齒輪 → 偏好設定。

點 儲存 才會記下模組清單；語言在一般頁改完即生效。

5. GeoCanvas — 路徑 · SVG · 測量

畫向量、量尺寸、把點陣圖描成路徑、再匯出圖示。

左欄

• 設計：工具、畫板、頁面、圖層。
• 測量：尺寸、幾何。選取圖形後可看長寬、面積等。

主區區頁籤

• 畫板：在畫布上畫。從左欄 工具 選：選取、鋼筆、矩形、橢圓、多邊形、星形、正多邊形、箭頭、對勾、叉、編號、文字框。
• 路徑：編輯節點、布林運算、簡化等。
• 預覽：依選區出圖。點 匯出… 或 匯出 SVG 會先跳出 匯出背景：透明、黑、白，或自訂顏色（色相環、十六進位、不透明度）。

區頂欄常用：匯入 SVG、匯入影像、描摹影像、複製影像。

次區

• 輪廓：圖層清單。
• 選取：對齊、分布、旋轉複製等。
• 顏色：描邊 / 填色。

畫布習慣

• 滾輪縮放，拖曳平移；預覽裡按兩下可重設檢視。
• 從尺規拖出參考線；把參考線拖回尺規可刪除。對話框擋住畫布時，不會透過彈窗拖到尺規。
• 畫板背景：區底欄 背景，可選夜間、黑色、灰色、白色等預設。
• 設計會自動保存在本機（見第 12 節）。

6. OtterDrive — 工作流程 · 觸發器 · 監視

用節點圖編排命令，可手動執行，也可依時間或丟檔案來跑。

左欄

• 劇本：工作流程、專案。可先開啟內建 Demo plant / Nightly ingest，或新建。
• 監視：Workers（工作節點）、Queue（待處理的檔案投放）。

主區

• 圖：編排節點。用 從所選連接 連線；右鍵邊可刪除。
• 執行：每次執行的紀錄。
• 監視：看節點進度與輸出。

次區

• 節點：為節點撰寫要執行的命令。
• 觸發器：排程（5 段 cron）和/或資料夾投放（監視目錄 + 檔名規則）。把符合的檔案拖到投放區會複製進資料夾並排隊。
• 環境：專案 / 工作流程的 $ENV。

點 執行一次 執行目前圖。跨機器投放需先在監視 → Workers 登記本機、填好 Hub 位址；各機器的監視資料夾請用可攜路徑（Windows 如 %USERPROFILE%\Desktop\TAG，macOS / Linux 如 ~/Desktop/TAG）。

7. SilkQuery — Excel · CSV · SQLite · JSON

把表格檔當資料來源檢視、篩選、組查詢、再匯出。需要授權開通。

左欄

資料來源：檔案、表、資料庫。用 + 新增 Excel / CSV / SQLite / JSON。

主區

• 工作表：看資料、捲動欄、改欄寬。
• 結構：欄位一覽。
• 樣本：抽樣預覽。
• 建構器：視覺化組查詢。

次區

• 指令碼：SQL / 配方。
• 匯出：寫出檔案。
• 歷程：匯出紀錄。

典型順序：新增檔案 → 工作表確認內容 → 建構器或指令碼處理 → 匯出。

8. RapidDock — 連線 · SQL

連遠端資料庫，在工作表看結果。需要授權開通。支援常見 SQL 庫（如 PostgreSQL、MySQL、SQLite、SQL Server 等，以連線對話框列出的為準）。

左欄

資料來源：連線、表、資料庫。先 新建連線，填主機、庫名、帳號，測通後再瀏覽表。

主區 / 次區

版面與 SilkQuery 相近：工作表、結構、樣本、建構器；次區有指令碼、匯出、歷程。

密碼保存在本機連線設定，請只連你有權使用的庫，不要把本機設定檔隨便拷給別人。

9. MintCall — 請求 · 集合

發送 HTTP / WebSocket 請求，類似輕量 API 用戶端。需要授權開通。

左欄

集合：請求、資料夾、專案。依專案組織請求。

主區區頁籤

Headers、Body、Auth、Query、Listen、Encrypt。選好方法與 URL，編好標頭與正文後傳送。

次區

預覽回應、時間軸等。WebSocket 可在同一專案建立連線並收發訊息。

若管理員提供本機 Playground，把請求指到 http://127.0.0.1:8765 即可對著範例服務練習。

10. MossNet — Ollama · 雲端模型

對著專案檔案聊天、改檔、跑命令。需要授權開通。本機模型需已安裝並啟動 Ollama。

左欄

• 對話：專案、工作階段。先建專案並指定工作目錄。
• 檔案：目前專案檔案樹。

主區

• 工作區：對話。可選模型，串流輸出，可取消。
• 工具：看助手能呼叫的工具。

次區

• 追蹤：工具呼叫過程。
• 文件：開啟的說明 / 預覽。
• 回溯：檢查點（不是 git）。不滿意可退回。

可在專案下放置技能手冊：

.moss/skills/<名稱>/SKILL.md

也辨識 .cursor/skills/*/SKILL.md。符合的技能會進入助手提示；也可用工具 list_skills / read_skill 按需讀取。

敏感操作可設為每次詢問或一律允許。工作目錄外的路徑預設受限制。

11. AmberClip — 資料夾 · 波形 · 切片 · 合成

對著資料夾裡的音訊 / 影片 / 圖片做傳送帶挑選、標記播放範圍、再依序合成匯出。需要授權開通。影片封面、波形和匯出依賴本機 ffmpeg（可與程式放在同一目錄，或已加入系統 PATH）。

左欄

• 資料來源：資料夾（拖入或瀏覽新增）、檔案樹（顯示數量與大小，懸停可刪除）。
• 快照：切片（切片器寫入的單檔播放範圍）、合成（合成器寫入的多檔順序與範圍）。

主區區頁籤

• 傳送帶：卡片預覽（音訊 / 影片顯示波形）。區底欄可按類型、排序、篩選從檔案樹挑出；區頂欄可全選 / 全不選 / 反選。
• 切片器：在波形上標出入點，寫入快照裡的切片清單。
• 合成器：排列多個檔案的播放範圍與順序，寫入快照裡的合成清單。

次區

• 指令碼：把目前傳送帶符合的檔案遷移到另一資料夾。
• 匯出：依選中的合成匯出合併 WAV，或逐條匯出。需要 ffmpeg。
• 歷史：匯出紀錄；次區底欄可清除歷史。

典型順序：新增資料夾 → 傳送帶篩選挑選 → 切片器和/或合成器 → 匯出。

12. 資料存在哪

程式本身不寫安裝目錄。設定與各模組資料在使用者目錄：

其中大致包括：

換電腦時：只拷貝程式 不能 帶走這些資料。需要的話把整個資料資料夾一併複製。不要把含 App Secret、資料庫密碼的檔案發到公開位置。

13. 更新

啟動時會在背景檢查更新。狀態列出現更新提示時，開啟授權/更新對話框即可查看目前版本與是否有新包。本手冊對應 2.7.7。

• Windows：用新的 EchoPace.exe 覆蓋即可。
• macOS：開啟新的 DMG，再拖一次到「應用程式」覆蓋。

本機資料資料夾會保留。

14. 常見問題

只能看到兩個模組？
還沒填授權，或授權裡沒有對應模組。到狀態列開啟 授權，填 App ID / App Secret；已開通 裡鎖住的項目表示目前授權未包含。

授權過期？
優先點 申請 5 天試用/續期 自助續期；半年視窗結束後到 開通更多 寄信 support@mossboat.dev，並附上 App ID 申請長期授權。

語言不是繁體中文？
偏好設定 → 一般 → 語言 → 繁體中文。

關掉次區之後找不到檢查面板？
視窗頂欄打開次區開關。

GeoCanvas 匯出帶底色？
預覽 → 匯出時選背景：透明 / 黑 / 白 / 自訂。

MossNet 沒有模型？
先啟動 Ollama，拉好模型（例如在終端機執行 ollama pull …），回到 MossNet 重新整理模型清單。

AmberClip 沒有波形，或匯出失敗？
安裝 ffmpeg，或把 ffmpeg / ffmpeg.exe 放到與程式同一目錄。

Windows SmartScreen / macOS「無法驗證開發者」？
Windows：更多資訊 → 仍要執行。macOS：隱私權與安全性 → 仍要打開。若公司政策完全禁止未知程式，請讓 IT 加白名單。

誤刪了畫板或工作流程？
看模組裡是否有復原。MossNet 有檢查點回溯。仍找不回時，不要用舊備份貿然覆蓋整個資料資料夾（會把目前資料一併換掉）。