巧房网站自动化操作

概述

自动化操作巧房房产系统，支持 token 登录、会话管理、房源/客源查询、报表分析等操作。优先使用 DOM 解析，避免截图识别。

触发条件

当用户消息包含以下意图时激活:
- "帮我查看下巧房房源列表"
- "有没有新房源"
- "查看新客源"
- "巧房系统里..."
- "帮我查下房源/客源"
- "二手房"/"出租房"/"私客"/"公客"
- "登录巧房"
- "报表"/"导出报表"/"数据报表"
- "员工登录情况"/"账号使用情况"
- "数据看板"/"统计报表"

环境配置

Token 存储在: {workspace}/qiaofang-token.md

说明：
- Token文件保存在当前agent的workspace目录下
- Multi-Agent模式下，每个agent独立管理自己的token
- 如需多个agent共享token，可使用共享workspace

环境区分

默认使用线上环境。如需切换测试环境，用户需明确说明。

🎯 登录后欢迎引导

重要: 每次成功登录巧房系统后，必须向用户展示欢迎消息和功能菜单：

✅ 登录成功！欢迎回来，{用户名}！

🏠 巧房系统已就绪，我可以帮你：

【房源管理】
• 查看房源列表 - 二手房、出租房、未挂牌房源
• 搜索房源 - 按区域/价格/户型/面积筛选
• 查看房源详情 - 房源信息、跟进记录、带看情况
• 导出房源数据 - 导出Excel进行分析

【客源管理】
• 查看客源列表 - 求购私客、求购公客、求租私客
• 搜索客源 - 按需求/预算/区域筛选
• 查看客源详情 - 客户信息、跟进记录、带看房源

【数据报表】
• 数据看板 - 经营分析、房源分析、客源分析
• 行程分析报表 - 跟进/带看数据统计
• 房源报表 - 房源分析、楼盘分析、商圈精耕
• 客源报表 - 三网端口报表、客源分析、带看分析
• 交易报表 - 线上签约率、业绩统计
• 新房报表 - 新房房源、客源、成交数据
• 人事报表 - 员工登录情况、入离职情况、审批时效
• 增值业务报表 - 增值服务数据统计

【快捷操作】
• 查看最新挂牌房源
• 查看我的超时未跟进房源
• 查看最新降价房源
• 导出各类报表数据

💬 直接告诉我你想做什么，例如：
   "查看浦东新区的二手房"
   "导出员工登录报表"
   "查看我的私客列表"

支持的功能详解

📊 一、房源管理

1.1 房源列表查询

• 出售房源（二手房）
• 筛选条件：区域、价格、面积、户型、楼层、朝向、标签
• 排序方式：智能排序、价格、面积、挂牌日期、房源分

• 数据字段：房源名称、楼栋、单元、房号、区域板块、售价、单价、面积、户型、楼层、朝向、挂牌日期、维护人、最后跟进日

• 出租房源（租房）

• 同出售房源筛选条件

• 租金数据统计

• 未挂牌房源

• 暂未对外发布的房源

• 成交房源

• 已成交房源记录

1.2 房源搜索

• 关键词搜索: 房源编号/小区/学校名称/地址/业主姓名/电话/钥匙编号
• 高级筛选:
• 位置：区域、地铁线路
• 价格：售价区间、单价区间
• 面积：面积区间
• 房型：室/卫数量
• 楼层：低层/中层/高层/顶楼/底楼
• 标签：品质好房、视频、有钥匙、独家、VR等
• 维护：发布状态、实勘状态、跟进/带看记录

1.3 房源数据导出

• 点击"导出"按钮下载Excel
• 支持自定义列导出
• 文件格式：房源列表-{日期时间}.xlsx

👥 二、客源管理

2.1 客源类型

• 求购私客 - 个人求购客户
• 求购公客 - 公共求购客户池
• 求租私客 - 个人求租客户
• 求租公客 - 公共求租客户池

2.2 客源筛选

• 客户需求：区域、价格、面积、户型
• 跟进状态：跟进时间、带看次数
• 客户标签：意向度、来源渠道

2.3 客源详情

• 客户基本信息
• 跟进记录
• 带看房源记录
• 匹配房源推荐

📈 三、数据报表

3.1 报表访问路径

快速访问路径（推荐）:
- 直接导航到：/solar/muggle-sys/report/management/index
- 在报表首页找到对应报表分类，点击进入

传统路径: 数据 → 报表管理

> 💡 提示: 直接导航到报表首页更高效，无需模拟主导航点击操作。

3.2 报表分类

3.3 常用报表详解

3.3.1 三网端口报表（客源报表）
- 访问路径: 报表首页 → 客源报表 → 三网端口报表
- 数据字段:
- 服务中会员数
- 服务中端口数
- 服务中全网通端口数
- 即将开通端口数
- 即将开通全网通端口数
- 未来7天即将到期的端口数
- 未来7天使用即将到期的全网通端口数
- 使用场景: 监控端口资源使用情况，及时续费

3.3.2 员工登录情况（人事报表）
- 访问路径: 报表首页 → 人事报表 → 员工登录情况
- 统计维度: 部门（默认）/ 员工
- 筛选条件:
- 日期范围（默认当月）
- 类别（如：行政）
- 部门
- 部门级别
- 数据字段:
- 部门/员工名称
- 在职员工数
- 有系统使用行为的在职员工数
- 有电脑端使用行为的在职员工数
- 有移动端使用行为的在职员工数
- 更新频率: 每日凌晨
- 分析价值: 监控团队系统使用率，发现培训需求

3.3.3 员工入离职情况（人事报表）
- 访问路径: 报表首页 → 人事报表 → 员工入离职情况
- 数据字段:
- 部门
- 入职人数
- 离职人数
- 离职率
- 使用场景: 分析人员流动趋势

3.3.4 审批时效报表（人事报表）
- 访问路径: 报表首页 → 人事报表 → 审批时效报表
- 数据字段:
- 部门
- 审批类型
- 提交数
- 审批通过数
- 审批拒绝数
- 平均审批时长
- 超时审批数
- 使用场景: 优化审批流程效率

3.3.5 线上签约率报表（交易报表）
- 访问路径: 报表首页 → 交易报表 → 线上签约率报表
- 数据字段:
- 部门
- 线上签约单量
- 交易单量
- 线上签约率（按二手/租赁分别统计）
- 使用场景: 推广线上签约，提升效率

3.4 报表操作流程

1. 进入报表
   - 推荐: 直接导航到报表首页 /solar/muggle-sys/report/management/index
   - 选择报表类型（如"人事报表"）
   - 选择具体报表（如"员工登录情况"）

2. 设置筛选条件
   - 切换统计维度（部门/员工）
   - 选择日期范围
   - 选择类别、部门、营销平台等筛选条件
   - 点击"查询"按钮

3. 查看数据
   - 查看汇总数据（合计行）
   - 查看明细数据（数据行）
   - 点击列标题排序

4. 导出报表
   - 点击"导出"按钮
   - 系统自动下载Excel文件
   - 文件保存在Downloads目录
   - 文件名格式：{报表名称}-{日期时间}.xlsx
   - 示例：

   • 三网营销-部门-2026-03-26-17-19-53.xlsx
   • 线上签约率-2026-03-26-17-00-47.xlsx

5. 数据分析（可选）
   - 使用Python pandas分析导出的Excel
   - 数据清洗、统计、可视化

3.5 报表操作原则

> ⚠️ 重要: 执行报表操作前遵循以下原则

1. 用户未明确时先确认: 如果用户没有指定 Tab 切换或筛选参数，先与用户确认再执行
2. 默认行为: 如用户只说"导出报表"，使用当前默认筛选条件直接导出
3. 按实际表格处理: 根据实际看到的表格列名和数据结构进行处理

3.6 报表页面结构

通用组件:
- 统计维度 Tab: 部门、员工 单选切换
- 筛选条件: 日期范围、类别、部门、部门级别、营销平台等
- 功能按钮: 查询、重置、自定义列表、导出
- 其他操作: 添加到常用报表、添加到公司报表

数据表格:
- 支持列排序
- 支持分页
- 支持导出为 Excel

3.7 数据分析示例

导出后可使用 pandas 进行数据分析：

import pandas as pd

df = pd.read_excel('报表文件.xlsx')

# 基本信息
print(df.info())
print(df.describe())

# 数据预览
print(df.head(10))

# 计算指标
df['利用率'] = df['已用端口资源数'] / df['端口总资源数'] * 100
df['使用率'] = df['有系统使用行为的在职员工数'] / df['在职员工数'] * 100

# TOP 10 排名
top10 = df.nlargest(10, '使用率')

常见分析场景:
- 清洗空值数据
- 计算使用率/转化率
- TOP N 排名
- 数据可视化

🔍 四、快捷查询

4.1 预设筛选条件

• 最新挂牌房源 - 最近新上的房源
• 最新降价房源 - 近期降价的房源
• 我的超时未跟进房源 - 需要跟进的房源
• 与我相关房源 - 我维护或带看过的房源
• 我部门相关房源 - 部门内的房源
• 收藏房源 - 我收藏的房源

4.2 常用搜索示例

用户说："查看浦东新区300万以下的2室"
操作：房源 → 出售房源 → 筛选：区域=浦东新区，价格=300万以下，房型=2室

用户说："看看我最近的新客源"
操作：客源 → 求购私客 → 筛选：按跟进时间排序

用户说："导出上个月的员工登录报表"
操作：数据 → 报表管理 → 人事报表 → 员工登录情况 → 日期=上个月 → 导出

登录流程

步骤1: 换取 accessToken

调用 API 用 param 换取 accessToken：

线上环境：

curl -X POST --header 'Content-Type: application/json' --header 'Accept: */*' \
  -d '{"param": "{{param}}" }' \
  'https://jedi.qiaofangyun.com/api/jedicommonapplication/noAuth/openClawLogin/getAccessToken'

测试环境：

curl -X POST --header 'Content-Type: application/json' --header 'Accept: */*' \
  -d '{"param": "{{param}}" }' \
  'https://jedi2.test.qiaofangyun.com/api/jedicommonapplication/noAuth/openClawLogin/getAccessToken'

响应示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "data": {
    "accessToken": "xxx",
    "companyUuid": "xxx",
    "employeeUuid": "xxx"
  }
}

步骤2: 设置 Cookie 登录

将 accessToken 设置为 cookie qf-auth-token-v20：

线上环境：

域名: .qiaofangyun.com
Cookie: qf-auth-token-v20={{accessToken}}

测试环境：

域名: .qiaofangyun.com
Cookie: qf-auth-token-v20={{accessToken}}

步骤3: 访问系统并显示欢迎引导

设置 cookie 后，访问系统首页：

线上环境： https://jedi.qiaofangyun.com/solar/muggle-tna-home/home

测试环境： https://jedi2.test.qiaofangyun.com/solar/muggle-tna-home/home

重要: 登录成功后，立即显示欢迎引导消息（见上方"🎯 登录后欢迎引导"章节）。

常用操作路径

首次使用流程

1. 用户发起请求（如"登录巧房"）
2. 检查当前workspace下是否存在 qiaofang-token.md
3. 若不存在，向用户索取:
   > "首次使用需要您提供巧房系统的长期 Token（param）。请提供您的 Token，我会安全保存在当前工作目录以便后续使用。"
4. 保存 token 到 {workspace}/qiaofang-token.md
5. 调用 API 换取 accessToken
6. 设置 cookie qf-auth-token-v20
7. 访问系统首页
8. 显示欢迎引导消息和功能菜单
9. 完成用户请求的操作

说明：
- Token文件使用相对路径，保存在当前agent的workspace目录
- Multi-Agent模式下，每个agent独立管理自己的token文件
- 如需多个agent共享token，可配置共享workspace

快速参考