心算:静态站点统计新星

静态站点统计工具中,最受程序员欢迎的当数大名鼎鼎的不蒜子,不过不蒜子只提供了在线服务,并没有开放自建服务的能力,于是就有了心算。

心算作为新一代静态站点统计工具,设计上参考了前辈不蒜子,只是既支持在线服务接入,也支持自建服务;同时心算还支持hash路由和history路由模式的SPA站点的统计。

一、在线服务接入

心算在线服务接入方式参考了不蒜子,下面我们就详细说明心算在线服务的使用步骤。

(一) 安装依赖

npm i sinsuan

(二) 启动统计

import { bootstrap } from 'sinsuan'

// 启动统计
bootstrap();

上面的代码会开启页面统计功能,bootstrap函数未传入参数,意味着使用默认配置启动,那么要呈现数据,就需要在页面上声明承载数据的html节点,如下所示:

当前页面PV: <span data-sinsuan-pv></span>
当前页面UV: <span data-sinsuan-uv></span>
站点PV: <span data-sinsuan-site-pv></span>
站点UV: <span data-sinsuan-site-uv></span>

(三) bootstrap参数详解

bootstrap函数的参数类型如下:

/**
 * 配置信息
 */
export type SinSuanConfig = {
  /** 服务器接口地址 */
  serverUrl?: string;
  /** 传递ID值的请求头 */
  idHeaderKey?: string;
  /** 传递统计地址的请求头,由于需要支持单页形式的hash模式路由的请求和避免no-referer页面服务器无法获取Referer头的情况 */
  countUrlHeaderKey?: string;
  /** 用于存储信息的实例,可以由使用方实现,默认实现使用localStorage */
  storage?: Storage;
  /** 是否启用hash路由统计模式 */
  hashMode?: boolean;
  /** 是否启用history路由统计模式 */
  historyMode?: boolean;
  /** 当收到数据时要执行的处理 */
  onReceiveData?: OnReceiveDataHandler;
};

如上所示,我们常用的参数有:

  • serverUrl:当我们使用自建服务时,在启动的时候首先要配置的就是这个服务器地址,此地址使用全路径
  • hashMode:用于指定当页面hash变化的时候是否执行统计,默认值:false
  • historyMode:当通过history api改变url时是否统计,默认值:true
  • onReceiveData:自定义数据接收函数,请求后端接口并收到响应后触发,默认会将数据填入到页面上的填值占位符(如:<span data-sinsuan-pv></span>这样的节点)中

二、自建服务

(一)Linux系统

对于linux系统,可以直接下载sinsuan-x86_64-unknown-linux-musl-v0.1.0.zip资源包,解压并执行./sinsuan来启动服务。
解压后的目录结构:

├── sinsuan
└── Rocket.yaml

当我们执行./sinsuan命令后,会在当前目录中生成db.sqlite文件,这就是数据文件。
当然我们可以通过sqlite3命令行工具管理我们的数据。

如果希望更改服务监听的地址、数据库文件存放路径,以及数据库连接池调优,也可以通过修改Rocket.yaml文件来达到目的。

(二)其它操作系统

其它操作系统会稍微麻烦一点,我们需要安装rust环境,然后从github下载源码自行编译,这里就不详述了,有需要可以联系我(微信:iamyunsin)。

(三)项目集成

集成时,与在线服务模式的集成相似,仅仅需修改bootstrap函数的入参,将serverUrl改为您自己的服务地址即可。

import { bootstrap } from 'sinsuan'

// 启动统计
bootstrap({
  serverUrl: 'https://your.host/path/to/count'
});

结语

大家可以看到,心算的使用方式与不蒜子非常类似,只是有了更多选择空间。

欢迎大家使用,也欢迎大家给作者反馈意见、建议和问题,再次感谢您的耐心阅读,谢谢^_^

⚡ 站长自研 · 极客在线工具箱 (Rust + WebAssembly) 查看全部工具 →
🔥 爆款 · 视频转GIF 视频转 GIF 动图在线制作工作台(支持帧率调节、色彩量化压缩与无水印导出) 📸 逐帧截图 · 台词拼图 视频高清逐帧截图、批量抽帧提取与九宫格故事板/台词长图拼接器 🎞️ 格式转换 · 音频提取 本地视频格式转换、码率瘦身压缩与无损音频 (WAV) 一键提取工作台 🔒 100% 本地 · 隐私级 100% 本地隐私级 WebP / AVIF / PNG / JPEG 批量转换压缩与 EXIF 擦除工作台 🎭 表情包 · 拆帧倒放 GIF 动图拆帧提取、一键倒放、变速抽帧瘦身与表情包字幕合成工坊 🪪 证件照 · 精准控KB 隐私级证件照/考试报名照换底色、精准控制 KB 大小与六寸冲印排版器 🛡️ 证件防盗 · 纯本地 身份证/营业执照/房产证防盗用隐私平铺水印相机与正反面 A4 拼版工具 🎵 音频剪辑 · 铃声截取 纯本地可视化音频波形剪辑、淡入淡出、变速变调与手机铃声截取器 🏠 提前还贷 · 省息决策 房贷(商贷/公积金/组合贷)与提前还贷划算度决策计算器(缩短年限 vs 减少月供) 🚗 买车避坑 · 油电对比 购车全款落地价、4S店车贷费率转真实年化 (IRR) 与油车 vs 电车 5 年回本计算器 🔍 利率照妖镜 · 真实IRR 信用卡分期 / 网贷 / 融资租赁真实年化利率 (IRR) 照妖镜与砍头息穿透计算器 💰 个税筹划 · 年终奖盲区 薪资五险一金税后到手 & 年终奖个税“多发1元多交数千税”临界盲区筹划计算器 🛒 凑单退货 · 外卖拼单AA 电商大促凑单满减退货实付分摊 & 多人点外卖/聚餐红包运费公平 AA 计算器 📈 复利定投 · FIRE退休 复利定投收益、通胀购买力折现与 FIRE(4%法则提前退休/养老金)财务自由模拟器 🏁 永久活码 · 扫码识别 全能艺术二维码生成工坊(WiFi连接码/挪车码/名片码)与本地批量扫码解码器 🏷️ 电商仓储 · A4批量排印 电商/仓储条形码 (EAN-13 / Code128 / UPC-A) 批量生成、校验位计算与 A4 不干胶排版打印 📄 零上传PDF · 转长图/合成 100% 本地零上传 PDF 页面提取、PDF 转高清长图与多图排版合成 A4 PDF 工作台 ✍️ 透明签名 · 扫描件漂白 手写签名照一键抠出透明背景电子签名 (PNG/SVG) & 手机拍文档去黑底阴影漂白器 🖥️ 屏幕坏点 · 键鼠双击验机 显示器屏幕坏点/漏光/高刷帧率 (Hz) & 鼠标微动双击故障/键盘全键无冲在线验机台 🏮 亲戚称呼 · 人生900格 中国三姑六婆亲戚称呼计算器 & 精确周岁虚岁/节气星座/人生 900 个月格子可视化 🎨 自媒体 · 爆款排版 自媒体爆款社交分享卡片与金句排版生成工坊 💼 自由职业 · 商务单据 自由职业者极速隐私报价单、服务确认函与商业发票生成器 💳 跨境支付 · 汇损穿透 全球跨境支付渠道真实手续费、隐性汇损与到账净额精算器 📊 独立开发 · SaaS 沙盘 独立开发与 Micro-SaaS 核心单元经济学、现金流推演与并购估值沙盘 🔥 热门 · Rust Wasm 全球大模型 (LLM API) Token 分词可视化与成本对比计算器 🔄 全栈多语言 · 离线转换 全栈多语言类型与数据结构转换工场 (JSON / YAML / SQL DDL / cURL) 📱 移动开发 · 博客联动 App 唤醒 (DeepLink / Universal Links / App Links) 配置生成与扫码调试器 🛡️ 免连钱包 · 离线安全 多链 RPC 节点真实延迟测速 & 交易 Calldata / ABI 离线安全解码器 🧪 原理实验室 · Vue3 编译 Vue 3 编译三步曲 (Token → AST → PatchFlags & Block Tree) 交互式可视化器 🧪 原理实验室 · 事件循环 JavaScript 事件循环 (Event Loop) 全队列单步推演沙盒(光杆站长模型) 🧪 原理实验室 · 快速 Diff Vue 3 响应式依赖收集 (Track/Trigger) 与快速 Diff (最长递增子序列 LIS) 步进推演器 🧪 原理实验室 · HTTP/3 HTTP/2 (TCP) vs HTTP/3 (QUIC) 0-RTT 握手与丢包队头阻塞 (HoL) 对比模拟器