@spzxg/cli-ui 0.6.6 → 0.6.7

package/src/styles.css

@@ -52,7 +52,7 @@
 .cli-ui .sess-head .sh-tools{min-width:0;max-width:100%;flex-wrap:wrap;justify-content:flex-end;margin-left:auto;}
 .cli-ui .sess-head .crumb{overflow-wrap:anywhere;}
 .cli-ui .cli-export{white-space:nowrap;}
-.cli-ui .comp-area textarea{min-width:0;min-height:48px;}
+.cli-ui .comp-area textarea{min-width:0;}
 .cli-ui .comp-foot{gap:8px;padding:8px 10px;background:transparent;border-top:0;flex-wrap:wrap;}
 .cli-ui .cli-attach{display:inline-flex;align-items:center;gap:5px;min-height:32px;padding:0 8px;border-radius:7px;color:var(--ink-3);font-size:12px;}
 .cli-ui .cli-attach:hover{background:var(--surface-2);color:var(--ink);}
@@ -87,7 +87,7 @@
 .cli-ui.cli-file-preview,
 .cli-ui.cli-browser-view{display:flex;flex-direction:column;min-height:0;min-width:0;height:100%;overflow:hidden;background:var(--panel);}
 .cli-ui.cli-browser-view .rail-pad{flex:1;}
-.cli-ui.cli-board{display:flex;flex-direction:column;min-height:0;min-width:0;height:100%;overflow:hidden;border-left:1px solid var(--line);}
+.cli-ui.cli-board{display:flex;flex-direction:column;min-height:0;min-width:0;height:100%;overflow:hidden;border-left:1px solid var(--line-2);}
 .cli-ui.cli-board .rail-scroll{overflow:hidden;}
 .cli-ui.cli-board.collapsed{background:var(--bg-2);}
 .cli-ui .cli-board-strip{display:flex;flex-direction:column;align-items:center;gap:12px;width:100%;height:100%;padding:14px 0;color:var(--ink-3);}
@@ -102,8 +102,14 @@
 .cli-ui .cli-tc-open:hover{background:var(--accent-soft);}
 
 .cli-ui .cli-files{display:flex;flex-direction:column;min-height:0;flex:1;}
-.cli-ui .cli-crumbs{display:flex;align-items:center;flex-wrap:wrap;gap:2px;padding:10px 12px;border-bottom:1px solid var(--line-2);font-size:12.5px;}
-.cli-ui .cli-crumb{display:inline-flex;align-items:center;gap:5px;padding:3px 6px;border-radius:6px;color:var(--ink-3);}
+.cli-ui .cli-source-workspace{display:flex;align-items:center;flex-wrap:wrap;gap:6px 10px;}
+.cli-ui .cli-source-workspace .btn{margin-left:auto;min-height:32px;}
+.cli-ui .cli-crumbs{display:flex;align-items:center;gap:8px;min-height:48px;padding:7px 12px;border-bottom:1px solid var(--line-2);font-size:13px;}
+.cli-ui .cli-crumb-path{display:flex;align-items:center;flex:1;min-width:0;gap:2px;overflow-x:auto;scrollbar-width:none;}
+.cli-ui .cli-crumb-path::-webkit-scrollbar{display:none;}
+.cli-ui .cli-crumb-w{display:inline-flex;align-items:center;flex:none;gap:2px;}
+.cli-ui .cli-crumb{display:inline-flex;align-items:center;flex:none;gap:5px;min-height:32px;padding:4px 6px;border-radius:6px;color:var(--ink-3);}
+.cli-ui .cli-crumb-name{display:block;min-width:0;max-width:180px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
 .cli-ui .cli-crumb svg{width:13px;height:13px;}
 .cli-ui .cli-crumb.on{color:var(--ink);font-weight:600;}
 .cli-ui .cli-crumb:hover{background:var(--row-sel);}
@@ -111,29 +117,34 @@
 .cli-ui .cli-files-sync{font-family:var(--mono);font-size:10.5px;color:var(--ink-4);}
 .cli-ui .cli-files-list{flex:1;min-height:0;overflow-y:auto;padding:4px 0;}
 .cli-ui .cli-frow{display:flex;align-items:center;width:100%;}
-.cli-ui .cli-frow:hover{background:var(--row-sel);}
+.cli-ui .cli-frow+.cli-frow{border-top:1px solid var(--line-2);}
+.cli-ui .cli-frow:hover,.cli-ui .cli-frow:focus-within{background:var(--row-sel);}
 .cli-ui .cli-frow.fresh .cli-frow-name{color:var(--accent-ink);}
-.cli-ui button.cli-frow,.cli-ui .cli-frow-main{display:flex;align-items:center;gap:8px;flex:1;min-width:0;padding:7px 12px;font-size:13px;text-align:left;color:var(--ink);}
-.cli-ui .cli-frow-ic{display:inline-flex;color:var(--ink-3);}
+.cli-ui button.cli-frow,.cli-ui .cli-frow-main{display:flex;align-items:center;gap:10px;flex:1;min-width:0;min-height:44px;padding:5px 12px;font-size:13.5px;line-height:1.4;text-align:left;color:var(--ink);}
+.cli-ui .cli-files>button.cli-frow{flex:none;}
+.cli-ui .cli-frow-ic{display:inline-flex;flex:none;color:var(--ink-3);}
 .cli-ui .cli-frow.dir .cli-frow-ic{color:var(--accent);}
-.cli-ui .cli-frow-ic svg{width:14px;height:14px;}
+.cli-ui .cli-frow-ic svg{width:16px;height:16px;}
+.cli-ui .cli-frow-body{display:flex;flex-direction:column;flex:1;min-width:0;gap:1px;}
+.cli-ui .cli-frow-title{display:flex;align-items:center;min-width:0;gap:8px;}
 .cli-ui .cli-frow-name{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
 .cli-ui .cli-frow-new{font-size:10.5px;color:var(--accent);background:var(--accent-soft);padding:1px 6px;border-radius:9px;}
-.cli-ui .cli-frow-meta{font-family:var(--mono);font-size:10.5px;color:var(--ink-4);white-space:nowrap;}
-.cli-ui .cli-frow-dl{display:inline-grid;place-items:center;width:28px;height:28px;margin-right:6px;border-radius:6px;color:var(--ink-3);opacity:0;}
-.cli-ui .cli-frow:hover .cli-frow-dl,.cli-ui .cli-frow-dl:focus-visible{opacity:1;}
+.cli-ui .cli-frow-meta{font-family:var(--mono);font-size:10.5px;line-height:1.3;color:var(--ink-4);white-space:nowrap;}
+.cli-ui .cli-frow-dl{display:inline-grid;place-items:center;flex:none;width:36px;height:36px;margin-right:6px;border-radius:7px;color:var(--ink-3);opacity:0;}
+.cli-ui .cli-frow:hover .cli-frow-dl,.cli-ui .cli-frow:focus-within .cli-frow-dl{opacity:1;}
+.cli-ui .cli-frow-dl:disabled{opacity:.4;}
 .cli-ui .cli-frow-dl:hover{background:var(--surface-2);color:var(--ink);}
 .cli-ui .cli-frow-dl svg{width:14px;height:14px;}
 @media (hover:none){.cli-ui .cli-frow-dl{opacity:1;}}
 
 .cli-ui .cli-fv{display:flex;flex-direction:column;min-height:0;flex:1;background:var(--panel);}
-.cli-ui .cli-fv-h{display:flex;align-items:center;gap:6px;padding:8px 10px;border-bottom:1px solid var(--line-2);font-size:12.5px;min-width:0;}
-.cli-ui .cli-fv-ic{display:inline-flex;color:var(--ink-3);}
+.cli-ui .cli-fv-h{display:flex;align-items:center;gap:8px;min-height:50px;padding:8px 12px;border-bottom:1px solid var(--line-2);font-size:13px;min-width:0;}
+.cli-ui .cli-fv-ic{display:inline-flex;flex:none;color:var(--ink-3);}
 .cli-ui .cli-fv-ic svg{width:14px;height:14px;}
-.cli-ui .cli-fv-name{font-weight:600;color:var(--ink);min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
+.cli-ui .cli-fv-name{flex:0 1 auto;font-weight:600;color:var(--ink);min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
 .cli-ui .cli-fv-meta{font-family:var(--mono);font-size:10.5px;color:var(--ink-4);white-space:nowrap;}
 .cli-ui .cli-fv-sp{flex:1;}
-.cli-ui .cli-fv-back{font-size:18px;line-height:1;width:26px;height:26px;border-radius:6px;color:var(--ink-3);}
+.cli-ui .cli-fv-back{flex:none;font-size:18px;line-height:1;width:32px;height:32px;border-radius:7px;color:var(--ink-3);}
 .cli-ui .cli-fv-back:hover{background:var(--row-sel);color:var(--ink);}
 .cli-ui .cli-fv-btn{font-size:12px;color:var(--accent);padding:3px 8px;border-radius:6px;white-space:nowrap;}
 .cli-ui .cli-fv-btn:hover{background:var(--accent-soft);}
@@ -141,12 +152,24 @@
 .cli-ui .cli-fv-icon:hover:not(:disabled){background:var(--surface-2);color:var(--ink);}
 .cli-ui .cli-fv-icon:disabled{opacity:.4;}
 .cli-ui .cli-fv-icon svg{width:14px;height:14px;}
+.cli-ui .cli-fv-actions{position:relative;display:flex;align-items:center;flex:none;}
+.cli-ui .cli-fv-more{width:32px;height:32px;}
+.cli-ui .cli-fv-menu{z-index:1010;width:248px;padding:6px;border-radius:12px;}
+.cli-ui .cli-fv-menu-head{padding:7px 10px 10px;margin-bottom:4px;border-bottom:1px solid var(--line-2);}
+.cli-ui .cli-fv-menu-head strong{display:block;margin-bottom:4px;font-size:12px;font-weight:600;color:var(--ink);}
+.cli-ui .cli-fv-menu-head span{display:block;max-height:4.5em;overflow:auto;overflow-wrap:anywhere;font-size:11px;line-height:1.5;color:var(--ink-4);user-select:text;}
+.cli-ui .cli-fv-menu .pop-item{width:100%;min-height:40px;padding:9px 10px;gap:9px;border-radius:7px;text-align:left;font-size:13px;line-height:1.4;font-weight:500;}
+.cli-ui .cli-fv-menu .pop-item svg{flex:none;width:16px;height:16px;color:var(--ink-3);}
+.cli-ui .cli-fv-menu-custom{margin-bottom:4px;padding-bottom:4px;border-bottom:1px solid var(--line-2);}
+.cli-ui .cli-fv-menu-custom .pop-item{font-weight:600;color:var(--accent-ink);}
+.cli-ui .cli-fv-status{font-size:11px;color:var(--ink-3);white-space:nowrap;}
 .cli-ui .cli-fv-b{flex:1;min-height:0;overflow:auto;}
 .cli-ui .cli-fv-b.k-pdf,.cli-ui .cli-fv-b.k-html,.cli-ui .cli-fv-b.k-docx{overflow:hidden;display:flex;}
-.cli-ui .cli-fv-frame{flex:1;width:100%;height:100%;min-height:360px;border:0;background:#fff;}
-.cli-ui .cli-fv-md{padding:16px 18px;}
+.cli-ui .cli-fv-frame{display:block;flex:1;width:100%;height:100%;min-height:0;border:0;background:#fff;}
+.cli-ui .cli-fv-md{padding:20px 22px;}
+.cli-ui .cli-fv-md .md{font-size:14px;line-height:1.8;}
 .cli-ui .cli-fv-code .md pre{margin:0;border:0;border-radius:0;min-height:100%;}
-.cli-ui .cli-fv-pre{margin:0;padding:12px 14px;font-family:var(--mono);font-size:12px;line-height:1.55;color:var(--ink);white-space:pre-wrap;word-break:break-word;}
+.cli-ui .cli-fv-pre{margin:0;padding:12px 14px;font-family:var(--mono);font-size:12px;line-height:1.65;color:var(--ink);white-space:pre-wrap;word-break:break-word;}
 .cli-ui .cli-fv-img{display:grid;place-items:center;padding:16px;min-height:100%;background:repeating-conic-gradient(var(--surface-2) 0 25%,transparent 0 50%) 0 0/16px 16px;}
 .cli-ui .cli-fv-img img{max-width:100%;height:auto;box-shadow:var(--sh-1);}
 .cli-ui .cli-fv-csv{overflow:auto;}
@@ -185,19 +208,20 @@
 .cli-ui .bp-dialog-hint{font-size:12px;color:var(--amber);}
 .cli-ui .bp-dialog-a{display:flex;justify-content:flex-end;gap:8px;}
 
-/* ── 窄容器（手机、很窄的侧栏）：预览工具栏换行，次要信息收起 ── */
+/* ── 窄容器（手机、很窄的侧栏）：次要信息收起，操作入口固定 ── */
 .cli-ui .cli-fv{container-type:inline-size;}
 .cli-ui .cli-fv{position:relative;}
-.cli-ui .cli-fv-selq{position:absolute;z-index:5;transform:translate(-50%,calc(-100% - 6px));display:inline-flex;align-items:center;gap:4px;padding:4px 10px;border-radius:999px;font-size:12px;white-space:nowrap;color:#fff;background:var(--ink);box-shadow:var(--sh-2, 0 4px 14px rgba(0,0,0,.18));}
-.cli-ui .cli-fv-selq svg{width:12px;height:12px;}
-.cli-ui .cli-fv-h{flex-wrap:wrap;row-gap:4px;}
+.cli-ui .cli-fv-selq{position:absolute;z-index:5;transform:translate(-50%,calc(-100% - 6px));display:inline-flex;align-items:center;gap:6px;min-height:34px;max-width:calc(100% - 16px);padding:7px 11px;border:1px solid var(--line-strong);border-radius:9px;font-size:12.5px;line-height:1.3;white-space:nowrap;color:var(--ink);background:var(--raise);box-shadow:var(--sh-2, 0 4px 14px rgba(0,0,0,.18));}
+.cli-ui .cli-fv-selq svg{width:14px;height:14px;color:var(--accent);}
+.cli-ui .cli-fv-h{flex-wrap:nowrap;}
+@container (max-width:440px){.cli-ui .cli-fv-md{padding:16px 14px;}}
 @container (max-width:380px){
   .cli-ui .cli-fv-meta{display:none;}
+  .cli-ui .cli-fv-status{position:absolute;top:48px;right:10px;padding:4px 8px;border-radius:6px;background:var(--raise);z-index:1;}
   .cli-ui .cli-fv-btn{padding:3px 6px;}
 }
 .cli-ui.cli-board{container-type:inline-size;}
 @container (max-width:340px){
-  .cli-ui .cli-frow-meta{display:none;}
   .cli-ui .rail-tab{padding:12px 9px 10px;}
 }
 .cli-ui .scrim{z-index:var(--cli-popup-z,200);}
@@ -265,7 +289,7 @@ cli-split{display:block;}
 .cli-ui .cli-fv-zoom{font-size:14px;line-height:1;}
 /* 图片缩放 */
 .cli-ui .cli-fv-imgwrap{display:flex;flex-direction:column;min-height:100%;}
-.cli-ui .cli-fv-imgbar{display:flex;align-items:center;gap:4px;padding:6px 10px;border-bottom:1px solid var(--line);background:var(--surface);position:sticky;top:0;z-index:1;}
+.cli-ui .cli-fv-imgbar{display:flex;align-items:center;gap:4px;padding:6px 10px;border-bottom:1px solid var(--line-2);background:var(--surface);position:sticky;top:0;z-index:1;}
 .cli-ui .cli-fv-imgpct{font-family:var(--mono);font-size:11px;color:var(--ink-3);min-width:44px;text-align:center;}
 .cli-ui .cli-fv-imgwrap .cli-fv-img{flex:1;}
 .cli-ui .cli-fv-img.zoomed{display:block;overflow:auto;}
@@ -290,7 +314,8 @@ cli-split{display:block;}
 .cli-ui .rail-tabs-scroll::-webkit-scrollbar{display:none;}
 .cli-ui .rail-tabs-scroll .rail-tab{flex:none;}
 .cli-ui .rail-ftab{display:inline-flex;align-items:center;gap:2px;max-width:180px;padding-right:4px;letter-spacing:0;font-family:inherit;font-size:12px;}
-.cli-ui .rail-ftab-l{display:inline-flex;align-items:center;gap:4px;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:inherit;background:none;border:0;padding:0;cursor:pointer;font:inherit;}
+.cli-ui .rail-ftab-l{display:inline-flex;align-items:center;flex:1;gap:4px;min-width:0;overflow:hidden;white-space:nowrap;color:inherit;background:none;border:0;padding:0;cursor:pointer;font:inherit;}
+.cli-ui .rail-ftab-text{display:block;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
 .cli-ui .rail-ftab-l svg{width:12px;height:12px;flex:none;}
 .cli-ui .rail-ftab-x{display:inline-grid;place-items:center;flex:none;width:16px;height:16px;border-radius:4px;border:0;background:none;color:var(--ink-4);cursor:pointer;opacity:.6;}
 .cli-ui .rail-ftab:hover .rail-ftab-x,.cli-ui .rail-ftab.on .rail-ftab-x{opacity:1;}
@@ -305,26 +330,163 @@ cli-split{display:block;}
 .cli-ui .cli-refs.cli-ctxs+.cli-refs{padding-top:4px;}
 .cli-ui .cli-ref.ctx{padding-right:9px;background:var(--surface-2);border-color:var(--line-2);}
 
+/* Explicit references stay next to the draft, with an inspectable source and a quiet excerpt. */
+.cli-ui .cli-reference{min-width:0;max-width:100%;border:1px solid var(--line-2);border-left:2px solid var(--line);border-radius:10px;background:var(--surface-2);color:var(--ink-2);overflow:hidden;}
+.cli-ui .cli-reference-head{display:flex;align-items:center;gap:2px;padding:2px 4px 0 2px;}
+.cli-ui .cli-reference-toggle{display:flex;align-items:center;gap:7px;min-width:0;min-height:34px;flex:1;text-align:left;padding:6px 8px;border-radius:6px;font-size:12px;color:var(--ink-2);background:transparent;}
+.cli-ui .cli-reference-toggle:hover{background:var(--row-sel);}
+.cli-ui .cli-reference-icon{display:inline-flex;flex:none;color:var(--ink-3);}
+.cli-ui .cli-reference-icon svg{width:14px;height:14px;}
+.cli-ui .cli-reference-kind{flex:none;color:var(--ink-3);font-size:11px;}
+.cli-ui .cli-reference-title{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-weight:500;}
+.cli-ui .cli-reference-state{margin-left:auto;color:var(--ink-3);font-size:11px;flex:none;}
+.cli-ui .cli-reference-chevron{display:flex;flex:none;color:var(--ink-3);}
+.cli-ui .cli-reference-chevron svg{width:13px;height:13px;}
+.cli-ui .cli-reference-remove{display:grid;place-items:center;width:32px;height:32px;flex:none;border-radius:6px;color:var(--ink-3);background:transparent;}
+.cli-ui .cli-reference-remove svg{width:14px;height:14px;}
+.cli-ui .cli-reference-remove:hover:not(:disabled){color:var(--ink);background:var(--row-sel);}
+.cli-ui .cli-reference-remove:disabled{opacity:.45;cursor:default;}
+.cli-ui .cli-reference-toggle:focus-visible,.cli-ui .cli-reference-remove:focus-visible{outline:2px solid var(--accent);outline-offset:-2px;}
+.cli-ui .cli-reference-preview{margin:0 12px 10px;font-size:12px;line-height:1.6;color:var(--ink-3);overflow-wrap:anywhere;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;}
+.cli-ui .cli-reference-body{max-height:min(240px,30dvh);overflow:auto;overscroll-behavior:contain;scrollbar-width:thin;padding:10px 12px 12px;border-top:1px solid var(--line-2);font-size:13px;line-height:1.65;overflow-wrap:anywhere;}
+.cli-ui .cli-reference-body>pre{margin:0;font:inherit;white-space:pre-wrap;overflow-wrap:anywhere;}
+.cli-ui .cli-reference-body .md h1,.cli-ui .cli-reference-body .md h2,.cli-ui .cli-reference-body .md h3{font-size:14px;}
+.cli-ui .msg-body .cli-reference{margin:0 0 12px;background:var(--surface);}
+.cli-ui .msg-body .cli-reference:last-child{margin-bottom:0;}
+.cli-ui .cli-refs.composer-references{display:flex;flex-direction:column;align-items:stretch;gap:8px;padding:12px 14px 0;max-height:min(240px,32dvh);overflow:auto;overscroll-behavior:contain;}
+.cli-ui .composer-references>.cli-refs-t{font-size:11px;padding-left:2px;}
+@container(max-width:420px){
+  .cli-ui .cli-reference-state{display:none;}
+  .cli-ui .cli-reference-title{white-space:normal;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow-wrap:anywhere;line-height:1.4;}
+  .cli-ui .cli-reference-chevron{margin-left:auto;}
+}
+@media(pointer:coarse){
+  .cli-ui .cli-reference-toggle,.cli-ui .cli-reference-remove{min-height:44px;}
+  .cli-ui .cli-reference-remove{width:44px;}
+  .cli-ui .msg-actions button,.cli-ui .tool-h{min-height:44px;}
+  .cli-ui .msg-nav-btn{width:38px;height:44px;}
+}
+
 /* Shared panel controls never shrink the active content or overflow narrow rails. */
-.cli-ui .cli-panel-controls{position:relative;flex:none;}
+.cli-ui .cli-panel-controls{position:relative;display:flex;align-items:center;flex:none;}
+.cli-ui .cli-board-content-actions{display:flex;align-items:center;gap:4px;flex:none;}
+.cli-ui .cli-board-content-actions:empty{display:none;}
+.cli-ui .cli-board-content-actions .cli-fv-status{max-width:100px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
 .cli-ui .rail-tabs-scroll{min-width:0;}
 .cli-ui .cli-board-empty{padding:24px 16px;color:var(--ink-3);font-size:13px;line-height:1.6;}
 .cli-ui .operator-file-tabs{display:flex;flex:1;min-width:0;overflow-x:auto;align-items:center;scrollbar-width:thin;}
 
+/* When the side board is absent, its existing tabs share one quiet chat header. */
+.cli-ui .sess-head:has(.workspace-tabs){gap:12px;padding-top:8px;padding-bottom:0;align-items:center;}
+.cli-ui .sess-head .workspace-tabs{display:flex;align-items:stretch;gap:4px;flex:1 1 0;min-width:0;overflow-x:auto;overscroll-behavior-x:contain;scrollbar-width:none;}
+.cli-ui .workspace-tabs::-webkit-scrollbar{display:none;}
+.cli-ui .workspace-chat-tab{display:flex;flex-direction:column;justify-content:center;gap:4px;flex:none;max-width:min(300px,48cqi);min-height:56px;padding:7px 12px 10px 0;border-bottom:2px solid transparent;text-align:left;color:var(--ink-3);}
+.cli-ui .workspace-chat-tab.on{border-bottom-color:var(--accent);color:var(--ink);}
+.cli-ui .workspace-chat-tab:hover{color:var(--ink);}
+.cli-ui .workspace-chat-subtitle{display:flex;min-width:0;font-size:10.5px;color:var(--ink-3);}
+.cli-ui .workspace-chat-subtitle>.crumb{max-width:100%;}
+.cli-ui .workspace-chat-title{display:flex;align-items:baseline;gap:7px;min-width:0;width:100%;font-size:15px;font-weight:600;line-height:1.4;}
+.cli-ui .workspace-chat-title>span:last-child{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
+.cli-ui .workspace-chat-kind{flex:none;color:var(--ink-3);font-size:11px;font-weight:400;}
+.cli-ui .workspace-board-tabs-host,.cli-ui .workspace-board-tabs-host>.rail-tabs,.cli-ui .workspace-board-tabs-host .rail-tabs-scroll,.cli-ui .workspace-board-tabs-host .operator-file-tabs{display:contents;}
+.cli-ui .workspace-tabs .rail-tab{display:flex;align-items:center;gap:5px;flex:none;max-width:210px;padding:0 8px;min-height:56px;letter-spacing:0;font-family:var(--sans);font-size:13px;}
+.cli-ui .workspace-tabs .rail-ftab-l{min-height:44px;max-width:170px;gap:5px;}
+.cli-ui .workspace-tabs .rail-ftab-x{width:26px;height:32px;}
+.cli-ui .workspace-tabs .cli-panel-controls{position:sticky;right:0;background:var(--surface);padding:0 4px;}
+.cli-ui .workspace-tabs .rail-collapse{flex:none;min-width:36px;min-height:44px;margin:auto 0;}
+.cli-ui .workspace-tabs button:focus-visible{outline:2px solid var(--accent);outline-offset:-3px;border-radius:4px;}
+.cli-ui .workspace-tabs .rail-tab.on{border-bottom-color:var(--accent);}
+.cli-ui .sess-head:has(.workspace-tabs)>.sh-tools{align-self:center;padding-bottom:8px;flex:0 0 auto;}
+.cli-ui .workspace-tabs [role="tablist"]{min-width:0;}
+.cli-ui .workspace-chat-content{display:flex;flex:1;flex-direction:column;min-width:0;min-height:0;}
+.cli-ui .workspace-chat-content[hidden],.cli-ui .cli-inline-board[hidden],.cli-ui .sess-rail-inline[hidden]{display:none;}
+.cli-ui.cli-board.cli-inline-board{flex:1;min-height:0;border-left:0;}
+.cli-ui .sess-rail-inline{border:0;}
+.cli-ui .workspace-board-slot{display:contents;}
+.cli-ui .session:has(.workspace-drawer-layer){position:relative;}
+.cli-ui .workspace-drawer-layer{position:absolute;inset:0;z-index:70;}
+.cli-ui .workspace-drawer-layer[hidden],.cli-ui .workspace-drawer-scrim[hidden],.cli-ui .workspace-drawer-heading[hidden]{display:none;}
+.cli-ui .workspace-drawer-scrim{position:absolute;inset:0;width:100%;height:100%;background:rgba(0,0,0,.28);cursor:default;}
+.cli-ui .workspace-drawer-panel{position:absolute;inset:0 0 0 auto;display:flex;flex-direction:column;width:min(92%,480px);min-width:0;min-height:0;background:var(--surface);box-shadow:-10px 0 35px rgba(0,0,0,.12);animation:workspace-drawer-in .18s ease-out;}
+.cli-ui .workspace-drawer-heading{display:flex;align-items:center;justify-content:space-between;flex:none;min-height:52px;padding:4px 8px 4px 16px;border-bottom:1px solid var(--line-2);font-size:14px;font-weight:600;}
+.cli-ui .workspace-drawer-close{display:grid;place-items:center;width:44px;height:44px;border-radius:8px;color:var(--ink-3);}
+.cli-ui .workspace-drawer-close:hover{background:var(--surface-2);color:var(--ink);}
+.cli-ui .workspace-drawer-close svg{width:18px;height:18px;}
+.cli-ui .workspace-drawer-panel>.sess-rail,.cli-ui .workspace-board-slot>.sess-rail{flex:1;min-height:0;}
+.cli-ui .workspace-drawer-panel>.cli-board{height:auto;border-left:0;}
+.cli-ui .workspace-drawer-panel .rail-collapse{min-width:40px;min-height:44px;}
+.cli-ui .workspace-drawer-panel>.sess-rail:not(.cli-board)>.rail-tabs>.rail-collapse{display:none;}
+.cli-ui .workspace-drawer-panel .rail-tab{padding:2px 8px;font-family:var(--sans);font-size:12px;letter-spacing:0;}
+.cli-ui .workspace-drawer-panel .rail-ftab-x{min-width:30px;min-height:44px;}
+.cli-ui .workspace-drawer-panel .rail-ftab-l{min-height:44px;}
+.cli-ui .workspace-open{display:inline-flex;align-items:center;justify-content:center;flex:none;gap:5px;min-width:44px;min-height:44px;padding:0 8px;border-radius:8px;color:var(--ink-3);font-size:12px;}
+.cli-ui .workspace-open:hover{background:var(--surface-2);color:var(--ink);}
+.cli-ui .workspace-open svg{width:17px;height:17px;}
+.cli-ui .workspace-open:focus-visible,.cli-ui .workspace-drawer-close:focus-visible{outline:2px solid var(--accent);outline-offset:-2px;}
+@keyframes workspace-drawer-in{from{transform:translateX(20px);opacity:.65}to{transform:none;opacity:1}}
+@media(prefers-reduced-motion:reduce){.cli-ui .workspace-drawer-panel{animation:none;}}
+.cli-ui .compact-session .sess-head:has(.workspace-tabs){position:relative;flex-wrap:wrap;gap:0 8px;padding:6px 12px 0;}
+.cli-ui .compact-session .sess-head .workspace-tabs{flex:1 1 100%;order:2;}
+.cli-ui .compact-session .sess-head:has(.workspace-tabs)>.sh-tools{order:1;margin-left:auto;padding:0;flex:0 0 auto;}
+.cli-ui .compact-session .workspace-chat-tab{max-width:210px;min-height:52px;padding-right:10px;}
+.cli-ui .compact-session .workspace-chat-title{font-size:14px;}
+.cli-ui .compact-session .workspace-chat-subtitle{position:absolute;top:15px;left:12px;max-width:calc(100% - 160px);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
+.cli-ui .compact-session .sess-head:has(.mobile-back) .workspace-chat-subtitle{left:48px;max-width:calc(100% - 196px);}
+.cli-ui .compact-session .workspace-tabs .rail-tab{min-height:52px;max-width:180px;}
+.cli-ui .compact-session .workspace-tabs .rail-ftab-x{width:32px;height:44px;}
+@container (max-width:640px){
+  .cli-ui .sess-head:has(.workspace-tabs){position:relative;flex-wrap:wrap;gap:0 8px;padding:6px 12px 0;}
+  .cli-ui .sess-head .workspace-tabs{flex:1 1 100%;order:2;}
+  .cli-ui .sess-head:has(.workspace-tabs)>.sh-tools{order:1;margin-left:auto;padding:0;flex:0 0 auto;}
+  .cli-ui .workspace-chat-tab{max-width:210px;min-height:52px;padding-right:10px;}
+  .cli-ui .workspace-chat-title{font-size:14px;}
+  .cli-ui .workspace-chat-subtitle{position:absolute;top:15px;left:12px;max-width:calc(100% - 160px);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
+  .cli-ui .workspace-tabs .rail-tab{min-height:52px;max-width:180px;}
+  .cli-ui .workspace-tabs .rail-ftab-x{width:32px;height:44px;}
+}
+
 /* Keep browser controls readable in a narrow desktop rail and on phones. */
 .cli-ui .prev-actions.bp-actions{display:flex;flex-wrap:wrap;gap:8px;}
 .cli-ui .prev-actions.bp-actions>.btn{flex:0 0 auto;white-space:nowrap;min-width:0;}
 .cli-ui .prev-actions.bp-actions>span{min-width:0;}
 
-.cli-ui .cli-board-background{display:flex;align-items:flex-start;gap:10px;margin:0 14px 8px;padding:8px 10px;border:1px solid var(--line);border-radius:10px;color:var(--muted);font-size:12px;min-width:0;}
-.cli-ui .cli-board-background details{flex:1;min-width:0;overflow-wrap:anywhere;}
-.cli-ui .cli-board-background summary{cursor:pointer;}
-.cli-ui .cli-board-background label{display:flex;align-items:center;gap:4px;white-space:nowrap;cursor:pointer;}
-.cli-ui .cli-board-background ul{padding-left:18px;max-height:150px;overflow:auto;}
 
 .cli-ui .cli-auto-background{font-size:12px;color:var(--muted);margin-top:8px;}
 .cli-ui .cli-auto-background pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:220px;overflow:auto;}
 
+/* The live queue sits just above the composer; expanded content stays in a viewport-bound card. */
+.cli-ui .cli-queue{flex:none;min-width:0;max-height:154px;overflow-y:auto;overscroll-behavior:contain;scrollbar-width:thin;margin:0 12px -1px;padding:4px 8px 8px;border:1px solid var(--line-strong);border-radius:18px 18px 0 0;background:var(--raise);}
+.cli-ui .cli-queue-row{display:flex;align-items:center;gap:8px;min-width:0;min-height:46px;}
+.cli-ui .cli-queue-row+.cli-queue-row{border-top:1px solid var(--line-2);}
+.cli-ui .cli-queue-icon{display:grid;place-items:center;flex:none;width:20px;color:var(--ink-4);}
+.cli-ui .cli-queue-icon svg{width:16px;height:16px;}
+.cli-ui .cli-queue-summary{display:flex;align-items:center;gap:8px;flex:1;min-width:0;min-height:40px;padding:4px 0;text-align:left;color:var(--ink-2);}
+.cli-ui .cli-queue-thumb{flex:none;width:32px;height:32px;object-fit:cover;border:1px solid var(--line);border-radius:7px;}
+.cli-ui .cli-queue-text{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px;line-height:1.5;}
+.cli-ui .cli-queue-state{flex:none;color:var(--ink-4);font-size:10px;white-space:nowrap;}
+.cli-ui .cli-queue-remove,.cli-ui .cli-queue-more{display:grid;place-items:center;flex:none;width:30px;height:34px;border-radius:9px;color:var(--ink-3);}
+.cli-ui .cli-queue-remove svg,.cli-ui .cli-queue-more svg{width:17px;height:17px;}
+.cli-ui .cli-queue-remove:hover,.cli-ui .cli-queue-more:hover{background:var(--surface-2);color:var(--ink);}
+.cli-ui .cli-queue-remove:hover{color:var(--red);}
+.cli-ui .cli-queue-summary:focus-visible,.cli-ui .cli-queue-remove:focus-visible,.cli-ui .cli-queue-more:focus-visible{outline:2px solid var(--accent);outline-offset:1px;border-radius:8px;}
+.cli-ui .cli-queue-popover{width:420px;}
+.cli-ui .cli-queue-detail{max-height:min(44vh,320px);overflow:auto;overscroll-behavior:contain;overflow-wrap:anywhere;}
+.cli-ui .cli-queue-detail .msg{margin:0;}
+.cli-ui .cli-queue-detail .msg.user .msg-body{padding:8px;max-width:100%;border:0;box-shadow:none;background:transparent;}
+.cli-ui .cli-queue-actions{margin-top:8px;padding-top:4px;border-top:1px solid var(--line-2);}
+.cli-ui .cli-queue-actions .pop-item{min-height:40px;border-radius:10px;gap:8px;font-size:13px;}
+.cli-ui .cli-queue-actions svg{width:16px;height:16px;}
+.cli-ui .cli-queue-note,.cli-ui .cli-queue-feedback{padding:8px 10px;color:var(--ink-3);font-size:12px;line-height:1.5;overflow-wrap:anywhere;}
+.cli-ui .cli-queue-feedback[role="alert"]{color:var(--red);}
+.cli-ui .session>.cli-queue{width:calc(100% - 48px);max-width:800px;align-self:center;margin:8px 24px 16px;border-radius:16px;}
+@container(max-width:420px){
+  .cli-ui .cli-queue{margin:0 8px -1px;padding:4px 6px 7px;max-height:112px;}
+  .cli-ui .cli-queue-row{gap:5px;}
+  .cli-ui .cli-queue-state{display:none;}
+}
+@media(pointer:coarse){.cli-ui .cli-queue-remove,.cli-ui .cli-queue-more{width:36px;height:40px;}}
+@media(max-height:500px){.cli-ui .cli-queue{max-height:70px;}}
+
 /* Keep controls reachable when a keyboard, split host or landscape view leaves little height. */
 .cli-ui .session{overflow-x:hidden;overflow-y:auto;overscroll-behavior-y:contain;}
 /* A zero-height transcript must not paint over references and composer controls. */
@@ -333,8 +495,11 @@ cli-split{display:block;}
   .cli-ui .comp-area textarea,.cli-ui .ask-other,.cli-ui .bp-addr,.cli-ui .bp-dialog-in{font-size:16px;}
   .cli-ui .rail-ftab-x{width:32px;height:36px;opacity:1;}
   .cli-ui .cli-ref-x{width:32px;height:32px;}
-  .cli-ui .cli-fv-btn,.cli-ui .cli-fv-back,.cli-ui .bp-nav,.cli-ui .cli-attach{min-height:36px;min-width:36px;}
+  .cli-ui .cli-fv-btn,.cli-ui .cli-fv-back,.cli-ui .cli-fv-icon,.cli-ui .bp-nav,.cli-ui .cli-attach{min-height:36px;min-width:36px;}
   .cli-ui .rail-collapse{min-width:36px;min-height:36px;}
+  .cli-ui .cli-crumb{min-height:36px;}
+  .cli-ui .cli-fv-selq{min-height:40px;}
+  .cli-ui .cli-source-workspace .btn{min-height:36px;}
 }
 @media (max-height:500px){
   .cli-ui.cli-chat .sess-head{min-height:42px;padding:6px 12px;gap:6px;}
@@ -344,11 +509,60 @@ cli-split{display:block;}
   .cli-ui .msg-nav{display:none;}
   .cli-ui.cli-chat .composer{padding:6px 10px;}
   .cli-ui.cli-chat .comp-area{padding:8px 12px 0;}
-  .cli-ui.cli-chat .comp-area textarea{min-height:40px;max-height:64px;}
   .cli-ui.cli-chat .comp-foot{padding:4px 8px;}
-  .cli-ui .cli-board-background{margin:0 10px 4px;padding:5px 8px;max-height:56px;overflow:auto;flex:0 0 auto;}
   .cli-ui .cli-refs{max-height:64px;overflow:auto;flex:0 0 auto;}
 }
 @media (pointer:coarse) and (max-width:600px){
   .cli-ui .bp.bp-big,.cli-ui .cli-fv.cli-fv-big{inset:max(6px,env(safe-area-inset-top)) max(6px,env(safe-area-inset-right)) max(6px,env(safe-area-inset-bottom)) max(6px,env(safe-area-inset-left));}
 }
+
+.cli-ui .cli-fv-sync{position:absolute;right:12px;top:12px;z-index:2;padding:4px 8px;color:var(--dim);font-size:12px;background:var(--bg);pointer-events:none}
+
+/* Shared chat / board upload status. Theme variables stay owned by the host. */
+.cli-ui .cli-upload-progress{display:grid;grid-template-columns:18px minmax(0,1fr) auto;align-items:start;gap:8px;min-width:0;max-width:100%;padding:10px;border:1px solid var(--line-2);border-radius:10px;background:var(--surface-2);container-type:inline-size;}
+.cli-ui .cli-upload-icon{display:flex;align-items:center;justify-content:center;padding-top:2px;color:var(--ink-3);}
+.cli-ui .cli-upload-icon svg{width:16px;height:16px;}
+.cli-ui .cli-upload-body{min-width:0;}
+.cli-ui .cli-upload-head{display:flex;align-items:baseline;flex-wrap:wrap;gap:3px 10px;min-width:0;}
+.cli-ui .cli-upload-name{flex:1 1 140px;min-width:0;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--ink);font-size:12.5px;font-weight:500;line-height:1.45;}
+.cli-ui .cli-upload-status{flex:none;color:var(--ink-3);font-size:11.5px;line-height:1.45;white-space:nowrap;}
+.cli-ui .cli-upload-meta{display:flex;align-items:baseline;justify-content:space-between;gap:8px;min-width:0;margin-top:4px;color:var(--ink-3);font-family:var(--mono);font-size:10.5px;line-height:1.4;font-variant-numeric:tabular-nums;}
+.cli-ui .cli-upload-meta>span:first-child{min-width:0;overflow-wrap:anywhere;}
+.cli-ui .cli-upload-meta>span+span{flex:none;}
+.cli-ui .cli-upload-track{height:3px;margin-top:7px;overflow:hidden;border-radius:3px;background:var(--line-2);}
+.cli-ui .cli-upload-fill{display:block;height:100%;border-radius:inherit;background:var(--accent);}
+.cli-ui .cli-upload-track.indeterminate .cli-upload-fill{width:35%;animation:cli-upload-pending 1.7s ease-in-out infinite alternate;}
+.cli-ui [data-upload-status="queued"] .cli-upload-track.indeterminate .cli-upload-fill{width:20%;animation:none;opacity:.55;}
+.cli-ui .cli-upload-actions{display:flex;align-items:center;justify-content:flex-end;gap:4px;}
+.cli-ui .cli-upload-action{display:inline-flex;align-items:center;justify-content:center;flex:none;min-width:32px;min-height:32px;padding:4px 6px;border-radius:7px;color:var(--ink-3);font-size:12px;line-height:1.3;}
+.cli-ui .cli-upload-action svg{width:15px;height:15px;}
+.cli-ui .cli-upload-action:hover:not(:disabled){background:var(--surface);color:var(--ink);}
+.cli-ui .cli-upload-action:focus-visible{outline:2px solid var(--accent);outline-offset:1px;}
+.cli-ui .cli-upload-action:disabled{opacity:.45;cursor:default;}
+.cli-ui .cli-upload-retry{color:var(--accent);}
+.cli-ui .cli-upload-error{margin-top:5px;min-width:0;color:var(--red);font-size:12px;line-height:1.5;overflow-wrap:anywhere;}
+.cli-ui [data-upload-status="error"] .cli-upload-status{color:var(--red);}
+.cli-ui .cli-upload-sr{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0;}
+@keyframes cli-upload-pending{from{transform:translateX(0)}to{transform:translateX(185%)}}
+@container(max-width:360px){.cli-ui .cli-upload-head{gap:2px 6px;}.cli-ui .cli-upload-name{flex-basis:110px;}}
+@media(pointer:coarse){.cli-ui .cli-upload-action{min-width:44px;min-height:44px;}.cli-ui .cli-upload-retry{min-width:48px;}}
+@media(prefers-reduced-motion:reduce){.cli-ui .cli-upload-track.indeterminate .cli-upload-fill{animation:none;}}
+
+.cli-ui .cli-board-upload{flex:none;min-width:0;padding:8px 10px;}
+.cli-ui .cli-blocks>.cli-upload-progress{flex:none;}
+
+.cli-ui .composer-upload-list{display:flex;flex-direction:column;gap:8px;padding:10px 12px 0;min-width:0;}
+
+/* 群聊沿用普通对话排版，只补充发言人与协作引用的辅助信息。 */
+.cli-ui.cli-group-chat .cli-group-meta{color:var(--ink-3);font-size:11.5px;line-height:1.6;padding:0 0 4px;overflow-wrap:anywhere;}
+.cli-ui.cli-group-chat .cli-group-references{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0 12px;}
+.cli-ui.cli-group-chat .cli-group-references>.cli-reference{flex:1 1 240px;min-width:0;}
+
+/* Large-file reading keeps only one bounded semantic page in the document. */
+.cli-ui .cli-html-reading{overflow-wrap:anywhere;}
+.cli-ui .cli-html-reading .cli-html-row{font-family:var(--font-mono,monospace);white-space:pre-wrap;}
+.cli-ui .cli-html-reading .cli-html-image{color:var(--ink-3);}
+.cli-ui .cli-fv-sync .cli-fv-btn{margin-left:8px;}
+.cli-ui .cli-fv-b.k-html.cli-fv-flow{display:block;overflow:auto;}
+.cli-ui .cli-html-reading-note{color:var(--ink-3);background:transparent;}
+.cli-ui .cli-html-page-nav{position:sticky;bottom:0;display:flex;align-items:center;justify-content:center;gap:8px;background:var(--surface-1,var(--surface));color:var(--ink-3);}

package/src/ui/Markdown.tsx

@@ -44,12 +44,12 @@ function MdImg({ src, alt, ...props }: ComponentProps<"img">) {
 // 缺省的地址处理会把 file: 等非网页协议清空；放行 file: 和 Windows 路径，交给上面按本地文件处理（与 Operator 一致）。
 const urlTransform = (url: string) => (/^file:/i.test(url) || /^[a-z]:[\\/]/i.test(url) ? url : defaultUrlTransform(url));
 
-export const Markdown = memo(function Markdown({ children }: { children: string }) {
+export const Markdown = memo(function Markdown({ children, highlight = true }: { children: string; highlight?: boolean }) {
   return (
     <div className="md">
       <ReactMarkdown
         remarkPlugins={[remarkGfm]}
-        rehypePlugins={[[rehypeHighlight, { detect: false, ignoreMissing: true }]]}
+        rehypePlugins={highlight ? [[rehypeHighlight, { detect: false, ignoreMissing: true }]] : []}
         components={{ a: MdLink, img: MdImg, code: MdCode }}
         urlTransform={urlTransform}
       >

package/src/ui/Popover.tsx

@@ -1,8 +1,9 @@
-import { useEffect, useLayoutEffect, useRef, useState } from "react";
+import { useEffect, useLayoutEffect, useRef, useState, type RefObject } from "react";
 import { createPortal } from "react-dom";
-export function Popover({ children, onClose }: { children: React.ReactNode; onClose: () => void }) {
+export function Popover({ children, onClose, className, ariaLabel = "选项", placement = "auto", align = "end", returnFocusRef }: { children: React.ReactNode; onClose: () => void; className?: string; ariaLabel?: string; placement?: "auto" | "top"; align?: "start" | "end"; returnFocusRef?: RefObject<HTMLElement | null> }) {
   const markerRef = useRef<HTMLSpanElement>(null);
   const menuRef = useRef<HTMLDivElement>(null);
+  const placeRef = useRef<(() => void) | null>(null);
   const [pos, setPos] = useState<{ top: number; left: number } | null>(null);
 
   useLayoutEffect(() => {
@@ -20,38 +21,50 @@ export function Popover({ children, onClose }: { children: React.ReactNode; onCl
       menu.style.maxWidth = `${Math.max(0, vw - 16)}px`;
       menu.style.maxHeight = `${Math.max(0, vh - 16)}px`;
       const mw = menu.offsetWidth, mh = menu.offsetHeight;
-      const left = Math.max(leftEdge + 8, Math.min(r.right - mw, leftEdge + vw - mw - 8));
+      const preferredLeft = align === "start" ? r.left : r.right - mw;
+      const left = Math.max(leftEdge + 8, Math.min(preferredLeft, leftEdge + vw - mw - 8));
       const below = r.bottom + 6;
-      const preferredTop = below + mh <= topEdge + vh - 8 ? below : r.top - mh - 6;
+      const preferredTop = placement !== "top" && below + mh <= topEdge + vh - 8 ? below : r.top - mh - 6;
       const top = Math.max(topEdge + 8, Math.min(preferredTop, topEdge + vh - mh - 8));
       setPos({ top, left });
     };
+    placeRef.current = place;
     place();
     const observer = new ResizeObserver(place);
     observer.observe(menu);
     window.addEventListener("resize", place);
     window.visualViewport?.addEventListener("resize", place);
     window.visualViewport?.addEventListener("scroll", place);
-    return () => { observer.disconnect(); window.removeEventListener("resize", place); window.visualViewport?.removeEventListener("resize", place); window.visualViewport?.removeEventListener("scroll", place); };
-  }, []);
+    return () => { placeRef.current = null; observer.disconnect(); window.removeEventListener("resize", place); window.visualViewport?.removeEventListener("resize", place); window.visualViewport?.removeEventListener("scroll", place); };
+  }, [placement, align]);
 
   const placed = pos !== null;
   useEffect(() => {
-    if (placed) menuRef.current?.querySelector<HTMLElement>("button:not(:disabled),input:not(:disabled),[tabindex='0']")?.focus({ preventScroll: true });
+    if (placed) menuRef.current?.querySelector<HTMLElement>("button:not(:disabled),input:not(:disabled),select:not(:disabled),textarea:not(:disabled),[tabindex='0']")?.focus({ preventScroll: true });
   }, [placed]);
 
   useEffect(() => {
     const close = (e: PointerEvent) => {
       if (!menuRef.current?.contains(e.target as Node) && !markerRef.current?.parentElement?.contains(e.target as Node)) onClose();
     };
-    const onScroll = (e: Event) => { if (!menuRef.current?.contains(e.target as Node)) onClose(); };
+    const onScroll = (e: Event) => {
+      const menu = menuRef.current;
+      if (e.target instanceof Node && menu?.contains(e.target)) return;
+      const focused = document.activeElement;
+      // A phone keyboard may scroll the outer workspace while the card owns input focus.
+      if (menu?.classList.contains("composer-popover") && focused && menu.contains(focused) && focused.matches("input,textarea,select,[contenteditable='true']")) {
+        placeRef.current?.();
+        return;
+      }
+      onClose();
+    };
     const onKey = (e: KeyboardEvent) => {
       if (e.key === "Escape") {
         e.preventDefault(); e.stopPropagation(); onClose();
-        markerRef.current?.parentElement?.querySelector<HTMLButtonElement>("button")?.focus();
+        (returnFocusRef?.current ?? markerRef.current?.parentElement?.querySelector<HTMLButtonElement>("button"))?.focus();
       }
       if (e.key === "Tab") {
-        const items = Array.from(menuRef.current?.querySelectorAll<HTMLElement>("button:not(:disabled),input:not(:disabled),a[href],[tabindex='0']") ?? []);
+        const items = Array.from(menuRef.current?.querySelectorAll<HTMLElement>("button:not(:disabled),input:not(:disabled),select:not(:disabled),textarea:not(:disabled),a[href],[tabindex='0']") ?? []);
         if (!items.length) return;
         if (e.shiftKey && document.activeElement === items[0]) { e.preventDefault(); items.at(-1)?.focus(); }
         else if (!e.shiftKey && document.activeElement === items.at(-1)) { e.preventDefault(); items[0].focus(); }
@@ -61,7 +74,7 @@ export function Popover({ children, onClose }: { children: React.ReactNode; onCl
     window.addEventListener("scroll", onScroll, true);
     window.addEventListener("keydown", onKey, true);
     return () => { window.removeEventListener("pointerdown", close, true); window.removeEventListener("scroll", onScroll, true); window.removeEventListener("keydown", onKey, true); };
-  }, [onClose]);
+  }, [onClose, returnFocusRef]);
 
   return (
     <>
@@ -69,7 +82,7 @@ export function Popover({ children, onClose }: { children: React.ReactNode; onCl
       {createPortal(
         <div className="cli-ui" data-theme={markerRef.current?.closest("[data-theme]")?.getAttribute("data-theme") ?? "dark"}><div
           ref={menuRef}
-          className="popover" role="dialog" aria-label="选项"
+          className={`popover${className ? ` ${className}` : ""}`} role="dialog" aria-label={ariaLabel}
           style={{ position: "fixed", top: pos?.top ?? -9999, left: pos?.left ?? -9999, right: "auto", visibility: pos ? "visible" : "hidden" }}
           onClick={(e) => e.stopPropagation()}
         >

package/src/ui/QueuedMessages.tsx

@@ -0,0 +1,69 @@
+import { useMemo, useRef, useState, type MouseEvent, type ReactNode } from "react";
+import type { Msg } from "../core/types";
+import { splitMessage } from "../core/blocks";
+import { withoutBoardContext } from "../board/context";
+import { Icon } from "./icons";
+import { splitAttachments, type MsgAttachment } from "./format";
+import { MessageView, type MessageViewOptions } from "./Transcript";
+import { Popover } from "./Popover";
+
+const detailView: MessageViewOptions = { timestamps: false, initialBadge: false, userLabel: "你", agentName: "智能体", viewingBlock: false };
+export interface QueuedMessagesProps {
+  scopeKey: string;
+  messages: readonly Msg[];
+  onCancel?: (message: Msg) => void;
+  attachmentUrl?: (attachment: MsgAttachment) => string | null;
+  renderMessage?: (message: Msg) => ReactNode;
+}
+
+/** The original live queue remains authoritative; this view never removes or resends messages locally. */
+export function QueuedMessages({ scopeKey, messages, onCancel, attachmentUrl, renderMessage }: QueuedMessagesProps) {
+  if (!messages.length) return null;
+  return <div className="cli-queue" role="list" aria-label={`排队消息（${messages.length}）`}>
+    {messages.map((message, index) => <QueuedMessage key={`${scopeKey}:${message.id}`} message={message} index={index} onCancel={onCancel} attachmentUrl={attachmentUrl} renderMessage={renderMessage} />)}
+  </div>;
+}
+
+function QueuedMessage({ message, index, onCancel, attachmentUrl, renderMessage }: Omit<QueuedMessagesProps, "messages" | "scopeKey"> & { message: Msg; index: number }) {
+  const [open, setOpen] = useState(false);
+  const [copying, setCopying] = useState(false);
+  const [feedback, setFeedback] = useState<{ error: boolean; text: string } | null>(null);
+  const returnFocusRef = useRef<HTMLButtonElement | null>(null);
+  const content = useMemo(() => withoutBoardContext(message.content), [message.content]);
+  const preview = useMemo(() => {
+    const { text, attachments } = splitAttachments(content);
+    const body = splitMessage(text).map(part => part.kind === "text" ? part.text : part.block.name).join(" · ").replace(/\s+/g, " ").trim().slice(0, 160);
+    const summary = [body, ...attachments.map(attachment => attachment.name)].filter(Boolean).join(" · ");
+    return { summary: summary || "查看排队消息", attachments };
+  }, [content]);
+  const thumbnail = preview.attachments.filter(attachment => attachment.kind === "image").map(attachment => ({ attachment, url: attachmentUrl?.(attachment) })).find(item => item.url);
+  const toggle = (event: MouseEvent<HTMLButtonElement>) => { returnFocusRef.current = event.currentTarget; setOpen(value => !value); setFeedback(null); };
+  const copy = async () => {
+    if (copying) return;
+    setCopying(true); setFeedback(null);
+    try {
+      if (!navigator.clipboard?.writeText) throw new Error("当前浏览器不支持复制，请选择消息内容手动复制");
+      await navigator.clipboard.writeText(content);
+      setFeedback({ error: false, text: "消息已复制" });
+    } catch (error) {
+      setFeedback({ error: true, text: error instanceof Error ? error.message : "复制失败，请重试" });
+    } finally { setCopying(false); }
+  };
+  return <div className="cli-queue-row" role="listitem" data-queued-id={message.id}>
+    <span className="cli-queue-icon" aria-hidden="true">{Icon.list()}</span>
+    <button className="cli-queue-summary" aria-label={`查看第 ${index + 1} 条排队消息`} aria-expanded={open} aria-haspopup="dialog" onClick={toggle} title={preview.summary}>
+      {thumbnail?.url && <img className="cli-queue-thumb" src={thumbnail.url} alt={thumbnail.attachment.name} loading="lazy" onError={event => { event.currentTarget.hidden = true; }} />}
+      <span className="cli-queue-text">{preview.summary}</span>
+    </button>
+    <span className="cli-queue-state">排队中</span>
+    {onCancel && <button className="cli-queue-remove" title="从队列中移除" aria-label={`移除第 ${index + 1} 条排队消息`} onClick={() => onCancel(message)}>{Icon.x()}</button>}
+    <button className="cli-queue-more" title="更多排队消息操作" aria-label={`第 ${index + 1} 条排队消息的更多操作`} aria-expanded={open} aria-haspopup="dialog" onClick={toggle}>{Icon.dots()}</button>
+    {open && <Popover className="composer-popover cli-queue-popover" ariaLabel="排队消息内容" placement="top" align="start" returnFocusRef={returnFocusRef} onClose={() => setOpen(false)}>
+      <div className="pop-sec">第 {index + 1} 条排队消息</div>
+      <div className="cli-queue-detail" onClick={event => { if (event.defaultPrevented && event.target instanceof Element && event.target.closest("a")) setOpen(false); }}>{renderMessage ? renderMessage({ ...message, role: "user", content }) : <MessageView m={{ ...message, role: "user", content }} initial={false} hideWho handlers={{ attachmentUrl }} view={detailView} />}</div>
+      {message.note && <div className="cli-queue-note">{message.note}</div>}
+      <div className="cli-queue-actions"><button className="pop-item" disabled={copying} onClick={() => void copy()}>{Icon.copy()} {copying ? "复制中…" : "复制消息"}</button></div>
+      {feedback && <div className="cli-queue-feedback" role={feedback.error ? "alert" : "status"}>{feedback.text}</div>}
+    </Popover>}
+  </div>;
+}

package/src/ui/ReferenceCard.tsx

@@ -0,0 +1,28 @@
+import { useId, useState, type ReactNode } from "react";
+import { Icon } from "./icons";
+import { Markdown } from "./Markdown";
+import { referencePreview, referenceTitle } from "./reference";
+
+/** A reference stays separate from editable text; expanding it never changes the payload. */
+export function ReferenceCard({ title, text, onRemove, disabled, renderContent, className, removeLabel }: {
+  title: string; text: string; onRemove?: () => void; disabled?: boolean;
+  renderContent?: (text: string) => ReactNode; className?: string; removeLabel?: string;
+}) {
+  const [open, setOpen] = useState(false);
+  const bodyId = useId();
+  const displayTitle = referenceTitle(title);
+  return <section className={`cli-reference${open ? " open" : ""}${className ? ` ${className}` : ""}`} aria-label={`引用 ${displayTitle}`}>
+    <div className="cli-reference-head">
+      <button type="button" className="cli-reference-toggle" aria-expanded={open} aria-controls={bodyId} aria-label={`${open ? "收起" : "展开"}引用 ${displayTitle}`} onClick={() => setOpen(value => !value)}>
+        <span className="cli-reference-icon" aria-hidden="true">{Icon.doc()}</span>
+        <span className="cli-reference-kind">引用</span>
+        <span className="cli-reference-title cli-ref-l" title={title}>{displayTitle}</span>
+        <span className="cli-reference-state">{open ? "收起" : "展开"}</span>
+        <span className="cli-reference-chevron" aria-hidden="true">{open ? Icon.chevUp() : Icon.chevDown()}</span>
+      </button>
+      {onRemove && <button type="button" className="cli-reference-remove" disabled={disabled} aria-label={removeLabel ?? `移除引用 ${title}`} title="移除引用" onClick={onRemove}>{Icon.x()}</button>}
+    </div>
+    {open ? <div className="cli-reference-body" id={bodyId}>{text.length > 50_000 ? <pre>{text}</pre> : renderContent ? renderContent(text) : <Markdown>{text}</Markdown>}</div>
+      : <div className="cli-reference-preview">{referencePreview(text) || "引用内容"}</div>}
+  </section>;
+}