@xiongtao.xt/tau-plugins 0.26.0 → 0.27.0

package/AI.md

@@ -1,8 +1,49 @@
 # AI 服务
 
-此能力需要 SDK 0.7.0 及以上，以及支持插件 AI 服务的 Tau 客户端。
+自定义 AI 功能需要 SDK 0.7.0；申请应用已有的模型分配需要 SDK 0.27.0。两者都需要包含对应实现的 Tau 客户端。
 
-插件声明 AI 功能，由用户在插件详情的「设置 → AI 配置」分配已有模型并开启授权。全局「大语言模型」设置管理服务商和密钥；插件只能通过 `ctx.ai` 请求模型，接口不返回密钥、连接地址或用户的聊天历史。
+自定义 AI 功能由插件声明，用户在插件详情的「设置 → AI 配置」分配已有模型并开启授权。全局「大语言模型」设置管理服务商和密钥；这类功能通过 `ctx.ai` 请求模型，接口不返回密钥、连接地址或用户的聊天历史。
+
+## 使用应用已有模型分配
+
+无需声明 `ai.features` 或另配模型。先在 manifest 中声明 `ai:<能力名>` 权限，再申请对应客户端：
+
+```json
+{ "permissions": ["ai:titleSummary"] }
+```
+
+```ts
+const model = await context.ai.requestCapability("titleSummary");
+const result = await model.chat({
+  messages: [{ role: "user", content: "为这段文字拟一个简短标题：……" }],
+});
+console.log(result.text);
+```
+
+申请时由用户选择允许或拒绝；能力分别授权，未声明的申请会被拒绝。返回客户端提供 `chat(request)` 和 `stream(request)`，参数与下文自定义 AI 相同，但不传 `feature`。每次调用复核权限，撤权、停用或切库取消在途生成；额度、并发和用量审计按插件统计。缺少应用模型分配时明确失败，不自动选择其他模型。
+
+当前全部 12 项大模型功能分配均可申请，能力清单也可从 `PLUGIN_AI_CAPABILITIES` 导入：
+
+| 能力名                         | 沿用的应用分配 |
+| ------------------------------ | -------------- |
+| `chat`                         | 对话功能       |
+| `titleSummary`                 | 标题总结       |
+| `webClip`                      | 网页剪藏       |
+| `podcastGeneration`            | 播客生成       |
+| `flashcardGeneration`          | 闪卡生成       |
+| `aiJudgement`                  | 答案评判       |
+| `transcriptionOptimization`    | 转录断句优化   |
+| `videoSummary`                 | 视频总结       |
+| `videoEbookRewrite`            | 视频电子书重写 |
+| `vibeLearningImageDescription` | 图片理解       |
+| `contentMetadata`              | 笔记元信息     |
+| `contentInsights`              | AI 洞见        |
+
+这里复用模型分配，不自动执行宿主的业务流程或读取业务数据；插件传入自己的消息。已有闪卡业务流程由 `context.flashcards` 提供，它内部调用同一通用机制，需声明 `ai:flashcardGeneration`，详见 [FLASHCARDS.md](FLASHCARDS.md)。
+
+图片理解可在 user 消息中传入 `images: [{ data: imageBase64, mimeType: "image/png" }]`。`data` 不带 data: 前缀；支持 PNG、JPEG、WebP、GIF，每条消息最多 10 张，整次请求的 Base64 总长最多 20 MiB，模型须支持图片。图片与消息正文不会写入用量审计。
+
+## 声明自定义 AI 功能
 
 ```ts
 import { definePlugin } from "@tau/plugins";

package/API.md

@@ -2,7 +2,7 @@
 
 本文介绍编写命令、页面、侧边栏、设置、数据存储、网络请求和摘录所需的接口。插件接口从 `@tau/plugins` 导入，界面组件从 `@tau/ui` 导入。所述能力需要 Tau 0.59.0 或更高版本。
 
-本文对应 SDK 0.26.0；最低客户端版本只负责版本门槛，使用新领域接口时仍需包含对应实现的客户端构建。SDK 升级步骤见 [DEVELOPMENT.md](DEVELOPMENT.md#升级-sdk-与同步旧模板)。独立后台与双入口构建见 [BACKEND.md](BACKEND.md)。
+本文对应 SDK 0.27.0；最低客户端版本只负责版本门槛，使用新领域接口时仍需包含对应实现的客户端构建。SDK 升级步骤见 [DEVELOPMENT.md](DEVELOPMENT.md#升级-sdk-与同步旧模板)。独立后台与双入口构建见 [BACKEND.md](BACKEND.md)。
 
 博客发布提供方见 [PUBLISH.md](PUBLISH.md)，需要 SDK 0.21.0 和包含该能力的客户端；独立博客站点读取数据见 [PUBLISH-DATA.md](PUBLISH-DATA.md)。
 
@@ -10,7 +10,7 @@
 
 AI 功能声明、用户模型分配、流式对话、取消与统一用量审计见 [AI.md](AI.md)（SDK 0.7.0 及以上）。
 
-创建闪卡、卡组、打开宿主手动/AI 制卡窗口及显式自动保存见 [FLASHCARDS.md](FLASHCARDS.md)，需要 SDK 0.26.0 和包含该能力的客户端构建。
+创建闪卡、卡组、打开宿主手动/AI 制卡窗口及显式自动保存见 [FLASHCARDS.md](FLASHCARDS.md)，需要 SDK 0.27.0 和包含该能力的客户端构建。
 
 白板扩展契约见 [WHITEBOARD.md](WHITEBOARD.md)，需要 SDK 0.8.0 及以上。
 
@@ -519,6 +519,7 @@ function NoteActions({ context, target }: { context: PluginContext; target: Plug
 | `todos:read` / `todos:write` / `todos:delete`          | `context.data.todos` 的查询、新建与修改、删除                   |
 | `calendar:read` / `calendar:write` / `calendar:delete` | `context.data.calendar` 的查询、新建与修改、删除                |
 | `flashcards:read` / `flashcards:write`                 | 查询卡组 / 创建卡组与闪卡、自动保存，见 FLASHCARDS.md           |
+| `ai:<能力名>`                                          | 申请应用已有 AI 模型分配，全部能力及用法见 AI.md                |
 
 插件第一次调用某个接口时，Tau 会弹窗询问用户：「仅这次」在插件停用或应用重启前有效，「始终允许」保存到用户撤销为止，「拒绝」在本次运行内不再询问，连续拒绝 3 次后转为已阻止。应用不在前台时不弹窗，请求会记在插件详情页的「权限」中等待用户处理。用户可以随时在那里撤销。
 

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新记录
 
+## 0.27.0
+
+- 新增通用 `context.ai.requestCapability(name)`，开放应用全部 12 项大模型功能分配。每项声明 `ai:<能力名>` 并由用户独立授权，返回 `chat/stream` 客户端，不需要另配模型或声明自定义 AI 功能。
+- 闪卡 AI 制作使用此通用入口，权限为 `ai:flashcardGeneration`；不再要求传入 `feature`。支持在 user 消息中附带图片，图片不进入用量审计。
+- 宿主模型仍经插件额度、并发限制与用量审计执行；撤销闪卡 AI 权限会取消在途请求，应用未配模型或分配变化时明确失败。
+- 插件自定义 AI 的原有声明、授权与模型分配保持独立；闪卡读写权限和 `contentRef` 来源校验沿用 0.26.0。
+
 ## 0.26.0
 
 - 新增 `context.flashcards`：查询与创建卡组、创建闪卡、宿主制卡窗口、AI 草稿与自动保存；直接读写经 `flashcards:read/write` 授权。

package/DEVELOPMENT.md

@@ -8,7 +8,7 @@
 - pnpm 11.9.0
 - Tau 桌面客户端 0.59.0 或更高版本
 
-模板锁定公开 SDK `@xiongtao.xt/tau-plugins@0.26.0` 和 UI `@xiongtao.xt/tau-ui@0.1.1`，通过 npm 别名安装为 `@tau/plugins`、`@tau/ui`。SDK 提供类型契约，运行实现由 Tau 注入；新领域能力还需包含相应实现的客户端构建，不能只依据客户端版本号判断。
+模板锁定公开 SDK `@xiongtao.xt/tau-plugins@0.27.0` 和 UI `@xiongtao.xt/tau-ui@0.1.1`，通过 npm 别名安装为 `@tau/plugins`、`@tau/ui`。SDK 提供类型契约，运行实现由 Tau 注入；新领域能力还需包含相应实现的客户端构建，不能只依据客户端版本号判断。
 
 ## 跑通示例
 
@@ -63,10 +63,10 @@ pnpm install:local
 
 GitHub 模板创建的仓库不会自动跟随模板更新。已有项目先提交或备份自己的改动，再按需同步 [上游模板](https://github.com/LastKnightCoder/tau-plugin-template) 的构建脚本、开发文档和 `.github/workflows/release.yml`，保留自己的插件 ID、入口、用户说明与版本记录。
 
-先在 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 中增加新 SDK 的精确例外 `@xiongtao.xt/tau-plugins@0.26.0`，暂时保留旧锁文件所需的已核实例外，再更新依赖及锁文件：
+先在 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 中增加新 SDK 的精确例外 `@xiongtao.xt/tau-plugins@0.27.0`，暂时保留旧锁文件所需的已核实例外，再更新依赖及锁文件：
 
 ```sh
-pnpm add @tau/plugins@npm:@xiongtao.xt/tau-plugins@0.26.0 --save-exact
+pnpm add @tau/plugins@npm:@xiongtao.xt/tau-plugins@0.27.0 --save-exact
 pnpm install --frozen-lockfile
 pnpm build
 ```
@@ -75,17 +75,18 @@ pnpm build
 
 从旧 SDK 升级时，重点核对：
 
-| 版本          | 变化与对应文档                                                                                     |
-| ------------- | -------------------------------------------------------------------------------------------------- |
-| 0.17.0        | 行内源码接口，见 EDITOR.md                                                                         |
-| 0.18.0        | 图片生成与编辑提供方，见 IMAGES.md                                                                 |
-| 0.19.0–0.20.0 | 发布数据子入口、站点级数据归清单、分类与关键词，见 PUBLISH-DATA.md 与 API.md                       |
-| 0.21.0        | 博客发布提供方、配置与 Git 快照服务，见 PUBLISH.md                                                 |
-| 0.22.0        | 视频提供方与视频页面信息查询，见 VIDEO.md                                                          |
-| 0.23.0        | 删除 `ffmpeg.probe` 与 `MediaInfo`；`ffmpeg.run` 保留，见 SERVICES.md                              |
-| 0.24.0        | 删除 `services.typst`；Typst 编译由独立插件实现，见 SERVICES.md                                    |
-| 0.25.0        | 数据读写与权限、正文组件、插件实体、宿主动作、存储随库同步，见 API.md；本机后台双入口见 BACKEND.md |
-| 0.26.0        | 闪卡创建、读写授权、插件 AI 制卡与 contentRef 来源引用，见 FLASHCARDS.md                           |
+| 版本          | 变化与对应文档                                                                                         |
+| ------------- | ------------------------------------------------------------------------------------------------------ |
+| 0.17.0        | 行内源码接口，见 EDITOR.md                                                                             |
+| 0.18.0        | 图片生成与编辑提供方，见 IMAGES.md                                                                     |
+| 0.19.0–0.20.0 | 发布数据子入口、站点级数据归清单、分类与关键词，见 PUBLISH-DATA.md 与 API.md                           |
+| 0.21.0        | 博客发布提供方、配置与 Git 快照服务，见 PUBLISH.md                                                     |
+| 0.22.0        | 视频提供方与视频页面信息查询，见 VIDEO.md                                                              |
+| 0.23.0        | 删除 `ffmpeg.probe` 与 `MediaInfo`；`ffmpeg.run` 保留，见 SERVICES.md                                  |
+| 0.24.0        | 删除 `services.typst`；Typst 编译由独立插件实现，见 SERVICES.md                                        |
+| 0.25.0        | 数据读写与权限、正文组件、插件实体、宿主动作、存储随库同步，见 API.md；本机后台双入口见 BACKEND.md     |
+| 0.26.0        | 闪卡创建、读写授权、插件 AI 制卡与 contentRef 来源引用，见 FLASHCARDS.md                               |
+| 0.27.0        | 通用 requestCapability 开放全部内置大模型功能分配，分别以 ai:<能力名> 授权；闪卡复用同一机制，见 AI.md |
 
 更早版本的完整变更见已安装包的 `node_modules/@tau/plugins/CHANGELOG.md`。需要本地媒体元数据时自行实现，不能把视频页面解析当作本地文件探测。SDK 根入口、白板/同步契约、UI 和 React 由 Tau 提供，保持模板的 external 配置；普通第三方库由构建打入 ZIP。独立站点数据子入口的用途另见 PUBLISH-DATA.md。
 

package/FLASHCARDS.md

@@ -1,27 +1,24 @@
 # 闪卡能力
 
-需要 SDK 0.26.0 和支持闪卡接口的 Tau 0.59.0 客户端构建。能力通过激活时的 `context.flashcards` 使用，绑定本次激活的数据库；停用、切库后旧调用失效。旧客户端可用 `if (!context.flashcards)` 检查是否支持。
+本文对应 SDK 0.27.0 和支持闪卡接口的 Tau 0.59.0 客户端构建。能力通过激活时的 `context.flashcards` 使用，绑定本次激活的数据库；停用、切库后旧调用失效。旧客户端可用 `if (!context.flashcards)` 检查是否支持。
 
 ## 权限与 AI 配置
 
 直接查询卡组需在 manifest 声明 `flashcards:read`，直接创建卡组、闪卡及自动保存需声明 `flashcards:write`；使用时由用户授权，可在插件详情页撤销。引用已有正文还需对应实体的读取权限；本插件自有正文沿用免业务权限规则。打开宿主窗口必须来自用户点击或按键，窗口内的创建由用户确认，不需要闪卡读写权限。
 
-AI 调用使用插件声明的功能，先在 `definePlugin` 中配置：
+AI 制卡直接复用应用「闪卡生成」已分配的模型，不需要声明插件自己的 AI 功能或再次选择模型。在 manifest 中声明要申请的能力：
 
-```ts
-ai: {
-  features: [{ id: "cards", name: "AI 制卡" }];
-}
+```json
+{ "permissions": ["flashcards:read", "flashcards:write", "ai:flashcardGeneration"] }
 ```
 
-随后由用户在插件设置中分配模型并开启 AI 授权；所有 AI 入口传 `feature: "cards"`，沿用插件的并发、每日额度和用量审计，失败不会回退到应用模型。详情见 AI.md。
+内部通过通用的 `context.ai.requestCapability("flashcardGeneration")` 申请“使用闪卡制作 AI”，可在插件的「权限」页撤销，撤权会取消在途生成。主进程读取应用现有模型分配，按插件身份记录用量并限制并发和每日额度；额度可在插件 AI 设置中调整。应用未配置闪卡模型时明确报错。申请其他内置模型分配或声明自己的 AI 功能见 AI.md。
 
 ## 打开宿主制卡窗口
 
 ```ts
 const result = await context.flashcards.openCreate({
   mode: "ai", // manual 为手动制卡，缺省为 manual
-  feature: "cards",
   content: "牛顿第二定律：F = ma。", // Markdown 或 Descendant[]
   title: "力学笔记",
   // deckId: 123, // 可选；省略时先选择卡组，也可以现场新建卡组
@@ -42,7 +39,6 @@ AI 模式自动开始生成并展示预览，可选择、编辑后保存；手
 ```ts
 await context.flashcards.openCreate({
   mode: "ai",
-  feature: "cards",
   content: sourceContent,
   references: [{ refType: "content", contentRef: sourceContentRef, title: "原文" }],
 });
@@ -78,7 +74,6 @@ const card = await context.flashcards.createCard({
 const drafts = await context.flashcards.generate({
   content: "需要学习的内容",
   title: "资料",
-  feature: "cards",
 });
 
 // 只有明确调用此方法才绕过预览，直接保存。
@@ -86,12 +81,11 @@ const result = await context.flashcards.generateAndSave({
   content: "需要学习的内容",
   title: "资料",
   deckId: deck.id,
-  feature: "cards",
 });
 // result.cards：成功保存的记录；result.failed：失败项的零基下标和 message。
 ```
 
-AI 经 `context.ai` 使用用户为该插件功能分配的模型，不读取或导出密钥。没有模型配置、未授权、额度不足或内容为空时明确失败，不自动选择其他模型。
+AI 沿用应用的闪卡制作模型，不读取或导出密钥。没有模型配置、未授权、额度不足或内容为空时明确失败，不自动选择其他模型；AI 模型变更后下一次调用使用新分配，已经进入准备过程的请求若发现分配改变会拒绝并要求重试。
 
 自动保存先校验全部草稿，再逐张写入；不承诺整批事务。不要对整个自动保存调用盲目重试，否则会重复创建成功项。需要精确重试时，使用 `generate` 保留草稿并逐张 `createCard`。取消与切库阻止后续写入，已发出的写入可能已在原库提交，不能将取消理解为事务回滚。
 

package/client/{chunk-2UDW3NLX.js → chunk-R3YIHOWT.js}

@@ -85,7 +85,27 @@ function readCatalogFields(item, strict) {
   };
 }
 
+// packages/plugins/src/ai.ts
+var PLUGIN_AI_CAPABILITIES = {
+  chat: { name: "\u5BF9\u8BDD\u529F\u80FD" },
+  titleSummary: { name: "\u6807\u9898\u603B\u7ED3" },
+  webClip: { name: "\u7F51\u9875\u526A\u85CF" },
+  podcastGeneration: { name: "\u64AD\u5BA2\u751F\u6210" },
+  flashcardGeneration: { name: "\u95EA\u5361\u5236\u4F5C" },
+  aiJudgement: { name: "\u7B54\u6848\u8BC4\u5224" },
+  transcriptionOptimization: { name: "\u8F6C\u5F55\u65AD\u53E5\u4F18\u5316" },
+  videoSummary: { name: "\u89C6\u9891\u603B\u7ED3" },
+  videoEbookRewrite: { name: "\u89C6\u9891\u7535\u5B50\u4E66\u91CD\u5199" },
+  vibeLearningImageDescription: { name: "\u56FE\u7247\u7406\u89E3" },
+  contentMetadata: { name: "\u7B14\u8BB0\u5143\u4FE1\u606F" },
+  contentInsights: { name: "AI \u6D1E\u89C1" }
+};
+var isPluginAICapability = (value) => typeof value === "string" && Object.hasOwn(PLUGIN_AI_CAPABILITIES, value);
+
 // packages/plugins/src/permissions.ts
+var aiPermissions = Object.keys(PLUGIN_AI_CAPABILITIES).map(
+  (capability) => `ai:${capability}`
+);
 var PLUGIN_PERMISSIONS = [
   "cards:read",
   "cards:write",
@@ -102,7 +122,8 @@ var PLUGIN_PERMISSIONS = [
   "calendar:write",
   "calendar:delete",
   "flashcards:read",
-  "flashcards:write"
+  "flashcards:write",
+  ...aiPermissions
 ];
 var permissionIds = new Set(PLUGIN_PERMISSIONS);
 var isPluginPermission = (value) => typeof value === "string" && permissionIds.has(value);
@@ -273,6 +294,8 @@ export {
   PLUGIN_KEYWORD_LIMIT,
   PLUGIN_KEYWORD_MAX_LENGTH,
   isPluginCategory,
+  PLUGIN_AI_CAPABILITIES,
+  isPluginAICapability,
   PLUGIN_PERMISSIONS,
   isPluginPermission,
   PLUGIN_SYSTEM_ACCESS,

package/package.js

@@ -1,4 +1,5 @@
 import {
+  PLUGIN_AI_CAPABILITIES,
   PLUGIN_CATEGORIES,
   PLUGIN_KEYWORD_LIMIT,
   PLUGIN_KEYWORD_MAX_LENGTH,
@@ -8,12 +9,14 @@ import {
   assertLocalId,
   comparePluginVersions,
   isContentPlugin,
+  isPluginAICapability,
   isPluginCategory,
   isPluginPermission,
   validateBackendManifest,
   validatePluginManifest
-} from "./client/chunk-2UDW3NLX.js";
+} from "./client/chunk-R3YIHOWT.js";
 export {
+  PLUGIN_AI_CAPABILITIES,
   PLUGIN_CATEGORIES,
   PLUGIN_KEYWORD_LIMIT,
   PLUGIN_KEYWORD_MAX_LENGTH,
@@ -23,6 +26,7 @@ export {
   assertLocalId,
   comparePluginVersions,
   isContentPlugin,
+  isPluginAICapability,
   isPluginCategory,
   isPluginPermission,
   validateBackendManifest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiongtao.xt/tau-plugins",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/publish-artifacts.js

@@ -1,7 +1,7 @@
 import {
   PLUGIN_SHARED_MODULES,
   validatePluginManifest
-} from "./client/chunk-2UDW3NLX.js";
+} from "./client/chunk-R3YIHOWT.js";
 
 // packages/plugins/src/rendering.ts
 var PLUGIN_RENDER_VERSION = 1;

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

@@ -3,12 +3,62 @@ export interface PluginAIFeature {
     name: string;
     description?: string;
 }
+export declare const PLUGIN_AI_CAPABILITIES: {
+    readonly chat: {
+        readonly name: "对话功能";
+    };
+    readonly titleSummary: {
+        readonly name: "标题总结";
+    };
+    readonly webClip: {
+        readonly name: "网页剪藏";
+    };
+    readonly podcastGeneration: {
+        readonly name: "播客生成";
+    };
+    readonly flashcardGeneration: {
+        readonly name: "闪卡制作";
+    };
+    readonly aiJudgement: {
+        readonly name: "答案评判";
+    };
+    readonly transcriptionOptimization: {
+        readonly name: "转录断句优化";
+    };
+    readonly videoSummary: {
+        readonly name: "视频总结";
+    };
+    readonly videoEbookRewrite: {
+        readonly name: "视频电子书重写";
+    };
+    readonly vibeLearningImageDescription: {
+        readonly name: "图片理解";
+    };
+    readonly contentMetadata: {
+        readonly name: "笔记元信息";
+    };
+    readonly contentInsights: {
+        readonly name: "AI 洞见";
+    };
+};
+export type PluginAICapability = keyof typeof PLUGIN_AI_CAPABILITIES;
+export declare const isPluginAICapability: (value: unknown) => value is PluginAICapability;
+export interface PluginAIImage {
+    /** 不带 data: 前缀的 Base64 图片字节。 */
+    data: string;
+    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+}
+export type PluginAIMessage = {
+    role: "system" | "assistant";
+    content: string;
+} | {
+    role: "user";
+    content: string;
+    images?: readonly PluginAIImage[];
+};
 export interface PluginAIRequest {
     feature: string;
-    messages: readonly {
-        role: "system" | "user" | "assistant";
-        content: string;
-    }[];
+    messages: readonly PluginAIMessage[];
     maxOutputTokens?: number;
     signal?: AbortSignal;
 }
@@ -28,7 +78,7 @@ export type PluginAIEvent = {
     type: "done";
     result: PluginAIResult;
 };
-export interface PluginAI {
+export interface PluginAIFeatures {
     getStatus(feature: string): Promise<{
         configured: boolean;
         enabled: boolean;
@@ -37,4 +87,13 @@ export interface PluginAI {
     chat(request: PluginAIRequest): Promise<PluginAIResult>;
     stream(request: PluginAIRequest): AsyncIterable<PluginAIEvent>;
 }
+export type PluginAICapabilityRequest = Omit<PluginAIRequest, "feature">;
+export interface PluginAICapabilityClient {
+    chat(request: PluginAICapabilityRequest): Promise<PluginAIResult>;
+    stream(request: PluginAICapabilityRequest): AsyncIterable<PluginAIEvent>;
+}
+export interface PluginAI extends PluginAIFeatures {
+    /** 申请使用应用已有模型分配的 AI 能力；需在 manifest 声明对应 ai:<能力名> 权限。 */
+    requestCapability(capability: PluginAICapability): Promise<PluginAICapabilityClient>;
+}
 export declare const unavailableAI: PluginAI;

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

@@ -52,8 +52,6 @@ export interface PluginCreatedFlashcard extends PluginFlashcardDraft {
 }
 export interface PluginFlashcardCreateOptions {
     mode?: "manual" | "ai";
-    /** AI 模式使用插件 ai.features 中声明的功能，由用户分配模型并授权。 */
-    feature?: string;
     /** 字符串按 Markdown 导入；富文本按当前编辑器节点协议传入。 */
     content?: string | Descendant[];
     title?: string;
@@ -83,11 +81,9 @@ export interface PluginFlashcards {
     /** 仅生成草稿；自动落库须显式调用 generateAndSave。 */
     generate(options: Omit<PluginFlashcardCreateOptions, "mode" | "deckId"> & {
         content: string | Descendant[];
-        feature: string;
     }): Promise<PluginFlashcardDraft[]>;
     generateAndSave(options: Omit<PluginFlashcardCreateOptions, "mode"> & {
         content: string | Descendant[];
         deckId: number;
-        feature: string;
     }): Promise<PluginFlashcardBatchResult>;
 }

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

@@ -34,4 +34,5 @@ export type { PluginMCPToolResult } from "./mcp";
 export type { PluginChat, PluginToolRendererDefinition, PluginToolRendererProps, ToolCallExecutionState, } from "./chat";
 export type { PluginPageDefinition, PluginPageHandle, PluginPageParams, PluginPageProps, PluginPages, } from "./pages";
 export declare function definePlugin(definition: Omit<PluginDefinition, "apiVersion" | "create"> & Partial<Pick<PluginDefinition, "create">>): PluginDefinition;
-export type { PluginAI, PluginAIFeature, PluginAIRequest, PluginAIResult, PluginAIEvent, } from "./ai";
+export type { PluginAI, PluginAIFeature, PluginAIRequest, PluginAIResult, PluginAIEvent, PluginAIFeatures, PluginAICapability, PluginAICapabilityClient, PluginAICapabilityRequest, PluginAIImage, PluginAIMessage, } from "./ai";
+export { PLUGIN_AI_CAPABILITIES, isPluginAICapability } from "./ai";

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

@@ -6,6 +6,7 @@ export { validateBackendManifest, PLUGIN_SYSTEM_ACCESS, type PluginBackendManife
 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 { PLUGIN_AI_CAPABILITIES, isPluginAICapability } from "./ai";
 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 | 2;

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

@@ -1,9 +1,4 @@
-/**
- * 业务数据权限：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", "flashcards:read", "flashcards:write"];
+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", "flashcards:read", "flashcards:write", ...("ai:chat" | "ai:titleSummary" | "ai:webClip" | "ai:podcastGeneration" | "ai:flashcardGeneration" | "ai:aiJudgement" | "ai:transcriptionOptimization" | "ai:videoSummary" | "ai:videoEbookRewrite" | "ai:vibeLearningImageDescription" | "ai:contentMetadata" | "ai:contentInsights")[]];
 export type PluginPermission = (typeof PLUGIN_PERMISSIONS)[number];
 export declare const isPluginPermission: (value: unknown) => value is PluginPermission;
 /** granted：可直接调用；prompt：调用时会询问用户；denied：本次运行已拒绝或已被阻止 */