从房源记录信息，走向销售成交决策系统

支持聊天记录 JSON、多份楼盘知识/词典表和 HomeSeek AI 用户笔记；当前统一读取 5 份楼盘知识库、3,413 条楼栋与户型规则，并记录导入批次、源文件、工作表与时间。

统一项目别名、面积、户型、电话、时间、群聊和联系人格式；金额必须分类为发布总价、租金、单价、推算约价、首付、定金、佣金或其他费用，并保留原始文本与来源类型。

按统一结构维护标准项目名、别名、上级项目、分期、楼栋、房号、建筑类型、面积、户型、朝向、总高、梯户比、景观、备注和源文件。离线用于发布内容标准化、项目归属和安全字段补齐；在线与原文检索、向量/SQL 召回并行，未命中不得阻断查询。

一条消息可拆分多个房源候选；任何编号项强制开启新候选，分隔线与项目标题辅助切分。每个候选只能抽取本片段内的项目、房号、面积、户型、总价、单价、租金、佣金和联系人。

相同房源关联同一 listing_group_id；同一 wx_id 的重复消息归入同一 offer，不同 wx_id 分别保留为组内独立销售关系。

只向量化每个 offer_id 的最新规范记录，并支持更新、失效和重新生成。

首页展示 5 个来自真实客户问题类型的代表性案例：产品名找房、指定楼盘户型、预算与老人常住、多开发商并列求购、宝妈带宝宝与老人长租。案例可以使用短标签，但提交给查询流程的必须是完整客户原话；点击后按当前房源索引、词典、用户笔记和当前版本 Prompt 实时执行，不使用历史固定答案。销售也可改写并提交任意客户原话；系统保留最新完整查询文本，并解析楼盘、产品俗称、销售姓名、手机号、用户标识、预算、面积、户型和交易类型等条件槽位。

房源详情展示楼盘、类型、楼层、面积、价格、房型、朝向、设施、地段和动态匹配度；同组下列出全部负责人、手机号、报价、佣金、税费、发布群、时间和完整历史原文。每条证据保留 message_id 与来源文件并支持命中字段高亮，wx_id 默认隐藏并支持点击“查看用户标识”。

默认演示问题“我要克拉墅的房子”使用 Sonnet 4.6 提前生成的真实结果并直接展示；销售输入任何新问题时，回答、推荐顺序、风险和追问由 Sonnet 4.6 基于当前完整查询条件及其证据实时生成，禁止使用固定话术模板替代。模型必须遵循资深海南房产顾问的人物设定、专业语气和事实边界；词典高置信命中时自然解释术语，词典未命中时继续基于原文与房源证据回答。

每个结论展示来源、更新时间和可信等级；房源匹配度随当前查询条件动态计算，并可解释预算、面积、房型、结构、时效等得分因素。

销售可新建或编辑高置信房源笔记，必填/关联房源名称、销售姓名和联系电话；支持富文本、大小标题、编号、项目符号、待办、分割线、提醒、图片、音频文件和麦克风录音。笔记独立保存规范房源快照，旧笔记按 listing_id、标题、项目、面积与联系人关系回溯原始记录；匹配不唯一时不强制回填。笔记卡片、查看弹窗、对话内笔记与编辑预览必须复用同一房源信息组件，不得出现字段口径不一致。

管理员可合并或拆分房源组、处理同一 wx_id 内的误去重、修正销售身份和异常来源；房源归组不得删除任何销售关系。

记录销售采用、修改、联系和成交结果，用于优化排序、话术和置信度。

编辑中文字、元数据和附件自动保存，支持撤销、重做和草稿恢复。每个账号默认提供 10GB 笔记空间，实时显示已用量、剩余量、百分比和附件占用；超额时禁止继续上传并引导清理。

服务端通过 PipeLLM 调用 claude-sonnet-4-6 并使用强制 Function Tool Use 获得结构化输出。API Key 仅从服务端环境变量或 macOS 系统钥匙串读取，不得写入 HTML、浏览器存储或房源索引。本地服务由 LaunchAgent 登录自启并保持常驻，异常退出自动拉起；客户侧不出现启动、配置或网关提示。

查询结果必须先按同一销售相同房源去重，再将去重后的全部房源组、全部销售关系和命中词典数据交给模型，禁止 Top N、抽样或销售人员截断。AI 推荐只影响排序，不得删除未推荐房源；AI 接待页和房源列表页均需显示本次全部去重结果。重复发布原文和同一销售的重复证据不进入模型上下文，但必须保留在关系库中用于详情追溯。

提交查询后依次显示需求理解、词典、房源记录、语义理解、价格校验、用户笔记和去重归组进度。基础检索产生的候选列表不得直接展示；只有语义重排、价格清洗和去重归组全部完成后，才一次性呈现稳定房源列表，防止低价中间结果闪现后自动换序。稳定列表立即生成唯一 retrieval_snapshot_id 并持久化，销售顾问 AI 只能读取该冻结快照并异步生成回复。AI 运行期间“更新查询”保持可用，新查询必须取消上一轮请求并废弃旧快照。

查询理解 AI 输出 explicitTerms、inheritedTerms、implicitNeeds、dictionaryTerms、searchExpansions、preferFeatures 和 avoidFeatures。inheritedTerms 只能来自当前 Session 已完成历史，并由服务端反向校验原文依据；程序同时校验 dictionaryTerms 确实存在于真实词典。纯场景查询若没有楼盘、预算、面积、户型、交易类型、当前 Session 继承实体或词典关系等确定性锚点，不得仅凭 AI 假设扩大房源结果，只能用于专业追问。存在锚点时，AI 候选可以重排真实结果，但不得删除销售关系。

每个客户对话创建独立 Session，每次提交创建独立 Turn；同一 Session 最多向模型提供最近 8 个已完成 Turn，并支持“300万以内”“不要地下室”等连续补充。右上角提供“新对话”，点击后取消旧请求、关闭旧 Session、清空输入与结果并创建新 Session。服务端校验 session_id、turn_id 与 retrieval_snapshot_id 的归属，旧 Turn、旧快照或已关闭 Session 返回的结果不得更新当前页面。Session 仅作为运行时上下文，24 小时无活动可失效；原始对话由永久 conversation_id 独立持久化。

清洗程序将“景业清水湾三期”“智汇城云尚A区”“恒大·海上帝景”等原文别名映射到统一标准名称，并按项目、面积、户型、朝向、楼栋和房号逐级匹配字典规则。项目级名称命中后必须把标准名写入规范房源；只有详细规则唯一且不与发布显性字段冲突时才补齐具体分期或属性。存在冲突或多个候选时保留发布原名并记录候选，不得强制覆盖。模型读取 knowledgeReference 时必须区分标准产品知识与实时挂牌证据。

服务端必须以版本化角色配置维护“首席房产销售顾问”身份、性格、五步接待法、自然销售表达和事实边界。客户回复必须像资深中介在即时沟通中真实接待：简单问题简洁，复杂家庭场景要细致说明初选判断、替代方向、关键取舍与执行步骤；每项建议按“已知事实—对选择的影响—下一步动作”自然展开。专业主张可以是联系、核验和看房顺序，不得为了果断强行宣布唯一答案。只允许清除内部术语等底线内容，禁止使用机械短语替换或整句删除破坏语感；禁止检索摘要、客服问卷、固定模板和无证据营销判断。

从提交查询到最终回复完成，页面不得出现无法判断是否卡死的空白或静态等待文本。客户原话只保留在可编辑输入框中，不在侧栏重复以大标题展示。查询理解采用一次有界调用，默认最多等待9秒，超时立即使用确定性与本地语义规则继续，不得连续重试拖延首段回复。需求理解、房源整理和快照确认使用紧凑行内旋转器；收到首个 Markdown 增量后立即切换为分批平滑文本流，避免逐字重绘造成卡顿。客户回复完成后输入框立即停止转圈，内部专业判断继续按顺序加载。房源结果始终独立可用，模型失败不得阻断检索或暴露技术错误。

价格语义、正则边界、编号切分、项目别名、词典冲突和推算字段均作为版本化清洗规则维护。价格提取必须排除“总建面22.7万㎡”“占地面积”“总建筑面积”等项目规模数字，只能把售价、总价、挂牌价或面积乘明确单价作为总价。每次变更必须从源文件重建完整索引，并自动验证定金/首付/佣金排除、项目面积排除、小数单价边界、编号长消息、项目归属、关键楼盘召回和销售关系完整性；任一用例失败不得发布新索引。

每次新客户对话在生成前创建唯一 conversation_id，与运行时 session_id 分离。持久保存对话标题、创建/更新时间、每轮客户原话、客户回复、内部判断、推荐 ID 和房源呈现快照。历史记录以响应式短卡片网格展示，默认不显示选择框和“详情”按钮；点击卡片直接恢复当时完整产品结果，包括房源解读、全部房源、楼盘资料、用户笔记、销售关系、比价、专业判断和追问。历史对话的“对话”模式必须在最后一轮下方提供持续可见的输入框；发送后复用当前持久对话 ID 和隔离会话，立即追加新一轮客户原话，并在原页面渐进显示需求理解、房源整理和流式客户回复。生成期间锁定重复提交；完成后重新读取服务端完整对话，刷新页面不得丢失新增轮次。只有用户主动进入“批量管理”时才显示卡片选择状态和批量删除操作。

完整索引必须输出 matched、ambiguous、unmatched 三态统计、项目级覆盖率和全部未收录楼盘清单。清单按影响房源组数排序，展示原始楼盘名、别名、房源组、销售关系、原文消息数、首次/最近发布时间和房源示例，并支持搜索与分批加载；歧义项目单独展示候选标准名，供人工补充或判定。

销售顾问 AI 必须根据客户已经表达的信息，动态判断这次找房希望完成的生活、家庭或资产安排，而不是固定套用需求问卷。客户只给楼盘、预算、面积或户型时，从触发事件、期望进展、阻力与焦虑、决策情境中选择最能改变排序的一项自然深挖；客户已经明确养老、度假、换房、投资等场景时，围绕该场景给条件式建议，不得重复询问用途。客户回复结尾最多提出一个场景深挖问题，再加一个会改变排序的硬条件问题，并说明答案将如何影响房源或看房顺序。方法论名称仅供内部 Prompt 使用，客户侧不得出现“JTBD、Job To Be Done、任务理论、需求框架”等术语；由场景推导的动机只能作为待验证假设，不得写成客户事实。

专业接待判断必须由模型基于本轮真实字典命中、房源级校验、楼盘资料、字段冲突和查询理解结果，独立生成“字典与资料作用”。内容分别说明资料参与了名称归一、产品解释、检索扩展、结构化字段补齐或需求验证中的哪些环节；哪些校验通过且唯一一致的内容可作为准确参考；哪些存在多个候选、资料未收录、字段冲突或多个可能值只能作为候选；以及资料帮助发现了哪些原文未直接写出的标准项目、产品结构、参考户型、建筑类型或总楼层数据。隐性需求必须注明来自客户原话与查询理解，楼盘资料只能验证、补充或否定，不能冒充客户动机来源。销售用户可见内容禁止展示英文状态、系统字段、内部房源 ID、null 或代码名，必须转换成自然中文。该判断供销售内部使用，不写入可直接发送给客户的回复。

查询理解必须区分客户点名楼盘是硬限制还是初选方案。出现“只看、仅限、不要其他”等明确限制时采用严格范围，只召回点名楼盘；出现“初步设定、可以更改、需要建议、您更专业、不好决定、还有其他建议”等授权顾问判断的表达时，在保留客户点名房源的同时，按地域、租售、预算、户型、入住时间等硬条件从完整真实索引补充候选。销售顾问 AI 必须先评价客户初选，再推荐 1–3 个真实替代方向，结合家庭成员、租期、楼层、电梯、房屋结构、价格与入住条件说明加入比较的原因和代价；不得虚构楼盘、跨区域或把语义偏好误当硬过滤。客户点名基础项目名时，标准分期名称仍归为客户点名范围。

客户并列说出多个开发商、楼盘、产品或联系人时，确定性解析必须生成完整目标数组，不得只保留第一个或最长实体。同一维度的并列目标执行 OR 召回，不同维度的租售、预算、面积、户型等条件执行 AND 过滤；例如“求购碧桂园，求购雅居乐，求购绿城”必须同时保留三个品牌并统一限定为售房。意图分析与 HyDE/语义扩展在直接召回之后并行补充别名、项目关系和隐性需求，不得删除、改写或替代客户明确点名的目标。多目标结果按目标生成子Tab，每个目标默认展示10条并独立加载；词典没有标准词条的目标仍按发布原文和房源索引返回。

索引载入时根据 message_id 将每条销售证据关联到完整原始记录，不在详情组件临时遍历全量消息。正常查询、原文回退召回和历史对话恢复必须使用同一证据结构；详情展开后完整展示原文及审计元数据，并对当前查询与房源字段进行安全高亮。任一房源或销售关系缺少原始证据都视为发布阻断问题。

顶部导航提供独立定价页，会员方案命名统一为基础版、专业版和团队版。会员状态、积分余额、购买记录与积分流水必须和平台用户 UUID 唯一绑定并由服务端持久化，禁止仅保存在浏览器。购买请求必须使用幂等标识，重复提交不得重复生成订单或发放积分；专业版 450 初始积分每个账号只发放一次。基础版计划提供每日 3 次 AI 房源解读、每次最多 10 组结果与 2GB 笔记空间；专业版以 99 元/月早鸟价提供完整结果、20GB 笔记空间、房源追踪、比价走势、AI 笔记与积分包折扣；团队版提供团队积分池、共享笔记、成员权限与团队追踪，具体额度由商务方案确定。当前测试阶段套餐按钮完成站内登记但不发起真实扣款，也暂不执行次数、空间和功能拦截；原始证据回溯是可信度基础，三档均可使用且不得设置为付费限制。接入真实支付后，会员生效与积分入账必须以服务端支付成功回调为准。

历史记录中的任一对话均可建立房源追踪计划。用户从该对话最新一轮的完整房源结果中选择一个或多个楼盘，并设置每小时、每 6 小时、每 12 小时、每天、每 3 天或每周的更新周期。定时检查只比对选中楼盘的报价、销售关系和发布动态；更改楼盘范围时重建基线，不将范围变化误报为房源下架。历史卡片和对话详情必须显示追踪楼盘、更新周期、下次更新时间和未读动态，并支持暂停、继续、立即更新和停止追踪。

从历史卡片进入对话后，页面以“对话—详情—追踪”三模式组织，默认打开对话模式并完整展示历史轮次；详情模式恢复当时的房源解读、全部房源、楼盘资料、用户笔记、销售关系、比价、专业判断和追问。桌面端详情模式占满导航以下的剩余视口，左侧楼盘资料与右侧房源结果分别独立滚动，任一侧滚动不得带动另一侧；移动端保持自然纵向浏览。仅已追踪对话显示追踪模式。每次追踪检查必须保存真实报价的更新前价格、更新后价格、变动金额、变动比例和时间；追踪模式使用 ECharts 展示单套房源价格走势、每次更新的整体平均波动、基线与最新房源总数对比、上调/下调次数和平均变动。追踪页提供“价格／百分比”切换并默认进入价格模式。价格模式的房源列表只展示当前参考价，详情只并列展示区间起点与当前参考价，不在卡片、徽标和汇总数据中直接铺开计算价差；价差与涨跌幅应在鼠标悬停曲线节点时按需呈现。整体走势必须使用连续曲线：价格模式绘制同一计价单位房源的平均参考价，百分比模式绘制相对起点的平均涨跌幅；禁止把售价、月租和年租混算。左侧房源列表按完整卡片分页加载，任何视口与缩放比例下都不得从半张卡片处截断或因右栏高度产生空白占位。没有新的真实报价差异时，服务端应基于已有发布轨迹或最新报价生成稳定、可复现的模拟趋势，并在标题、统计、图表和 AI 分析中持续标明“模拟趋势”；模拟值不得计入真实价格变化记录，也不得表述为真实调价、成交价或市场事实。Sonnet 只能基于对应数据口径生成销售分析，禁止编造房东动机、市场背景、心理底价、成交概率或谈判时机，出现越界表达时必须自动重写或回退为确定性数据分析。