@xiongtao.xt/tau-plugins 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 更新记录
+
+## 0.14.0
+
+- 移除 `PluginServices.tikz` 和 `context.services.tikz.compile`。TikZ 编译、字体与文档块由独立插件 tau.tikz 提供，宿主不再保留编译实现或转发入口。
+- 插件作者如需 TikZ 绘图，应由自己的插件携带实现；其他宿主编译与转换服务保持不变。
+- 保留 0.13.0 的 TTS、资源上传及其生命周期接口。

package/EDITOR.md

@@ -93,7 +93,7 @@ export default definePlugin({
 
 ## 块会在哪里显示
 
-块除了显示在桌面编辑器里，还会出现在移动端、浏览器扩展和用户发布的网页中，这些地方都直接使用你在 `elements.render` 中写的同一个组件，不需要另写入口。因此渲染代码要满足：
+块显示在桌面编辑器和用户发布的博客中，两处直接使用 `elements.render` 中的同一个组件，不需要另写入口。移动端与浏览器扩展不加载插件，遇到插件节点保留原数据并显示通用占位。因此渲染代码要满足：
 
 - 模块顶层和渲染组件能在浏览器中运行，不导入 Electron、Node 或 Tau 客户端内部路径。
 - 不依赖 `activate` 中才赋值的变量，也不调用 `context` 的存储、页面、服务等桌面能力。

package/SERVICES.md

@@ -1,6 +1,6 @@
 # 编译与转换服务
 
-需要在插件里编译 Tailwind、Typst、TikZ，转换 Markdown，或处理音视频时，可以使用这些服务。通过 `context.services` 调用，类型从 `@tau/plugins` 导入，需要 Tau 0.59.0 或更高版本。
+需要在插件里编译 Tailwind、Typst，转换 Markdown，或处理音视频时，可以使用这些服务。通过 `context.services` 调用，类型从 `@tau/plugins` 导入，需要 Tau 0.59.0 或更高版本。TikZ 编译属于独立绘图插件，不再提供宿主服务。
 
 所有服务都是异步方法，只处理传入数据并返回结果，不读写笔记、不选择或保存文件、不自动注入样式。
 
@@ -13,7 +13,6 @@
 | `markdown.deserialize(source, options?)` | Markdown 字符串                                   | `{ nodes: Descendant[], warnings }` |
 | `markdown.serialize(nodes, options?)`    | `Descendant[]`                                    | `{ markdown, warnings }`            |
 | `markdown.render(source, options?)`      | Markdown 字符串                                   | `{ html, css, warnings }`           |
-| `tikz.compile(input, options?)`          | `{ source }`，包含 `tikzpicture` 环境             | `{ svg }`                           |
 | `ffmpeg.probe(file, options?)`           | `{ name, data: Blob }`                            | `{ format, streams }`               |
 | `ffmpeg.run(input, options?)`            | `{ files, args, outputs }`                        | `{ files, log }`                    |
 
@@ -99,18 +98,6 @@ const result = await context.services.markdown.serialize(nodes, {
 
 HTML 渲染不自动执行 TikZ、Typst、Mermaid 编译器；相关节点可能显示源码并返回 `DISPLAY_FALLBACK`，音视频可能显示链接。原始 HTML 和远程资源按客户端导出规则保留，输出不是经过净化的 HTML。`css` 是本次生成内容附带的样式，不包含完整 Tau 页面主题，也不打包图片附件。
 
-## TikZ
-
-```ts
-const { svg } = await context.services.tikz.compile({
-  source: String.raw`\begin{tikzpicture}
-  \draw (0,0) -- (1,1);
-\end{tikzpicture}`,
-});
-```
-
-不要添加 `documentclass` 或 `document` 环境。服务负责包装，返回包含字体样式的 SVG 字符串。这不是完整 LaTeX 文档编译器，不提供任意宏包安装。语法或宏包不支持时明确报错；单次最长 120 秒，可通过 signal 提前取消。
-
 ## FFmpeg
 
 `ServiceFile` 为 `{ name: string, data: Blob }`；文件名仅在任务内使用，不是客户端路径。输入输出名称不得重复，目录使用 `/`。文件整体经内存传输，适合可以放进内存的素材，不支持大文件流式处理。

package/TTS.md

@@ -0,0 +1,20 @@
+# 语音提供方
+
+需要 SDK 0.13.0 和包含语音插件能力的 Tau 0.59.0 客户端。
+
+在activate中调用context.tts.register({id: context.pluginId, name, create})。create(config, modelId)同步创建任务实例，固定该账号配置和模型，不发送网络请求。每个插件可对应多个用户账号，不能用插件全局变量保存“当前API Key”。
+
+| 方法或字段                                         | 职责                                                                                |
+| -------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| getVoices(signal)                                  | 返回id、name、type（system/cloned/custom）、可选description组成的音色数组           |
+| synthesize({text,voiceId,options},signal)          | 返回{audio:Uint8Array,mime:string}；options仅含speed、volume、pitch                 |
+| cloneVoice({file,requestedId?,name?},signal)，可选 | 每次一个{name,mimeType,content}参考文件，返回实际创建的音色；不返回上传文件ID或void |
+| textInstructions，可选                             | 当前模型的合成文本规则；供宿主播客脚本使用，缺省为纯文本                            |
+
+请求使用context.fetch并传入方法收到的signal。服务商超时用AbortSignal.any组合，不能覆盖取消信号；退避等待也须取消，不把AbortError当作可重试错误。
+
+配置通过settings.register的target:"tts"挂载。组件接收ttsConfig.instanceId、value、models和save(value,models)，只保存当前账号，不自动选为默认，不覆盖同插件其他账号。模型项为{id,label?}；用户可填写自定义模型。保存失败保留表单并显示错误，不另存一份凭据到context.storage。
+
+需要公开上传参考音频时调用context.upload.uploadRemote(file,{signal})，复用用户选定的远端上传配置。本地模式明确报错；MiniMax自有文件上传不需要图床。不要自行选择用户的上传插件、读取上传凭据或修改桶权限。
+
+主进程只转发数据和提供宿主能力。插件在主窗口渲染进程执行，不使用Node后台入口。宿主负责音频播放、合并和保存；插件不直接写笔记或文件。

package/UPLOAD.md

@@ -2,16 +2,18 @@
 
 需要 SDK 0.12.0 和包含资源上传插件能力的 Tau 0.59.0 客户端。上传返回正文可直接引用的 HTTP(S) 地址；数据库和资源目录同步使用 SYNC.md 的另一套接口。
 
+SDK 0.13.0 增加第三个signal参数与context.upload.uploadRemote(file,{signal})。提供方应将signal合并进context.fetch请求；调用方使用uploadRemote时，本地目标明确报错，不自动更换存储。signal取消会结束等待并通知提供方，不代表撤回已经上传的远端对象。
+
 在 activate 中注册提供方：
 
 ```tsx
 context.upload.register({
   id: context.pluginId,
   name: "我的资源存储",
-  async upload(file, config) {
+  async upload(file, config, signal) {
     // 用 context.fetch 请求服务商，认证与路径由本次 config 决定。
     // file.name 已唯一命名，file.mimeType 是 MIME，file.content 为 Uint8Array。
-    return uploadToStorage(context.fetch, file, config);
+    return uploadToStorage(context.fetch, file, config, signal);
   },
 });
 context.settings.register({

package/package.json

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

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

@@ -9,6 +9,7 @@ import type { MarkdownCodec } from "../../markdown/src/index";
 import type { PluginSettings } from "./settings";
 import type { PluginSync } from "./sync";
 import type { PluginUpload } from "./upload";
+import type { PluginTTS } from "./tts";
 import type { PluginSidebar } from "./sidebar";
 import type { PluginExcerpts, PluginMaterials } from "./excerpts";
 import type { PluginMCP } from "./mcp";
@@ -41,6 +42,7 @@ export interface PluginContext {
     readonly settings: PluginSettings;
     readonly sync: PluginSync;
     readonly upload: PluginUpload;
+    readonly tts: PluginTTS;
     readonly sidebar: PluginSidebar;
     readonly excerpts: PluginExcerpts;
     readonly materials: PluginMaterials;

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

@@ -1,5 +1,6 @@
 import type { PluginDefinition } from "./contract";
 export type * from "./upload";
+export type * from "./tts";
 export type { JsonValue, Disposable, PluginStorage, PluginCommand, PluginContext, PluginInstance, PluginDefinition, } from "./contract";
 export type { PluginSettings, PluginSettingsDefinition, PluginSettingsProps, PluginSettingsHandle, } from "./settings";
 export * from "./editor";

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

@@ -74,13 +74,6 @@ export interface PluginServices {
             warnings: ServiceWarning[];
         }>;
     };
-    tikz: {
-        compile(input: {
-            source: string;
-        }, options?: ServiceOptions): Promise<{
-            svg: string;
-        }>;
-    };
     ffmpeg: {
         probe(input: ServiceFile, options?: ServiceOptions): Promise<MediaInfo>;
         /** args 中用任务文件名引用输入和输出；不接受 shell 命令。 */

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

@@ -3,6 +3,18 @@ import type { Disposable, PluginContext } from "./index";
 import type { JsonValue } from "./json";
 export interface PluginSettingsProps {
     readonly context: PluginContext;
+    readonly ttsConfig?: {
+        readonly instanceId: string;
+        readonly value: JsonValue;
+        readonly models: readonly {
+            id: string;
+            label?: string;
+        }[];
+        save(value: JsonValue, models: readonly {
+            id: string;
+            label?: string;
+        }[]): Promise<void>;
+    };
     readonly uploadConfig?: {
         readonly value: JsonValue;
         save(value: JsonValue): Promise<void>;
@@ -16,8 +28,8 @@ export interface PluginSettingsDefinition {
     id: string;
     title: string;
     description?: string;
-    /** 同步提供方的配置表单挂载到宿主同步设置。 */
-    target?: "sync" | "upload";
+    /** 提供方配置表单挂载到对应宿主设置；普通插件设置省略。 */
+    target?: "sync" | "upload" | "tts";
     component: ComponentType<PluginSettingsProps>;
 }
 export interface PluginSettingsHandle extends Disposable {
@@ -25,6 +37,6 @@ export interface PluginSettingsHandle extends Disposable {
     open(): Promise<void>;
 }
 export interface PluginSettings {
-    /** 分区随本次激活回收，保存使用 context.storage。 */
+    /** 分区随本次激活回收；提供方保存使用配置属性，普通设置使用 context.storage。 */
     register(definition: PluginSettingsDefinition): PluginSettingsHandle;
 }

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

@@ -0,0 +1,42 @@
+import type { Disposable, JsonValue } from "./contract";
+import type { UploadFile } from "./upload";
+export interface TTSVoice {
+    id: string;
+    name: string;
+    type: "system" | "cloned" | "custom";
+    description?: string;
+}
+export interface TTSSynthesizeOptions {
+    speed?: number;
+    volume?: number;
+    pitch?: number;
+}
+export interface TTSSynthesizeRequest {
+    text: string;
+    voiceId: string;
+    options?: TTSSynthesizeOptions;
+}
+export interface TTSAudio {
+    audio: Uint8Array;
+    mime: string;
+}
+export interface TTSCloneRequest {
+    file: UploadFile;
+    requestedId?: string;
+    name?: string;
+}
+export interface TTSInstance {
+    readonly textInstructions?: string;
+    getVoices(signal: AbortSignal): Promise<TTSVoice[]>;
+    synthesize(request: TTSSynthesizeRequest, signal: AbortSignal): Promise<TTSAudio>;
+    cloneVoice?(request: TTSCloneRequest, signal: AbortSignal): Promise<TTSVoice>;
+}
+export interface TTSProviderDefinition {
+    id: string;
+    name: string;
+    /** 每次任务固定配置和模型，创建时不发网络请求。 */
+    create(config: JsonValue, modelId: string): TTSInstance;
+}
+export interface PluginTTS {
+    register(definition: TTSProviderDefinition): Disposable;
+}

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

@@ -1,6 +1,6 @@
 import type { Disposable, JsonValue } from "./contract";
 export interface UploadFile {
-    /** 宿主已完成压缩和唯一命名，插件只负责追加远端路径前缀。 */
+    /** 提供方收到宿主唯一命名后的文件；uploadRemote的调用者传原始文件名。 */
     name: string;
     mimeType: string;
     content: Uint8Array;
@@ -9,8 +9,12 @@ export interface UploadProviderDefinition {
     id: string;
     name: string;
     /** 返回可供正文直接引用的HTTP(S)地址，不返回临时签名URL。 */
-    upload(file: UploadFile, config: JsonValue): Promise<string>;
+    upload(file: UploadFile, config: JsonValue, signal: AbortSignal): Promise<string>;
 }
 export interface PluginUpload {
     register(definition: UploadProviderDefinition): Disposable;
+    /** 使用用户当前远端配置；本地模式明确失败，不自动选择其他存储。 */
+    uploadRemote(file: UploadFile, options?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
 }