PTT 終端機畫面解析注意事項 全站各列表模式 (看板列表、文章列表、信件列表、、使用者名單)、 文章閱讀器 (pmore) 與看板資訊/設定 ([i]) 的介面標準化改版即將上線。 若有透過畫面文字、座標或按鍵腳本進行解析 (Screen Scraping) 的 App / Bot / 外掛開發者，請及早測試 & 更新。 此更新可以與前一項介面調整一併進行，但此項上線時間會比較晚， 可以先寫好兩套邏輯切換。 上線時間: PTT2 - 9/20 PTT1 - 10/18 (預定) 影響範圍: 所有依賴各列表底部狀態列左側標籤 (Caption)、次標題列 (Row 1)、 文章閱讀器右下角提示、以及看板資訊 ([i]) 畫面與按鍵流程 做狀態判讀的 App/Client。 說明： 為了統一全站各子系統的操作體驗與指令架構，我們將所有列表畫面與 閱讀/編輯器遷移至統一的動態指令列 (vs_cmd_bar) 與列表瀏覽框架 (PSB)。主要影響畫面解析與自動化操作的變更如下： 1. 各列表模式底部狀態列 (最後一列 / Row 23) 左側標籤改版 許多 Client 依賴左下角第一個反白區塊判斷目前所在的列表模式， 各列表的標籤文字已統一調整如下： (a) 看板列表 / 我的最愛 / 分類看板： - 舊版：一律固定為「 選擇看板 」(前後各 2 格半形空白) - 新版：依所在列表類型區分為 3 種 (前後改為各 1 格半形空白)： * 一般/熱門/分類子層看板列表：「 看板列表 」 * 我的最愛列表： 「 我的最愛 」 * 分類看板根目錄： 「 分類看板 」 (b) 看板文章列表 / 站內信箱列表： - 舊版：看板一律為「 文章選讀 」、信箱一律為「 鴻雁往返 」 - 新版：依目前閱讀與篩選狀態細分為 4 種： * 一般看板文章列表： 「 文章列表 」 * 搜尋/同主題/條件篩選結果： 「 系列文章 」 (如執行 /, ?, a, Z, G, #, = 等搜尋過濾後的列表) * 看板文摘模式 (按 Tab)： 「 文摘列表 」 * 站內信箱列表： 「 信件列表 」 (c) 列表： - 舊版：一般使用者「 【功能鍵】 」、板主「 【板 主】 」、 剪貼簿有標記時「【已標記(複製) N 項】」 - 新版：一般使用者「 精華列表 」、板主「 精華管理 」、 剪貼簿有標記時「 標記項目 」 2. 次標題列 (Row 1) 與底部狀態列 (Row 23) 改為動態指令列 - 舊版：Row 1 與 Row 23 的按鍵提示為固定寫死的字串 (例如文章列表 Row 1 固定為「[←]離開 [?]閱讀 [Ctrl-P]發表文章...」，Row 23 固定為「 (y)回應(X)推文(^X)轉錄 (=[]<>)相關主題...」)。 - 新版：統一由系統依「指令優先權」、「使用者權限」、「列表是否為空」 及「終端機寬度」動態排版輸出： * Row 1 格式統一為「[按鍵]名稱」(以半形空白分隔)；信箱 Row 1 不再顯示舊有的「[O]站外信:開/關」狀態文字。 * Row 23 中段格式統一為「 (按鍵)名稱」(每個項目間皆有半形空白， 不再有「(y)回應(X)推文」緊貼或「(/?a)」合併寫法)，最右側統一 靠右對齊「(h)說明」(或單列模式為「(←)離開 (h)說明」)。 * 空列表動態隱藏：當看板無文章、搜尋無結果、信箱無信件時，所有 需作用於項目的指令 (如閱讀、刪除、回應、推文、搜尋等) 會自動 從 Row 1 與 Row 23 隱藏。 3. 看板資訊/設定畫面 (看板內按 [i]) 全面改版與按鍵行為變更 若您的程式會自動送出「i」擷取看板設定、或提供板主管理工具，請特別 注意此畫面已由舊版半螢幕覆蓋視窗改為「全螢幕可捲動列表」： (a) 離開按鍵變更 (重要！避免狀態機卡死)： - 舊版：一般使用者按 i 檢視後，送出「任意鍵」(如 Space 或 Enter) 即可關閉視窗回到文章列表。 - 新版：進入標準列表瀏覽模式，【必須送出 q 或 ←】 才能離開！送出 Space / PgDn 會執行列表向下翻頁而不會離開。 (b) 畫面佈局與內容調整： - Row 0：兩段式標題「 看板設定與管理 - <板名> 」+「 [唯讀檢視]」 - Row 1：「 看板代號: <板名> 板主名單: <名單> 看板編號: <N>」 - Row 2：「 中文敘述: <敘述> 人氣指數: <N>」 - Row 3：欄位標題「 # 設定 / 管理項目 狀態」 - Row 4~22：編號項目列表 (共 21 項，24 行畫面首頁顯示第 1~19 項) - 移除舊版右側的「發文與推文限制」(登入次數/退文篇數等) 顯示區塊。 (c) 板主設定操作流程變更： - 進入 [i] 畫面預設一律為「唯讀模式」，此時直接按 w (水桶)、 c (文章類別)、m (投票) 等單鍵熱鍵不會觸發；必須先送出 Ctrl-P 切換至「編輯模式」後方可使用單鍵熱鍵 (或移動游標按 Enter)。 - 在編輯模式下離開時，系統會顯示「已儲存新設定」或 「未改變任何設定」提示訊息，需多按一次任意鍵確認。 4. 列表為空 (0 筆資料) 時的游標與畫面行為 - 當看板列表、文章列表、信件列表、或使用者名單為空時： * 畫面上【不會繪製「>」游標字元】，終端機硬體游標會停在右下角 (Row 23, Col 79)。 * 空文章列表會在 Row 3 顯示「 沒有文章...」。 5. 文章閱讀器 (pmore) 與編輯器底部狀態列調整 - 文章閱讀畫面 (pmore)： * 左半部進度資訊「 瀏覽 第 x/y 頁 ( zz%) 目前顯示: 第 xx~yy 行」 【完全不變】。 * 右半部按鍵提示改由動態指令列產生，最右側結尾文字由原本的 「(h)說明(→)離開 」/「(h)說明 (←/q)離開 」調整為 「(←)離開 (h)說明」(順序對調且統一色碼)。 - 文章編輯器 (vedit)： * 左側「 編輯文章 」與最右側狀態框「||插入|5ipr|| 1: 1」【不變】。 * 中段按鍵提示改為 (^X)存檔 (^C)色碼 (^V)彩色...(Esc-h)按鍵 (^Z)說明」 * 給第三方程式開發者的建議 1. 判斷目前所在列表畫面時，請檢查 Row 23 最左側的反白標籤 (Caption)， 並將「 看板列表 / 我的最愛 / 分類看板 」、「 文章列表 / 系列文章 / 文摘列表 」、「 信件列表 」納入狀態機判定；請勿再寫死比對舊版的 「 選擇看板 」、「 文章選讀 」或「 鴻雁往返 」。 2. 請勿依賴 Row 1 (次標題列) 或 Row 23 中段的完整按鍵提示字串做畫面 辨識，因為該區域會隨使用者權限、視窗寬度與列表是否為空而動態增減。 3. 若您的程式有實作「按 i 讀取看板資訊」，離開該畫面時請務必明確送出 「q」或「?」，切勿送出空白鍵或 Enter，以免卡在看板設定列表內。 4. 判斷文章閱讀 (pmore) 狀態與閱讀進度時，請繼續解析左半部的 「瀏覽 第 x/y 頁 ( zz%) 目前顯示: 第 xx~yy 行」，不要依賴最右側 的「(←)離開 」字樣。