AI Keyboard 设计文档

项目: Lenovo AI Keyboard
日期: 2026-03-04
状态: 设计阶段

一、硬件验证：磁轴参数可调性分析

1.1 磁轴硬件架构

┌─────────────────────────────────────┐
│           键帽 (Keycap)              │
├─────────────────────────────────────┤
│           轴心 (Stem)                │
│    ┌─────────────────────────┐      │
│    │   永磁体 (Magnet)       │      │
│    └─────────────────────────┘      │
├─────────────────────────────────────┤
│           弹簧 (Spring)              │
├─────────────────────────────────────┤
│    ┌─────────────────────────┐      │
│    │  霍尔传感器 (Hall Sensor)│      │
│    └─────────────────────────┘      │
├─────────────────────────────────────┤
│           PCB 主板                   │
│    ┌─────────────────────────┐      │
│    │   MCU + 算法处理器       │      │
│    └─────────────────────────┘      │
└─────────────────────────────────────┘

1.2 可调参数矩阵

参数	硬件层	软件层	实时可调	备注
触发点位置	❌	✅	✅	0.1-4.0mm，软件定义
复位点位置	❌	✅	✅	软件定义
触发力度	⚠️ 弹簧决定	⚠️ 有限调节	❌	需配合电磁铁才能软件调
回弹速度	⚠️ 弹簧决定	❌	❌	纯机械特性
段落感	❌ 磁轴无	⚠️ 模拟	✅	只能通过触觉反馈模拟
触底缓冲	⚠️ 需硅胶垫	❌	❌	硬件决定
采样率	✅ MCU 决定	✅	✅	1000-8000Hz
温漂补偿	❌	✅	✅	软件校准算法

1.3 硬件方案对比

方案 A：纯磁轴（成本优先）

成本：$40-60（整板）

可调参数：触发点、复位点、采样率

不可调：触发力、回弹速度、段落感

✅ 优点：成本低，成熟方案
❌ 缺点：算法能力受限，无法实现力度调节

方案 B：磁轴 + 触觉马达（体验优先）⭐ 推荐

成本：$80-120（整板）

可调参数：触发点、复位点、触觉反馈强度/模式

不可调：实际触发力

✅ 优点：可模拟段落感，用户感知明显
❌ 缺点：成本翻倍，功耗增加

方案 C：电磁轴（全可调，旗舰）

成本：$150-200（整板）

可调参数：全部（包括触发力）

✅ 优点：真正的软件定义键盘
❌ 缺点：成本高，功耗大，需要有线供电

            建议：Lenovo AI Keyboard 推荐方案 B（磁轴 + 触觉马达），零售价 $150-180，主打「智能自适应」而非「极客调参」。
        

二、用户测试矩阵

2.1 测试用户分组

组别	人数	特征	测试重点
A-程序员	20	日均打字 >3h，IDE 使用者	快捷键优化、疲劳保护
B-电竞	15	FPS/MOBA 玩家，日均游戏 >2h	Rapid Trigger、WASD 优化
C-作家	15	日均打字 >5h，纯文字	舒适度、段落感模拟
D-办公	20	混合使用，会议多	场景自动切换、静音模式
E-对照组	10	混合用户	使用默认配置，不启用 AI

2.2 测试流程

Week 1 基线期：Day 1-2 普通键盘基线，Day 3-5 AI Keyboard 默认配置，Day 6-7 初步反馈
Week 2-3 变量测试期：每 2 天切换变量组合，拉丁方设计避免顺序效应
Week 4 自由使用期：用户自选配置，观察长期行为

2.3 成功标准

指标	目标	最低接受
整体满意度	≥8.0/10	≥7.0/10
NPS	≥50	≥30
WPM 提升	≥5%	不下降
错误率	下降 ≥10%	不上升
疲劳评分	下降 ≥20%	下降 ≥10%
愿付价格	≥$150	≥$120

三、SDK 接口定义

3.1 架构概览

┌─────────────────────────────────────────────────────┐
│                   应用层 (Apps)                      │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐   │
│  │ 配置软件 │ │ 游戏插件 │ │ IDE 插件 │ │ 系统托盘 │   │
│  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘   │
├───────┴───────────┴───────────┴───────────┴────────┤
│                   SDK 层 (API)                       │
│  ┌─────────────────────────────────────────────┐   │
│  │           AI Keyboard SDK (C/Python/JS)      │   │
│  └─────────────────────┬───────────────────────┘   │
├─────────────────────────┴──────────────────────────┤
│                   驱动层 (Driver)                    │
├────────────────────────────────────────────────────┤
│                   固件层 (Firmware)                  │
└────────────────────────────────────────────────────┘

3.2 Python API 示例

from aikeyboard import AIKeyboard

kb = AIKeyboard()
kb.connect()

# 单键配置
kb.set_key(
    key='A',
    actuation=1.5,
    force_multiplier=0.75,  # 小指减压
    rapid_trigger=False
)

# 创建 Profile
kb.create_profile(
    name='Gaming',
    trigger_apps=['csgo.exe', 'valorant.exe'],
    keys={
        'WASD': {'actuation': 0.1, 'rapid_trigger': True},
        'Space': {'actuation': 0.3, 'force_multiplier': 1.2}
    }
)

# 启用自动切换
kb.auto_switch = True

# 疲劳检测
fatigue = kb.get_fatigue_status()
if fatigue.level > 0.7:
    print(f"建议休息: {fatigue.recommendation}")

3.3 SDK 发布计划

语言	优先级	发布时间	备注
C/C++	P0	硬件发布同步	核心 SDK
Python	P0	硬件发布同步	AI 开发者首选
JavaScript/Node	P1	+1 月	Web 配置工具
C#	P1	+1 月	Windows/Unity
Rust	P2	+3 月	高性能场景