admin后台第一阶段目录优化

2026-05-15 14:12:38 +08:00
parent 34b71decf1
commit 11678a7f83
35 changed files with 41 additions and 46 deletions
@@ -170,7 +170,7 @@ onMounted(loadAuditLogs)
 </template>

 <style scoped>
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .total-label {
  color: var(--text-secondary);
@@ -1,4 +1,4 @@
-@import '../../styles/admin-config-pages.css';
+@import '../../../styles/admin-config-pages.css';

 /* ============================================================
   AdminFulfillmentBindings — 绿色主题覆盖 & 页面特有样式
@@ -2,8 +2,8 @@
 import { computed } from 'vue'
 import { useRoute, useRouter } from 'vue-router'

-import AdminFulfillmentBindingsView from '@/views/admin/AdminFulfillmentBindingsView.vue'
-import AdminKuaishouCloudFulfillmentView from '@/views/admin/AdminKuaishouCloudFulfillmentView.vue'
+import AdminFulfillmentBindingsView from './AdminFulfillmentBindingsView.vue'
+import AdminKuaishouCloudFulfillmentView from './AdminKuaishouCloudFulfillmentView.vue'

 type FulfillmentTabKey = 'legacy' | 'kuaishou-cloud'

@@ -1,4 +1,4 @@
-@import '../../styles/admin-config-pages.css';
+@import '../../../styles/admin-config-pages.css';

 .admin-panel {
  --panel-ink: var(--text-primary);
@@ -1,4 +1,4 @@
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .form-grid {
  display: grid;
@@ -195,7 +195,7 @@ onMounted(loadMessageDeliveries)
 </template>

 <style scoped>
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .filter-grid {
  grid-template-columns: repeat(4, minmax(0, 1fr));
@@ -244,7 +244,7 @@ onMounted(loadOrders)
 </template>

 <style scoped>
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .filter-grid {
  grid-template-columns: minmax(200px, 1fr) minmax(130px, 0.6fr) minmax(180px, 0.9fr) minmax(320px, 1.4fr) minmax(150px, 0.55fr);
@@ -3,17 +3,6 @@ import { onMounted, ref } from 'vue'
 import { RefreshRight } from '@element-plus/icons-vue'

 import AdminPageHeader from '@/components/admin/AdminPageHeader.vue'
-import AdminPlatformAgisoSection from '@/components/admin/AdminPlatformAgisoSection.vue'
-import AdminPlatformCloudtentaclesSection from '@/components/admin/AdminPlatformCloudtentaclesSection.vue'
-import AdminPlatformNinetyoneSection from '@/components/admin/AdminPlatformNinetyoneSection.vue'
-import AdminPlatformNotificationSection from '@/components/admin/AdminPlatformNotificationSection.vue'
-import AdminPlatformKuaishouEticketSection from '@/components/admin/AdminPlatformKuaishouEticketSection.vue'
-import { useAdminAgisoPlatform } from '@/composables/admin/platform-shops/useAdminAgisoPlatform'
-import { useAdminCloudtentaclesPlatform } from '@/composables/admin/platform-shops/useAdminCloudtentaclesPlatform'
-import { useAdminNinetyonePlatform } from '@/composables/admin/platform-shops/useAdminNinetyonePlatform'
-import { useAdminNotificationPlatform } from '@/composables/admin/platform-shops/useAdminNotificationPlatform'
-import { useAdminKuaishouEticketPlatform } from '@/composables/admin/platform-shops/useAdminKuaishouEticketPlatform'
-import type { PlatformTab } from '@/composables/admin/platform-shops/types'
 import {
  fetchAdminAgisoShopConfigs,
  fetchAdminCloudtentaclesSourceConfig,
@@ -22,6 +11,17 @@ import {
  fetchAdminScheduledJobsConfig,
 } from '@/services/admin'
 import { hasAdminRole } from '@/utils/admin-auth'
+import AdminPlatformAgisoSection from './components/AdminPlatformAgisoSection.vue'
+import AdminPlatformCloudtentaclesSection from './components/AdminPlatformCloudtentaclesSection.vue'
+import AdminPlatformNinetyoneSection from './components/AdminPlatformNinetyoneSection.vue'
+import AdminPlatformNotificationSection from './components/AdminPlatformNotificationSection.vue'
+import AdminPlatformKuaishouEticketSection from './components/AdminPlatformKuaishouEticketSection.vue'
+import { useAdminAgisoPlatform } from './composables/useAdminAgisoPlatform'
+import { useAdminCloudtentaclesPlatform } from './composables/useAdminCloudtentaclesPlatform'
+import { useAdminNinetyonePlatform } from './composables/useAdminNinetyonePlatform'
+import { useAdminNotificationPlatform } from './composables/useAdminNotificationPlatform'
+import { useAdminKuaishouEticketPlatform } from './composables/useAdminKuaishouEticketPlatform'
+import type { PlatformTab } from './composables/types'

 const loading = ref(true)
 const isDevMode = import.meta.env.DEV
@@ -0,0 +1,275 @@
+<script setup lang="ts">
+import type { AdminAgisoObservedShopItem } from '@/types/admin'
+import { formatAdminDateTime } from '@/utils/admin-time'
+
+import type { EditableDefaults, EditableShop } from '../composables/types'
+
+type Props = {
+  agisoFilePath: string
+  defaults: EditableDefaults
+  shops: EditableShop[]
+  observedShops: AdminAgisoObservedShopItem[]
+  saving: boolean
+  isShopExpanded: (id: string) => boolean
+  toggleShop: (id: string) => void
+  expandAllShops: () => void
+  collapseAllShops: () => void
+  describeShop: (shop: EditableShop) => string
+  removeShop: (id: string) => void
+  importObservedShop: (item: AdminAgisoObservedShopItem) => void
+  saveAgisoConfigs: () => void | Promise<void>
+}
+
+defineProps<Props>()
+</script>
+
+<template>
+  <div class="platform-section">
+    <!-- 配置信息 -->
+    <el-card class="section-card">
+      <template #header>
+        <span class="card-title">配置信息</span>
+      </template>
+      <el-descriptions :column="1" border size="small">
+        <el-descriptions-item label="配置文件">
+          <code>{{ agisoFilePath || '-' }}</code>
+        </el-descriptions-item>
+        <el-descriptions-item label="职责">
+          管理 Agiso 默认消息模板、店铺 AccessToken 以及店铺级模板覆盖。
+        </el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <!-- 默认消息模板 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">默认消息模板</span>
+            <p class="card-desc">Agiso 店铺未单独配置时，统一使用这里的领取消息与自动发货消息模板。</p>
+          </div>
+        </div>
+      </template>
+      <el-form label-width="auto" label-position="top">
+        <el-form-item label="默认领取链接消息模板">
+          <el-input
+            v-model="defaults.messageTemplate"
+            type="textarea"
+            :rows="3"
+            placeholder="例如：您的订单 {platformOrderId} 已创建领取链接，请尽快打开并完成领取：{claimUrl}"
+          />
+        </el-form-item>
+        <el-form-item label="默认自动发货消息模板">
+          <el-input
+            v-model="defaults.autoDeliveryMessageTemplate"
+            type="textarea"
+            :rows="3"
+            placeholder="例如：您的订单 {platformOrderId} 已完成自动发货，请注意查收。"
+          />
+        </el-form-item>
+      </el-form>
+    </el-card>
+
+    <!-- 店铺列表 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">Agiso 店铺列表</span>
+            <p class="card-desc">每家店铺可单独配置 AccessToken 和模板覆盖。建议先用"近期识别到的店铺"导入，再补 AccessToken。</p>
+          </div>
+          <div class="card-actions">
+            <el-button :disabled="shops.length === 0" @click="expandAllShops">全部展开</el-button>
+            <el-button :disabled="shops.length === 0" @click="collapseAllShops">全部折叠</el-button>
+            <el-button :loading="saving" type="primary" @click="saveAgisoConfigs">保存 Agiso 配置</el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-empty v-if="shops.length === 0" description="当前还没有 Agiso 店铺配置，先新增一条。" />
+
+      <el-collapse
+        v-else
+        :model-value="shops.filter(s => isShopExpanded(s.id)).map(s => s.id)"
+      >
+        <el-collapse-item
+          v-for="shop in shops"
+          :key="shop.id"
+          :name="shop.id"
+        >
+          <template #title>
+            <div class="shop-title">
+              <strong>{{ shop.shopName || shop.shopId || '未命名店铺' }}</strong>
+              <span class="shop-subtitle">ID: {{ shop.shopId || '未填写' }}</span>
+              <el-tag
+                :type="shop.enabled ? 'success' : 'info'"
+                size="small"
+                style="margin-left: auto; margin-right: 12px"
+              >
+                {{ shop.enabled ? '已启用' : '已停用' }}
+              </el-tag>
+              <span class="shop-brief">{{ describeShop(shop) }}</span>
+            </div>
+          </template>
+
+          <el-form label-width="auto" label-position="top">
+            <el-row :gutter="16">
+              <el-col :span="12">
+                <el-form-item label="店铺 ID">
+                  <el-input v-model="shop.shopId" placeholder="例如 693760716" />
+                </el-form-item>
+              </el-col>
+              <el-col :span="12">
+                <el-form-item label="店铺名称">
+                  <el-input v-model="shop.shopName" placeholder="例如 大锤商行" />
+                </el-form-item>
+              </el-col>
+            </el-row>
+            <el-form-item label="AccessToken">
+              <el-input v-model="shop.accessToken" placeholder="AldsIdle..." />
+            </el-form-item>
+            <el-form-item label="领取链接消息模板">
+              <el-input
+                v-model="shop.messageTemplate"
+                type="textarea"
+                :rows="2"
+                placeholder="留空则沿用默认领取链接模板"
+              />
+            </el-form-item>
+            <el-form-item label="自动发货消息模板">
+              <el-input
+                v-model="shop.autoDeliveryMessageTemplate"
+                type="textarea"
+                :rows="2"
+                placeholder="留空则沿用默认自动发货模板"
+              />
+            </el-form-item>
+          </el-form>
+
+          <div class="shop-footer">
+            <el-switch v-model="shop.enabled" active-text="启用店铺级覆盖" />
+            <el-button type="danger" size="small" @click="removeShop(shop.id)">删除</el-button>
+          </div>
+        </el-collapse-item>
+      </el-collapse>
+    </el-card>
+
+    <!-- 近期识别到的店铺 -->
+    <el-card class="section-card">
+      <template #header>
+        <div>
+          <span class="card-title">近期识别到的 Agiso 店铺</span>
+          <p class="card-desc">从 webhook 自动识别出的店铺，可一键导入到上方店铺列表。</p>
+        </div>
+      </template>
+
+      <el-table :data="observedShops" stripe size="small">
+        <el-table-column label="店铺" min-width="180">
+          <template #default="{ row }">
+            <div>
+              <div>{{ row.displayShopName || row.shopId }}</div>
+              <div style="font-size: var(--text-xs); color: var(--text-muted)">ID: {{ row.shopId }}</div>
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column prop="webhookEventCount" label="Webhook 次数" width="120" align="center" />
+        <el-table-column label="最近出现时间" width="180">
+          <template #default="{ row }">{{ formatAdminDateTime(row.latestSeenAt) }}</template>
+        </el-table-column>
+        <el-table-column label="状态" width="100" align="center">
+          <template #default="{ row }">
+            <el-tag :type="row.configured ? 'success' : 'warning'" size="small">
+              {{ row.configured ? '已配置' : '未配置' }}
+            </el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" width="140" align="center">
+          <template #default="{ row }">
+            <el-button v-if="!row.configured" size="small" type="primary" @click="importObservedShop(row)">
+              导入到店铺
+            </el-button>
+            <span v-else class="text-muted">已存在</span>
+          </template>
+        </el-table-column>
+        <template #empty>
+          <el-empty description="最近还没有识别到可用店铺。" :image-size="60" />
+        </template>
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<style scoped>
+.platform-section {
+  display: grid;
+  gap: var(--space-4);
+}
+
+.section-card {
+  border-radius: var(--radius-lg);
+}
+
+.card-title {
+  font-size: var(--text-lg);
+  font-weight: 600;
+  color: var(--text-primary);
+}
+
+.card-desc {
+  margin: var(--space-1) 0 0;
+  font-size: var(--text-sm);
+  color: var(--text-secondary);
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+  gap: var(--space-3);
+}
+
+.card-actions {
+  display: flex;
+  gap: var(--space-2);
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+
+.shop-title {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  flex: 1;
+  min-width: 0;
+  padding-right: var(--space-4);
+}
+
+.shop-title strong {
+  white-space: nowrap;
+}
+
+.shop-subtitle {
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+}
+
+.shop-brief {
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+  margin-left: auto;
+}
+
+.shop-footer {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-top: var(--space-3);
+  padding-top: var(--space-3);
+  border-top: 1px solid var(--border-default);
+}
+
+.text-muted {
+  color: var(--text-muted);
+}
+</style>
@@ -0,0 +1,333 @@
+<script setup lang="ts">
+import AdminResultCard from '@/components/admin/AdminResultCard.vue'
+import type {
+  AdminCloudtentaclesLoginTestResult,
+  AdminCloudtentaclesPersistedSession,
+  AdminCloudtentaclesSendSmsResult,
+  AdminCloudtentaclesValidateSessionResult,
+} from '@/types/admin'
+import { formatAdminDateTime } from '@/utils/admin-time'
+
+type CloudtentaclesForm = {
+  baseUrl: string
+  username: string
+  password: string
+  phone: string
+  code: string
+  token: string
+  vnKey: string
+  vnId: number
+  skuId: number
+  skuCount: number
+  deviceId: string
+  deviceType: number
+}
+
+type CloudtentaclesStats = {
+  hasCredential: boolean
+  smsSent: boolean
+  validated: boolean
+}
+
+type Props = {
+  cloudtentaclesFilePath: string
+  cloudtentaclesSessionFilePath: string
+  cloudtentaclesForm: CloudtentaclesForm
+  cloudtentaclesSaving: boolean
+  cloudtentaclesSendingSms: boolean
+  cloudtentaclesTesting: boolean
+  cloudtentaclesValidating: boolean
+  cloudtentaclesResultError: string
+  cloudtentaclesSmsResult: AdminCloudtentaclesSendSmsResult | null
+  cloudtentaclesLoginResult: AdminCloudtentaclesLoginTestResult | null
+  cloudtentaclesValidateResult: AdminCloudtentaclesValidateSessionResult | null
+  cloudtentaclesDebugLoading: boolean
+  cloudtentaclesDebugResult: string
+  cloudtentaclesPersistedSession: AdminCloudtentaclesPersistedSession | null
+  cloudtentaclesStats: CloudtentaclesStats
+  handleCloudtentaclesSaveSource: () => void | Promise<void>
+  handleCloudtentaclesSendSmsCode: () => void | Promise<void>
+  handleCloudtentaclesTestLogin: () => void | Promise<void>
+  handleCloudtentaclesValidateSession: () => void | Promise<void>
+  handleCloudtentaclesFetchAsset: () => void | Promise<void>
+  handleCloudtentaclesFetchCategories: () => void | Promise<void>
+  handleCloudtentaclesFetchSkuList: () => void | Promise<void>
+  handleCloudtentaclesBuySku: () => void | Promise<void>
+  handleCloudtentaclesUseSku: () => void | Promise<void>
+  handleCloudtentaclesFetchKnapsack: () => void | Promise<void>
+  handleCloudtentaclesFetchVnList: () => void | Promise<void>
+  handleCloudtentaclesAppointVn: () => void | Promise<void>
+  handleCloudtentaclesGenerateVnLoginCode: () => void | Promise<void>
+  handleCloudtentaclesFetchVnCode: () => void | Promise<void>
+  handleCloudtentaclesVerifyVnCode: () => void | Promise<void>
+  handleCloudtentaclesFetchBindUrl: () => void | Promise<void>
+  handleCloudtentaclesBackVn: () => void | Promise<void>
+  handleCloudtentaclesRunFullFlow: () => void | Promise<void>
+}
+
+defineProps<Props>()
+</script>
+
+<template>
+  <div class="platform-section">
+    <!-- 配置信息 -->
+    <el-card class="section-card">
+      <template #header>
+        <span class="card-title">配置信息</span>
+      </template>
+      <el-descriptions :column="1" border size="small">
+        <el-descriptions-item label="配置文件">
+          <code>{{ cloudtentaclesFilePath || '-' }}</code>
+        </el-descriptions-item>
+        <el-descriptions-item label="会话文件">
+          <code>{{ cloudtentaclesSessionFilePath || '-' }}</code>
+        </el-descriptions-item>
+        <el-descriptions-item label="职责">
+          管理 cloudtentacles 外部履约平台的账号、短信验证码登录与 token 探活。该区域不处理订单来源同步。
+        </el-descriptions-item>
+        <el-descriptions-item label="已保存 token">
+          {{ cloudtentaclesPersistedSession?.hasToken ? `${cloudtentaclesPersistedSession.tokenMasked} / ${formatAdminDateTime(cloudtentaclesPersistedSession.loggedInAt)}` : '未保存' }}
+        </el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <!-- 履约平台配置 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">cloudtentacles 履约平台配置</span>
+            <p class="card-desc">先保存账号、密码、手机号和设备头，再发送短信验证码，最后执行登录测试或手动校验 token。</p>
+          </div>
+          <div class="card-actions">
+            <el-button :loading="cloudtentaclesSaving" @click="handleCloudtentaclesSaveSource">保存履约配置</el-button>
+            <el-button :loading="cloudtentaclesSendingSms" @click="handleCloudtentaclesSendSmsCode">发送短信验证码</el-button>
+            <el-button :loading="cloudtentaclesTesting" type="primary" @click="handleCloudtentaclesTestLogin">测试登录</el-button>
+            <el-button :loading="cloudtentaclesValidating" @click="handleCloudtentaclesValidateSession">校验 token</el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-form label-width="auto" label-position="top">
+        <el-form-item label="Base URL">
+          <el-input v-model="cloudtentaclesForm.baseUrl" placeholder="https://123.207.217.176" />
+        </el-form-item>
+        <el-row :gutter="16">
+          <el-col :span="8">
+            <el-form-item label="账号">
+              <el-input v-model="cloudtentaclesForm.username" placeholder="cloudtentacles 登录账号" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="密码">
+              <el-input v-model="cloudtentaclesForm.password" type="password" show-password placeholder="cloudtentacles 登录密码" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="手机号">
+              <el-input v-model="cloudtentaclesForm.phone" placeholder="接收短信验证码的手机号" />
+            </el-form-item>
+          </el-col>
+        </el-row>
+        <el-row :gutter="16">
+          <el-col :span="8">
+            <el-form-item label="短信验证码">
+              <el-input v-model="cloudtentaclesForm.code" placeholder="收到验证码后填写" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="VN Key">
+              <el-input v-model="cloudtentaclesForm.vnKey" placeholder="例如 1" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="VN ID">
+              <el-input-number v-model="cloudtentaclesForm.vnId" :min="0" controls-position="right" style="width: 100%" />
+            </el-form-item>
+          </el-col>
+        </el-row>
+        <el-row :gutter="16">
+          <el-col :span="8">
+            <el-form-item label="SKU ID">
+              <el-input-number v-model="cloudtentaclesForm.skuId" :min="0" controls-position="right" style="width: 100%" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="购买数量">
+              <el-input-number v-model="cloudtentaclesForm.skuCount" :min="1" controls-position="right" style="width: 100%" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="deviceId">
+              <el-input v-model="cloudtentaclesForm.deviceId" placeholder="-" />
+            </el-form-item>
+          </el-col>
+        </el-row>
+        <el-row :gutter="16">
+          <el-col :span="12">
+            <el-form-item label="deviceType">
+              <el-input-number v-model="cloudtentaclesForm.deviceType" :min="0" controls-position="right" style="width: 100%" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="token（可手动粘贴）">
+              <el-input v-model="cloudtentaclesForm.token" placeholder="登录成功后可自动回填，也可手动粘贴" />
+            </el-form-item>
+          </el-col>
+        </el-row>
+      </el-form>
+
+      <el-alert
+        v-if="cloudtentaclesResultError"
+        :title="cloudtentaclesResultError"
+        type="error"
+        show-icon
+        :closable="false"
+        style="margin-top: 16px"
+      />
+
+      <div class="result-grid" style="margin-top: 16px">
+        <AdminResultCard label="短信发送" :value="cloudtentaclesSmsResult ? '成功' : '未执行'">
+          <p v-if="cloudtentaclesSmsResult">
+            {{ cloudtentaclesSmsResult.phoneMasked }}，{{ formatAdminDateTime(cloudtentaclesSmsResult.sentAt) }}
+          </p>
+          <p v-else>先发送短信验证码，确认手机号可用。</p>
+        </AdminResultCard>
+        <AdminResultCard label="登录结果" :value="cloudtentaclesLoginResult ? '成功' : '未执行'">
+          <p v-if="cloudtentaclesLoginResult">
+            {{ cloudtentaclesLoginResult.phoneMasked }}，{{ formatAdminDateTime(cloudtentaclesLoginResult.loggedInAt) }}
+          </p>
+          <p v-else>填写短信验证码后可执行测试登录。</p>
+        </AdminResultCard>
+        <AdminResultCard label="会话校验" :value="cloudtentaclesValidateResult ? '成功' : '未执行'">
+          <p v-if="cloudtentaclesValidateResult">
+            权限 {{ cloudtentaclesValidateResult.session.permissionCount }} 项，余额 {{ cloudtentaclesValidateResult.asset }}
+          </p>
+          <p v-else>登录成功后可继续校验 token 会话。</p>
+        </AdminResultCard>
+      </div>
+    </el-card>
+
+    <!-- 开发调试工具 -->
+    <el-card class="section-card">
+      <template #header>
+        <div>
+          <span class="card-title">cloudtentacles 开发调试工具</span>
+          <p class="card-desc">仅开发模式展示。用于调试分类、SKU、购买、发货、虚拟号、兑换链接和结束退还链路。</p>
+        </div>
+      </template>
+
+      <div class="debug-buttons">
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchAsset">余额</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchCategories">分类</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchSkuList">SKU</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesBuySku">购买</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" type="primary" @click="handleCloudtentaclesUseSku">发货</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchKnapsack">背包</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchVnList">虚拟号列表</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesAppointVn">申请虚拟号</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesGenerateVnLoginCode">生成登录码</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchVnCode">获取验证码</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesVerifyVnCode">校验验证码</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" @click="handleCloudtentaclesFetchBindUrl">兑换链接</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" type="warning" @click="handleCloudtentaclesBackVn">退还号码</el-button>
+        <el-button :loading="cloudtentaclesDebugLoading" type="success" @click="handleCloudtentaclesRunFullFlow">完整流程</el-button>
+      </div>
+
+      <pre v-if="cloudtentaclesDebugResult" class="debug-pre" style="margin-top: 16px">{{ cloudtentaclesDebugResult }}</pre>
+      <el-empty v-else description="执行一次调试动作后，这里会显示原始返回数据。" :image-size="60" />
+    </el-card>
+
+    <!-- 调试结果 -->
+    <el-card v-if="cloudtentaclesLoginResult || cloudtentaclesValidateResult" class="section-card">
+      <template #header>
+        <div>
+          <span class="card-title">cloudtentacles 调试结果</span>
+          <p class="card-desc">用于确认当前账号会话、权限和用户信息，后续发货执行器会复用这里的登录能力。</p>
+        </div>
+      </template>
+
+      <div class="result-grid">
+        <AdminResultCard
+          label="当前 token"
+          :value="cloudtentaclesValidateResult?.session.tokenMasked || cloudtentaclesLoginResult?.session.tokenMasked || '-'"
+        >
+          <p>原始 token 已写入上方输入框，可继续用于校验或后续调试。</p>
+        </AdminResultCard>
+        <AdminResultCard
+          label="权限"
+          :value="`${cloudtentaclesValidateResult?.session.permissionCount || cloudtentaclesLoginResult?.session.permissionCount || 0} 项`"
+        >
+          <p>{{ (cloudtentaclesValidateResult?.session.permissions || cloudtentaclesLoginResult?.session.permissions || []).join('、') || '暂无' }}</p>
+        </AdminResultCard>
+        <AdminResultCard label="余额" :value="cloudtentaclesValidateResult?.asset || cloudtentaclesLoginResult?.asset || 0">
+          <p>可用于确认当前履约账号状态。</p>
+        </AdminResultCard>
+      </div>
+    </el-card>
+  </div>
+</template>
+
+<style scoped>
+.platform-section {
+  display: grid;
+  gap: var(--space-4);
+}
+
+.section-card {
+  border-radius: var(--radius-lg);
+}
+
+.card-title {
+  font-size: var(--text-lg);
+  font-weight: 600;
+  color: var(--text-primary);
+}
+
+.card-desc {
+  margin: var(--space-1) 0 0;
+  font-size: var(--text-sm);
+  color: var(--text-secondary);
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+  gap: var(--space-3);
+}
+
+.card-actions {
+  display: flex;
+  gap: var(--space-2);
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+
+.debug-buttons {
+  display: flex;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+}
+
+.result-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: var(--space-3);
+}
+
+.debug-pre {
+  margin: 0;
+  padding: var(--space-4);
+  border-radius: var(--radius-lg);
+  background: #0f172a;
+  color: #e2e8f0;
+  overflow-y: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-size: var(--text-xs);
+  line-height: 1.6;
+  font-family: var(--font-mono);
+}
+</style>
@@ -0,0 +1,515 @@
+<script setup lang="ts">
+import type { EditableKuaishouEticketShop } from '../composables/types'
+import type {
+  AdminKuaishouEticketConsumeResult,
+  AdminKuaishouEticketDetailResult,
+  AdminKuaishouEticketShopInfoResult,
+} from '@/types/admin'
+import AdminResultCard from '@/components/admin/AdminResultCard.vue'
+
+type KuaishouEticketForm = {
+  baseUrl: string
+  selectedShopId: string
+  queryTicketCode: string
+  eTicketId: string
+  oid: string
+  formToken: string
+  num: number
+  storeId: string
+}
+
+type KuaishouEticketStats = {
+  configuredShopCount: number
+  cookieReadyCount: number
+  selectedShopReady: boolean
+  detailReady: boolean
+  consumed: boolean
+}
+
+type Props = {
+  kuaishouEticketFilePath: string
+  kuaishouEticketShops: EditableKuaishouEticketShop[]
+  kuaishouEticketForm: KuaishouEticketForm
+  kuaishouEticketSaving: boolean
+  kuaishouEticketResolvingShopId: string
+  kuaishouEticketDetailing: boolean
+  kuaishouEticketConsuming: boolean
+  kuaishouEticketResultError: string
+  kuaishouEticketShopInfoResult: AdminKuaishouEticketShopInfoResult | null
+  kuaishouEticketDetailResult: AdminKuaishouEticketDetailResult | null
+  kuaishouEticketConsumeResult: AdminKuaishouEticketConsumeResult | null
+  activeKuaishouEticketShop: EditableKuaishouEticketShop | null
+  kuaishouEticketStats: KuaishouEticketStats
+  addKuaishouEticketShop: () => void
+  removeKuaishouEticketShop: (id: string) => void
+  isKuaishouEticketShopExpanded: (id: string) => boolean
+  toggleKuaishouEticketShop: (id: string) => void
+  expandAllKuaishouEticketShops: () => void
+  collapseAllKuaishouEticketShops: () => void
+  setKuaishouEticketDebugShop: (id: string) => void
+  describeKuaishouEticketShop: (shop: EditableKuaishouEticketShop) => string
+  getKuaishouEticketShopInitial: (shop: EditableKuaishouEticketShop) => string
+  handleKuaishouEticketResolveShopInfo: (shop: EditableKuaishouEticketShop) => void | Promise<void>
+  handleKuaishouEticketSaveSource: () => void | Promise<void>
+  handleKuaishouEticketQueryDetail: () => void | Promise<void>
+  handleKuaishouEticketConsume: () => void | Promise<void>
+}
+
+defineProps<Props>()
+</script>
+
+<template>
+  <div class="platform-section">
+    <!-- 说明信息 -->
+    <el-card class="section-card">
+      <template #header>
+        <span class="card-title">说明信息</span>
+      </template>
+      <el-descriptions :column="1" border size="small">
+        <el-descriptions-item label="配置文件">{{ kuaishouEticketFilePath || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="职责">
+          这是独立的新流程，只负责快手小店券核销调试与配置，不接入当前已完成的订单来源和履约主链路。
+        </el-descriptions-item>
+        <el-descriptions-item label="建议流程">
+          先为每个店铺录入 kshopName + Cookie，可用 info 接口自动识别店铺名与店铺 ID；保存后选择目标店铺，再查询券码并执行核销。
+        </el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <!-- 店铺配置 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">快手小店店铺配置</span>
+            <p class="card-desc">支持多店铺配置，建议先粘贴 Cookie，再用 info 接口自动识别 kshopName / shopId，最后统一保存到文件。</p>
+          </div>
+          <div class="card-actions">
+            <el-button :disabled="kuaishouEticketShops.length === 0" @click="expandAllKuaishouEticketShops">全部展开</el-button>
+            <el-button :disabled="kuaishouEticketShops.length === 0" @click="collapseAllKuaishouEticketShops">全部折叠</el-button>
+            <el-button @click="addKuaishouEticketShop">新增店铺</el-button>
+            <el-button :loading="kuaishouEticketSaving" type="primary" @click="handleKuaishouEticketSaveSource">保存配置</el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-form label-width="auto" label-position="top">
+        <el-form-item label="Base URL">
+          <el-input v-model="kuaishouEticketForm.baseUrl" placeholder="https://s.kwaixiaodian.com" />
+        </el-form-item>
+      </el-form>
+
+      <el-empty v-if="kuaishouEticketShops.length === 0" description="当前还没有快手小店店铺配置，先新增一条。" />
+
+      <div v-else class="shop-panels">
+        <div class="shop-list">
+          <el-collapse
+            :model-value="kuaishouEticketShops.filter(s => isKuaishouEticketShopExpanded(s.id)).map(s => s.id)"
+          >
+            <el-collapse-item
+              v-for="shop in kuaishouEticketShops"
+              :key="shop.id"
+              :name="shop.id"
+              :class="['shop-panel', {
+                'is-debug': kuaishouEticketForm.selectedShopId === shop.id,
+              }]"
+            >
+              <template #title>
+                <div class="shop-title-bar">
+                  <div class="shop-avatar">
+                    <img v-if="shop.userAvatar" :src="shop.userAvatar" :alt="shop.kshopName || shop.shopId || '店铺头像'" />
+                    <span v-else>{{ getKuaishouEticketShopInitial(shop) }}</span>
+                  </div>
+                  <div class="shop-info">
+                    <div class="shop-name-row">
+                      <strong>{{ shop.kshopName || shop.shopId || '未命名店铺' }}</strong>
+                      <el-tag :type="shop.enabled ? 'success' : 'info'" size="small">{{ shop.enabled ? '已启用' : '已停用' }}</el-tag>
+                      <el-tag v-if="kuaishouEticketForm.selectedShopId === shop.id" type="primary" size="small">当前调试</el-tag>
+                    </div>
+                    <div class="shop-meta">
+                      <span>店铺 ID：{{ shop.shopId || '等待 info 自动识别' }}</span>
+                      <el-tag :type="Boolean(shop.cookie.trim()) ? 'success' : 'warning'" size="small">
+                        {{ shop.cookie.trim() ? 'Cookie 已粘贴' : '待补 Cookie' }}
+                      </el-tag>
+                      <el-tag :type="Boolean(shop.userAvatar || shop.shopId.trim()) ? 'success' : 'info'" size="small">
+                        {{ shop.userAvatar || shop.shopId.trim() ? '信息已识别' : '未读取信息' }}
+                      </el-tag>
+                    </div>
+                  </div>
+                </div>
+              </template>
+
+              <el-form label-width="auto" label-position="top">
+                <el-row :gutter="16">
+                  <el-col :span="12">
+                    <el-form-item label="kshopName">
+                      <el-input v-model="shop.kshopName" placeholder="例如 稚嫩游戏交易店" />
+                    </el-form-item>
+                  </el-col>
+                  <el-col :span="12">
+                    <el-form-item label="店铺 ID">
+                      <el-input v-model="shop.shopId" readonly placeholder="通过 info 接口自动识别" />
+                    </el-form-item>
+                  </el-col>
+                </el-row>
+                <el-form-item label="Cookie">
+                  <el-input
+                    v-model="shop.cookie"
+                    type="textarea"
+                    :rows="4"
+                    placeholder="直接粘贴该店铺请求头中的完整 Cookie"
+                  />
+                </el-form-item>
+              </el-form>
+
+              <div class="shop-footer">
+                <div class="footer-left">
+                  <el-switch v-model="shop.enabled" active-text="启用该店铺" />
+                  <span v-if="shop.userAvatar" class="text-muted">已识别头像，可直接作为调试店铺</span>
+                  <span v-else class="text-muted">建议先读取店铺信息确认 Cookie 归属</span>
+                </div>
+                <div class="footer-actions">
+                  <el-button
+                    :loading="kuaishouEticketResolvingShopId === shop.id"
+                    size="small"
+                    @click="handleKuaishouEticketResolveShopInfo(shop)"
+                  >
+                    读取店铺信息
+                  </el-button>
+                  <el-button
+                    size="small"
+                    :type="kuaishouEticketForm.selectedShopId === shop.id ? 'success' : 'primary'"
+                    @click="setKuaishouEticketDebugShop(shop.id)"
+                  >
+                    {{ kuaishouEticketForm.selectedShopId === shop.id ? '当前调试店铺' : '设为调试店铺' }}
+                  </el-button>
+                  <el-button size="small" type="danger" @click="removeKuaishouEticketShop(shop.id)">删除</el-button>
+                </div>
+              </div>
+            </el-collapse-item>
+          </el-collapse>
+        </div>
+
+        <div class="side-panel">
+          <AdminResultCard label="店铺总数" :value="kuaishouEticketStats.configuredShopCount">
+            <p>其中 Cookie 就绪 {{ kuaishouEticketStats.cookieReadyCount }} 家。</p>
+          </AdminResultCard>
+          <AdminResultCard
+            label="当前调试店铺"
+            :value="activeKuaishouEticketShop?.kshopName || activeKuaishouEticketShop?.shopId || '未选择'"
+          >
+            <p>{{ kuaishouEticketStats.selectedShopReady ? '已具备调试条件，可直接查询核销信息。' : '请选择店铺并补全 Cookie。' }}</p>
+          </AdminResultCard>
+          <AdminResultCard
+            label="最近识别结果"
+            :value="kuaishouEticketShopInfoResult?.shop.kshopName || kuaishouEticketShopInfoResult?.shop.shopId || '未执行'"
+          >
+            <p v-if="kuaishouEticketShopInfoResult">结算状态 {{ kuaishouEticketShopInfoResult.shop.settleStatus }}</p>
+            <p v-else>可用"读取店铺信息"校验 Cookie 是否属于预期店铺。</p>
+          </AdminResultCard>
+          <AdminResultCard label="建议顺序" value="先配置，再调试">
+            <p>1. 新增店铺并粘贴 Cookie</p>
+            <p>2. 读取店铺信息确认 kshopName / shopId</p>
+            <p>3. 设为调试店铺后查询券码并执行核销</p>
+          </AdminResultCard>
+        </div>
+      </div>
+
+      <el-alert
+        v-if="kuaishouEticketResultError"
+        :title="kuaishouEticketResultError"
+        type="error"
+        show-icon
+        :closable="false"
+        style="margin-top: 16px"
+      />
+    </el-card>
+
+    <!-- 核销调试 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">快手小店核销调试</span>
+            <p class="card-desc">这里使用"当前调试店铺"的 Cookie 执行查询与核销；eTicketId / oid / formToken 都来自查询结果。</p>
+          </div>
+          <div class="card-actions">
+            <el-button :loading="kuaishouEticketDetailing" @click="handleKuaishouEticketQueryDetail">查询核销信息</el-button>
+            <el-button :loading="kuaishouEticketConsuming" type="primary" @click="handleKuaishouEticketConsume">执行核销</el-button>
+          </div>
+        </div>
+      </template>
+
+      <div class="debug-layout">
+        <div class="debug-main">
+          <el-form label-width="auto" label-position="top">
+            <el-form-item label="调试店铺">
+              <el-select v-model="kuaishouEticketForm.selectedShopId" placeholder="请选择店铺" style="width: 100%">
+                <el-option v-for="shop in kuaishouEticketShops" :key="shop.id" :label="shop.kshopName || shop.shopId || '未命名店铺'" :value="shop.id" />
+              </el-select>
+            </el-form-item>
+            <el-row :gutter="16">
+              <el-col :span="8">
+                <el-form-item label="查询券码">
+                  <el-input v-model="kuaishouEticketForm.queryTicketCode" placeholder="用于查询核销信息" />
+                </el-form-item>
+              </el-col>
+              <el-col :span="8">
+                <el-form-item label="核销数量">
+                  <el-input-number v-model="kuaishouEticketForm.num" :min="1" controls-position="right" style="width: 100%" />
+                </el-form-item>
+              </el-col>
+              <el-col :span="8">
+                <el-form-item label="storeId">
+                  <el-input v-model="kuaishouEticketForm.storeId" placeholder="默认 0" />
+                </el-form-item>
+              </el-col>
+            </el-row>
+          </el-form>
+        </div>
+
+        <el-card shadow="never" class="auto-fill-card">
+          <template #header>
+            <div>
+              <span class="card-title">自动回填参数</span>
+              <span class="text-muted" style="margin-left: 8px">查询后生成</span>
+            </div>
+          </template>
+          <el-form label-width="auto" label-position="top">
+            <el-row :gutter="16">
+              <el-col :span="8">
+                <el-form-item label="eTicketId">
+                  <el-input :model-value="kuaishouEticketForm.eTicketId" readonly placeholder="查询后自动回填" />
+                </el-form-item>
+              </el-col>
+              <el-col :span="8">
+                <el-form-item label="oid">
+                  <el-input :model-value="kuaishouEticketForm.oid" readonly placeholder="查询后自动回填" />
+                </el-form-item>
+              </el-col>
+              <el-col :span="8">
+                <el-form-item label="formToken">
+                  <el-input :model-value="kuaishouEticketForm.formToken" readonly placeholder="查询后自动回填" />
+                </el-form-item>
+              </el-col>
+            </el-row>
+          </el-form>
+        </el-card>
+      </div>
+
+      <div class="result-grid" style="margin-top: 16px">
+        <AdminResultCard label="详情查询" :value="kuaishouEticketDetailResult ? (kuaishouEticketDetailResult.ok ? '成功' : '已返回') : '未执行'">
+          <p v-if="kuaishouEticketDetailResult?.detail">
+            {{ kuaishouEticketDetailResult.goods?.itemTitle || kuaishouEticketDetailResult.goods?.skuDesc || '-' }}，
+            剩余 {{ kuaishouEticketDetailResult.detail.leftCount }} / {{ kuaishouEticketDetailResult.detail.totalCount }}
+          </p>
+          <p v-else>先通过查询券码获取核销详情并自动带出核销参数。</p>
+        </AdminResultCard>
+        <AdminResultCard label="核销执行" :value="kuaishouEticketConsumeResult ? (kuaishouEticketConsumeResult.consumed ? '已处理' : '已返回') : '未执行'">
+          <p v-if="kuaishouEticketConsumeResult">
+            {{ kuaishouEticketConsumeResult.errorMessage || (kuaishouEticketConsumeResult.ok ? '核销成功' : '接口已返回结果') }}
+          </p>
+          <p v-else>查询详情后再执行核销会更稳妥。</p>
+        </AdminResultCard>
+      </div>
+    </el-card>
+
+    <!-- 详情结果 -->
+    <el-card v-if="kuaishouEticketDetailResult" class="section-card">
+      <template #header>
+        <div>
+          <span class="card-title">核销详情返回</span>
+          <p class="card-desc">成功查询后会自动回填 eTicketId、oid、formToken 和建议核销数量。</p>
+        </div>
+      </template>
+      <pre class="debug-pre">{{ JSON.stringify(kuaishouEticketDetailResult.raw, null, 2) }}</pre>
+    </el-card>
+
+    <el-card v-if="kuaishouEticketConsumeResult" class="section-card">
+      <template #header>
+        <div>
+          <span class="card-title">核销执行返回</span>
+          <p class="card-desc">这里保留接口原始响应，方便核对 result、error_msg 和 requestId。</p>
+        </div>
+      </template>
+      <pre class="debug-pre">{{ JSON.stringify(kuaishouEticketConsumeResult.raw, null, 2) }}</pre>
+    </el-card>
+  </div>
+</template>
+
+<style scoped>
+.platform-section {
+  display: grid;
+  gap: var(--space-4);
+}
+
+.section-card {
+  border-radius: var(--radius-lg);
+}
+
+.card-title {
+  font-size: var(--text-lg);
+  font-weight: 600;
+  color: var(--text-primary);
+}
+
+.card-desc {
+  margin: var(--space-1) 0 0;
+  font-size: var(--text-sm);
+  color: var(--text-secondary);
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+  gap: var(--space-3);
+}
+
+.card-actions {
+  display: flex;
+  gap: var(--space-2);
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+
+.shop-panels {
+  display: grid;
+  grid-template-columns: minmax(0, 1.7fr) minmax(260px, 0.9fr);
+  gap: var(--space-4);
+  margin-top: var(--space-4);
+}
+
+.shop-list {
+  min-width: 0;
+}
+
+.side-panel {
+  display: grid;
+  gap: var(--space-3);
+  align-content: start;
+}
+
+.shop-panel.is-debug {
+  border: 1px solid var(--border-hover);
+  border-radius: var(--radius-md);
+}
+
+.shop-title-bar {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  flex: 1;
+  min-width: 0;
+  padding-right: var(--space-4);
+}
+
+.shop-avatar {
+  width: 44px;
+  height: 44px;
+  border-radius: var(--radius-md);
+  overflow: hidden;
+  background: linear-gradient(135deg, #dbeafe, #eff6ff);
+  color: var(--color-primary-dark);
+  font-size: 18px;
+  font-weight: 800;
+  display: grid;
+  place-items: center;
+  flex-shrink: 0;
+  border: 1px solid var(--border-hover);
+}
+
+.shop-avatar img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.shop-info {
+  min-width: 0;
+}
+
+.shop-name-row {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+}
+
+.shop-meta {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+  margin-top: 2px;
+}
+
+.shop-footer {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+  gap: var(--space-3);
+  margin-top: var(--space-3);
+  padding-top: var(--space-3);
+  border-top: 1px solid var(--border-default);
+}
+
+.footer-left {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+}
+
+.footer-actions {
+  display: flex;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+}
+
+.debug-layout {
+  display: grid;
+  grid-template-columns: minmax(0, 1.7fr) minmax(260px, 0.9fr);
+  gap: var(--space-4);
+}
+
+.auto-fill-card {
+  background: var(--bg-subtle);
+}
+
+.result-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: var(--space-3);
+}
+
+.debug-pre {
+  margin: 0;
+  padding: var(--space-4);
+  border-radius: var(--radius-lg);
+  background: #0f172a;
+  color: #e2e8f0;
+  overflow-y: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-size: var(--text-xs);
+  line-height: 1.6;
+  font-family: var(--font-mono);
+}
+
+.text-muted {
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+}
+
+@media (max-width: 900px) {
+  .shop-panels,
+  .debug-layout {
+    grid-template-columns: 1fr;
+  }
+}
+</style>
@@ -0,0 +1,179 @@
+<script setup lang="ts">
+import type { AdminNinetyoneOrderItem, AdminNinetyoneOrderListResult } from '@/types/admin'
+import { formatAdminDateTime } from '@/utils/admin-time'
+
+type Props = {
+  ninetyoneLoading: boolean
+  ninetyoneActionLoadingId: number | null
+  ninetyoneResultError: string
+  ninetyoneStatus: 'pending_config' | 'all' | 'manual_failed'
+  ninetyoneOrders: AdminNinetyoneOrderListResult
+  ninetyoneStats: {
+    total: number
+    currentCount: number
+    pendingCount: number
+    failedCount: number
+    taskReadyCount: number
+  }
+  loadNinetyoneOrders: (page?: number) => void | Promise<void>
+  handleNinetyoneStatusChange: (status: 'pending_config' | 'all' | 'manual_failed') => void | Promise<void>
+  handleNinetyoneRetryOrder: (item: AdminNinetyoneOrderItem) => void | Promise<void>
+  handleNinetyoneFailOrder: (item: AdminNinetyoneOrderItem) => void | Promise<void>
+}
+
+defineProps<Props>()
+</script>
+
+<template>
+  <div class="platform-section">
+    <!-- 说明信息 -->
+    <el-card class="section-card">
+      <template #header>
+        <span class="card-title">说明信息</span>
+      </template>
+      <el-descriptions :column="1" border size="small">
+        <el-descriptions-item label="职责">
+          接收 91卡券推送订单，未命中履约配置时先进入待补全队列，补完商品规则后可手动重试生成任务。
+        </el-descriptions-item>
+        <el-descriptions-item label="处理建议">
+          先到"快手 Cloud 新履约"页为 91 的 productNo 配置规则，再回到这里点击重试。
+        </el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <!-- 订单队列 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">91卡券订单队列</span>
+            <p class="card-desc">
+              当前筛选 {{ ninetyoneStats.currentCount }} 条，总计 {{ ninetyoneStats.total }} 条，已生成任务 {{ ninetyoneStats.taskReadyCount }} 条。
+            </p>
+          </div>
+          <div class="card-actions">
+            <el-radio-group
+              :model-value="ninetyoneStatus"
+              size="small"
+              @update:model-value="(v: string | number | boolean | undefined) => handleNinetyoneStatusChange(v as 'pending_config' | 'all' | 'manual_failed')"
+            >
+              <el-radio-button value="pending_config">待补全</el-radio-button>
+              <el-radio-button value="manual_failed">失败</el-radio-button>
+              <el-radio-button value="all">全部</el-radio-button>
+            </el-radio-group>
+            <el-button :loading="ninetyoneLoading" @click="loadNinetyoneOrders(ninetyoneOrders.page)">刷新</el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-alert
+        v-if="ninetyoneResultError"
+        :title="ninetyoneResultError"
+        type="error"
+        show-icon
+        :closable="false"
+        style="margin-bottom: 16px"
+      />
+
+      <el-table
+        :data="ninetyoneOrders.items"
+        stripe
+        size="small"
+        v-loading="ninetyoneLoading"
+        element-loading-text="正在读取 91卡券订单..."
+      >
+        <el-table-column label="订单" min-width="180">
+          <template #default="{ row }">
+            <div>
+              <div style="font-weight: 600">{{ row.orderNo }}</div>
+              <div style="font-size: var(--text-xs); color: var(--text-muted)">{{ row.outTradeNo || '-' }}</div>
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column label="商品" min-width="180">
+          <template #default="{ row }">
+            <div>
+              <div style="font-weight: 600">{{ row.productName || row.productNo || '-' }}</div>
+              <div style="font-size: var(--text-xs); color: var(--text-muted)">productNo: {{ row.productNo || '-' }}</div>
+              <div style="font-size: var(--text-xs); color: var(--text-muted)">数量：{{ row.buyNum || 0 }}</div>
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column label="状态" min-width="140">
+          <template #default="{ row }">
+            <div>
+              <el-tag size="small">{{ row.orderStatus }}</el-tag>
+              <div style="font-size: var(--text-xs); color: var(--text-muted); margin-top: 4px">任务 {{ row.taskCount }}</div>
+              <div v-if="row.failReason" style="font-size: var(--text-xs); color: var(--color-danger)">{{ row.failReason }}</div>
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column label="时间" width="180">
+          <template #default="{ row }">{{ formatAdminDateTime(row.updatedAt || row.createdAt) }}</template>
+        </el-table-column>
+        <el-table-column label="操作" width="200" align="center">
+          <template #default="{ row }">
+            <el-button
+              :loading="ninetyoneActionLoadingId === row.orderId"
+              size="small"
+              type="primary"
+              @click="handleNinetyoneRetryOrder(row)"
+            >
+              重试生成任务
+            </el-button>
+            <el-button
+              v-if="row.orderStatus !== 'manual_failed'"
+              :loading="ninetyoneActionLoadingId === row.orderId"
+              size="small"
+              type="danger"
+              @click="handleNinetyoneFailOrder(row)"
+            >
+              标记失败
+            </el-button>
+          </template>
+        </el-table-column>
+        <template #empty>
+          <el-empty description="当前没有 91卡券订单。" :image-size="60" />
+        </template>
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<style scoped>
+.platform-section {
+  display: grid;
+  gap: var(--space-4);
+}
+
+.section-card {
+  border-radius: var(--radius-lg);
+}
+
+.card-title {
+  font-size: var(--text-lg);
+  font-weight: 600;
+  color: var(--text-primary);
+}
+
+.card-desc {
+  margin: var(--space-1) 0 0;
+  font-size: var(--text-sm);
+  color: var(--text-secondary);
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+  gap: var(--space-3);
+}
+
+.card-actions {
+  display: flex;
+  gap: var(--space-2);
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+</style>
@@ -0,0 +1,463 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import type { AdminNotificationTestResult, AdminScheduledJobRuntimeState } from '@/types/admin'
+import type { EditableNotificationRecipient, EditableScheduledJob } from '../composables/types'
+import { formatAdminDateTime } from '@/utils/admin-time'
+
+type Props = {
+  notificationFilePath: string
+  notificationForm: {
+    enabled: boolean
+    barkEnabled: boolean
+    barkServerUrl: string
+    testTitle: string
+    testBody: string
+    testUrl: string
+  }
+  notificationRecipients: EditableNotificationRecipient[]
+  notificationSaving: boolean
+  notificationTesting: boolean
+  notificationResultError: string
+  notificationTestResult: AdminNotificationTestResult | null
+  scheduledJobsFilePath: string
+  scheduledJobsForm: {
+    enabled: boolean
+  }
+  scheduledJobs: EditableScheduledJob[]
+  scheduledJobRuntime: AdminScheduledJobRuntimeState[]
+  scheduledJobsSaving: boolean
+  scheduledJobRunningId: string
+  notificationStats: {
+    configuredRecipientCount: number
+    enabledRecipientCount: number
+    barkReady: boolean
+    lastSuccessCount: number
+    lastFailedCount: number
+    scheduledJobEnabledCount: number
+  }
+  addNotificationRecipient: () => void
+  removeNotificationRecipient: (id: string) => void
+  handleNotificationSaveConfig: () => void | Promise<void>
+  handleNotificationTest: () => void | Promise<void>
+  handleScheduledJobsSaveConfig: () => void | Promise<void>
+  handleScheduledJobRunNow: (jobId: string) => void | Promise<void>
+  getScheduledJobRuntime: (jobId: string) => AdminScheduledJobRuntimeState | null
+}
+
+defineProps<Props>()
+
+const timeUnitOptions = [
+  { label: '秒', value: 1 },
+  { label: '分钟', value: 60 },
+  { label: '小时', value: 3600 },
+]
+
+function formatJobType(type: string) {
+  if (type === 'cloudtentacles_health') return 'cloudtentacles 健康检查'
+  return type || '-'
+}
+
+function resolveTimeValue(seconds: number) {
+  const normalized = Math.max(0, Number(seconds || 0))
+  if (normalized >= 3600 && normalized % 3600 === 0) {
+    return { amount: normalized / 3600, unit: 3600 }
+  }
+  if (normalized >= 60 && normalized % 60 === 0) {
+    return { amount: normalized / 60, unit: 60 }
+  }
+  return { amount: normalized || 1, unit: 1 }
+}
+
+function formatDuration(seconds: number) {
+  const value = resolveTimeValue(seconds)
+  const unit = timeUnitOptions.find((item) => item.value === value.unit)?.label || '秒'
+  return `${value.amount} ${unit}`
+}
+
+function bindDuration(job: EditableScheduledJob, key: 'intervalSeconds' | 'cooldownSeconds') {
+  const amountKey = `${key}Amount` as keyof EditableScheduledJob
+  const unitKey = `${key}Unit` as keyof EditableScheduledJob
+
+  if (!Number(job[amountKey])) {
+    const resolved = resolveTimeValue(Number(job[key] || 0))
+    ;(job[amountKey] as number) = resolved.amount
+    ;(job[unitKey] as number) = resolved.unit
+  }
+
+  return computed<number>({
+    get: () => Number(job[amountKey] || 1),
+    set: (value: number) => {
+      ;(job[amountKey] as number) = Math.max(1, Number(value || 1))
+      job[key] = Number(job[amountKey] || 1) * Number(job[unitKey] || 1)
+    },
+  })
+}
+
+function bindDurationUnit(job: EditableScheduledJob, key: 'intervalSeconds' | 'cooldownSeconds') {
+  const amountKey = `${key}Amount` as keyof EditableScheduledJob
+  const unitKey = `${key}Unit` as keyof EditableScheduledJob
+
+  if (!Number(job[unitKey])) {
+    const resolved = resolveTimeValue(Number(job[key] || 0))
+    ;(job[amountKey] as number) = resolved.amount
+    ;(job[unitKey] as number) = resolved.unit
+  }
+
+  return computed<number>({
+    get: () => Number(job[unitKey] || 1),
+    set: (value: number) => {
+      ;(job[unitKey] as number) = Math.max(1, Number(value || 1))
+      job[key] = Number(job[amountKey] || 1) * Number(job[unitKey] || 1)
+    },
+  })
+}
+</script>
+
+<template>
+  <div class="platform-section">
+    <!-- 配置信息 -->
+    <el-card class="section-card">
+      <template #header>
+        <span class="card-title">配置信息</span>
+      </template>
+      <el-descriptions :column="1" border size="small">
+        <el-descriptions-item label="职责">内部运营通知，仅发送给后台管理员、客服或值班人员。</el-descriptions-item>
+        <el-descriptions-item label="配置文件">{{ notificationFilePath || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="监控任务">{{ scheduledJobsFilePath || '-' }}</el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <!-- Bark 通知配置 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">Bark 通知</span>
+            <p class="card-desc">已配置 {{ notificationStats.configuredRecipientCount }} 人，启用 {{ notificationStats.enabledRecipientCount }} 人。</p>
+          </div>
+          <div class="card-actions">
+            <el-button @click="addNotificationRecipient">新增接收人</el-button>
+            <el-button :loading="notificationSaving" type="primary" @click="handleNotificationSaveConfig">保存配置</el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-alert
+        v-if="notificationResultError"
+        :title="notificationResultError"
+        type="error"
+        show-icon
+        :closable="false"
+        style="margin-bottom: 16px"
+      />
+
+      <el-form label-width="auto" label-position="top" inline>
+        <el-form-item><el-switch v-model="notificationForm.enabled" active-text="启用内部通知" /></el-form-item>
+        <el-form-item><el-switch v-model="notificationForm.barkEnabled" active-text="启用 Bark 通道" /></el-form-item>
+        <el-form-item label="Bark 服务地址" style="width: 100%">
+          <el-input v-model="notificationForm.barkServerUrl" placeholder="https://api.day.app" />
+        </el-form-item>
+      </el-form>
+
+      <el-table :data="notificationRecipients" stripe size="small" style="margin-top: 16px">
+        <el-table-column label="接收人" min-width="150">
+          <template #default="{ row }">
+            <el-input v-model="row.name" placeholder="例如：客服A" size="small" />
+          </template>
+        </el-table-column>
+        <el-table-column label="Device Key" min-width="200">
+          <template #default="{ row }">
+            <el-input v-model="row.deviceKey" placeholder="Bark device key" size="small" />
+          </template>
+        </el-table-column>
+        <el-table-column label="状态" width="100" align="center">
+          <template #default="{ row }">
+            <el-switch v-model="row.enabled" />
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" width="80" align="center">
+          <template #default="{ row }">
+            <el-button size="small" type="danger" text @click="removeNotificationRecipient(row.id)">删除</el-button>
+          </template>
+        </el-table-column>
+        <template #empty>
+          <el-empty description="还没有 Bark 接收人。" :image-size="60" />
+        </template>
+      </el-table>
+    </el-card>
+
+    <!-- 监控任务 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">监控任务</span>
+            <p class="card-desc">间隔表示多久检查一次；冷却表示同一个异常在这段时间内最多通知一次。</p>
+          </div>
+          <div class="card-actions">
+            <el-button :loading="scheduledJobsSaving" type="primary" @click="handleScheduledJobsSaveConfig">保存任务</el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-form label-width="auto" label-position="top">
+        <el-form-item>
+          <el-switch v-model="scheduledJobsForm.enabled" active-text="启用监控任务系统" />
+        </el-form-item>
+      </el-form>
+
+      <el-table :data="scheduledJobs" stripe size="small" style="margin-top: 8px">
+        <el-table-column label="任务" min-width="200">
+          <template #default="{ row: job }">
+            <div>
+              <div style="font-weight: 600">{{ formatJobType(job.type) }}</div>
+              <el-switch v-model="job.enabled" size="small" active-text="启用" style="margin-top: 4px" />
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column label="参数" min-width="320">
+          <template #default="{ row: job }">
+            <div class="job-params">
+              <div class="param-row">
+                <span class="param-label">检查间隔</span>
+                <input v-model.number="bindDuration(job, 'intervalSeconds').value" type="number" min="1" class="mini-input" />
+                <select v-model.number="bindDurationUnit(job, 'intervalSeconds').value" class="mini-select">
+                  <option v-for="unit in timeUnitOptions" :key="unit.value" :value="unit.value">{{ unit.label }}</option>
+                </select>
+                <span class="param-hint">每 {{ formatDuration(job.intervalSeconds) }} 检查一次</span>
+              </div>
+              <div class="param-row">
+                <span class="param-label">通知冷却</span>
+                <input v-model.number="bindDuration(job, 'cooldownSeconds').value" type="number" min="1" class="mini-input" />
+                <select v-model.number="bindDurationUnit(job, 'cooldownSeconds').value" class="mini-select">
+                  <option v-for="unit in timeUnitOptions" :key="unit.value" :value="unit.value">{{ unit.label }}</option>
+                </select>
+                <span class="param-hint">同类异常 {{ formatDuration(job.cooldownSeconds) }} 内只通知一次</span>
+              </div>
+              <div class="param-row">
+                <span class="param-label">余额阈值</span>
+                <input v-model.number="job.assetThreshold" type="number" min="0" class="mini-input" />
+                <span class="param-hint">低于该值时通知</span>
+              </div>
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column label="最近状态" min-width="160">
+          <template #default="{ row: job }">
+            <div class="runtime-info">
+              <el-tag
+                :type="getScheduledJobRuntime(job.id)?.lastStatus === 'success' ? 'success' : 'info'"
+                size="small"
+              >
+                {{ getScheduledJobRuntime(job.id)?.lastStatus || 'pending' }}
+              </el-tag>
+              <span class="param-hint">{{ getScheduledJobRuntime(job.id)?.lastMessage || '-' }}</span>
+              <span class="param-hint">余额：{{ getScheduledJobRuntime(job.id)?.lastAsset ?? '-' }}</span>
+              <span class="param-hint">上次：{{ formatAdminDateTime(getScheduledJobRuntime(job.id)?.lastRunAt || '') }}</span>
+              <span class="param-hint">下次：{{ formatAdminDateTime(getScheduledJobRuntime(job.id)?.nextRunAt || '') }}</span>
+            </div>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" width="110" align="center">
+          <template #default="{ row: job }">
+            <el-button
+              :loading="scheduledJobRunningId === job.id"
+              size="small"
+              @click="handleScheduledJobRunNow(job.id)"
+            >
+              立即检查
+            </el-button>
+          </template>
+        </el-table-column>
+        <template #empty>
+          <el-empty description="暂无可配置的监控任务。" :image-size="60" />
+        </template>
+      </el-table>
+    </el-card>
+
+    <!-- 测试发送 -->
+    <el-card class="section-card">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <span class="card-title">测试发送</span>
+            <p class="card-desc">测试会发送给所有已启用且填写了 Device Key 的接收人。</p>
+          </div>
+          <div class="card-actions">
+            <el-button
+              :disabled="!notificationStats.barkReady"
+              :loading="notificationTesting"
+              type="primary"
+              @click="handleNotificationTest"
+            >
+              发送测试
+            </el-button>
+          </div>
+        </div>
+      </template>
+
+      <el-form label-width="auto" label-position="top">
+        <el-row :gutter="16">
+          <el-col :span="8">
+            <el-form-item label="标题">
+              <el-input v-model="notificationForm.testTitle" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="内容">
+              <el-input v-model="notificationForm.testBody" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="8">
+            <el-form-item label="跳转链接">
+              <el-input v-model="notificationForm.testUrl" placeholder="可选" />
+            </el-form-item>
+          </el-col>
+        </el-row>
+      </el-form>
+
+      <div v-if="notificationTestResult" class="result-grid">
+        <el-card shadow="never" class="stat-card">
+          <div class="stat-label">成功</div>
+          <div class="stat-value">{{ notificationTestResult.successCount }}</div>
+        </el-card>
+        <el-card shadow="never" class="stat-card">
+          <div class="stat-label">失败</div>
+          <div class="stat-value">{{ notificationTestResult.failedCount }}</div>
+        </el-card>
+        <el-card shadow="never" class="stat-card">
+          <div class="stat-label">通道</div>
+          <div class="stat-value">{{ notificationTestResult.channel || '-' }}</div>
+        </el-card>
+      </div>
+
+      <el-table v-if="notificationTestResult" :data="notificationTestResult.results" stripe size="small" style="margin-top: 16px">
+        <el-table-column label="接收人">
+          <template #default="{ row }">{{ row.recipientName || row.recipientKeyMasked || '-' }}</template>
+        </el-table-column>
+        <el-table-column label="结果" width="80">
+          <template #default="{ row }">
+            <el-tag :type="row.ok ? 'success' : 'danger'" size="small">{{ row.ok ? '成功' : '失败' }}</el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column prop="status" label="状态码" width="80" align="center" />
+        <el-table-column label="说明">
+          <template #default="{ row }">{{ row.errorMessage || '-' }}</template>
+        </el-table-column>
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<style scoped>
+.platform-section {
+  display: grid;
+  gap: var(--space-4);
+}
+
+.section-card {
+  border-radius: var(--radius-lg);
+}
+
+.card-title {
+  font-size: var(--text-lg);
+  font-weight: 600;
+  color: var(--text-primary);
+}
+
+.card-desc {
+  margin: var(--space-1) 0 0;
+  font-size: var(--text-sm);
+  color: var(--text-secondary);
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+  gap: var(--space-3);
+}
+
+.card-actions {
+  display: flex;
+  gap: var(--space-2);
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+
+.job-params {
+  display: grid;
+  gap: var(--space-2);
+}
+
+.param-row {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+}
+
+.param-label {
+  font-size: var(--text-xs);
+  color: var(--text-secondary);
+  font-weight: 600;
+  min-width: 56px;
+}
+
+.mini-input {
+  width: 100px;
+  height: 32px;
+  padding: 0 8px;
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--border-default);
+  background: var(--bg-surface);
+  font-size: var(--text-sm);
+  text-align: center;
+}
+
+.mini-select {
+  width: 80px;
+  height: 32px;
+  padding: 0 4px;
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--border-default);
+  background: var(--bg-surface);
+  font-size: var(--text-sm);
+}
+
+.param-hint {
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+}
+
+.runtime-info {
+  display: grid;
+  gap: 2px;
+  font-size: var(--text-xs);
+}
+
+.result-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: var(--space-3);
+  margin-top: var(--space-4);
+}
+
+.stat-card {
+  text-align: center;
+}
+
+.stat-label {
+  font-size: var(--text-xs);
+  color: var(--text-secondary);
+  font-weight: 700;
+}
+
+.stat-value {
+  font-size: 22px;
+  font-weight: 700;
+  color: var(--text-primary);
+  margin-top: var(--space-1);
+}
+</style>
@@ -0,0 +1,45 @@
+export type PlatformTab = 'agiso' | 'notifications' | 'ninetyone' | 'kuaishouEticket' | 'cloudtentacles'
+
+export type EditableDefaults = {
+  messageTemplate: string
+  autoDeliveryMessageTemplate: string
+}
+
+export type EditableShop = {
+  id: string
+  shopId: string
+  shopName: string
+  accessToken: string
+  enabled: boolean
+  messageTemplate: string
+  autoDeliveryMessageTemplate: string
+}
+
+export type EditableKuaishouEticketShop = {
+  id: string
+  shopId: string
+  kshopName: string
+  cookie: string
+  userAvatar: string
+  enabled: boolean
+}
+
+export type EditableNotificationRecipient = {
+  id: string
+  name: string
+  deviceKey: string
+  enabled: boolean
+}
+
+export type EditableScheduledJob = {
+  id: string
+  type: string
+  enabled: boolean
+  intervalSeconds: number
+  intervalSecondsAmount: number
+  intervalSecondsUnit: number
+  cooldownSeconds: number
+  cooldownSecondsAmount: number
+  cooldownSecondsUnit: number
+  assetThreshold: number
+}
@@ -0,0 +1,199 @@
+import { computed, ref } from 'vue'
+
+import { showError, showSuccess } from '@/lib/feedback'
+import { saveAdminAgisoShopConfigs } from '@/services/admin'
+import type { AdminAgisoMessagingDefaults, AdminAgisoObservedShopItem, AdminAgisoShopConfigItem } from '@/types/admin'
+
+import type { EditableDefaults, EditableShop } from './types'
+
+export function useAdminAgisoPlatform() {
+  const saving = ref(false)
+  const agisoFilePath = ref('')
+  const defaults = ref<EditableDefaults>(createEmptyDefaults())
+  const shops = ref<EditableShop[]>([])
+  const observedShops = ref<AdminAgisoObservedShopItem[]>([])
+  const expandedShopIds = ref<string[]>([])
+
+  const agisoStats = computed(() => ({
+    configuredShopCount: shops.value.length,
+    observedShopCount: observedShops.value.length,
+    pendingObservedCount: observedShops.value.filter((item) => !item.configured).length,
+  }))
+
+  function hydrateAgisoConfig(data: {
+    filePath: string
+    defaults: AdminAgisoMessagingDefaults
+    shops: AdminAgisoShopConfigItem[]
+    observedShops: AdminAgisoObservedShopItem[]
+  }) {
+    agisoFilePath.value = data.filePath
+    defaults.value = mapEditableDefaults(data.defaults)
+    shops.value = data.shops.map(mapEditableShop)
+    observedShops.value = data.observedShops
+    expandedShopIds.value = []
+  }
+
+  function addShop() {
+    const shop = createEmptyShop()
+    shops.value.unshift(shop)
+    expandShop(shop.id)
+  }
+
+  function removeShop(id: string) {
+    shops.value = shops.value.filter((item) => item.id !== id)
+    collapseShop(id)
+  }
+
+  function importObservedShop(item: AdminAgisoObservedShopItem) {
+    const shop: EditableShop = {
+      id: crypto.randomUUID(),
+      shopId: item.shopId,
+      shopName: item.detectedShopName || item.displayShopName || '',
+      accessToken: '',
+      enabled: true,
+      messageTemplate: '',
+      autoDeliveryMessageTemplate: '',
+    }
+    shops.value.unshift(shop)
+    expandShop(shop.id)
+  }
+
+  function isShopExpanded(id: string) {
+    return expandedShopIds.value.includes(id)
+  }
+
+  function expandShop(id: string) {
+    if (expandedShopIds.value.includes(id)) {
+      return
+    }
+    expandedShopIds.value = [id, ...expandedShopIds.value]
+  }
+
+  function collapseShop(id: string) {
+    expandedShopIds.value = expandedShopIds.value.filter((item) => item !== id)
+  }
+
+  function toggleShop(id: string) {
+    if (isShopExpanded(id)) {
+      collapseShop(id)
+      return
+    }
+    expandShop(id)
+  }
+
+  function expandAllShops() {
+    expandedShopIds.value = shops.value.map((item) => item.id)
+  }
+
+  function collapseAllShops() {
+    expandedShopIds.value = []
+  }
+
+  function describeShop(shop: EditableShop) {
+    const overrides: string[] = []
+
+    if (shop.messageTemplate.trim()) {
+      overrides.push('领取模板')
+    }
+    if (shop.autoDeliveryMessageTemplate.trim()) {
+      overrides.push('发货模板')
+    }
+
+    return overrides.length === 0 ? '使用默认模板' : `已覆盖 ${overrides.join('、')}`
+  }
+
+  async function saveAgisoConfigs(reloadConfigs: () => Promise<void>) {
+    const payloadDefaults = {
+      messageTemplate: defaults.value.messageTemplate.trim(),
+      autoDeliveryMessageTemplate: defaults.value.autoDeliveryMessageTemplate.trim(),
+    }
+    const payload = shops.value
+      .map((item) => ({
+        shopId: item.shopId.trim(),
+        shopName: item.shopName.trim(),
+        accessToken: item.accessToken.trim(),
+        enabled: item.enabled,
+        messageTemplate: item.messageTemplate.trim(),
+        autoDeliveryMessageTemplate: item.autoDeliveryMessageTemplate.trim(),
+      }))
+      .filter((item) => item.shopId && item.accessToken)
+
+    saving.value = true
+
+    try {
+      const response = await saveAdminAgisoShopConfigs({
+        defaults: payloadDefaults,
+        shops: payload,
+      })
+      agisoFilePath.value = response.data.filePath
+      defaults.value = mapEditableDefaults(response.data.defaults)
+      shops.value = response.data.shops.map(mapEditableShop)
+      showSuccess('Agiso 配置已保存')
+      await reloadConfigs()
+    } catch (error) {
+      showError(error instanceof Error ? error.message : '保存 Agiso 配置失败')
+    } finally {
+      saving.value = false
+    }
+  }
+
+  return {
+    saving,
+    agisoFilePath,
+    defaults,
+    shops,
+    observedShops,
+    expandedShopIds,
+    agisoStats,
+    hydrateAgisoConfig,
+    addShop,
+    removeShop,
+    importObservedShop,
+    isShopExpanded,
+    expandShop,
+    collapseShop,
+    toggleShop,
+    expandAllShops,
+    collapseAllShops,
+    describeShop,
+    saveAgisoConfigs,
+  }
+}
+
+function createEmptyDefaults(): EditableDefaults {
+  return {
+    messageTemplate: '',
+    autoDeliveryMessageTemplate: '',
+  }
+}
+
+function createEmptyShop(): EditableShop {
+  return {
+    id: crypto.randomUUID(),
+    shopId: '',
+    shopName: '',
+    accessToken: '',
+    enabled: true,
+    messageTemplate: '',
+    autoDeliveryMessageTemplate: '',
+  }
+}
+
+function mapEditableDefaults(item?: AdminAgisoMessagingDefaults): EditableDefaults {
+  return {
+    messageTemplate: item?.messageTemplate ?? '',
+    autoDeliveryMessageTemplate: item?.autoDeliveryMessageTemplate ?? '',
+  }
+}
+
+function mapEditableShop(item: AdminAgisoShopConfigItem): EditableShop {
+  return {
+    id: crypto.randomUUID(),
+    shopId: item.shopId,
+    shopName: item.shopName,
+    accessToken: item.accessToken,
+    enabled: item.enabled !== false,
+    messageTemplate: item.messageTemplate,
+    autoDeliveryMessageTemplate: item.autoDeliveryMessageTemplate,
+  }
+}
@@ -0,0 +1,458 @@
+import { computed, ref } from 'vue'
+
+import { showError, showSuccess } from '@/lib/feedback'
+import {
+  appointAdminCloudtentaclesVn,
+  backAdminCloudtentaclesVn,
+  buyAdminCloudtentaclesSku,
+  fetchAdminCloudtentaclesAsset,
+  fetchAdminCloudtentaclesBindUrl,
+  fetchAdminCloudtentaclesCategories,
+  fetchAdminCloudtentaclesKnapsack,
+  fetchAdminCloudtentaclesSkuList,
+  fetchAdminCloudtentaclesVnCode,
+  fetchAdminCloudtentaclesVnList,
+  generateAdminCloudtentaclesVnLoginCode,
+  runAdminCloudtentaclesFullFlow,
+  saveAdminCloudtentaclesSourceConfig,
+  sendAdminCloudtentaclesSmsCode,
+  testAdminCloudtentaclesLogin,
+  useAdminCloudtentaclesSku,
+  validateAdminCloudtentaclesSession,
+  verifyAdminCloudtentaclesVnCode,
+} from '@/services/admin'
+import type {
+  AdminCloudtentaclesLoginTestResult,
+  AdminCloudtentaclesPersistedSession,
+  AdminCloudtentaclesSendSmsResult,
+  AdminCloudtentaclesSourceConfig,
+  AdminCloudtentaclesValidateSessionResult,
+} from '@/types/admin'
+
+export function useAdminCloudtentaclesPlatform() {
+  const cloudtentaclesFilePath = ref('')
+  const cloudtentaclesSessionFilePath = ref('')
+  const cloudtentaclesForm = ref({
+    baseUrl: 'https://123.207.217.176',
+    username: '',
+    password: '',
+    phone: '',
+    code: '',
+    token: '',
+    vnKey: '1',
+    vnId: 0,
+    skuId: 5,
+    skuCount: 1,
+    deviceId: '-',
+    deviceType: 0,
+  })
+  const cloudtentaclesSaving = ref(false)
+  const cloudtentaclesSendingSms = ref(false)
+  const cloudtentaclesTesting = ref(false)
+  const cloudtentaclesValidating = ref(false)
+  const cloudtentaclesResultError = ref('')
+  const cloudtentaclesSmsResult = ref<AdminCloudtentaclesSendSmsResult | null>(null)
+  const cloudtentaclesLoginResult = ref<AdminCloudtentaclesLoginTestResult | null>(null)
+  const cloudtentaclesValidateResult = ref<AdminCloudtentaclesValidateSessionResult | null>(null)
+  const cloudtentaclesDebugLoading = ref(false)
+  const cloudtentaclesDebugResult = ref('')
+  const cloudtentaclesPersistedSession = ref<AdminCloudtentaclesPersistedSession | null>(null)
+
+  const cloudtentaclesStats = computed(() => ({
+    hasCredential: Boolean(
+      cloudtentaclesForm.value.username.trim()
+        && cloudtentaclesForm.value.password.trim()
+        && cloudtentaclesForm.value.phone.trim(),
+    ),
+    smsSent: Boolean(cloudtentaclesSmsResult.value),
+    validated: Boolean(cloudtentaclesValidateResult.value || cloudtentaclesLoginResult.value),
+  }))
+
+  function hydrateCloudtentaclesConfig(data: {
+    filePath: string
+    sessionFilePath: string
+    session: AdminCloudtentaclesPersistedSession
+    source: {
+      baseUrl?: string
+      username?: string
+      password?: string
+      phone?: string
+      deviceId?: string
+      deviceType?: number
+    }
+  }) {
+    cloudtentaclesFilePath.value = data.filePath
+    cloudtentaclesSessionFilePath.value = data.sessionFilePath
+    cloudtentaclesPersistedSession.value = data.session
+    cloudtentaclesForm.value = {
+      baseUrl: data.source.baseUrl || 'https://123.207.217.176',
+      username: data.source.username || '',
+      password: data.source.password || '',
+      phone: data.source.phone || '',
+      code: '',
+      token: data.session?.token || '',
+      vnKey: '1',
+      vnId: 0,
+      skuId: 5,
+      skuCount: 1,
+      deviceId: data.source.deviceId || '-',
+      deviceType: data.source.deviceType || 0,
+    }
+  }
+
+  function buildCloudtentaclesConfigPayload(): AdminCloudtentaclesSourceConfig {
+    return {
+      enabled: true,
+      baseUrl: cloudtentaclesForm.value.baseUrl.trim() || 'https://123.207.217.176',
+      username: cloudtentaclesForm.value.username.trim(),
+      password: cloudtentaclesForm.value.password.trim(),
+      phone: cloudtentaclesForm.value.phone.trim(),
+      deviceId: cloudtentaclesForm.value.deviceId.trim() || '-',
+      deviceType: Number(cloudtentaclesForm.value.deviceType || 0),
+    }
+  }
+
+  function buildCloudtentaclesLoginPayload() {
+    return {
+      ...buildCloudtentaclesConfigPayload(),
+      code: cloudtentaclesForm.value.code.trim(),
+    }
+  }
+
+  function ensureCloudtentaclesBaseFields() {
+    if (!cloudtentaclesForm.value.username.trim() || !cloudtentaclesForm.value.phone.trim()) {
+      cloudtentaclesResultError.value = '请先填写 cloudtentacles 账号和手机号'
+      return false
+    }
+    return true
+  }
+
+  function ensureCloudtentaclesLoginFields() {
+    if (
+      !cloudtentaclesForm.value.username.trim()
+      || !cloudtentaclesForm.value.password.trim()
+      || !cloudtentaclesForm.value.phone.trim()
+    ) {
+      cloudtentaclesResultError.value = '请先填写 cloudtentacles 账号、密码和手机号'
+      return false
+    }
+
+    if (!cloudtentaclesForm.value.code.trim()) {
+      cloudtentaclesResultError.value = '请先填写短信验证码'
+      return false
+    }
+
+    return true
+  }
+
+  async function handleCloudtentaclesSaveSource() {
+    cloudtentaclesSaving.value = true
+    cloudtentaclesResultError.value = ''
+
+    try {
+      const response = await saveAdminCloudtentaclesSourceConfig(buildCloudtentaclesConfigPayload())
+      cloudtentaclesFilePath.value = response.data.filePath
+      cloudtentaclesSessionFilePath.value = response.data.sessionFilePath
+      cloudtentaclesPersistedSession.value = response.data.session
+      cloudtentaclesForm.value.token = response.data.session?.token || ''
+      showSuccess('cloudtentacles 履约平台配置已保存')
+    } catch (error) {
+      cloudtentaclesResultError.value = error instanceof Error ? error.message : 'cloudtentacles 配置保存失败'
+      showError(cloudtentaclesResultError.value)
+    } finally {
+      cloudtentaclesSaving.value = false
+    }
+  }
+
+  async function handleCloudtentaclesSendSmsCode() {
+    if (!ensureCloudtentaclesBaseFields()) {
+      return
+    }
+
+    cloudtentaclesSendingSms.value = true
+    cloudtentaclesResultError.value = ''
+
+    try {
+      const response = await sendAdminCloudtentaclesSmsCode(buildCloudtentaclesConfigPayload())
+      cloudtentaclesSmsResult.value = response.data
+      showSuccess('cloudtentacles 短信验证码已发送')
+    } catch (error) {
+      cloudtentaclesResultError.value = error instanceof Error ? error.message : 'cloudtentacles 发送短信验证码失败'
+      showError(cloudtentaclesResultError.value)
+    } finally {
+      cloudtentaclesSendingSms.value = false
+    }
+  }
+
+  async function handleCloudtentaclesTestLogin() {
+    if (!ensureCloudtentaclesLoginFields()) {
+      return
+    }
+
+    cloudtentaclesTesting.value = true
+    cloudtentaclesResultError.value = ''
+
+    try {
+      const response = await testAdminCloudtentaclesLogin(buildCloudtentaclesLoginPayload())
+      cloudtentaclesLoginResult.value = response.data
+      cloudtentaclesForm.value.token = response.data.token || cloudtentaclesForm.value.token
+      cloudtentaclesPersistedSession.value = {
+        token: response.data.token || '',
+        tokenMasked: response.data.session.tokenMasked,
+        baseUrl: response.data.baseUrl,
+        username: response.data.username,
+        phoneMasked: response.data.phoneMasked,
+        loggedInAt: response.data.loggedInAt,
+        deviceId: cloudtentaclesForm.value.deviceId.trim() || '-',
+        deviceType: Number(cloudtentaclesForm.value.deviceType || 0),
+        hasToken: Boolean(response.data.token),
+      }
+      showSuccess('cloudtentacles 登录测试成功')
+    } catch (error) {
+      cloudtentaclesResultError.value = error instanceof Error ? error.message : 'cloudtentacles 登录测试失败'
+      showError(cloudtentaclesResultError.value)
+    } finally {
+      cloudtentaclesTesting.value = false
+    }
+  }
+
+  async function handleCloudtentaclesValidateSession() {
+    const token = cloudtentaclesForm.value.token.trim()
+    if (!token) {
+      cloudtentaclesResultError.value = '请先填写 token'
+      return
+    }
+
+    cloudtentaclesValidating.value = true
+    cloudtentaclesResultError.value = ''
+
+    try {
+      const response = await validateAdminCloudtentaclesSession({
+        baseUrl: cloudtentaclesForm.value.baseUrl.trim() || 'https://123.207.217.176',
+        token,
+        deviceId: cloudtentaclesForm.value.deviceId.trim() || '-',
+        deviceType: Number(cloudtentaclesForm.value.deviceType || 0),
+      })
+      cloudtentaclesValidateResult.value = response.data
+      cloudtentaclesPersistedSession.value = {
+        token,
+        tokenMasked: response.data.session.tokenMasked,
+        baseUrl: response.data.baseUrl,
+        username: cloudtentaclesPersistedSession.value?.username || cloudtentaclesForm.value.username.trim(),
+        phoneMasked: cloudtentaclesPersistedSession.value?.phoneMasked || '',
+        loggedInAt: response.data.loggedInAt,
+        deviceId: cloudtentaclesForm.value.deviceId.trim() || '-',
+        deviceType: Number(cloudtentaclesForm.value.deviceType || 0),
+        hasToken: Boolean(token),
+      }
+      showSuccess('cloudtentacles 会话校验成功')
+    } catch (error) {
+      cloudtentaclesResultError.value = error instanceof Error ? error.message : 'cloudtentacles 会话校验失败'
+      showError(cloudtentaclesResultError.value)
+    } finally {
+      cloudtentaclesValidating.value = false
+    }
+  }
+
+  function buildCloudtentaclesTokenPayload() {
+    return {
+      baseUrl: cloudtentaclesForm.value.baseUrl.trim() || 'https://123.207.217.176',
+      token: cloudtentaclesForm.value.token.trim(),
+      deviceId: cloudtentaclesForm.value.deviceId.trim() || '-',
+      deviceType: Number(cloudtentaclesForm.value.deviceType || 0),
+    }
+  }
+
+  function ensureCloudtentaclesToken() {
+    if (!cloudtentaclesForm.value.token.trim()) {
+      cloudtentaclesResultError.value = '请先登录或手动填写 token'
+      return false
+    }
+    return true
+  }
+
+  function renderCloudtentaclesDebugResult(label: string, data: unknown) {
+    cloudtentaclesDebugResult.value = `${label}\n${JSON.stringify(data, null, 2)}`
+  }
+
+  async function runCloudtentaclesDebugAction(label: string, runner: () => Promise<{ data: unknown }>) {
+    cloudtentaclesDebugLoading.value = true
+    cloudtentaclesResultError.value = ''
+
+    try {
+      const response = await runner()
+      renderCloudtentaclesDebugResult(label, response.data)
+      showSuccess(`${label}成功`)
+    } catch (error) {
+      cloudtentaclesResultError.value = error instanceof Error ? error.message : `${label}失败`
+      showError(cloudtentaclesResultError.value)
+    } finally {
+      cloudtentaclesDebugLoading.value = false
+    }
+  }
+
+  async function handleCloudtentaclesFetchAsset() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('查询余额', () => fetchAdminCloudtentaclesAsset(buildCloudtentaclesTokenPayload()))
+  }
+
+  async function handleCloudtentaclesFetchCategories() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('查询分类', () => fetchAdminCloudtentaclesCategories(buildCloudtentaclesTokenPayload()))
+  }
+
+  async function handleCloudtentaclesFetchSkuList() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('查询SKU列表', () => fetchAdminCloudtentaclesSkuList(buildCloudtentaclesTokenPayload()))
+  }
+
+  async function handleCloudtentaclesBuySku() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('购买SKU', () => buyAdminCloudtentaclesSku({
+      ...buildCloudtentaclesTokenPayload(),
+      id: Number(cloudtentaclesForm.value.skuId || 0),
+      count: Number(cloudtentaclesForm.value.skuCount || 1),
+    }))
+  }
+
+  async function handleCloudtentaclesUseSku() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('执行发货', () => useAdminCloudtentaclesSku({
+      ...buildCloudtentaclesTokenPayload(),
+      id: Number(cloudtentaclesForm.value.skuId || 0),
+      virtualNumberId: Number(cloudtentaclesForm.value.vnId || 0),
+      phone: cloudtentaclesForm.value.phone.trim(),
+    }))
+  }
+
+  async function handleCloudtentaclesFetchKnapsack() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('查询背包', () => fetchAdminCloudtentaclesKnapsack(buildCloudtentaclesTokenPayload()))
+  }
+
+  async function handleCloudtentaclesFetchVnList() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('查询虚拟号列表', () => fetchAdminCloudtentaclesVnList({
+      ...buildCloudtentaclesTokenPayload(),
+      key: cloudtentaclesForm.value.vnKey.trim(),
+    }))
+  }
+
+  async function handleCloudtentaclesAppointVn() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('申请虚拟号', async () => {
+      const response = await appointAdminCloudtentaclesVn({
+        ...buildCloudtentaclesTokenPayload(),
+        key: cloudtentaclesForm.value.vnKey.trim(),
+      })
+      const item = (response.data as { item?: { id?: number, phone?: string } }).item
+      if (item?.id) {
+        cloudtentaclesForm.value.vnId = Number(item.id)
+      }
+      if (item?.phone) {
+        cloudtentaclesForm.value.phone = String(item.phone)
+      }
+      return response
+    })
+  }
+
+  async function handleCloudtentaclesGenerateVnLoginCode() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('生成登录码', () => generateAdminCloudtentaclesVnLoginCode({
+      ...buildCloudtentaclesTokenPayload(),
+      key: cloudtentaclesForm.value.vnKey.trim(),
+      id: Number(cloudtentaclesForm.value.vnId || 0),
+    }))
+  }
+
+  async function handleCloudtentaclesFetchVnCode() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('获取验证码', async () => {
+      const response = await fetchAdminCloudtentaclesVnCode({
+        ...buildCloudtentaclesTokenPayload(),
+        key: cloudtentaclesForm.value.vnKey.trim(),
+        phone: cloudtentaclesForm.value.phone.trim(),
+      })
+      const code = (response.data as { code?: string }).code
+      if (code) {
+        cloudtentaclesForm.value.code = String(code)
+      }
+      return response
+    })
+  }
+
+  async function handleCloudtentaclesVerifyVnCode() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('校验验证码', () => verifyAdminCloudtentaclesVnCode({
+      ...buildCloudtentaclesTokenPayload(),
+      key: cloudtentaclesForm.value.vnKey.trim(),
+      id: Number(cloudtentaclesForm.value.vnId || 0),
+      code: cloudtentaclesForm.value.code.trim(),
+    }))
+  }
+
+  async function handleCloudtentaclesFetchBindUrl() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('获取兑换链接', () => fetchAdminCloudtentaclesBindUrl({
+      ...buildCloudtentaclesTokenPayload(),
+      key: cloudtentaclesForm.value.vnKey.trim(),
+      id: Number(cloudtentaclesForm.value.vnId || 0),
+    }))
+  }
+
+  async function handleCloudtentaclesBackVn() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('退还号码', () => backAdminCloudtentaclesVn({
+      ...buildCloudtentaclesTokenPayload(),
+      key: cloudtentaclesForm.value.vnKey.trim(),
+      id: Number(cloudtentaclesForm.value.vnId || 0),
+    }))
+  }
+
+  async function handleCloudtentaclesRunFullFlow() {
+    if (!ensureCloudtentaclesToken()) return
+    await runCloudtentaclesDebugAction('完整测试流程', () => runAdminCloudtentaclesFullFlow({
+      ...buildCloudtentaclesTokenPayload(),
+      skuId: Number(cloudtentaclesForm.value.skuId || 0),
+      skuCount: Number(cloudtentaclesForm.value.skuCount || 1),
+      vnKey: cloudtentaclesForm.value.vnKey.trim(),
+    }))
+  }
+
+  return {
+    cloudtentaclesFilePath,
+    cloudtentaclesSessionFilePath,
+    cloudtentaclesForm,
+    cloudtentaclesSaving,
+    cloudtentaclesSendingSms,
+    cloudtentaclesTesting,
+    cloudtentaclesValidating,
+    cloudtentaclesResultError,
+    cloudtentaclesSmsResult,
+    cloudtentaclesLoginResult,
+    cloudtentaclesValidateResult,
+    cloudtentaclesDebugLoading,
+    cloudtentaclesDebugResult,
+    cloudtentaclesPersistedSession,
+    cloudtentaclesStats,
+    hydrateCloudtentaclesConfig,
+    handleCloudtentaclesSaveSource,
+    handleCloudtentaclesSendSmsCode,
+    handleCloudtentaclesTestLogin,
+    handleCloudtentaclesValidateSession,
+    handleCloudtentaclesFetchAsset,
+    handleCloudtentaclesFetchCategories,
+    handleCloudtentaclesFetchSkuList,
+    handleCloudtentaclesBuySku,
+    handleCloudtentaclesUseSku,
+    handleCloudtentaclesFetchKnapsack,
+    handleCloudtentaclesFetchVnList,
+    handleCloudtentaclesAppointVn,
+    handleCloudtentaclesGenerateVnLoginCode,
+    handleCloudtentaclesFetchVnCode,
+    handleCloudtentaclesVerifyVnCode,
+    handleCloudtentaclesFetchBindUrl,
+    handleCloudtentaclesBackVn,
+    handleCloudtentaclesRunFullFlow,
+  }
+}
@@ -0,0 +1,382 @@
+import { computed, ref } from 'vue'
+
+import { showError, showSuccess } from '@/lib/feedback'
+import {
+  consumeAdminKuaishouEticket,
+  queryAdminKuaishouEticketDetail,
+  queryAdminKuaishouEticketShopInfo,
+  saveAdminKuaishouEticketSourceConfig,
+} from '@/services/admin'
+import type {
+  AdminKuaishouEticketConsumeResult,
+  AdminKuaishouEticketDetailResult,
+  AdminKuaishouEticketShopConfigItem,
+  AdminKuaishouEticketShopInfoResult,
+  AdminKuaishouEticketSourceConfig,
+} from '@/types/admin'
+
+import type { EditableKuaishouEticketShop } from './types'
+
+export function useAdminKuaishouEticketPlatform() {
+  const kuaishouEticketFilePath = ref('')
+  const kuaishouEticketShops = ref<EditableKuaishouEticketShop[]>([])
+  const expandedKuaishouEticketShopIds = ref<string[]>([])
+  const kuaishouEticketForm = ref({
+    baseUrl: 'https://s.kwaixiaodian.com',
+    selectedShopId: '',
+    queryTicketCode: '',
+    eTicketId: '',
+    oid: '',
+    formToken: '',
+    num: 1,
+    storeId: '0',
+  })
+  const kuaishouEticketSaving = ref(false)
+  const kuaishouEticketResolvingShopId = ref('')
+  const kuaishouEticketDetailing = ref(false)
+  const kuaishouEticketConsuming = ref(false)
+  const kuaishouEticketResultError = ref('')
+  const kuaishouEticketShopInfoResult = ref<AdminKuaishouEticketShopInfoResult | null>(null)
+  const kuaishouEticketDetailResult = ref<AdminKuaishouEticketDetailResult | null>(null)
+  const kuaishouEticketConsumeResult = ref<AdminKuaishouEticketConsumeResult | null>(null)
+
+  const activeKuaishouEticketShop = computed(() => (
+    kuaishouEticketShops.value.find((item) => item.id === kuaishouEticketForm.value.selectedShopId) || null
+  ))
+
+  const kuaishouEticketStats = computed(() => ({
+    configuredShopCount: kuaishouEticketShops.value.length,
+    cookieReadyCount: kuaishouEticketShops.value.filter((item) => item.cookie.trim()).length,
+    selectedShopReady: Boolean(activeKuaishouEticketShop.value?.cookie.trim()),
+    detailReady: Boolean(kuaishouEticketDetailResult.value?.detail),
+    consumed: Boolean(kuaishouEticketConsumeResult.value?.consumed),
+  }))
+
+  function hydrateKuaishouEticketConfig(data: {
+    filePath: string
+    source: {
+      baseUrl?: string
+      shops: AdminKuaishouEticketShopConfigItem[]
+    }
+  }) {
+    kuaishouEticketFilePath.value = data.filePath
+    kuaishouEticketShops.value = data.source.shops.map(mapEditableKuaishouEticketShop)
+    kuaishouEticketForm.value = {
+      baseUrl: data.source.baseUrl || 'https://s.kwaixiaodian.com',
+      selectedShopId: '',
+      queryTicketCode: '',
+      eTicketId: '',
+      oid: '',
+      formToken: '',
+      num: 1,
+      storeId: '0',
+    }
+    kuaishouEticketForm.value.selectedShopId = kuaishouEticketShops.value[0]?.id || ''
+    expandedKuaishouEticketShopIds.value = kuaishouEticketShops.value[0]?.id ? [kuaishouEticketShops.value[0].id] : []
+  }
+
+  function buildKuaishouEticketConfigPayload(): AdminKuaishouEticketSourceConfig {
+    return {
+      enabled: true,
+      baseUrl: kuaishouEticketForm.value.baseUrl.trim() || 'https://s.kwaixiaodian.com',
+      shops: kuaishouEticketShops.value.map((item) => ({
+        shopId: item.shopId.trim(),
+        kshopName: item.kshopName.trim(),
+        cookie: item.cookie.trim(),
+        cookieMasked: '',
+        hasCookie: Boolean(item.cookie.trim()),
+        userAvatar: item.userAvatar.trim(),
+        enabled: item.enabled,
+      })),
+    }
+  }
+
+  function addKuaishouEticketShop() {
+    const shop = createEmptyKuaishouEticketShop()
+    kuaishouEticketShops.value.unshift(shop)
+    setKuaishouEticketDebugShop(shop.id)
+  }
+
+  function removeKuaishouEticketShop(id: string) {
+    kuaishouEticketShops.value = kuaishouEticketShops.value.filter((item) => item.id !== id)
+    collapseKuaishouEticketShop(id)
+    if (kuaishouEticketForm.value.selectedShopId === id) {
+      kuaishouEticketForm.value.selectedShopId = kuaishouEticketShops.value[0]?.id || ''
+    }
+  }
+
+  function isKuaishouEticketShopExpanded(id: string) {
+    return expandedKuaishouEticketShopIds.value.includes(id)
+  }
+
+  function expandKuaishouEticketShop(id: string) {
+    if (expandedKuaishouEticketShopIds.value.includes(id)) {
+      return
+    }
+    expandedKuaishouEticketShopIds.value = [id, ...expandedKuaishouEticketShopIds.value]
+  }
+
+  function collapseKuaishouEticketShop(id: string) {
+    expandedKuaishouEticketShopIds.value = expandedKuaishouEticketShopIds.value.filter((item) => item !== id)
+  }
+
+  function toggleKuaishouEticketShop(id: string) {
+    if (isKuaishouEticketShopExpanded(id)) {
+      collapseKuaishouEticketShop(id)
+      return
+    }
+    expandKuaishouEticketShop(id)
+  }
+
+  function expandAllKuaishouEticketShops() {
+    expandedKuaishouEticketShopIds.value = kuaishouEticketShops.value.map((item) => item.id)
+  }
+
+  function collapseAllKuaishouEticketShops() {
+    expandedKuaishouEticketShopIds.value = []
+  }
+
+  function setKuaishouEticketDebugShop(id: string) {
+    kuaishouEticketForm.value.selectedShopId = id
+    expandKuaishouEticketShop(id)
+  }
+
+  function describeKuaishouEticketShop(shop: EditableKuaishouEticketShop) {
+    const status = shop.cookie.trim() ? 'Cookie 已就绪' : '待补 Cookie'
+    const identity = shop.shopId.trim() ? '已识别店铺' : '待读取信息'
+    return `${status} · ${identity}`
+  }
+
+  function getKuaishouEticketShopInitial(shop: EditableKuaishouEticketShop) {
+    const label = shop.kshopName.trim() || shop.shopId.trim() || '店'
+    return label.slice(0, 1).toUpperCase()
+  }
+
+  function ensureSelectedKuaishouEticketShop() {
+    const selected = activeKuaishouEticketShop.value
+
+    if (!selected) {
+      kuaishouEticketResultError.value = '请先新增并选择一个店铺配置'
+      return null
+    }
+
+    if (!selected.cookie.trim()) {
+      kuaishouEticketResultError.value = '当前店铺缺少 Cookie，请先补全后再操作'
+      return null
+    }
+
+    return selected
+  }
+
+  function ensureKuaishouEticketQueryFields() {
+    const selected = ensureSelectedKuaishouEticketShop()
+    if (!selected) return false
+
+    if (!kuaishouEticketForm.value.queryTicketCode.trim()) {
+      kuaishouEticketResultError.value = '请先填写查询券码'
+      return false
+    }
+
+    return true
+  }
+
+  function ensureKuaishouEticketConsumeFields() {
+    const selected = ensureSelectedKuaishouEticketShop()
+    if (!selected) return false
+
+    if (!kuaishouEticketDetailResult.value?.detail) {
+      kuaishouEticketResultError.value = '请先查询核销信息，系统会自动带出 eTicketId、oid 和 formToken'
+      return false
+    }
+
+    return true
+  }
+
+  function applyKuaishouEticketDetailToForm(result: AdminKuaishouEticketDetailResult | null) {
+    if (!result?.detail) {
+      return
+    }
+
+    kuaishouEticketForm.value.eTicketId = result.detail.eTicketId || kuaishouEticketForm.value.eTicketId
+    kuaishouEticketForm.value.oid = result.detail.oid || kuaishouEticketForm.value.oid
+    kuaishouEticketForm.value.formToken = result.detail.formToken || kuaishouEticketForm.value.formToken
+
+    const leftCount = Number(result.detail.leftCount || 0)
+    if (leftCount > 0) {
+      kuaishouEticketForm.value.num = leftCount
+    }
+  }
+
+  async function handleKuaishouEticketResolveShopInfo(shop: EditableKuaishouEticketShop) {
+    if (!shop.cookie.trim()) {
+      kuaishouEticketResultError.value = '请先为该店铺粘贴 Cookie'
+      showError(kuaishouEticketResultError.value)
+      return
+    }
+
+    kuaishouEticketResolvingShopId.value = shop.id
+    kuaishouEticketResultError.value = ''
+
+    try {
+      const response = await queryAdminKuaishouEticketShopInfo({
+        baseUrl: kuaishouEticketForm.value.baseUrl.trim() || 'https://s.kwaixiaodian.com',
+        shopId: shop.shopId.trim(),
+        cookie: shop.cookie.trim(),
+      })
+      kuaishouEticketShopInfoResult.value = response.data
+      shop.shopId = response.data.shop.shopId || shop.shopId
+      shop.kshopName = response.data.shop.kshopName || shop.kshopName
+      shop.userAvatar = response.data.shop.userAvatar || shop.userAvatar
+      if (!kuaishouEticketForm.value.selectedShopId) {
+        setKuaishouEticketDebugShop(shop.id)
+      }
+      showSuccess(`已识别店铺：${response.data.shop.kshopName || response.data.shop.shopId || '未知店铺'}`)
+    } catch (error) {
+      kuaishouEticketResultError.value = error instanceof Error ? error.message : '读取快手小店店铺信息失败'
+      showError(kuaishouEticketResultError.value)
+    } finally {
+      kuaishouEticketResolvingShopId.value = ''
+    }
+  }
+
+  async function handleKuaishouEticketSaveSource() {
+    kuaishouEticketSaving.value = true
+    kuaishouEticketResultError.value = ''
+
+    try {
+      const response = await saveAdminKuaishouEticketSourceConfig(buildKuaishouEticketConfigPayload())
+      kuaishouEticketFilePath.value = response.data.filePath
+      kuaishouEticketForm.value.baseUrl = response.data.source.baseUrl || 'https://s.kwaixiaodian.com'
+      const previousSelectedShopId = activeKuaishouEticketShop.value?.shopId || ''
+      kuaishouEticketShops.value = response.data.source.shops.map(mapEditableKuaishouEticketShop)
+      kuaishouEticketForm.value.selectedShopId = (
+        kuaishouEticketShops.value.find((item) => item.shopId && item.shopId === previousSelectedShopId)?.id
+        || kuaishouEticketShops.value[0]?.id
+        || ''
+      )
+      expandedKuaishouEticketShopIds.value = kuaishouEticketForm.value.selectedShopId
+        ? [kuaishouEticketForm.value.selectedShopId]
+        : []
+      showSuccess('快手小店核销配置已保存')
+    } catch (error) {
+      kuaishouEticketResultError.value = error instanceof Error ? error.message : '快手小店核销配置保存失败'
+      showError(kuaishouEticketResultError.value)
+    } finally {
+      kuaishouEticketSaving.value = false
+    }
+  }
+
+  async function handleKuaishouEticketQueryDetail() {
+    if (!ensureKuaishouEticketQueryFields()) {
+      return
+    }
+
+    const selected = activeKuaishouEticketShop.value
+    kuaishouEticketDetailing.value = true
+    kuaishouEticketResultError.value = ''
+    kuaishouEticketConsumeResult.value = null
+
+    try {
+      const response = await queryAdminKuaishouEticketDetail({
+        baseUrl: kuaishouEticketForm.value.baseUrl.trim() || 'https://s.kwaixiaodian.com',
+        shopId: selected?.shopId.trim(),
+        cookie: selected?.cookie.trim(),
+        eTicketId: kuaishouEticketForm.value.queryTicketCode.trim(),
+      })
+      kuaishouEticketDetailResult.value = response.data
+      applyKuaishouEticketDetailToForm(response.data)
+      showSuccess(response.data.ok ? '核销信息查询成功' : (response.data.errorMessage || '核销信息已返回'))
+    } catch (error) {
+      kuaishouEticketResultError.value = error instanceof Error ? error.message : '查询快手小店核销信息失败'
+      showError(kuaishouEticketResultError.value)
+    } finally {
+      kuaishouEticketDetailing.value = false
+    }
+  }
+
+  async function handleKuaishouEticketConsume() {
+    if (!ensureKuaishouEticketConsumeFields()) {
+      return
+    }
+
+    const selected = activeKuaishouEticketShop.value
+    kuaishouEticketConsuming.value = true
+    kuaishouEticketResultError.value = ''
+
+    try {
+      const detail = kuaishouEticketDetailResult.value?.detail
+      const response = await consumeAdminKuaishouEticket({
+        baseUrl: kuaishouEticketForm.value.baseUrl.trim() || 'https://s.kwaixiaodian.com',
+        shopId: selected?.shopId.trim(),
+        cookie: selected?.cookie.trim(),
+        eTicketId: String(detail?.eTicketId || kuaishouEticketForm.value.eTicketId || '').trim(),
+        oid: String(detail?.oid || kuaishouEticketForm.value.oid || '').trim(),
+        formToken: String(detail?.formToken || kuaishouEticketForm.value.formToken || '').trim(),
+        num: Number(kuaishouEticketForm.value.num || 1),
+        storeId: kuaishouEticketForm.value.storeId.trim() || '0',
+      })
+      kuaishouEticketConsumeResult.value = response.data
+      showSuccess(response.data.ok ? '快手小店核销成功' : (response.data.errorMessage || '核销请求已执行'))
+    } catch (error) {
+      kuaishouEticketResultError.value = error instanceof Error ? error.message : '执行快手小店核销失败'
+      showError(kuaishouEticketResultError.value)
+    } finally {
+      kuaishouEticketConsuming.value = false
+    }
+  }
+
+  return {
+    kuaishouEticketFilePath,
+    kuaishouEticketShops,
+    expandedKuaishouEticketShopIds,
+    kuaishouEticketForm,
+    kuaishouEticketSaving,
+    kuaishouEticketResolvingShopId,
+    kuaishouEticketDetailing,
+    kuaishouEticketConsuming,
+    kuaishouEticketResultError,
+    kuaishouEticketShopInfoResult,
+    kuaishouEticketDetailResult,
+    kuaishouEticketConsumeResult,
+    activeKuaishouEticketShop,
+    kuaishouEticketStats,
+    hydrateKuaishouEticketConfig,
+    addKuaishouEticketShop,
+    removeKuaishouEticketShop,
+    isKuaishouEticketShopExpanded,
+    expandKuaishouEticketShop,
+    collapseKuaishouEticketShop,
+    toggleKuaishouEticketShop,
+    expandAllKuaishouEticketShops,
+    collapseAllKuaishouEticketShops,
+    setKuaishouEticketDebugShop,
+    describeKuaishouEticketShop,
+    getKuaishouEticketShopInitial,
+    handleKuaishouEticketResolveShopInfo,
+    handleKuaishouEticketSaveSource,
+    handleKuaishouEticketQueryDetail,
+    handleKuaishouEticketConsume,
+  }
+}
+
+function createEmptyKuaishouEticketShop(): EditableKuaishouEticketShop {
+  return {
+    id: crypto.randomUUID(),
+    shopId: '',
+    kshopName: '',
+    cookie: '',
+    userAvatar: '',
+    enabled: true,
+  }
+}
+
+function mapEditableKuaishouEticketShop(item: AdminKuaishouEticketShopConfigItem): EditableKuaishouEticketShop {
+  return {
+    id: crypto.randomUUID(),
+    shopId: item.shopId,
+    kshopName: item.kshopName,
+    cookie: item.cookie,
+    userAvatar: item.userAvatar,
+    enabled: item.enabled !== false,
+  }
+}
@@ -0,0 +1,117 @@
+import { computed, ref } from 'vue'
+
+import { showConfirm, showError, showSuccess } from '@/lib/feedback'
+import {
+  failAdminNinetyoneOrder,
+  fetchAdminNinetyoneOrders,
+  retryAdminNinetyoneOrder,
+} from '@/services/admin'
+import type { AdminNinetyoneOrderItem, AdminNinetyoneOrderListResult } from '@/types/admin'
+
+export function useAdminNinetyonePlatform() {
+  const ninetyoneLoading = ref(false)
+  const ninetyoneActionLoadingId = ref<number | null>(null)
+  const ninetyoneResultError = ref('')
+  const ninetyoneStatus = ref<'pending_config' | 'all' | 'manual_failed'>('pending_config')
+  const ninetyoneOrders = ref<AdminNinetyoneOrderListResult>({
+    page: 1,
+    pageSize: 20,
+    total: 0,
+    items: [],
+  })
+
+  const ninetyoneStats = computed(() => {
+    const pendingCount = ninetyoneOrders.value.items.filter((item) => item.orderStatus === 'pending_config').length
+    const failedCount = ninetyoneOrders.value.items.filter((item) => item.orderStatus === 'manual_failed').length
+    const taskReadyCount = ninetyoneOrders.value.items.filter((item) => item.taskCount > 0).length
+
+    return {
+      total: ninetyoneOrders.value.total,
+      currentCount: ninetyoneOrders.value.items.length,
+      pendingCount,
+      failedCount,
+      taskReadyCount,
+    }
+  })
+
+  async function loadNinetyoneOrders(page = 1) {
+    ninetyoneLoading.value = true
+    ninetyoneResultError.value = ''
+
+    try {
+      const response = await fetchAdminNinetyoneOrders({
+        page,
+        pageSize: ninetyoneOrders.value.pageSize || 20,
+        status: ninetyoneStatus.value,
+      })
+      ninetyoneOrders.value = response.data
+    } catch (error) {
+      ninetyoneResultError.value = error instanceof Error ? error.message : '91卡券订单读取失败'
+      showError(ninetyoneResultError.value)
+    } finally {
+      ninetyoneLoading.value = false
+    }
+  }
+
+  async function handleNinetyoneStatusChange(status: 'pending_config' | 'all' | 'manual_failed') {
+    ninetyoneStatus.value = status
+    await loadNinetyoneOrders(1)
+  }
+
+  async function handleNinetyoneRetryOrder(item: AdminNinetyoneOrderItem) {
+    ninetyoneActionLoadingId.value = item.orderId
+    ninetyoneResultError.value = ''
+
+    try {
+      const response = await retryAdminNinetyoneOrder(item.orderId)
+      showSuccess(`91卡券订单已重试，生成任务 ${response.data.taskCount} 个`)
+      await loadNinetyoneOrders(ninetyoneOrders.value.page || 1)
+    } catch (error) {
+      ninetyoneResultError.value = error instanceof Error ? error.message : '91卡券订单重试失败'
+      showError(ninetyoneResultError.value)
+    } finally {
+      ninetyoneActionLoadingId.value = null
+    }
+  }
+
+  async function handleNinetyoneFailOrder(item: AdminNinetyoneOrderItem) {
+    try {
+      await showConfirm(`确认把 91卡券订单 ${item.orderNo} 标记为无法履约吗？查询接口会返回失败状态。`, '确认标记失败', {
+        type: 'warning',
+        confirmButtonText: '标记失败',
+        cancelButtonText: '取消',
+      })
+    } catch {
+      return
+    }
+
+    ninetyoneActionLoadingId.value = item.orderId
+    ninetyoneResultError.value = ''
+
+    try {
+      await failAdminNinetyoneOrder(item.orderId, {
+        reason: '商家后台手动标记无法履约',
+      })
+      showSuccess('91卡券订单已标记失败')
+      await loadNinetyoneOrders(ninetyoneOrders.value.page || 1)
+    } catch (error) {
+      ninetyoneResultError.value = error instanceof Error ? error.message : '91卡券订单标记失败失败'
+      showError(ninetyoneResultError.value)
+    } finally {
+      ninetyoneActionLoadingId.value = null
+    }
+  }
+
+  return {
+    ninetyoneLoading,
+    ninetyoneActionLoadingId,
+    ninetyoneResultError,
+    ninetyoneStatus,
+    ninetyoneOrders,
+    ninetyoneStats,
+    loadNinetyoneOrders,
+    handleNinetyoneStatusChange,
+    handleNinetyoneRetryOrder,
+    handleNinetyoneFailOrder,
+  }
+}
@@ -0,0 +1,262 @@
+import { computed, ref } from 'vue'
+
+import { showError, showSuccess } from '@/lib/feedback'
+import {
+  runAdminScheduledJob,
+  saveAdminNotificationConfig,
+  saveAdminScheduledJobsConfig,
+  testAdminNotification,
+} from '@/services/admin'
+import type {
+  AdminNotificationConfig,
+  AdminNotificationTestResult,
+  AdminScheduledJobRuntimeState,
+  AdminScheduledJobsConfig,
+  AdminScheduledJobsResponse,
+} from '@/types/admin'
+
+import type { EditableNotificationRecipient, EditableScheduledJob } from './types'
+
+export function useAdminNotificationPlatform() {
+  const notificationFilePath = ref('')
+  const notificationForm = ref({
+    enabled: true,
+    barkEnabled: true,
+    barkServerUrl: 'https://api.day.app',
+    testTitle: '订单系统测试通知',
+    testBody: '这是一条 Bark 内部通知测试。',
+    testUrl: '',
+  })
+  const notificationRecipients = ref<EditableNotificationRecipient[]>([])
+  const notificationSaving = ref(false)
+  const notificationTesting = ref(false)
+  const notificationResultError = ref('')
+  const notificationTestResult = ref<AdminNotificationTestResult | null>(null)
+  const scheduledJobsFilePath = ref('')
+  const scheduledJobsForm = ref({
+    enabled: true,
+  })
+  const scheduledJobs = ref<EditableScheduledJob[]>([])
+  const scheduledJobRuntime = ref<AdminScheduledJobRuntimeState[]>([])
+  const scheduledJobsSaving = ref(false)
+  const scheduledJobRunningId = ref('')
+
+  const notificationStats = computed(() => {
+    const enabledRecipients = notificationRecipients.value.filter((item) => item.enabled && item.deviceKey.trim())
+
+    return {
+      configuredRecipientCount: notificationRecipients.value.length,
+      enabledRecipientCount: enabledRecipients.length,
+      barkReady: notificationForm.value.enabled && notificationForm.value.barkEnabled && enabledRecipients.length > 0,
+      lastSuccessCount: notificationTestResult.value?.successCount || 0,
+      lastFailedCount: notificationTestResult.value?.failedCount || 0,
+      scheduledJobEnabledCount: scheduledJobs.value.filter((item) => item.enabled).length,
+    }
+  })
+
+  function hydrateNotificationConfig(data: {
+    filePath: string
+    source: AdminNotificationConfig
+  }) {
+    notificationFilePath.value = data.filePath
+    notificationForm.value.enabled = data.source.enabled !== false
+    notificationForm.value.barkEnabled = data.source.channels.bark.enabled !== false
+    notificationForm.value.barkServerUrl = data.source.channels.bark.serverUrl || 'https://api.day.app'
+    notificationRecipients.value = data.source.channels.bark.recipients.map((item) => ({
+      id: item.id || crypto.randomUUID(),
+      name: item.name,
+      deviceKey: item.deviceKey,
+      enabled: item.enabled !== false,
+    }))
+  }
+
+  function hydrateScheduledJobsConfig(data: AdminScheduledJobsResponse) {
+    scheduledJobsFilePath.value = data.filePath
+    scheduledJobsForm.value.enabled = data.source.enabled !== false
+    scheduledJobs.value = data.source.jobs.map((item) => ({
+      id: item.id,
+      type: item.type,
+      enabled: item.enabled === true,
+      intervalSeconds: Number(item.intervalSeconds || 300),
+      intervalSecondsAmount: resolveTimeValue(Number(item.intervalSeconds || 300)).amount,
+      intervalSecondsUnit: resolveTimeValue(Number(item.intervalSeconds || 300)).unit,
+      cooldownSeconds: Number(item.cooldownSeconds || 1800),
+      cooldownSecondsAmount: resolveTimeValue(Number(item.cooldownSeconds || 1800)).amount,
+      cooldownSecondsUnit: resolveTimeValue(Number(item.cooldownSeconds || 1800)).unit,
+      assetThreshold: Number(item.config?.assetThreshold || 500),
+    }))
+    scheduledJobRuntime.value = data.runtime || []
+  }
+
+  function addNotificationRecipient() {
+    notificationRecipients.value.unshift({
+      id: crypto.randomUUID(),
+      name: '',
+      deviceKey: '',
+      enabled: true,
+    })
+  }
+
+  function removeNotificationRecipient(id: string) {
+    notificationRecipients.value = notificationRecipients.value.filter((item) => item.id !== id)
+  }
+
+  function buildNotificationConfigPayload(): AdminNotificationConfig {
+    return {
+      enabled: notificationForm.value.enabled,
+      channels: {
+        bark: {
+          enabled: notificationForm.value.barkEnabled,
+          serverUrl: notificationForm.value.barkServerUrl.trim() || 'https://api.day.app',
+          recipients: notificationRecipients.value.map((item) => ({
+            id: item.id,
+            name: item.name.trim(),
+            deviceKey: item.deviceKey.trim(),
+            deviceKeyMasked: '',
+            enabled: item.enabled,
+          })),
+        },
+      },
+    }
+  }
+
+  function buildScheduledJobsConfigPayload(): AdminScheduledJobsConfig {
+    return {
+      enabled: scheduledJobsForm.value.enabled,
+      jobs: scheduledJobs.value.map((item) => ({
+        id: item.id,
+        type: item.type,
+        enabled: item.enabled,
+        intervalSeconds: Number(item.intervalSeconds || 300),
+        cooldownSeconds: Number(item.cooldownSeconds || 1800),
+        config: {
+          assetThreshold: Number(item.assetThreshold || 500),
+        },
+      })),
+    }
+  }
+
+  async function handleNotificationSaveConfig() {
+    notificationSaving.value = true
+    notificationResultError.value = ''
+
+    try {
+      const response = await saveAdminNotificationConfig(buildNotificationConfigPayload())
+      notificationFilePath.value = response.data.filePath
+      hydrateNotificationConfig(response.data)
+      showSuccess('内部通知配置已保存')
+    } catch (error) {
+      notificationResultError.value = error instanceof Error ? error.message : '内部通知配置保存失败'
+      showError(notificationResultError.value)
+    } finally {
+      notificationSaving.value = false
+    }
+  }
+
+  async function handleNotificationTest() {
+    notificationTesting.value = true
+    notificationResultError.value = ''
+    notificationTestResult.value = null
+
+    try {
+      const saved = await saveAdminNotificationConfig(buildNotificationConfigPayload())
+      notificationFilePath.value = saved.data.filePath
+      hydrateNotificationConfig(saved.data)
+
+      const response = await testAdminNotification({
+        title: notificationForm.value.testTitle.trim(),
+        body: notificationForm.value.testBody.trim(),
+        url: notificationForm.value.testUrl.trim(),
+      })
+      notificationTestResult.value = response.data
+      if (response.data.successCount > 0) {
+        showSuccess(`内部通知测试完成，成功 ${response.data.successCount} 个`)
+      } else {
+        showError('内部通知测试未成功发送，请检查 Bark 配置')
+      }
+    } catch (error) {
+      notificationResultError.value = error instanceof Error ? error.message : '内部通知测试失败'
+      showError(notificationResultError.value)
+    } finally {
+      notificationTesting.value = false
+    }
+  }
+
+  async function handleScheduledJobsSaveConfig() {
+    scheduledJobsSaving.value = true
+    notificationResultError.value = ''
+
+    try {
+      const response = await saveAdminScheduledJobsConfig(buildScheduledJobsConfigPayload())
+      hydrateScheduledJobsConfig(response.data)
+      showSuccess('监控任务配置已保存')
+    } catch (error) {
+      notificationResultError.value = error instanceof Error ? error.message : '监控任务配置保存失败'
+      showError(notificationResultError.value)
+    } finally {
+      scheduledJobsSaving.value = false
+    }
+  }
+
+  async function handleScheduledJobRunNow(jobId: string) {
+    scheduledJobRunningId.value = jobId
+    notificationResultError.value = ''
+
+    try {
+      const saved = await saveAdminScheduledJobsConfig(buildScheduledJobsConfigPayload())
+      hydrateScheduledJobsConfig(saved.data)
+      const response = await runAdminScheduledJob(jobId)
+      scheduledJobRuntime.value = response.data.runtime || []
+      const message = String(response.data.result?.message || '监控任务已执行')
+      showSuccess(message)
+    } catch (error) {
+      notificationResultError.value = error instanceof Error ? error.message : '监控任务执行失败'
+      showError(notificationResultError.value)
+    } finally {
+      scheduledJobRunningId.value = ''
+    }
+  }
+
+  function getScheduledJobRuntime(jobId: string) {
+    return scheduledJobRuntime.value.find((item) => item.id === jobId) || null
+  }
+
+  function resolveTimeValue(seconds: number) {
+    const normalized = Math.max(0, Number(seconds || 0))
+    if (normalized >= 3600 && normalized % 3600 === 0) {
+      return { amount: normalized / 3600, unit: 3600 }
+    }
+
+    if (normalized >= 60 && normalized % 60 === 0) {
+      return { amount: normalized / 60, unit: 60 }
+    }
+
+    return { amount: normalized || 1, unit: 1 }
+  }
+
+  return {
+    notificationFilePath,
+    notificationForm,
+    notificationRecipients,
+    notificationSaving,
+    notificationTesting,
+    notificationResultError,
+    notificationTestResult,
+    scheduledJobsFilePath,
+    scheduledJobsForm,
+    scheduledJobs,
+    scheduledJobRuntime,
+    scheduledJobsSaving,
+    scheduledJobRunningId,
+    notificationStats,
+    hydrateNotificationConfig,
+    hydrateScheduledJobsConfig,
+    addNotificationRecipient,
+    removeNotificationRecipient,
+    handleNotificationSaveConfig,
+    handleNotificationTest,
+    handleScheduledJobsSaveConfig,
+    handleScheduledJobRunNow,
+    getScheduledJobRuntime,
+  }
+}
@@ -287,7 +287,7 @@ function resetFilters() {
 </template>

 <style scoped>
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .filter-grid {
  grid-template-columns: minmax(150px, 0.75fr) minmax(220px, 1fr) minmax(220px, 1fr) minmax(210px, 0.95fr);
@@ -206,7 +206,7 @@ onMounted(loadUsers)
 </template>

 <style scoped>
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .users-tools {
  display: grid;
@@ -233,7 +233,7 @@ onMounted(loadEvents)
 </template>

 <style scoped>
-@import '../../styles/admin-list-pages.css';
+@import '../../../styles/admin-list-pages.css';

 .filter-grid {
  grid-template-columns: repeat(4, minmax(0, 1fr));