@xiongtao.xt/tau-plugins 0.23.1 → 0.25.0

package/types/packages/plugins/src/contract.d.ts

@@ -17,6 +17,12 @@ import type { PluginSidebar } from "./sidebar";
 import type { PluginExcerpts, PluginMaterials } from "./excerpts";
 import type { PluginMCP } from "./mcp";
 import type { PluginChat } from "./chat";
+import type { PluginBackendClient } from "./backend";
+import type { PluginPermissions } from "./permissions";
+import type { PluginContent, PluginData } from "./data";
+import type { PluginEvents } from "./events";
+import type { PluginApp } from "./app";
+import type { PluginOwnEntities } from "./entities";
 import type { JsonValue } from "./json";
 export type { JsonValue } from "./json";
 export interface Disposable {
@@ -34,6 +40,7 @@ export interface PluginCommand {
     run(input: JsonValue): JsonValue | Promise<JsonValue>;
 }
 export interface PluginContext {
+    readonly backend: PluginBackendClient;
     readonly pluginId: string;
     readonly workspaceId: string;
     readonly signal: AbortSignal;
@@ -58,6 +65,18 @@ export interface PluginContext {
     readonly ai: PluginAI;
     readonly mcp: PluginMCP;
     readonly chat: PluginChat;
+    /** 业务数据权限的查询与申请；数据接口首次调用时也会自动申请 */
+    readonly permissions: PluginPermissions;
+    /** 卡片、文章、项目文档、待办与日程的只读访问 */
+    readonly data: PluginData;
+    /** 按 ContentRef 读取正文 */
+    readonly content: PluginContent;
+    /** 业务数据变更事件，如卡片更新 */
+    readonly events: PluginEvents;
+    /** 选择与打开已有内容 */
+    readonly app: PluginApp;
+    /** 插件自建、各带一份正文的内容；读写自己的内容不需要业务数据权限 */
+    readonly entities: PluginOwnEntities;
     /** 将订阅等资源交给宿主，在停用或激活失败时逆序回收。 */
     register(resource: Disposable): Disposable;
 }

package/types/packages/plugins/src/data.d.ts

@@ -0,0 +1,223 @@
+/**
+ * 业务数据接口。ID 与 ContentRef 都是不透明字符串：只用于传回宿主，不要解析其格式。
+ * 每次调用前宿主按 manifest.permissions 与用户授权校验，未获准抛出 PluginPermissionError。
+ * 修改与删除要传读到的 revision，数据已被别处修改时抛出 PluginConflictError。
+ */
+/** 一份正文的句柄，从实体上取得，传给 context.content 读取 */
+export type PluginContentRef = string;
+export interface PluginPage<T> {
+    items: T[];
+    /** 还有下一页时给出，原样传回 query 的 cursor */
+    cursor?: string;
+}
+export interface PluginEntityQuery {
+    /** 毫秒时间戳，含起点、不含终点 */
+    createdAfter?: number;
+    createdBefore?: number;
+    updatedAfter?: number;
+    updatedBefore?: number;
+    /** 层级标签按前缀命中：「读书」也命中「读书/小说」 */
+    tag?: string;
+    /** 默认按更新时间倒序 */
+    sort?: "created" | "updated";
+    /** 1–200，默认 50 */
+    limit?: number;
+    cursor?: string;
+}
+interface PluginEntityBase {
+    id: string;
+    /** 元数据版本，修改与删除时作为 expectedRevision 传回；正文修改不改变它 */
+    revision: string;
+    title: string;
+    tags: string[];
+    wordCount: number;
+    createdAt: number;
+    /** 元数据与正文中较晚的修改时间 */
+    updatedAt: number;
+}
+export interface PluginCard extends PluginEntityBase {
+    /** 卡片没有标题字段，这里是 AI 标题或正文开头 */
+    title: string;
+    pinned: boolean;
+    contentRef: PluginContentRef;
+}
+export interface PluginArticle extends PluginEntityBase {
+    pinned: boolean;
+    contentRef: PluginContentRef;
+}
+export interface PluginDocument extends PluginEntityBase {
+    /** document（富文本）、white-board 等；非富文本类型没有正文 */
+    kind: string;
+    contentRef: PluginContentRef | null;
+    projectIds: string[];
+}
+export interface PluginEntityReader<T> {
+    get(id: string): Promise<T | null>;
+    query(query?: PluginEntityQuery): Promise<PluginPage<T>>;
+}
+export interface PluginWriteOptions {
+    /** 读取时得到的 revision */
+    expectedRevision: string;
+}
+export interface PluginCardInput {
+    /** 正文，Markdown；省略时为空卡片 */
+    markdown?: string;
+    tags?: string[];
+    pinned?: boolean;
+}
+export interface PluginCardPatch {
+    tags?: string[];
+    pinned?: boolean;
+}
+export interface PluginArticleInput {
+    title: string;
+    markdown?: string;
+    tags?: string[];
+}
+export interface PluginArticlePatch {
+    title?: string;
+    tags?: string[];
+    pinned?: boolean;
+}
+export interface PluginDocumentPatch {
+    title?: string;
+    tags?: string[];
+}
+/** 新建与修改需要 `*:write`，删除需要 `*:delete`；删除可由用户在插件详情页 7 天内恢复 */
+export interface PluginEntityWriter<T, Input, Patch> extends PluginEntityReader<T> {
+    create(input: Input): Promise<T>;
+    update(id: string, patch: Patch, options: PluginWriteOptions): Promise<T>;
+    delete(id: string, options: PluginWriteOptions): Promise<void>;
+}
+export interface PluginTodoQuery {
+    /** 缺省为全部：独立待办与正文里的勾选项 */
+    source?: "all" | "todo" | "document";
+    completed?: boolean;
+    keyword?: string;
+    /** YYYY-MM-DD，按截止日期筛选 */
+    start?: string;
+    end?: string;
+    /** 1–100，默认 50 */
+    limit?: number;
+    cursor?: string;
+}
+export interface PluginTodo {
+    id: string;
+    revision: string;
+    title: string;
+    completed: boolean;
+    archived: boolean;
+    /** YYYY-MM-DD 或 ISO 时间 */
+    dueAt: string | null;
+    /** 正文里的勾选项所在的文档 */
+    source?: {
+        kind: "card" | "article" | "document" | "diary";
+        id: string;
+        title?: string;
+    };
+}
+export interface PluginCalendarQuery {
+    /** YYYY-MM-DD 或带时区的 ISO 时间，必填 */
+    start: string;
+    end: string;
+    /** 1–100，默认 50 */
+    limit?: number;
+    cursor?: string;
+}
+export interface PluginCalendarEvent {
+    id: string;
+    revision: string;
+    title: string;
+    start: string;
+    end: string;
+    allDay: boolean;
+    calendarId: string;
+    /** 由待办安排出的日程 */
+    todoId?: string;
+}
+export interface PluginTodoInput {
+    title: string;
+    /** YYYY-MM-DD 或带时区的 ISO 时间 */
+    dueAt?: string | null;
+}
+export interface PluginTodoPatch {
+    title?: string;
+    dueAt?: string | null;
+}
+export interface PluginCalendarInput {
+    title: string;
+    /** 全天日程用 YYYY-MM-DD，结束日期不含当天（当天全天的 end 为次日）；定时日程用带时区的 ISO 时间 */
+    start: string;
+    end: string;
+    allDay: boolean;
+    /** 缺省为默认日历 */
+    calendarId?: string;
+}
+export type PluginCalendarPatch = Partial<PluginCalendarInput>;
+export interface PluginData {
+    readonly cards: PluginEntityWriter<PluginCard, PluginCardInput, PluginCardPatch>;
+    readonly articles: PluginEntityWriter<PluginArticle, PluginArticleInput, PluginArticlePatch>;
+    /** 项目文档只能修改标题与标签；新建、移动与删除涉及文档树，暂不开放 */
+    readonly documents: PluginEntityReader<PluginDocument> & {
+        update(id: string, patch: PluginDocumentPatch, options: PluginWriteOptions): Promise<PluginDocument>;
+    };
+    readonly todos: {
+        query(query?: PluginTodoQuery): Promise<PluginPage<PluginTodo>>;
+        create(input: PluginTodoInput): Promise<PluginTodo>;
+        update(id: string, patch: PluginTodoPatch, options: PluginWriteOptions): Promise<PluginTodo>;
+        setCompleted(id: string, completed: boolean, options: PluginWriteOptions): Promise<PluginTodo>;
+        /** 有子待办时拒绝删除 */
+        delete(id: string, options: PluginWriteOptions): Promise<void>;
+    };
+    readonly calendar: {
+        query(query: PluginCalendarQuery): Promise<PluginPage<PluginCalendarEvent>>;
+        create(input: PluginCalendarInput): Promise<PluginCalendarEvent>;
+        update(id: string, patch: PluginCalendarPatch, options: PluginWriteOptions): Promise<PluginCalendarEvent>;
+        delete(id: string, options: PluginWriteOptions): Promise<void>;
+    };
+}
+export interface PluginContentSnapshot {
+    ref: PluginContentRef;
+    /** 正文版本，edit 时作为 expectedRevision 传回 */
+    revision: string;
+    /** format 为 markdown（默认）时给出 */
+    markdown?: string;
+    /** format 为 nodes 时给出编辑器节点 JSON；结构随编辑器演进，优先使用 markdown */
+    nodes?: unknown[];
+    wordCount: number;
+    updatedAt: number;
+}
+/**
+ * 正文修改。append / prepend 只追加新内容，原有内容保持不变；replaceText 与 replaceAll 会把整篇
+ * 经 Markdown 重建，Markdown 无法表达的格式可能简化。
+ */
+export type PluginContentEdit = {
+    op: "append";
+    markdown: string;
+} | {
+    op: "prepend";
+    markdown: string;
+}
+/** find 必须在当前 Markdown 中恰好出现一次 */
+ | {
+    op: "replaceText";
+    find: string;
+    markdown: string;
+} | {
+    op: "replaceAll";
+    markdown: string;
+};
+export interface PluginContent {
+    /** 需要拥有该正文所属实体的读取权限；正文不存在时返回 null */
+    read(ref: PluginContentRef, options?: {
+        format?: "markdown" | "nodes";
+    }): Promise<PluginContentSnapshot | null>;
+    /**
+     * 修改正文，需要所属实体的写入权限。经协作会话写入：打开中的编辑器与协作者实时看到；
+     * 修改不进入编辑器的撤销记录。返回新的 revision。
+     */
+    edit(ref: PluginContentRef, edit: PluginContentEdit, options: PluginWriteOptions): Promise<{
+        revision: string;
+    }>;
+}
+export {};

package/types/packages/plugins/src/entities.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 插件实体：插件自己创建、各带一份正文的内容（如周记、看板卡片）。正文与卡片正文一样实时保存、
+ * 随云同步；读写自己的实体与正文不需要业务数据权限。
+ */
+import type { Disposable } from "./contract";
+import type { PluginContentRef, PluginPage, PluginWriteOptions } from "./data";
+import type { JsonValue } from "./json";
+import type { PluginPageParams } from "./pages";
+import type { PluginEntityRef } from "./app";
+import type { PluginIcon } from "./icons";
+export type PluginOwnEntityMeta = Record<string, JsonValue>;
+export interface PluginOwnEntity {
+    id: string;
+    /** registerKind 声明的类型 */
+    kind: string;
+    /** 插件给定、同一类型内唯一的键，如周记用「2026-W43」 */
+    key: string;
+    title: string;
+    /** 交给 context.content 或 ContentEditor 读写正文 */
+    contentRef: PluginContentRef;
+    meta: PluginOwnEntityMeta;
+    createdAt: number;
+    /** 标题、meta 与正文中较新的修改时间 */
+    updatedAt: number;
+    /** 标题与 meta 的版本，update 时作为 expectedRevision */
+    revision: string;
+}
+export interface PluginOwnEntityKind {
+    /** 插件内唯一的类型 ID */
+    kind: string;
+    /** 在 Tau 中显示的类型名，如「周记」 */
+    label: string;
+    /**
+     * 类型图标，与侧边栏图标同一协议。宿主声明时渲染一次并随笔记库保存：插件停用、卸载宽限期内，
+     * 搜索结果、正文中的引用、脉络等处仍按声明的类型名与图标显示。缺省为通用的插件图标。
+     */
+    icon?: PluginIcon;
+    /** 用户在 Tau 中打开这项内容时进入的插件页面；params 只能读取实体字段，不访问其他状态 */
+    open: {
+        page: string;
+        params?: (entity: PluginOwnEntity) => PluginPageParams;
+    };
+    /** 是否可在正文中用 @ 引用，默认 false */
+    mentionable?: boolean;
+}
+export interface PluginOwnEntityInput {
+    kind: string;
+    key: string;
+    title?: string;
+    meta?: PluginOwnEntityMeta;
+}
+export interface PluginOwnEntityPatch {
+    title?: string;
+    meta?: PluginOwnEntityMeta;
+}
+export interface PluginOwnEntityQuery {
+    kind?: string;
+    cursor?: string;
+    /** 默认 50，最多 200 */
+    limit?: number;
+}
+/** 正文里引用了这项内容的一处来源 */
+export interface PluginOwnEntityBacklink {
+    /** 可交给 context.app.open 打开 */
+    ref: PluginEntityRef;
+    title: string;
+    /** 引用处的上下文：前文、链接文字、后文 */
+    snippets: {
+        before: string;
+        label: string;
+        after: string;
+    }[];
+}
+export interface PluginOwnEntities {
+    /** 声明一种内容类型；create 只接受已声明的类型 */
+    registerKind(definition: PluginOwnEntityKind): Disposable;
+    /** 新建一项，正文为空。同一类型下 key 已存在时抛出 PluginConflictError */
+    create(input: PluginOwnEntityInput): Promise<PluginOwnEntity>;
+    get(id: string): Promise<PluginOwnEntity | null>;
+    find(kind: string, key: string): Promise<PluginOwnEntity | null>;
+    /** 按创建时间倒序分页 */
+    query(query?: PluginOwnEntityQuery): Promise<PluginPage<PluginOwnEntity>>;
+    /** 修改标题或 meta；revision 不是最新时抛出 PluginConflictError */
+    update(id: string, patch: PluginOwnEntityPatch, options: PluginWriteOptions): Promise<PluginOwnEntity>;
+    /**
+     * 删除一项及其正文；revision 不是最新时抛出 PluginConflictError。用户可在插件详情页
+     * 「最近删除」中 7 天内恢复，恢复后 ID、key 与正文不变，指向它的引用重新生效。
+     */
+    delete(id: string, options: PluginWriteOptions): Promise<void>;
+    /**
+     * 哪些卡片、文章、项目文档在正文里引用了这项内容。只返回插件已获准读取的类型，不询问权限；
+     * 其余来源（未获准的类型、日记、其他插件的内容）只计入 omitted。
+     */
+    backlinks(id: string): Promise<{
+        items: PluginOwnEntityBacklink[];
+        omitted: number;
+    }>;
+}

package/types/packages/plugins/src/errors.d.ts

@@ -0,0 +1,5 @@
+/** 写入时数据已被别处修改（expectedRevision 不是最新）：重新读取后再决定是否重试 */
+export declare class PluginConflictError extends Error {
+    readonly name = "PluginConflictError";
+    constructor(message?: string);
+}

package/types/packages/plugins/src/events.d.ts

@@ -0,0 +1,30 @@
+import type { Disposable } from "./contract";
+import type { PluginPermission } from "./permissions";
+/**
+ * 业务数据变更事件。事件只说明「哪一项变了」，不携带数据：需要时用 context.data 重新读取。
+ * 正文修改计入所属卡片、文章或项目文档的 updated；待办与日程只给出集合级变化。
+ */
+export declare const PLUGIN_EVENT_TYPES: readonly ["card.created", "card.updated", "card.deleted", "article.created", "article.updated", "article.deleted", "document.created", "document.updated", "document.deleted", "todos.changed", "calendar.changed", "workspace.reset"];
+export type PluginEventType = (typeof PLUGIN_EVENT_TYPES)[number];
+/** 变化来自哪里：插件经 context.data / context.content 写入时为 plugin，其余（用户、同步、AI 等）为 app */
+export type PluginEventOrigin = {
+    kind: "plugin";
+    pluginId: string;
+} | {
+    kind: "app";
+};
+export interface PluginDomainEvent {
+    type: PluginEventType;
+    /** 实体事件给出与 context.data 相同的 ID；集合级事件没有 */
+    id?: string;
+    /** 宿主发出事件的时间（毫秒） */
+    at: number;
+    /** 用来忽略自己写入引起的事件；待办与日程的集合级事件恒为 app */
+    origin: PluginEventOrigin;
+}
+/** 接收事件需要对应数据的读取权限；未获准时事件不送达，也不会弹窗询问 */
+export declare const PLUGIN_EVENT_PERMISSIONS: Record<PluginEventType, PluginPermission | null>;
+export declare const isPluginEventType: (value: unknown) => value is PluginEventType;
+export interface PluginEvents {
+    on(types: PluginEventType | readonly PluginEventType[], listener: (event: PluginDomainEvent) => void): Disposable;
+}

package/types/packages/plugins/src/icons.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentType, SVGProps } from "react";
+/**
+ * 插件提供的图标：线性单色 SVG 组件（如 lucide-react 图标或自绘组件），用 currentColor 跟随主题。
+ * 侧边栏条目与内容类型共用这一协议；宿主统一传入 size、strokeWidth、className 与 aria-hidden。
+ */
+export type PluginIconProps = SVGProps<SVGSVGElement> & {
+    size?: number | string;
+};
+export type PluginIcon = ComponentType<PluginIconProps>;

package/types/packages/plugins/src/index.d.ts

@@ -1,4 +1,5 @@
 import type { PluginDefinition } from "./contract";
+export type { PluginBackendClient, BackendStatus, BackendState } from "./backend";
 export type * from "./upload";
 export type * from "./tts";
 export type * from "./images";
@@ -10,8 +11,20 @@ export * from "./editor";
 export { SourceBlockEditor, useSourceBlock, useReportPreviewError, insertSourceBlock, sourceBlockParagraphBehavior, } from "./source-editor";
 export type { SourceBlockEditorProps, PluginRuntimeStyleCompiler } from "./source-editor";
 export { useInlineSource, insertInlineSource, InlineSourceBoundary } from "./inline-source";
+export { ContentEditor, ContentPreview } from "./components";
+export type { ContentEditorProps, ContentPreviewProps } from "./components";
 export * from "./sidebar";
+export type * from "./icons";
 export type * from "./excerpts";
+export type * from "./data";
+export type * from "./entities";
+export { PluginConflictError } from "./errors";
+export { PLUGIN_ENTITY_KINDS, PLUGIN_APP_ACTIONS, PLUGIN_EXPORT_FORMATS } from "./app";
+export type { PluginApp, PluginAppAction, PluginAppActions, PluginExportFormat, PluginEntityKind, PluginEntityRef, PluginPickOptions, PluginPickedEntity, } from "./app";
+export { PLUGIN_EVENT_TYPES } from "./events";
+export type { PluginDomainEvent, PluginEventOrigin, PluginEventType, PluginEvents } from "./events";
+export { PLUGIN_PERMISSIONS, PluginPermissionError, isPluginPermission } from "./permissions";
+export type { PluginPermission, PluginPermissions, PluginPermissionState, PluginPermissionDenial, } from "./permissions";
 export type * from "./services";
 export { usePluginServices } from "./service-access";
 export type { PluginSkill } from "./skills";

package/types/packages/plugins/src/package.d.ts

@@ -1,10 +1,14 @@
 export { assertLocalId } from "./ids";
 import { type PluginCategory } from "./categories";
+import { type PluginPermission } from "./permissions";
+import { type PluginBackendManifest } from "./backend-manifest";
+export { validateBackendManifest, PLUGIN_SYSTEM_ACCESS, type PluginBackendManifest, type PluginSystemAccess, } from "./backend-manifest";
 export { comparePluginVersions } from "./version";
 export { PLUGIN_CATEGORIES, PLUGIN_KEYWORD_LIMIT, PLUGIN_KEYWORD_MAX_LENGTH, isPluginCategory, type PluginCategory, } from "./categories";
+export { PLUGIN_PERMISSIONS, isPluginPermission, type PluginPermission } from "./permissions";
 export declare const PLUGIN_SHARED_MODULES: readonly ["@tau/plugins", "@tau/plugins/whiteboard", "@tau/plugins/sync", "@tau/ui", "react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"];
 export interface PluginManifest {
-    formatVersion: 1;
+    formatVersion: 1 | 2;
     id: string;
     name: string;
     version: string;
@@ -13,7 +17,7 @@ export interface PluginManifest {
     platform: "desktop";
     format: "cjs";
     main: string;
-    /** 无界面的同步存储入口，Node产物与UI入口分别校验。 */
+    backend?: PluginBackendManifest;
     styles?: string;
     /** 静态编辑器贡献在窗口启动时装配，启停需重启。 */
     editor?: true;
@@ -22,6 +26,8 @@ export interface PluginManifest {
     categories?: readonly PluginCategory[];
     /** 仅参与搜索匹配。 */
     keywords?: readonly string[];
+    /** 可申请的业务数据权限上限；实际授权由用户在调用时决定。 */
+    permissions?: readonly PluginPermission[];
     integrity: Record<string, string>;
 }
 /** 宿主内部传输的已读取产物，不属于作者运行时 API。 */
@@ -30,7 +36,7 @@ export interface DevelopmentPluginPackage {
     code: string;
     css?: string;
 }
-/** strict 供门户上传使用：分类或关键词不合规时报错，客户端默认静默丢弃。 */
+/** strict 供门户上传使用：分类、关键词或权限不合规时报错，客户端默认静默丢弃。 */
 export declare function validatePluginManifest(value: unknown, options?: {
     strict?: boolean;
 }): PluginManifest;

package/types/packages/plugins/src/permissions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 业务数据权限：manifest 的 permissions 声明插件可申请的上限，首次调用对应接口时由宿主
+ * 弹窗询问用户。read 读取，write 新建与修改（含正文），delete 删除（可在插件详情页恢复）。
+ * 插件与应用运行在同一环境，权限约束的是 SDK 接口，不是安全隔离。
+ */
+export declare const PLUGIN_PERMISSIONS: readonly ["cards:read", "cards:write", "cards:delete", "articles:read", "articles:write", "articles:delete", "documents:read", "documents:write", "todos:read", "todos:write", "todos:delete", "calendar:read", "calendar:write", "calendar:delete"];
+export type PluginPermission = (typeof PLUGIN_PERMISSIONS)[number];
+export declare const isPluginPermission: (value: unknown) => value is PluginPermission;
+/** granted：可直接调用；prompt：调用时会询问用户；denied：本次运行已拒绝或已被阻止 */
+export type PluginPermissionState = "granted" | "prompt" | "denied";
+/**
+ * undeclared：manifest 未声明；denied：用户拒绝；blocked：用户已阻止，需到插件详情页解除；
+ * unavailable：应用不在前台无法询问，请求已记入插件详情页等待用户处理。
+ */
+export type PluginPermissionDenial = "undeclared" | "denied" | "blocked" | "unavailable";
+export declare class PluginPermissionError extends Error {
+    readonly name = "PluginPermissionError";
+    readonly permission: PluginPermission;
+    readonly reason: PluginPermissionDenial;
+    constructor(permission: PluginPermission, reason: PluginPermissionDenial);
+}
+export interface PluginPermissions {
+    query(permission: PluginPermission): Promise<PluginPermissionState>;
+    /** 一次询问多项；全部获准时返回 true。已获准的不再询问。 */
+    request(permissions: readonly PluginPermission[]): Promise<boolean>;
+}
+/** 读取 manifest.permissions；strict 用于门户上传，客户端静默丢弃未知权限。 */
+export declare function readPermissionsField(item: Record<string, unknown>, strict: boolean): {
+    permissions?: readonly PluginPermission[];
+};

package/types/packages/plugins/src/services.d.ts

@@ -56,16 +56,6 @@ export interface PluginServices {
             css: string;
         }>;
     };
-    typst: {
-        compile(input: {
-            source: string;
-            format?: "html";
-            inputs?: Record<string, string>;
-            files?: ServiceFile[];
-        }, options?: ServiceOptions): Promise<{
-            html: string;
-        }>;
-    };
     markdown: {
         deserialize(source: string, options?: MarkdownServiceOptions): Promise<{
             nodes: Descendant[];

package/types/packages/plugins/src/sidebar.d.ts

@@ -1,10 +1,10 @@
 import type { Disposable } from "./contract";
 import type { PluginPageHandle, PluginPageParams } from "./pages";
-import type { ComponentType, SVGProps } from "react";
-export type PluginSidebarIconProps = SVGProps<SVGSVGElement> & {
-    size?: number | string;
-};
-export type PluginSidebarIcon = ComponentType<PluginSidebarIconProps>;
+import type { PluginIcon, PluginIconProps } from "./icons";
+/** 与 PluginIconProps 相同 */
+export type PluginSidebarIconProps = PluginIconProps;
+/** 与 PluginIcon 相同 */
+export type PluginSidebarIcon = PluginIcon;
 export declare const SIDEBAR_GROUPS: Readonly<{
     readonly daily: "daily";
     readonly knowledge: "knowledge";

package/types/packages/shared/entity-ref.d.ts

@@ -1,11 +1,11 @@
 /**
- * 统一实体地址：跨模块指向「一份正文的某个身份」（卡片、文章、项目文档、日记）。
+ * 统一实体地址：跨模块指向「一份正文的某个身份」（卡片、文章、项目文档、日记、插件内容）。
  *
  * 纯 TypeScript，桌面端与移动端共用。存量各处的类型写法（question_link 的 project_item、
  * content-link / 索引的 project-item）经 normalizeEntityRefKind 收口；
  * 日记正文身份为 diary-moment + 片段 id，存量日级引用在开库时转换。
  */
-export declare const ENTITY_REF_KINDS: readonly ["card", "article", "project-item", "diary-moment"];
+export declare const ENTITY_REF_KINDS: readonly ["card", "article", "project-item", "diary-moment", "plugin-entity"];
 export type EntityRefKind = (typeof ENTITY_REF_KINDS)[number];
 export interface EntityRef {
     kind: EntityRefKind;
@@ -15,5 +15,5 @@ export interface EntityRef {
 export declare function normalizeEntityRefKind(raw: unknown): EntityRefKind | null;
 export declare const entityRefKey: (ref: EntityRef) => string;
 export declare const isSameEntityRef: (a: EntityRef, b: EntityRef) => boolean;
-/** 同一份正文被多个实体共用时，选哪个身份作代表：卡片 > 文章 > 项目文档 > 日记 */
+/** 同一份正文被多个实体共用时，选哪个身份作代表：卡片 > 文章 > 项目文档 > 日记 > 插件内容 */
 export declare const ENTITY_REF_PRIORITY: Record<EntityRefKind, number>;