# 實作狀態

本頁列出 PodRun 的完整規劃：哪些已可使用、哪些仍在開發。目標是讓部署到遠端 Podman 與 k3s 像在本地執行 docker compose 一樣方便。

## 已完成

| 項目 | 說明 |
|---|---|
| Podman Compose 部署 | `up`、`down`、`clear` 與 `ps`／`logs`／`restart`／`exec`／`build` 轉送 |
| 檔案同步 | rsync 同步與覆寫前差異預覽 |
| Compose 改寫 | 遠端副本移除主機 Port、補 `:z` |
| 部署紀錄 API | `/api/pod/*` 與 SQLite 儲存 |

## 未完成

| 項目 | 狀態 | 規劃內容 |
|---|---|---|
| k3s Runtime（`--type=k3s`） | **[未完成]** | 以同一套指令部署至 k3s；目前僅寫入 `target` 欄位，實際仍以 Podman Compose 執行 |
| `deploy` | **[未完成]** | 將專案部署至 Kubernetes |
| `export` | **[未完成]** | 將專案匯出為 Pod Manifest |
| `domain` | **[未完成]** | 為 Pod 設定網域，已預留 `domains` 資料表 |
| `info` | **[未完成]** | 顯示專案資訊 |
| `clone` | **[未完成]** | 將遠端專案複製回本地 |

未完成指令目前的行為：五個指令都會先印出一行規劃說明；之後 `domain`、`deploy` 不執行任何動作，`export`、`info`、`clone` 回傳 `unsupported command`。
