修复 Agent 部署 Pages 问题

internal/apps/upload/exports.go

@@ -31,10 +31,13 @@ var (
 
 // Programmatic ingest API
 var (
-	Ingest      = ingest.Ingest
-	Remove      = ingest.Remove
-	RemoveOwned = ingest.RemoveOwned
-	FindByHash  = ingest.FindByHash
+	Ingest           = ingest.Ingest
+	Remove           = ingest.Remove
+	RemoveOwned      = ingest.RemoveOwned
+	FindByHash       = ingest.FindByHash
+	GetActiveUpload  = ingest.GetActive
+	OpenStoredUpload = ingest.OpenActive
+	ActiveUploadHash = ingest.ActiveHash
 )
 
 // Ingest policy constants

internal/apps/upload/ingest/access.go

@@ -0,0 +1,49 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+package ingest
+
+import (
+	"context"
+	"errors"
+	"strings"
+
+	uploadcache "github.com/Rain-kl/Wavelet/internal/apps/upload/cache"
+	uploadstorage "github.com/Rain-kl/Wavelet/internal/apps/upload/storage"
+	"github.com/Rain-kl/Wavelet/internal/model"
+	"github.com/Rain-kl/Wavelet/internal/storage"
+)
+
+// GetActive loads an active upload record by ID through the upload metadata cache path.
+func GetActive(ctx context.Context, uploadID uint64) (model.Upload, error) {
+	if uploadID == 0 {
+		return model.Upload{}, errors.New("upload id is required")
+	}
+	return uploadcache.GetUploadByID(ctx, uploadID)
+}
+
+// OpenActive opens the stored object for an active upload record.
+func OpenActive(ctx context.Context, uploadID uint64) (*storage.Object, model.Upload, error) {
+	record, err := GetActive(ctx, uploadID)
+	if err != nil {
+		return nil, model.Upload{}, err
+	}
+	obj, err := uploadstorage.OpenStoredObject(ctx, &record)
+	if err != nil {
+		return nil, model.Upload{}, err
+	}
+	return obj, record, nil
+}
+
+// ActiveHash returns the SHA-256 hash recorded for an active upload.
+func ActiveHash(ctx context.Context, uploadID uint64) (string, error) {
+	record, err := GetActive(ctx, uploadID)
+	if err != nil {
+		return "", err
+	}
+	hash := strings.TrimSpace(record.Hash)
+	if hash == "" {
+		return "", errors.New("upload hash is empty")
+	}
+	return hash, nil
+}

internal/apps/upload/ingest/access_test.go

@@ -0,0 +1,16 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+package ingest
+
+import (
+	"context"
+	"testing"
+)
+
+func TestGetActiveRequiresUploadID(t *testing.T) {
+	_, err := GetActive(context.Background(), 0)
+	if err == nil {
+		t.Fatal("expected error for empty upload id")
+	}
+}