# sixhat

**Repository Path**: solar86/sixhat

## Basic Information

- **Project Name**: sixhat
- **Description**: 用六顶思考帽方法分析问题
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 六顶思考帽 · Six Thinking Hats

> 你抛出一个"我该怎么办"式的真实问题，六个 AI 角色各戴一顶思考帽开一场会，
> 会后交付一份**标注了分歧与盲区**的决策简报。

它不给你"两边都有道理"的和稀泥答案，而是给你**一张标好了分歧状态和盲区的图**——
剩下的判断权还在你手里。

---

## 快速开始

```bash
npm install

# 离线冒烟：不需要 API key，跑完一整场讨论并产出报告
npm run smoke

# 起开发服务器 → http://localhost:3000
npm run dev

npm test          # 145 个用例
npm run build     # 生产构建
```

### 要用真实模型

复制 `.env.example` 为 `.env.local`，填 `MINIMAX_API_KEY`（**不要提交**）：

| 变量 | 说明 |
|---|---|
| `MINIMAX_API_KEY` | 必填；**缺失时自动走离线 mock 模式**（不联网、不花钱） |
| `MINIMAX_BASE_URL` | 默认 `https://api.minimax.cn/anthropic` |
| `MINIMAX_MODEL` | 默认 `MiniMax-M3` |
| `MINIMAX_TIMEOUT_MS` | 可选；单次调用超时，默认 180000 |

---

## 它是怎么跑的

八个阶段，**帽子串行使用**（"并行"指最终六视角的并列展示），蓝帽负责调度：

```
0 蓝帽·议题校准 → 1 白帽·事实盘点 → 2 绿帽·创意发散
→ 3 黄帽·价值可行 ‖ 黑帽·风险批判   ← 唯一并发点
→ 4 红帽·情绪汇总 → 5 黑帽·攻击黄帽 → 6 黄帽·逐条防守 → 7 蓝帽·收敛
```

每顶帽子**两次调用**：A 自由散文发言（流式推给前端）、B 带 strict tool 的结构化输出
（`submit_hat_output`）——因为 MiniMax 端的 `output_config.format` 会被静默忽略、
`tool_choice` 不可靠，**结构化只能走 tool**。

三条不可妥协的产品原则：

1. **角色边界是硬约束**——每顶帽子的 system prompt 里有逐条写死的"禁止"清单；
   红帽不许给方案、黑帽不许夹带情绪，**越界即 bug**（全流程同一个模型，
   角色差异只能靠 prompt 保证，没有模型能力差异兜底）。
2. **黄帽与黑帽必须显式对撞**——默认 1 轮辩论（黑帽逐条攻击 → 黄帽逐条防守并标出哪条被说服），
   不能合并成一段"利弊分析"。
3. **每条结论可追溯**到具体帽子与具体依据。

---

## 文档

| 文档 | 是什么 |
|---|---|
| [docs/PRD.md](docs/PRD.md) | 产品需求（v0.2，决策确认稿）——**权威版本** |
| [docs/live-run-2026-10-26.md](docs/live-run-2026-10-26.md) | **真实 MiniMax 实跑记录**（两轮对照：链路、tool_use、角色边界、性能与成本） |
| [artifacts/delivery/delivery-note.md](artifacts/delivery/delivery-note.md) | 交付说明：交到了什么、怎么跑起来、还差什么（含真人试用发现的缺陷） |
| [artifacts/review/acceptance-record.md](artifacts/review/acceptance-record.md) | 独立验收记录（**D-003：24/24 通过**——9 条需求级 + 15 条任务级（PM 的文件清单派生）） |
| [artifacts/review/acceptance-record-D002.md](artifacts/review/acceptance-record-D002.md) | 上一单（D-002）的独立验收记录原文（12/12 + 5 条非阻断缺陷），**一个字未动** |
| [artifacts/plan/project-plan.md](artifacts/plan/project-plan.md) | 实现计划 |
| [artifacts/design/architecture.md](artifacts/design/architecture.md) · [hat-prompts.md](artifacts/design/hat-prompts.md) | 技术方案 · 六帽 prompt 契约（工程师逐字抄的全文） |

---

## 当前状态与已知限制

**已跑通**：首页输入 → 八阶段编排（含黄黑对撞）→ SSE 流式 → 结构化输出 → 六宫格 → 决策简报 + 成本显示。
真实模型下实测 **264 秒 / 场、≈¥0.42 / 场、9/9 结构化产出、角色边界零越界**。
**会话持久化**（D-003 交付）：整场讨论落进服务端存档，带同一个会话 id 从另一台客户端打开，
**看到的是同一场讨论**（9 顶帽子 + 分歧矩阵 + 简报，一个字不差）。

**还没做**（二期）：追问某顶帽子重答、5 个场景预设、PDF/飞书导出、账号体系、外部信息检索。

**已知限制**：

- **会话没有账号体系**——**任何知道会话 id 的人都能取回那场讨论**（含你输入的问题原文）。
  这是"本机工具"的取舍，**不是**能直接放到公网的前提；
- **存档落在服务端本机的文件系统**（默认 `.sixhat-archives/`，可用 `SIXHAT_ARCHIVE_DIR` 改）——
  "换设备能接着看"指的是**连同一个服务端**的另一台客户端，不是云端同步；
- **客户端不校验服务端返回的会话 id**（独立评审记的"缺防线"）：服务端按 id 精确取档、正常不会串号，
  但客户端少一道校验；
- **UI 没有自动化测试**（环境里没有 DOM 测试环境）——组件层只有人工验证；
  ✅ 但这次的**客户端复原接线已由创始人真人浏览器实测通过**（2026-10-27：换浏览器打开同一会话 id
  能原样复原、刷新不自动重跑）；
- **简报的盲区/下一步质量只有开发者读过**，还没有真人评价过"这份简报对我有没有用"；
- 真实 MiniMax 端点实测为 `api.minimax.cn`（**PRD 附录 B 写的 `api.minimaxi.com` 与我们手上的 key 不匹配**）。

---

> ⚠ **免责声明**：本工具提供的是思维框架辅助，**不构成法律、医疗、投资或职业建议**。

*由 ai-company 虚拟公司交付（D-002 建仓 · **D-003 会话持久化**）*