@xiongtao.xt/tau-plugins 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 更新记录
 
+## 0.21.0
+
+- 新增 context.publish 发布提供方、publishConfig 配置表单和文件式／快照式提交协议，本地导出仍由宿主提供。
+- 新增受控 Git 快照发布与缓存目录选择服务，插件不获得任意命令或宿主文件访问。
+- 插件分类新增博客发布。
+
 ## 0.20.0
 
 - manifest 支持 `categories`（插件中心分类）与 `keywords`（目录搜索），门户上传严格校验，客户端忽略未知值。

package/PUBLISH.md

@@ -0,0 +1,17 @@
+# 博客发布提供方
+
+需要 SDK 0.21.0 及包含博客发布能力的客户端。提供方只在渲染进程注册和执行，网络使用 `context.fetch`。本地导出由宿主提供，不注册本地发布插件。
+
+在 activate 中调用 `context.publish.register({ id: context.pluginId, name, create(config) })`。create 返回文件式或快照式实例，配置是本轮固定的 JSON 副本。提供方 ID 必须等于所属插件 ID。
+
+两种实例都实现 `describe(signal)` 与 `checkConnection(signal)`；describe 返回 `identity`、`basePath`、可选 `publicUrl`。identity 是不含密钥的物理目标稳定身份，不随插件版本、模板、Token 或提交方式变化。basePath 以斜杠开头和结尾，根路径为 `/`。
+
+文件式实例声明 `mode: "files"`，实现 `uploadFile(path, Uint8Array, signal)` 与 `deleteFile(path, signal)`，可用 `concurrency` 声明 1–32 的上限。方法成功返回 void，失败抛出异常。宿主负责增量、重试、依赖先行和入口后置、旧资源清理，不把远端目录当成可任意删除的文件清单。
+
+快照式实例声明 `mode: "snapshot"`，实现 `publish(snapshot, signal)`。snapshot 包含本轮临时 id、待上传文件的路径和摘要及删除路径。只有远端确认整轮提交后才返回；失败抛异常，不返回部分成功。可选 dispose 在会话关闭时回收连接。
+
+Git 快照使用 `context.services.git.publishSnapshot({ publicationId: snapshot.id, remote, branch, author: { name, email }, authentication: { username, password }, cacheId? }, { signal })`。remote 只接受不含凭据的 HTTPS 地址；认证通过任务通道使用，不写入 remote URL。publicationId 仅在所属窗口本轮发布中有效，不能用于读取任意本地文件。需要缓存目录时调用 `context.services.git.selectCacheDirectory({})`，由宿主选择并返回 `{ id, label }`；只保存 id 和展示用 label，不传入任意 cwd 或 shell 命令。
+
+配置视图使用 `context.settings.register({ id, title, target: "publish", component })`。组件接收 `PluginSettingsProps.publishConfig` 的 value 与 save，保存成功后再提交表单值，不用按工作区隔离的 context.storage 保存账号。普通插件详情页提供前往博客发布页的入口。
+
+离开发布页继续运行；停用、切库和发起窗口关闭使旧会话失效。每次请求都传递 signal，错误信息不得包含凭据。新安装默认停用，插件缺失或未启用时宿主保留用户配置及选择，不自动切换其他目标。

package/package.json

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

package/publish-artifacts.js

@@ -43,6 +43,7 @@ var PLUGIN_CATEGORIES = [
   { id: "editor", label: "\u7F16\u8F91\u5668" },
   { id: "whiteboard", label: "\u767D\u677F" },
   { id: "blog-template", label: "\u535A\u5BA2\u6A21\u677F" },
+  { id: "blog-publish", label: "\u535A\u5BA2\u53D1\u5E03" },
   { id: "ai", label: "AI" },
   { id: "voice", label: "\u8BED\u97F3" },
   { id: "page", label: "\u9875\u9762" }

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

@@ -14,6 +14,9 @@ export declare const PLUGIN_CATEGORIES: readonly [{
 }, {
     readonly id: "blog-template";
     readonly label: "博客模板";
+}, {
+    readonly id: "blog-publish";
+    readonly label: "博客发布";
 }, {
     readonly id: "ai";
     readonly label: "AI";

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

@@ -11,6 +11,7 @@ import type { PluginSync } from "./sync";
 import type { PluginUpload } from "./upload";
 import type { PluginTTS } from "./tts";
 import type { PluginImages } from "./images";
+import type { PluginPublish } from "./publish";
 import type { PluginSidebar } from "./sidebar";
 import type { PluginExcerpts, PluginMaterials } from "./excerpts";
 import type { PluginMCP } from "./mcp";
@@ -46,6 +47,7 @@ export interface PluginContext {
     readonly upload: PluginUpload;
     readonly tts: PluginTTS;
     readonly images: PluginImages;
+    readonly publish: PluginPublish;
     readonly sidebar: PluginSidebar;
     readonly excerpts: PluginExcerpts;
     readonly materials: PluginMaterials;

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

@@ -2,6 +2,7 @@ import type { PluginDefinition } from "./contract";
 export type * from "./upload";
 export type * from "./tts";
 export type * from "./images";
+export type * from "./publish";
 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/publish.d.ts

@@ -0,0 +1,59 @@
+import type { Disposable, JsonValue } from "./contract";
+export interface PublishTarget {
+    /** 物理目标的稳定身份，不包含凭据、插件或模板版本。 */
+    identity: string;
+    basePath: string;
+    publicUrl?: string;
+}
+export interface PublicationSnapshot {
+    /** 宿主为本轮文件计划颁发的临时句柄，不能读取任意本地文件。 */
+    id: string;
+    files: readonly {
+        path: string;
+        hash: string;
+    }[];
+    deletions: readonly string[];
+}
+interface PublishInstanceBase {
+    describe(signal: AbortSignal): Promise<PublishTarget>;
+    checkConnection(signal: AbortSignal): Promise<boolean>;
+    dispose?(): void | Promise<void>;
+}
+export interface FilePublishInstance extends PublishInstanceBase {
+    mode: "files";
+    concurrency?: number;
+    uploadFile(path: string, content: Uint8Array, signal: AbortSignal): Promise<void>;
+    deleteFile(path: string, signal: AbortSignal): Promise<void>;
+}
+export interface SnapshotPublishInstance extends PublishInstanceBase {
+    mode: "snapshot";
+    publish(snapshot: PublicationSnapshot, signal: AbortSignal): Promise<void>;
+}
+export type PublishInstance = FilePublishInstance | SnapshotPublishInstance;
+export interface PublishProviderDefinition {
+    id: string;
+    name: string;
+    create(config: JsonValue): PublishInstance;
+}
+export interface PluginPublish {
+    register(definition: PublishProviderDefinition): Disposable;
+}
+export interface GitSnapshotRequest {
+    publicationId: string;
+    remote: string;
+    branch: string;
+    author: {
+        name: string;
+        email: string;
+    };
+    authentication: {
+        username: string;
+        password: string;
+    };
+    cacheId?: string;
+}
+export interface GitCacheDirectory {
+    id: string;
+    label: string;
+}
+export {};

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

@@ -1,5 +1,6 @@
 import type { Descendant } from "slate";
 import type { MarkdownCodec } from "../../markdown/src/index";
+import type { GitSnapshotRequest, GitCacheDirectory } from "./publish";
 export type { Descendant } from "slate";
 export interface ServiceOptions {
     signal?: AbortSignal;
@@ -39,6 +40,10 @@ export interface MediaInfo {
     }[];
 }
 export interface PluginServices {
+    git: {
+        publishSnapshot(input: GitSnapshotRequest, options?: ServiceOptions): Promise<void>;
+        selectCacheDirectory(input: Record<string, never>, options?: ServiceOptions): Promise<GitCacheDirectory | null>;
+    };
     tailwind: {
         compile(input: {
             source: string;

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

@@ -3,6 +3,10 @@ import type { Disposable, PluginContext } from "./index";
 import type { JsonValue } from "./json";
 export interface PluginSettingsProps {
     readonly context: PluginContext;
+    readonly publishConfig?: {
+        readonly value: JsonValue;
+        save(value: JsonValue): Promise<void>;
+    };
     readonly imageConfig?: {
         readonly instanceId: string;
         readonly value: JsonValue;
@@ -35,7 +39,7 @@ export interface PluginSettingsDefinition {
     title: string;
     description?: string;
     /** 提供方配置表单挂载到对应宿主设置；普通插件设置省略。 */
-    target?: "sync" | "upload" | "tts" | "images";
+    target?: "sync" | "upload" | "tts" | "images" | "publish";
     component: ComponentType<PluginSettingsProps>;
 }
 export interface PluginSettingsHandle extends Disposable {