Skip to content

SPEC.md

Latest commit

 

History

History
217 lines (162 loc) · 6.86 KB

SPEC.md

File metadata and controls

217 lines (162 loc) · 6.86 KB
Raw

HumanToken — 产品规格说明书

Version: 2.0（愿景版） 更新： 2026-06-08 状态： 规划中

一、背景与核心洞察

背景

2026年，AI 正在把一切信息处理Token化——OpenAI 按输入/输出 token 收费，DeepSeek 价格战，硅基流动打 API套餐。

但有一个问题：

AI 靠 Token 收费，凭什么人类说话免费？

人类说的每一句话，同样消耗了注意力、时间、专业知识、情感能量。在 AI 时代，这些"人类专属的东西"正在变得更稀缺、更值钱——因为 AI 越来越强，但人类判断、信任、情绪价值反而成了真正的稀缺资源。

核心洞察

AI 让什么贬值 AI 让什么增值
信息获取（搜一搜就有） 人类判断力（AI 需要人审核）
内容生产（AI 一键生成） 人类信任背书（人只信人）
标准答案（LLM 都能答） 人类情绪价值（安慰、鼓励、陪伴）
技能执行（Agent 替代） 专家关系网络（圈子、人脉）

HumanToken 的本质： 把人类说话这件事Token化，让人类意识到自己的话语、注意力、判断力是有价的。

二、产品愿景（双轨定位）

轨道 A：游戏化版本（当前 v1）

  • 定位： AI Token 经济学的认知教育工具 + 娱乐
  • 用户： 开发者、知识工作者、科技爱好者
  • 核心玩法： 每日话语额度、余额耗尽"断网"、角色费率差异化
  • 目标： GitHub Trending + 引发讨论

轨道 B：价值验证版本（规划 v2）

  • 定位： 人类 AI 协作质量认证平台
  • 用户： 企业采购 AI 服务、需要人类背书的场景
  • 核心玩法： AI 生成内容 + 人类专家签名验证 = 认证标记
  • 目标： 成为 AI 时代的"可信认证层"

两个轨道不矛盾。 轨道 A 负责传播和流量，轨道 B 是商业化出口。

三、现状评估（v1.5）

已完成功能 ✅

  • 说话扣费系统（按内容类型 + 角色倍率）
  • 余额耗尽"断网"交互
  • 成就系统（12 项成就）
  • 每日挑战（5 项挑战 +奖励）
  • 订阅会员体系（Free / Pro / VIP）
  • 排行榜
  • 角色自定义（添加/编辑/删除）
  • 深色/亮色模式切换
  • WebSocket 实时扣费（API 层）
  • JWT 认证 + 速率限制
  • localStorage 持久化
  • 单元测试（Vitest）
  • GitHub Pages 落地页

技术债务⚠️

  • 后端仅内存存储，无真实用户体系
  • 排行榜是 Mock 数据，无真实后端
  • 落地页（index.html）与产品功能脱节，缺乏产品愿景
  • 无移动端 App / PWA 支持
  • skills/ 目录包含大量 agent skills，定位模糊（可能是历史遗留）

四、落地页重设计（v2）

重新定位

落地页从"讽刺性演示"升级为"产品+愿景"双展示：

旧落地页：讲笑话 → 引流到 GitHub
新落地页：讲价值 → 引流到 App + 预告 v2

###落地页结构（4 屏）

第一屏：Hero — 灵魂拷问

"人类说的话，值多少？"

AI 时代，Token 是 AI 的货币。
但人类说话——消耗注意力、专业知识、情绪能量——凭什么免费？

HumanToken 将人类话语 Token化，
让你看清自己说话的真实成本。

第二屏：演示 — 3 秒理解产品

  • 输入框直接体验扣费
  • 实时显示：内容类型 + 费率 + 预估费用

第三屏：洞察 — 为什么这重要

  • AI 让信息贬值，人类判断力增值
  • 信息不值钱，判断力才值钱
  • 未来：人类签名 = AI 输出的信任背书

第四屏：路线图 — v2 预告

  • v2: 人类 AI 协作认证
  • 邀请专家验证 AI 生成内容，获得"Human Verified"标记
  • 企业采购 AI 服务时，有据可查

五、功能路线图

Phase 1: 增强娱乐性（1-2周）✅ 已完成

  • 声音反馈（发送消息时播放扣费音效）— Web Audio API 合成音效
  • 动画效果（余额变化、消息发送的微交互）— balance flash / msg slide-in / death shake
  • PWA 支持（可安装到桌面/手机）— manifest.json + service worker
  • 更多角色（设计师+80%、运营+60%、HR+40%）
  • 本地历史记录导出（CSV）

Phase 2: 社交化（1个月）✅ 已完成

  • 真实后端（sql.js SQLite，ESM 模块）
  • 用户注册/登录（JWT 认证 + 密码哈希）
  • 真实排行榜（按总消费排名，含个人排名）
  • 好友系统（互加、查看好友消费）
  • 挑战邀请（分享挑战给好友）
  • 房间系统（创建房间，多人同时扣费竞技）

Phase 3: 价值化（1-2个月）

  • "Human Verify" 功能
    • 用户提交 AI 生成的内容
    • 邀请专家朋友"签名验证"
    • 生成带时间戳+签名者+置信度的认证报告
  • API 开放（供其他产品接入 HumanToken 扣费系统）
  • 企业版（团队额度管理、管理员面板）
  • 内容市场（精彩发言/深度思考可被打赏）

Phase 4: 商业化（远期）

  • "Human Verified" 认证标志 NFT/徽章
  • 品牌合作（定制费率，如"程序员专属话语额度"）
  • 数据分析（个人话语报告、价值评估）
  • 与 intentguard 集成（AI 代码 +人类签名验证）

六、技术架构演进

当前（v1）

client/ (React 18 + TypeScript + Vite + TailwindCSS)
server/  (Express + in-memory)
shared/  (TypeScript config)

目标（v2）

packages/
  shared/       ← 类型定义、费率配置、工具函数
  client/       ← React 18 + TypeScript + Vite
  server/       ← Node.js + Express + SQLite（后期换 PostgreSQL）
  verify/       ← Human Verify验证模块（独立微服务）

部署：Vercel (前端) + Railway/Render (后端)

七、与现有项目的协同

项目 协同方式
intentguard AI 生成代码 + 人类签名认证 = 可信代码输出
crafttrace 人类手艺人 = 天然的"Human Token"持有者
aicourse 教师讲课Token化（声音+知识+情绪）= 教育价值量化
ai-pk-game 人类 vs AI 竞技场，人类参赛费 = Human Token

八、成功指标

v1 成功指标

  • GitHub Stars > 1000
  • 落地页日均 UV > 500
  • Reddit/HackerNews 引发讨论

v2 成功指标

  • 注册用户 > 10,000
  • 企业客户 > 10（认证服务付费）
  • "Human Verified" 标记被 > 50 个开源项目采用

九、优先级建议

本周行动项：

  1. 更新落地页（index.html）—— 4 屏结构 + 产品愿景 2.补齐 Phase 1 功能（PWA + 音效 + 动画）
  2. 创建 v2 路线图文档

一个月行动项： 4. 真实后端（SQLite 用户体系） 5. 真实排行榜 6. 社交功能

三个月行动项： 7. Human Verify 模块 8. API 开放 9. 企业版

本文件为产品规划文档，随项目进展更新。 最后更新：2026-06-08