feat: 文档页增加左侧目录导航与滚动高亮

This commit is contained in:
root committed 2026-10-12 00:29:19 +08:00
1 parent 3abeeb3580
commit c0f75f69a6
1 file changed
+132 -10
+132 -10
View File
@@ -28,8 +28,25 @@
<p class="hero-desc">轻量级<b>卡密(激活码)+ 机器授权</b>解决方案 · 多项目管理 · 代理分销 · 在线支付 · API 对接</p>
</div>
<div class="docs-grid">
<div class="docs-card">
<div class="docs-layout">
<!-- 左侧锚点导航 -->
<aside class="docs-nav" aria-label="文档目录">
<div class="docs-nav-title">目录导航</div>
<nav>
<a
v-for="item in navItems"
:key="item.id"
class="docs-nav-item"
:class="{ active: activeSection === item.id }"
:href="'#/' + item.id"
@click.prevent="scrollTo(item.id)"
>{{ item.label }}</a>
</nav>
</aside>
<!-- 右侧内容 -->
<div class="docs-grid">
<div class="docs-card" id="sec-intro">
<div class="docs-card-head"><span>系统介绍</span></div>
<p>CardAuth 是一套轻量级的<b>卡密(激活码)+ 机器授权管理系统</b>,提供多项目管理、卡密生成与分销、代理体系、在线支付购买及授权验证 API。适用于软件授权、机器人授权等场景。</p>
<ul>
@@ -45,7 +62,7 @@
</ul>
</div>
<div class="docs-card">
<div class="docs-card" id="sec-buy">
<div class="docs-card-head"><span>购买与激活流程</span></div>
<ol>
<li><b>购买授权</b>:在<b>购买中心</b>选择项目与商品,支付宝/微信付款后系统即时发放卡密</li>
@@ -56,7 +73,7 @@
<p class="docs-tip">卡密未使用前不限期有效;一旦绑定,有效期自激活时开始计算。请妥善保管卡密,谨防泄露。</p>
</div>
<div class="docs-card docs-card-wide">
<div class="docs-card docs-card-wide" id="sec-agent">
<div class="docs-card-head"><span>代理 / 分销使用详解</span></div>
<p>代理体系适合渠道商、分销商:向平台按<b>代理价</b>采购卡密或创建授权,再以自定零售价转售给终端客户,赚取差价。代理使用<b>额度余额</b>结算,不直接走在线支付。</p>
@@ -132,7 +149,7 @@
<p class="docs-tip">成为代理前请确认套餐已配置「代理价格」;注册账号一般需管理员在用户管理中审核/启用。</p>
</div>
<div class="docs-card">
<div class="docs-card" id="sec-autocard">
<div class="docs-card-head"><span>自动发卡(App/IPTV 直购)</span></div>
<p>支付成功后系统自动完成发卡,适合电视端 / App 内直接购买、无需人工发卡的场景。</p>
<ol>
@@ -154,7 +171,7 @@
</ul>
</div>
<div class="docs-card">
<div class="docs-card" id="sec-install">
<div class="docs-card-head"><span>安装统计与版本推送</span></div>
<p>系统支持统计项目被安装次数、区分存活/已删除、记录最后上线时间,并可向客户端推送最新安装包(支持强制更新提示)。</p>
<ul>
@@ -176,7 +193,7 @@
<p class="docs-tip">强制推送仅影响客户端更新提示,不会让旧版本卡密验证失败。若需彻底停用旧版本,请在卡密/授权侧处理。</p>
</div>
<div class="docs-card docs-card-wide">
<div class="docs-card docs-card-wide" id="sec-api">
<div class="docs-card-head"><span>开发者对接(API)</span></div>
<h4 class="docs-sub">1. 鉴权方式</h4>
@@ -358,7 +375,7 @@ curl -X POST https://你的域名/api/public/installations/heartbeat \
<p class="doc-note"><b>对接建议:</b>软件启动时调用 verify 或 check-update;将 remaining_days / update_available 缓存本地并在需要时提示续费或更新;付款回调由系统处理,客户端只需轮询 orders/query。</p>
</div>
<div class="docs-card">
<div class="docs-card" id="sec-faq">
<div class="docs-card-head"><span>常见问题</span></div>
<ul>
<li><b>付款后没有收到卡密?</b>在购买中心用订单号查询;App/IPTV 订单支付成功后会自动发卡(见「自动发卡」);超过 15 分钟未支付订单自动作废。</li>
@@ -370,7 +387,8 @@ curl -X POST https://你的域名/api/public/installations/heartbeat \
<li><b>如何成为代理?</b>点击顶部 <router-link to="/agent/login" class="docs-link">代理登录</router-link>,注册后审核通过即可在额度内采购卡密;也可直接访问 <code>/agent/login</code>。详见上方「代理 / 分销使用详解」。</li>
</ul>
</div>
</div>
</div><!-- /docs-grid -->
</div><!-- /docs-layout -->
<div class="docs-cta">
<router-link to="/shop" class="cta-btn">立即购买 / 查看商品</router-link>
@@ -384,7 +402,50 @@ curl -X POST https://你的域名/api/public/installations/heartbeat \
</template>
<script setup>
import { ref, onMounted, onUnmounted } from 'vue'
const year = new Date().getFullYear()
const navItems = [
{ id: 'sec-intro', label: '系统介绍' },
{ id: 'sec-buy', label: '购买与激活' },
{ id: 'sec-agent', label: '代理 / 分销' },
{ id: 'sec-autocard', label: '自动发卡' },
{ id: 'sec-install', label: '安装统计与版本推送' },
{ id: 'sec-api', label: '开发者对接 API' },
{ id: 'sec-faq', label: '常见问题' },
]
const activeSection = ref('sec-intro')
function scrollTo(id) {
const el = document.getElementById(id)
if (!el) return
activeSection.value = id
const top = el.getBoundingClientRect().top + window.scrollY - 20
window.scrollTo({ top, behavior: 'smooth' })
}
function onScroll() {
let current = navItems[0].id
for (const item of navItems) {
const el = document.getElementById(item.id)
if (!el) continue
if (el.getBoundingClientRect().top <= 120) {
current = item.id
}
}
activeSection.value = current
}
onMounted(() => {
window.addEventListener('scroll', onScroll, { passive: true })
onScroll()
})
onUnmounted(() => {
window.removeEventListener('scroll', onScroll)
})
</script>
<style scoped>
@@ -427,12 +488,58 @@ const year = new Date().getFullYear()
.btn-ghost:hover { background: rgba(115,103,240,.08); }
/* 文档主体 */
.docs-wrap { position: relative; z-index: 1; max-width: 1100px; margin: 0 auto; padding: 18px 24px 40px; }
.docs-wrap { position: relative; z-index: 1; max-width: 1240px; margin: 0 auto; padding: 18px 24px 40px; }
.docs-hero { text-align: center; padding: 26px 0 30px; }
.hero-title { font-size: 34px; font-weight: 800; margin: 0 0 12px; color: #2d2b45; letter-spacing: 1px; }
.hero-desc { font-size: 15px; color: #5f6580; margin: 0; }
.hero-desc b { color: #6758e8; }
.docs-layout {
display: grid;
grid-template-columns: 200px minmax(0, 1fr);
gap: 20px;
align-items: start;
}
.docs-nav {
position: sticky;
top: 20px;
background: rgba(255,255,255,.82);
backdrop-filter: blur(14px);
border: 1px solid rgba(255,255,255,.9);
border-radius: 16px;
padding: 16px 12px;
box-shadow: 0 8px 30px rgba(102,126,234,.10);
}
.docs-nav-title {
font-size: 13px;
font-weight: 700;
color: #2d2b45;
padding: 0 8px 10px;
border-bottom: 1px solid rgba(115,103,240,.12);
margin-bottom: 8px;
}
.docs-nav-item {
display: block;
padding: 8px 10px;
margin: 2px 0;
border-radius: 8px;
font-size: 13px;
color: #5f6580;
text-decoration: none;
line-height: 1.4;
transition: all .15s ease;
}
.docs-nav-item:hover {
background: rgba(115,103,240,.08);
color: #6758e8;
}
.docs-nav-item.active {
background: linear-gradient(135deg, rgba(115,103,240,.14), rgba(157,103,255,.14));
color: #5b4fd0;
font-weight: 600;
}
.docs-card { scroll-margin-top: 24px; }
.docs-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 18px; }
.docs-card {
background: rgba(255,255,255,.78);
@@ -487,6 +594,21 @@ const year = new Date().getFullYear()
.docs-footer { position: relative; z-index: 1; text-align: center; padding: 20px; color: #9aa0b5; font-size: 12.5px; }
@media (max-width: 960px) {
.docs-layout { grid-template-columns: 1fr; }
.docs-nav {
position: relative;
top: 0;
display: flex;
flex-wrap: wrap;
gap: 6px;
padding: 12px;
align-items: center;
}
.docs-nav-title { border: none; padding: 0 6px 0 0; margin: 0; }
.docs-nav nav { display: flex; flex-wrap: wrap; gap: 6px; }
.docs-nav-item { padding: 6px 10px; background: rgba(115,103,240,.06); font-size: 12px; }
}
@media (max-width: 860px) {
.docs-grid { grid-template-columns: 1fr; }
.hero-title { font-size: 26px; }