# TOOLS.md - 本地环境配置

这里是美容院助手的环境特定配置。换一个门店/机器，这些信息可能就变了。

---

## 库存管理

### 项目列表

| 项目名 | 说明 |
| --- | --- |
| `<填写项目名>` | `<填写说明>` |

### 商品参考

| 商品名 | 规格 | 备注 |
| --- | --- | --- |
| `<填写商品名>` | `<规格>` | |

---

## 客户管理

### 数据库路径

```
<默认路径或自定义路径>
```

### 当前客户数

`<填写数量>`（截至 `<日期>`）

### 已设置生日提醒的客户

| 客户 | 生日 | 提醒时间 |
| --- | --- | --- |
| `<客户名>` | `<生日>` | `<提醒规则>` |

---

## 日程管理

### 日程文件路径

```
<填写日程文件路径>
```

### 默认设置

- 默认提前提醒：`<分钟数>` 分钟
- 提醒渠道：`<渠道>`

---

## 工作空间

### 根目录

```
<填写工作空间路径>
```

### 关键文件

| 文件 | 用途 |
| --- | --- |
| `<文件名>` | `<用途说明>` |

---

## 时区与时间

- **时区**：`<填写时区，如 Asia/Shanghai>`
- **日期格式**：YYYY-MM-DD
- **时间格式**：HH:MM（24小时制）

---

## 门店信息（待填写）

以下是门店特定信息，首次使用时请填写：

- [ ] 门店铺名
- [ ] 门店类型（美容院/美甲店/美发/综合店）
- [ ] 主要营业渠道（微信/抖音/美团/小红书）
- [ ] 客单价区间
- [ ] 老板称呼
- [ ] 老板联系方式
- [ ] 合作医美机构信息
- [ ] 常用供应商联系方式

---

## 提醒设置偏好

### 预约提醒

- 提前时间：`<分钟数>` 分钟
- 发送方式：`<方式>`

### 跟进提醒

- 通过客户管理技能设置
- 提醒时间：`<时间规则>`

---

## 常用命令速查

### 库存

```bash
# 查看项目列表
python3 /app/skills/inventory-management/scripts/inventory.py project-list

# 查看库存
python3 /app/skills/inventory-management/scripts/inventory.py stock-query --project <项目名>

# 入库
python3 /app/skills/inventory-management/scripts/inventory.py stock-in --project <项目名> --key <商品名> --quantity <数量>

# 出库
python3 /app/skills/inventory-management/scripts/inventory.py stock-out --project <项目名> --key <商品名> --quantity <数量>
```

### 客户

```bash
# 查看全部客户
uv run --project "/app/skills/sophnet-customer-management" python -m customer_mgmt_cli customer query --json '{"limit":100}'

# 添加客户
uv run --project "/app/skills/sophnet-customer-management" python -m customer_mgmt_cli customer add --json '{"name":"姓名","primary_phone":"手机号"}'

# 查询客户
uv run --project "/app/skills/sophnet-customer-management" python -m customer_mgmt_cli customer query --json '{"name":"客户名"}'

# 设置跟进提醒
uv run --project "/app/skills/sophnet-customer-management" python -m customer_mgmt_cli reminder schedule --json '{"follow_up":{"match":{"name":"客户名"},"date":"YYYY-MM-DD"}}'
```

### 日程

```bash
# 添加预约
python3 /app/skills/schedule-reminder/scripts/append_event.py \
  --file <日程文件路径> \
  --date "YYYY-MM-DD" --start "HH:MM" --end "HH:MM" \
  --title "事项" --priority "高" --advance 30

# 设置预约提醒
openclaw cron add --name "预约提醒-日期" --at "YYYY-MM-DDTHH:MM:00+08:00" --session main --system-event "提醒内容" --delete-after-run
```

---

*此文件随环境变化而更新。首次使用时请填写门店特定信息，发现新的环境特定信息时请及时补充。*
