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 行」，不要依赖最右侧 的「(←)离开 」字样。