# 如何閱讀 Oysterun 的大型 Tool 結果 分辨長串 Tool 活動與單一超大結果，使用 View details、分頁和有界內容安全地閱讀目前可用資訊。 當 Session 裡有一長串 Tool 活動，或單一 Tool 結果大到無法完整顯示時，請使用本指南。你會先判斷是哪一種情況，再開啟受支援的詳細資料、逐頁閱讀有界內容，最後在不重複執行可能產生副作用的指令下安全停止。 簡短原則： 一長串 Tool 執行與單一超大 Tool 結果是兩種不同的限制。 View details 可以整理多次 Tool 呼叫並分頁顯示，但不能讓單一超大結果的完整內容變得可用。 ## 開始前 - 你的 Oysterun Host 已連線，而且你能開啟相關的 Session。 - 該 Session 內有可見的 **Tool Call**、**Tool Update**、**Tool Output**、**Tool Result**、**Tool Error**，或已群組的 Tool 資料列。 - 你知道原始指令是否可能變更檔案、帳號、服務或其他外部狀態。如果有可能，請勿只為了換一種顯示方式而再次執行。 **起始畫面：**開啟該 Session 的聊天頁面，捲動到與你要檢查的結果相對應的 Tool 資料列。 ## 1. 判斷你遇到哪一種大型結果 你看到的內容 代表的意義 受支援的閱讀方式 一筆保留的 Tool 資料列代表一長串呼叫、更新、輸出、結果或失敗事件 這是多事件的長串 Tool 執行。後續事件可在主要聊天時間軸之外群組呈現。 選擇 View details ，再使用呼叫分頁。 單一 Tool 結果只顯示摘要、預覽或大小限制狀態 該單一結果有顯示上限；完整內容可能太大，Oysterun 無法顯示。 閱讀可用的預覽或詳細資料。不要預期長串執行的分頁會顯示此單一結果的剩餘內容。 一般的舊 Tool 資料列沒有 View details 操作 它可能是沒有受支援延續內容的舊式單一事件。 使用資料列中可見的內容；不要因為操作不存在，就判定指令執行失敗。 不要從長度推斷成功。 長串執行可能以失敗或不完整的呼叫結束，短預覽也可能屬於成功結果。請閱讀所選呼叫的可見狀態與結果。 ## 2. 開啟受支援的 Tool 詳細資料 ![開啟詳細資料前，同一個 Session 中的 Tool 資料列標題、預覽與 View details 操作同時可見。](../assets/publication/tool-row-view-details.jpg) 畫面 checkpoint：在開啟詳細資料前，目標 Tool 資料列、預覽與 View details 同時可見。 1. 找到你要檢查的執行流程中，第一筆保留的 Tool 資料列。 1. 先讀取標題與預覽，避免誤開相鄰的結果。 1. 選擇 **View details**。 檢查點： 詳細資料對話框已開啟，標題可能是 Tool Usage 、 Tool Message Group 或 Tool Output Batch 。如果資料列沒有 View details 操作，請停在目前可見的資料列；該事件沒有可開啟的受支援延續內容。 ## 3. 逐次呼叫閱讀長串 Tool 執行 ![Tool Usage 第 2 頁（共 2 頁）顯示第 11 次呼叫、成功狀態、Call、Output、Result、Previous 與停用的 Next。](../assets/publication/tool-detail-page-two.jpg) 畫面 checkpoint：第 2 頁在同一個完整對話框中顯示第 11 次呼叫、狀態、可用區段與前後分頁控制。 1. 從目前選取的 **Tool Invocation** 開始。它的狀態可能是進行中、成功、失敗或不完整。 1. 閱讀存在的區段：**Call**、**Updates**、**Output** 與 **Result**。如果該次呼叫沒有產生某種事件，相對應的區段可能不會出現。 1. 如果對話框出現分頁控制，使用 PreviousPage N of MNext 瀏覽整段執行。每頁最多包含 10 次邏輯呼叫。 1. 在每一頁選取你需要的呼叫，再閱讀它目前可用的區段。 檢查點： 移至其他頁面時，頁碼標籤會改變；所選呼叫的可見 Call、Updates、Output 或 Result 屬於該頁。 Previous 或 Next 停用，代表你已位於可用頁面的那一端。 ## 4. 理解單一超大結果的界線 ![超大 Tool 詳細資料顯示一個會產生 2,100,000 bytes 的指令、有界輸出，以及精確的 1,051,424 bytes omitted 標記。](../assets/publication/oversized-result.jpg) 畫面 checkpoint：詳細資料保持有界，並明確標示 1,051,424 bytes omitted ，沒有宣稱可延續讀取。 Oysterun 會限制 Tool 詳細資料的大小，避免單一結果壓垮 Session 畫面。收合的資料列可能只有摘要或預覽，而 **View details** 只會顯示目前可供呈現的部分。 1 MiB 顯示界線： 當一次 Tool 呼叫所選的 Call 或 Output 超過 1 MiB（1,048,576 bytes）時，Oysterun 在此詳細資料檢視中只顯示最前面的 1 MiB。因此，2,100,000-byte 測試資料會精確標示 1,051,424 bytes omitted 。呼叫分頁不會揭露被省略的剩餘內容，本檢視也不提供其延續內容或下載功能。 請用可見的摘要、預覽、狀態與有界詳細資料判斷發生的情況。不要把 provider 端的本機路徑或隱藏儲存位置當成公開的復原途徑。 ## 5. 在不重複 Tool 操作的情況下復原 - **開啟了錯誤的詳細資料：**選擇 **Close**，找出正確的 Tool 資料列，再選擇該列的 **View details**。 - **詳細資料仍在載入：**等待目前的請求結束。如果沒有結束，關閉對話框，再重新開啟同一筆資料列一次。 - **對話框回報不完整或較舊的 Tool Detail pipeline：**關閉它，重新開啟同一個 Session 一次，再嘗試同一筆資料列一次。如果訊息仍存在，保留可見錯誤並向管理該 Host 的人員求助。除非該人員明確指示，否則不要自行重新啟動 Host。 - **結果受到大小限制：**將缺少的部分視為無法在此檢視中取得。若你希望日後的結果能在這裡閱讀，請在再次執行任務前，先要求較短的摘要或有明確範圍的分段內容。 - **原始指令可能有副作用：**不要只為了取得更多詳細資料而重新執行。請先確認可見的最終狀態，再詢問 Host 管理者或任務負責人下一步。 安全停止點： 重新開啟一次後，無法取得的延續內容或持續出現的詳細資料錯誤，不會因為重送相同工作而修復。請保留可見的 Tool 資料列與錯誤狀態，然後停止。 ## 6. 關閉詳細資料並確認所在位置 ![選擇 Close 後，同一個 Session 仍顯示原始 Tool 資料列與 FIXTURE READY 完成狀態，沒有第二次 Tool 操作。](../assets/publication/tool-row-after-close.jpg) 畫面 checkpoint：選擇 Close 後，原始 Tool 資料列與終端完成狀態仍保留，且沒有再次執行 Tool。 1. 選擇 **Close**。 1. 確認你回到同一個 Session，而且原始 Tool 資料列仍然可見。 1. 記錄呼叫狀態與你實際讀到的有界資訊。不要把未看見的內容描述成已復原。 完成： 你已分辨多事件的長串執行與單一超大結果，讀完所需的所有受支援分頁或有界區段，並保持原始 Tool 操作不變。