# 数据文件模板与规范

所有数据文件位于 `.skills-data/zhongjie/data/`，对应浏览器工作台的三个页面。
每次更新后浏览器会自动刷新显示（5 秒轮询）。

---

## preferences.md（我的画像）

```markdown
# 客户购房画像

> 最后更新：YYYY-MM-DD

## 客户概况
- 家庭构成：
- 买房动机：
- 现住情况：
- 通勤地点：
- 看房经验：
- 紧迫程度：

## 参考标的
- 标的名称：
- 喜欢的点：
- 不满意的点：
- 参考价值：（对后续推荐的指导意义）

## 需求优先级

### 硬性条件（不可妥协）
1.
2.

### 强烈偏好（非常在意）
1.
2.

### 锦上添花（有则更好）
1.
2.

## 详细需求
- 目标城市/区域：
- 预算范围：
- 户型/面积：
- 交通要求：
- 教育需求：
- 小区品质：
- 居住环境：
- 房屋类型：
- 特殊偏好：

## 已识别的需求矛盾
|矛盾点|分析|客户倾向|
|------|------|------|

## 待确认事项
-（列出还需要问客户的问题）

## 沟通记录
| 日期 | 要点 |
|------|------|
```

**更新原则：**
- 空白项标注"待了解"，作为下次追问的提示
- 客户修改偏好时记入沟通记录，追踪需求演变
- 特别关注"待确认事项"——这是下次对话的切入点

---

## research.md（调研资料）

```markdown
# 调研资料

> 最后更新：YYYY-MM-DD

## 区域分析

### [区域名]
- 板块定位：
- 参考均价及走势：
- 核心配套：
- 规划利好/风险：

## 政策要点

### [政策主题]
- 要点：
- 对客户的影响：
- 信息来源：

## 小区测评

### [小区名]
- 来源：[链接]
- 关键发现：
- 中介点评：

## 积分入学分析
（如适用，记录计算结果和结论）

## 市场动态
- [日期] [动态内容]

## 搜索记录
| 日期 | 关键词/来源 | 要点发现 |
|------|------------|----------|
```

**更新原则：**
- 每次搜索到有价值的信息都记录，注明来源和日期
- 区域分析按客户关注的区域组织
- 小区测评跟推荐的房源对应，方便交叉参考

---

## report.md（推荐报告）

```markdown
# 房屋推荐报告

> 最后更新：YYYY-MM-DD
> 核心诉求：（一句话概括客户最在意的几件事）

## 推荐总览

| 序号 | 小区/楼盘 | 区域 | 参考均价 | 核心亮点 | 主要短板 | 匹配度 |
|------|----------|------|----------|----------|----------|--------|

## 详细分析

### 1. [小区名]

> **一句话推荐理由：** 为什么推荐这个给这位客户

**基本信息**
- 位置 / 类型 / 建成年份 / 参考均价 / 户型

**与客户需求的匹配度**
- ✅ 满足的硬性条件：
- ✅ 满足的偏好：
- ⚠️ 部分满足：
- ❌ 不满足：

**中介点评**
（基于专业经验的综合评价，不是复述数据，而是给出判断）

**信息来源**
- [来源](URL)

---

## 横向对比
（针对客户最在意的 2-3 个维度，表格对比各推荐）

## 中介综合建议
（明确的建议，不要模棱两可。）

## 下一步建议

## 客户反馈与调整
| 日期 | 推荐反馈 | 需求调整 |
|------|----------|----------|
```

**更新原则：**
- 客户否决的房源不删除，标注否决原因——这些原因是精细化推荐的宝贵信息
- 根据客户反馈动态调整匹配度评分
- 每轮推荐后更新"客户反馈与调整"

---

## properties.json（房源地图数据）

将推荐房源写入 `.skills-data/zhongjie/data/properties.json`，浏览器「房源地图」页自动渲染。

```json
[
  {
    "name": "小区名称",
    "searchName": "高德搜索词（可加区域辅助定位，如'绿城桂语兰庭 光明'）",
    "area": "所在区域",
    "price": "参考均价（如'3.6-3.8万/㎡'）",
    "priceDetail": "户型对应总价（如'115㎡ 约448-530万'）",
    "layout": "户型面积（如'115㎡ / 128㎡ 四房'）",
    "highlights": ["亮点1", "亮点2"],
    "concerns": ["短板1", "短板2"],
    "comment": "一两句中介点评",
    "matchScore": 5,
    "isReference": false,
    "color": "#d4845a",
    "sources": [{"label": "来源名称", "url": "https://..."}]
  }
]
```

### 字段说明

| 字段 | 必填 | 说明 |
|------|------|------|
| `name` | ✅ | 小区/楼盘名 |
| `searchName` | | 高德搜索用词，不填则用 `name`。加区域更精准 |
| `area` | | 所在区域，显示在卡片和弹窗中 |
| `price` | | 参考均价 |
| `priceDetail` | | 户型+总价 |
| `layout` | | 户型/面积 |
| `highlights` | | 核心亮点，显示为绿色标签 |
| `concerns` | | 主要短板，显示为黄色标签 |
| `comment` | | 一句话中介点评 |
| `matchScore` | | 匹配度 1-5，显示为星星 |
| `isReference` | | `true` 表示参考标的，虚线边框区分 |
| `color` | | 标注颜色，不填则自动分配 |
| `sources` | | `[{label, url}]` 数组，信息来源链接 |

`properties.json` 应与 `report.md` 保持同步——每次更新推荐房源时，一并更新 JSON 文件。