Files
TrangleAgent/Frontend/QUICKSTART.md
2026-01-18 18:20:40 +08:00

143 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 快速开始指南
## 安装和运行
1. **安装依赖**
```bash
npm install
```
2. **启动开发服务器**
```bash
npm run dev
```
3. **访问应用**
浏览器会自动打开 http://localhost:3000
## 使用流程
### 第一步:注册账号
1. 访问登录页面,点击"还没有账号?立即注册"
2. 填写账号、密码、确认密码和姓名
3. 点击注册,自动登录并跳转到主页
### 第二步:创建或加入房间
**创建房间:**
1. 在主页"创建房间"卡片中,输入房间名称
2. 点击"创建房间"按钮
3. 自动进入房间,成为主持人
**加入房间:**
1. 在主页"加入房间"卡片中,输入房间号
2. 点击"加入房间"按钮
3. 自动进入房间,成为玩家
### 第三步:使用骰子系统
**玩家初始投掷4个D4**
1. 进入房间后,玩家会看到"玩家初始投掷4个D4"区域
2. 点击"投掷4个D4"按钮
3. 查看投掷结果显示4个骰子的值
4. 如果3的数量少于3个
- 可以输入消耗的属性值来增加3的数量
- 如果最终达到3个3不会产生混沌值
- 否则每个不是3的D4会产生1点混沌值
5. 点击"确认投掷结果"完成初始投掷
**普通投掷:**
- 在"选择骰子类型"区域点击对应的骰子按钮D3/D4/D6/D12/D20
- 投掷结果会显示在投掷历史中
**混沌值管理(仅主持人):**
- 混沌值显示在页面顶部,所有人可见
- 主持人可以点击"消耗混沌值"按钮来消耗混沌值
### 第四步:总部/分部管理
1. 在主页点击"总部/分部管理"
2. **创建分部**(需要经理权限):
- 点击"创建分部"按钮
- 填写分部名称和负责人
- 点击确定
3. **发布招聘信息**(需要经理权限):
- 在右侧"招聘信息"卡片中,点击"发布招聘"
- 填写标题和内容
- 点击确定
4. **查看分部信息**
- 点击分部列表中的"查看详情"
- 可以看到该分部的天气、散一端等信息
### 第五步:异常管理
1. 在主页点击"异常管理"
2. **添加异常**
- 点击"添加异常"按钮
- 填写异常信息:
- 异常名称
- 类型(实体/概念/地点/现象)
- 特殊能力
- 焦点
- 领域(现实/记忆/时间/空间/生命/死亡/知识/情感)
- 点击确定
3. **收容异常**
- 在"未收容异常"列表中,点击"收容"按钮
- 异常会移动到"已收容异常"列表
4. **解决异常**
- 在"已收容异常"列表中,点击"标记为已解决"
- 异常会移动到"已解决异常"列表
5. **设置天气**
- 在"天气系统"卡片中,输入天气信息
- 点击"设置天气"按钮
## 功能说明
### 混沌值规则TRTC三角洲机构规则
1. **初始投掷规则**
- 玩家开始时必须投掷4个D4
- 如果投出的4个D4中3的数量达到3个可通过消耗属性值达到则不会产生混沌值
- 如果3的数量少于3个每个不是3的D4会产生1点混沌值
2. **混沌值显示**
- 混沌值显示在房间页面顶部,所有玩家可见
- 只有主持人可以消耗混沌值
3. **普通投掷**
- 普通投掷不会自动产生混沌值(除非特殊规则)
### 数据存储
- 当前版本使用浏览器的localStorage进行数据存储
- 所有数据保存在本地浏览器中
- 刷新页面后数据会保留
- 清除浏览器数据会丢失所有信息
## 注意事项
1. **房间号分享**:创建房间后,可以点击"复制房间号"按钮分享给其他玩家
2. **角色权限**
- 主持人:可以消耗混沌值
- 玩家:可以投掷骰子,但不能消耗混沌值
- 经理:可以创建分部、发布招聘信息
3. **数据同步**:当前版本是纯前端应用,多个浏览器标签页之间的数据不会实时同步
## 常见问题
**Q: 如何切换账号?**
A: 点击右上角"退出"按钮,然后使用其他账号登录。
**Q: 房间数据会丢失吗?**
A: 数据保存在浏览器localStorage中除非清除浏览器数据否则不会丢失。
**Q: 可以多人同时使用吗?**
A: 当前版本是纯前端多人使用时需要各自在浏览器中操作数据不会实时同步。如需实时同步需要集成WebSocket或后端API。