@hyacine/vercount 0.0.1

package/README.md

@@ -0,0 +1,196 @@
+# @hyacine/vercount
+
+一个集成 Vercount 网站统计服务的 Hyacine 插件，是不蒜子 (Busuanzi) 的现代化替代方案。
+
+## 功能
+
+- 🚀 **极速响应**：服务器响应时间在 100ms 以内
+- 📊 **精准统计**：支持页面浏览量 (page_pv)、站点访问量 (site_pv) 和访客数 (site_uv)
+- 🔒 **安全可靠**：采用 POST 请求，杜绝 CSRF 攻击风险
+- 🌐 **全球 CDN**：Vercel 全球分发，99.99% 可用性
+- 🔄 **无缝迁移**：支持不蒜子数据自动迁移
+- ⚙️ **高度可定制**：可自定义显示内容、前缀后缀文本
+- 💻 **Runtime-only**：客户端加载，无需服务器端渲染
+
+## 关于 Vercount
+
+Vercount 是 [EvanNotFound](https://github.com/EvanNotFound) 开发的开源网站计数器服务，解决了不蒜子以下问题：
+
+- ❌ 速度慢，容易出现 502 错误
+- ❌ 使用过时的 Referrer 方法，移动端统计不准确
+- ❌ JSONP 回调存在安全隐患
+
+更多信息请访问：[vercount.one](https://vercount.one/)
+
+## 安装
+
+```bash
+bun add @hyacine/vercount
+```
+
+## 使用方法
+
+### 基础用法
+
+在 `hyacine.plugin.ts` 中配置：
+
+```typescript
+import vercount from "@hyacine/vercount";
+
+export default [vercount()];
+```
+
+这将使用默认配置，在 `post-footer` 注入点插入统计信息，显示格式为：
+
+```
+本文总阅读量 <数字> 次 | 本站总访问量 <数字> 次 | 本站总访客数 <数字> 人
+```
+
+### 自定义配置
+
+```typescript
+import vercount from "@hyacine/vercount";
+
+export default [
+  vercount({
+    // 只显示站点总访问量和访客数
+    showPagePV: false,
+    showSitePV: true,
+    showSiteUV: true,
+
+    // 自定义文本
+    sitePVPrefix: "访问量",
+    sitePVSuffix: "次",
+    siteUVPrefix: "访客数",
+    siteUVSuffix: "人",
+
+    // 使用自托管的 Vercount 实例
+    scriptUrl: "https://your-vercount-instance.com/js",
+  }),
+];
+```
+
+### 完整配置选项
+
+```typescript
+export interface VercountOptions {
+  /**
+   * 自定义 Vercount 脚本 URL
+   * @default "https://events.vercount.one/js"
+   */
+  scriptUrl?: string;
+
+  /**
+   * 是否显示页面浏览量
+   * @default true
+   */
+  showPagePV?: boolean;
+
+  /**
+   * 是否显示站点总访问量
+   * @default true
+   */
+  showSitePV?: boolean;
+
+  /**
+   * 是否显示站点总访客数
+   * @default true
+   */
+  showSiteUV?: boolean;
+
+  /**
+   * 页面浏览量的前缀文本
+   * @default "本文总阅读量"
+   */
+  pagePVPrefix?: string;
+
+  /**
+   * 页面浏览量的后缀文本
+   * @default "次"
+   */
+  pagePVSuffix?: string;
+
+  /**
+   * 站点总访问量的前缀文本
+   * @default "本站总访问量"
+   */
+  sitePVPrefix?: string;
+
+  /**
+   * 站点总访问量的后缀文本
+   * @default "次"
+   */
+  sitePVSuffix?: string;
+
+  /**
+   * 站点总访客数的前缀文本
+   * @default "本站总访客数"
+   */
+  siteUVPrefix?: string;
+
+  /**
+   * 站点总访客数的后缀文本
+   * @default "人"
+   */
+  siteUVSuffix?: string;
+}
+```
+
+## 注入点
+
+此插件默认将统计信息注入到 `post-footer` 注入点。如果你使用的主题或框架支持自定义注入点，请确保已定义 `post-footer` 注入点。
+
+## 统计方式
+
+- **页面浏览量 (page_pv)**：每访问一次加一
+- **站点访问量 (site_pv)**：所有页面的访问量总和
+- **独立访客量 (site_uv)**：通过用户的 UserAgent 和 IP 地址判断
+
+## 从不蒜子迁移
+
+Vercount 兼容不蒜子的数据格式，首次访问时会自动同步不蒜子的数据。你只需要：
+
+1. 使用此插件替换不蒜子
+2. 首次访问时数据会自动迁移
+3. 无需手动操作
+
+## 样式自定义
+
+插件生成的 HTML 结构：
+
+```html
+<div class="vercount-stats">
+  <span>本文总阅读量 <span id="vercount_value_page_pv">Loading</span> 次</span> |
+  <span>本站总访问量 <span id="vercount_value_site_pv">Loading</span> 次</span> |
+  <span>本站总访客数 <span id="vercount_value_site_uv">Loading</span> 人</span>
+</div>
+```
+
+你可以通过 CSS 自定义样式：
+
+```css
+.vercount-stats {
+  text-align: center;
+  font-size: 0.9em;
+  color: #666;
+  padding: 1em 0;
+}
+
+.vercount-stats span {
+  margin: 0 0.5em;
+}
+```
+
+## 数据管理
+
+如需编辑统计数据或验证域名，请访问 [vercount.one](https://vercount.one/) 进行操作。
+
+## 许可证
+
+MIT
+
+## 相关链接
+
+- [Vercount 官网](https://vercount.one/)
+- [Vercount GitHub](https://github.com/EvanNotFound/vercount)
+- [Hyacine Plugins](https://github.com/your-repo/hyacine-plugins)

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@hyacine/vercount",
+  "version": "0.0.1",
+  "description": "A Hyacine plugin that integrates Vercount website statistics - a modern alternative to Busuanzi",
+  "keywords": [
+    "analytics",
+    "busuanzi",
+    "counter",
+    "hyacine",
+    "plugin",
+    "statistics",
+    "vercount"
+  ],
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "bunx --bun oxlint --type-aware --type-check . --fix",
+    "format": "bunx oxfmt ."
+  },
+  "dependencies": {
+    "@hyacine/core": "workspace:*",
+    "@hyacine/helper": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  }
+}

package/src/index.ts

@@ -0,0 +1,91 @@
+import type { PluginManifest } from "@hyacine/core";
+
+export interface VercountOptions {
+  /**
+   * 自定义 Vercount 脚本 URL
+   * @default "https://events.vercount.one/js"
+   */
+  scriptUrl?: string;
+
+  /**
+   * 是否显示页面浏览量
+   * @default true
+   */
+  showPagePV?: boolean;
+
+  /**
+   * 是否显示站点总访问量
+   * @default true
+   */
+  showSitePV?: boolean;
+
+  /**
+   * 是否显示站点总访客数
+   * @default true
+   */
+  showSiteUV?: boolean;
+
+  /**
+   * 页面浏览量的前缀文本
+   * @default "本文总阅读量"
+   */
+  pagePVPrefix?: string;
+
+  /**
+   * 页面浏览量的后缀文本
+   * @default "次"
+   */
+  pagePVSuffix?: string;
+
+  /**
+   * 站点总访问量的前缀文本
+   * @default "本站总访问量"
+   */
+  sitePVPrefix?: string;
+
+  /**
+   * 站点总访问量的后缀文本
+   * @default "次"
+   */
+  sitePVSuffix?: string;
+
+  /**
+   * 站点总访客数的前缀文本
+   * @default "本站总访客数"
+   */
+  siteUVPrefix?: string;
+
+  /**
+   * 站点总访客数的后缀文本
+   * @default "人"
+   */
+  siteUVSuffix?: string;
+}
+
+export default (options: VercountOptions = {}): PluginManifest => {
+  return {
+    name: "@hyacine/vercount",
+    version: "0.0.1",
+    minRenderCapability: "runtime-only",
+    entry: [
+      {
+        type: "runtime-only",
+        injectPoint: "post-footer",
+        path: new URL("./runtime.ts", import.meta.url).href,
+        name: "vercount-runtime",
+        options: {
+          scriptUrl: options.scriptUrl || "https://events.vercount.one/js",
+          showPagePV: options.showPagePV !== false,
+          showSitePV: options.showSitePV !== false,
+          showSiteUV: options.showSiteUV !== false,
+          pagePVPrefix: options.pagePVPrefix || "本文总阅读量",
+          pagePVSuffix: options.pagePVSuffix || "次",
+          sitePVPrefix: options.sitePVPrefix || "本站总访问量",
+          sitePVSuffix: options.sitePVSuffix || "次",
+          siteUVPrefix: options.siteUVPrefix || "本站总访客数",
+          siteUVSuffix: options.siteUVSuffix || "人",
+        },
+      },
+    ],
+  };
+};

package/src/runtime.ts

@@ -0,0 +1,95 @@
+import type { PluginInitFunction } from "@hyacine/helper/runtime";
+import { getInjectPointSelector } from "@hyacine/helper/runtime";
+
+interface VercountRuntimeOptions {
+  scriptUrl: string;
+  showPagePV: boolean;
+  showSitePV: boolean;
+  showSiteUV: boolean;
+  pagePVPrefix: string;
+  pagePVSuffix: string;
+  sitePVPrefix: string;
+  sitePVSuffix: string;
+  siteUVPrefix: string;
+  siteUVSuffix: string;
+}
+
+/**
+ * 加载 Vercount 脚本
+ * @param scriptUrl Vercount 脚本 URL
+ * @returns Promise<void>
+ */
+function loadVercountScript(scriptUrl: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    // 检查脚本是否已加载
+    const existingScript = document.querySelector(`script[src="${scriptUrl}"]`);
+    if (existingScript) {
+      resolve();
+      return;
+    }
+
+    const script = document.createElement("script");
+    script.src = scriptUrl;
+    script.defer = true;
+
+    script.onload = () => resolve();
+    script.onerror = () => reject(new Error("Failed to load Vercount script"));
+
+    document.head.appendChild(script);
+  });
+}
+
+/**
+ * 创建统计元素的 HTML
+ * @param options VercountRuntimeOptions
+ * @returns HTML 字符串
+ */
+function createStatsHTML(options: VercountRuntimeOptions): string {
+  const parts: string[] = [];
+
+  if (options.showPagePV) {
+    parts.push(
+      `<span>${options.pagePVPrefix} <span id="vercount_value_page_pv">Loading</span> ${options.pagePVSuffix}</span>`,
+    );
+  }
+
+  if (options.showSitePV) {
+    parts.push(
+      `<span>${options.sitePVPrefix} <span id="vercount_value_site_pv">Loading</span> ${options.sitePVSuffix}</span>`,
+    );
+  }
+
+  if (options.showSiteUV) {
+    parts.push(
+      `<span>${options.siteUVPrefix} <span id="vercount_value_site_uv">Loading</span> ${options.siteUVSuffix}</span>`,
+    );
+  }
+
+  return parts.join(" | ");
+}
+
+export const init: PluginInitFunction<VercountRuntimeOptions> = async (options) => {
+  try {
+    // 加载 Vercount 脚本
+    await loadVercountScript(options.scriptUrl);
+
+    // 获取注入点元素
+    const selector = getInjectPointSelector("post-footer");
+    const targetElement = document.querySelector(selector);
+
+    if (!targetElement) {
+      console.warn(`[vercount] Inject point not found: ${selector}`);
+      return;
+    }
+
+    // 创建容器元素
+    const container = document.createElement("div");
+    container.className = "vercount-stats";
+    container.innerHTML = createStatsHTML(options);
+
+    // 插入到注入点
+    targetElement.appendChild(container);
+  } catch (error) {
+    console.error("[vercount] Failed to initialize:", error);
+  }
+};