@chengxianglibra/dsh-data-analysis 0.3.0 → 0.3.1

package/lib/report-publishing/service.js

@@ -0,0 +1,133 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import { publishingFields, } from "./credential-contract.js";
+function pathName(value, fallback) {
+    const name = Array.from(value.normalize('NFKC').replace(/[^\p{L}\p{N}_-]+/gu, '-'))
+        .slice(0, 48)
+        .join('')
+        .replace(/^-+|-+$/g, '');
+    return name || fallback;
+}
+export class ReportPublishingService {
+    configId = randomUUID();
+    #config;
+    #store;
+    #files;
+    #workspaceName;
+    constructor(config, store, files, workspaceName) {
+        this.#config = config;
+        this.#store = store;
+        this.#files = files;
+        this.#workspaceName = workspaceName;
+    }
+    assertConfig(configId) {
+        if (configId !== this.configId)
+            throw new Error('report-publishing-config-changed');
+    }
+    async describe() {
+        const fields = await Promise.all(publishingFields.flatMap((field) => {
+            const reference = this.#config.storage[`${field}Ref`];
+            if (reference === undefined)
+                return [];
+            return [
+                this.#store.describe(credentialRef(reference)).then((info) => ({
+                    field,
+                    reference,
+                    required: true,
+                    configured: info.configured,
+                    writable: info.writable,
+                    ...(info.source ? { source: info.source } : {}),
+                })),
+            ];
+        }));
+        return {
+            enabled: true,
+            configId: this.configId,
+            name: this.#config.storage.name,
+            bucket: this.#config.storage.bucket,
+            fields,
+        };
+    }
+    async change(field, value, signal) {
+        const reference = this.#config.storage[`${field}Ref`];
+        if (reference === undefined)
+            throw new Error('report-publishing-disabled-or-field-unavailable');
+        signal.throwIfAborted();
+        if (value === undefined)
+            await this.#store.unset(credentialRef(reference));
+        else
+            await this.#store.set(credentialRef(reference), value);
+    }
+    async publish(scope, ref, caller) {
+        const signal = AbortSignal.any([caller, AbortSignal.timeout(110_000)]);
+        const { workspaceId, reportId, buildId } = ref;
+        const document = await this.#files.readSavedReport(scope, ref, signal);
+        const { exportAnalysisHtml } = await import("../client/analysis-ui/offline-export.js");
+        const bytes = Buffer.from(exportAnalysisHtml(document), 'utf8');
+        const sha256 = createHash('sha256').update(bytes).digest('hex');
+        const publicationId = createHash('sha256')
+            .update(JSON.stringify([workspaceId, reportId, buildId, sha256]))
+            .digest('hex')
+            .slice(0, 32);
+        const { pathPrefix, publicBaseUrl, storage } = this.#config;
+        const key = [
+            pathPrefix,
+            pathName(this.#workspaceName(workspaceId), 'workspace'),
+            pathName(document.title, 'report'),
+            publicationId,
+            'index.html',
+        ]
+            .filter(Boolean)
+            .join('/');
+        const { S3Client, PutObjectCommand } = await import('@aws-sdk/client-s3');
+        const accessKeyId = await this.#resolveCredential(storage.accessKeyIdRef, signal);
+        const secretAccessKey = await this.#resolveCredential(storage.secretAccessKeyRef, signal);
+        const sessionToken = storage.sessionTokenRef === undefined
+            ? undefined
+            : await this.#resolveCredential(storage.sessionTokenRef, signal);
+        signal.throwIfAborted();
+        const client = new S3Client({
+            endpoint: storage.endpoint,
+            region: storage.region,
+            forcePathStyle: storage.forcePathStyle,
+            credentials: { accessKeyId, secretAccessKey, sessionToken },
+            maxAttempts: 3,
+            requestChecksumCalculation: 'WHEN_REQUIRED',
+        });
+        try {
+            await client.send(new PutObjectCommand({
+                Bucket: storage.bucket,
+                Key: key,
+                Body: bytes,
+                ContentType: 'text/html; charset=utf-8',
+                ContentDisposition: 'inline',
+                CacheControl: 'public, max-age=31536000, immutable',
+            }), { abortSignal: signal });
+        }
+        catch {
+            throw new Error('report-publishing-upload-unconfirmed');
+        }
+        finally {
+            client.destroy();
+        }
+        return {
+            storage: storage.name,
+            bucket: storage.bucket,
+            key,
+            url: `${publicBaseUrl.replace(/\/+$/, '')}/${key.split('/').map(encodeURIComponent).join('/')}`,
+            workspaceId,
+            reportId,
+            buildId,
+            sha256,
+            bytes: bytes.length,
+            publishedAt: new Date().toISOString(),
+        };
+    }
+    async #resolveCredential(reference, signal) {
+        signal.throwIfAborted();
+        const result = await this.#store.resolve(credentialRef(reference));
+        if (!result?.value)
+            throw new Error('report-publishing-credentials-missing');
+        return result.value;
+    }
+}

package/lib/skill-build.generated.js

@@ -1,6 +1,6 @@
 export const packagedSkillBuild = {
     "schema": "dsh-data-analysis-skills/v1",
-    "digest": "fff651d8aca73eaf4a855e13a1a42ac6a271b7a0aa73baee03d83a01d4bfbc27",
+    "digest": "8826de1c36384d33c07b611c8f7244abbef18ad1d1facde9a45b096c745bbbb7",
     "files": [
         {
             "path": "dsh-data-analysis-files/SKILL.md",
@@ -8,7 +8,7 @@ export const packagedSkillBuild = {
         },
         {
             "path": "dsh-data-analysis-files/references/delivery.md",
-            "sha256": "bcc03e13a013fb081050a95d0da71ba12eba32569e37b3fcaee3c7c694f21637"
+            "sha256": "60b2eb892c17410b431477976ee504894ef9f60fe82938ddfcecf963be562728"
         },
         {
             "path": "dsh-data-analysis-files/references/examples.md",

package/lib/types/client/credentials/install.d.ts

@@ -7,9 +7,10 @@ export declare function CredentialIcon({ name, size }: {
 export declare function DatasourceProperties({ context }: {
     context: any;
 }): import("react").JSX.Element;
-export declare function CredentialPanel({ model, workspaces, onRefresh }: {
+export declare function CredentialPanel({ model, workspaces, onRefresh, initialSection }: {
     model: any;
     workspaces: any;
     onRefresh: any;
+    initialSection?: string | undefined;
 }): import("react").JSX.Element | null;
 export declare function installCredentials(ctx: any, rpc: any, changes?: CredentialChanges): CredentialClientModel;

package/lib/types/client/credentials/model.d.ts

@@ -1,4 +1,5 @@
 import type { CredentialAction, CredentialContextView, CredentialOperationView, CredentialRequestView } from '../../datasource/service.ts';
+import { type PublishingField } from '../../report-publishing/credential-contract.ts';
 import { type Notice } from './../i18n/copy.ts';
 import type { BrowserRpc } from '../semantic-browser/model.ts';
 import type { CredentialChanges } from './changes.ts';
@@ -7,6 +8,18 @@ interface QueryHandle {
     id: string;
     scope: string;
 }
+export type PublishingCredentialRequest = {
+    endpoint: 'describe';
+} | {
+    endpoint: 'set';
+    configId: string;
+    field: PublishingField;
+    value: string;
+} | {
+    endpoint: 'unset';
+    configId: string;
+    field: PublishingField;
+};
 export interface ClientOperation {
     handle: QueryHandle;
     name: string;
@@ -38,6 +51,23 @@ export declare class CredentialClientModel {
     constructor(rpc: BrowserRpc, storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>, changes?: CredentialChanges);
     getSnapshot: () => CredentialClientState;
     subscribe: (listener: () => void) => (() => void);
+    publishingCredentials(workspaceId: string, { endpoint, ...input }: PublishingCredentialRequest, signal: AbortSignal): Promise<{
+        enabled: false;
+        fields: [];
+    } | {
+        enabled: true;
+        configId: string;
+        name: string;
+        bucket: string;
+        fields: {
+            field: "accessKeyId" | "secretAccessKey" | "sessionToken";
+            reference: string;
+            required: boolean;
+            configured: boolean;
+            writable: boolean;
+            source?: string | undefined;
+        }[];
+    }>;
     show(workspaceId: string, selectedToken?: string): Promise<void>;
     close(): void;
     suspend(): void;

package/lib/types/client/credentials/report-publishing.d.ts

@@ -0,0 +1,5 @@
+import type { CredentialClientModel } from './model.ts';
+export declare function ReportPublishingCredentials({ model, workspaceId, }: {
+    model: CredentialClientModel;
+    workspaceId: string;
+}): import("react").JSX.Element;

package/lib/types/client/credentials/styles.d.ts

@@ -1,2 +1,2 @@
 /** Datasource arrangement and saved-property reading; controls use shadcn primitives. */
-export declare const credentialStyles = "\n.mc-panel{min-width:0;width:100%;container-type:inline-size;--mc-accent:var(--dsw-alias-state-business-primary,#075bea)}\n.mc-shell,.mc-columns,.mc-main,.mc-form{display:flex;flex-direction:column;min-width:0}\n.mc-shell,.mc-columns,.mc-form-body{gap:1.5rem}\n.mc-form{gap:1rem;flex:1}\n.mc-form-body{display:flex;flex-direction:column;flex:1}\n.mc-detail-heading,.mc-name-row,.mc-heading-actions,.mc-field-header,.mc-field-actions,.mc-request-heading,.mc-progress{display:flex;align-items:center;flex-wrap:wrap;gap:.75rem;min-width:0}\n.mc-detail-heading,.mc-name-row,.mc-field-header{justify-content:space-between}\n.mc-name-row{width:100%}\n.mc-identity{display:flex;align-items:flex-start;gap:1rem;flex:1 1 180px;min-width:0}\n.mc-identity-icon{width:3.375rem;height:3.375rem;display:grid;place-items:center;flex:none;background:var(--muted);border-radius:.625rem}\n.mc-identity-copy{min-width:0}\n.mc-identity-title{display:flex;align-items:center;flex-wrap:wrap;gap:.5rem;min-width:0}\n.mc-identity-title [data-slot=card-title]{min-width:0;max-width:100%}\n.mc-heading-actions{flex:none}\n.mc-detail-heading{margin-bottom:.5rem}\n.mc-detail-heading h3{margin:0;font-size:1.25rem;line-height:1.4;font-weight:600;overflow-wrap:anywhere}\n.mc-datasource-heading [data-slot=card-title]{font-size:1.5rem;line-height:1.2;font-weight:700;letter-spacing:-.025em;overflow-wrap:anywhere}\n.mc-nav{min-width:0}\n.mc-nav-heading{margin-bottom:.75rem;color:var(--muted-foreground);font-size:.875rem}\n.mc-nav-heading h3{font:inherit;margin:0}\n.mc-datasources{width:100%;max-width:100%;height:auto;justify-content:flex-start;overflow-x:auto;border-bottom:1px solid var(--border);border-radius:0;padding:0;gap:.25rem}\n.mc-datasources .mc-datasource{min-width:0;max-width:min(16rem,100%);flex:0 0 auto;border-radius:0;padding:.75rem 1.25rem;font-size:.9375rem;background:transparent;color:var(--muted-foreground);box-shadow:none;transition:none}\n.mc-datasources .mc-datasource[aria-selected=true]{color:var(--mc-accent)}\n.mc-datasources .mc-datasource::after{background:var(--mc-accent);bottom:0;opacity:0;transition:none}\n.mc-datasources .mc-datasource[aria-selected=true]::after{opacity:1}\n.mc-datasources .mc-datasource:focus-visible{outline:2px solid var(--ring);outline-offset:-2px}\n.mc-datasource>svg{flex:none}\n.mc-datasource-copy{min-width:0;display:flex;align-items:center;gap:.375rem}\n.mc-datasource-name{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.mc-visually-hidden{position:absolute;left:0;top:0;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}\n.mc-dot{width:6px;height:6px;background:var(--muted-foreground);border-radius:50%;flex:none}\n.mc-dot[data-ready=true]{background:var(--mv-success)}\n.mc-dot[data-ready=false]{background:var(--destructive)}\n.mc-properties,.mc-fields{min-width:0}\n.mc-datasource-detail .mc-properties,.mc-datasource-detail .mc-fields{gap:1rem;padding:0;background:transparent;box-shadow:none;border-radius:0;overflow:visible}\n.mc-datasource-detail .mc-properties>[data-slot=card-header],.mc-datasource-detail .mc-properties>[data-slot=card-content],.mc-datasource-detail .mc-fields>[data-slot=card-content]{padding:0}\n.mc-credential-section{display:flex;flex-direction:column;gap:1rem;min-width:0;padding-top:1.5rem;border-top:1px solid var(--border)}\n.mc-section-heading{display:flex;align-items:center;gap:.625rem;min-width:0;margin:0;font-size:1.125rem;line-height:1.4;font-weight:700}\n.mc-section-heading>svg{width:1.125rem;height:1.125rem;flex:none}\n.mc-fields>[data-slot=card-content]>.mc-field+.mc-field{border-top:1px solid var(--border);padding-top:1rem;margin-top:1rem}\n.mc-property-list{margin:0;min-width:0}\n.mc-property{display:grid;grid-template-columns:minmax(0,140px) minmax(0,1fr);gap:1rem;padding:.75rem 0}\n.mc-property+.mc-property{border-top:1px solid var(--border)}\n.mc-property dt{color:var(--muted-foreground);font-weight:500;overflow-wrap:anywhere}\n.mc-property dd{margin:0;min-width:0;white-space:pre-wrap;overflow-wrap:anywhere}\n.mc-property pre{font-family:var(--mv-font-mono,ui-monospace,monospace);tab-size:4;white-space:pre-wrap;overflow-wrap:anywhere;margin:0}\n.mc-property-json{max-height:240px;overflow:auto}\n.mc-field{min-width:0;margin:0;border:0;padding:0;display:flex;flex-direction:column;gap:1rem}\n\n.mc-field-title{min-width:0;overflow-wrap:anywhere}\n.mc-field-title h4,.mc-field-title p{margin:0}\n.mc-field-title p,.mc-field-note,.mc-note,.mc-eyebrow{color:var(--muted-foreground);font-size:.875rem;overflow-wrap:anywhere}\n.mc-eyebrow{margin:0}\n.mc-confirm{margin-top:.75rem}\n.mc-result-title{display:flex;align-items:center;gap:.5rem}\n.mc-result pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:180px;overflow:auto}\n.mc-form-footer{display:flex;align-items:center;flex-wrap:wrap;gap:.5rem}\n.mc-form-footer .mc-cancel{margin-left:auto}\n.mc-requests,.mc-activity-list{display:flex;align-items:center;gap:.5rem;flex-wrap:wrap}\n.mc-request-status,.mc-operation-note{overflow-wrap:anywhere}\n.mc-reference-options summary{cursor:pointer}\n.mc-credential-entry,.mc-credential-group,.mc-existing-source,.mc-inline-credentials{display:flex;flex-direction:column;gap:1rem;min-width:0}\n.mc-reference-options{min-width:0}\n.mc-timezone-control{display:flex;gap:.375rem;align-items:center}\n.mc-timezone-control input{flex:1;min-width:0}\n.mc-timezone-popover{display:grid;gap:.625rem;max-width:calc(100vw - 2rem)}\n.mc-timezone-select{width:100%;min-width:0;max-height:15rem;border:1px solid var(--border);border-radius:var(--radius);background:var(--background);color:var(--foreground);font:inherit}\n.mc-timezone-select:focus-visible{outline:2px solid var(--ring);outline-offset:2px}\n.mc-engine-confirm{margin-top:.5rem}\n.mc-scoped-actions{display:flex;flex-wrap:wrap;gap:.5rem}\n.mc-activity{display:flex;flex-direction:column;gap:.75rem}\n.mc-activity-heading{margin:0;color:var(--muted-foreground);font-size:.875rem}\n.mc-progress button{margin-left:auto}\n.mc-empty{margin:auto}\n@container(max-width:650px){.mc-name-row>.mc-heading-actions{width:100%}.mc-property{grid-template-columns:minmax(0,1fr);gap:.375rem}.mc-field-actions{margin-left:auto}}\n";
+export declare const credentialStyles = "\n.mc-panel{min-width:0;width:100%;container-type:inline-size;--mc-accent:var(--dsw-alias-state-business-primary,#075bea)}\n.mc-shell,.mc-columns,.mc-main,.mc-form{display:flex;flex-direction:column;min-width:0}\n.mc-directory-content{min-width:0}\n.mc-directory-content>.mc-requests{margin-bottom:1rem}\n.mc-shell,.mc-columns,.mc-form-body{gap:1.5rem}\n.mc-form{gap:1rem;flex:1}\n.mc-form-body{display:flex;flex-direction:column;flex:1}\n.mc-detail-heading,.mc-name-row,.mc-heading-actions,.mc-field-header,.mc-field-actions,.mc-request-heading,.mc-progress{display:flex;align-items:center;flex-wrap:wrap;gap:.75rem;min-width:0}\n.mc-detail-heading,.mc-name-row,.mc-field-header{justify-content:space-between}\n.mc-name-row{width:100%}\n.mc-identity{display:flex;align-items:flex-start;gap:1rem;flex:1 1 180px;min-width:0}\n.mc-identity-icon{width:3.375rem;height:3.375rem;display:grid;place-items:center;flex:none;background:var(--muted);border-radius:.625rem}\n.mc-identity-copy{min-width:0}\n.mc-identity-title{display:flex;align-items:center;flex-wrap:wrap;gap:.5rem;min-width:0}\n.mc-identity-title [data-slot=card-title]{min-width:0;max-width:100%}\n.mc-heading-actions{flex:none}\n.mc-detail-heading{margin-bottom:.5rem}\n.mc-detail-heading h3{margin:0;font-size:1.25rem;line-height:1.4;font-weight:600;overflow-wrap:anywhere}\n.mc-datasource-heading [data-slot=card-title]{font-size:1.5rem;line-height:1.2;font-weight:700;letter-spacing:-.025em;overflow-wrap:anywhere}\n.mc-nav{min-width:0}\n.mc-nav-heading{margin-bottom:.75rem;color:var(--muted-foreground);font-size:.875rem}\n.mc-nav-heading h3{font:inherit;margin:0}\n.mc-datasources{width:100%;max-width:100%;height:auto;justify-content:flex-start;overflow-x:auto;border-bottom:1px solid var(--border);border-radius:0;padding:0;gap:.25rem}\n.mc-datasources .mc-datasource{min-width:0;max-width:min(16rem,100%);flex:0 0 auto;border-radius:0;padding:.75rem 1.25rem;font-size:.9375rem;background:transparent;color:var(--muted-foreground);box-shadow:none;transition:none}\n.mc-datasources .mc-datasource[aria-selected=true]{color:var(--mc-accent)}\n.mc-datasources .mc-datasource::after{background:var(--mc-accent);bottom:0;opacity:0;transition:none}\n.mc-datasources .mc-datasource[aria-selected=true]::after{opacity:1}\n.mc-datasources .mc-datasource:focus-visible{outline:2px solid var(--ring);outline-offset:-2px}\n.mc-datasource>svg{flex:none}\n.mc-datasource-copy{min-width:0;display:flex;align-items:center;gap:.375rem}\n.mc-datasource-name{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.mc-visually-hidden{position:absolute;left:0;top:0;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}\n.mc-dot{width:6px;height:6px;background:var(--muted-foreground);border-radius:50%;flex:none}\n.mc-dot[data-ready=true]{background:var(--mv-success)}\n.mc-dot[data-ready=false]{background:var(--destructive)}\n.mc-properties,.mc-fields{min-width:0}\n.mc-datasource-detail .mc-properties,.mc-datasource-detail .mc-fields{gap:1rem;padding:0;background:transparent;box-shadow:none;border-radius:0;overflow:visible}\n.mc-datasource-detail .mc-properties>[data-slot=card-header],.mc-datasource-detail .mc-properties>[data-slot=card-content],.mc-datasource-detail .mc-fields>[data-slot=card-content]{padding:0}\n.mc-credential-section{display:flex;flex-direction:column;gap:1rem;min-width:0;padding-top:1.5rem;border-top:1px solid var(--border)}\n.mc-section-heading{display:flex;align-items:center;gap:.625rem;min-width:0;margin:0;font-size:1.125rem;line-height:1.4;font-weight:700}\n.mc-section-heading>svg{width:1.125rem;height:1.125rem;flex:none}\n.mc-fields>[data-slot=card-content]>.mc-field+.mc-field{border-top:1px solid var(--border);padding-top:1rem;margin-top:1rem}\n.mc-property-list{margin:0;min-width:0}\n.mc-property{display:grid;grid-template-columns:minmax(0,140px) minmax(0,1fr);gap:1rem;padding:.75rem 0}\n.mc-property+.mc-property{border-top:1px solid var(--border)}\n.mc-property dt{color:var(--muted-foreground);font-weight:500;overflow-wrap:anywhere}\n.mc-property dd{margin:0;min-width:0;white-space:pre-wrap;overflow-wrap:anywhere}\n.mc-property pre{font-family:var(--mv-font-mono,ui-monospace,monospace);tab-size:4;white-space:pre-wrap;overflow-wrap:anywhere;margin:0}\n.mc-property-json{max-height:240px;overflow:auto}\n.mc-field{min-width:0;margin:0;border:0;padding:0;display:flex;flex-direction:column;gap:1rem}\n\n.mc-field-title{min-width:0;overflow-wrap:anywhere}\n.mc-field-title h4,.mc-field-title p{margin:0}\n.mc-field-title p,.mc-field-note,.mc-note,.mc-eyebrow{color:var(--muted-foreground);font-size:.875rem;overflow-wrap:anywhere}\n.mc-eyebrow{margin:0}\n.mc-confirm{margin-top:.75rem}\n.mc-result-title{display:flex;align-items:center;gap:.5rem}\n.mc-result pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:180px;overflow:auto}\n.mc-form-footer{display:flex;align-items:center;flex-wrap:wrap;gap:.5rem}\n.mc-form-footer .mc-cancel{margin-left:auto}\n.mc-requests,.mc-activity-list{display:flex;align-items:center;gap:.5rem;flex-wrap:wrap}\n.mc-request-status,.mc-operation-note{overflow-wrap:anywhere}\n.mc-reference-options summary{cursor:pointer}\n.mc-credential-entry,.mc-credential-group,.mc-existing-source,.mc-inline-credentials{display:flex;flex-direction:column;gap:1rem;min-width:0}\n.mc-reference-options{min-width:0}\n.mc-timezone-control{display:flex;gap:.375rem;align-items:center}\n.mc-timezone-control input{flex:1;min-width:0}\n.mc-timezone-popover{display:grid;gap:.625rem;max-width:calc(100vw - 2rem)}\n.mc-timezone-select{width:100%;min-width:0;max-height:15rem;border:1px solid var(--border);border-radius:var(--radius);background:var(--background);color:var(--foreground);font:inherit}\n.mc-timezone-select:focus-visible{outline:2px solid var(--ring);outline-offset:2px}\n.mc-engine-confirm{margin-top:.5rem}\n.mc-scoped-actions{display:flex;flex-wrap:wrap;gap:.5rem}\n.mc-activity{display:flex;flex-direction:column;gap:.75rem}\n.mc-activity-heading{margin:0;color:var(--muted-foreground);font-size:.875rem}\n.mc-progress button{margin-left:auto}\n.mc-empty{margin:auto}\n@container(max-width:650px){.mc-name-row>.mc-heading-actions{width:100%}.mc-property{grid-template-columns:minmax(0,1fr);gap:.375rem}.mc-field-actions{margin-left:auto}}\n";

package/lib/types/client/i18n/copy.d.ts

@@ -489,6 +489,18 @@ export declare const zh: {
     'marivo.presentation.export-html-started': "HTML 下载已开始。";
     'marivo.presentation.export-html-failed': "导出失败，请重试。";
     'marivo.presentation.export-html-dismiss': "关闭导出提示";
+    'marivo.presentation.report-delivery-checking': "正在读取导出设置…";
+    'marivo.presentation.report-delivery-unavailable': "导出设置不可用，重新打开菜单重试";
+    'marivo.presentation.publish-report': "发布到对象存储";
+    'marivo.presentation.publishing-report': "正在发布…";
+    'marivo.presentation.publish-report-success': "报告已上传到对象存储。";
+    'marivo.presentation.publish-report-credentials-missing': "缺少发布凭据。补齐后可重新发布。";
+    'marivo.presentation.publish-report-config-changed': "发布配置已变更，请重新打开菜单。";
+    'marivo.presentation.publish-report-unconfirmed': "上传结果未确认，请检查对象存储或重试。";
+    'marivo.presentation.publish-report-failed': "无法发布报告，请重试。";
+    'marivo.presentation.open-published-report': "查看已发布报告";
+    'marivo.presentation.open-publishing-credentials': "前往凭证管理";
+    'marivo.presentation.publish-report-dismiss': "关闭发布提示";
     'marivo.presentation.ui-open-tab': "在右侧打开分析视图";
     'marivo.presentation.ui-loading': "正在读取已保存快照…";
     'marivo.presentation.ui-preparing': "正在准备分析视图…";
@@ -575,6 +587,15 @@ export declare const zh: {
     'marivo.navigation.cannot-verify-the-new-version': "无法核验新版本";
     'marivo.navigation.report-identity-changed': "分析视图身份已变化";
     'marivo.navigation.open-value': "打开{p0}";
+    'marivo.credentials.datasources-tab': "数据源";
+    'marivo.credentials.credential-management-tab': "凭证管理";
+    'marivo.credentials.report-publishing-credentials': "报告发布凭证";
+    'marivo.credentials.refresh-credential-status': "刷新凭证状态";
+    'marivo.credentials.loading-publishing-credentials': "正在读取发布凭证状态…";
+    'marivo.credentials.publishing-disabled': "当前 Host 尚未启用对象存储发布。";
+    'marivo.credentials.publishing-config-changed': "发布配置已更新，请刷新状态后重新填写。";
+    'marivo.credentials.publishing-credential-unconfirmed': "凭证操作结果未确认，请刷新状态后重试。";
+    'marivo.credentials.delete-shared-publishing-credential': "删除 {p0} 的已保存值？当前 Host 中使用此引用的 Workspace 都会受到影响。";
     'marivo.credentials.basic-settings': "基本配置";
     'marivo.credentials.advanced-settings': "高级设置";
     'marivo.credentials.autocommit-required': "MySQL 和 PostgreSQL 仅支持默认或启用自动提交；请选择默认或 true。";

package/lib/types/client/i18n/credentials.d.ts

@@ -1,5 +1,14 @@
 /** Plugin-owned copy; keys are stable identifiers, never business labels. */
 export declare const zh: {
+    readonly 'marivo.credentials.datasources-tab': "数据源";
+    readonly 'marivo.credentials.credential-management-tab': "凭证管理";
+    readonly 'marivo.credentials.report-publishing-credentials': "报告发布凭证";
+    readonly 'marivo.credentials.refresh-credential-status': "刷新凭证状态";
+    readonly 'marivo.credentials.loading-publishing-credentials': "正在读取发布凭证状态…";
+    readonly 'marivo.credentials.publishing-disabled': "当前 Host 尚未启用对象存储发布。";
+    readonly 'marivo.credentials.publishing-config-changed': "发布配置已更新，请刷新状态后重新填写。";
+    readonly 'marivo.credentials.publishing-credential-unconfirmed': "凭证操作结果未确认，请刷新状态后重试。";
+    readonly 'marivo.credentials.delete-shared-publishing-credential': "删除 {p0} 的已保存值？当前 Host 中使用此引用的 Workspace 都会受到影响。";
     readonly 'marivo.credentials.basic-settings': "基本配置";
     readonly 'marivo.credentials.advanced-settings': "高级设置";
     readonly 'marivo.credentials.autocommit-required': "MySQL 和 PostgreSQL 仅支持默认或启用自动提交；请选择默认或 true。";
@@ -271,6 +280,15 @@ export declare const zh: {
     readonly 'marivo.credentials.save-failed': "保存配置失败。";
 };
 export declare const en: {
+    'marivo.credentials.datasources-tab': string;
+    'marivo.credentials.credential-management-tab': string;
+    'marivo.credentials.report-publishing-credentials': string;
+    'marivo.credentials.refresh-credential-status': string;
+    'marivo.credentials.loading-publishing-credentials': string;
+    'marivo.credentials.publishing-disabled': string;
+    'marivo.credentials.publishing-config-changed': string;
+    'marivo.credentials.publishing-credential-unconfirmed': string;
+    'marivo.credentials.delete-shared-publishing-credential': string;
     'marivo.credentials.basic-settings': string;
     'marivo.credentials.advanced-settings': string;
     'marivo.credentials.autocommit-required': string;

package/lib/types/client/i18n/presentation.d.ts

@@ -162,6 +162,18 @@ export declare const zh: {
     readonly 'marivo.presentation.export-html-started': "HTML 下载已开始。";
     readonly 'marivo.presentation.export-html-failed': "导出失败，请重试。";
     readonly 'marivo.presentation.export-html-dismiss': "关闭导出提示";
+    readonly 'marivo.presentation.report-delivery-checking': "正在读取导出设置…";
+    readonly 'marivo.presentation.report-delivery-unavailable': "导出设置不可用，重新打开菜单重试";
+    readonly 'marivo.presentation.publish-report': "发布到对象存储";
+    readonly 'marivo.presentation.publishing-report': "正在发布…";
+    readonly 'marivo.presentation.publish-report-success': "报告已上传到对象存储。";
+    readonly 'marivo.presentation.publish-report-credentials-missing': "缺少发布凭据。补齐后可重新发布。";
+    readonly 'marivo.presentation.publish-report-config-changed': "发布配置已变更，请重新打开菜单。";
+    readonly 'marivo.presentation.publish-report-unconfirmed': "上传结果未确认，请检查对象存储或重试。";
+    readonly 'marivo.presentation.publish-report-failed': "无法发布报告，请重试。";
+    readonly 'marivo.presentation.open-published-report': "查看已发布报告";
+    readonly 'marivo.presentation.open-publishing-credentials': "前往凭证管理";
+    readonly 'marivo.presentation.publish-report-dismiss': "关闭发布提示";
     readonly 'marivo.presentation.ui-open-tab': "在右侧打开分析视图";
     readonly 'marivo.presentation.ui-loading': "正在读取已保存快照…";
     readonly 'marivo.presentation.ui-preparing': "正在准备分析视图…";
@@ -398,6 +410,18 @@ export declare const en: {
     'marivo.presentation.export-html-started': string;
     'marivo.presentation.export-html-failed': string;
     'marivo.presentation.export-html-dismiss': string;
+    'marivo.presentation.report-delivery-checking': string;
+    'marivo.presentation.report-delivery-unavailable': string;
+    'marivo.presentation.publish-report': string;
+    'marivo.presentation.publishing-report': string;
+    'marivo.presentation.publish-report-success': string;
+    'marivo.presentation.publish-report-credentials-missing': string;
+    'marivo.presentation.publish-report-config-changed': string;
+    'marivo.presentation.publish-report-unconfirmed': string;
+    'marivo.presentation.publish-report-failed': string;
+    'marivo.presentation.open-published-report': string;
+    'marivo.presentation.open-publishing-credentials': string;
+    'marivo.presentation.publish-report-dismiss': string;
     'marivo.presentation.ui-open-tab': string;
     'marivo.presentation.ui-loading': string;
     'marivo.presentation.ui-preparing': string;

package/lib/types/client/right-tabs/report-actions.d.ts

@@ -1,9 +1,13 @@
 import type { AnalysisDocument } from '../../presentation/contracts/analysis-document.ts';
-export declare function ReportActions({ document, isCurrent, onHistory, refreshLocked, onRefreshData, onDelete, }: {
+import type { BrowserRpc } from '../semantic-browser/model.ts';
+export declare function ReportActions({ document, isCurrent, onHistory, refreshLocked, onRefreshData, onDelete, rpc, signal, onOpenPublishingCredentials, }: {
     document: AnalysisDocument;
     isCurrent: () => boolean;
     onHistory: () => void;
     refreshLocked: boolean;
     onRefreshData: (isCurrent: () => boolean) => Promise<'accepted' | 'stale' | 'unavailable' | 'failed' | 'uncertain'>;
     onDelete: (isCurrent: () => boolean) => Promise<'deleted' | 'cleanup-pending' | 'stale' | 'unavailable' | 'failed' | 'uncertain'>;
+    rpc: BrowserRpc;
+    signal: AbortSignal;
+    onOpenPublishingCredentials: () => void;
 }): import("react").JSX.Element;

package/lib/types/client/right-tabs/report-publishing.d.ts

@@ -0,0 +1,21 @@
+import type { AnalysisDocument } from '../../presentation/contracts/analysis-document.ts';
+import type { BrowserRpc } from '../semantic-browser/model.ts';
+type PublishStatus = {
+    kind: 'working' | 'credentials-missing' | 'config-changed' | 'unconfirmed' | 'failed';
+} | {
+    kind: 'success';
+    url: string;
+};
+export declare function useReportPublishing({ rpc, document, signal, isCurrent, }: {
+    rpc: BrowserRpc;
+    document: AnalysisDocument;
+    signal: AbortSignal;
+    isCurrent: () => boolean;
+}): {
+    mode: "unavailable" | "publish" | "download" | "checking";
+    status: PublishStatus | undefined;
+    check: () => Promise<void>;
+    publish: () => Promise<void>;
+    dismiss: () => void;
+};
+export {};

package/lib/types/client/right-tabs/styles.d.ts

@@ -1,2 +1,2 @@
 /** Content layout inside the native Host right-side tab. */
-export declare const rightTabStyles = "\n.rt-page{height:100%;width:100%;min-width:0;overflow:auto;padding:1rem;box-sizing:border-box;container-type:inline-size}\n.rt-heading-row{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:1rem;margin-bottom:.25rem}\n.rt-heading{margin:0;font-size:1.25rem;line-height:1.4;font-weight:600;overflow-wrap:anywhere}\n.rt-heading-row>button{flex:none}\n.rt-caption{color:var(--muted-foreground);font-size:.875rem;margin:0 0 1.5rem;overflow-wrap:anywhere}\n.rt-report-surface{position:relative;min-width:0}\n.rt-toolbar{position:absolute;top:1rem;right:1rem;z-index:1}\n.rt-report-surface:has(.rt-toolbar) .au-surface-content>:first-child:not(.au-surface-body),\n.rt-report-surface:has(.rt-toolbar) .au-surface-body:first-child>[aria-busy]>div>:not(.au-stack[data-direction=column]),\n.rt-report-surface:has(.rt-toolbar) .au-surface-body:first-child>[aria-busy]>div>.au-stack[data-direction=column]>:first-child{box-sizing:border-box;padding-right:3rem}\n.rt-actions-menu{z-index:100;min-width:13rem;max-width:min(22rem,calc(100vw - 2rem));padding:.35rem;border:1px solid var(--border);border-radius:var(--radius-lg);background:var(--popover);color:var(--popover-foreground);box-shadow:0 8px 24px #0002;font-size:.875rem}\n.rt-actions-item{padding:.5rem .65rem;border-radius:var(--radius-md);cursor:pointer;outline:none}\n.rt-actions-item[data-highlighted]{background:var(--accent);color:var(--accent-foreground)}\n.rt-actions-item[data-disabled]{opacity:.5;cursor:default}\n.rt-dialog-overlay{position:fixed;inset:0;background:#0008;z-index:200}\n.rt-dialog{position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);z-index:201;width:min(28rem,calc(100vw - 2rem));box-sizing:border-box;padding:1.25rem;border:1px solid var(--border);border-radius:var(--radius-lg);background:var(--popover);color:var(--popover-foreground);box-shadow:0 8px 24px #0003}\n.rt-dialog h2{font-size:1.1rem;font-weight:600;margin:0 0 .75rem}.rt-dialog p{margin:0;overflow-wrap:anywhere;line-height:1.5}\n.rt-dialog-actions{display:flex;justify-content:flex-end;gap:.5rem;margin-top:1.25rem}\n.rt-export-notice{position:absolute;top:calc(100% + .5rem);right:0;z-index:101;display:flex;align-items:center;gap:.5rem;width:max-content;max-width:min(22rem,calc(100vw - 2rem));box-sizing:border-box;padding:.75rem;border:1px solid var(--border);border-radius:var(--radius-lg);background:var(--popover);color:var(--popover-foreground);box-shadow:0 8px 24px #0002;font-size:.875rem;line-height:1.4}\n.rt-export-notice>svg{width:1rem;height:1rem;flex:none;color:var(--primary)}\n.rt-export-notice-error>svg{color:var(--destructive)}\n.rt-export-notice button{width:1.75rem;height:1.75rem;flex:none;margin:-.375rem -.375rem -.375rem 0}\n.rt-notice{display:flex;align-items:center;flex-wrap:wrap;gap:.75rem;margin-bottom:1rem}\n.rt-page .pd-catalog{padding:0;overflow:auto}\n.rt-page .pd-history{position:static;max-height:300px;margin-bottom:1rem;width:100%}\n";
+export declare const rightTabStyles = "\n.rt-page{height:100%;width:100%;min-width:0;overflow:auto;padding:1rem;box-sizing:border-box;container-type:inline-size}\n.rt-heading-row{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:1rem;margin-bottom:.25rem}\n.rt-heading{margin:0;font-size:1.25rem;line-height:1.4;font-weight:600;overflow-wrap:anywhere}\n.rt-heading-row>button{flex:none}\n.rt-caption{color:var(--muted-foreground);font-size:.875rem;margin:0 0 1.5rem;overflow-wrap:anywhere}\n.rt-report-surface{position:relative;min-width:0}\n.rt-toolbar{position:absolute;top:1rem;right:1rem;z-index:1}\n.rt-report-surface:has(.rt-toolbar) .au-surface-content>:first-child:not(.au-surface-body),\n.rt-report-surface:has(.rt-toolbar) .au-surface-body:first-child>[aria-busy]>div>:not(.au-stack[data-direction=column]),\n.rt-report-surface:has(.rt-toolbar) .au-surface-body:first-child>[aria-busy]>div>.au-stack[data-direction=column]>:first-child{box-sizing:border-box;padding-right:3rem}\n.rt-actions-menu{z-index:100;min-width:13rem;max-width:min(22rem,calc(100vw - 2rem));padding:.35rem;border:1px solid var(--border);border-radius:var(--radius-lg);background:var(--popover);color:var(--popover-foreground);box-shadow:0 8px 24px #0002;font-size:.875rem}\n.rt-actions-item{padding:.5rem .65rem;border-radius:var(--radius-md);cursor:pointer;outline:none}\n.rt-actions-item[data-highlighted]{background:var(--accent);color:var(--accent-foreground)}\n.rt-actions-item[data-disabled]{opacity:.5;cursor:default}\n.rt-dialog-overlay{position:fixed;inset:0;background:#0008;z-index:200}\n.rt-dialog{position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);z-index:201;width:min(28rem,calc(100vw - 2rem));box-sizing:border-box;padding:1.25rem;border:1px solid var(--border);border-radius:var(--radius-lg);background:var(--popover);color:var(--popover-foreground);box-shadow:0 8px 24px #0003}\n.rt-dialog h2{font-size:1.1rem;font-weight:600;margin:0 0 .75rem}.rt-dialog p{margin:0;overflow-wrap:anywhere;line-height:1.5}\n.rt-dialog-actions{display:flex;justify-content:flex-end;gap:.5rem;margin-top:1.25rem}\n.rt-export-notice{position:absolute;top:calc(100% + .5rem);right:0;z-index:101;display:flex;align-items:center;gap:.5rem;width:max-content;max-width:min(22rem,calc(100vw - 2rem));box-sizing:border-box;padding:.75rem;border:1px solid var(--border);border-radius:var(--radius-lg);background:var(--popover);color:var(--popover-foreground);box-shadow:0 8px 24px #0002;font-size:.875rem;line-height:1.4}\n.rt-export-notice>svg{width:1rem;height:1rem;flex:none;color:var(--primary)}\n.rt-export-notice-error>svg{color:var(--destructive)}\n.rt-export-notice button{width:1.75rem;height:1.75rem;flex:none;margin:-.375rem -.375rem -.375rem 0}\n.rt-publishing-details{display:flex;flex-direction:column;align-items:flex-start;gap:.25rem;min-width:0;overflow-wrap:anywhere}\n.rt-publishing-details a{color:var(--primary);text-decoration:underline}\n.rt-publishing-details button{width:auto;height:auto;margin:0;padding:0;white-space:normal;text-align:start}\n.rt-notice{display:flex;align-items:center;flex-wrap:wrap;gap:.75rem;margin-bottom:1rem}\n.rt-page .pd-catalog{padding:0;overflow:auto}\n.rt-page .pd-history{position:static;max-height:300px;margin-bottom:1rem;width:100%}\n";

package/lib/types/environment/identity.d.ts

@@ -0,0 +1,6 @@
+import type { ImportIdentity } from './types.ts';
+/** Resolve directory aliases without following a venv's Python link into its base installation. */
+export declare function canonicalPythonExecutable(executable: string): string;
+export declare function canonicalImportIdentity(identity: ImportIdentity): ImportIdentity;
+/** The Python equivalent of canonicalImportIdentity, shared by every execution boundary. */
+export declare const PYTHON_IMPORT_IDENTITY: string;

package/lib/types/plugin-agents.d.ts

@@ -7,6 +7,7 @@ import { type MarivoDisclosureOptions } from './disclosure/index.ts';
 import { MarivoEnvironment } from './environment/index.ts';
 import type { NextStepsNotice } from './next-steps/contracts.ts';
 import { AnalysisDrafts } from './presentation/drafts.ts';
+import type { ReportPublishingService } from './report-publishing/service.ts';
 export type MarivoPluginEnvironmentResolver = (agent: Agent) => MarivoEnvironment | Promise<MarivoEnvironment>;
 /**
  * Install one already-bound environment into every live or subsequently published Agent scope.
@@ -22,6 +23,7 @@ export declare function createMarivoAgentInstallation(ctx: Context, environmentO
     /** Runtime-scoped Help source; normal plugin installation never binds Help to a Workspace. */
     helpBridgeSource?: MarivoHelpBridgeSource;
     presentationDrafts?: AnalysisDrafts;
+    reportPublishing?: ReportPublishingService;
     nextStepsPublish?: (notice: NextStepsNotice) => void;
 }): {
     install(): void;

package/lib/types/plugin.d.ts

@@ -4,6 +4,7 @@ export { resolvePresentationWorkspace } from './workspace-identity.ts';
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { MarivoIntegrationV1 } from './integration.ts';
+import { type ReportPublishingConfig } from './report-publishing/config.ts';
 /** Cordis plugin name used by loader diagnostics and lifecycle logs. */
 export declare const name = "dsh-data-analysis";
 /** Services that must exist before the plugin binds and watches Agent scopes. */
@@ -11,6 +12,7 @@ export declare const inject: string[];
 /** Loader-safe configuration for the shared Runtime and per-Workspace bindings. */
 export interface Config extends PythonTimeoutConfig {
     readonly credentialInteraction?: 'web' | 'none';
+    readonly reportPublishing?: ReportPublishingConfig;
     /** Explicit project root override; otherwise each Agent uses session.header.cwd. */
     readonly projectRoot?: string;
     /** Administrator-provided shared interpreter; must already contain an importable Marivo. */
@@ -24,6 +26,7 @@ export interface Config extends PythonTimeoutConfig {
 }
 /** Cordis loader schema. Runtime defaults are resolved in {@link apply}. */
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    reportPublishing: z<any, any, "plain">;
     pythonTimeoutMs: z<number, number, "volatile-defined">;
     credentialInteraction: z<"web" | "none", "web" | "none", "defined">;
     projectRoot: z<string, string, "plain">;
@@ -32,6 +35,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     bootstrapPythonExecutable: z<string, string, "plain">;
     installTimeoutMs: z<number, number, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
+    reportPublishing: z<any, any, "plain">;
     pythonTimeoutMs: z<number, number, "volatile-defined">;
     credentialInteraction: z<"web" | "none", "web" | "none", "defined">;
     projectRoot: z<string, string, "plain">;