【工具推荐】纯前端字数统计工具 WordCountIt 的设计与使用
1. 背景与痛点
在撰写技术博客、README 文档、API 接口说明或学术论文时，我们常常需要精确控制文本的字数、字符数（含/不含空格）、段落数以及可读性指标。同时，随着大语言模型（LLM）的普及，调用 API 前预估Token 消耗量也成为一项刚需。
现有在线统计工具往往存在以下问题：
文本内容被上传至服务器，存在隐私泄露风险；
对中文、日文、韩文（CJK）等双字节字符支持不佳，计数结果偏差较大；
需要注册或付费，使用流程繁琐；
缺乏 Token 估算、关键词密度等进阶功能。
为解决上述问题，我们开发了一款完全运行于浏览器本地的统计工具 —— WordCountIt。本文将从技术实现角度，介绍其核心功能、算法原理和使用方式。
2. 技术架构与隐私保护
2.1 纯本地运算
WordCountIt 采用零服务端架构，所有文本处理、统计计算均在用户的浏览器中完成。页面加载后，不会向任何服务器发送网络请求（除静态资源加载外），确保用户数据0 bytes离开本地。
2.2 性能优化
统计逻辑使用原生 JavaScript 实现，并借助requestAnimationFrame或setTimeout分片处理大文本，避免阻塞 UI 主线程。实测单次统计响应时间在 150ms 以内（视文本长度略有浮动），实现实时反馈。
3. 核心功能与技术实现
3.1 基础统计项
| 统计项 | 实现要点 |
|---|---|
| 字数（Word Count） | 按 Unicode 空白字符分割，过滤空串；对英文按空格分隔，对 CJK 按单个字符计数（混合文本适当调整） |
| 字符数（含/不含空格） | 直接计算字符串长度；不含空格时过滤\s及零宽字符 |
| 句子数 | 以.、！、？、;等句子终止符分割，需处理缩写词（如 Dr.）等边界情况，当前版本采用正则表达式基础分割，后续可引入 NLP 增强 |
| 段落数 | 按连续换行符\n\n或\r\n\r\n分割，过滤空段落 |
3.2 CJK 字符专项支持
针对中文、日文、韩文等双字节字符，我们使用 Unicode 范围判定（如\u4E00-\u9FFF等），确保每个汉字/假名/谚文字符被正确计为1 个字符，与英文单词分开统计。此逻辑在wordCount与charCount中均有适配。
3.3 可读性评分（Flesch-Kincaid Grade Level）
采用经典的Flesch-Kincaid 年级水平公式：
Score = 0.39 * (总单词数 / 总句子数) + 11.8 * (总音节数 / 总单词数) - 15.59
其中音节数通过启发式规则估算（基于单词中元音组合），对于英文文本有较好参考价值。对于中文文本，该评分仅供参考，未来可引入中文可读性指标（如基于笔画数或常见字频率）。
3.4 关键词密度
统计每个单词（或连续短语）在文本中出现的频率，计算公式：
密度 = (出现次数 / 总单词数) * 100%
用户可自定义最小词长，过滤常见停用词，用于 SEO 优化或主题聚焦分析。
3.5 AI Token 估算
支持OpenAI 的 cl100k_base编码方式，也兼容p50k_base和r50k_base等主流 Tokenizer。实现原理是在前端加载轻量级 BPE 分词表（压缩后约 1.2MB），通过在线程中执行编码估算。若无网络，也可回退至字符级近似估算（约 1 Token ≈ 4 字符英文或 1.5 汉字）。该功能帮助开发者预估 API 调用成本。
4. 使用指南
4.1 快速开始
访问 WordCounter Tools — Free Online Word Counter & Text Analysis
在文本框中输入或粘贴待统计内容
右侧面板实时更新所有统计数值
可切换界面语言（支持中、英、日、韩）
4.2 适用场景
撰写技术博客时，控制标题（≤ 80 字符）和摘要长度
编写 API 文档或 README，确保可读性得分不低于 60（较易读）
SEO 内容优化，检查 Meta Description（约 160 字符）及关键词密度（建议 2%~5%）
使用 LLM 前，快速估算输入 Token，控制成本
学术论文定稿前，确认字数满足期刊要求（不含空格字数）
4.3 数据隐私说明
由于所有计算均在本地完成，您的文本不会被上传、存储或分享。可放心处理敏感内容（如内部代码片段、未公开技术方案）。
5. 开源与扩展
项目目前以 Web 应用形式提供，代码未完全开源，但核心统计算法可参照以下伪代码：
javascript
function countWords(text) { // 处理 CJK 混合文本 const normalized = text.normalize('NFC'); const words = normalized.match(/[\w\u4E00-\u9FFF\uAC00-\uD7AF\u3040-\u30FF]+/g) || []; return words.length; } function countSentences(text) { const sentenceEnders = /[。！？.!?;；]+/g; const parts = text.split(sentenceEnders).filter(s => s.trim().length > 0); return parts.length; }如果您希望集成类似功能到自己的项目中，可参考上述逻辑进行封装。
6. 后续规划
增加阅读时间估算（基于平均阅读速度）
支持Markdown格式的统计（忽略标记符号）
提供Chrome 扩展，方便在编辑器中直接调用
7. 总结
WordCountIt 是一款轻量、安全、功能丰富的纯前端字数统计工具，尤其适合技术写作和 API 成本预估场景。它既解决了隐私担忧，又覆盖了从基础计数到进阶可读性、Token 估算的完整需求链。欢迎有类似需求的开发者试用，并期待您的反馈。
项目地址：WordCounter Tools — Free Online Word Counter & Text Analysis
（注：无需注册，完全免费）
本文仅作技术分享，旨在提供一种本地化文本统计的解决方案。