soultrace

SoulTrace 性格评估

通过 soultrace API 进行自适应性格评估。回答 24 个问题（1-7 分李克特量表），根据五色心理模型获得你的性格原型。

API 端点

POST https://soultrace.app/api/agent

无需认证。每个 IP 每小时限 100 次请求。

工作原理

API 是无状态的。每次请求时传递所有已积累的答案，服务器重放贝叶斯推理以选择下一个最优问题。

第一步：开始测试

发送空 answers 数组以获取第一个问题：

curl -X POST https://soultrace.app/api/agent \
  -H "Content-Type: application/json" \
  -d '{"answers": []}'

响应：

{
  "status": "in_progress",
  "question": {
    "id": 42,
    "text": "我能在掌握复杂系统中找到深深的满足感。"
  },
  "currentDistribution": {
    "white": 0.2,
    "blue": 0.2,
    "black": 0.2,
    "red": 0.2,
    "green": 0.2
  },
  "entropy": 2.322,
  "progress": { "answered": 0, "total": 24 }
}

第二步：回答问题

用户按 1-7 分回答每个问题：

• 1 = 非常不同意
• 4 = 中立
• 7 = 非常同意

附加答案并发送到目前为止的所有答案：

curl -X POST https://soultrace.app/api/agent \
  -H "Content-Type: application/json" \
  -d '{"answers": [{"questionId": 42, "score": 6}]}'

持续积累答案。每个响应都会给出下一个问题。

第三步：获取结果

回答完 24 个问题后，响应会自动返回最终结果：

{
  "status": "complete",
  "resultId": "abc-123-def",
  "resultUrl": "https://soultrace.app/en/results/abc-123-def",
  "distribution": {
    "white": 0.15,
    "blue": 0.35,
    "black": 0.25,
    "red": 0.10,
    "green": 0.15
  },
  "entropy": 1.89,
  "archetype": {
    "key": "blue-black",
    "name": "策略家",
    "alignmentScore": 87.3,
    "coreDynamic": "...",
    "strengths": ["..."],
    "weaknesses": ["..."]
  },
  "topMatches": [
    { "key": "blue-black", "name": "策略家", "alignmentScore": 87.3 },
    { "key": "blue", "name": "理性主义者", "alignmentScore": 82.1 },
    { "key": "black-blue", "name": "执行者", "alignmentScore": 78.5 }
  ],
  "shadowColors": [
    { "color": "red", "score": 0.10 },
    { "color": "green", "score": 0.15 }
  ],
  "progress": { "answered": 24, "total": 24 }
}

代理交互协议

当用户要求进行性格测试时：

1. 开始：使用 {"answers": []} 调用 API。
2. 呈现：清晰地向用户展示每个问题。告知他们按 1-7 分回答（1=非常不同意，4=中立，7=非常同意）。
3. 收集：用户的数字答案（1-7）。如果给出非数字或描述性答案，将其映射到量表：
   • "非常不同意" / "完全不" → 1
   • "不同意" / "不太" → 2
   • "有点不同意" → 3
   • "中立" / "也许" / "有时" → 4
   • "有点同意" → 5
   • "同意" / "是" → 6
   • "非常同意" / "绝对" → 7
4. 积累：每次发送所有之前的答案以及新答案。
5. 24 个问题后：呈现结果，包括：
   • 他们的原型名称和匹配度分数
   • 他们的颜色分布（以百分比显示）
   • 他们的前 3 个原型匹配
   • 完整结果页面的链接
6. 绝不跳过问题或代表用户自动回答。

评分量表

分数	含义
1	非常不同意
2	不同意
3	有点不同意
4	中立
5	有点同意
6	同意
7	非常同意

五种颜色

颜色	驱动力	本质
白色	结构、公平	秩序、责任
蓝色	理解、精通	好奇心、精确
黑色	自主、成就	野心、策略
红色	强度、表达	激情、诚实
绿色	连接、成长	归属感、耐心

速率限制

• 每个 IP 每小时 100 次请求
• 每次测试需要 25 次请求（1 次开始 + 24 次回答）
• 每小时最多约 4 次完整测试

错误处理

状态码	含义
400	请求体或答案格式无效
429	超出速率限制（检查 Retry-After 头部）
500	服务器错误

API 信息

GET https://soultrace.app/api/agent

返回 API 元数据（版本、问题数量、分数范围）。