-
![]()
+
![]()
- CPA-Helper
+ {{ productName }}
{{ appVersion }}
{{ accountText }} · {{ roleText }}
@@ -430,7 +431,7 @@ const logoutAriaLabel = computed(() => t('退出登录', 'Sign out'))
-
+
diff --git a/frontend/src/features/auth/views/ChangeCredentialsView.vue b/frontend/src/features/auth/views/ChangeCredentialsView.vue
index 78bcbff7..0446b92a 100644
--- a/frontend/src/features/auth/views/ChangeCredentialsView.vue
+++ b/frontend/src/features/auth/views/ChangeCredentialsView.vue
@@ -6,11 +6,12 @@ import { NAlert, NButton, NCard, NForm, NFormItem, NInput, useMessage } from 'na
import { changeCredentials, getMe } from '@/features/auth/api/authApi'
import { setCurrentUser } from '@/features/auth/state/currentUser'
import { useI18n } from '@/shared/i18n'
-import { logoUrl } from '@/shared/utils/assets'
+import { useProductInfo } from '@/shared/state/productInfo'
const router = useRouter()
const message = useMessage()
const { errorText, t } = useI18n()
+const { productLogo } = useProductInfo()
const isLoading = ref(false)
const errorMessage = ref(null)
const form = reactive({
@@ -58,7 +59,7 @@ async function handleSubmit() {
-
![]()
+
![]()
-
![]()
+
![]()
+
+
+
+
{{ t('产品信息', 'Product Branding') }}
+
+
+
+
@@ -290,6 +360,61 @@ onMounted(refresh)
margin-top: 10px;
}
+.branding-grid {
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.logo-upload-row {
+ display: flex;
+ align-items: center;
+ gap: 12px;
+}
+
+.logo-preview {
+ flex-shrink: 0;
+ width: 52px;
+ height: 52px;
+ border-radius: 12px;
+ overflow: hidden;
+ background: var(--cpa-surface-solid);
+ border: 1px solid var(--cpa-border);
+ display: grid;
+ place-items: center;
+}
+
+.logo-preview img {
+ width: 100%;
+ height: 100%;
+ object-fit: cover;
+}
+
+.logo-placeholder {
+ color: var(--cpa-text-muted);
+ font-size: 22px;
+ font-weight: 700;
+ line-height: 1;
+}
+
+.logo-upload-actions {
+ display: flex;
+ gap: 8px;
+ align-items: center;
+ flex-wrap: wrap;
+}
+
+.logo-file-label {
+ cursor: pointer;
+}
+
+.logo-file-input {
+ position: absolute;
+ width: 1px;
+ height: 1px;
+ overflow: hidden;
+ clip: rect(0, 0, 0, 0);
+ white-space: nowrap;
+}
+
@media (max-width: 900px) {
.settings-metrics {
grid-template-columns: repeat(2, minmax(0, 1fr));
diff --git a/frontend/src/main.ts b/frontend/src/main.ts
index a082a36d..908a14ef 100644
--- a/frontend/src/main.ts
+++ b/frontend/src/main.ts
@@ -2,7 +2,9 @@ import { createApp } from 'vue'
import App from './app/App.vue'
import { router } from './app/router'
+import { loadProductInfo } from './shared/state/productInfo'
import './styles/tokens.css'
+loadProductInfo()
createApp(App).use(router).mount('#app')
diff --git a/frontend/src/shared/state/productInfo.ts b/frontend/src/shared/state/productInfo.ts
new file mode 100644
index 00000000..65564b0e
--- /dev/null
+++ b/frontend/src/shared/state/productInfo.ts
@@ -0,0 +1,32 @@
+import { readonly, ref } from 'vue'
+
+import { apiClient } from '@/shared/api/apiClient'
+import type { ProductInfoResponse } from '@/shared/types/api'
+import { logoUrl as defaultLogoUrl } from '@/shared/utils/assets'
+
+const DEFAULT_PRODUCT_NAME = 'CPA-Helper'
+
+const productName = ref(DEFAULT_PRODUCT_NAME)
+const productLogo = ref(defaultLogoUrl)
+
+export async function loadProductInfo(): Promise
{
+ try {
+ const info = await apiClient.get('/product-info')
+ productName.value = info.product_name.trim() || DEFAULT_PRODUCT_NAME
+ productLogo.value = info.product_logo.trim() || defaultLogoUrl
+ } catch {
+ // fall back to defaults on error
+ }
+}
+
+export function setProductInfo(name: string, logo: string): void {
+ productName.value = name.trim() || DEFAULT_PRODUCT_NAME
+ productLogo.value = logo.trim() || defaultLogoUrl
+}
+
+export function useProductInfo() {
+ return {
+ productName: readonly(productName),
+ productLogo: readonly(productLogo),
+ }
+}
diff --git a/frontend/src/shared/types/api.ts b/frontend/src/shared/types/api.ts
index a03c1dac..cdfe2fe1 100644
--- a/frontend/src/shared/types/api.ts
+++ b/frontend/src/shared/types/api.ts
@@ -37,6 +37,8 @@ export interface SettingsResponse {
batch_size: number
poll_interval_seconds: number
retry_interval_seconds: number
+ product_name: string
+ product_logo: string
}
export interface SettingsUpdatePayload {
@@ -48,6 +50,13 @@ export interface SettingsUpdatePayload {
batch_size?: number
poll_interval_seconds?: number
retry_interval_seconds?: number
+ product_name?: string
+ product_logo?: string
+}
+
+export interface ProductInfoResponse {
+ product_name: string
+ product_logo: string
}
export interface ModelRequestGuide {
From 08cf6e84ae858be3980227d76f6241e54ced7711 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 6 Aug 2026 09:06:20 +0000
Subject: [PATCH 02/25] fix: address review comments on branding feature
Co-authored-by: bytemain <13938334+bytemain@users.noreply.github.com>
---
backend/internal/app/auth_settings.go | 2 +-
backend/migrations/202608060001_product_branding.sql | 2 ++
frontend/src/app/layout/AppShell.vue | 2 +-
frontend/src/features/settings/views/SettingsView.vue | 1 +
4 files changed, 5 insertions(+), 2 deletions(-)
diff --git a/backend/internal/app/auth_settings.go b/backend/internal/app/auth_settings.go
index 5a04980d..23c4ebaa 100644
--- a/backend/internal/app/auth_settings.go
+++ b/backend/internal/app/auth_settings.go
@@ -361,7 +361,7 @@ func (a *App) handleSettings(w http.ResponseWriter, r *http.Request) error {
if payload.ProductLogo != nil {
logo := strings.TrimSpace(*payload.ProductLogo)
if logo != "" && !isAllowedLogoDataURL(logo) {
- return validationError("product_logo 必须是 PNG 或 JPEG 的 base64 data URL")
+ return validationError("product_logo 必须是 PNG、JPEG、WebP 或 GIF 的 base64 data URL")
}
cfg.ProductLogo = logo
}
diff --git a/backend/migrations/202608060001_product_branding.sql b/backend/migrations/202608060001_product_branding.sql
index cc4c10f6..02b88783 100644
--- a/backend/migrations/202608060001_product_branding.sql
+++ b/backend/migrations/202608060001_product_branding.sql
@@ -3,3 +3,5 @@ ALTER TABLE app_settings ADD COLUMN product_name VARCHAR(64) NOT NULL DEFAULT ''
ALTER TABLE app_settings ADD COLUMN product_logo TEXT NOT NULL DEFAULT '';
-- +goose Down
+ALTER TABLE app_settings DROP COLUMN product_logo;
+ALTER TABLE app_settings DROP COLUMN product_name;
diff --git a/frontend/src/app/layout/AppShell.vue b/frontend/src/app/layout/AppShell.vue
index abf58225..9de237c7 100644
--- a/frontend/src/app/layout/AppShell.vue
+++ b/frontend/src/app/layout/AppShell.vue
@@ -379,7 +379,7 @@ const logoutAriaLabel = computed(() => t('退出登录', 'Sign out'))
-
+
![]()
diff --git a/frontend/src/features/settings/views/SettingsView.vue b/frontend/src/features/settings/views/SettingsView.vue
index df50f62d..e73a3af3 100644
--- a/frontend/src/features/settings/views/SettingsView.vue
+++ b/frontend/src/features/settings/views/SettingsView.vue
@@ -412,6 +412,7 @@ onMounted(refresh)
height: 1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
+ clip-path: inset(50%);
white-space: nowrap;
}
From 8d6bc6ccbf805e9d2c68a2763a2fd5eefb8b0f01 Mon Sep 17 00:00:00 2001
From: bytemain
Date: Mon, 10 Aug 2026 13:09:56 +0000
Subject: [PATCH 03/25] fix: sync document.title with product name branding
---
frontend/src/shared/state/productInfo.ts | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/frontend/src/shared/state/productInfo.ts b/frontend/src/shared/state/productInfo.ts
index 65564b0e..fccef7ef 100644
--- a/frontend/src/shared/state/productInfo.ts
+++ b/frontend/src/shared/state/productInfo.ts
@@ -9,11 +9,16 @@ const DEFAULT_PRODUCT_NAME = 'CPA-Helper'
const productName = ref(DEFAULT_PRODUCT_NAME)
const productLogo = ref(defaultLogoUrl)
+function syncDocumentTitle(name: string): void {
+ document.title = name
+}
+
export async function loadProductInfo(): Promise {
try {
const info = await apiClient.get('/product-info')
productName.value = info.product_name.trim() || DEFAULT_PRODUCT_NAME
productLogo.value = info.product_logo.trim() || defaultLogoUrl
+ syncDocumentTitle(productName.value)
} catch {
// fall back to defaults on error
}
@@ -22,6 +27,7 @@ export async function loadProductInfo(): Promise {
export function setProductInfo(name: string, logo: string): void {
productName.value = name.trim() || DEFAULT_PRODUCT_NAME
productLogo.value = logo.trim() || defaultLogoUrl
+ syncDocumentTitle(productName.value)
}
export function useProductInfo() {
From 90de775d425b11da2e42bed21a4fcaf3c4bf064c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 19 Aug 2026 17:56:03 +0000
Subject: [PATCH 04/25] fix: inject product branding into index.html
server-side
Co-authored-by: bytemain <13938334+bytemain@users.noreply.github.com>
---
backend/internal/app/app.go | 67 ++++++++++++++++++++++--
backend/internal/app/frontend_test.go | 64 ++++++++++++++++++++++
frontend/src/shared/state/productInfo.ts | 1 -
3 files changed, 128 insertions(+), 4 deletions(-)
diff --git a/backend/internal/app/app.go b/backend/internal/app/app.go
index 0371472a..c5a0962a 100644
--- a/backend/internal/app/app.go
+++ b/backend/internal/app/app.go
@@ -402,8 +402,14 @@ func (a *App) serveExternalSPA(w http.ResponseWriter, r *http.Request) (bool, er
}
indexPath := filepath.Join(a.frontendDist, "index.html")
if _, err := os.Stat(indexPath); err == nil {
- http.ServeFile(w, r, indexPath)
- return true, nil
+ data, err := os.ReadFile(indexPath)
+ if err != nil {
+ return false, err
+ }
+ data = a.injectBranding(r.Context(), data)
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ _, err = w.Write(data)
+ return true, err
}
return false, nil
}
@@ -416,11 +422,66 @@ func (a *App) serveEmbeddedSPA(w http.ResponseWriter, r *http.Request) (bool, er
}
}
if _, err := fs.Stat(a.frontendFS, "index.html"); err == nil {
- return true, serveFSFile(w, r, a.frontendFS, "index.html")
+ data, err := fs.ReadFile(a.frontendFS, "index.html")
+ if err != nil {
+ return false, err
+ }
+ data = a.injectBranding(r.Context(), data)
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ _, err = w.Write(data)
+ return true, err
}
return false, nil
}
+// injectBranding replaces the tag and __CPA_HELPER_LOGO_URL__ placeholder
+// in the given HTML with the product name and logo from the app configuration.
+// On any error it returns the original HTML unchanged.
+func (a *App) injectBranding(ctx context.Context, html []byte) []byte {
+ if a.db == nil {
+ return html
+ }
+ cfg, err := a.loadConfig(ctx)
+ if err != nil {
+ return html
+ }
+
+ productName := cfg.ProductName
+ if productName == "" {
+ productName = "CPA-Helper"
+ }
+ logoURL := cfg.ProductLogo
+ if logoURL == "" {
+ logoURL = "/logo.png"
+ }
+
+ html = bytes.ReplaceAll(html, []byte("__CPA_HELPER_LOGO_URL__"), []byte(logoURL))
+ html = replaceTitleTag(html, productName)
+ return html
+}
+
+// replaceTitleTag replaces the content of the first <title>... in html.
+func replaceTitleTag(html []byte, title string) []byte {
+ const openTag = ""
+ const closeTag = ""
+ start := bytes.Index(html, []byte(openTag))
+ if start == -1 {
+ return html
+ }
+ end := bytes.Index(html[start:], []byte(closeTag))
+ if end == -1 {
+ return html
+ }
+ end += start
+ var buf bytes.Buffer
+ buf.Write(html[:start])
+ buf.WriteString(openTag)
+ buf.WriteString(title)
+ buf.WriteString(closeTag)
+ buf.Write(html[end+len(closeTag):])
+ return buf.Bytes()
+}
+
func cleanSPAPath(requestPath string) string {
cleaned := slashpath.Clean("/" + strings.TrimPrefix(requestPath, "/"))
if cleaned == "/" {
diff --git a/backend/internal/app/frontend_test.go b/backend/internal/app/frontend_test.go
index 1daffdfc..e3eaced9 100644
--- a/backend/internal/app/frontend_test.go
+++ b/backend/internal/app/frontend_test.go
@@ -1,6 +1,7 @@
package app
import (
+ "context"
"net/http/httptest"
"os"
"path/filepath"
@@ -96,3 +97,66 @@ func TestHandleSPAFrontendDistOverrideUsesExternalFiles(t *testing.T) {
t.Fatalf("body = %q", body)
}
}
+
+func TestReplaceTitleTag(t *testing.T) {
+ tests := []struct {
+ name string
+ input string
+ title string
+ want string
+ }{
+ {
+ name: "replaces existing title",
+ input: `CPA-Helper`,
+ title: "My Product",
+ want: `My Product`,
+ },
+ {
+ name: "no title tag returns unchanged",
+ input: ``,
+ title: "My Product",
+ want: ``,
+ },
+ {
+ name: "no closing tag returns unchanged",
+ input: `CPA-Helper</head></html>`,
+ title: "My Product",
+ want: `<html><head><title>CPA-Helper</head></html>`,
+ },
+ }
+ for _, tc := range tests {
+ t.Run(tc.name, func(t *testing.T) {
+ got := string(replaceTitleTag([]byte(tc.input), tc.title))
+ if got != tc.want {
+ t.Fatalf("got %q, want %q", got, tc.want)
+ }
+ })
+ }
+}
+
+func TestInjectBrandingNilDB(t *testing.T) {
+ // When a.db is nil (no database), injectBranding returns the HTML unchanged.
+ app := &App{}
+ input := `<html><head><title>CPA-Helper`
+ got := string(app.injectBranding(context.Background(), []byte(input)))
+ if got != input {
+ t.Fatalf("expected unchanged HTML when db is nil, got %q", got)
+ }
+}
+
+func TestHandleSPAInjectsTitle(t *testing.T) {
+ // When db is nil the HTML is served as-is (no injection panic).
+ app := &App{frontendFS: fstest.MapFS{
+ "index.html": &fstest.MapFile{Data: []byte(`CPA-Helper`)},
+ }}
+
+ req := httptest.NewRequest("GET", "http://example.com/", nil)
+ recorder := httptest.NewRecorder()
+ if err := app.handleSPA(recorder, req); err != nil {
+ t.Fatal(err)
+ }
+ body := recorder.Body.String()
+ if !strings.Contains(body, "CPA-Helper") {
+ t.Fatalf("body = %q", body)
+ }
+}
diff --git a/frontend/src/shared/state/productInfo.ts b/frontend/src/shared/state/productInfo.ts
index fccef7ef..a5e42e1e 100644
--- a/frontend/src/shared/state/productInfo.ts
+++ b/frontend/src/shared/state/productInfo.ts
@@ -18,7 +18,6 @@ export async function loadProductInfo(): Promise {
const info = await apiClient.get('/product-info')
productName.value = info.product_name.trim() || DEFAULT_PRODUCT_NAME
productLogo.value = info.product_logo.trim() || defaultLogoUrl
- syncDocumentTitle(productName.value)
} catch {
// fall back to defaults on error
}
From 441bf6afe646de83d1b52610e877d69b4776f3a4 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 19 Aug 2026 18:03:35 +0000
Subject: [PATCH 05/25] fix: embed product info in HTML to eliminate
/api/product-info request
Co-authored-by: bytemain <13938334+bytemain@users.noreply.github.com>
---
backend/internal/app/app.go | 30 +++++++++++++++-
backend/internal/app/frontend_test.go | 34 ++++++++++++++++++-
.../src/features/auth/views/LoginView.vue | 11 +++---
frontend/src/shared/state/productInfo.ts | 16 ++++-----
4 files changed, 73 insertions(+), 18 deletions(-)
diff --git a/backend/internal/app/app.go b/backend/internal/app/app.go
index c5a0962a..eb3a5000 100644
--- a/backend/internal/app/app.go
+++ b/backend/internal/app/app.go
@@ -435,7 +435,9 @@ func (a *App) serveEmbeddedSPA(w http.ResponseWriter, r *http.Request) (bool, er
}
// injectBranding replaces the tag and __CPA_HELPER_LOGO_URL__ placeholder
-// in the given HTML with the product name and logo from the app configuration.
+// in the given HTML with the product name and logo from the app configuration,
+// and injects a <script> block that exposes window.__PRODUCT_INFO__ so the
+// frontend can bootstrap without an extra HTTP round-trip.
// On any error it returns the original HTML unchanged.
func (a *App) injectBranding(ctx context.Context, html []byte) []byte {
if a.db == nil {
@@ -457,9 +459,35 @@ func (a *App) injectBranding(ctx context.Context, html []byte) []byte {
html = bytes.ReplaceAll(html, []byte("__CPA_HELPER_LOGO_URL__"), []byte(logoURL))
html = replaceTitleTag(html, productName)
+ html = injectProductInfoScript(html, productName, logoURL)
return html
}
+// injectProductInfoScript injects a <script> block before </head> that sets
+// window.__PRODUCT_INFO__ = {product_name: "...", product_logo: "..."}.
+// Values are embedded as JSON so they are properly escaped.
+func injectProductInfoScript(html []byte, productName, productLogo string) []byte {
+ type productInfo struct {
+ ProductName string `json:"product_name"`
+ ProductLogo string `json:"product_logo"`
+ }
+ jsonBytes, err := json.Marshal(productInfo{ProductName: productName, ProductLogo: productLogo})
+ if err != nil {
+ return html
+ }
+ script := []byte("<script>window.__PRODUCT_INFO__=" + string(jsonBytes) + "</script>")
+ const headClose = "</head>"
+ idx := bytes.Index(html, []byte(headClose))
+ if idx == -1 {
+ return html
+ }
+ var buf bytes.Buffer
+ buf.Write(html[:idx])
+ buf.Write(script)
+ buf.Write(html[idx:])
+ return buf.Bytes()
+}
+
// replaceTitleTag replaces the content of the first <title>... in html.
func replaceTitleTag(html []byte, title string) []byte {
const openTag = ""
diff --git a/backend/internal/app/frontend_test.go b/backend/internal/app/frontend_test.go
index e3eaced9..321d5097 100644
--- a/backend/internal/app/frontend_test.go
+++ b/backend/internal/app/frontend_test.go
@@ -144,8 +144,40 @@ func TestInjectBrandingNilDB(t *testing.T) {
}
}
+func TestInjectProductInfoScript(t *testing.T) {
+ tests := []struct {
+ name string
+ input string
+ productName string
+ productLogo string
+ wantContain string
+ }{
+ {
+ name: "injects script before </head>",
+ input: `<html><head><title>CPA-Helper