@xiongtao.xt/tau-plugins 0.17.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 更新记录
 
+## 0.19.0
+
+- 补齐 publish-data 类型、publish-client 纯数据客户端及 publish-artifacts 协议校验/定义求值入口；数据与产物声明不连带载入 Editor/React/UI 类型。
+- 普通 SDK/UI 根入口保持类型与 Tau 注入约定；通用源码组件契约与实现由 Editor 公开入口维护，既有源码宿主适配只负责接线。
+- 保留 master 0.18.0 的图片插件及全部已插件化接口。
+
+## 0.18.0
+
+- 新增 `context.images.register`，按账号配置与模型创建图片生成或编辑实例，返回图片字节和实际 MIME。
+- 图片配置视图通过 `settings.register({ target: "images" })` 注册，接收当前账号的 `imageConfig`；保存按实例隔离，不使用共享凭据。
+- 图片插件在主窗口渲染进程执行，跨窗口调用、上传、取消和停用共用任务生命周期；保留 TTS 与上传等既有接口。
+
 ## 0.17.0
 
 - 新增通用行内源码 API：useInlineSource、insertInlineSource 和 InlineSourceBoundary，复用宿主 Slate 实例与浏览器行内边界处理。

package/IMAGES.md

@@ -0,0 +1,16 @@
+# 图片生成与编辑提供方
+
+需要 SDK 0.18.0 和支持图片插件接口的客户端。通过 `context.images.register({ id: context.pluginId, name, create })` 注册，每个插件一个提供方，可由用户配置多个账号实例。
+
+`create(config, modelId)` 同步创建任务实例，不发网络请求。配置结构由插件解释和校验，不读取宿主 store，也不将账号凭据放进插件共享 storage。实例至少实现一个方法：
+
+- `generate({ prompt, options? }, signal)`：文本生成图片。
+- `edit({ prompt, options?, images }, signal)`：基于一张或多张参考图编辑。
+
+输入图片为 `{ name, mimeType, content: Uint8Array }`。输出为相同结构的数组，可附加 `revisedPrompt`。宿主支持 PNG/JPEG/WebP，单次最多 16 张、输入和输出总大小分别不超过 128 MiB。提供方返回临时 URL 时自行下载为字节，下载时不要将 API 凭据自动传给其他域名。
+
+`options` 包含 `size/quality/outputFormat/background/count`，仅在显式传入时映射到服务商请求。无法等价支持的参数应报告错误，不忽略、不隐式多次调用凑数量。协议、鉴权、超时、重试和轮询由插件负责；网络使用 `context.fetch` 并传入方法的 signal，轮询等待也响应取消。宿主负责文件解析、最终资源上传和正文插入。
+
+配置视图通过 `context.settings.register({ id, title, target: "images", component })` 注册。组件接收 `PluginSettingsProps.imageConfig`：`instanceId`、`value`、`modelId`、`save(value, modelId)`。字段、布局、验证和错误提示由插件决定；保存失败保留草稿，成功后才提示已保存。模型标识也由插件表单填写。不要把正在编辑的账号误当成全局当前账号。
+
+生成和编辑仍使用用户选择的同一个当前账号；不支持的方法不显示对应入口。停用、重载、切库或调用窗口退出会关闭任务，后续上传和保存不得接收迟到结果。取消不保证撤销远端已发生的任务或费用。图片插件不自动安装、启用或切换资源存储。

package/PUBLISH-DATA.md

@@ -0,0 +1,19 @@
+# 独立站点的数据接入
+
+普通 Tau 插件仍然使用 SDK 类型开发，构建时将宿主注入模块设为 external。SDK 根入口和 UI 包不携带编辑器、组件或页面的运行实现。
+
+独立站点可使用 `@tau/plugins/publish-data` 的纯数据类型，以及 `@tau/plugins/publish-client` 的可执行辅助客户端。后者只有数据读取、摘要校验、取消和搜索，不包含 React、渲染器、路由或预览界面。
+
+```ts
+import { createClient } from "@tau/plugins/publish-client";
+
+const client = createClient({ manifestUrl: "https://example.com/data/site.<摘要>.json" });
+const manifest = await client.readManifest();
+const result = await client.readData({ key: manifest.items[0].key });
+```
+
+模板也可以自行读取协议 JSON。模板自行携带渲染实现并消费 C23 插件产物；宿主不为站点提供 UI 模块。资源以清单或所属数据文件的 URL 为上下文解析，公开路由由模板决定。
+
+`@tau/plugins/publish-artifacts` 提供 C23 清单校验、定义求值与节点归属检查，仅处理协议，不提供 UI、模块映射或资源生命周期。其声明不连带加载 SDK 根入口的 Editor/Slate/UI 类型；共享模块由模板通过实际公开能力提供。
+
+可选 `@tau/editor` 是单独的可执行通用编辑器，包含默认内置功能和已编译样式。模板起步工程中的 PublishedContent 负责读取已验证正文、加载插件产物和伴生 CSS，再将扩展及节点交给 Editor；dataUrl 和发布协议不进入 Editor 的 props。普通 SDK/UI 根入口继续保持类型与 Tau 注入边界。

package/README.md

@@ -1,6 +1,6 @@
 # Tau 插件开发包 @tau/plugins
 
-开发 Tau 插件所需的类型与接口，通过 npm 别名安装为 `@tau/plugins`。实际实现由 Tau 客户端在运行时提供，构建时需设为 external，不能在普通 Node.js 程序中直接运行。
+开发 Tau 插件所需的类型与接口，通过 npm 别名安装为 `@tau/plugins`。根入口的实际实现由 Tau 客户端提供，构建时需设为 external。plugins 包另提供独立站点可用的 publish-data 类型和 publish-client 纯数据客户端，见该包 PUBLISH-DATA.md；不包含站点渲染、路由或预览实现。
 
 从模板开始开发：https://github.com/LastKnightCoder/tau-plugin-template