Fartown · Oct 23, 2026 · Oct 23, 2026 · Oct 23, 2026 · Oct 23, 2026
diff --git a/.gitignore b/.gitignore
@@ -270,3 +270,6 @@ ci-shards/
 /.build/windows-native-benchmark/
 
 .local/static-analysis-research/
+
+!docs/issue/终端聊天视图恢复/
+!docs/issue/终端聊天视图恢复/**
diff --git a/config/architecture-policies.jsonc b/config/architecture-policies.jsonc
@@ -6,6 +6,32 @@
     { "prefix": "@renderer/", "replacement": "src/renderer/src/" }
   ],
   "policies": [
+    {
+      "id": "native-chat-view-recovery",
+      "description": "Restore the existing terminal/chat view action without creating or resuming provider sessions.",
+      "rules": [
+        {
+          "id": "native-chat-view-recovery-worktree-scope",
+          "type": "change-scope",
+          "comparison": "worktree",
+          "whenChanged": [
+            "src/renderer/src/native-chat-view-recovery/**",
+            "docs/issue/终端聊天视图恢复/**"
+          ],
+          "allowedPaths": [
+            "src/renderer/src/native-chat-view-recovery/**",
+            "docs/issue/终端聊天视图恢复/**",
+            "src/renderer/src/components/tab-bar/SortableTabContextMenu.tsx",
+            "src/renderer/src/components/tab-bar/SortableTabContextMenu.test.tsx",
+            "config/fork-features.jsonc",
+            "config/architecture-policies.jsonc",
+            "docs/issue/README.md",
+            ".gitignore"
+          ],
+          "message": "Change is outside terminal chat view recovery."
+        }
+      ]
+    },
     {
       "id": "terminal-launch-diagnostics",
       "description": "Observational terminal launch tracing only; no runtime ownership or wire changes.",
@@ -485,6 +511,10 @@
           // diff against the upstream commit it last merged, evaluated without a sync first.
           "requireBaseAncestor": false,
           "allowedPaths": [
+            "src/renderer/src/native-chat-view-recovery/**",
+            "docs/issue/终端聊天视图恢复/**",
+            "src/renderer/src/components/tab-bar/SortableTabContextMenu.tsx",
+            "src/renderer/src/components/tab-bar/SortableTabContextMenu.test.tsx",
             "src/cli/integration-builds/**",
             "src/renderer/src/integration-builds/**",
             "src/main/serve-update-handoff.ts",

diff --git a/config/fork-features.jsonc b/config/fork-features.jsonc
@@ -22,6 +22,38 @@
   // Imports every feature may take without declaring them: the design-system primitives.
   "dependsOnIgnore": ["src/renderer/src/components/ui/**"],
   "features": [
+    {
+      "id": "native-chat-view-recovery",
+      "title": "终端聊天视图恢复",
+      "goal": "恢复已有终端标签的聊天视图切换，保留同一终端与会话绑定",
+      "journal": "docs/issue/终端聊天视图恢复/journal.md",
+      "dependsOn": [
+        "src/renderer/src/i18n/i18n.ts",
+        "src/renderer/src/components/native-chat/native-chat-shortcut.ts"
+      ],
+      "policyId": "native-chat-view-recovery",
+      "ownedPaths": [
+        "src/renderer/src/native-chat-view-recovery/**",
+        "docs/issue/终端聊天视图恢复/**"
+      ],
+      "requiredFiles": ["src/renderer/src/native-chat-view-recovery/TerminalTabViewSwitch.tsx"],
+      "seams": [
+        {
+          "file": "src/renderer/src/components/tab-bar/SortableTabContextMenu.tsx",
+          "mustContain": "TerminalTabViewSwitch",
+          "why": "Expose the existing same-pane view toggle in both directions."
+        },
+        {
+          "file": "src/renderer/src/components/tab-bar/SortableTabContextMenu.test.tsx",
+          "mustContain": "switches an eligible terminal tab into chat view",
+          "why": "Keep the existing menu behavior contract aligned with the restored entry."
+        }
+      ],
+      "tests": ["src/renderer/src/components/tab-bar/SortableTabContextMenu.test.tsx"],
+      "checks": [
+        "pnpm exec vitest run --config config/vitest.config.ts src/renderer/src/components/tab-bar/SortableTabContextMenu.test.tsx src/renderer/src/components/tab-bar/native-chat-tab-agent-evidence.test.ts"
+      ]
+    },
     {
       "id": "integration-builds",
       "title": "集成分支自动出包：同一提交的 macOS、Linux 与 Android 内测包",

diff --git a/docs/issue/README.md b/docs/issue/README.md
@@ -4,6 +4,7 @@
 
 | 需求                                                          | 目标                                                                                        | 状态         | 需求文档                                                                                | 方案                                                                                                                                                                                                                                                                                                                                                             | 测试用例                                                                                                                                                                                                                                                                                                                     | 更新       |
 | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| [终端聊天视图恢复](终端聊天视图恢复/journal.md)               | 恢复已有终端标签的聊天视图切换，保留同一终端与会话绑定                                      | testing      | [终端聊天视图恢复](终端聊天视图恢复/requirements/终端聊天视图恢复.md)                   | -                                                                                                                                                                                                                                                                                                                                                                | [切换与绑定](终端聊天视图恢复/tests/cases/切换与绑定.md)                                                                                                                                                                                                                                                                     | 2026-10-23 |
 | [集成分支自动出包](集成分支自动出包/journal.md)               | 同源发布 fork 内测包，并提供桌面更新清单和 Android 应用内更新                               | testing      | [集成分支自动出包](集成分支自动出包/requirements/集成分支自动出包.md)                   | [2026-10-21-orcad上游同步](集成分支自动出包/solutions/2026-10-21-orcad上游同步.md)、[Linux服务自动更新方案](集成分支自动出包/solutions/Linux服务自动更新方案.md)、[macOS自动更新签名修复方案](集成分支自动出包/solutions/macOS自动更新签名修复方案.md)、[发布页分层与可读发布说明方案](集成分支自动出包/solutions/发布页分层与可读发布说明方案.md)               | [Linux服务自动更新](集成分支自动出包/tests/cases/Linux服务自动更新.md)、[自动出包](集成分支自动出包/tests/cases/自动出包.md)                                                                                                                                                                                                 | 2026-10-23 |
 | [文档预览大小](文档预览大小/journal.md)                       | 扩大文档文本预览上限，不扩大普通文件读取和 paired RPC 预算                                  | testing      | [文档预览大小](文档预览大小/requirements/文档预览大小.md)                               | -                                                                                                                                                                                                                                                                                                                                                                | [预览大小边界](文档预览大小/tests/cases/预览大小边界.md)                                                                                                                                                                                                                                                                     | 2026-10-21 |
 | [Goal 目标模式](Goal目标模式/journal.md)                      | 持久目标、既有会话续跑、独立验收与目标管理 UI                                               | testing      | [Goal目标模式](Goal目标模式/requirements/Goal目标模式.md)                               | [Goal守卫监工与唤醒兜底修订方案](Goal目标模式/solutions/Goal守卫监工与唤醒兜底修订方案.md)、[Goal守卫监工与唤醒兜底修订方案.review](Goal目标模式/solutions/Goal守卫监工与唤醒兜底修订方案.review.md)、[Goal目标模式技术说明](Goal目标模式/solutions/Goal目标模式技术说明.md)、[Goal目标管理与交互闭环方案](Goal目标模式/solutions/Goal目标管理与交互闭环方案.md) | [Goal功能测试](Goal目标模式/tests/cases/Goal功能测试.md)                                                                                                                                                                                                                                                                     | 2026-10-21 |

diff --git a/docs/issue/终端聊天视图恢复/journal.md b/docs/issue/终端聊天视图恢复/journal.md
@@ -0,0 +1,46 @@
+---
+title: 终端聊天视图恢复
+document_type: journal
+status: testing
+created: 2026-10-23
+updated: 2026-10-23
+issue: 终端聊天视图恢复
+external_ids: []
+---
+
+# 终端聊天视图恢复
+
+## 1. 关键文档链接
+
+| 类型     | 文档                                                    | 状态         | 说明                                             |
+| -------- | ------------------------------------------------------- | ------------ | ------------------------------------------------ |
+| 需求     | [终端聊天视图恢复](requirements/终端聊天视图恢复.md)    | ready        | REQ-1801～1803                                   |
+| 交互     | -                                                       | not-required | 恢复已有菜单与快捷键                             |
+| 方案     | -                                                       | not-required | 接入现有 toggleViewMode；不新增会话控制链路      |
+| 测试用例 | [切换与绑定](tests/cases/切换与绑定.md)                 | ready        | 双向入口、本地、SSH、历史只读                    |
+| 测试执行 | [本机与SSH验收](tests/runs/2026-10-23-本机与SSH验收.md) | completed    | 双向菜单、进程及 transcript 保留；正式发布待完成 |
+
+## 2. 决策点记录
+
+- 2026-10-23：根因是标签右键菜单用 isChatView 隐藏了终端到聊天的方向；终端面板右键和快捷键已支持。恢复同一标签的现有切换，不把它替换为创建新会话或恢复 provider。
+- 界面展示由客户端持有，终端和 transcript 继续由本地或 SSH 执行主机持有；不新增协议、主机连接或配置。
+
+## 3. 开发记录
+
+### 2026-10-23 登记与实施（implementing）
+
+- 本轮目标：恢复标签入口，并校验指定历史会话绑定。
+- 完成内容：核对现有两个菜单及切换回调；建立独立功能分支和需求登记。
+- 代码或文档变更：登记、需求和验收用例；实现放在功能拥有目录。
+- 验证证据：源码核对；真实界面和自动化验证待执行。
+- 未解决问题：历史标签的实际元数据仍需核对；尚未出包安装。
+- 下一步：实现入口、完成本地与 SSH 验收及所有门禁，合入正式发包。
+
+### 2026-10-23 双向菜单和历史绑定验收（testing）
+
+- 本轮目标：完成入口回归与真实本机、SSH 验证。
+- 完成内容：功能拥有目录中的菜单项调用已有回调，支持双向标签切换并复用跨平台快捷键与现有翻译。历史标签通过已有 hook 入口重放 transcript 已记录的完成事件，补齐 provider 元数据；未向 provider 发送消息或恢复进程。
+- 代码或文档变更：SortableTabContextMenu 接线、既有菜单回归测试、需求及登记。
+- 验证证据：26 项相关测试、四目标 pnpm tc、三项本地化、架构、fork 功能和文档、变更代码质量通过。本机与 SSH 使用正常 AppImage 的后台隔离实例，双向菜单及历史正文可见；原 handle、incarnation、shell PID 保持，测试 transcript SHA256 保持。用户历史 transcript 的大小、mtime 和 SHA256 前后一致，已有 Codex PID 4013571 保留。证据见本轮 Test Run 与 .docs/native-chat-view-ui-validation/2026-10-23/。
+- 未解决问题：代码尚未随正式包交付；网页端旧的独立 folderWorkspace 目录入口在隔离实例未显示，本轮菜单验收采用已有 folder 项目，未将该目录问题计作通过。
+- 下一步：提交、合入 fork/integration，正式安装后复核原标签菜单和更新状态。
diff --git a/docs/issue/终端聊天视图恢复/requirements/终端聊天视图恢复.md b/docs/issue/终端聊天视图恢复/requirements/终端聊天视图恢复.md
@@ -0,0 +1,30 @@
+---
+title: 终端聊天视图恢复
+document_type: requirement
+status: ready
+created: 2026-10-23
+updated: 2026-10-23
+issue: 终端聊天视图恢复
+---
+
+# 终端聊天视图恢复
+
+用户要求修好 Fartown 安装包中无法发现或使用 Chat View 的问题，并完成合入与安装验证。
+
+### REQ-1801 已有终端可双向切换视图
+
+优先级：P0。当前状态：实现中。
+
+支持原生聊天视图的终端标签，右键菜单提供 Continue in Chat UI；聊天视图提供 Continue with Terminal Agent。两者调用已有同标签切换入口，保留终端 ID、进程和 provider session。普通 shell、不支持的 agent、缺少切换回调的标签不显示此项。切换不创建标签、不启动或恢复 provider 会话、不发送用户消息。
+
+### REQ-1802 本地和 SSH 行为一致
+
+优先级：P0。当前状态：实现中。
+
+本地文件夹和 Git 工作树、SSH 执行主机均沿用已有能力判断、会话路由和 transcript 读取。执行主机拥有 transcript 与终端进程，客户端仅切换展示；不增加 RPC、端口、设置、文件副本或重试。旧主机维持其已有能力判断。快捷键标签复用跨平台绑定，移动端的原生聊天入口保持已有行为。
+
+### REQ-1803 历史会话可读且只读校验
+
+优先级：P0。当前状态：实现中。
+
+对用户指定旧标签核对 Orca 的 provider session 元数据；如缺失，只用已核实的会话标识及已有绑定入口修复元数据。读取并显示已有 transcript，前后校验文件未改动；不 resume 旧 provider、不发送消息、不关闭原终端。此项是既有配置的修复验收，优先复用现有接口。
diff --git a/docs/issue/终端聊天视图恢复/tests/cases/切换与绑定.md b/docs/issue/终端聊天视图恢复/tests/cases/切换与绑定.md
@@ -0,0 +1,15 @@
+---
+title: 切换与绑定
+document_type: test-case
+status: ready
+created: 2026-10-23
+updated: 2026-10-23
+issue: 终端聊天视图恢复
+---
+
+# 切换与绑定
+
+- TC-1801（REQ-1801）：支持的终端右键显示聊天入口，点击仅调用同标签切换一次；聊天视图可返回终端，原 handle 和 PID 保持。
+- TC-1802（REQ-1801）：普通 shell、无能力或缺少回调时不显示切换；原有历史会话操作菜单仍在正确分组。
+- TC-1803（REQ-1802）：本地和真实 SSH 执行端分别运行隔离 App；已有 transcript 在两种展示间切换，终端进程保留。不新增或替换 provider 会话。
+- TC-1804（REQ-1803）：核对用户旧标签的 provider session ID、执行主机 transcript 路径和可读内容；前后文件大小、mtime、SHA256 一致，无 resume 或发送操作。
diff --git a/docs/issue/终端聊天视图恢复/tests/runs/2026-10-23-本机与SSH验收.md b/docs/issue/终端聊天视图恢复/tests/runs/2026-10-23-本机与SSH验收.md
@@ -0,0 +1,27 @@
+---
+title: 本机与SSH验收
+document_type: test-run
+status: completed
+created: 2026-10-23
+updated: 2026-10-23
+issue: 终端聊天视图恢复
+---
+
+# REQ-1801～1803 / TC-1801～1804 验收
+
+开发包 preview.9010 由正常 integration electron-builder 配置构建，用于隔离验证，未安装到用户服务。
+
+| 项目                             | 结果                                                                                                                            |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| 菜单、能力门禁与同标签所有权回归 | 3 文件 26 项通过                                                                                                                |
+| 类型检查                         | pnpm tc 四目标通过                                                                                                              |
+| 静态门禁                         | fork 功能与文档、18 组架构策略、三项本地化和本分支 3 个代码文件全部增量质量扫描通过                                             |
+| 本机 AppImage                    | 同一终端标签右键进入 Chat UI，显示既有测试 transcript，右键返回终端                                                             |
+| SSH AppImage                     | root sshd 的 Ubuntu 20.04 隔离容器，客户端 HTTP/WebSocket 均经 SSH 转发，远端文件及服务独立；完成相同双向切换                   |
+| 进程与会话保留                   | 本机 PID 1047024、SSH PID 5344 均 live，handle 和 incarnation 一致；测试 transcript SHA256 一致                                 |
+| 用户历史会话                     | provider 01a15c57-f3c1-7b90-81e1-e5bfafd150d8；已有 Codex PID 4013571；只更新 Orca hook 元数据，实际网页 Chat View 显示已有对话 |
+| 用户历史文件只读                 | 大小 1023425013，mtimeNs 1792724055678743227，SHA256 a175c62c1ed8d548717533777d9afa54022da0a80c93ea2582c2a3a1584f46d4，前后一致 |
+
+证据目录 `.docs/native-chat-view-ui-validation/2026-10-23/`：scripts 为可复查脚本，evidence 中包含 local/ssh-result.json、双向入口与正文截图、历史绑定摘要及截图。测试模拟已有 Codex transcript 和已完成 hook，不启动真实 provider。测试夹具曾使用错误的 content 类型，按现有 decoder 契约修正后验收通过，未更改产品解析器。
+
+范围限制：真实 UI 使用 folder 项目，不把网页独立 folderWorkspace 目录未显示的问题算作通过。菜单能力路由复用既有本地/SSH 所有权；未修改远端协议。macOS/Windows 快捷键标签复用既有跨平台模块，本轮没有对应平台真机证据。正式发布、覆盖安装与生产菜单验收仍待执行。