cfe75ffb2b
- Added TarotSessionManager class to manage tarot reading sessions, including session creation, retrieval, reading addition, and cleanup of old sessions. - Defined various tarot spreads in a new spreads module, including single card, three card, Celtic cross, and more, with detailed descriptions and meanings for each position. - Created core types for tarot cards, readings, and sessions in a new types module to structure data effectively. - Configured TypeScript settings in tsconfig.json for improved development experience and compatibility.
187 lines
4.4 KiB
Markdown
187 lines
4.4 KiB
Markdown
# 📝 塔罗牌 MCP 服务器更新日志
|
||
|
||
## 🎯 版本 1.1.0 - 公平随机性更新 (2025-07-28)
|
||
|
||
### 🔄 重大改变：正位/逆位分布调整
|
||
|
||
#### 从 70/30 改为 50/50 分布
|
||
|
||
**之前 (70/30):**
|
||
- 正位牌：70% 概率
|
||
- 逆位牌：30% 概率
|
||
- 基于传统塔罗牌实践
|
||
|
||
**现在 (50/50):**
|
||
- 正位牌：50% 概率
|
||
- 逆位牌：50% 概率
|
||
- 完全公平的随机分布
|
||
|
||
#### 🎯 改变原因
|
||
|
||
1. **完全公正性**
|
||
- 每种方向有相等的概率
|
||
- 消除任何潜在的偏差
|
||
- 符合现代公平原则
|
||
|
||
2. **统计准确性**
|
||
- 更容易验证随机性
|
||
- 简化质量评估算法
|
||
- 便于长期统计分析
|
||
|
||
3. **用户反馈**
|
||
- 用户要求更公平的分布
|
||
- 避免过度倾向正位解读
|
||
- 提供更平衡的占卜体验
|
||
|
||
#### 🔧 技术实现
|
||
|
||
```typescript
|
||
// 之前的实现
|
||
private getSecureRandomOrientation(): CardOrientation {
|
||
const random = this.getSecureRandom();
|
||
return random < 0.7 ? "upright" : "reversed"; // 70% 正位
|
||
}
|
||
|
||
// 现在的实现
|
||
private getSecureRandomOrientation(): CardOrientation {
|
||
const random = this.getSecureRandom();
|
||
return random < 0.5 ? "upright" : "reversed"; // 50% 正位
|
||
}
|
||
```
|
||
|
||
#### 📊 验证工具更新
|
||
|
||
随机性验证工具 (`verify_randomness`) 已更新：
|
||
- 期望正位比例：从 ~70% 改为 ~50%
|
||
- 偏差计算：基于50%基准线
|
||
- 质量评分：调整评分算法
|
||
|
||
#### 🧪 测试结果
|
||
|
||
使用新的50/50分布进行测试：
|
||
- ✅ 统计分布更加均匀
|
||
- ✅ 验证工具正常工作
|
||
- ✅ 占卜结果更加平衡
|
||
- ✅ 加密级随机性保持不变
|
||
|
||
## 🔒 随机性保证系统 (版本 1.0.0)
|
||
|
||
### ✅ 已实现的功能
|
||
|
||
1. **加密级随机数生成**
|
||
- Web Crypto API / Node.js crypto 模块
|
||
- 操作系统级熵源
|
||
- 自动降级机制
|
||
|
||
2. **Fisher-Yates 洗牌算法**
|
||
- 数学证明的均匀分布
|
||
- O(n) 时间复杂度
|
||
- 无统计偏差
|
||
|
||
3. **13个专业工具**
|
||
- 基础塔罗牌工具 (4个)
|
||
- 专业牌阵工具 (4个)
|
||
- 高级分析工具 (5个)
|
||
|
||
4. **11种专业牌阵**
|
||
- 通用指导牌阵 (4种)
|
||
- 关系与个人牌阵 (3种)
|
||
- 事业与人生道路牌阵 (2种)
|
||
- 灵性与能量工作牌阵 (2种)
|
||
|
||
5. **随机性验证系统**
|
||
- Chi-square 统计检验
|
||
- 方向分布验证
|
||
- 性能指标分析
|
||
- 质量评分系统
|
||
|
||
## 🎯 使用指南
|
||
|
||
### 启动服务器
|
||
|
||
```bash
|
||
# HTTP 模式（推荐用于测试）
|
||
npm run start:http
|
||
|
||
# MCP 协议模式（用于 AI 客户端）
|
||
npm start
|
||
|
||
# 开发模式（带热重载）
|
||
npm run dev:http
|
||
```
|
||
|
||
### 验证随机性
|
||
|
||
```bash
|
||
# 验证50/50分布
|
||
curl -X POST http://localhost:3000/mcp \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"jsonrpc": "2.0",
|
||
"id": 1,
|
||
"method": "tools/call",
|
||
"params": {
|
||
"name": "verify_randomness",
|
||
"arguments": {
|
||
"testCount": 100,
|
||
"cardCount": 3
|
||
}
|
||
}
|
||
}'
|
||
```
|
||
|
||
### 测试占卜
|
||
|
||
```bash
|
||
# 三张牌占卜
|
||
curl -X POST http://localhost:3000/api/reading \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"spreadType": "three_card",
|
||
"question": "测试50/50分布"
|
||
}'
|
||
|
||
# 关系十字牌阵
|
||
curl -X POST http://localhost:3000/api/reading \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"spreadType": "relationship_cross",
|
||
"question": "如何改善我的人际关系？"
|
||
}'
|
||
```
|
||
|
||
## 📚 文档更新
|
||
|
||
- **RANDOMNESS.md**: 更新了50/50分布说明
|
||
- **README.md**: 更新了技术特性描述
|
||
- **SPREADS.md**: 完整的牌阵指南
|
||
- **CHANGELOG.md**: 本更新日志
|
||
|
||
## 🔮 质量保证
|
||
|
||
### 随机性质量标准
|
||
|
||
- **优秀级别 (90-100分)**: 完全符合50/50分布，统计偏差 < 5%
|
||
- **良好级别 (75-89分)**: 轻微偏差，可接受范围内
|
||
- **一般级别 (60-74分)**: 存在一些偏差，需要关注
|
||
- **差级别 (<60分)**: 显著偏差，需要调查
|
||
|
||
### 验证指标
|
||
|
||
1. **方向分布**: 正位/逆位比例接近50/50
|
||
2. **卡片分布**: Chi-square 检验确保均匀性
|
||
3. **性能指标**: 抽牌速度和算法效率
|
||
4. **熵值计算**: 真实随机性验证
|
||
|
||
## 🎉 总结
|
||
|
||
这次更新将塔罗牌方向分布从70/30调整为50/50，提供了：
|
||
|
||
- ✅ **完全公正的随机性**：每种方向概率相等
|
||
- ✅ **更好的统计特性**：便于验证和测试
|
||
- ✅ **现代化设计**：符合公平原则
|
||
- ✅ **保持专业品质**：加密级随机性不变
|
||
- ✅ **全面的验证工具**：确保质量可控
|
||
|
||
现在您的塔罗牌占卜系统提供了真正公正、统计学上可验证的随机性保证！🔮✨
|