feat: 文档页增加左侧目录导航与滚动高亮
This commit is contained in:
1 parent
3abeeb3580
commit
c0f75f69a6
1 file changed
+132
-10
@@ -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; }
|
||||
|
||||
Reference in new issue
Block a user