assistant/docs/橘子拓客结果交付与知识复用优化方案-v0.3.md

# 橘子拓客结果交付与知识复用优化方案

版本 v0.3。日期 2026年10月29日。状态 用户已批准，首轮程序实现及本地验收已完成；真实平台复用及业务效果继续待验收。

本次优化让用户清楚看到已交付的成果，同时让系统依据实际执行证据持续积累、选择和淘汰操作经验。正常使用流程为：用户交代目标，系统执行并交付，用户按需反馈；知识由系统自动留证、试用和评估，人工审核不作为日常必经步骤。

方案覆盖结果状态、名单呈现、知识结构、自动验证、可信度排序、链路复用和验收。保留已实现的自然语言入口、明确人数目标、按人去重、分析复用、真实用量记录及关注私信授权。当前实现见 [DESIGN](DESIGN.md)，最近知识审计与修复见 [PROGRESS 的 D34](PROGRESS.md)。

## 1 实施前问题和本次目标（保留审核基线）

当前名单按行统一显示需求待核实，证据详情也使用固定待核提示。用户已经收到结果，却容易理解为还要逐条人工审核，才能完成任务。

现有知识支持操作草稿、页面证据、试用回执与草稿的基础升降级。召回主要按小红书业务范围筛选，将已验证项排在草稿前，取少量条目注入，两种状态均可参与试用；相符回执会核对证据是否存在于页面，但尚未充分检查动作后的实际变化。连续排名、细粒度场景匹配、已验证经验遇到反证后的自动停用仍需完善。

最近杭州跟妆任务保存了正文、评论、回复三类任务草稿，共享库实际只有一条未验证草稿，跨任务验证为零。误合并与旧快照覆盖的程序缺陷已经修复，历史记录保留。这些记录只能支持操作草稿，不能作为完整获客链路已经学会的依据。

本版目标：交付状态准确，结果缺项具体，知识自动验证，复用依据可追溯，可信度随独立证据变化。操作可靠性、名单质量与业务效果分别评价。

## 2 任务交付与结果信息分别表达

### 任务是否完成

任务完成依据用户明确要求的范围、人数和产物，由程序判断。名单已经保存并可在对话和历史中查看，就可以构成交付；用户明确要求文件时，还需成功生成对应文件。点击下载和人工审完每条线索都不作为通用完成条件。

| 实际情况 | 主标题示例 | 必须保留的信息 |
| --- | --- | --- |
| 已达到人数或有限范围，并完成要求的产物 | 名单已交付 共20位 | 本次标准、按人去重后的数量、证据与文件入口 |
| 目标20位，实际8位后受阻或用户停止 | 阶段成果已交付 共8位 目标20位 | 剩余12位未完成、实际停止原因、已有成果及继续选项 |
| 执行仍在进行，但已形成部分名单 | 已整理8位 正在继续 | 真实新增成果和当前阶段，避免提前显示整任务完成 |
| 用户要求检查的有限页面已处理，未发现符合条件的人 | 本次检查已完成 未发现符合条件的候选 | 实际读取范围与筛选依据 |
| 页面无法读取或没有取得有效来源 | 本阶段未取得可判断的资料 | 未读范围与阻碍，不能据此称没有需求 |
| 只要求导出已有名单且文件已生成 | 文件已生成 | 文件版本、生成时间和对应结果范围 |

执行状态、目标达成程度和产物是否可查看分别记录。即使任务中断，已有文件仍可交付；生成文件也不能把尚未完成的目标改成完成。保留程序停止原因、采集原始结论及实际检索覆盖，不用新的标题掩盖原失败。

### 缺失信息是否影响达标

必要条件由本次目标决定。用户只要求寻找候选时，可选账号字段缺失不阻止交付；用户明确要求20个可见小红书号时，实际取得且正确归属的账号号数才计入该项完成量。用户明确规定的地区或需求条件缺少依据时，列为补充来源，不混入满足条件的数量。

同一人多条原话合并。无法区分身份的来源单列，不凑人数；昵称、内部用户标识、主页入口与页面可见小红书号继续分别处理。目标未提供的产品、地区或联系方式不增加为必填项。

## 3 名单与对话界面

移除统一的需求待核实标签，按已有证据展示具体状态。状态必须由来源和分析字段生成，不能仅替换成更积极的固定文案。

| 信息维度 | 展示方式示例 | 依据与限制 |
| --- | --- | --- |
| 需求表达 | 本人明确表达需求 相关需求信号 语境不足 | 回指本人原话与理由，分享经验和同行广告分别判断 |
| 身份关联 | 来源身份可区分 主页号已获取 无法区分身份 | 保持笔记、评论、回复与主页的归属一致 |
| 地区 | 需求原话支持 相关信息不足 地区不匹配 | 说明依据来自哪里；IP属地不作服务地点 |
| 账号字段 | 已取得小红书号 账号号未获取 | 有主页入口不等于已取得可见账号号 |
| 跟进进展 | 未执行 已关注 已发送 发送失败 结果未知 已回复 | 来自真实动作记录或明确反馈，已发送不等于已回复 |

这些维度分别展示。例如账号已取得，但需求语境不足，不能用一个已核实标签替代全部信息。

结果卡优先展示交付数量、匹配依据、具体缺项和产物。证据原话、主页入口、观察时间、未读范围按需展开。缺项分组可以筛选，用户可直接查看、导出或提出下一步要求，无需进入审核流程。

保留可选的纠正这条、补充账号信息和重新按新标准分析。用户调整标准后，旧结果与文件保留原版本，系统说明哪些判断需要重算，避免将旧名单自动当作新目标成果。

假设示例：用户要求整理20位候选，实际已达到目标，可以显示名单已交付共20位；下方说明其中12位有本人明确需求原话、8位为相关需求信号，以及哪些账号字段尚未取得。若用户原要求只接受明确需求，则后8位单列补充来源，本次达标人数应为12位。

## 4 分层沉淀内容

| 层次 | 保存内容 | 复用单位 |
| --- | --- | --- |
| 操作能力 | 适用页面、参数、前置条件、操作方法、成功标准、失败恢复、版本与证据 | 展开一组回复 保存某类来源 读取主页号 |
| 阶段链路 | 操作能力组合、顺序、分支、阶段产物、恢复点及依赖版本 | 阅读讨论并归属发言人 核对账号并整理名单 |
| 业务策略 | 适用行业与目标、搜索方向、筛选标准、反馈样本和效果来源 | 相近业务中选择搜索方向或筛选方法 |
| 本次任务资料 | 用户目标、参数、名单、原话、授权、文件、进度和反馈 | 同一任务继续与追溯 |

操作与阶段链路中的城市、关键词、对象和话术作为参数传入，不固定成上次任务内容。私密业务偏好按所属工作区和用户范围保存。个人昵称、账号、评论原话及签名链接留在任务资料，不写入通用操作方法。

预置阶段模板、模型提出的方法和真实任务归纳的方法分别标记来源。预置模板可用于规划，其存在本身不增加真实验证次数。完整链路只对实际执行过的分支形成验证记录；各小操作成功不能直接推导整条链路成功。

## 5 知识记录与版本

每条方法记录稳定标识、能力与来源类型、适用条件、参数、步骤、预期结果、恢复方法、依赖版本，以及证据引用、独立验证数量、最近结果和当前可用状态。

任务内的详细证据与共享知识元信息保持关联，避免只把一段方法文字写入共享库，却丢失它的适用条件和验证依据。能力、来源类型与版本继续按独立身份保存，不因文案相似误合并。

验证记录保存方法版本、任务及目标版本、实际对象引用、运行与动作标识、动作前后证据、结果类别、原因、验证方式和时间。原始页面资料仍保留在任务证据中，共享记录只保存必要引用和去标识后的覆盖指标。

知识内容改变时产生新版本，旧版本及回执可追溯。旧错配记录保留审计，默认不进入优先推荐，不通过迁移直接补成高可信知识。

## 6 自动沉淀与验证

执行留证 → 独立复盘整理方法 → 后续任务受控试用 → 系统核验实际变化 → 更新排序或暂停相应版本。

复盘从真实动作和来源提炼方法。模型可提出候选步骤，程序为可验证的动作补齐前置条件与成功标准；只有文字描述、缺少执行依据的方法进入探索候选，不能登记为已成功验证。

### 优先使用程序验收

| 能力 | 自动成功依据 | 不构成成功的情况 |
| --- | --- | --- |
| 展开回复 | 出现新增回复或讨论标识，归属当前父评论，保存时作者和层级独立 | 仅点击过按钮 页面没有新增 有回复但归属无法判断 |
| 保存来源 | 原话属于当前独立容器，来源类型与作者归属通过核对，记录实际持久化 | 把父评论原话保存成回复者需求 只有模型总结 |
| 核对主页号 | 来源作者入口与实际主页匹配，页面可见账号号已读取并保存 | 只有昵称 内部profile标识 猜造链接 |
| 名单导出 | 当前结果版本的文件存在，按人分组和必要字段符合要求，入口可打开 | 只返回文件名 路径失效 文件对应旧目标却标最新 |
| 受授权的跟进 | 动作账本与相应页面结果一致 | 只有点击或输入记录 超时后结果未知 |

先利用已产生的页面观察、来源记录和动作账本验证，不默认每一步再调用一个模型。语义有歧义时可以按需分析；仍不能判定的结果保持未知，不增加成功次数。用户纠错可以触发针对已有证据的重算，不默认重跑浏览器。

任务整体未完成时，已经有独立成功依据的小操作仍可留作经验；整任务失败也不能把所有小操作都记为失败。

### 统一验证结果

| 结果类别 | 对知识评价的影响 |
| --- | --- |
| 有证据的成功 | 满足独立性条件后增加成功验证 |
| 与方法直接相关的不符 | 增加反证，并暂停相应场景的方法版本 |
| 平台限制 登录要求 服务不可用 | 记录阻断和适用条件，不直接算方法错误或成功 |
| 程序执行异常 | 单独记录程序问题；未证实方法失效时不记方法反证，也不算成功 |
| 未使用 | 保留召回记录，不计入可靠性分母 |
| 结果未知或证据不足 | 记录缺口，不算成功或反证 |

证据出现在页面中只证明它被观察到，成功还须满足方法声明的动作结果。回执由执行模型提出时，保存其来源；通过程序验收的事实与尚待系统判定的模型报告分开。

## 7 独立验证与可信度排名

### 先匹配适用条件

先检查平台、阶段、能力、来源类型、页面结构特征、方法与依赖版本，以及本次动作是否在用户授权范围内，再比较可信度。不兼容或有未解决反证的方法暂停在当前场景使用；高分不能跳过这些条件。

适用性比较使用必要的结构特征，不依赖固定屏幕坐标、临时页面索引或签名链接。每次复用仍从当前页面确认真实入口。页面变化触发重验或新版本，不永久沿用过去的成功结论。

### 按独立证据累计

同一方法在同一任务内重试、重复回填、导出或重启恢复，不重复增加可信度。S和F只计入选定的独立验证样本：在同一方法版本和场景统计范围内，同一任务、同一对象均最多贡献一个计数。同对象跨任务重复成功不再增加S，同一问题反复失败不重复增加F；同一任务的其他对象可增加覆盖记录。样本选择规则和参与计数的事件留档，避免只挑成功事件。

重复对象出现新的相反证据时，更新其有效结论并重算相关统计；明确反证仍立即暂停对应场景，不能因统计去重忽略它。新的页面环境或方法版本使用自己的统计范围，旧证据只作历史参考。

保存不可变验证事件与修订依据，按有效事件计算当前统计。重复写入保持幂等，修正旧回执时重新计算相关计数；不能数据库回执只留一行，计数却因反复提交不断增加。恢复冲突保留双方依据。按事件记录已处理位置，避免任务整体已回填标记吞掉后续新增经验回执。

### 首版排序规则

首版采用可解释的层级与排序，不向用户展示未经校准的成功概率。以下为用户已批准的初始规则，配置和计算规则均记录版本：

1. 无独立成功验证的方法列为探索候选；有真实成功依据但样本有限的方法列为可试用。
2. 优先复用层至少有3个独立任务、3个不同对象的有效覆盖，当前场景匹配，且没有未解决的相关反证。数量门槛只是初步保护，不单独决定排名。
3. 在适用方法之间，结合有证据的成功与相关失败进行样本修正。可先使用排序指标 R＝（S＋1）÷（S＋F＋2），其中S、F是按独立性规则认可的成功与相关失败次数。它是内部排序指标，不是实际成功概率；少量样本仍保留样本有限标识。
4. 同层参考证据完整度、最近有效验证、对象覆盖和当前目标相关性；可靠性相近时优先更少重复、更低模型用量的方法。不为追求低成本忽略必要证据。
5. 已经进入优先复用的方法也持续接收反证。出现明确不适用证据时，立即暂停对应场景，记录原因；修复后用新版本或新的适用范围重新验证。

方法A一次成功得到的修正指标为2/3；方法B在100个独立有效验证中成功90次，指标为91/102。排序同时展示样本与适用范围，这个比较不代表A或B的未来成功概率已经被测准。

新方法通过真实用户任务中的适合环节受控试用。优先在只读、可恢复的小操作上验证，不为提高知识分数另起无关任务、额外触达用户或无限探索；已经有稳定方法时，探索不会成为交付的前置阻碍。

### 知识界面

知识卡显示优先复用、可试用、探索候选或当前场景暂停，并列出为什么适用、独立任务与对象覆盖、成功/反证/未知、最近验证及证据入口。保留用户可选的纠正或不适用反馈，常规路径不要求人工批准每条知识。

历史数据缺少完整计量时标记历史记录不完整，不能从缺失推算为零次失败或高可靠。人工确认、程序验收和模型建议分别标明来源。

## 8 阶段链路与业务效果

将已具备依据的小操作组合成带参数、分支、产物和恢复点的阶段链路。规划时选择适用方法，运行中按实际页面调整；保存实际执行了哪条分支、用了哪些能力版本及哪些结果验证通过。

链路技术可靠性只统计其明确终点是否完成，部分交付与受阻分别记账。修改能力或阶段版本后，旧链路记录保留，不能把旧版本成功全部归到新版本。

业务效果另记三个维度：名单与目标的匹配质量、用户认可、实际跟进结果。关键词和路线只在相近行业、目标和观察范围内比较，显示有效样本与来源，负面反馈和无回复也保留。回复、确认需求和合作分别记录；不能把所有后续成交都归功于一次搜索或某条操作经验。

任务👍/👎关联当时的目标和结果版本，可用于满意度及问题定位；单条纠正关联具体来源。它们不自动增加每条方法的技术成功次数。缺少逐条归因依据时，业务效果保持未知。

## 9 成本与恢复

沿用已有输入版本缓存、增量分析和真实供应商用量记录。知识验证优先消费现有执行证据，模型只处理需要语义判断的内容；同一事件或同一份资料重复打开不新增分析调用。

持续保存任务目标、已处理对象、实际覆盖、文件版本、动作账本、方法版本及验证事件。程序重启和用户继续沿原任务接续，不因更换推荐方法清空累计进度。对未知发送结果继续保留禁止自动重发的处理，不把方法换版本当成新发送授权。

保留用户明确的候选人数或有限范围，以及无默认阅读篇数、评论数、总步数和自建余额的约定。知识试用数量属于内部选择，不转化为用户的业务阅读配额。Search/Fetch继续按既有记录后续讨论，本版不扩展。

## 10 实施顺序

| 阶段 | 主要交付 | 进入下一阶段的条件 |
| --- | --- | --- |
| 第一阶段 结果表达 | 任务交付与缺项分离 目标与必要字段一致 名单按证据生成状态 | 已完成与部分交付准确，UI和CSV统计一致 |
| 第二阶段 验证依据 | 结构化知识与证据引用 程序验收 验证事件及去重 | 重复或未知不增成功，阻断与反证区分，历史不被改写 |
| 第三阶段 经验选择 | 场景匹配 可信度排序 受控试用 暂停与新版本 | 小样本不冒充稳定，高分不跨条件使用，旧高等级经验可失效 |
| 第四阶段 链路与效果 | 参数化阶段组合 分支验收 用户反馈与业务效果分开归因 | 不同对象能复用，实际路径有依据，完整链路成功不靠拼接推断 |

优先完成第一阶段，再建立第二阶段的事实基础，之后启用排名。第三阶段不会先给缺少验收依据的数据打高分。每阶段先运行本地回归与隔离界面验证，再借用户已授权任务中的适合环节进行真实验证；没有合适任务时保留尚未真实验证，不另起平台任务。真实关注、私信沿用明确对象及话术授权。

当前技术栈和桌面视觉继续沿用，功能调整集中在拓客编排、来源投影、学习回执、知识存储及结果卡。迁移可重复执行，保留历史来源、文件、草稿、旧版本、授权和动作记录；不为了新界面统一改写旧任务成已完成。

## 11 验收清单

| 验收场景 | 预期结果 |
| --- | --- |
| 已达20位，只有可选字段缺失 | 显示名单已交付20位，逐项说明缺失，不要求逐条审核 |
| 目标20位，8位后中断且已生成文件 | 文件可用，显示阶段成果8/20及真实原因，不改成整任务完成 |
| 目标明确要求20个可见小红书号 | 未取得号的对象不计入该项完成量，昵称与内部ID不代填 |
| 已读有限范围后没有符合条件的人 | 交付真实检查结论；未读取或无来源不能伪装成零需求 |
| 身份未知或同人多条发言 | 未知单列，同人合并，人数和证据条数分开 |
| 用户改目标后打开旧名单或文件 | 标明旧版本；原资料保留，不计新目标达成 |
| 页面有证据文字，但展开操作无新增 | 不算展开成功，保存实际观察和结果 |
| 同任务重复回填、导出、恢复或修订回执 | 不重复增加试用和成功数，计数与有效事件一致 |
| 同对象跨任务反复成功或重复失败 | 不重复抬高S或F；有新的反证时更新结论并暂停相关场景 |
| 平台限制、超时或未采用方法 | 分别记阻断、未知或未用上，不当方法反证 |
| 程序异常导致动作未完成 | 记录程序故障，方法正确性保持未知，不直接扣方法可靠性 |
| 已优先复用的方法出现明确不适用 | 暂停对应场景并留原因，历史成功记录保留 |
| 高排名方法与当前来源类型或页面版本不匹配 | 不直接复用，选择适用方法或重新观察 |
| 新方法仅一次成功，旧方法多对象稳定验证 | 展示样本差异，不能仅按原始成功率判新方法最佳 |
| 用户给整份结果点赞 | 保存结果版本评价，不将所有客户或所有操作升级 |
| 同一来源与标准再次分析 | 复用已有判断，未强制重做时不新增模型分析调用 |
| 任务整体失败但部分操作证据成立 | 分别记录已成功的小操作与未完成阶段，不整体洗白或全部否定 |
| 高可信方法包含当前未获授权的触达 | 不执行，知识排名不能扩大用户动作范围 |
| 旧错配草稿或缺失历史验证数据 | 保留原记录，标明历史或冲突，不自动补成功次数 |

每阶段报告实际变化、本地测试、真实模型和真实平台验证范围，以及尚未解决的问题。最终验收需确认用户能直接使用交付结果，系统能依据独立证据选择和停用方法，且完整链路与获客效果均可追溯。

## 12 用户已确认的实施依据

用户已要求执行以下建议；其中真实验证须由后续已有授权任务产生，不能用迁移或测试补造：

1. 结果以已完成或阶段成果已交付呈现，缺项按字段说明，取消统一的人工待复核感受。
2. 知识由系统自动沉淀、试用和验证，人工纠错为可选补充，不设置日常逐条审核关卡。
3. 复用先看适用条件，再按独立证据、样本修正可靠性、近期表现及成本排序；分数用于选择方法，不代表成交或未来成功概率。
4. 初始采用探索候选、可试用、优先复用和当前场景暂停；优先复用的3任务、3对象门槛及修正排序指标作为首版起点，后续按真实数据调整并保留规则版本。
5. 按结果表达、自动验收、经验排名、链路与效果四阶段实施，保留现有任务数据与授权范围。

## 13 首轮实现范围与验证边界

- **交付**：程序分别计算运行状态、必要条件达成和产物交付。名单、CSV及达标停止共享按人分组与必要字段口径；明确要求的小红书号、本人需求、地区或CSV才纳入必要条件。没有取得有效来源与检查后零匹配分别展示。旧标准结果保留，不能算当前达标。
- **证据与方法**：新增工作区隔离的结构化方法、不可变验证事件和业务反馈三张表。保存来源、展开回复、核对主页、生成文件均接程序验收器；任务内保留前后快照，共享知识只存引用与去标识对象。短时无新增、加载或归属未知不能算成功，也不自动算方法反证。模型建议和模型回执不能自行增加技术成功数。
- **选择与追溯**：适用条件先行，独立任务/对象匹配去重、相关反证暂停、依赖版本与分支终点验收、幂等重放及修订重算已接通。规则版本为 `independent-evidence-v1`。知识卡显示状态、样本、原因及原任务前后快照；用户反馈为可选，不设置逐条人工审批。
- **已接的阶段链路**：限于同篇正文与一条独立评论或回复均成功保存，依赖两条真实操作回执，并保留实际执行分支。它不证明已读完评论，不证明搜索→详情→展开全部回复→主页→触达全链路完成。其余阶段组合与业务策略效果仍需积累后扩展。
- **页面版本限制**：`xhs_visible_dom_v1` 当前代表DOM适配器版本，并非自动识别出的全部平台页面变体；每次工具调用仍核对当前入口和归属。动态页面变体分类及其跨变体复用继续待真实样本验收。
- **历史与业务效果**：历史错配草稿不修写、不补成功，缺失统计标为未记录，默认不参与自动召回。👍/👎、方法纠错及回复/合作等用户后续反馈单独记账，不能增加技术成功或直接证明获客归因。真实工作区当前仍只有原未验证历史草稿，尚无可宣称的跨任务优先复用或最优获客策略。
- **本地验收**：后端全量、类型构建、程序取证/入库/召回/导出贯通与CUA隔离界面验证已覆盖；测试工作区与本机UI夹具不计真实经验。本轮未调用真实模型、Search/Fetch或小红书，不执行关注私信。实际测试数量、截图及桌面加载情况记录在 [PROGRESS D36](PROGRESS.md)。