From 6bad39a7bad8ebbaffa38b72bb4604f51a65b6bf Mon Sep 17 00:00:00 2001
From: unknown <kate522@88.com>
Date: Tue, 14 Jul 2026 21:18:26 +0800
Subject: [PATCH] chore(admin): clarify download points purchase mode copy
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Rename residual 积分扣费/按次扣费 labels to 积分购买模式 and note cashier unlock; keep download_credit key for storage.
---
 assets/admin/src/pages/CmsCredits.vue                |  6 +++---
 .../src/pages/permissions/DownloadPermissions.vue    | 12 ++++++------
 .../schema/class-aksrt-admin-schema-permissions.php  |  4 ++--
 .../class-aksrt-settings-credits-payment-groups.php  |  2 +-
 .../class-aksrt-settings-credits-runtime.php         |  3 ++-
 5 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/assets/admin/src/pages/CmsCredits.vue b/assets/admin/src/pages/CmsCredits.vue
index 4fdcfd9a..8ec21397 100644
--- a/assets/admin/src/pages/CmsCredits.vue
+++ b/assets/admin/src/pages/CmsCredits.vue
@@ -89,12 +89,12 @@
     </n-card>
 
     <n-card class="aksrt-section-card">
-      <div class="aksrt-section-header"><h3>下载消费</h3></div>
+      <div class="aksrt-section-header"><h3>下载消费（参考）</h3></div>
       <n-form :model="cfg" label-placement="left" label-width="200" class="aksrt-form">
-        <n-form-item :label="`默认资源价格（${cfg.currency_name || '积分'}）`">
+        <n-form-item :label="`默认积分价参考（${cfg.currency_name || '积分'}）`">
           <n-input-number v-model:value="cfg.download_default_cost" :min="0" :max="100000" />
           <template #feedback>
-            <span class="aksrt-hint-text">资源未单独设价时回退使用。设为 0 表示免费</span>
+            <span class="aksrt-hint-text">兼容字段。实际价格以文章「付费内容设置」的积分价/现金价为准；下载解锁走收银台订单，不按次扣费。</span>
           </template>
         </n-form-item>
       </n-form>
diff --git a/assets/admin/src/pages/permissions/DownloadPermissions.vue b/assets/admin/src/pages/permissions/DownloadPermissions.vue
index 638cbae0..333b572d 100644
--- a/assets/admin/src/pages/permissions/DownloadPermissions.vue
+++ b/assets/admin/src/pages/permissions/DownloadPermissions.vue
@@ -2,7 +2,7 @@
   <div class="aksrt-page-container">
     <PageHeader
       title="下载权限"
-      desc="管理资源下载所需的登录、积分与验证码门槛，并查看当前默认下载成本。"
+      desc="管理资源下载的登录、积分购买模式与验证码门槛。付费解锁走收银台订单，下载 token 不再按次扣积分。"
     >
       <template #actions>
         <n-space>
@@ -22,12 +22,12 @@
             登录要求：{{ form.download_login ? '已启用' : '已关闭' }}
           </n-tag>
           <n-tag :type="form.download_credit ? 'warning' : 'default'" round>
-            积分扣费：{{ form.download_credit ? '已启用' : '已关闭' }}
+            积分购买模式：{{ form.download_credit ? '已启用' : '已关闭' }}
           </n-tag>
           <n-tag :type="form.download_captcha ? 'warning' : 'default'" round>
             下载验证码：{{ form.download_captcha ? '已启用' : '已关闭' }}
           </n-tag>
-          <n-tag type="info" round>默认下载积分：{{ defaultCost }}</n-tag>
+          <n-tag type="info" round>默认积分价参考：{{ defaultCost }}</n-tag>
           <n-tag type="info" round>Token TTL：10 分钟</n-tag>
         </n-space>
       </n-card>
@@ -44,10 +44,10 @@
             </template>
           </n-form-item>
 
-          <n-form-item label="下载启用积分扣费">
+          <n-form-item label="允许积分购买模式">
             <n-switch v-model:value="form.download_credit" />
             <template #feedback>
-              <span class="aksrt-hint-text">关闭后，资源价格将只作为展示信息，不会真正扣除积分。</span>
+              <span class="aksrt-hint-text">开启后，文章 pay_modo=积分 可走收银台一次购买解锁；下载 token 不再按次扣积分。关闭时积分模式资源按免费/需登录策略处理。</span>
             </template>
           </n-form-item>
 
@@ -62,7 +62,7 @@
 
       <n-card class="aksrt-section-card">
         <n-alert type="info" :show-icon="false">
-          默认下载积分仍由积分配置维护；本页只负责访问门槛。更完整的支付、VIP 与白名单策略将在 Phase 10 统一收口。
+          实际价格以文章「付费内容设置」为准；本页只维护全局访问门槛。VIP 白名单与收银台策略见「支付 &amp; 付费」相关页面。
         </n-alert>
       </n-card>
 
diff --git a/inc/classes/admin/schema/class-aksrt-admin-schema-permissions.php b/inc/classes/admin/schema/class-aksrt-admin-schema-permissions.php
index eb254028..459b9639 100644
--- a/inc/classes/admin/schema/class-aksrt-admin-schema-permissions.php
+++ b/inc/classes/admin/schema/class-aksrt-admin-schema-permissions.php
@@ -123,8 +123,8 @@ class AKSRT_Admin_Schema_Permissions {
                     'groups'     => [
                         ['key' => 'basic', 'title' => '下载设置', 'fields' => [
                             ['key' => 'download_require_login', 'label' => '下载需要登录', 'type' => 'switch', 'default' => true],
-                            ['key' => 'download_require_credits', 'label' => '下载需要积分', 'type' => 'switch', 'default' => false],
-                            ['key' => 'download_credits_cost', 'label' => '下载所需积分', 'type' => 'number', 'default' => 1, 'min' => 1, 'max' => 100],
+                            ['key' => 'download_require_credits', 'label' => '允许积分购买模式', 'type' => 'switch', 'default' => false, 'help' => '兼容字段；运行时以 cms_features.download_credit 为准。开启表示 pay_modo=积分 可收银台一次购买，不是按次扣费。'],
+                            ['key' => 'download_credits_cost', 'label' => '默认积分价参考', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100, 'help' => '仅运营参考/兼容；实际价格以文章付费设置为准。'],
                             ['key' => 'download_daily_limit', 'label' => '每日下载限制', 'type' => 'number', 'default' => 0, 'min' => 0, 'help' => '0为不限制'],
                             ['key' => 'download_link_expire', 'label' => '下载链接有效期(分钟)', 'type' => 'number', 'default' => 30, 'min' => 5, 'max' => 1440],
                             ['key' => 'download_speed_limit', 'label' => '下载速度限制(KB/s)', 'type' => 'number', 'default' => 0, 'min' => 0, 'help' => '0为不限制'],
diff --git a/inc/classes/settings/class-aksrt-settings-credits-payment-groups.php b/inc/classes/settings/class-aksrt-settings-credits-payment-groups.php
index 4a913b79..e2a09a79 100644
--- a/inc/classes/settings/class-aksrt-settings-credits-payment-groups.php
+++ b/inc/classes/settings/class-aksrt-settings-credits-payment-groups.php
@@ -62,7 +62,7 @@ trait AKSRT_Settings_Credits_Payment_Groups {
     }
 
     /**
-     * 积分功能是否启用（开关 + cms_features.download_credit 联合判定）。
+     * 积分功能是否启用（仅积分系统开关）。
      */
     public static function credits_enabled(): bool {
         return AKSRT_Settings_Credits_Runtime::credits_enabled();
diff --git a/inc/classes/settings/class-aksrt-settings-credits-runtime.php b/inc/classes/settings/class-aksrt-settings-credits-runtime.php
index 3298d657..84b1ec9e 100644
--- a/inc/classes/settings/class-aksrt-settings-credits-runtime.php
+++ b/inc/classes/settings/class-aksrt-settings-credits-runtime.php
@@ -204,7 +204,8 @@ class AKSRT_Settings_Credits_Runtime {
     }
 
     /**
-     * 积分功能是否启用（开关 + cms_features.download_credit 联合判定）。
+     * 积分功能是否启用。
+     * 仅看积分系统开关；不再与 cms_features.download_credit 联合（该开关表示积分购买模式，非按次扣费）。
      */
     public static function credits_enabled(): bool {
         $config = self::get_credit_settings();