版本說明
目前版本：v0.1.1
六步驟安裝裡下載到的就是這一版。
確認你手上是哪一版：
legatio-agent version
會印出版本、對應的 commit 與建置時間，例如
legatio-agent v0.1.1 (commit da53d197, built 2026-08-03T19:50:51Z)。
回報問題時附上這一行，我們就知道你跑的是什麼。
支援的機器：macOS（Apple 晶片／Intel）· Linux（x86_64／ARM）· Windows（x86_64） —— 一個檔案，五個平台，都附校驗和。
版本紀錄
| 版本 | 變更 |
|---|---|
| v0.1.1 | 執行檔內部的建置識別改用產品命名。功能與 v0.1.0 相同，不需要特別更新 —— 但新下載的就是這一版。 |
| v0.1.0 | 第一個公開發行版。 |
這一版會做什麼
十九項能力，出廠全部關著。你打開一項算一項，隨時可以用
legatio-agent flags 看它現在被允許做什麼。
在 Slack 裡對話
| 能力 | 做什麼 |
|---|---|
| 連上 Slack | 用 Socket Mode 連線，不需要你開防火牆或準備對外網址 |
| 收發訊息 | 私訊與被 @ 提及都收得到 |
| 逐字回覆 | 回答邊生成邊出現，不用等整段寫完 |
| 表情回應 | 用表情表示「收到了、正在想」 |
| 連續發言合併 | 你連打三句話，它當成一件事回答，不會回你三次 |
| 打招呼 | 第一次對話時的開場 |
指令
| 能力 | 做什麼 |
|---|---|
/help | 列出它現在會做什麼 |
/auth login | 用你的 Claude 帳號授權，授權碼不會留在頻道紀錄裡 |
它是誰、記得什麼
| 能力 | 做什麼 |
|---|---|
| 角色設定 | 給它一份「你是誰、你知道什麼」，每次對話都帶著 |
| 團隊知識 | 讓它帶著你們自己的資料回答 |
| 記住上下文 | 重新啟動後對話還接得下去（不開的話每次都是全新開始） |
安全
| 能力 | 做什麼 |
|---|---|
| 提示注入偵測 | 掃描送進來的內容，擋掉試圖竄改它行為的指令 |
| 敏感資料防護 | 出去的內容先過濾，避免把不該說的說出去 |
這兩項建議一直開著。另外，稽核紀錄（誰在什麼時候對它做了什麼）是一直都在的， 不是可選項。
讓它動手做事
| 能力 | 做什麼 |
|---|---|
| 讀檔案 | 讀取你指定範圍內的檔案 |
| 改檔案 | 修改檔案 |
| 執行指令 | 在機器上執行命令 |
三項是分開的開關，一層一層開。也可以一層都不開，讓它就只是一個很懂你們的問答對象。
開放執行指令，等於允許聊天室裡的一句話變成這台機器上執行的命令 —— 用的是這台機器的身分、憑證與網路存取權。
這一項必須在隔離環境（Linux 容器）裡跑。legatio-agent doctor 偵測到不符合
就直接判失敗、不放行，這是刻意的。在 Windows 或直接在 macOS／Linux 主機上跑，
這一項一定不會被放行。 要走到這一步請先跟我們聯絡。
這一版還不會做什麼
| 項目 | 現況 |
|---|---|
| 其他聊天平台 | 只支援 Slack。Mattermost、Zulip 規劃中。 |
| 其他 AI 服務 | 只支援 Claude。 |
| 圖形介面 | 沒有。設定走環境變數，狀態走 doctor／flags。 |
| 自動更新 | 沒有。換版本＝重新下載一個檔案覆蓋掉。 |
已知狀況
macOS 會說「無法驗證開發者」
執行檔目前沒有 Apple 的開發者簽章。照安裝指南用 curl 下載就不會遇到；
用瀏覽器下載的話執行一次 xattr -d com.apple.quarantine legatio-agent 即可。
Windows 會跳 SmartScreen 同樣是簽章的關係。點「其他資訊」→「仍要執行」。不放心的話先做校驗和核對。
Windows 上「執行指令」不會被放行
隔離檢查認得的是 Linux 容器，在 Windows 上一律判定為未隔離。
其餘功能（對話、讀寫檔案的開關、/auth）不受影響。
需要機器上有 Claude Code
它透過 Claude Code 與 AI 對話，所以那台機器上要有它。
legatio-agent doctor 檢查不到時會直接告訴你怎麼裝。
遇到問題
這三個指令會把多數狀況直接講出來，而且都不會改動你的電腦：
legatio-agent doctor # 這台機器缺什麼、怎麼補
legatio-agent flags # 它現在被允許做什麼
legatio-agent version # 你手上是哪一版
回報時附上 legatio-agent config 的輸出 —— 那是一份不含任何密碼與金鑰的設定摘要，
可以安全地貼給我們。