⚡ HookMeter (爆款引力计)

基于 TypeSafe JEV System 1 决策模型 · 击键级社交媒体文案爆款引力测速仪
Millisecond-level Viral Hook Telemetry & Copywriting Co-pilot for X / Twitter & Social Media.

---

🌟 为什么需要 HookMeter？（150字黄金引力法则）

在 X / Twitter、小红书、TikTok 等现代社交网络中，算法信息流的信息半衰期只有 1.2 秒。

• 残酷现实：99% 的读者在滑屏时，只会扫视帖子的前 150 个字（或前 2 行）。如果前 150 字没有制造出足够的信息差或情绪共鸣，后续无论写得多好，整条帖子都会沉底。
• 痛点：传统大模型（如 ChatGPT / Claude）对话式打分往往需要 5~10 秒，打断创作心流；或者只是空泛地回答“写得很好”。
• 解法：HookMeter 采用 TypeSafe JEV System 1 决策原语，将爆款评估直接嵌入浏览器输入框，在你敲下键盘的瞬间完成悬念指数、情绪能量与限流风险判定，并提供 10 字以内的即时修改处方！

---

✨ 核心特性

• 🏎️ 双模视觉呈现：
  • 极客转速表 (Cyber Tachometer)：赛博黑金、转速表动效、极客发帖仪式感。
  • 极简小清新 (Nordic Zen)：北欧纸墨质感、圆环进度条，轻盈不打扰。
• ⚡ 0ms 极速响应引擎：
  • Shadow DOM 物理样式隔离：绝不污染推特或宿主网页原生样式。
  • 中文输入法（IME）对齐：防抖锁定，避免拼音输入过程中的无效网络请求。
  • 底层 DOM 突变雷达 (MutationObserver)：无论打字、删除还是快捷键粘贴，0.1ms 内敏锐捕获。
  • 5ms 本地启发式瞬时预评 + 客户端 LRU 缓存：回退修改 0ms 即刻呈现。
• 🧠 JEV System 1 四维认知评估体系：
  • Score: 信息悬念指数 (curiosity_gap 1-5 阶梯)
  • Score: 情绪唤起能量 (emotional_arousal 1-5 阶梯)
  • Choice: 爆款心理学模式归类 (反直觉观点 / 高价值成果 / 紧迫痛点 / 故事叙事 / 平铺直叙)
  • Noul: 违规限流标题党预警 (内置“干货与真实技术论点”豁免条款，杜绝误杀)
• 💡 10 字极简调优锦囊：
  • 绝不仅做打分，直接给出即时处方（如：💡 缺少信息差，造个反常识悬念、🚨 结论说太满，建议加约束条件）。
• 🌐 零服务器云端部署：
  • 内置单文件 cloudflare_worker.js，0 元月租在全球边缘节点上线运行。

---

🏗️ 架构概览

flowchart LR
    A["Twitter / X / Web 输入框"] -->|"DOM 监听 & 输入法对齐"| B["Chrome Extension (Content Script)"]
    B -->|"0ms"| C["本地启发式即时预评 (Fast Estimate)"]
    B -->|"180ms 防抖"| D{"API 网关"}
    D -->|"本地开发"| E["server.py (FastAPI)"]
    D -->|"线上生产"| F["Cloudflare Worker (Edge)"]
    E -->|"System 1 原语"| G["TypeSafe JEV API (jev-latest)"]
    F -->|"System 1 原语"| G
    G -->|"Score / Choice / Noul"| B
    B -->|"Shadow DOM 渲染"| H["转速表 / 小清新 爆款徽章"]

---

🚀 快速上手

1. 安装 Chrome 扩展

1. 克隆或下载本项目到本地。
2. 打开 Chrome 浏览器，访问 chrome://extensions/。
3. 开启右上角的 「开发者模式」。
4. 点击 「加载已解压的扩展程序」，选择本项目中的 extension 文件夹。
5. 打开 Twitter / X，点击发帖框，即可看到 HookMeter 待命徽章！

---

2. 启动本地服务（开发与自测）

环境准备

# 1. 克隆代码
git clone https://github.com/your-username/HookMeter.git
cd HookMeter

# 2. 安装依赖
pip install -r requirements.txt

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env，填入你的 TYPESAFE_API_KEY

启动后台

python server.py
# 服务将运行在 http://127.0.0.1:8000

打开浏览器访问 http://127.0.0.1:8000 即可体验独立的 Web 赛车转速表沙箱！

---

3. 一键部署生产级 Serverless 网关（开箱即用，0 服务器）

如果你希望将 HookMeter 分享给全世界的创作者，无需租用服务器：

1. 注册并登录 Cloudflare Dashboard -> Workers & Pages -> Create Application.
2. 将 cloudflare_worker.js 的全部代码复制粘贴进编辑器。
3. 在 Worker 的 Settings -> Variables and Secrets 中添加：
   • 变量名：TYPESAFE_API_KEY
   • 变量值：你的 JEV API 密钥
4. 点击 Deploy，获得专属于你的全球边缘 API 端点（例如 https://hookmeter-api.your-subdomain.workers.dev/api/analyze）。
5. 在 Chrome 扩展中将该端点配置为默认值，普通用户安装即可免 Key 直接使用！

---

📁 项目目录结构

HookMeter/
├── extension/                     # Chrome 扩展程序 (Manifest V3)
│   ├── manifest.json              # 扩展配置文件
│   ├── content.js                 # 核心交互 (Shadow DOM + IME + MutationObserver)
│   ├── content.css                # 样式支持
│   ├── popup.html                 # 商业级极简设置弹窗
│   ├── popup.js                   # 状态探活与设置逻辑
│   └── icons/                     # 16 / 48 / 128 像素图标
├── web/                           # 独立 Web 沙箱游乐场
│   └── index.html                 # 赛车仪表盘与小清新 Web 体验页
├── cloudflare_worker.js           # 生产级 Serverless 边缘网关 (单文件部署)
├── hookmeter_engine.py            # JEV System 1 决策算法评估内核
├── server.py                      # FastAPI 本地调试与代理服务
├── package_extension.py           # 自动化打包发布脚本
├── requirements.txt               # Python 依赖清单
├── .env.example                   # 环境变量示例模版
├── .gitignore                     # Git 忽略配置 (严防秘钥泄露)
└── LICENSE                        # MIT 开源许可证

---

🤝 参与贡献

欢迎提交 Issue 和 Pull Request！

• 如有灵感或优化建议，请随时发起讨论。
• 遵循开源社区公约，友善交流。

---

📄 开源许可证

本项目基于 MIT 许可证 开源。