Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { Button } from '@/components/ui/button';
/**
* SelectionQuoteButton — 聊天消息流的"选中文字 → 添加到对话"浮动按钮。
*
* 交互(对标图片标注的"发送到对话"心智):在消息流([data-scroll-container])
* 内选中任意文字,选区上方浮出胶囊按钮;点击把选中文本追加进当前会话草稿的
* 正文(composerDraftStore.appendQuoteToDraft,非 silent → ChatInput 立即插入
* 引用块并把光标放到其后),随后清除选区、按钮消失。
*
* 实现要点:
* - selectionchange 只负责"选区塌缩就隐藏";按钮定位在 mouseup 时计算一次
* (选区定型后),不随滚动跟随——消息流滚动会触发 scroll 隐藏,避免按钮
* 悬在错位处。
* - 按钮用 onMouseDown preventDefault:点击瞬间浏览器默认会先清除选区,
* 否则 click 时 selection 已空拿不到文本。
* - portal 到 body,fixed 定位;z-index 低于 lightbox(9999),高于消息流。
* - 宿主不限于聊天流:文件浏览器(FileBodyView)以自己的正文容器 + 当前
* 文件相对路径复用同一交互,引用随消息携带来源文件。
*/
import { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react';
import { createPortal } from 'react-dom';
import { MessageSquarePlus } from 'lucide-react';
import { useTranslation } from 'react-i18next';
import type { ChatQuote } from '@/lib/chatQuotes';
import { appendQuoteToDraft } from '@/lib/composerDraftStore';
/** 单条引用的长度上限:防止误选整篇转录把 prompt 撑爆;超出截断并加省略号。 */
const QUOTE_MAX_CHARS = 4000;
interface SelectionAnchor {
text: string;
x: number;
y: number;
placement: 'above' | 'below';
}
const BUTTON_GAP_PX = 8;
const BUTTON_HEIGHT_ESTIMATE_PX = 28;
const BUTTON_MIN_TOP_PX = 44;
// The fixed-position element's auto width is otherwise shrink-to-fit from its
// untransformed `left` edge. Keep a full pill-width clearance on both sides:
// the visual centering transform does not participate in that calculation.
const BUTTON_EDGE_MARGIN_PX = 8;
const FLOATING_QUOTE_DISABLED_SELECTOR = '[data-selection-floating-quote-disabled]';
interface RectBounds {
left: number;
top: number;
right: number;
bottom: number;
width: number;
height: number;
}
function clamp(value: number, min: number, max: number): number {
return Math.min(Math.max(value, min), max);
}
/**
* 用户消息不显示主动浮出的“添加到对话”按钮,但右键菜单仍可添加。
* 用 Range 相交判断而非只看选区端点,避免跨消息拖选时夹带 user 消息时
* 浮动按钮重新出现。
*/
export function selectionIntersectsFloatingQuoteDisabledArea(
range: Pick<Range, 'intersectsNode'>,
container: Pick<HTMLElement, 'querySelectorAll'>,
): boolean {
for (const element of container.querySelectorAll(FLOATING_QUOTE_DISABLED_SELECTOR)) {
if (range.intersectsNode(element)) return true;
}
return false;
}
function getSelectionDirection(selection: Selection): 'forward' | 'backward' {
if (!selection.anchorNode || !selection.focusNode) return 'forward';
if (selection.anchorNode === selection.focusNode) {
return selection.focusOffset >= selection.anchorOffset ? 'forward' : 'backward';
}
const position = selection.anchorNode.compareDocumentPosition(selection.focusNode);
if (position & Node.DOCUMENT_POSITION_FOLLOWING) return 'forward';
if (position & Node.DOCUMENT_POSITION_PRECEDING) return 'backward';
return 'forward';
}
function getRectBounds(rects: readonly DOMRect[]): RectBounds | null {
let left = Number.POSITIVE_INFINITY;
let top = Number.POSITIVE_INFINITY;
let right = Number.NEGATIVE_INFINITY;
let bottom = Number.NEGATIVE_INFINITY;
for (const rect of rects) {
if (rect.width <= 0 || rect.height <= 0) continue;
left = Math.min(left, rect.left);
top = Math.min(top, rect.top);
right = Math.max(right, rect.right);
bottom = Math.max(bottom, rect.bottom);
}
if (
!Number.isFinite(left) ||
!Number.isFinite(top) ||
!Number.isFinite(right) ||
!Number.isFinite(bottom)
) {
return null;
}
return {
left,
top,
right,
bottom,
width: right - left,
height: bottom - top,
};
}
function getFloatingAnchor(selection: Selection, range: Range): Omit<SelectionAnchor, 'text'> | null {
const rects = Array.from(range.getClientRects()).filter(
(rect) => rect.width > 0 && rect.height > 0,
);
if (rects.length === 0) return null;
const bounds = getRectBounds(rects);
if (!bounds) return null;
const direction = getSelectionDirection(selection);
const edgeRect = direction === 'forward' ? rects[rects.length - 1] : rects[0];
if (!edgeRect) return null;
const edgeMiddleY = edgeRect.top + edgeRect.height / 2;
const boundsMiddleY = bounds.top + bounds.height / 2;
const canPlaceAbove =
edgeRect.top - BUTTON_GAP_PX - BUTTON_HEIGHT_ESTIMATE_PX >= BUTTON_MIN_TOP_PX;
const canPlaceBelow =
edgeRect.bottom + BUTTON_GAP_PX + BUTTON_HEIGHT_ESTIMATE_PX <= window.innerHeight;
const placement =
edgeMiddleY > boundsMiddleY && canPlaceBelow ? 'below' : canPlaceAbove ? 'above' : 'below';
return {
x: direction === 'forward' ? edgeRect.right : edgeRect.left,
y: placement === 'above' ? edgeRect.top : edgeRect.bottom,
placement,
};
}
export function SelectionQuoteButton({
sessionId,
containerRef,
sourcePath,
getQuoteText,
getQuoteMetadata,
onAskInSideChat,
}: {
onAskInSideChat?: (quote: string) => Promise<boolean>;
sessionId: string;
/**
* 引用来源文件(workdir 相对路径)。文件浏览器宿主传入;聊天消息流不传。
* 带来源的引用发送时携带 `— source:` 行,模型可 Read 上下文 / 精准编辑。
*/
sourcePath?: string;
/** Optional raw text source override; file bodies use the CodeMirror document slice. */
getQuoteText?: () => string | null;
/** Optional file/editor metadata to attach to the quote. */
getQuoteMetadata?: () => Pick<ChatQuote, 'startLine' | 'endLine'> | null;
/**
* 本按钮所属消息流的滚动容器。判定选区归属必须用**自己的**容器——协同
* 模式下多个聊天流(lead + workers)同时挂载,各有一个本组件实例;若用
* 全局 querySelector 找第一个容器,选区会被错误实例认领,引用就加进了
* 别的会话的输入框。绑定自己的容器后,选区落在哪个流,只有那个流的
* 按钮出现,append 的 sessionId 必然正确。
*/
containerRef: React.RefObject<HTMLElement | null>;
}) {
const { t } = useTranslation();
const [anchor, setAnchor] = useState<SelectionAnchor | null>(null);
const [openingSideChat, setOpeningSideChat] = useState(false);
const pillRef = useRef<HTMLDivElement>(null);
const [pillWidth, setPillWidth] = useState(200);
useLayoutEffect(() => {
if (anchor && pillRef.current) setPillWidth(pillRef.current.getBoundingClientRect().width);
}, [anchor, openingSideChat, onAskInSideChat, t]);
const anchorRef = useRef<SelectionAnchor | null>(null);
anchorRef.current = anchor;
const commitQuote = useCallback((selectionAnchor: SelectionAnchor) => {
const text =
selectionAnchor.text.length > QUOTE_MAX_CHARS
? `${selectionAnchor.text.slice(0, QUOTE_MAX_CHARS)}…`
: selectionAnchor.text;
const metadata = getQuoteMetadata?.() ?? null;
appendQuoteToDraft(
sessionId,
sourcePath ? { text, sourcePath, ...(metadata ?? {}) } : { text },
);
window.getSelection()?.removeAllRanges();
setAnchor(null);
}, [getQuoteMetadata, sessionId, sourcePath]);
useEffect(() => {
// Position follows the actual selected text edge, not the mouse-up point. This keeps
// the button attached to the selection even if the pointer is released outside it.
const readSelectionInStream = (allowQuoteDisabled = false): SelectionAnchor | null => {
const sel = window.getSelection();
if (!sel || sel.isCollapsed || sel.rangeCount === 0) return null;
const raw = getQuoteText?.() ?? sel.toString();
if (!raw.trim()) return null;
// 前导**缩进空格**必须保留:空白敏感代码(FileBodyView 选中缩进行)的
// 引用要与文件原文逐字符一致,模型才能按引用文本定位 / 精准编辑。但前
// 导 / 尾部**换行**要剥:对定位无意义,且以换行开头的引用会让
// formatQuoteForSend 的首行产出裸 `>`,引用解析的 `> ` 守卫会失配。
// trim 仅用于上面的空选区判定。
const text = raw.replace(/^[\r\n]+/, '').replace(/[\r\n]+$/, '');
const container = containerRef.current;
if (!container) return null;
const range = sel.getRangeAt(0);
// 选区必须整体落在消息流容器内(输入框/侧栏里的选中不触发)。
if (
!container.contains(range.startContainer) ||
!container.contains(range.endContainer)
) {
return null;
}
if (!allowQuoteDisabled && selectionIntersectsFloatingQuoteDisabledArea(range, container)) return null;
const floatingAnchor = getFloatingAnchor(sel, range);
if (!floatingAnchor) return null;
return { text, ...floatingAnchor };
};
const onMouseUp = () => {
// 松手后 selection 需要一帧定型(双击选词等场景)。
requestAnimationFrame(() => setAnchor(readSelectionInStream()));
};
const onSelectionChange = () => {
// 只负责"选区没了就藏"——避免每次拖动扩选都重算位置导致按钮乱跳。
const sel = window.getSelection();
if ((!sel || sel.isCollapsed) && anchorRef.current) setAnchor(null);
};
const onScrollOrResize = () => {
if (anchorRef.current) setAnchor(null);
};
const container = containerRef.current;
if (container) container.dataset.selectionQuoteContext = '';
const unsubscribeAddToChat = window.electronAPI.onSelectionContextMenuAddToChat(() => {
const currentSelection = readSelectionInStream(true);
if (currentSelection) commitQuote(currentSelection);
});
document.addEventListener('mouseup', onMouseUp);
document.addEventListener('selectionchange', onSelectionChange);
// capture:消息流滚动事件不冒泡到 document,用捕获段拿到。
document.addEventListener('scroll', onScrollOrResize, true);
window.addEventListener('resize', onScrollOrResize);
return () => {
document.removeEventListener('mouseup', onMouseUp);
document.removeEventListener('selectionchange', onSelectionChange);
document.removeEventListener('scroll', onScrollOrResize, true);
window.removeEventListener('resize', onScrollOrResize);
unsubscribeAddToChat();
if (container?.dataset.selectionQuoteContext === '') {
delete container.dataset.selectionQuoteContext;
}
};
}, [commitQuote, containerRef, getQuoteText]);
if (!anchor) return null;
const handleAdd = () => {
commitQuote(anchor);
};
return createPortal(
<div
ref={pillRef}
// mousedown 先于 click 触发浏览器清选区;preventDefault 保住选区与按钮。
onMouseDown={(e) => e.preventDefault()}
className="fixed z-[60] flex w-max max-w-[calc(100vw-16px)] flex-wrap justify-center gap-1 rounded-full bg-popover p-1 shadow-[var(--shadow-menu)]"
style={{
left: clamp(anchor.x, pillWidth / 2 + BUTTON_EDGE_MARGIN_PX, window.innerWidth - pillWidth / 2 - BUTTON_EDGE_MARGIN_PX),
top:
anchor.placement === 'above'
? Math.max(anchor.y - BUTTON_GAP_PX, BUTTON_MIN_TOP_PX)
: Math.min(
anchor.y + BUTTON_GAP_PX,
Math.max(
BUTTON_MIN_TOP_PX,
window.innerHeight - BUTTON_HEIGHT_ESTIMATE_PX - BUTTON_GAP_PX,
),
),
transform: anchor.placement === 'above' ? 'translate(-50%, -100%)' : 'translate(-50%, 0)',
}}
>
<Button variant="secondary" size="sm" compact type="button" onClick={handleAdd}>
<MessageSquarePlus className="h-3.5 w-3.5" />
{t('chat.quote.addToChat')}
</Button>
{onAskInSideChat && <Button variant="secondary" size="sm" compact type="button" disabled={openingSideChat}
onClick={async () => {
setOpeningSideChat(true);
try {
if (await onAskInSideChat(anchor.text.slice(0, QUOTE_MAX_CHARS))) {
window.getSelection()?.removeAllRanges();
setAnchor(null);
}
} finally { setOpeningSideChat(false); }
}}>
{t(openingSideChat ? 'chat.sideChat.opening' : 'chat.sideChat.title')}
</Button>}
</div>,
document.body,
);
}