它解决什么问题#

大型项目的工程规范通常包括功能规格（spec）、架构决策记录（ADR）、技术栈总览、设计令牌、开发提示词等几十份文档。一次性让 AI 全生成，往往因为上下文过长导致后半段质量下降、甚至遗漏关键项。

Harness Builder 的核心思路是增量式生成：

• 每轮只问一件事，回答后立即落盘对应文档
• 文档写完后，后续轮次无需重复记忆前面的细节
• 从根本上规避上下文窗口溢出带来的质量滑坡

工作流程#

整套流程分为两个阶段：

1
Phase 1  增量问答与生成
2
  Round 1  项目基础        → 技术栈 / CONTEXT / spec 骨架
3
  Round 2  技术选型        → 架构、依赖、部署形态
4
  Round 3  交互与体验      → 设计令牌、动效、无障碍规范
5
  ...      （逐轮推进，共 51 项规范清单）
6

7
Phase 2  生成开发提示词
8
  产出「提示词」文件夹，供后续分段开发使用

使用方式#

它被打包成一个标准 AI Skill，目录结构如下：

1
project-harness-builder/
2
├── SKILL.md            # Skill 主入口（工作流定义）
3
├── checklist.md        # 大项目规范完整清单（51 项）
4
└── spec-templates.md   # 各类规范的模板结构

触发方式也遵循 Skill 的语义约定，例如对 AI 说”构建项目规范""初始化 harness""搭建工程框架”，即会启动交互式问答流程。

适用与不适用#

项目已开源，欢迎前往 GitHub 仓库查看完整工作流与模板：

github.com/Znfooe/project-harness-builder

功能一览#

• 反应力测试：逐回合记录详细数据，量化你的反应速度
• 击杀时间测试：支持 2D / 3D 兼容模式与 Raw Input，贴近真实电竞环境
• 外观自定义：准星、目标、网格、开屏均可按个人习惯调整
• 账号体系：登录、成绩历史与排行榜（客户端侧）
• 多端构建：Flutter Web 与 Windows 桌面端

技术栈与环境#

1
Flutter 3.44.3
2
Dart    3.12.2
3
Windows 桌面构建需 Visual Studio 2022「使用 C++ 的桌面开发」

快速开始#

Web 端本地运行：

1
Set-Location .\frontend
2
flutter pub get
3
flutter run -d chrome

Windows 桌面端：

1
Set-Location .\frontend
2
flutter run -d windows --dart-define=API_BASE_URL=http://localhost:3000/api/v1

配置与安全#

客户端配置会被编译进应用（用户可读取），因此只允许放公开值：

1
API_BASE_URL
2
OAUTH_GITHUB_CLIENT_ID
3
OAUTH_GOOGLE_CLIENT_ID
4
SENTRY_DSN

项目使用 Apache License 2.0 开源，详情见仓库：

github.com/Znfooe/ReactionPro-Client

目标人群#

平台功能#

• 65+ 个交互式数学实验，覆盖极坐标曲线、三角函数、泰勒展开、线性代数、矩阵分解、PCA、蒙特卡洛、马尔可夫链、拉普拉斯变换、小波分析、黄金分割、博弈论等
• 参数实时调控：每个实验配滑块 + 数字输入框
• 坐标系智能锁定：调参时坐标系不动，曲线超出视野才自动扩大
• 全屏演示模式：图表撑满屏幕，内置可折叠参数面板，ESC 退出
• AI 语音讲解：双音色普通话旁白，随实验同步播放
• 防误触设计：全屏时滚轮不误缩放图表，适配课堂翻页笔

技术栈#

1
React 19 + TypeScript + Vite + Tailwind CSS + Plotly.js
2
后端：Express + LowDB（仅用于缺陷反馈收集，非核心）

快速开始#

1
# 1. 克隆仓库
2
git clone https://github.com/Znfooe/mathviz.git
3
cd mathviz
4

5
# 2. 安装全部依赖
6
npm run install:all
7

8
# 3. 启动开发环境（前端 5173 + 后端 3001）
9
npm run dev

构建生产版本：

1
cd client
2
npm run build   # 产物输出到 client/dist/

部署#

平台构建产物是纯静态网站，部署极其简单：将 web/ 目录上传到任意静态服务器（nginx、宝塔、Vercel、Netlify、GitHub Pages 均可），无需 Node.js、后端或数据库。

项目已开源，欢迎前往 GitHub 仓库查看完整文档：

github.com/Znfooe/mathviz