快速入門

1. HakoSpace 是什麼

HakoSpace 是自架的語音、視訊與訊息平台，讓你完全掌控伺服器、資料與隱私。 （產品名 Hako 取自日文「箱（はこ）」—— 一個只屬於你的盒子。）

HakoSpace 由兩個部分組成：HakoSpace Server（伺服器，由架設者部署在自己的主機上）與 HakoSpace 客戶端（Web 或 Desktop，給終端使用者連線使用）。終端使用者只需要一個由伺服器擁有者提供的網址，就可以開始使用。

重要：HakoSpace 沒有跨伺服器的全域帳號。每個 HakoSpace Server 的成員資料是獨立的，你需要在每個想加入的伺服器分別註冊一次。

2. 選擇你的客戶端：Web 或 Desktop

HakoSpace 提供兩種客戶端，核心功能（訊息、語音、視訊、頻道）完全相同。差別在於 Desktop 多了幾項只有桌面環境才能做到的功能。

客戶端	取得方式	適用情境	桌面專屬功能
HakoSpace Web	用瀏覽器直接訪問伺服器網址（https://...）	想立刻試用、不安裝任何軟體	—
HakoSpace Desktop	從官網下載安裝（Windows / Linux）	想常駐使用、用全域快捷鍵或 HakoCap 螢幕擷取	系統匣、全域快捷鍵、按鍵發話、HakoCap 螢幕擷取、（Windows）遊戲 HUD、（Linux）應用程式音訊擷取等（見《使用者指南》桌面專屬章）

兩種客戶端都能連到任意 HakoSpace Server。如果你想同時連多座伺服器：Web 開多個瀏覽器分頁就行；Desktop 則內建多伺服器側欄，方便在同一個視窗裡切換。

3. 加入你的第一個 HakoSpace Server

HakoSpace 是自架的，所以你需要一個伺服器網址才能開始。網址通常由你的伺服器擁有者提供（例如 https://example.com:8443）。

3.1 走 Web 路線

1. 取得伺服器網址（向擁有者索取）。網址格式為 https://... 開頭。
2. 在瀏覽器網址列輸入該網址，按 Enter。
3. 你會看到登入頁面，標題顯示「歡迎來到 {伺服器名稱}！」。
4. 接著進入下一節「4. 建立帳號 / 登入」。

Web 沒有「加入伺服器」這個步驟 —— 網址本身就決定了你要連哪一座 HakoSpace Server。要同時連多座伺服器，可以開多個瀏覽器分頁分別輸入不同網址。

3.2 走 Desktop 路線

1. 從官網下載並安裝 HakoSpace Desktop（Windows 或 Linux 版）。
2. 啟動應用程式。用官網的「安裝程式」安裝的 Windows 版，會先出現一個檢查更新的啟動畫面，有新版本時會更新並重新開啟，之後才出現主視窗。第一次開啟時，視窗最左側是多伺服器側欄，其餘的畫面中央會顯示「選擇伺服器以連線」。
3. 點側欄上的 + 按鈕（滑鼠移上去會顯示「新增伺服器」）。
4. 在彈出的對話框中填入：
   • 伺服器名稱：自訂的顯示名稱（用來在側欄辨識，可隨意命名）。
   • 伺服器位址：擁有者提供的網址（例如 https://example.com:8443）。
5. （建議）點「測試連線」確認伺服器可達；測試成功後再點「確認新增」。
6. 新增完成後，伺服器會以圖示出現在左側欄，點一下即可連線。
7. 連線成功後，進入下一節「4. 建立帳號 / 登入」。

HakoSpace Desktop 視窗的最左側會常駐一條多伺服器側欄，列出所有已新增的伺服器圖示。側欄上的 + 按鈕（滑鼠移上去會顯示「新增伺服器」）讓你日後隨時可以加入更多伺服器。

4. 建立帳號 / 登入

連線到伺服器後，預設會看到登入頁。HakoSpace 帳號以伺服器為單位，即使你在其他 HakoSpace Server 已有帳號，到一座新的伺服器仍要重新註冊。

登入頁的欄位：

• 使用者名稱（提示文字：「輸入你的使用者名稱」）
• 密碼（提示文字：「輸入你的密碼」）
• 下方有「忘記密碼？」連結。

如果你還沒有帳號，請點頁面下方「還沒有帳號？」旁的「註冊」連結前往註冊頁。

註冊頁的欄位（公開註冊模式下）：

1. 使用者名稱：必填，最多 20 個字元（提示文字：「選擇一個獨特的使用者名稱」）。是你在伺服器中的唯一識別代號。
2. 暱稱（選填）：最多 20 個字元，可顯示中文、表情符號等任意字元，註冊後可隨時於設定中變更。
3. 密碼：必填。要求至少 6 個字元，必須包含英文字母和數字。
4. 確認密碼：再次輸入相同密碼以確保一致。

不同伺服器的註冊模式：

不同伺服器擁有者會採用不同註冊政策，你可能會遇到下列其中一種：

• 公開註冊：直接填上述表格即可建立帳號。
• 邀請制：註冊頁會多出「邀請碼」欄位，需擁有有效邀請碼才能完成註冊。
• Email 驗證制：註冊時須填 email；提交後會收到驗證信，點擊信中連結後帳號才會啟用。
• 註冊已關閉：頁面顯示「目前已關閉註冊。」，無法自助註冊；請聯繫伺服器擁有者另行開通。

註冊成功後會看到「帳號已建立！正在跳轉至登入頁面…」。

關於 Email 驗證：驗證信由伺服器擁有者設定的寄件地址發出，並非 HakoSpace 官方統一寄發。如果遲未收到，請先檢查垃圾信匣。若仍未收到，請用該帳號的使用者名稱和密碼登入一次；登入頁會偵測到帳號未驗證並顯示「重新發送驗證郵件」按鈕，填入你註冊時用的 email 後點擊即可重寄。使用者名稱或密碼不對時不會出現這個按鈕。

5. 傳出你的第一則訊息

登入成功後會進入主介面。如果伺服器擁有者已設定預設頻道，你會自動進入該頻道；否則需從左側頻道列表手動選一個文字頻道（標示為 # 的頻道）。

進入空頻道時，畫面中央會顯示：

• 歡迎來到 #{頻道名稱}！
• 這是 #{頻道名稱} 頻道的開始。成為第一個發言的人吧！

訊息輸入框位於畫面下方，提示文字會隨頻道變動，顯示為「在 #{頻道名稱} 中發送訊息」。

發送訊息：

1. 在輸入框輸入訊息內容。
2. 按 Enter 發送。
3. 按 Shift + Enter 換行（不發送）。

用注音等輸入法選字時按的 Enter 與 Esc 只用在選字上，不會發送訊息。

訊息發送後會立即出現在頻道訊息流中。

進階用法：HakoSpace 訊息支援多種文字格式 —— 粗體、斜體、刪除線、行內程式碼、自訂字體區域（不同字型的特殊文字效果）、以及防劇透 / 隱藏文字等。訊息輸入框右側有一個「格式說明」按鈕，點開可以看到完整的語法清單。詳細用法請見《使用者指南》文字頻道章節。

6. 加入語音頻道

左側頻道列表裡，文字頻道的名稱前綴 #，語音頻道的名稱前綴 ♪ 音符圖示。伺服器若有頻道群組，頻道會列在各群組的名稱底下。

加入與控制：

1. 點擊即加入：點擊任一語音頻道的名稱即直接加入該頻道，沒有「先進設定再加入」的中間步驟。
2. 權限請求：首次加入時，瀏覽器或系統會請求麥克風權限；鏡頭要等你在左側欄底部的「視訊來源」選單按「開啟鏡頭」時才會另外請求（見《使用者指南》§3.3）。
   • 若拒絕鏡頭權限，會看到提示：「HakoSpace 需要鏡頭權限以讓他人看見你。」並補充：「請至瀏覽器或系統設定開啟鏡頭權限，你也可以僅以音訊繼續。」
   • 即使拒絕鏡頭，仍可進行純語音通話。
3. 音訊控制按鈕（位於左側欄底部）：
   • 靜音麥克風 / 取消靜麥：切換麥克風是否送出聲音。
   • 拒聽 / 取消拒聽：切換喇叭是否輸出。啟用「拒聽」時，麥克風也會同時被靜音。
4. 離開頻道：點擊左側列表中的另一個語音頻道時會跳出確認對話框，按「切換」即可離開原頻道並加入新頻道；點你目前所在的語音頻道則會跳出「離開語音頻道？」對話框，按「離開」即可離開。關閉應用程式 / 網頁則會自動離開。

語音輸入模式：

HakoSpace 提供兩種語音偵測方式：

• 語音感應：偵測到聲音時自動送出。
• 按鍵發話：必須按住指定快捷鍵才會送出聲音。

兩種模式的切換在「桌面設定 → 行為 → 語音輸入模式」，僅 HakoSpace Desktop 可調整；HakoSpace Web 一律採語音感應。詳細設定請見《使用者指南》桌面版專屬章節。

7. 下一步

到這一步，你已經能在 HakoSpace 上發訊與通話。接下來依你的需求閱讀對應文件：

• 想深入了解 HakoSpace 的所有功能（私訊、論壇、IO Apps、桌面專屬功能等）：請見《使用者指南》。
• 想自己架一座 HakoSpace Server：請見《速架設指南》。
• 遇到問題或有疑問：請見《常見問題》。