Spacewave：在瀏覽器裡運作的本地優先協作空間

專案要解決的具體問題：spacewave

s4wave/spacewave 的 README 將專案描述為「self-host directly in the web browser, no servers required. local-first」。本文只整理倉庫可直接核對的內容，不把 star、Fork 或宣傳語當成品質證明。README 在「README」下寫到：Open it in your browser: no account, no server, working offline in one click.。這說明的是專案邊界，不是已完成的生產驗證。

spacewave 的 README 把第 1 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

功能與資料流：spacewave

從 README 的「README」與相關條目，可以先判斷它是否處理你的實際問題：Multiplayer: Invite people into a Space and work in it together, live。若需求不同，不應只因專案熱度就採用。本文保留原始專案名、命令與元件名，方便回到一手來源核對。 README 另外列出一項可核對的資訊：Spaces: One shared place for your files, notes, apps, devices, and workflows。這類原文條目可用來設計試跑步驟，但不能取代實際環境測試。

spacewave 的 README 把第 2 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

安裝入口與執行方式：spacewave

README 將運作方式分散在「README」等段落。可確認的線索包括：As your work grows, the workspace becomes a Space: shared encrypted state for files, notes, apps, layouts, devices, and workflows. Spaces are multiplayer: invite people into one and work in it together, live.。本文不把未寫出的架構、效能或安全邊界補成結論；真正的執行鏈仍要配合目錄、設定檔與版本標籤檢查。

spacewave 的 README 把第 3 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

文件已說明的限制：spacewave

第一次安裝應從 README 指出的入口開始。目前可核對的命令是：

# Install dependencies bun install

# Start the desktop app bun run start:desktop

# Start the web app with GoScript browser Go plugins bun run start:web

# Start the web app with standard Go/WASM browser Go plugins bun run start:web:wasm

如果倉庫沒有命令，本文不會自行編造步驟，而是建議先閱讀「Why Spacewave?」，確認系統依賴、預設埠與首次初始化。

spacewave 的 README 把第 4 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

採用前的專案檢查：spacewave

日常使用取決於專案文件。README 的「README」段落提到：You choose where your data lives and how it moves. Store it on your machines, in your browser, on your own server, or in a cloud you pick, and sync over any network your devices can reach.。設定檔、環境變數、權限與資料目錄只在來源明確時才會記錄；沒有寫出的預設值，應在測試環境驗證並保留回滾副本。 同一部分也提到：Peer-to-Peer Sync: Sync directly between your devices and keep working offline。

spacewave 的 README 把第 5 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

維護訊號與授權：spacewave

README 能確認的限制比宣傳頁更重要。現有來源沒有證明s4wave/spacewave具備固定相容矩陣、服務等級、效能基準或長期支援承諾。README 只明確寫到「Make it your own with the same machinery the app is made of: a Go, TypeScript, React, and WebAssembly stack where every app is local-first, multiplayer, and encrypted by default.」。這些未知項應列入選型紀錄，不要改成肯定句。

spacewave 的 README 把第 6 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

實際使用邊界：spacewave

授權資訊來自倉庫資料與 LICENSE：目前 SPDX 標識為 Apache-2.0。這代表分發和修改要依授權處理，但不等於完成安全審查。憑證管理、網路暴露、日誌保存與第三方依賴若未在 README 說明，仍需逐項檢查。

spacewave 的 README 把第 7 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

編輯判斷：spacewave

維護判斷只能引用可追溯訊號：預設分支為 master，快照記錄 588 個 star、9 個 fork、1 個開放 issue。README 的「README」寫到：Plugin Ecosystem: Extend a Space with plugins:。這可用來安排升級複核，不能取代變更測試。 維護時也應對照 README 的「README」段落：[in your browser]: https://spacewave.app [Spacewave App]: https://spacewave.app [SkiffOS]: https://skiffos.com。

spacewave 的 README 把第 8 節的這個專案放在很清楚的技術脈絡裡：它提供的入口、資料格式、執行命令與限制，都應以文件實際寫出的內容為準。對 s4wave/spacewave 而言，這種界線很重要，因為倉庫描述可以說明設計目標，卻不能代替你的作業系統、依賴版本和真實輸入。閱讀本節時，先把專案名稱、命令和檔案路徑標出來，再對照自己的流程逐項核對。 在 s4wave/spacewave 的情境中，這表示不能把未列出的整合當成既定功能，也不能把 README 的示例數字直接移植到另一台機器。若要採用，應從文件列出的命令和輸入開始，保留原始輸出，再針對這個專案的錯誤訊息、設定鍵或產物檔案作判斷。本節特別要核對 spacewave 的專案名稱、README 指定的命令和輸入輸出關係。測試紀錄應保留成功與失敗兩種結果，並分開標註文件明示內容和本機觀察內容。這樣日後更新 s4wave/spacewave 時，才能知道是版本改變、環境差異，還是原本就未承諾的行為。

編輯結論

適合能接受瀏覽器本地儲存、WebRTC 與加密同步模型的個人或小型協作團隊；不適合要求單一伺服器掌握所有資料、或尚未釐清離線衝突處理的組織。先執行 bun run test、bun run typecheck，並以實際 .proto 變更驗證 bun run gen。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes