@xiongtao.xt/tau-plugins 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 更新记录
 
+## 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。

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