# 如何判讀 Oysterun Agent 正在工作或已經閒置

從 Sessions 頁面實際送出一則安全訊息，分辨可用、占用、工作、完成與未知狀態，避免重複派工。

這份 Docs 指南幫助你在同一個 Oysterun Session 中分辨五種狀態：可使用、仍被占用、已有可見進度、已結束與未知。你會開啟一個真實 Session、送出一則安全訊息，再選擇下一步，同時避免重複派工。

最短判讀原則：

Oysterun 當前 provider 的回應中指示器，只能證明這一輪仍被占用、不是閒置；它本身不能證明 Codex 或 Claude 已開始或正持續產生有效進度。看不到指示器也不能直接判定閒置，送出下一則訊息前仍要檢查最新結果。其他聊天參與者的輸入中提示是另一種訊號，不能證明 provider 活動。

## 開始之前

- 你的 Oysterun Host 已連線。
- 該 Host 已安裝並登入 Codex 或 Claude Code。
- 你至少有一個可以開啟的 Session。如果 Sessions 頁面是空的，選擇 **New Session**，選好 Codex 或 Claude 與 Start Folder，再選擇 **Start Session**。

**起始畫面：**開啟 Oysterun，從主導覽列選擇 **Sessions**。

## 1. 開啟 Session 聊天

![同一個 Session 的標題與完整輸入框，顯示在最新對話畫面中。](../assets/publication/session-available.png)

畫面 checkpoint：同一個 Session 的標題與完整輸入框顯示在最新對話畫面中，確認這個 Session 可以使用。

1. 在 **Sessions** 頁面選擇你要檢查的 Session。
1. 等待聊天頁面開啟。
1. 確認頁面底部看得到訊息輸入框。

檢查點：

畫面顯示指定的 Session 與它的輸入框。這只證明可以檢查或使用該聊天，不能證明 provider 閒置、仍被占用或已產生進度。

## 2. 送出一則安全的測試訊息

1. 在輸入框輸入：「不要使用工具、不要讀取檔案，也不要變更任何內容；請用五個簡短項目，說明你能回答哪些軟體專案問題。」
1. 只送出一次。
1. 讓同一個聊天頁面保持開啟，等待 Oysterun 接受訊息。

檢查點：

你送出的訊息會留在對話中。如果回答快到你沒看到回應中指示器，直接進到步驟 5；這是合法的快速完成，不要為了強迫指示器出現而重送。如果 Oysterun 立刻顯示送出錯誤，代表這一輪沒有開始；重試前先閱讀錯誤內容。

## 3. 辨認「仍被占用」的狀態

![同一個 Session 的完整桌面畫面，同時顯示一則安全測試請求與目前的 Codex 回應中指示器。](../assets/publication/turn-occupied.png)

畫面 checkpoint：安全測試請求只出現一次，同一個 Session 內也同時看得到目前 provider 的回應中指示器。

Oysterun 接受訊息後，當前 provider 可能會在對話下方顯示為 **Codex is typing…**、**Claude is typing…**，或其他 provider 專屬的回應中指示器。這裡要判讀的是 Oysterun 當前 provider 狀態，不是一般聊天參與者的輸入中提示。

- **指示器可見：**這一輪仍被占用。它可能只是已接受、排隊中、正在啟動、執行工具、等待控制，或疑似停滯；指示器本身無法分辨這些情況。不要重複送出相同請求。
- **在這一輪仍被占用時，出現屬於本請求的新 Agent 文字或 Tool 結果：**這一輪已產生可見進度。繼續追蹤原本的請求。
- **Stop response 可用：**Oysterun 此刻提供請求中斷的操作。中斷是否仍會被接受，與目前是否仍被占用或已有進度，是不同的判斷。

不要把輸入中提示或等待秒數當成進度證明。

其他參與者也可能產生一般輸入中提示，有些工具執行時則不會持續顯示文字。無論是安靜幾秒，或只看到 provider 指示器，都不足以證明正在產生有效進度。

## 4. 處理疑似重複開始

重新連線可能讓同一輪看起來又開始一次。指示器重複出現或頁面重新連線，都不是重送訊息的理由。

1. 確認原本送出的訊息仍留在聊天中。
1. 不要重送，也不要為同一個請求另開一個 Session。
1. 等待一個完整回答、明確錯誤或停止結果。
1. 如果同一個請求看起來產生了兩份回答，或畫面反覆回到回應中卻沒有最終結果，開啟原始訊息的 **…** 選單並選擇 **Copy Debug Info**。
1. 私下把資訊交給管理該 Host 的人，不要公開張貼。

檢查點：

你只追蹤原本那一則請求；最後要嘛得到一個終端結果，要嘛保留一份交給 Host 管理者的私密 debug 記錄，調查期間不建立另一個 delivery。

## 5. 確認這一輪已結束

![同一個 Session 顯示單一原始請求與完整五項回答，而且沒有回應中指示器。](../assets/publication/turn-terminal.png)

畫面 checkpoint：原始請求仍只有一則，完整回答已顯示，而且 provider 的回應中指示器已清除。

1. 等待完整的 Agent 回答、明確錯誤，或畫面顯示已停止／已取消的結果。
1. 確認回應中指示器已消失。
1. 閱讀最終結果，再決定下一則訊息要做什麼。

檢查點：

畫面已有完整回答、明確錯誤或停止結果，而且回應中指示器已清除。正常回答代表可以繼續下一個指令；錯誤或停止結果則應先修正畫面寫出的原因，再視情況重試一次。

## 6. 狀態不清楚時如何復原

如果沒有當前 provider 的回應中指示器，也沒有明確的最終結果，或畫面上的訊號互相矛盾，不要猜測 Session 已經閒置。

1. 只使用瀏覽器的 **Reload** 操作一次。
1. 再次閱讀最新訊息。
1. 如果頁面仍像是少了內容，回到 **Sessions**，再開啟同一個 Session 一次。
1. 如果最終結果出現，就依結果處理。如果狀態仍不清楚，不要重複送出請求；開啟最新已提交訊息的 **…** 選單，選擇 **Copy Debug Info**，再私下把資訊交給管理該 Host 的人。如果沒有這個指令，保留畫面上看得到的資訊並聯絡 Host 管理者，仍然不要重送。

安全停止點：

Reload 一次、重新開啟一次後仍無法判讀，就把狀態保留為「未知」。保存原請求與 debug info，不要製造重複工作。

## 狀態速查表

你看到的畫面

可以證明什麼

下一步

Session 可開啟，輸入框可見

可使用：

可以檢查或使用該聊天；無法因此證明 provider 活動或閒置

送出前先閱讀最新結果

Oysterun 當前 provider 的回應中指示器可見

仍被占用：

目前這一輪不是閒置；尚未證明持續或有效進度

不要重送；等待，或只在確定要中斷時使用 Stop response

在同一請求仍被占用時，出現新 Agent 文字或本輪 Tool 結果

可見進度：

這一輪開始後已產生新結果

除非確定要停止，否則繼續追蹤原本的請求

畫面出現完整回答、明確錯誤或已停止／已取消結果，且 provider 指示器已清除

已結束：

這一輪已以正常或其他結果結束

閱讀結果；正常回答後再送下一個指令，否則先修正畫面寫出的原因，再進行一次合適的重試

沒有 provider 指示器也沒有明確最終結果，或畫面訊號互相矛盾

未知：

無法證明閒置或仍有活動

Reload 一次、重新開啟一次，再保存 debug info，不要重送