负责对账服务
优化慢查询
" }],
+};
+const after = {
+ ...before,
+ content_json: [{ company: "示例科技", description: "
" }],
+};
+const change = { change_id: "change_1", change_type: "modified", before, after, rationale: "JD 强调高并发" };
+
+describe("行内 diff 的计算", () => {
+ it("reports only the bullet that changed, with a readable location", () => {
+ expect(proposalTextChanges(change)).toEqual([
+ { label: "示例科技 · 要点 1", before: "负责对账服务", after: "负责日均千万笔的对账服务" },
+ ]);
+ });
+
+ it("diffs Chinese by character so the inserted words stand out", () => {
+ expect(diffText("负责对账服务", "负责日均千万笔的对账服务")).toEqual([
+ { kind: "same", text: "负责" },
+ { kind: "added", text: "日均千万笔的" },
+ { kind: "same", text: "对账服务" },
+ ]);
+ });
+
+ it("finds the target by evidence first and flags a manual edit as a conflict", () => {
+ const sections = [
+ { id: 1, section_type: "experience", title: "改过名的经历", content_json: before.content_json, source_section_ids: [11] },
+ ];
+ const target = findTargetSection(sections, change);
+ expect(target?.id).toBe(1);
+ expect(conflictsWithManualEdit(target, change)).toBe(false);
+ const edited = { ...sections[0], content_json: [{ company: "示例科技", description: "我自己写的" }] };
+ expect(conflictsWithManualEdit(edited, change)).toBe(true);
+ expect(conflictsWithManualEdit(undefined, { change_type: "added" })).toBe(false);
+ });
+});
+
+describe("InlineProposal：采用 / 修改 / 跳过", () => {
+ const renderProposal = (overrides: Partial
[0]> = {}) => {
+ const props = {
+ change, conflict: false, factGateBlocked: false, busy: false,
+ onAccept: vi.fn(), onSkip: vi.fn(), onAskRewrite: vi.fn(), ...overrides,
+ };
+ render();
+ return props;
+ };
+
+ it("shows the change in place and accepts or skips it in one click", () => {
+ const props = renderProposal();
+ expect(screen.getByText("日均千万笔的")).toHaveClass("paper-diff-added");
+ expect(screen.getByText("JD 强调高并发")).toBeInTheDocument();
+ fireEvent.click(screen.getByRole("button", { name: /采用/ }));
+ expect(props.onAccept).toHaveBeenCalledWith();
+ fireEvent.click(screen.getByRole("button", { name: /跳过/ }));
+ expect(props.onSkip).toHaveBeenCalled();
+ });
+
+ it("lets the user rewrite the suggestion before accepting", () => {
+ const props = renderProposal();
+ fireEvent.click(screen.getByRole("button", { name: /修改/ }));
+ const box = screen.getByRole("textbox", { name: "修改 AI 建议" });
+ expect(box.textContent).toBe("负责日均千万笔的对账服务");
+ box.textContent = "负责日均 1,000 万笔的对账服务";
+ fireEvent.click(screen.getByRole("button", { name: /按我的改法采用/ }));
+ expect(props.onAccept).toHaveBeenCalledWith("负责日均 1,000 万笔的对账服务");
+ });
+
+ it("never lets a stale suggestion overwrite the user's own edit", () => {
+ const props = renderProposal({ conflict: true });
+ expect(screen.getByRole("note")).toHaveTextContent("以你的版本为准");
+ expect(screen.getByRole("button", { name: /^采用/ })).toBeDisabled();
+ expect(screen.getByRole("button", { name: /修改/ })).toBeDisabled();
+ fireEvent.click(screen.getByRole("button", { name: "让 AI 按我的版本重写" }));
+ expect(props.onAskRewrite).toHaveBeenCalled();
+ });
+});
+
+describe("修改意见：先堆积，再一次交给 AI", () => {
+ const comments = [
+ { id: "a", quote: "负责对账服务", section: "工作经历", instruction: "更精炼" },
+ { id: "b", quote: "优化慢查询", section: "工作经历", instruction: "补上优化幅度" },
+ ];
+
+ it("builds one prompt that keeps the user's edits and forbids invented facts", () => {
+ const prompt = buildCommentPrompt(42, "示例公司 · 后端", comments);
+ expect(prompt).toContain("岗位简历 #42");
+ expect(prompt).toContain("1. 【工作经历】「负责对账服务」→ 更精炼");
+ expect(prompt).toContain("2. 【工作经历】「优化慢查询」→ 补上优化幅度");
+ expect(prompt).toContain("get_resume_workspace");
+ expect(prompt).toContain("不要编造");
+ expect(prompt).toContain("不要直接覆盖");
+ });
+
+ it("removes a single comment and submits the rest together", () => {
+ const onRemove = vi.fn();
+ const onSubmit = vi.fn();
+ render();
+ expect(screen.getByTestId("resume-comment-tray")).toHaveTextContent("2 条修改意见");
+ fireEvent.click(screen.getAllByRole("button", { name: "删除这条意见" })[0]);
+ expect(onRemove).toHaveBeenCalledWith("a");
+ fireEvent.click(screen.getByRole("button", { name: "一次交给 AI" }));
+ expect(onSubmit).toHaveBeenCalled();
+ });
+});
diff --git a/frontend/src/app/resume/components/canvas/CanvasAssist.tsx b/frontend/src/app/resume/components/canvas/CanvasAssist.tsx
new file mode 100644
index 00000000..efa25327
--- /dev/null
+++ b/frontend/src/app/resume/components/canvas/CanvasAssist.tsx
@@ -0,0 +1,262 @@
+"use client";
+
+/**
+ * 简历画布上的 AI 协作层（切片 ②）：
+ * - InlineProposal：AI 建议落在它要改的那一段里，按块「采用 / 修改 / 跳过」；
+ * - CanvasSelectionBar：选中文字后的浮条，「更精炼 / 对齐岗位 / 换个说法 / 留言」；
+ * - CommentTray：修改意见先堆着，攒够了一次交给 Agent。
+ *
+ * 这些控件全部带 data-paper-chrome，打印 / 导出时不存在。
+ */
+
+import { useEffect, useRef, useState, type RefObject } from "react";
+import { Check, MessageSquarePlus, PenLine, Sparkles, X } from "lucide-react";
+import { diffText, proposalTextChanges, type ProposalTextChange } from "./proposalDiff";
+
+export interface InlineChange {
+ change_id: string;
+ change_type?: string;
+ title?: string;
+ before?: any;
+ after?: any;
+ rationale?: string;
+ reason?: string;
+}
+
+export function DiffLine({ change }: { change: ProposalTextChange }) {
+ const segments = diffText(change.before, change.after);
+ return (
+
+ {segments.map((segment, index) => (
+ {segment.text}
+ ))}
+
+ );
+}
+
+export function InlineProposal({
+ change,
+ conflict,
+ factGateBlocked,
+ busy,
+ onAccept,
+ onSkip,
+ onAskRewrite,
+}: {
+ change: InlineChange;
+ conflict: boolean;
+ factGateBlocked: boolean;
+ busy: boolean;
+ onAccept: (editedText?: string) => void;
+ onSkip: () => void;
+ onAskRewrite: () => void;
+}) {
+ const [editing, setEditing] = useState(false);
+ const editRef = useRef(null);
+ const lines = proposalTextChanges(change);
+ const editableLine = lines.length === 1 ? lines[0] : null;
+ const reason = change.rationale || change.reason || "";
+ const structural = change.change_type === "removed"
+ ? "建议隐藏这一段"
+ : change.change_type === "reordered"
+ ? "建议调整这一段的位置"
+ : change.change_type === "added"
+ ? `建议新增段落「${change.after?.title || change.title || ""}」`
+ : "";
+ const acceptBlocked = conflict || factGateBlocked;
+
+ useEffect(() => {
+ if (editing && editRef.current) {
+ editRef.current.textContent = editableLine?.after || "";
+ editRef.current.focus();
+ }
+ }, [editing, editableLine?.after]);
+
+ return (
+
+
+ AI 建议
+ {reason && {reason}}
+
+ {conflict && (
+
+ 你在建议生成后改过这段，以你的版本为准。这条建议基于旧内容，不能直接采用。
+
+ )}
+ {structural &&
{structural}
}
+ {!editing && lines.map((line, index) => (
+
+ {line.label}
+
+
+ ))}
+ {editing && editableLine && (
+
+ {editableLine.label} · 改成你想要的样子
+
+
+ )}
+
+ {editing ? (
+ <>
+
+
+
+ ) : (
+ <>
+
+
+
+ {conflict &&
}
+
+ )}
+
+
{ if (!writing) event.preventDefault(); }}>
+ {writing ? (
+
+ ) : (
+ <>
+ {QUICK_INSTRUCTIONS.map(([label, instruction]) => (
+
+ ))}
+
+
+ )}
+
+ );
+}
+
+export function buildCommentPrompt(resumeId: number, targetLabel: string, comments: CanvasComment[]) {
+ const lines = comments.map((comment, index) =>
+ `${index + 1}. 【${comment.section}】「${comment.quote}」→ ${comment.instruction}`,
+ );
+ return [
+ `请修改岗位简历 #${resumeId}（目标：${targetLabel}）中我圈出的内容：`,
+ ...lines,
+ "",
+ "要求：",
+ "- 先用 get_resume_workspace 读取当前版本：我刚在页面上手动改过，它是最新的，不要基于旧内容改写；",
+ "- 只改我圈出的文字，其他内容保持原样；",
+ "- 新增的数字、公司、成果必须来自已验证档案（Evidence）；没有证据就先问我，不要编造；",
+ "- 以可审核的修改建议提交，让我在页面上逐条采用、修改或跳过，不要直接覆盖。",
+ ].join("\n");
+}
+
+export function CommentTray({
+ comments,
+ onRemove,
+ onSubmit,
+}: {
+ comments: CanvasComment[];
+ onRemove: (id: string) => void;
+ onSubmit: () => void;
+}) {
+ if (!comments.length) return null;
+ return (
+
+
+ {comments.length} 条修改意见
+
+
+
+ {comments.map((comment) => (
+ -
+ 「{comment.quote}」
+ {comment.instruction}
+
+
+ ))}
+
+
负责支付对账服务
把对账耗时从 40 分钟降到 6 分钟
",
+ }],
+ ...overrides,
+});
+
+const renderPaper = (props: Partial[0]> = {}) => render(
+ ,
+);
+
+const commit = (element: HTMLElement, text: string) => {
+ element.focus();
+ element.textContent = text;
+ fireEvent.blur(element);
+};
+
+describe("纸模板：成品即编辑器", () => {
+ it("renders the finished resume without any editing chrome when read-only", () => {
+ renderPaper();
+ expect(screen.getByText("林一")).toBeInTheDocument();
+ expect(screen.getByText("把对账耗时从 40 分钟降到 6 分钟")).toBeInTheDocument();
+ expect(screen.queryAllByRole("textbox")).toHaveLength(0);
+ expect(screen.queryByText(/添加一条/)).not.toBeInTheDocument();
+ });
+
+ it("commits a direct edit of a bullet back to the same source field", () => {
+ const onSectionChange = vi.fn();
+ renderPaper({ editable: true, onSectionChange });
+ const [, second] = screen.getAllByRole("textbox", { name: "经历要点" });
+ commit(second, "把对账耗时从 40 分钟降到 4 分钟");
+ const next = onSectionChange.mock.calls[0][0] as PaperSection;
+ expect(next.id).toBe(7);
+ expect(next.content_json[0].description).toBe(
+ "负责支付对账服务
把对账耗时从 40 分钟降到 4 分钟
",
+ );
+ expect(next.content_json[0].company).toBe("示例科技");
+ });
+
+ it("edits profile fields in place and does nothing when the text is unchanged", () => {
+ const onProfileChange = vi.fn();
+ renderPaper({ editable: true, onProfileChange });
+ const name = screen.getByRole("textbox", { name: "姓名" });
+ commit(name, "林一");
+ expect(onProfileChange).not.toHaveBeenCalled();
+ commit(name, "林一一");
+ expect(onProfileChange).toHaveBeenCalledWith({ user_name: "林一一" });
+ commit(screen.getByRole("textbox", { name: "电话" }), "138 0000 0000");
+ expect(onProfileChange).toHaveBeenLastCalledWith({ contact_json: { email: "lin@example.com", phone: "138 0000 0000" } });
+ });
+
+ it("Escape restores the original text instead of committing", () => {
+ const onSectionChange = vi.fn();
+ renderPaper({ editable: true, onSectionChange });
+ const title = screen.getByRole("textbox", { name: "公司" });
+ title.focus();
+ title.textContent = "写错了";
+ fireEvent.keyDown(title, { key: "Escape" });
+ expect(title.textContent).toBe("示例科技");
+ });
+
+ it("adds an item from the canvas", () => {
+ const onSectionChange = vi.fn();
+ renderPaper({ editable: true, onSectionChange });
+ fireEvent.click(screen.getByRole("button", { name: /添加一条/ }));
+ const next = onSectionChange.mock.calls[0][0] as PaperSection;
+ expect(next.content_json).toHaveLength(2);
+ expect(next.content_json[1]).toMatchObject({ company: "", position: "", description: "" });
+ });
+});
+
+describe("要点与 description 互转", () => {
+ it("escapes user text and drops empty bullets", () => {
+ expect(bulletsToDescription(["A ", " ", "\u200b"])).toBe("");
+ });
+
+ it("keeps hidden bullet indexes aligned when a bullet is removed", () => {
+ const item = { description: "", hidden_bullet_indexes: [2] };
+ const next = editBullet(item, 0, { remove: true });
+ expect(next.description).toBe("");
+ expect(next.hidden_bullet_indexes).toEqual([1]);
+ });
+});
+
+describe("纸模板默认排版", () => {
+ it("uses the Kami-style dense defaults only for the paper template", () => {
+ const paper = normalizeTemplateSettings({ template: "paper" });
+ expect(paper.margins).toEqual({ top: 11, right: 13, bottom: 11, left: 13 });
+ expect(paper.exact.headingColor).toBe("#1B365D");
+ expect(paper.exact.lineHeight).toBe(1.45);
+ const reference = normalizeTemplateSettings({ template: "reference" });
+ expect(reference.margins.top).toBe(8);
+ });
+});
diff --git a/frontend/src/app/resume/components/templates/ResumePaper.tsx b/frontend/src/app/resume/components/templates/ResumePaper.tsx
new file mode 100644
index 00000000..35f5bc97
--- /dev/null
+++ b/frontend/src/app/resume/components/templates/ResumePaper.tsx
@@ -0,0 +1,486 @@
+"use client";
+
+/**
+ * 「纸」模板：成品即编辑器。
+ *
+ * 同一个组件既是导出 PDF 用的成品，也是工作区里可以直接点字修改的画布
+ * （editable=true）。所以画布上看到的就是导出的样子，没有表单与预览两套东西。
+ *
+ * 排版约束参考 tw93/Kami（MIT）的 design.md：单一强调色、暖灰、单衬线两字重、
+ * 字号阶梯、减法装饰、4pt 间距网格。中文字体只用 OFL 许可的思源宋体 / Noto Serif SC，
+ * 不使用仅限个人免费的仓耳今楷。
+ */
+
+import { Fragment, useEffect, useRef, type KeyboardEvent, type ReactNode } from "react";
+import { splitBullets } from "@/lib/resumeText";
+
+export interface PaperSection {
+ id: number;
+ section_type: string;
+ title: string;
+ visible: boolean;
+ content_json: any[];
+ sort_order: number;
+ [key: string]: unknown;
+}
+
+export interface ResumePaperProps {
+ userName: string;
+ title?: string;
+ summary: string;
+ contactJson: Record;
+ sections: PaperSection[];
+ styleConfig: Record;
+ editable?: boolean;
+ onProfileChange?: (patch: { user_name?: string; title?: string; summary?: string; contact_json?: Record }) => void;
+ onSectionChange?: (section: PaperSection) => void;
+ /** 仅画布：在某一段标题下方插入行内 AI 建议等交互层（不进入导出）。 */
+ renderSectionAside?: (section: PaperSection) => ReactNode;
+ /** 仅画布：页尾交互层，例如「建议新增的段落」。 */
+ canvasFooter?: ReactNode;
+}
+
+type FieldKey = string;
+interface ItemShape {
+ title: FieldKey;
+ meta: FieldKey[];
+ start?: FieldKey;
+ end?: FieldKey;
+ date?: FieldKey;
+ description?: boolean;
+ tags?: { category: FieldKey; items: FieldKey };
+ titlePlaceholder: string;
+ metaPlaceholders: string[];
+}
+
+const EXPERIENCE: ItemShape = {
+ title: "company", meta: ["position", "location"], start: "startDate", end: "endDate", description: true,
+ titlePlaceholder: "公司", metaPlaceholders: ["职位", "城市"],
+};
+
+const SHAPES: Record = {
+ education: {
+ title: "school", meta: ["degree", "major", "gpa"], start: "startDate", end: "endDate", description: true,
+ titlePlaceholder: "学校", metaPlaceholders: ["学历", "专业", "GPA"],
+ },
+ workExperiences: EXPERIENCE,
+ experience: EXPERIENCE,
+ internshipExperiences: EXPERIENCE,
+ projects: {
+ title: "name", meta: ["role", "url"], start: "startDate", end: "endDate", description: true,
+ titlePlaceholder: "项目名称", metaPlaceholders: ["角色", "链接"],
+ },
+ awards: {
+ title: "awardName", meta: ["issuer"], date: "awardedAt", description: true,
+ titlePlaceholder: "奖项", metaPlaceholders: ["颁发方"],
+ },
+ certificates: {
+ title: "name", meta: ["scoreOrLevel", "issuer"], date: "date",
+ titlePlaceholder: "证书", metaPlaceholders: ["分数 / 等级", "颁发方"],
+ },
+ skills: {
+ title: "category", meta: [], tags: { category: "category", items: "items" },
+ titlePlaceholder: "类别", metaPlaceholders: [],
+ },
+ personalExperiences: {
+ title: "experienceTitle", meta: [], start: "startDate", end: "endDate", description: true,
+ titlePlaceholder: "经历", metaPlaceholders: [],
+ },
+};
+SHAPES.project = SHAPES.projects;
+SHAPES.skill = SHAPES.skills;
+SHAPES.certificate = SHAPES.certificates;
+SHAPES.custom = SHAPES.personalExperiences;
+
+const FALLBACK_SHAPE: ItemShape = {
+ title: "title", meta: ["subtitle"], start: "startDate", end: "endDate", description: true,
+ titlePlaceholder: "标题", metaPlaceholders: ["副标题"],
+};
+
+export function shapeFor(sectionType: string): ItemShape {
+ return SHAPES[sectionType] || FALLBACK_SHAPE;
+}
+
+const CONTACT_FIELDS: Array<[string, string]> = [
+ ["phone", "电话"],
+ ["email", "邮箱"],
+ ["location", "城市"],
+ ["website", "个人网站"],
+ ["github", "GitHub"],
+ ["linkedin", "LinkedIn"],
+];
+
+function escapeHtml(value: string) {
+ return value.replace(/&/g, "&").replace(//g, ">");
+}
+
+export function bulletsToDescription(bullets: string[]) {
+ const kept = bullets.map((item) => item.replace(/\u200b/g, "").trim()).filter(Boolean);
+ if (!kept.length) return "";
+ return `${kept.map((item) => `${escapeHtml(item)}
`;
+}
+
+export function editBullet(
+ item: Record,
+ index: number,
+ change: { text?: string; remove?: boolean; insertAfter?: boolean },
+): Record {
+ const bullets = splitBullets(String(item.description || ""));
+ const hidden = new Set(
+ Array.isArray(item.hidden_bullet_indexes) ? item.hidden_bullet_indexes.map(Number) : [],
+ );
+ let nextHidden = [...hidden];
+ if (change.remove) {
+ bullets.splice(index, 1);
+ nextHidden = nextHidden.filter((value) => value !== index).map((value) => (value > index ? value - 1 : value));
+ } else if (change.insertAfter) {
+ bullets.splice(index + 1, 0, "");
+ nextHidden = nextHidden.map((value) => (value > index ? value + 1 : value));
+ } else if (typeof change.text === "string") {
+ if (bullets[index] === change.text) return item;
+ bullets[index] = change.text;
+ }
+ const next: Record = { ...item, description: bulletsToDescription(bullets.length ? bullets : []) };
+ if (change.insertAfter) {
+ next.description = ``;
+ }
+ if (Array.isArray(item.hidden_bullet_indexes) || nextHidden.length) next.hidden_bullet_indexes = nextHidden;
+ return next;
+}
+
+function visibleBulletEntries(item: Record) {
+ const hidden = new Set(
+ Array.isArray(item.hidden_bullet_indexes) ? item.hidden_bullet_indexes.map(Number) : [],
+ );
+ return splitBullets(String(item.description || ""))
+ .map((text, index) => ({ text: text.replace(/\u200b/g, ""), index }))
+ .filter((entry) => !hidden.has(entry.index));
+}
+
+function printableBullets(item: Record, editable: boolean) {
+ const entries = visibleBulletEntries(item);
+ return editable ? entries : entries.filter((entry) => entry.text.trim());
+}
+
+interface EditableProps {
+ value: string;
+ editable: boolean;
+ placeholder: string;
+ className?: string;
+ label: string;
+ multiline?: boolean;
+ onCommit: (value: string) => void;
+ onEnter?: () => void;
+ onBackspaceEmpty?: () => void;
+ autoFocus?: boolean;
+}
+
+function Editable({ value, editable, placeholder, className = "", label, multiline = false, onCommit, onEnter, onBackspaceEmpty, autoFocus }: EditableProps) {
+ const ref = useRef(null);
+ useEffect(() => {
+ const node = ref.current;
+ if (!node || document.activeElement === node) return;
+ if (node.textContent !== value) node.textContent = value;
+ }, [value]);
+ useEffect(() => {
+ if (autoFocus && ref.current) ref.current.focus();
+ }, [autoFocus]);
+
+ if (!editable) {
+ return value ? {value} : null;
+ }
+
+ const commit = () => {
+ const text = (ref.current?.textContent || "").replace(/\u00a0/g, " ").replace(/\u200b/g, "");
+ const normalized = multiline ? text.trim() : text.replace(/\s*\n\s*/g, " ").trim();
+ if (normalized !== value) onCommit(normalized);
+ };
+
+ const onKeyDown = (event: KeyboardEvent) => {
+ if (event.key === "Escape") {
+ event.preventDefault();
+ if (ref.current) ref.current.textContent = value;
+ ref.current?.blur();
+ return;
+ }
+ if (event.key === "Enter" && !(multiline && event.shiftKey)) {
+ event.preventDefault();
+ commit();
+ if (onEnter) onEnter();
+ else ref.current?.blur();
+ return;
+ }
+ if (event.key === "Backspace" && onBackspaceEmpty && !(ref.current?.textContent || "").trim()) {
+ event.preventDefault();
+ onBackspaceEmpty();
+ }
+ };
+
+ return (
+
+ {value}
+
+ );
+}
+
+function textOf(value: unknown) {
+ if (Array.isArray(value)) return value.map((item) => String(item)).filter(Boolean).join("、");
+ return value == null ? "" : String(value);
+}
+
+function emptyItem(shape: ItemShape) {
+ const item: Record = { [shape.title]: "" };
+ for (const key of shape.meta) item[key] = "";
+ if (shape.description) item.description = "";
+ if (shape.tags) item[shape.tags.items] = "";
+ return item;
+}
+
+function hasContent(item: Record, shape: ItemShape) {
+ const keys = [shape.title, ...shape.meta, shape.start, shape.end, shape.date, shape.tags?.items, "description"];
+ return keys.some((key) => key && textOf(item[key]).replace(/<[^>]+>/g, "").trim());
+}
+
+export function ResumePaper(props: ResumePaperProps) {
+ const {
+ userName, title = "", summary, contactJson, sections, styleConfig,
+ editable = false, onProfileChange, onSectionChange, renderSectionAside, canvasFooter,
+ } = props;
+ const focusRef = useRef(null);
+ const tone = styleConfig.paperTone === "white" ? "white" : "parchment";
+
+ const contact = contactJson || {};
+ const contactEntries = CONTACT_FIELDS.filter(([key]) => editable || contact[key]);
+ const summaryText = summary ? summary.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim() : "";
+
+ const updateItem = (section: PaperSection, index: number, next: Record) => {
+ const content = [...(section.content_json || [])];
+ content[index] = next;
+ onSectionChange?.({ ...section, content_json: content });
+ };
+
+ const visibleSections = [...sections]
+ .filter((section) => section.visible !== false)
+ .sort((a, b) => (a.sort_order || 0) - (b.sort_order || 0));
+
+ return (
+
+
+
+ onProfileChange?.({ user_name: value })} />
+
+ {(editable || title) && (
+
+ onProfileChange?.({ title: value })} />
+
+ )}
+ {contactEntries.length > 0 && (
+
+ {contactEntries.map(([key, label], index) => (
+
+ {index > 0 && (editable || contact[key]) && ·}
+ onProfileChange?.({ contact_json: { ...contact, [key]: value } })} />
+
+ ))}
+
+ )}
+
+
+ {(editable || summaryText) && (
+
+
+ onProfileChange?.({ summary: value })} />
+
+
+ )}
+
+ {visibleSections.map((section) => {
+ const shape = shapeFor(section.section_type);
+ const items = (section.content_json || [])
+ .map((item, index) => ({ item: item as Record, index }))
+ .filter(({ item }) => editable || hasContent(item, shape));
+ if (!editable && items.length === 0) return null;
+ return (
+
+
+ onSectionChange?.({ ...section, title: value })} />
+
+ {editable && renderSectionAside?.(section)}
+
+ {items.map(({ item, index }) => (
+
updateItem(section, index, next)}
+ onRemove={() => {
+ const content = [...(section.content_json || [])];
+ content.splice(index, 1);
+ onSectionChange?.({ ...section, content_json: content });
+ }}
+ />
+ ))}
+
+
+ set(shape.tags!.category, value)} />
+
+
+ set(shape.tags!.items, value)} />
+
+ {editable && }
+
+ );
+ }
+
+ const renderMeta = (): ReactNode => metaParts.map((key, position) => {
+ const placeholder = shape.metaPlaceholders[shape.meta.indexOf(key)] || "";
+ return (
+
+ {position > 0 && (editable || textOf(item[key])) && ·}
+ set(key, value)} />
+
+ );
+ });
+
+ return (
+
+
+
+
+ set(shape.title, value)} />
+
+ {metaParts.length > 0 && {renderMeta()}}
+
+ {hasDate && (
+
+ {shape.date ? (
+ set(shape.date!, value)} />
+ ) : (
+ <>
+ set(shape.start!, value)} />
+ {(editable || (item[shape.start!] && item[shape.end!])) && – }
+ set(shape.end!, value)} />
+
+ )}
+
+ )}
+ {editable &&
}
+
+ {(bullets.length > 0 || (editable && shape.description)) && (
+
+ {bullets.map((entry, position) => {
+ const key = `${itemKey}-b${entry.index}`;
+ return (
+ -
+ onChange(editBullet(item, entry.index, { text: value }))}
+ onEnter={() => {
+ focusKey.current = `${itemKey}-b${entry.index + 1}`;
+ onChange(editBullet(item, entry.index, { insertAfter: true }));
+ }}
+ onBackspaceEmpty={() => {
+ const previous = bullets[position - 1];
+ focusKey.current = previous ? `${itemKey}-b${previous.index}` : null;
+ onChange(editBullet(item, entry.index, { remove: true }));
+ }}
+ />
+
+ );
+ })}
+ {editable && bullets.length === 0 && (
+ -
+
+
+ )}
+
+ )}
+
)}
+ {parkedRuns.length > 0 && (
+
+ {parkedRuns.map((item) => (
+
+
+
+ 之前的任务{PARKED_RUN_LABELS[item.status] || "等你处理"}，状态已保存
+
+
+
+ ))}
+
+ )}
+
+ {queuedMessages.length > 0 && (
+
+
+ {agentBusy ? "待发送：助手空闲后按顺序发送" : runNeedsUser ? "待发送：当前任务在等你，处理完会自动发送" : "待发送"}
+
+ {queuedMessages.map((item) => (
+
+ {item.content}
+ {!agentBusy && runNeedsUser && (
+
+ )}
+
+
+
+ ))}
+
+ )}
+
{/* 输入区 */}
@@ -1473,6 +1679,9 @@ function PanelMessageBubble({
>
{message.content}
+ {message.steered && (
+
{response.alerts && response.alerts.length > 0 &&
}
diff --git a/frontend/src/components/workbench/ContextRail.tsx b/frontend/src/components/workbench/ContextRail.tsx
index 80da6815..fce60191 100644
--- a/frontend/src/components/workbench/ContextRail.tsx
+++ b/frontend/src/components/workbench/ContextRail.tsx
@@ -10,6 +10,7 @@ import { AnimatePresence, motion } from "framer-motion";
import { lazy, Suspense, useEffect } from "react";
import { PanelRightClose, PanelRightOpen } from "lucide-react";
import { useWorkbench } from "@/lib/workbench";
+import { AGENT_COMPOSE_EVENT } from "@/lib/agentCompose";
const AgentPanel = lazy(() =>
import("./AgentPanel").then((module) => ({ default: module.AgentPanel })),
@@ -23,6 +24,12 @@ const RAIL_WIDTH = 340;
export function ContextRail() {
const { railMode, setRailMode, railOpen, setRailOpen, selection } = useWorkbench();
+ useEffect(() => {
+ const openAgent = () => { setRailMode("agent"); setRailOpen(true); };
+ window.addEventListener(AGENT_COMPOSE_EVENT, openAgent);
+ return () => window.removeEventListener(AGENT_COMPOSE_EVENT, openAgent);
+ }, [setRailMode, setRailOpen]);
+
useEffect(() => {
if (!railOpen) return;
const closeOnEscape = (event: KeyboardEvent) => {
diff --git a/frontend/src/components/workbench/WorkbenchShell.tsx b/frontend/src/components/workbench/WorkbenchShell.tsx
index eeb6966c..ee8a8324 100644
--- a/frontend/src/components/workbench/WorkbenchShell.tsx
+++ b/frontend/src/components/workbench/WorkbenchShell.tsx
@@ -11,6 +11,7 @@ import Link from "next/link";
import { usePathname, useRouter } from "next/navigation";
import { AnimatePresence, motion } from "framer-motion";
import { ArrowLeft, Bot } from "lucide-react";
+import { AGENT_COMPOSE_EVENT } from "@/lib/agentCompose";
import { Sidebar } from "@/components/layout/Sidebar";
import { OnboardingGate } from "@/components/onboarding/OnboardingGate";
import { WorkbenchProvider, useWorkbench } from "@/lib/workbench";
@@ -49,6 +50,12 @@ const FOCUS_RULES: FocusRule[] = [
function FocusTopBar({ rule }: { rule: FocusRule }) {
const [agentOpen, setAgentOpen] = useState(false);
+ // 页面把意图交给 Agent 时自动打开面板，消息在面板挂载后从邮箱取走。
+ useEffect(() => {
+ const open = () => setAgentOpen(true);
+ window.addEventListener(AGENT_COMPOSE_EVENT, open);
+ return () => window.removeEventListener(AGENT_COMPOSE_EVENT, open);
+ }, []);
return (
<>
diff --git a/frontend/src/lib/agentCompose.ts b/frontend/src/lib/agentCompose.ts
new file mode 100644
index 00000000..57595cbb
--- /dev/null
+++ b/frontend/src/lib/agentCompose.ts
@@ -0,0 +1,29 @@
+/**
+ * 页面把一段意图交给 OfferU Agent 的唯一通道（例如简历画布上攒好的修改意见）。
+ *
+ * Agent 面板是按需挂载的：事件发出时它可能还不存在。所以消息先进邮箱，
+ * 面板挂载时取走，已挂载的面板通过事件立即收到。面板按 D-1 规则发送：
+ * 正在运行就引导或排队，绝不丢、绝不锁。
+ */
+
+export interface AgentComposeRequest {
+ message: string;
+ skillId?: string;
+}
+
+export const AGENT_COMPOSE_EVENT = "offeru-agent-compose";
+
+const mailbox: AgentComposeRequest[] = [];
+
+export function composeToAgent(request: AgentComposeRequest) {
+ const message = request.message.trim();
+ if (!message) return;
+ mailbox.push({ ...request, message });
+ if (typeof window !== "undefined") {
+ window.dispatchEvent(new CustomEvent(AGENT_COMPOSE_EVENT));
+ }
+}
+
+export function drainAgentCompose(): AgentComposeRequest[] {
+ return mailbox.splice(0, mailbox.length);
+}
diff --git a/frontend/src/lib/api.ts b/frontend/src/lib/api.ts
index 67c57d20..c3a20b70 100644
--- a/frontend/src/lib/api.ts
+++ b/frontend/src/lib/api.ts
@@ -1445,6 +1445,12 @@ export const agentRuntimeApi = {
`/api/agent/runtime/runs/${encodeURIComponent(runId)}/resume`,
{ method: "POST" }
),
+ /** D-1：运行中发来的消息在下一个工具边界注入当前 Run；not_running 表示应作为新一轮发送。 */
+ steer: (runId: string, message: string) =>
+ request<{ ok: boolean; disposition: "steered" | "not_running" }>(
+ `/api/agent/runtime/runs/${encodeURIComponent(runId)}/steer`,
+ { method: "POST", body: JSON.stringify({ message }) }
+ ),
abort: (runId: string) =>
request<{ ok: boolean; run: AgentRunRecord }>(
`/api/agent/runtime/runs/${encodeURIComponent(runId)}/abort`,