From d71e9157c088ac41d5e3318af566b8ee9732334a Mon Sep 17 00:00:00 2001
From: noelorin <noelorin@outlook.com>
Date: Sun, 27 Sep 2026 12:03:46 +0800
Subject: [PATCH] docs(settings): guide obtaining DanDanPlay AppId via
 DevCenter

Official docs: AppId/AppSecret come from developer application review, not user login. Add in-app guidance.
---
 .../src/components/pages/SettingsAdminBody.tsx    | 15 +++++++++++++++
 packages/i18n/src/messages/en.ts                  |  4 ++++
 packages/i18n/src/messages/zh-CN.ts               |  4 ++++
 3 files changed, 23 insertions(+)

diff --git a/app/web/src/components/pages/SettingsAdminBody.tsx b/app/web/src/components/pages/SettingsAdminBody.tsx
index 71de85a..d071576 100644
--- a/app/web/src/components/pages/SettingsAdminBody.tsx
+++ b/app/web/src/components/pages/SettingsAdminBody.tsx
@@ -42,6 +42,21 @@ function Inner(props: { locale: Locale }) {
             </div>
             <p className="text-sm text-muted-foreground">{label("settings.openNetworkHint")}</p>
 
+            <div className="space-y-2 rounded-md border border-border p-3">
+                <p className="text-sm font-medium">{label("settings.obtainCreds")}</p>
+                <p className="text-xs text-muted-foreground">{label("settings.obtainCredsHint")}</p>
+                <p className="text-xs text-muted-foreground">{label("settings.obtainSteps")}</p>
+                <Button
+                    size="sm"
+                    variant="outline"
+                    onClick={() => {
+                        window.open("https://dev.dandanplay.com", "_blank", "noopener,noreferrer");
+                    }}
+                >
+                    {label("settings.openDevCenter")}
+                </Button>
+            </div>
+
             <div className="space-y-2">
                 <p className="text-sm text-muted-foreground">{label("settings.openAppId")}</p>
                 <Input
diff --git a/packages/i18n/src/messages/en.ts b/packages/i18n/src/messages/en.ts
index 0fe52c1..1d0d0a6 100644
--- a/packages/i18n/src/messages/en.ts
+++ b/packages/i18n/src/messages/en.ts
@@ -331,4 +331,8 @@ export const en: Record<MessageKey, string> = {
     "settings.openSaved": "Saved and applied",
     "settings.openSaveFailed": "Save failed",
     "settings.save": "Save",
+    "settings.obtainCreds": "Get credentials",
+    "settings.obtainCredsHint": "AppId/AppSecret are issued by the DanDanPlay DevCenter (create an app and pass review). They cannot be obtained by signing in with a normal account.",
+    "settings.openDevCenter": "Open DevCenter",
+    "settings.obtainSteps": "Steps: sign in / register at DevCenter → create an app → wait for review → copy AppId and AppSecret from the app detail",
 };
diff --git a/packages/i18n/src/messages/zh-CN.ts b/packages/i18n/src/messages/zh-CN.ts
index 7e0340e..eb18a2a 100644
--- a/packages/i18n/src/messages/zh-CN.ts
+++ b/packages/i18n/src/messages/zh-CN.ts
@@ -321,6 +321,10 @@ export const zhCN = {
     "settings.openSaved": "已保存并生效",
     "settings.openSaveFailed": "保存失败",
     "settings.save": "保存",
+    "settings.obtainCreds": "获取凭证",
+    "settings.obtainCredsHint": "AppId/AppSecret 由弹弹play 开发者中心发放（创建应用并通过审核），无法用普通账号登录自动获取。",
+    "settings.openDevCenter": "打开开发者中心",
+    "settings.obtainSteps": "步骤：登录/注册开发者中心 → 创建应用 → 等待审核 → 在应用详情复制 AppId 与 AppSecret",
 } as const;
 
 export type MessageKey = keyof typeof zhCN;