@plumeai/plugin-sdk 0.1.5 → 0.1.7

package/dist/client/styles/src/index.d.ts

@@ -105,19 +105,7 @@ export declare const card: {
         };
     };
 };
-/** 卡片底部一行：左边是说明，右边是按钮。 */
-export declare const actions: {
-    row: string;
-    note: string;
-};
 export declare const code: {
     block: string;
-    diff: string;
-    diffLine: string;
-    diffKind: {
-        same: string;
-        add: string;
-        remove: string;
-    };
 };
 export {};

package/dist/client/ui/src/avatar/AgentAvatar.d.ts

@@ -22,8 +22,6 @@ export interface AgentAvatarProps {
     /** 像素边长。 */
     size?: number;
     mood?: AvatarMood;
-    /** 右下角的小圆点：在跑是强调色、会一圈圈往外扩；出错是红的。 */
-    badge?: "running" | "failed" | null;
     /**
      * 悬停时眼睛跟着指针、身子弹一下。默认开。
      *
@@ -39,4 +37,4 @@ export interface AgentAvatarProps {
     cheer?: string | number | null;
     className?: string;
 }
-export declare function AgentAvatar({ avatar, size, mood, badge, interactive, host, seed, label, cheer, className, }: AgentAvatarProps): import("react").JSX.Element;
+export declare function AgentAvatar({ avatar, size, mood, interactive, host, seed, label, cheer, className }: AgentAvatarProps): import("react").JSX.Element;

package/dist/client/ui/src/avatar/AvatarPile.d.ts

@@ -1,8 +1,7 @@
 /**
  * 一摞脸：派出去不止一个时，叠在一起说「有好几个」。
  *
- * 和 `AvatarStack` 是两件事。那一排并排摆开，每张脸都看得清表情，适合「这一批都是谁」的场合；
- * 这一摞叠着放，占地方小，说的是「这里有好几个，点开看」——放在一行字旁边、一个切换器上这类挤的地方。
+ * 叠着放，占地方小，说的是「这里有好几个，点开看」——放在一行字旁边、一个切换器上这类挤的地方。
  * 表情仍然在：在跑的还在颠，只是被邻居盖住半张脸。
  *
  * 叠放有先后：后一张压在前一张上面，像一张一张往右放下去的牌，最后放下的那张完整露出来，「+N」

package/dist/client/ui/src/i18n/messages/en.d.ts

@@ -73,6 +73,7 @@ export declare const en: {
     "settings.models": string;
     "settings.about": string;
     "settings.personalization": string;
+    "settings.saveFailed": string;
     "settings.agents": string;
     "agents.title": string;
     "agents.intro": string;
@@ -185,6 +186,12 @@ export declare const en: {
     "projectList.projects": string;
     "projectList.recent": string;
     "projectList.newLooseChat": string;
+    "welcome.lateNight": string;
+    "welcome.morning": string;
+    "welcome.forenoon": string;
+    "welcome.noon": string;
+    "welcome.afternoon": string;
+    "welcome.evening": string;
     "empty.chat": string;
     "empty.projectQuestion": string;
     "empty.explore": string;
@@ -337,6 +344,9 @@ export declare const en: {
     "appearance.chatBackgroundErrorFailed": string;
     "appearance.chatBackgroundEmpty": string;
     "appearance.chatBackgroundShow": string;
+    "appearance.chatBackgroundTexture": string;
+    "appearance.chatBackgroundTextureNone": string;
+    "appearance.chatBackgroundTextureGrain": string;
     "appearance.chatBackgroundOpacityStep": string;
     "appearance.chatBackgroundFit": string;
     "appearance.chatBackgroundFitCover": string;
@@ -1123,14 +1133,11 @@ export declare const en: {
     "update.download": string;
     "update.downloadingPercent": string;
     "update.failed": string;
-    "update.goInstall": string;
     "update.newVersion": string;
     "update.pausedPercent": string;
     "update.preparing": string;
     "update.reading": string;
-    "update.readyInstaller": string;
     "update.readyRestart": string;
-    "update.reopenInstaller": string;
     "update.restartNow": string;
     "update.restartToUpdate": string;
     "update.resume": string;
@@ -1141,7 +1148,6 @@ export declare const en: {
     "updateDialog.downloadedSoFar": string;
     "updateDialog.downloading": string;
     "updateDialog.failedTitle": string;
-    "updateDialog.installerMissing": string;
     "updateDialog.notReady": string;
     "updateDialog.pause": string;
     "updateDialog.paused": string;
@@ -1387,6 +1393,7 @@ export declare const en: {
     "storage.exportDetail": string;
     "storage.exportDialogTitle": string;
     "storage.exportFailed": string;
+    "cleanup.failed": string;
     "storage.exportTitle": string;
     "storage.exported": string;
     "storage.exporting": string;

package/dist/client/ui/src/i18n/messages/zh-CN.d.ts

@@ -73,6 +73,7 @@ export declare const zhCN: {
     readonly "settings.models": "模型设置";
     readonly "settings.about": "关于";
     readonly "settings.personalization": "个性化";
+    readonly "settings.saveFailed": "设置没能保存：{reason}";
     readonly "settings.agents": "智能体";
     readonly "agents.title": "智能体";
     readonly "agents.intro": "把一类任务交给单独配置了模型、工具和指令的子智能体。";
@@ -159,6 +160,12 @@ export declare const zhCN: {
     readonly "projectList.projects": "项目";
     readonly "projectList.recent": "聊天";
     readonly "projectList.newLooseChat": "新对话（不在项目中）";
+    readonly "welcome.lateNight": "夜深了";
+    readonly "welcome.morning": "早上好";
+    readonly "welcome.forenoon": "上午好";
+    readonly "welcome.noon": "中午好";
+    readonly "welcome.afternoon": "下午好";
+    readonly "welcome.evening": "晚上好";
     readonly "empty.chat": "想聊点什么？";
     readonly "empty.projectQuestion": "要在 {project} 内开发什么？";
     readonly "empty.explore": "理解代码";
@@ -319,6 +326,9 @@ export declare const zhCN: {
     readonly "appearance.chatBackgroundErrorFailed": "图片导入失败，原背景图未改变。";
     readonly "appearance.chatBackgroundEmpty": "尚未设置背景图";
     readonly "appearance.chatBackgroundShow": "显示位置";
+    readonly "appearance.chatBackgroundTexture": "质感";
+    readonly "appearance.chatBackgroundTextureNone": "无";
+    readonly "appearance.chatBackgroundTextureGrain": "磨砂";
     readonly "appearance.chatBackgroundOpacityStep": "浓度 {percent}%";
     readonly "appearance.chatBackgroundFit": "铺放方式";
     readonly "appearance.chatBackgroundFitCover": "铺满";
@@ -471,7 +481,7 @@ export declare const zhCN: {
     readonly "market.unreadable": "{n} 个插件有问题，去设置里看看";
     readonly "market.notInCatalog": "插件目录里已经没有它了";
     readonly "market.unreachable": "连不上插件市场（{reason}），列出的是已装的和上次读到的";
-    readonly "market.localOwned": "这是本机直接放进目录的插件，到它的目录里删";
+    readonly "market.localOwned": "本地上传了同名的插件，先卸掉那一份";
     readonly "market.builtinOwned": "这是随应用发的插件，不能卸载、停用";
     readonly "market.notAPlugin": "这个文件夹不是构建好的插件：文件夹名只能用小写字母、数字和连字符，里面要有 dist/index.mjs";
     readonly "market.pickPluginFolder": "选择插件文件夹";
@@ -979,14 +989,11 @@ export declare const zhCN: {
     readonly "update.download": "下载安装";
     readonly "update.downloadingPercent": "下载中 {percent}%";
     readonly "update.failed": "下载失败";
-    readonly "update.goInstall": "去安装";
     readonly "update.newVersion": "新版本 {version}";
     readonly "update.pausedPercent": "已暂停 {percent}%";
     readonly "update.preparing": "准备中";
     readonly "update.reading": "正在读取版本…";
-    readonly "update.readyInstaller": "已下载完成，安装程序已经打开。按它的提示装完，再重新启动 Plume 就是新版本了。";
     readonly "update.readyRestart": "已下载完成。重启 Plume 即可用上新版本，正在进行的对话会中断。";
-    readonly "update.reopenInstaller": "重新打开安装包";
     readonly "update.restartNow": "立即重启";
     readonly "update.restartToUpdate": "重启更新";
     readonly "update.resume": "继续下载";
@@ -997,7 +1004,6 @@ export declare const zhCN: {
     readonly "updateDialog.downloadedSoFar": "（已下 {size}）";
     readonly "updateDialog.downloading": "正在下载";
     readonly "updateDialog.failedTitle": "这次没能写完";
-    readonly "updateDialog.installerMissing": "没找到下载好的安装包，重新下载一次";
     readonly "updateDialog.notReady": "更新没有准备好，重新下载一次再试";
     readonly "updateDialog.pause": "暂停";
     readonly "updateDialog.paused": "已暂停";
@@ -1207,6 +1213,7 @@ export declare const zhCN: {
     readonly "storage.exportDetail": "把所有会话另存为一个 SQLite 文件（.db），任何 SQLite 工具都能打开";
     readonly "storage.exportDialogTitle": "导出会话记录";
     readonly "storage.exportFailed": "导出失败：{reason}";
+    readonly "cleanup.failed": "清除失败：{reason}";
     readonly "storage.exportTitle": "导出会话记录";
     readonly "storage.exported": "已导出到 {path}";
     readonly "storage.exporting": "正在导出…";

package/dist/client/ui/src/index.d.ts

@@ -13,7 +13,6 @@ export type { MessageKey, ResolvedUiLocale } from "./i18n/messages/index.ts";
 export { activeLocale, translate } from "./i18n/translate.ts";
 export * from "./avatar/AgentAvatar.tsx";
 export * from "./avatar/AvatarPile.tsx";
-export * from "./avatar/AvatarStack.tsx";
 export * from "./avatar/art.ts";
 export * from "./fileIcon.tsx";
 export * from "./hooks/useCopied.ts";
@@ -53,10 +52,8 @@ export * from "./lib/hour-style.ts";
 export * from "./lib/number-draft.ts";
 export * from "./lib/relative-time.ts";
 export * from "./lib/tiling.ts";
-export * from "./lib/typing.ts";
 export * from "./motion/RollWords.tsx";
 export * from "./motion/RollingText.tsx";
-export * from "./motion/TypedText.tsx";
 export * from "./motion/freeze.ts";
 export * from "./motion/held.ts";
 export * from "./motion/loaders.tsx";
@@ -82,10 +79,8 @@ export * from "./primitives/Caret.tsx";
 export * from "./primitives/ChoiceMark.tsx";
 export * from "./primitives/ClosableTab.tsx";
 export * from "./primitives/CountUp.tsx";
-export * from "./primitives/GitHubMark.tsx";
 export * from "./primitives/IconButton.tsx";
 export * from "./primitives/MarkNumber.tsx";
-export * from "./primitives/RowDeleteButton.tsx";
 export * from "./primitives/Skeleton.tsx";
 export * from "./primitives/TabStrip.tsx";
 export * from "./primitives/Text.tsx";
@@ -126,15 +121,5 @@ export declare function Card({ title, subtitle, status, tone, children }: CardPr
 export declare function CodeBlock({ children }: {
     children: string;
 }): import("react").JSX.Element;
-type DiffLine = {
-    kind: "same" | "add" | "remove";
-    text: string;
-};
-/** 按行比较。用 LCS，够看小段改动；大文件的 diff 不在这里做。 */
-export declare function diffLines(before: string, after: string): DiffLine[];
-export declare function DiffView({ before, after }: {
-    before: string;
-    after: string;
-}): import("react").JSX.Element;
 export * from "./inputs/ColorField.tsx";
 export * from "./inputs/Slider.tsx";

package/dist/client/ui/src/inputs/TextArea.d.ts

@@ -17,14 +17,13 @@ import { type ComponentPropsWithoutRef } from "react";
  * 主输入框、消息编辑框这类框里还站着别的东西（工具栏、附件条、那排按钮）的不走这里，外壳是各自的。
  * 共享的是同一个 `useFieldFade` 和同一条遮罩。
  */
-export declare function TextArea({ value, onChange, shell, className, fieldRef, resizable, ...rest }: {
+export declare function TextArea({ value, onChange, shell, className, resizable, ...rest }: {
     value: string;
     onChange: (value: string) => void;
     /** 外壳上的额外类。高度、外边距、宽度——和这个框在页面上待在哪儿有关的事，调用方说了算。 */
     shell?: string;
     /** 字那一层的额外类：等宽、字号、`h-[180px]` 这类只跟可写区域有关的。 */
     className?: string;
-    fieldRef?: React.RefObject<HTMLTextAreaElement | null>;
     /** 能不能用鼠标拉高。只给写长文的地方，比如一份系统提示词。 */
     resizable?: boolean;
 } & Omit<ComponentPropsWithoutRef<"textarea">, "value" | "onChange" | "className" | "ref">): import("react").JSX.Element;

package/dist/client/ui/src/inputs/day-range.d.ts

@@ -53,5 +53,3 @@ export declare function isInterior(day: string, range: DayRange): boolean;
  * 前面」得到的是一段空范围，而且没有任何提示说刚才发生了什么。
  */
 export declare function pickDay(range: DayRange, day: string): DayRange;
-/** 这段日子有几天，两头都算。哪一头空着都数不出来。 */
-export declare function rangeLength(range: DayRange): number | null;

package/dist/client/ui/src/layout/RetainedViews.d.ts

@@ -1,19 +1,8 @@
 /** 留住少数几个看过的页面；藏起来的页面暂停 effect，保留局部状态。 */
-export declare function RetainedViews<T extends string>({ active, render, limit, pageClassName, slide, }: {
+export declare function RetainedViews<T extends string>({ active, render, limit }: {
     active: T;
     render: (key: T) => React.ReactNode;
     limit?: number;
-    /** 到达时的类。不同的页面可以换一种更长的淡入加升起。 */
-    pageClassName?: string;
-    /**
-     * 标签，按标签条上的顺序：每次切换，新页面从它所在的那一侧滑进来并淡入，而不是一帧之内换掉。
-     *
-     * 用 Web Animations API 在布局 effect 里播，不用类。用类的话——见下面 `seen` 的注释——从 `display: none`
-     * 回来的页面会先在终点画一帧，动画才接上。布局 effect 在页面显示之后、任何东西画出来之前跑，所以谁看到的
-     * 第一帧都已经是滑入的第一帧。回到一个页面也播：标签条是来回切的地方，只在第一次有动画的切换，第二次读起来
-     * 就像坏了。
-     */
-    slide?: readonly T[];
 }): import("react").JSX.Element;
 /**
  * 回来的那一页，里面的 CSS 动画不重演。
@@ -26,7 +15,7 @@ export declare function RetainedViews<T extends string>({ active, render, limit,
  * 跟着一起拆了），离开期间写完的回复要等回来、订阅重新挂上才补进来——那是紧跟着的另一次提交，
  * 当场处理会漏掉它，而它同样是在补账，不是此刻发生的事。两次提交都落在第一帧之前，逐帧量过。
  *
- * 页面自己那层（`pageClassName`）不算：那是换页本身的到达动画，每次换页都该有。转圈、呼吸这种
+ * 页面自己那层（`plume-page-enter`）不算：那是换页本身的到达动画，每次换页都该有。转圈、呼吸这种
  * 没有终点的照常跑——它们也没法跳到终点，`finish()` 会抛错。
  */
 export declare function finishReplayedAnimations(page: HTMLElement): void;

package/dist/client/ui/src/lib/tiling.d.ts

@@ -18,15 +18,6 @@ export interface Box {
     width: number;
     height: number;
 }
-/** 两棵树共有的形状：只要分支，叶子长什么样这里不关心。 */
-type Tiling = {
-    type: "leaf";
-} | {
-    type: "split";
-    dir: Axis;
-    sizes: readonly number[];
-    children: readonly Tiling[];
-};
 /**
  * 两个窗格之间一条能拖的边界。
  *
@@ -48,7 +39,6 @@ export interface SplitterBox extends Box {
      */
     split: Box;
 }
-export declare const FULL: Box;
 /**
  * 分隔条的抓取区，跨在两个窗格的边界上。
  *
@@ -67,16 +57,6 @@ export declare const GRIP_SPAN = 30;
  * 帧与帧之间字符串不变——这一点要紧：每帧都变的样式字符串会打断它本该在过渡的那个过渡。
  */
 export declare const pct: (fraction: number) => string;
-/** 给定在轴上从哪开始、占多少，从父框里切出孩子的框。 */
-export declare function slice(rect: Box, dir: Axis, offset: number, share: number): Box;
-/**
- * 所有能拖的边界。
- *
- * n 个孩子的分支有 n−1 条——分支的外沿是包着它的东西的边，不是两个窗格之间的边界。
- *
- * 每条都画成零厚度的线；抓取区由组件加，只有组件知道九个像素是多宽。
- */
-export declare function layoutSplitters(tree: Tiling, within?: Box): SplitterBox[];
 /**
  * 把指针位置换算成分隔条近侧窗格该占的份额。
  *
@@ -86,4 +66,3 @@ export declare function layoutSplitters(tree: Tiling, within?: Box): SplitterBox
  * `position` 是拖动轴上的客户区坐标：横向分支是 `clientX`，纵向是 `clientY`。
  */
 export declare function shareFromPointer(handle: SplitterBox, position: number, container: Box): number;
-export {};

package/dist/client/ui/src/motion/freeze.d.ts

@@ -19,4 +19,3 @@
  * 多少走的折叠组——这里只给它们加标记，样式引擎经类索引就能找到，不用遍历任何东西。
  */
 export declare function freezeMotion(): () => void;
-export declare function inertPanes(): () => void;

package/dist/client/ui/src/motion/loaders.d.ts

@@ -39,15 +39,10 @@ export declare function StatusSpinner({ size, className }: {
  *
  * 轨道是这个记号的重点，不是装饰：亮弧单独转的话，图形的轮廓跟着弧一起走，在按钮那个方寸
  * 之间会读成「有东西在里面甩」。垫一圈淡的，形状就恒定是一个完整的圆，动的只有亮处。
- *
- * 轨道浓度走 `--plume-track`，默认 0.18。实心底的按钮（`bg-ink`、`bg-accent`）上 `currentColor`
- * 是底色的反色，0.18 基本看不见，那几处传 `onFill`——见 `ui/motion.css` 里那一档的注释。
  */
-export declare function ActionSpinner({ size, className, onFill, }: {
+export declare function ActionSpinner({ size, className }: {
     size?: number;
     className?: string;
-    /** 画在实心底的按钮上（`bg-ink` / `bg-accent`），轨道要更浓才看得见。 */
-    onFill?: boolean;
 }): import("react").JSX.Element;
 /**
  * 一圈波纹离开静止的中心，颜色一路走过调色板。

package/dist/client/ui/src/overlay/Overlay.d.ts

@@ -7,10 +7,9 @@ export declare const OverlayDepth: import("react").Context<number>;
 /** 播完退场，再运行 `after`——没有别的要做时运行 `onClose`。 */
 export type Dismiss = (after?: () => void) => void;
 /** Escape、点遮罩、取消和完成共用一套生命周期，嵌套的对话框也一样。 */
-export declare function Overlay({ children, onClose, align, width, label, returnFocus, }: {
+export declare function Overlay({ children, onClose, width, label, returnFocus, }: {
     children: React.ReactNode | ((dismiss: Dismiss) => React.ReactNode);
     onClose: () => void;
-    align?: "center" | "bottom";
     width?: number;
     label?: string;
     returnFocus?: HTMLElement;

package/dist/client/ui/src/overlay/Tooltip.d.ts

@@ -1,7 +1,7 @@
 /**
  * 应用的悬停提示，写成 JSX 包装，比属性读起来顺。
  *
- * 它只给子元素打标记——气泡本身由 `tooltip.ts` 里那一个文档级监听器画。所以两种写法表现完全一样，
+ * 它只给子元素打标记——气泡本身由 `tooltip-attribute.ts` 里那一个文档级监听器画。所以两种写法表现完全一样，
  * 这很重要，因为第三方库自己建的按钮只能靠属性够到。
  *
  * 取代浏览器的 `title`：那个改不了样式，要等一秒半左右，不跟应用的字体和主题，在 macOS 上画成一个

package/dist/client/ui/src/primitives/ClosableTab.d.ts

@@ -9,7 +9,7 @@ import type { DataAttributes } from "./Button.tsx";
  * ✕ 只出现在指着的那个和当前那个标签上。每个标签都带一个的话，三个标签的一条就成了六个目标，关闭
  * 按钮和名字一样响——而这一条的全部用处就是让人按名字挑。
  */
-export declare function ClosableTab({ children, current, onSelect, onClose, closeLabel, tip, onContextMenu, className, labelClassName, ...data }: DataAttributes & {
+export declare function ClosableTab({ children, current, onSelect, onClose, closeLabel, tip, onContextMenu, className, ...data }: DataAttributes & {
     children: ReactNode;
     current: boolean;
     onSelect: () => void;
@@ -19,5 +19,4 @@ export declare function ClosableTab({ children, current, onSelect, onClose, clos
     tip?: string;
     onContextMenu?: (event: MouseEvent<HTMLDivElement>) => void;
     className?: string;
-    labelClassName?: string;
 }): import("react").JSX.Element;

package/dist/client/ui/src/primitives/CountUp.d.ts

@@ -11,11 +11,8 @@
  */
 export declare function CountUp({ value, className, 
 /** 走动中的数怎么写。默认是四舍五入的整数。 */
-format, bidirectional, ms, ...rest }: {
+format, ...rest }: {
     value: number;
     className?: string;
     format?: (shown: number) => string;
-    /** 往下也走——见 `useCountUp`。给按更短的时段重算的读数。 */
-    bidirectional?: boolean;
-    ms?: number;
 } & Omit<React.ComponentProps<"span">, "className" | "children">): import("react").JSX.Element;

package/dist/contract/src/plugin.d.ts

@@ -297,13 +297,9 @@ export interface ModelContext {
     readOnly?: boolean;
     /** 设置 › 个性化：语气和全局指令。 */
     personalization: Personalization;
-    /** 发出去的系统提示词，就是 `sections` 依次用空行连起来。 */
+    /** 发出去的系统提示词，就是 `sections` 依次用空行连起来。只读：每层交接时宿主按 `sections` 重拼，改它不作数。 */
     systemPrompt: string;
-    /**
-     * 系统提示词按段拆开。改哪个都行，交给下一层时宿主把另一个跟上：只改了 `sections`，`systemPrompt` 重新拼；
-     * 只改了 `systemPrompt` 而且是在后面接了一段，接上的那段成为末尾的 `extension` 段，整个换掉则只剩这一段 `extension`。
-     * 两个都改了以 `sections` 为准。
-     */
+    /** 系统提示词按段拆开。加、换、删都改这里，交给下一层时宿主把 `systemPrompt` 重新拼。 */
     sections: PromptSection[];
     messages: Message[];
     tools: ToolSpec[];
@@ -473,16 +469,16 @@ export interface ToolResultView {
 }
 /**
  * 钩子 context.compact 的结论：不给是不压。最里层不压。
- * 给了 `keep`，`history` 里从 `keep` 起原样留着，之前的（含上一次压缩换上的那几条）换成 `head`；不给 `head` 就是 `summary`
- * 加一句确认。`keep` 要落在上一次换上的那几条之后、最后一条之前，而且不能是工具结果（会和它回答的调用拆开）；`summary`
- * 只在按条丢弃（`via: "dropped"`，这时必须给 `head`）时可以是空串；不合规矩的宿主当作压缩失败。
+ * 给了 `keep`，`history` 里从 `keep` 起原样留着，之前的（含上一次压缩换上的那几条）换成 `head`。
+ * `keep` 要落在上一次换上的那几条之后、最后一条之前，而且不能是工具结果（会和它回答的调用拆开）；`summary`
+ * 只在按条丢弃（`via: "dropped"`）时可以是空串；不合规矩的宿主当作压缩失败。
  * `views` 是留下的那截里剪过的工具结果。只剪了工具结果、没有可摘要的（`pruneOnly`）时只给 `views`。
  */
 export type CompactSummary = {
     keep: number;
     summary: string;
     /** 代替边界之前那段的消息（以用户消息开头），宿主原样存下、以后每次照发。 */
-    head?: Message[];
+    head: Message[];
     via?: CompactionVia;
     views?: ToolResultView[];
 } | {
@@ -1040,10 +1036,15 @@ export type WebPageEvent = {
     url: string;
     redirect: boolean;
 }
-/** 页面要开新窗口（`window.open`、`target=_blank`）：宿主不开，交给插件决定。 */
+/**
+ * 页面要开新窗口（`window.open`、`target=_blank`）：宿主不开，交给插件决定。`window` 是脚本按尺寸开的小窗（第三方登录、
+ * 支付）：宿主已经把它开成挂在 Plume 窗口上的小窗口，和开它的页面连着（登录完经 `window.opener` 交回结果、自己关掉），
+ * 插件不用再开；它给人用，插件驱动不了。
+ */
  | {
     type: "popup";
     url: string;
+    window?: true;
 }
 /**
  * 宿主照 `answerDialogs` 替人答了页面的一个对话框。`beforeunload` 是离开页面的提示，没有文字；答 false 时留在原页，
@@ -1088,6 +1089,24 @@ export interface WebInspection {
         mimeType: "image/png";
     };
 }
+/** 从本机 Chrome 同步登录状态的现状，见 `WebPages.chromeLogins`。 */
+export interface ChromeLoginSync {
+    /** 开着：应用启动时同步一次，之后 Chrome 的 cookie 一变就跟着同步。 */
+    enabled: boolean;
+    /**
+     * 同步不了的原因：`unsupported` 这个系统还不支持（目前只有 macOS），`no-chrome` 没找到 Chrome 的数据，
+     * `no-access` 系统不让读（macOS 要在「隐私与安全性 › 完全磁盘访问权限」里给 Plume），`keychain-denied` 钥匙串里的 Chrome 密钥没拿到，
+     * `failed` 别的原因（`detail` 里是给人看的说明）。
+     */
+    problem?: "unsupported" | "no-chrome" | "no-access" | "keychain-denied" | "failed";
+    detail?: string;
+    /** 从哪个 Chrome 用户同步（Chrome 里显示的名字）。 */
+    profile?: string;
+    /** 上次同步时 Chrome 里有多少条能用的 cookie。 */
+    cookies?: number;
+    /** 上次成功同步的时间（毫秒）。 */
+    syncedAt?: number;
+}
 /**
  * 网页：插件界面入口自己画的 `<webview>`，各自一个进程，逻辑入口经这里驱动它。页面只有主进程碰得到，所以加载、执行脚本、
  * 原生输入、截图、缩放和视口、开发者工具、对话框由宿主做；标签、地址栏、给模型的工具都是插件自己的。
@@ -1167,6 +1186,12 @@ export interface WebPages {
      * 设上时，已经弹着、等人点的那一个也当场按它答掉。每答一个报一条 `dialog` 事件。`prompt` 不在其中：页面调用时直接拿到 null。
      */
     answerDialogs(id: string, accept: boolean | null): Promise<void>;
+    /**
+     * 从本机 Chrome 同步登录状态（全部 cookie，单向：同一条以 Chrome 为准，Chrome 里没了这边也删）进网页的分区，各插件共用。
+     * `status` 看现状；`on` 先由宿主弹系统对话框请人确认，人不同意就照旧关着；`off` 关掉并删掉同步进来的 cookie。
+     * cookie 的值只在主进程里，不交给插件。
+     */
+    chromeLogins(command: "status" | "on" | "off"): Promise<ChromeLoginSync>;
     /** 订阅本插件全部网页的事件，返回取消订阅的函数；停用时自动撤下。 */
     onEvent(listener: (event: WebPageEvent) => void): () => void;
 }
@@ -1364,7 +1389,7 @@ export interface SandboxProcess {
     /** 连它起的子进程一起停。 */
     kill(signal?: "SIGTERM" | "SIGKILL"): void;
 }
-/** 服务 `sandbox`：在沙箱里跑 shell 命令。内置插件 plume.sandbox 提供（macOS 用 seatbelt，Linux 用 bubblewrap，Windows 用受限令牌）。 */
+/** 服务 `sandbox`：在沙箱里跑 shell 命令。内置插件 plume.sandbox 提供（macOS 用 seatbelt，Windows 用受限令牌；Linux 没有后端）。 */
 export interface SandboxService {
     /**
      * 用用户的 shell 起一条命令，环境向登录 shell 要（从图标启动时也找得到用户装的工具）。`mode` 不给就不进沙箱；

package/dist/contract/src/service.d.ts

@@ -468,11 +468,15 @@ export type AgentEvent = {
     type: "projects";
     projects: ProjectEntry[];
 }
-/** 一条消息写进了会话。回复（assistant）同时顶替正在写的草稿，不另发清空草稿的 draft 事件。 */
+/**
+ * 一条消息写进了会话，`count` 是写进它以后的条数（它是第 `count - 1` 条）。回复（assistant）同时顶替正在写的草稿，不另发清空草稿的 draft 事件。
+ * 按位置放而不是接在末尾：界面拿快照接上事件流时会把快照里已有的几条再收一遍，放回原位就不会重复。
+ */
  | {
     type: "message";
     sessionId: string;
     message: Message;
+    count: number;
 }
 /** 会话截掉了尾巴（撤回、编辑重发）：只留前 `count` 条消息，压缩记录和压缩行换成留下的那些。 */
  | {
@@ -692,16 +696,21 @@ export interface AgentService {
      * 正在跑时报错。图片块可以只带 `media`（会话里存着的那张），不用把像素再传一遍。
      * `files` 为真时先把截掉的那段改过的文件退回去（钩子 session.rewind），退不回去就报错，对话不截、也不重发。
      * 插件的子会话也能编辑重发（插件经 `ConversationProps.reask` 同意了），但不带 `files`；撤回、演算、分叉仍然只给人自己的会话。
+     * `timestamp` 是界面上那一条的时间戳：序号对不上时按它认回那一条，认不出就报错，不截错地方。
      */
     editMessage(sessionId: string, index: number, message: OutgoingMessage, options?: {
         files?: boolean;
+        timestamp?: number;
     }): Promise<void>;
-    /** 撤回：第 `index` 条（人发的消息）连同它之后的全部截掉。正在跑时报错。`files` 同 `editMessage`。 */
+    /** 撤回：第 `index` 条（人发的消息）连同它之后的全部截掉。正在跑时报错。`files`、`timestamp` 同 `editMessage`。 */
     revertMessage(sessionId: string, index: number, options?: {
         files?: boolean;
+        timestamp?: number;
     }): Promise<void>;
-    /** 撤回、编辑重发第 `index` 条会截掉的那段改过哪些文件、能不能一起退回，只演算，不写（钩子 session.rewind）。 */
-    revertPlan(sessionId: string, index: number): Promise<RevertPlan>;
+    /** 撤回、编辑重发第 `index` 条会截掉的那段改过哪些文件、能不能一起退回，只演算，不写（钩子 session.rewind）。`timestamp` 同 `editMessage`。 */
+    revertPlan(sessionId: string, index: number, options?: {
+        timestamp?: number;
+    }): Promise<RevertPlan>;
     /**
      * 从第 `index` 条分叉出一个新会话，原会话不动。人发的消息：新会话停在它之前；落定的回复：新会话带着它。
      * `timestamp` 用来核对是不是那一条，对不上时按时间戳重找。正在跑也可以分叉。
@@ -726,8 +735,6 @@ export interface AgentService {
         origin?: string;
     })[]>;
     listDirectory(sessionId: string, path: string): Promise<FileEntry[]>;
-    /** 在原目录中改名；不覆盖同名目标，不改会话根目录。 */
-    renameFile(sessionId: string, path: string, name: string): Promise<string>;
     /**
      * 在会话工作目录里找一个写得不全的路径：裸文件名（`approvals.ts`）或相对于某个子目录的路径。
      * 返回找到的绝对路径，按路径排好；跳过依赖和构建产物目录。

package/dist/contract/src/ui.d.ts

@@ -146,7 +146,7 @@ export interface PageOptions {
  * 前四个是种子：背景、前景、强调色、对比度（0–1，默认 0.6）。其余的面、线、字都由种子推出来，
  * 皮肤通常只改种子；推出来的哪一档不满意，再单独覆盖那一档。
  */
-export type SkinToken = "bg" | "fg" | "accent" | "contrast" | "shell" | "root" | "accent-dim" | "sidebar" | "card" | "card-hover" | "elevated" | "input" | "float" | "knob" | "shade" | "window-tint" | "line" | "line-soft" | "line-float" | "ink" | "ink-muted" | "ink-faint" | "ok" | "danger" | "warning" | "violet" | "chart-2" | "chart-3" | "chart-4" | "chart-5" | "chart-6" | "on-accent" | "code-bg" | "code-fg" | "code-line-height" | "code-tracking" | "inline-code-bg" | "inline-code-fg" | "inline-code-ring" | "syntax-operator" | "diff-add" | "diff-remove" | "syntax-keyword" | "syntax-string" | "syntax-number" | "syntax-comment" | "syntax-function" | "syntax-type" | "syntax-variable" | "syntax-punctuation" | "syntax-tag" | "syntax-attribute" | "radius-panel" | "radius-field" | "radius-item" | "radius-menu" | "font-sans" | "font-mono" | "ui-size" | "code-size";
+export type SkinToken = "bg" | "fg" | "accent" | "contrast" | "shell" | "root" | "root-image" | "accent-dim" | "sidebar" | "card" | "card-hover" | "elevated" | "input" | "float" | "knob" | "shade" | "window-tint" | "line" | "line-soft" | "line-float" | "ink" | "ink-muted" | "ink-faint" | "ok" | "danger" | "warning" | "violet" | "chart-2" | "chart-3" | "chart-4" | "chart-5" | "chart-6" | "on-accent" | "code-bg" | "code-fg" | "code-line-height" | "code-tracking" | "inline-code-bg" | "inline-code-fg" | "inline-code-ring" | "syntax-operator" | "diff-add" | "diff-remove" | "syntax-keyword" | "syntax-string" | "syntax-number" | "syntax-comment" | "syntax-function" | "syntax-type" | "syntax-variable" | "syntax-punctuation" | "syntax-tag" | "syntax-attribute" | "radius-panel" | "radius-field" | "radius-item" | "radius-menu" | "font-sans" | "font-mono" | "ui-size" | "code-size";
 /**
  * 插件给产品显示的一段字：固定的字符串，或者按当前界面语言给出的函数。
  * 用函数而不是每种语言一份，界面加一种语言时插件的写法不用变；没翻译的语言由插件自己决定退回哪一种。
@@ -709,6 +709,12 @@ export interface SessionChange {
     type: "messages" | "summary" | "deleted";
     tools?: string[];
 }
+/** 欢迎页问候下面那一行（`ui.welcomeLine`）：一句话，可以带出处。 */
+export interface WelcomeLine {
+    text: string;
+    /** 出处（人名、书名），跟在这句话后面，小一号、更淡。 */
+    source?: string;
+}
 /** 插件在 `@` 菜单里提供的一项，选中只插入 token，不会自动发送。 */
 export interface ComposerMention {
     id: string;
@@ -875,6 +881,11 @@ export interface UiContext {
         sessionId?: string;
     }) => ComposerMention[] | Promise<ComposerMention[]>): void;
     composerHint(hint: (session: SessionView) => string | undefined): void;
+    /**
+     * 换掉欢迎页问候下面的那一行（默认是「要在某个项目里开发什么？」）：宿主每次画欢迎页时按界面语言问一次，等答复时那一行先空着，
+     * 回来了再淡入。只问最后注册的那一个；返回 undefined、空串或抛错时显示默认的那一句。一个插件只能有一个，再注册换掉上一个。
+     */
+    welcomeLine(line: (locale: Locale) => WelcomeLine | undefined | PromiseLike<WelcomeLine | undefined>): void;
     /**
      * 画回复的正文、复制回复之前，把字过一遍：插件让模型在回复里顺带写的标记（下一步建议的 `:followup[…]`）从这里拿掉。
      * 只改显示和复制，会话里存的、下一轮发给模型的都不变。正在生成的回复也会过，写了一半的标记也该拿掉。
@@ -1044,7 +1055,7 @@ export interface UiContext {
     }): Promise<ListedCommand[]>;
     /** 产品的对话视图，见 `ConversationProps`。 */
     readonly Conversation: ComponentType<ConversationProps>;
-    /** 产品的会话背景设置：选图、拖入图片、预览、铺放、效果、浓淡和显示位置；外观页不再有这一节，背景只经它设置。 */
+    /** 产品的会话背景设置：选图、拖入图片、预览、铺放、效果、浓淡、显示位置，以及整个窗口的磨砂质感（不看皮肤、不要图）；外观页不再有这一节，背景只经它设置。 */
     readonly ChatBackgroundSettings: ComponentType<{
         title?: string;
     }>;

package/dist/infra/rpc/src/endpoint.d.ts

@@ -8,7 +8,7 @@
 import { type RpcChannel } from "./rpc.ts";
 /** 被调方法收到的最后一个参数。 */
 export interface CallContext {
-    /** 调用方取消、超时或通道关闭时中止。 */
+    /** 调用方取消或通道关闭时中止。 */
     signal: AbortSignal;
 }
 /**

package/dist/infra/rpc/src/rpc.d.ts

@@ -3,7 +3,7 @@
  * 所以 utilityProcess 的 parentPort、渲染进程的 MessagePort、测试里的内存管道都能用同一套。
  * 不依赖任何第三方库：它会被打进渲染进程。
  */
-export type ErrorCode = "E_NOT_FOUND" | "E_TIMEOUT" | "E_CANCELLED" | "E_CLOSED" | "E_HANDLER";
+export type ErrorCode = "E_NOT_FOUND" | "E_CANCELLED" | "E_CLOSED" | "E_HANDLER";
 export interface Port {
     post(message: unknown): void;
     /** 返回取消监听的函数。 */
@@ -15,8 +15,6 @@ export declare class RpcError extends Error {
 }
 export declare function toRpcError(error: unknown, fallback?: ErrorCode): RpcError;
 export interface RequestOptions {
-    /** 不填表示不限时。 */
-    timeoutMs?: number;
     /** 中止时向对端发取消，本地以 E_CANCELLED 失败。 */
     signal?: AbortSignal;
     /** 收到中间值时调用。 */
@@ -24,14 +22,13 @@ export interface RequestOptions {
 }
 /** 处理方看到的这次调用。 */
 export interface IncomingCall {
-    /** 发起方取消、超时或通道关闭时中止。 */
+    /** 发起方取消或通道关闭时中止。 */
     signal: AbortSignal;
     /** 推送一个中间值给发起方。 */
     emit(value: unknown): void;
 }
 export interface RpcHandlers {
     request?(payload: unknown, call: IncomingCall): unknown;
-    note?(payload: unknown): void;
 }
 export declare class RpcChannel {
     private readonly port;
@@ -43,9 +40,7 @@ export declare class RpcChannel {
     private closedWith;
     constructor(port: Port, handlers?: RpcHandlers);
     setHandlers(handlers: RpcHandlers): void;
-    get closed(): boolean;
     request(payload: unknown, options?: RequestOptions): Promise<unknown>;
-    notify(payload: unknown): void;
     /** 关闭通道：挂起的请求全部以 E_CLOSED 失败，正在处理的请求被中止，之后的收发都被忽略。 */
     close(reason?: string): void;
     private settle;

package/dist/theme.css

@@ -42,6 +42,8 @@
 	--plume-shell: var(--plume-bg);
 	/* 窗口最外层，数据皮肤可将它与正文区分开。 */
 	--plume-root: var(--plume-shell);
+	/* 盖在 root 上的底纹（CSS 图像，可以是逗号分隔的几层，如渐变），只在数据皮肤接管配色时铺；缺省没有。 */
+	--plume-root-image: none;
 	/* 强调色弱底；数据皮肤可直接指定，不再从强调色透明度推导。 */
 	--plume-accent-dim: color-mix(in srgb, var(--plume-accent) 10%, transparent);
 	--plume-sidebar: color-mix(in srgb, var(--plume-fg) calc(4.2% * var(--plume-k) * var(--plume-k-surface)), var(--plume-bg));
@@ -287,7 +289,7 @@
 	--font-mono: var(--plume-font-mono);
 
 	/*
-	 * 字号七档加代码一档，都是界面字号的 calc，改一个数整套一起动。档与档至少差 1px，各自带行高和字距：
+	 * 字号八档加代码一档，都是界面字号的 calc，改一个数整套一起动。档与档至少差 1px，各自带行高和字距：
 	 * 字越大字距越紧。字重不放进档里，和字号配对写在用的地方（title 用 medium，heading、display 用 semibold）。
 	 */
 	--text-caption: calc(var(--plume-ui-size) - 2px);
@@ -309,6 +311,10 @@
 	--text-display: calc(var(--plume-ui-size) + 16px);
 	--text-display--line-height: 1.2;
 	--text-display--letter-spacing: -0.022em;
+	/* 只给欢迎页的问候：整页只有这一行字，比设置页的标题还大一档；配 font-medium，大字不再加粗。 */
+	--text-hero: calc(var(--plume-ui-size) + 22px);
+	--text-hero--line-height: 1.15;
+	--text-hero--letter-spacing: -0.025em;
 	/* 代码另起一档：另一种字体，按列读；行高 1.6 比正文紧，缩进和括号的形状不被拉散。 */
 	--text-code: var(--plume-code-size);
 	--text-code--line-height: var(--plume-code-line-height);

package/dist/ui.d.ts

@@ -1,2 +1,2 @@
 /** @plume/ui 对插件开放的部分：packages/client/ui/plugin-api.json 里的名字。由 scripts/build-types.mjs 生成。 */
-export { Text, Button, IconButton, Input, Textarea, TextArea, Select, InlineSelect, Toggle, ComposerToggle, WorktreeToggle, Segmented, TabStrip, SearchField, NumberField, Slider, ColorField, TimeField, ShortcutRecorder, useFieldFade, ChoiceMark, Popover, ContextMenu, MenuItem, MenuSeparator, MenuLabel, Dialog, DialogAction, Confirm, useConfirmer, useConfirmGate, Tooltip, usePopover, MenuBody, MenuSearch, MENU_MAX_HEIGHT, Overlay, Card, CodeBlock, DiffView, ApprovalFrame, ApprovalExpiry, SettingsSectionTitle, SettingsCard, SettingsRow, SettingsNotice, PanelEmpty, RetainedViews, useNarrow, useLiveRefresh, PageTopRow, ActionSpinner, BreatheLoader, SkeletonList, SkeletonBar, useSlowLoad, HoverRow, HoverRowMark, HoverRowReveal, hoverSlot, Caret, MarkNumber, FlowRow, lookFor, iconColour, Scroller, OverlayScrollbar, ScrollText, Sideways, useI18n, relativeTime, TimeAgo, macKeyboard, composingKey, shortcutLetter, shortcutLabel, acceleratorLabel, motionReduced, CountUp, useRolled, RollingText, useNow, Collapse, Disclosure, AgentAvatar, AvatarPile, assignAvatars, AVATAR_SHAPES, AVATAR_COLORS, COLOR_ART, parseAvatar, formatAvatar, freshAvatar, withHanFallback, useAnnotator, AnnotateCanvas, AnnotateToolbar, useToolbarPlacement, HANDLES, HANDLE_CURSOR, handlePoint, hitHandle, insideRect, rectFromPoints, resizeRect, moveRect, clampRect } from "./client/ui/src/index.d.ts";
+export { Text, Button, IconButton, Input, Textarea, TextArea, Select, InlineSelect, Toggle, ComposerToggle, WorktreeToggle, Segmented, TabStrip, SearchField, NumberField, Slider, ColorField, TimeField, ShortcutRecorder, useFieldFade, ChoiceMark, Popover, ContextMenu, MenuItem, MenuSeparator, MenuLabel, Dialog, DialogAction, Confirm, useConfirmer, useConfirmGate, Tooltip, usePopover, MenuBody, MenuSearch, MENU_MAX_HEIGHT, Overlay, Card, CodeBlock, ApprovalFrame, ApprovalExpiry, SettingsSectionTitle, SettingsCard, SettingsRow, SettingsNotice, PanelEmpty, RetainedViews, useNarrow, useLiveRefresh, PageTopRow, ActionSpinner, BreatheLoader, SkeletonList, SkeletonBar, useSlowLoad, HoverRow, HoverRowMark, HoverRowReveal, hoverSlot, Caret, MarkNumber, FlowRow, lookFor, iconColour, Scroller, OverlayScrollbar, ScrollText, Sideways, useI18n, relativeTime, TimeAgo, macKeyboard, composingKey, shortcutLetter, shortcutLabel, acceleratorLabel, motionReduced, CountUp, useRolled, RollingText, useNow, Collapse, Disclosure, AgentAvatar, AvatarPile, assignAvatars, AVATAR_SHAPES, AVATAR_COLORS, COLOR_ART, parseAvatar, formatAvatar, freshAvatar, withHanFallback, useAnnotator, AnnotateCanvas, AnnotateToolbar, useToolbarPlacement, HANDLES, HANDLE_CURSOR, handlePoint, hitHandle, insideRect, rectFromPoints, resizeRect, moveRect, clampRect } from "./client/ui/src/index.d.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumeai/plugin-sdk",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "写 Plume 插件用的类型、命令（新建、检查、构建、安装）、插件模板和给 agent 的 skill。随 Plume 应用带一份，也发在 npm 上（插件仓库按版本依赖）。",
   "license": "MIT",
   "repository": {

package/skill/SKILL.md

@@ -46,7 +46,7 @@ description: 写、改、排查 Plume 插件：工具、钩子（tool.execute、
 - 在最新结束的回复下面画卡片（`ui.turnFooter`），随转录滚走，新一轮开始就撤下；每一轮回复底下的操作排里加按钮（`ui.replyAction`）；复用产品的高亮差异（`ui.FileDiff`）、文件预览（`ui.FilePreview`）、统一只读文档预览（`ui.DocumentPreview`；经 `ui.documentViewer` 按扩展名注册，读取与权限仍由调用方负责）、文件右键菜单（`ui.useFileMenu`），经 `ui.openFile` 打开指定会话工作目录内的文件。
 - 用 `ui.codeBlock(language, Component)` 接管助手正文的某种围栏代码块；解析、具体 UI、状态和使用说明都归插件，收到原文、会话/消息/块标识、流式与完成状态；可选 `copyText` 在复制回复时提供当前可见值的文字。解析失败返回 `fallback`；宿主在渲染失败或停用时回到源码。完整块里真实点击后可经 `send(text, event)` 回到所属会话，不能在渲染或计时器中发送。
 - 用 `ui.mentions` 给 `@` 菜单提供当前目录可用的智能体或技能引用；选中只插入 token，不自动发送。页面角标 `ui.pageBadge` 可带 `attention: true` 同时进入通知菜单。
-- 给输入框一句灰字建议，人按 Tab 填进去（`ui.composerHint`）；画回复前拿掉插件让模型顺带写的标记（`ui.replyText`，只改显示和复制）；改会话标题（`ctx.sessions.setTitle`）。
+- 给输入框一句灰字建议，人按 Tab 填进去（`ui.composerHint`）；换掉欢迎页问候下面的那一行（`ui.welcomeLine`）；画回复前拿掉插件让模型顺带写的标记（`ui.replyText`，只改显示和复制）；改会话标题（`ctx.sessions.setTitle`）。
 - 用设置里的生图模型画图、改图（`ctx.model.findImageModel`、`ctx.model.image`），图存进会话媒体目录（`ctx.media`）；界面入口显示（`ui.mediaUrl`）、用产品的看图器看和标注（`ui.openImage`），另存、复制（`ui.saveImage`、`ui.copyImage`），把图带回某个会话的输入框（`ui.draftInSession`），跳到某次工具调用的卡片（`ui.revealToolCall`）；媒体图可在文件面板打开或在系统文件管理器定位（`ui.openMediaFile`、`ui.revealMediaFile`，菜单名取 `ui.revealMediaLabel()`）。
 - 侧栏会话行首空闲时画自己的记号（`ui.sessionMark`）；删除确认框里补一句会连带、会留下什么（`ui.deleteNote`）；人点了按钮时归档会话（`ctx.sessions.setArchived`）；模型照人的要求归档它所在的对话时，工具那次调用经 `run.archiveAfterTurn()` 交给本体，这一轮以完成收场后才归档（只有顶层会话有）。
 - 弹提示条（界面入口 `ui.notify`，逻辑入口 `ctx.notice`）、打开、关闭自己的面板（`ui.openPanel`、`ui.closePanel`）、把一段话写进输入框等人自己发（`ui.draftInSession`，`replace` 时整段换掉），或在项目签那一行的格子里，人点了写明要发什么的按钮时以人的身份直接发（`send`）；逻辑入口用默认模型做一次性的小调用（`ctx.model.complete`）、读会话（`ctx.sessions`）、读模型调用的花销（`ctx.model.usage`）。一次性结果要覆盖持久化内容时用 `ModelCompletion.requireComplete` 拒收截断结果；经 `ctx.sessions.onContextReset` 在压缩、撤回或上下文来源变化时作废自己的缓存。
@@ -76,7 +76,7 @@ description: 写、改、排查 Plume 插件：工具、钩子（tool.execute、
 4. **界面入口**（要画东西时）：读 [references/ui.md](references/ui.md)。
 5. **样式和文案**（有界面或给人看的文字时）：读 [references/style-i18n.md](references/style-i18n.md)。
 6. **构建和加载**：
-   - 独立项目：`plume-plugin dev` 构建、装进 `~/.plume/local-plugins/<目录名>/`（和市场装的同名时这一份生效，不被市场更新换掉，卸掉就回到市场那份），之后一改源码就重新构建、装上；Plume 开着的话每次都当场加载，不用重启。只装一次用 `plume-plugin build` 再 `plume-plugin install`。也可以把插件的上级目录放进环境变量 `PLUME_PLUGIN_PATHS`，Plume 同样盯着那里。
+   - 独立项目：`plume-plugin dev` 构建、装进 `~/.plume/local-plugins/<目录名>/`（和市场装的同名时这一份生效，不被市场更新换掉，卸掉就回到市场那份），之后一改源码就重新构建、装上；Plume 开着的话每次都当场加载，不用重启。只装一次用 `plume-plugin build` 再 `plume-plugin install`。
    - Plume 的插件仓库里（`plugins/<目录名>`）：`pnpm plugin dev plugins/<目录名>`，和独立项目一样构建、装进本机的 Plume。
 7. **自检**：对照文末清单，再跑检查（独立项目 `plume-plugin check`：类型检查加插件规则；仓库里 `pnpm check`）。
 

package/skill/references/components.md

@@ -265,7 +265,6 @@ export function TextArea({
 	onChange,
 	shell = "",
 	className = "",
-	fieldRef,
 	resizable = false,
 	...rest
 }: {
@@ -275,7 +274,6 @@ export function TextArea({
 	shell?: string;
 	/** 字那一层的额外类：等宽、字号、`h-[180px]` 这类只跟可写区域有关的。 */
 	className?: string;
-	fieldRef?: React.RefObject<HTMLTextAreaElement | null>;
 	/** 能不能用鼠标拉高。只给写长文的地方，比如一份系统提示词。 */
 	resizable?: boolean;
 } & Omit<ComponentPropsWithoutRef<"textarea">, "value" | "onChange" | "className" | "ref">)
@@ -978,7 +976,7 @@ export function useConfirmGate()
 /**
  * 应用的悬停提示，写成 JSX 包装，比属性读起来顺。
  *
- * 它只给子元素打标记——气泡本身由 `tooltip.ts` 里那一个文档级监听器画。所以两种写法表现完全一样，
+ * 它只给子元素打标记——气泡本身由 `tooltip-attribute.ts` 里那一个文档级监听器画。所以两种写法表现完全一样，
  * 这很重要，因为第三方库自己建的按钮只能靠属性够到。
  *
  * 取代浏览器的 `title`：那个改不了样式，要等一秒半左右，不跟应用的字体和主题，在 macOS 上画成一个
@@ -1071,14 +1069,12 @@ export const MENU_MAX_HEIGHT = 340;
 export function Overlay({
 	children,
 	onClose,
-	align = "center",
 	width = 460,
 	label,
 	returnFocus,
 }: {
 	children: React.ReactNode | ((dismiss: Dismiss) => React.ReactNode);
 	onClose: () => void;
-	align?: "center" | "bottom";
 	width?: number;
 	label?: string;
 	returnFocus?: HTMLElement;
@@ -1115,14 +1111,6 @@ export interface CardProps {
 export function CodeBlock({ children }: { children: string })
 ```
 
-### `DiffView`
-
-源码：`packages/client/ui/src/index.tsx`
-
-```tsx
-export function DiffView({ before, after }: { before: string; after: string })
-```
-
 ## 审批卡
 
 ### `ApprovalFrame`
@@ -1276,28 +1264,7 @@ export function PanelEmpty({
 
 ```tsx
 /** 留住少数几个看过的页面；藏起来的页面暂停 effect，保留局部状态。 */
-export function RetainedViews<T extends string>({
-	active,
-	render,
-	limit = 3,
-	pageClassName = "plume-page-enter",
-	slide,
-}: {
-	active: T;
-	render: (key: T) => React.ReactNode;
-	limit?: number;
-	/** 到达时的类。不同的页面可以换一种更长的淡入加升起。 */
-	pageClassName?: string;
-	/**
-	 * 标签，按标签条上的顺序：每次切换，新页面从它所在的那一侧滑进来并淡入，而不是一帧之内换掉。
-	 *
-	 * 用 Web Animations API 在布局 effect 里播，不用类。用类的话——见下面 `seen` 的注释——从 `display: none`
-	 * 回来的页面会先在终点画一帧，动画才接上。布局 effect 在页面显示之后、任何东西画出来之前跑，所以谁看到的
-	 * 第一帧都已经是滑入的第一帧。回到一个页面也播：标签条是来回切的地方，只在第一次有动画的切换，第二次读起来
-	 * 就像坏了。
-	 */
-	slide?: readonly T[];
-})
+export function RetainedViews<T extends string>({ active, render, limit = 3 }: { active: T; render: (key: T) => React.ReactNode; limit?: number })
 ```
 
 ### `useNarrow`
@@ -1370,20 +1337,8 @@ export function PageTopRow({
  *
  * 轨道是这个记号的重点，不是装饰：亮弧单独转的话，图形的轮廓跟着弧一起走，在按钮那个方寸
  * 之间会读成「有东西在里面甩」。垫一圈淡的，形状就恒定是一个完整的圆，动的只有亮处。
- *
- * 轨道浓度走 `--plume-track`，默认 0.18。实心底的按钮（`bg-ink`、`bg-accent`）上 `currentColor`
- * 是底色的反色，0.18 基本看不见，那几处传 `onFill`——见 `ui/motion.css` 里那一档的注释。
  */
-export function ActionSpinner({
-	size = 14,
-	className = "",
-	onFill = false,
-}: {
-	size?: number;
-	className?: string;
-	/** 画在实心底的按钮上（`bg-ink` / `bg-accent`），轨道要更浓才看得见。 */
-	onFill?: boolean;
-})
+export function ActionSpinner({ size = 14, className = "" }: { size?: number; className?: string })
 ```
 
 ### `BreatheLoader`
@@ -1871,16 +1826,11 @@ export function CountUp({
 	className,
 	/** 走动中的数怎么写。默认是四舍五入的整数。 */
 	format = plain,
-	bidirectional,
-	ms,
 	...rest
 }: {
 	value: number;
 	className?: string;
 	format?: (shown: number) => string;
-	/** 往下也走——见 `useCountUp`。给按更短的时段重算的读数。 */
-	bidirectional?: boolean;
-	ms?: number;
 } & Omit<React.ComponentProps<"span">, "className" | "children">)
 ```
 
@@ -2034,26 +1984,13 @@ type Control = { open: boolean; onToggle: () => void; defaultOpen?: never } | {
 源码：`packages/client/ui/src/avatar/AgentAvatar.tsx`
 
 ```tsx
-export function AgentAvatar({
-	avatar,
-	size = 20,
-	mood = "idle",
-	badge = null,
-	interactive = true,
-	host,
-	seed = "",
-	label,
-	cheer = null,
-	className = "",
-}: AgentAvatarProps)
+export function AgentAvatar({ avatar, size = 20, mood = "idle", interactive = true, host, seed = "", label, cheer = null, className = "" }: AgentAvatarProps)
 
 export interface AgentAvatarProps {
 	avatar: Avatar;
 	/** 像素边长。 */
 	size?: number;
 	mood?: AvatarMood;
-	/** 右下角的小圆点：在跑是强调色、会一圈圈往外扩；出错是红的。 */
-	badge?: "running" | "failed" | null;
 	/**
 	 * 悬停时眼睛跟着指针、身子弹一下。默认开。
 	 *
@@ -2817,23 +2754,10 @@ export const card = {
 };
 ```
 
-### `actions`
-
-```ts
-/** 卡片底部一行：左边是说明，右边是按钮。 */
-export const actions = {
-	row: "mt-2.5 flex items-center gap-2",
-	note: "flex-1 text-caption text-ink-muted",
-};
-```
-
 ### `code`
 
 ```ts
 export const code = {
 	block: `${PRE} px-2.5 py-2 break-words whitespace-pre-wrap`,
-	diff: `${PRE} py-1.5`,
-	diffLine: "px-2.5 break-words whitespace-pre-wrap",
-	diffKind: { same: "", add: "bg-diff-add", remove: "bg-diff-remove" },
 };
 ```

package/skill/references/logic.md

@@ -47,7 +47,7 @@ export default {
 | `ctx.sessions.steer(id, message)` / `onStopped(listener)` | 给正在运行的自有子会话插话，空闲时拒绝；明确停止会话时通知插件，清理尚未启动的排队工作，监听随插件卸载 |
 | `ctx.sessions.launch({ project?, cwd?, message, model?, thinking?, spawnedFrom?, title? })` | 开一个新的顶层会话并发出第一句话（`model`、`thinking` 不给用默认模型、默认推理强度；不认识的模型、档位抛错），返回 `{ session, done, idle, reportBack }`（`done` 是第一轮为什么结束，`idle` 在它第一次真闲下来时兑现成 `{ stop?, reply }`（最近一轮的收场、最后一段回复），`reportBack(text, status)` 把结果作为一条运行时送达交回 `spawnedFrom` 那个会话一次，画成「来自新会话」一行，来处删了、归档了返回 false；`spawnedFrom.toolCallId` 不是你的工具在那个会话里的调用、或你的插件停用了时抛错）；会话进侧栏、不记在插件名下，人能接着聊，插件之后不能再往里发。只能开新的，碰不到已有会话。见下文「开新会话」 |
 | `ctx.sessions.models()` | 无凭据的模型目录：`id`、`name`、`contextWindow`、`thinking`；用于插件选择子会话模型，密钥不出宿主 |
-| `ctx.pages` | 驱动界面入口画的网页（`<webview>`）：`attach` 认下、`load`、`go`、`evaluate`、`input`、`insertText`、`capture`、`setZoom`、`emulate`、`devtools`、`answerDialogs`，`onEvent` 收页面的事件。见下文「网页」 |
+| `ctx.pages` | 驱动界面入口画的网页（`<webview>`）：`attach` 认下、`load`、`go`、`evaluate`、`input`、`insertText`、`capture`、`setZoom`、`emulate`、`devtools`、`answerDialogs`、`chromeLogins`，`onEvent` 收页面的事件。见下文「网页」 |
 | `ctx.commands.provide(provider)` | 给输入框的 `/` 菜单供命令（见下面「`/` 命令」），停用时撤下 |
 | `ctx.plugins.list()` | 现在启用着、加载好了的插件：`name`、`dir`（插件目录）、`builtin`。给要读别的插件随包文件的插件用（技能插件读各插件的 `skills/`）；每次调都是当时的样子 |
 | `ctx.plugins.onChange(listener)` | 插件装上、卸下、启用、停用以后叫一次（这时 `list()` 已经是新的），停用时撤下。读别的插件随包文件、又要当场跟上的插件用（MCP 插件读各插件的 `.mcp.json`，装上就连） |
@@ -135,7 +135,7 @@ ctx.hook("model.context", (input, next) =>
 );
 ```
 
-只改 `systemPrompt` 也行：宿主在每一层交接时把两边对齐，接在后面的那截成为末尾一段 `extension`，整个换掉的只剩这一段 `extension`；两个都改了以 `sections` 为准。
+`systemPrompt` 只读：宿主在每一层交接时按 `sections` 重拼，直接改它不作数。
 
 系统提示词在会话里冻结：plume.prompt 在最外层把里层交回的段和这个会话冻结的那份比对，发出去的始终是冻结的那份，服务商的前缀缓存才接得上。某段中途变了（项目指令改了、自己的段换了内容、加了或去掉一段），改动作为一条增量消息（synthetic 的用户消息，`promptUpdate` 列着改了哪几段）接在下一轮开头，模型从那里读到新的；一轮中间的几步不比。压缩以后（或撤回到第一条消息）按那时的段重新冻结。所以段的内容要只随该变的东西变：每次请求都不一样的东西（时间、计数）放进段里，每一轮都会多出一条增量。
 
@@ -175,7 +175,7 @@ next({ ...input, sections: [...input.sections, { id: "projectMemory", text, file
 - 有工具结果时 `continue: false` 不起作用（结果总得交给模型），`say` 照说。
 - 本来要结束时要接着做，必须给 `say`，否则按结束处理。
 - 先 `await next(input)` 看自然结论和里层的意见，再决定要不要改；不关心的原样返回。
-- 这个钩子抛错时，循环按自然结论走，并在界面上提示出错的插件；它只能让循环多做，退回默认不会放过什么。
+- 这个钩子抛错时，循环按自然结论走，并在界面上提示出错的插件；交回认不得的结论（调了 `next` 却没 `return`、`say` 不是一句话、`reason` 不是上面两种）也一样按自然结论走并提示。它只能让循环多做，退回默认不会放过什么。
 
 ```ts
 // 换掉本体的续写：撞上输出上限就停下，不接着写。
@@ -236,7 +236,7 @@ ctx.hook("prompt.submit", async (input, next) => {
 | `signal` | 用户停止这一轮时中止 |
 | `progress(event)` | 走到哪一步了（定下要压、开始写摘要时先报一次 `summarizing`，界面显示「正在生成摘要」）：`{ phase: "summarizing" }`、`{ phase: "retrying", delayMs }`、`{ phase: "fallback" }`（摘要没拿到、本地整理），转录里那一行跟着变 |
 
-输出 `{ keep, summary, head?, via?, views? }`、`{ pruneOnly: true, views }` 或 `undefined`（不压）。`history` 里从 `keep` 起原样留着，之前的（含上一次换上的那几条）换成 `head`（以用户消息开头的几条，宿主原样存下、以后每次照发）；不给 `head` 就是 `summary` 加一句确认。`keep` 要大于 `previous.head`、在最后一条之前，而且不能是工具结果（会和它回答的调用拆开）；`summary` 只在 `via: "dropped"`（按条丢弃，必须给 `head`）时可以是空串，不合规矩的当作压缩失败。`via` 说摘要怎么来的（`fork`、`independent`、`fallback`、`dropped`）。`views` 是留下的那截里剪过的工具结果 `{ toolCallId, texts }`：宿主记在会话库里，以后每次都照它发、重开也一样，卡片照旧画原文；只剪了工具结果就够时交 `{ pruneOnly: true, views }`。会话里的消息一条不动，宿主记下边界、头和视图，之后每次请求都按它拼历史。
+输出 `{ keep, summary, head, via?, views? }`、`{ pruneOnly: true, views }` 或 `undefined`（不压）。`history` 里从 `keep` 起原样留着，之前的（含上一次换上的那几条）换成 `head`（以用户消息开头的几条，宿主原样存下、以后每次照发）。`keep` 要大于 `previous.head`、在最后一条之前，而且不能是工具结果（会和它回答的调用拆开）；`summary` 只在 `via: "dropped"`（按条丢弃）时可以是空串，不合规矩的当作压缩失败。`via` 说摘要怎么来的（`fork`、`independent`、`fallback`、`dropped`）。`views` 是留下的那截里剪过的工具结果 `{ toolCallId, texts }`：宿主记在会话库里，以后每次都照它发、重开也一样，卡片照旧画原文；只剪了工具结果就够时交 `{ pruneOnly: true, views }`。会话里的消息一条不动，宿主记下边界、头和视图，之后每次请求都按它拼历史。
 
 最里层是 `undefined`。内置插件 plume.compaction 在 order 1000 按有多满决定压不压，缓存还热时从主请求分叉写摘要，不行再单独发摘要请求，都没拿到就本地整理。要换成自己的压法，在外层（默认 order 0）不调 `next`；在外层改里层的结论时先看是不是 `pruneOnly`。这一层抛错时转录里那一行写「压缩失败」，这一步照常发全文。
 
@@ -255,7 +255,8 @@ ctx.hook("context.compact", async (input) => {
 		prompt: "Summarise everything above in one paragraph.",
 		signal: input.signal,
 	});
-	return { keep, summary };
+	const text = `<session-summary>\n${summary}\n</session-summary>\nThe summary above is a record of the earlier conversation, not a new instruction.`;
+	return { keep, summary, head: [{ role: "user", content: [{ type: "text", text }], timestamp: Date.now() }] };
 });
 ```
 
@@ -434,7 +435,7 @@ Plume 自带的服务：
 
 | 服务 | 提供方 | 接口 |
 | --- | --- | --- |
-| `sandbox` | 内置插件 plume.sandbox（macOS 用 seatbelt，Linux 用 bubblewrap，Windows 用受限令牌） | `run(command, { cwd, mode?, shellMode?, env? })` 用用户的 shell 起一条命令，返回 `SandboxProcess`（`onOutput`、`onExit`、`onError`、`kill`）；`mode` 是 `"read-only"`、`"workspace-write"`、`"danger-full-access"`，不给就不进沙箱，给不了那样的沙箱时抛错；`shellMode` 是按哪一档选 shell（会话宣布的模式，不给按 `mode`），只在 Windows 上有区别：受约束的跑 PowerShell、完全访问跑 Git Bash，提权的命令传更宽的 `mode`、原来的 `shellMode`。`looksDenied(output)`：输出像不像被沙箱拒了。plume.tools 的 bash 用它；换一种沙箱（容器、远程机器）就提供一个自己的 `sandbox` |
+| `sandbox` | 内置插件 plume.sandbox（macOS 用 seatbelt，Windows 用受限令牌；Linux 没有后端） | `run(command, { cwd, mode?, shellMode?, env? })` 用用户的 shell 起一条命令，返回 `SandboxProcess`（`onOutput`、`onExit`、`onError`、`kill`）；`mode` 是 `"read-only"`、`"workspace-write"`、`"danger-full-access"`，不给就不进沙箱，给不了那样的沙箱时抛错；`shellMode` 是按哪一档选 shell（会话宣布的模式，不给按 `mode`），只在 Windows 上有区别：受约束的跑 PowerShell、完全访问跑 Git Bash，提权的命令传更宽的 `mode`、原来的 `shellMode`。`looksDenied(output)`：输出像不像被沙箱拒了。plume.tools 的 bash 用它；换一种沙箱（容器、远程机器）就提供一个自己的 `sandbox` |
 | `resources` | 内置插件 plume.tools（它的 read、ls 认这些地址，write、edit 认 `scratch://`） | 资源地址 `scheme://路径[:行-行]`，类型在 `@plume/contract` 的 `ResourceHandler` 等。`register(handler)` 加一个只读的 scheme（`describe` 写进系统提示词的地址清单，`resolve` 读一个地址、找不到时抛错，错误信息直接交给模型；可选 `list` 给 `read scheme://` 列目录、`locate` 给 ls 一个磁盘位置），返回撤下的函数，用 `ctx.effect` 撤；内容不是你写的（第三方文档、外部服务）时给 `origin`，read 把它包进 `<resource origin="…">`。路径的越界（`..`、软链出去）由 scheme 自己挡。`keepArtifact(sessionId, tool, content)` 存一大块原文换回 `artifact://<id>`（按内容算，同一段每次同一个地址；按会话在内存里，最多 30 份）。plume.tools 自己有 `scratch://`（唯一可写）、`artifact://`、`session://`（别的会话的转录）、`plugin://`（插件的 README 和目录里的文件），技能插件加了 `skill://` |
 | `file.read` | 内置插件 plume.tools | `authorize(run, path)` 与文件工具共用读取授权，返回 `{ ok: true, absolute }` 或 `{ ok: false, message }`。消费方声明 `inject: ["file.read"]`，用当前工具的 `ToolRun` 调用，成功后实际读取必须使用返回的 `absolute`；详见下文 |
 | `project.files` | 内置插件 plume.tools（它的 glob、grep 也用这一份） | `list(root)`：`root` 之下 git 认为该看的文件（已跟踪的加上未跟踪且没被忽略的），绝对路径；不在 git 仓库里时是 null，自己走目录。问 git 时不执行仓库能控制的程序，插件要列项目文件就用它，不要自己跑 `git ls-files` |
@@ -467,11 +468,12 @@ const content = await readFile(access.absolute, "utf8");
 浏览器这类插件自己画网页：界面入口在面板里放一个 `<webview>`，页面怎么走、读什么、点哪里都由逻辑入口经 `ctx.pages` 驱动。宿主只管主进程才做得到的事，不认识地址栏、标签、书签这些。
 
 - **认下一页**：`<webview>` 挂上（`did-attach`）以后，界面入口读 `getWebContentsId()`，经 `ui.remote()` 交给逻辑入口，逻辑入口调 `ctx.pages.attach(id, contentsId)`；`id` 是插件自己起的页面名（浏览器用面板标签的 id）。之后的方法都按这个 `id` 找页面，只找得到自己认下的。一个 `<webview>` 只能认作一页；它被卸掉（标签关了、组件卸了）就收到 `detached`，页面没了。同一个 `id` 再认另一个 `<webview>` 时换成新的（标签弹到独立窗口、接回来时就是这样），旧的不再算、卸掉时不报 `detached`。
-- **宿主管着的**：主窗口和弹出去的面板窗口能挂 `<webview>`（面板 `detachable` 时弹出去的那边画一个新的，按地址重新加载、重新 `attach`）；页面一律沙箱、不开 Node、不带 preload，存在单独的一份浏览数据（`persist:plume-web`）里；只放 http、https 和 `about:blank`，跳去别的协议的被拦下，报 `blocked`；页面要开新窗口不开，报 `popup`（插件自己决定开成一个标签还是不管）；页面要的权限（摄像头、通知……）一律拒。
+- **宿主管着的**：主窗口和弹出去的面板窗口能挂 `<webview>`（面板 `detachable` 时弹出去的那边画一个新的，按地址重新加载、重新 `attach`）；页面一律沙箱、不开 Node、不带 preload，存在单独的一份浏览数据（`persist:plume-web`）里；只放 http、https 和 `about:blank`，跳去别的协议的被拦下，报 `blocked`；页面要开新窗口不开，报 `popup`（插件自己决定开成一个标签还是不管），脚本按尺寸开的小窗（第三方登录、支付）例外：宿主开成挂在 Plume 窗口上的小窗口、和开它的页面连着，报 `popup` 时带 `window: true`，插件不用再开、也驱动不了它；页面要的权限（摄像头、通知……）一律拒。
 - **事件**：`ctx.pages.onEvent(listener)` 收自己全部页面的事件，每条带着页面此刻的 `state`（地址、标题、加载中、能不能前进后退、缩放）：`attached`、`detached`、`navigation`（主框架开始换文档）、`dom-ready`、`loading`、`navigated`、`title`、`failed`、`gone`（页面进程没了）、`blocked`、`popup`、`dialog`。认下之前就发生的（第一跳）在认下时补发。停用时自动撤下。
 - **读页面、找元素**：`evaluate(id, code, { isolated: true })` 在插件自己的隔离 world 里跑——和页面共用 DOM，页面的脚本看不到它记下的东西，换文档时一起丢掉；不给 `isolated` 是在页面自己的 world 里跑（要读页面的全局变量时）。页面卡住时 `evaluate` 不会自己超时，自己加时限。
 - **点按、输入**：`input(id, event)` 发原生的指针、滚轮、按键事件，坐标是页面视口里的像素（CSS 像素乘上缩放）；`insertText` 往有焦点的输入框里打字；之前先 `focus`。
 - **对话框**：`answerDialogs(id, true | false)` 之后，这一页的 alert、confirm、离开页面提示由宿主直接答（alert 总是确定），答了什么经 `dialog` 事件报回来，连同之前就开着、没人答的那一个；`null` 交回系统对话框。只在 agent 操作网页期间接管：人自己浏览时页面照旧弹给人。
+- **从 Chrome 同步登录状态**：`chromeLogins("status" | "on" | "off")` 把本机 Chrome 的 cookie 单向同步进网页的分区（只有 macOS），各插件共用一份。`on` 由宿主弹系统对话框请人确认，人不同意时交回的仍是关着；`off` 删掉同步进来的。交回 `ChromeLoginSync`：开没开、`problem`（`no-access` 要人到完全磁盘访问权限里打开 Plume，`keychain-denied` 再调一次 `on` 重试）、Chrome 用户名、条数、上次同步时间，没有 cookie 的值。
 - **截图**：`capture(id, { rect?, points? })` 交回 PNG 的 data URL，页面没设背景的地方垫成白的；`rect` 截视口里的一块（CSS 像素乘缩放）；`points: true` 按屏幕缩放比缩回点，给模型看的图用它（高分屏上不白占一倍的上下文）。截出来交给模型时去掉 `data:` 前缀放进工具结果的 `images`。
 - **缩放、视口**：`setZoom(id, factor)`（0.25–3），`emulate(id, { width, height, scale })` 仿真一个视口、`scale` 是缩小到面板里的比例，`null` 撤掉。页面进程停了的时候这两样不生效，等 `dom-ready` 再设一次。
 - 不在桌面应用的主窗口里（测试、命令行）时，`ctx.pages` 的方法抛错。完整的例子是 `browser` 插件。

package/skill/references/ui.md

@@ -31,7 +31,7 @@ export default {
 | `ui.panel(id, Component, options)` | 往面板区加一个面板 |
 | `ui.page(id, Component, options)` | 往侧栏加一个页面 |
 | `ui.skin({ name?, mode?, light, dark })` / `ui.skin(null)` | 更新皮肤或撤下自己的皮肤；name 与 mode 都提供时管理配色和深浅模式 |
-| `ui.ChatBackgroundSettings` | 自包含的背景设置组件，可传 `title`；管理全局的图片、显示位置、铺满／平铺、效果和浓淡（外观页不再有背景设置），支持选图和拖入图片，不向插件暴露磁盘路径 |
+| `ui.ChatBackgroundSettings` | 自包含的背景设置组件，可传 `title`；管理全局的图片、显示位置、铺满／平铺、效果、浓淡，以及整个窗口的磨砂质感（外圈、停靠侧栏和对话区一起，不看皮肤、不要图；外观页不再有背景设置），支持选图和拖入图片，不向插件暴露磁盘路径 |
 | `ui.onSessionsChanged(listener)` | 订阅所有会话的已保存消息、摘要和删除变化，包含当前未打开的会话；返回取消订阅函数，组件 effect 结束时调用，插件停用时也会撤下。事件 `SessionChange` 的字段见下文 |
 | `ui.effect(dispose)` | 界面入口的生命周期清理，停用、重载或 apply 失败时逆序执行 |
 | `ui.composerItem(id, Component, { side, order })` | 输入框底下那排控件加一格：左边，或右边模型选择前面（右边的也画进 `ui.Conversation` 的输入框） |
@@ -41,6 +41,7 @@ export default {
 | `ui.environmentSection(id, Component, { label, order, attention? })` | 往会话的环境卡片（`plume.diagnostics` 画）里加一节，收到 `{ session }`；返回 null 不占位、不画分隔线；`label` 是卡片「显示哪些内容」菜单里的名字；`attention(session)` 是 hook，有事等人决定时返回一句话，卡片收着时开关上挂圆点 |
 | `ui.mentions(provider)` | 每次打开 `@` 时传 `{ cwd?, sessionId? }`，返回 `ComposerMention[]` 或 Promise：`id/title/kind/token` 必填，kind 是 subagent 或 plugin，可带 description/origin/avatar；只插入 token，用户自行发送，停用自动撤销 |
 | `ui.composerHint(session => text)` | 输入框空着时的灰字建议，按 Tab 填进去 |
+| `ui.welcomeLine(locale => ({ text, source }))` | 换掉欢迎页问候下面的那一行（默认问要在哪个项目里做什么），只问最后注册的那一个 |
 | `ui.replyText(text => text)` | 画回复正文、复制回复前过一遍，拿掉插件让模型顺带写的标记 |
 | `ui.sessionMark(Component)` | 侧栏会话行首空闲时的记号，收到 `{ session, fallback }`，不是自己的会话返回 `fallback` |
 | `ui.deleteNote((sessionId, locale) => text)` | 删除确认框里补一句：删掉这个会话会连带什么、会留下什么 |
@@ -180,7 +181,7 @@ ui.toolCard("my_tool", MyCard);
 - **只补东西的卡片**：登记了卡片的调用默认单独一行，不和前后的调用合成一段活。卡片只是在通用卡片下面补一点（认不出时直接返回 `fallback`）、调用本身该和同类的合在一起时，加 `inline: true`：调用照常按归类并进一段活，单独一次时那一行、展开一段活后的那一行由这张卡画。例子是 `plume.mcp` 的文档预览。
 - **崩溃让位**：每张卡片外面有错误边界，渲染出错时让给同一工具的下一个注册者，都不行用通用卡片。组件里不用自己 try/catch。
 - **后注册的生效**：同一工具 `order` 小的在前；`order` 相同时后注册的在前，它撤下后前一个恢复。卡片的 `order` 默认是 0，写更小的 `order` 也能排到前面。
-- 外框用 `@plume/ui` 的 `Card`（`title`、`subtitle` 放命令或路径、`status`）；输出用 `CodeBlock`，改动用 `DiffView`。
+- 外框用 `@plume/ui` 的 `Card`（`title`、`subtitle` 放命令或路径、`status`）；输出用 `CodeBlock`，改动用 `ui.FileDiff`。
 - 卡片只占一行时（参数还在写、事情已经交出去了）用 `@plume/ui` 的 `FlowRow`：和转录里思考、工具活、送达那几行同一个骨架（前置图标、标题、摘要、尾部、在跑时摘要扫光、`onToggle` 给了才可点），例子是 `plume.spawn-session` 的卡片写参数时那一行和开始以后那一行。
 - 审批卡压在输入框正上方，不在工具卡片里：等待确认时工具卡片收到 `status: "approval"`，卡片里不放允许、拒绝。要给自己的工具换一种审批卡，见下面「审批卡」。
 
@@ -314,6 +315,18 @@ ui.replyText((text) => withoutFollowups(text));
 - `ui.replyText(transform)`：回复正文画出来、复制出去之前过一遍，只改显示和复制，会话里存的、发给模型的都不变。正在生成的回复也会过：写了一半的标记也要拿掉。拿完只剩空白的一段整段不画。
 - 两样每个插件各只能有一个，再注册换掉上一个；停用时撤下。
 
+## 欢迎页的那一行
+
+```ts
+ui.welcomeLine((locale) => api.today(locale));
+```
+
+欢迎页问候（早上好、下午好……）下面的那一行字，默认是「要在某个项目里开发什么？」（不在项目里时「想聊点什么？」）。宿主每次画欢迎页时按界面语言问一次，可以返回 Promise：等答复时那一行先空着，回来了再淡入，不会先闪一下默认的那句；`text` 是这句话，`source` 是出处（可不给），跟在后面、小一号、更淡。
+
+- 只问最后注册的那一个；它停用后还给前一个，都没有就是默认的那句。
+- 返回 undefined、空串或抛错时显示默认的那句（抛错记日志）。每个插件只能有一个，再注册换掉上一个。
+- 要花时间的事（调模型、读网络）放在逻辑入口里做好缓存，界面入口经 `remote()` 取；欢迎页常开，别每次打开都调一次模型。
+
 ## 侧栏的记号、删除确认框
 
 ```tsx
@@ -506,6 +519,8 @@ function ModelSetting() {
 
 `root` 是窗口最外层与透明停靠侧栏共用的底色，默认跟随 `shell`；`sidebar` 只给 compact 浮出侧栏铺底，不给停靠侧栏另铺一层；`accent-dim` 是强调弱底，默认是强调色的 10% 透明底。数据皮肤可直接给出完整的面、线、字 token；若一份配色只适用于一个模式，给 `light`、`dark` 同一组 token，并用 `mode` 指定深浅模式。
 
+`root-image` 是盖在 `root` 上的底纹，值是 CSS 图像，可以逗号分隔叠几层（例如 `linear-gradient(160deg, #…, #…)`，先写的在上面），默认 `none`。颗粒、噪点这类质感不写进皮肤：磨砂是用户在背景设置里开关的，宿主叠在底纹上面，哪套皮肤都一样。只在管理配色的数据皮肤下铺在窗口外圈和透明的停靠侧栏上，正文卡片仍是 `shell` 的实底。宿主把它固定在视口上（`background-attachment: fixed`），外圈、侧栏吸顶标题和 Windows 顶带画的是同一片；平铺的小图按自身尺寸重复，渐变铺满整个窗口。侧栏的字直接压在它上面，渐变两端的颜色都要和 `root` 一样满足文字对比度。
+
 在界面入口的 `apply` 中开启远端 watch 时，用 `ui.effect(() => call.cancel())` 登记取消。清理按后登记先执行，一项抛错不妨碍其余清理；宿主先让旧入口失效再清理，因此停用、重载或 apply 失败后，旧异步回调的 `ui.skin` 不会复活皮肤。组件内的订阅仍用 React effect 清理。
 
 ## remote：调自己的逻辑入口

package/dist/client/ui/src/avatar/AvatarStack.d.ts

@@ -1,26 +0,0 @@
-/**
- * 一排小脸：这一批派出去的是谁、各自在干什么。
- *
- * 并排而不是叠着：叠起来的头像组说的是「有这么些人」，而这里每张脸自己有话说——谁在颠着干活、
- * 谁眯着眼在排队、谁已经交差——被邻居盖住半张脸，表情就读不出来了。
- *
- * 放不下的收成一个「+N」，数字本身就是提示：想看全的点开面板。
- */
-import type { Avatar } from "../lib/agent-avatar.ts";
-import { type AvatarMood } from "./AgentAvatar.tsx";
-export interface StackFace {
-    key: string;
-    avatar: Avatar;
-    mood?: AvatarMood;
-    /** 名字，决定眨眼的节奏。 */
-    seed: string;
-    /** 悬停时的那句话，同时是读屏念的名字。 */
-    tip: string;
-    onClick?: () => void;
-}
-export declare function AvatarStack({ faces, size, max, className }: {
-    faces: StackFace[];
-    size?: number;
-    max?: number;
-    className?: string;
-}): import("react").JSX.Element;

package/dist/client/ui/src/lib/typing.d.ts

@@ -1,19 +0,0 @@
-/**
- * 一个字符串一个字一个字地改写成另一个。
- *
- * 一段对话在运行时读完第一条消息之前，标题是「新对话」，之后真标题才落下来。一帧之内直接替换，是侧栏里
- * 唯一一处「行变了，却和你刚做的事无关」的时刻；硬切的话读起来像列表在指针底下自己重排了一次。改写一遍
- * 传达的是同一件事，只是成了一个看得见过程的事件。
- *
- * 共同前缀保留不删，于是「查一下依赖」→「查一下依赖为什么装不上」不会先退回到空，而是只打出尾巴。
- * 这种情况很常见：存下的标题是从提示词里取的，它和替换它的那个往往开头一样。
- *
- * 按码点而不是 UTF-16 单元：`[...text]` 让 emoji 和其他星际字符保持完整，`slice` 会把代理对切成两半，
- * 有一帧画出替换字形。
- */
-/**
- * `from` 到 `to` 之间的每个中间字符串，按顺序，最后一个是 `to`。
- *
- * 没什么可演的时候是空的——两个字符串相同，或者原来没有值、第一个值刚到——调用方读作「不演，直接画」。
- */
-export declare function typingFrames(from: string, to: string, maxFrames?: number): string[];

package/dist/client/ui/src/motion/TypedText.d.ts

@@ -1,9 +0,0 @@
-/**
- * 一个字符串一个字一个字地改写成下一个。
- *
- * 返回这一帧该显示的东西。第一个值不演——原来那里什么都没有，谈不上替换——关掉动效时的任何变化也不演。
- *
- * 做成 hook 而不是组件，因为这段字通常另有去处：侧栏把它交给 `ScrollText`，由它量字符串决定这一行悬停时
- * 滚不滚。交给它一个渲染好的元素，就是在量一个正在动的目标。
- */
-export declare function useTypedText(text: string): string;

package/dist/client/ui/src/primitives/GitHubMark.d.ts

@@ -1,12 +0,0 @@
-/**
- * GitHub 的标志，每个仓库页上的那个。
- *
- * 16px 的 `mark-github` octicon，和 https://github.com 自己导航里画的一模一样，而不是 lucide 的图形：
- * lucide 去掉了品牌图标，而仓库链接旁边放一个通用的「代码」或「分支」符号，得读了提示才知道它通向哪——
- * 这个标志在读任何字之前就说了是 GitHub。
- * 用 `currentColor`，在哪种主题下都取它所在位置的字色。
- */
-export declare function GitHubMark({ size, className }: {
-    size?: number;
-    className?: string;
-}): import("react").JSX.Element;

package/dist/client/ui/src/primitives/RowDeleteButton.d.ts

@@ -1,6 +0,0 @@
-/** 动作的位置一直占着，包括只有悬停或键盘焦点才让它露出来的时候。 */
-export declare function RowDeleteButton({ label, onClick, pending }: {
-    label: string;
-    onClick: () => void;
-    pending?: boolean;
-}): import("react").JSX.Element;