feat(app-iced): M104 AGENTRAIL —— 右栗三档 + 布局数学 + 独立页复用同一会话视图

用户定案(D16):右侧常驻可折叠、允许拆分成独立页、中栗宽度可调(磁铁吸附)。
本 mission 只做壳:三档状态 + 布局数学 + 一份会话视图;真数据仍归 M103,一行 presenter 都不调。

- 右栗三档:Collapsed(48) / Expanded(280~360,默认 320,锚=令牌 ai_panel_width) / Detached(Route::Agent);
  会话、草稿、未读在切档时一条不丢(拆出去再收回,话说了一半还在)
- 布局数学:中栗 = 窗口 − 右栗 − 拖拽缝(8),下限 472(= 行宽上限 424 + 两侧页边距);
  右栗一展开,页面按更窄的宽度重新排版(收缩而不是溢出);拖拽磁铁吸附到 280/320/360,超上限夹紧
- 独立页与右栗共用 conversation::view 这一份实现(输入=纯数据,输出=agent::Message)
- 控件:多行输入框(Enter 发送 / Shift+Enter 换行,走 text_editor::key_binding 的 modifiers 分流)、
  发送禁用态、流式中断、未读点 + 可读计数、⌄ 收起 / ⇥ 拆出 / ⇤ 收回;Esc 收栗、Tab 焦点环、Enter 激活
- 文案全部进 crates/i18n 的新域 catalog/agent.rs(+ golden 追加 20 行),零硬编码中文
- 取证:ULL_AGENT_RAIL / ULL_AGENT_FIXTURE / ULL_AGENT_WIDTH(截图走产品 bin,标题栏与三键可见)
- 消息不走 pages::Message(外壳级视图),走 app::Message::Agent(..) → app/update/agent.rs
- 删掉 M68 骨架回落(shell::view + shell/fallback.rs):Route::Agent 现在有真页面

门禁:fmt 0 / clippy(workspace,-D warnings) 0 / pages_demo 0 / app-iced lib 418 条全绿
This commit is contained in:
AskaEth committed 2026-11-04 00:21:32 +08:00
1 parent 875ac159ee
commit c3f20784a8
20 files changed
+2463 -153

No files matched your search

+154
View File
@@ -0,0 +1,154 @@
//! 助手栏消息的落点(M104):三档状态迁移 / 输入 / 拖拽 / 键盘。
//!
//! ## 为什么单独一个文件
//!
//! `app/update.rs` 已经贴着 400 行硬上限(M94 也因此把下载页四支拆到 `update/download.rs`)。
//! 助手栏有 11 个变体,塞回主文件必破线。任务也只允许主文件加一行 `mod agent;`。
//!
//! ## 分工:视图态 vs 业务命令
//!
//! | 消息 | 落到哪 |
//! |---|---|
//! | `Expand` / `Collapse` / `Dock` / `Escape` | **只改视图态**(`AgentUi`)+ 路由栈(离开/进入 `Route::Agent`) |
//! | `Detach` | 视图态 + `Route::Agent`(压栈,`back()` 能回去) |
//! | `Edit` / `Submit` / `Stop` | 改视图态:草稿、追加一条占位提示 |
//! | `DragStart` / `DragTo` / `DragEnd` | 视图态:吸附宽度 |
//! | `Key` / `Tab` / `Activate` | 键盘路径 |
//!
//! **没有任何 `AppCommand` 派发**:本 mission 不接 AI 后端(M103 的四个签名一行都不调)。
//! `Submit` 不假装有回复——它只把草稿记进会话 + 追加一条「占位外壳、没发给模型」的提示,
//! `Stop` 同理。真接线时这两个分支各加一次 `dispatch`,视图不用动。
use iced::keyboard::{key, Key};
use iced::Task;
use unlucky_i18n::{Catalog, Lang};
use crate::shell::agent::{self, Focus, RailState};
use super::*;
impl App {
/// 助手栏消息(`app::Message::Agent(..)` 的唯一落点)。
pub(super) fn on_agent(&mut self, message: agent::Message) -> Task<Message> {
let catalog = Catalog::of(Lang::En);
match message {
agent::Message::Expand => self.agent.expand(),
agent::Message::Collapse | agent::Message::Escape => self.collapse_agent(),
agent::Message::Detach => {
self.agent.detach();
self.state.navigate(Route::Agent);
}
agent::Message::Dock => {
self.agent.dock();
self.leave_agent_page();
}
agent::Message::DragStart => self.agent.drag_start(),
agent::Message::DragTo(x) => self.agent.drag_to(self.width, x),
agent::Message::DragEnd => self.agent.drag_end(),
agent::Message::Edit(action) => self.agent.edit(action),
agent::Message::Submit => {
if self.agent.submit(catalog) {
eprintln!("[agent] submit → 占位(没有接后端)");
}
}
agent::Message::Stop => self.agent.stop(catalog),
agent::Message::Tab { shift } => self.agent.step_focus(shift),
agent::Message::Activate => self.activate_focused(catalog),
agent::Message::Key(event) => return self.on_agent_key(event),
}
// 右栗的宽度/档位都会改「页面能用多宽」,所以视图模型必须重建(不是只重绘)。
self.view_dirty = true;
self.refresh_view();
Task::none()
}
/// 键盘订阅来的按键(`app/subscription.rs` 把整条键盘事件搬过来,解释权在这一层)。
///
/// 为什么不让订阅层直接翻成三个枚举:那样 `Escape`/`Tab`/`Enter` 的语义(什么状态下该做什么)
/// 会散在订阅表里;这里一眼能看完。
fn on_agent_key(&mut self, event: iced::keyboard::Event) -> Task<Message> {
let iced::keyboard::Event::KeyPressed { key, modifiers, .. } = event else {
return Task::none();
};
let message = match key {
Key::Named(key::Named::Escape) => agent::Message::Escape,
// 折叠档没有会话动作可巡航,`Tab` 不该被助手栏吃掉
Key::Named(key::Named::Tab) if self.agent.rail == RailState::Collapsed => {
return Task::none();
}
Key::Named(key::Named::Tab) => agent::Message::Tab {
shift: modifiers.shift(),
},
// `Activate` 只在软焦点落在**按钮**上时才动手(输入框的 Enter 由
// `text_editor::key_binding` 分流成「发送」,不能在这里重复发一次)。
Key::Named(key::Named::Enter) => agent::Message::Activate,
_ => return Task::none(),
};
self.on_agent(message)
}
/// `Esc` / `⌄`:展开 → 收起;独立页 → 收回右栗并离开 `Route::Agent`。
fn collapse_agent(&mut self) {
let was_detached = self.agent.rail == RailState::Detached;
self.agent.collapse();
if was_detached {
self.leave_agent_page();
}
}
/// 离开 AI 独立页:能回退就回退(`Detach` 是压栈的),否则回实例页。
fn leave_agent_page(&mut self) {
if self.state.route() != &Route::Agent {
return;
}
if !self.state.back() {
self.state.navigate(Route::Instances);
}
}
/// 键盘 `Enter`:激活软焦点上的按钮(`Tab` 环的顺序见 [`Focus`])。
///
/// 焦点在 [`Focus::Composer`] 上时**什么都不做**:那一条路径由输入框自己的 `key_binding`
/// 负责(按 `Tab` 走到输入框并不等于真的把 iced 焦点交过去,两次发送会打架)。
fn activate_focused(&mut self, catalog: Catalog) {
// 鼠标刚点过输入框(或从没按过 `Tab`)⇒ 这个 Enter 不归助手栏管
if !self.agent.keyboard_mode {
return;
}
let intent = match (self.agent.rail, self.agent.focus) {
(RailState::Collapsed, Focus::Collapse) => Some(agent::Message::Expand),
(RailState::Expanded, Focus::Collapse) => Some(agent::Message::Collapse),
(RailState::Expanded, Focus::Detach) | (RailState::Detached, Focus::Detach) => {
Some(if self.agent.rail == RailState::Detached {
agent::Message::Dock
} else {
agent::Message::Detach
})
}
(_, Focus::Send) => Some(agent::Message::Submit),
(_, Focus::Stop) => Some(agent::Message::Stop),
// 折叠档没有「拆出」、独立页没有「收起」:焦点环按 `Focus::order` 不会落到这两格,
// 显式列成 None 只是为了让编译器确认这份 intent 表是穷尽的。
(RailState::Collapsed, Focus::Detach)
| (RailState::Detached, Focus::Collapse)
| (_, Focus::Composer) => None,
};
if let Some(message) = intent {
let _ = self.on_agent(message);
} else {
// 「不得静默无反应」:焦点在输入框上按 Enter 由输入框自己处理,这里只留一行日志。
eprintln!(
"[agent] Enter on focus={} handled by the composer",
self.agent.focus.name()
);
let _ = catalog;
}
}
}