阿拉丁神灯 全球需求社交与企业获客系统设计任务书 V2

版本：V2.0。日期：2026年11月5日。状态：范围与验收基线。2026年11月6日已开始G1A开发，执行状态见开发计划；生产部署未获验收。

阿拉丁神灯帮助全球个人、企业与专业团队表达需求、展示能力、找到合适伙伴，并以熟悉的语言推进交流。每个市场的参与者都可作为需求方、供给方或协作者。首期以企业发现和可追溯研究提供独立的付费价值，同时保留免费需求发布与双向交流，让持续合作形成社交网络。

本任务书合并此前的产品、品牌、DSH、BettaFish、WorldMonitor、oceavant获客思路与盈利分析，并纳入七个候选项目的源码调查。它是后续实施的当前评审基线；V1设计保留为设计历史，Logo与界面概念继续作为候选视觉方向。

本轮成果为任务书与静态源码调查，不代表七个项目已经集成、运行或达到生产效果。版本、许可、具体源码和待核事项见组件调查附录与机器可读快照。

1 产品目标与首期边界

1.1 产品原则

首期建议选择一个产品或能力明确的细分行业及两个目标市场，例如创客、小批量制造或工程服务。行业由评审决定，不能把某个开源项目的矿业提示词当全行业模型。

1.2 首期交付闭环

用户确认能力档案 → 选择市场与目标角色 → 发现候选企业 → 读取原文并解释适配 → 用户选定少数候选 → 按需补全/核验联系入口 → 审核联系草稿 → 记录回复与需求进展 → 双方愿意时进入双语交流。

首期工作台提供可独立使用的企业研究与机会雷达。基础需求/能力卡和交流入口同步保留；完整社交推荐、复杂营销旅程与订单履约逐步扩展。此顺序调整了V1先铺完整社交MVP的设想，目的是在网络规模较小时仍能交付用户愿意付费的价值。

首期不包含全行业全平台覆盖、自动生成站内买家、自动群发、付款托管、自动成交、语音同传、产品视频生产或完整ERP。公开网页候选始终与当事人发布的需求分开。

2 已合并的前序研究结论

上述事实的官方来源和限制见调查附录第8节。模型评分、邮箱技术状态、邮件打开事件均不能升级为“已确认高意向”。

3 七个候选项目的选型决策

下表是设计建议，接入仍须通过版本、许可、接口和运行验证。

Crawl4AI读取网页，Reacher检查已知地址，Dittofeed经营已有用户，TradePilot管理业务进展。七者仍不能自动提供已核实的采购负责人数据库、真实采购需求、阿拉丁社交关系和统一商业授权。这些缺口必须明确建模。

4 用户流程与页面任务

复用现有品牌概念，新增工作台、证据抽屉、联系核验与费用确认、失败/空/过期状态的设计稿。手机优先支持查看机会、证据、审批和沟通；批量研究与复杂旅程配置可后置。当前三张图片是概念，不是这些新增页面已完成的证明。

5 数据对象与判断边界

5.1 统一数据对象

5.2 四种判断分别保留

1. 企业适配：可能购买、使用、集成或分销本产品的依据；同一企业允许多角色。
2. 当前需求证据：当事人发布、公开询价/招标、项目变化等；没有证据时明确未知。
3. 联系人角色依据：身份、任职与采购职责分别核查；邮箱可达不能补足角色证据。
4. 地址与交流状态：技术可达判断、对方回复、同意交流、具体需求推进各自记录。

模型低分、接口失败、页面读取失败和资料不足必须是不同状态。禁止把非空邮箱、POI评分、抽取数量、模型confidence或打开次数映射为已验证买家/采购概率。普通info@等角色地址不一律删除，保留公开联系入口与实际反馈。

6 推荐技术架构与职责

图表文字 · Diagram source

flowchart TD
  Clients[Web 手机 桌面壳] --> API[业务API 身份 权限 配额]
  API --> Core[需求 能力 企业 社交 会话 用量]
  Core --> DB[(PostgreSQL业务真相源)]
  Core --> Outbox[持久任务与Outbox]
  Outbox --> Agent[隔离DSH研究worker]
  Agent --> Search[SearchProvider 选定搜索服务]
  Agent --> Reader[ContentExtractor DSH Fetch或Crawl4AI]
  Outbox --> Maps[可选Maps候选连接器]
  Reader --> Evidence[证据存储和实体归并]
  Maps --> Evidence
  Evidence --> Fit[适配与需求信号工具]
  Fit --> DB
  Fit --> Contact[按需ContactEnricher 外接授权来源]
  Contact --> Verify[EmailVerifier Reacher候选]
  API --> Translation[独立翻译服务与版本化缓存]
  API --> Approval[用户确认 动作与版本绑定]
  Approval --> Dispatch[唯一发送网关 停止名单 幂等]
  Dispatch --> Channels[获准邮件或站内会话]
  Outbox --> Engagement[后期Dittofeed内部生命周期]
  API --> CRM[后期TradeWorkflow适配或导出]
  CRM --> TradePilot[TradePilot等CRM候选]

6.1 核心服务

延续Vue3与Tauri/Capacitor工程经验，业务API建议采用TypeScript模块化服务，PostgreSQL保存正式业务状态，附件与证据走受控对象存储，WebSocket推送状态。服务部署在云端，客户端关闭不停止雷达；旧桌面内置Python/Node模式保留原应用，不升级成全球多租户后端。

初期使用持久任务、数据库outbox和隔离worker；按负载再引入额外缓存或队列产品。第三方内部使用的Temporal等队列不成为阿拉丁业务状态真相源。DSH是唯一智能体主编排器，业务服务是唯一授权和写入入口。若单独试用AI Hunter，必须作为有边界的子任务，不能与DSH互相无限委托。

6.2 搜索与网页读取

SearchProvider负责发现URL；ContentExtractor负责读取给定URL。官方DSH Search/Fetch、博查与AnySearch通过独立适配器接入，每个任务使用显式选择的提供方及预算。全球覆盖和语言相关性须实测，不因既有国内接入就承诺全球效果。

轻量读取可使用DSH Fetch；需要JS渲染、批量站内产品页或结构化时按策略调用Crawl4AI。自托管Crawl4AI与其Cloud搜索是不同产品能力；TradePilot的Firecrawl Cloud搜索也不能仅换一个抓取库就保持等价。切换提供方须记录原因与成本，不自动向所有服务扇出同一请求。

网页读取包装层只接受获准公开HTTP(S) URL，检查跳转与解析后的网络范围，限制域名、深度、页数、并发、时间和内存。Crawl4AI的本地文件、任意脚本等功能不向模型暴露。遇到登录、访问限制或不可读页面返回blocked/partial，不标记为已读全文。网页文字不作为系统指令。

6.3 联系补全与Reacher

ContactEnricher是明确缺口：七个项目没有自动提供完整、获准且新鲜的采购负责人数据库。首期使用用户自有、公开工作联系入口或经授权提供方；付费来源的预算、条款和失败扣费方式单独确认。

仅在公司已筛选且用户选择之后进行邮箱技术核验。Reacher优先评估v1契约，保留四种状态与方法；catch-all保留risky及分项标记，无法判定保留unknown，safe不显示为身份/意向认证。配置核验方法白名单，不默认启用账号恢复等额外探测。SMTP路径有真实外部网络交互，使用获准验证地址先验出口、并发和重试；网络不支持时保持blocked/unknown或切换获准托管服务。

6.4 Dittofeed与发送权威

Dittofeed候选用于平台用户的欢迎、雷达通知、功能教育及获准的消息旅程。它不负责找买家、发现邮箱、租户鉴权或收件箱事实。首期不向外部客户暴露其管理界面；多租户营销、嵌入和白标的许可与隔离方案通过评审后才能扩展，不能把workspace或前端过滤当安全边界。

只由服务端桥接经鉴权的业务事件。Dittofeed的Write Key、客户端track或traits不能作为审批/租户/付款权限证明；Webhook关联标签仅供查找业务快照，不能自行指定获准收件人或动作。其Localized Delay有接收者时区能力，使用时需保存时区依据并验证默认与DST行为。

阿拉丁只保留一个最终发送网关。外部营销旅程须通过Webhook消息节点接入同一网关，再校验审批/订阅范围、即时停止名单、预算和幂等，不能让默认ESP直连绕过它；该路径未验证则不启用外部营销。仅发送异步订阅变更事件不保证立即停发。回复收取、需求推进和报价状态由会话/CRM服务处理，不假定Dittofeed天然拥有这些事实。

发送状态至少区分draft、approved、queued、dispatching、provider_accepted、delivered、bounced、replied、suppressed、failed和delivery_unknown。供应商接受不等于送达；打开不等于真人阅读。若超时后无法确定是否已接受，进入待核对状态，不盲目重新发送。

6.5 TradePilot与业务承接

TradePilot作为询盘、报价、订单、出货和客户权限模型的参考，现有Next.js/React实现不直接变成Vue组件。首期先做客户池、负责人、跟进状态和导出；后期通过TradeWorkflow适配客户与询盘草稿。正式报价、订单和承诺必须人工确认。

选择复制或派生TradePilot时，需要明确AGPL履约方案及实际许可文本，完成多租户、备份、供应商和生产运维验收。不能把其README受控部署状态当公网SaaS就绪，也不能把老审计中的已修问题继续当当前事实。语音、视频、ERP式扩展不进入首期主链。

7 提供方适配契约

所有接口共享tenant/actor授权上下文、job_id、对象版本、deadline、预算、幂等键和取消信号；外部提供方不自行接收可信租户ID决定权限。

提供方不可用、未配置、请求被阻断、超时、部分结果、无结果和技术成功必须分别返回。参数不支持时显式失败，不能悄悄改变模式或使用另一客户的密钥。

8 语言与消息体验

界面语言、阅读语言、不翻译语言和会话语言分别设置。原文与内容版本永久作为基准；缓存键至少包含版本、目标语言、术语表版本及权限域。公开译文可共享的范围取决于来源授权，私聊译文只向会话成员开放。

先可靠保存和送达原文，再异步提供译文；失败可继续查看原文，显示翻译失败或处理中。草稿修改后旧预览失效。金额、币种、数量、单位、型号、日期和贸易术语保留结构化原值，语言展示不自动改写交易条件。

首期验证中英文本，西语作为扩展候选；概念图中的西语不代表服务质量已验收。实时定义为新消息到达后异步产生译文，时延按区域、语言与缓存分别测量，不承诺零延迟或语音同传。

9 预算、调度与费用记录

每项研究必须有搜索次数、页面数、域名/深度、模型输入输出、最大时间、并发、联系补全与地址核验预算。未配置上限的任务不得启动。沿用现有单次1Search/最多3Fetch作为小任务验证起点；批次任务按明确预算扩展，不把它当全局雷达配额。

执行采用预留、消耗记录、结算/释放；供应商成功请求、失败尝试、平台研究额度和用户账单分开。技术失败返还何种额度、无有效结果如何计费、重查刷新期限须在收费前公开。没有买家结论也可能是有效研究，不能为扣费而制造阳性结果。

雷达按来源刷新政策、内容变化与用户条件调度，保留最后成功状态；外部发布、发现、读取和核对时间分别记录。当地发送窗口必须有时区依据与DST规则，未知时区不伪装准确；Host运行提醒不能替代业务持久调度。

月度总成本同时包括搜索/模型、浏览器算力、地图维护、联系人数据与验证、翻译、存储、邮件与渠道、客服核查、数据授权、人力、支付退款及新增获客。缓存去重需遵守租户权限与数据许可，不能把授权联系人跨客户共享以省成本。

10 商业化与单元经济验证

建议免费提供需求/能力发布、基础发现、关注和双方同意的正常沟通；付费提供持续雷达、可追溯研究、团队机会池与协作。深度研究、批量资料和付费补全按明示额度管理，不能靠售卖信任标识或陌生人骚扰权限获利。

此前个人99元/月、团队699元/月含3席仅为价格实验。冷启动可先邀请约10支团队成为付费设计伙伴，公开基础价格，复杂行业配置提供演示。记录人工工时，验证用户是否愿意续费后再增加套餐。

以下合并前序预算示例，所有转化率与成本均是假设，不是供应商报价、当前账单或收入预测。新组件的实际资源与授权费用尚需任务B13测定。

同一假设下约616个个人账号加20个团队接近平衡，不能由此推断能达到该转化率。免费服务从每人0.5元变1.5元时，成本再增加9,640元。加入联系人数据、Dittofeed完整依赖和生产支持后必须重算，不能把贡献率当利润。

主要指标为人工确认的适配企业比例、每家有效候选成本、联系人角色依据覆盖、有效回复、双方接受交流、需求推进、续费、翻译纠错与屏蔽举报。未有真实留存前不报告推算的漂亮LTV，先测各用户组的CAC回收和90日使用/续费。

11 分阶段任务包

角色为建议责任分工，不假定已有团队或承诺交付日期。阶段按出口条件推进，技术验证先于产品承诺。

阶段安排

• G0 评审基线：本任务书、组件调查、视觉参考；明确首期行业/市场/语言、商业许可与可接受预算。
• G1 技术与数据验证：B01、B02、B03、B04、B05、B06、B16；证明能找到相关企业并给出原文依据，完成权限/状态基础和基线对照。尚不对外自动联系。
• G2 可付费工作台试点：B07、B08、B09、B10、B11、B13、B17；完成小团队可用闭环，有明确同意的交流与反馈。B12只在地图价值和来源条件成立时加入。
• G3 持续运营和业务承接：稳定雷达与续费后做B14、B15、B18，按业务需要扩展语言、团队和市场，补充真实通知/渠道联调。

日期和人员排期在G0后按任务估量确定，不能用开源项目的README“一键部署”代替整套产品开发工期。

12 验收方法与发布门槛

12.1 质量验证

建议建立约50家人工标注的候选池作为首轮样本，覆盖下游厂、渠道商、集成商、同行、目录、过期需求与证据不足。固定同一产品版本和两个市场，对比普通关键词基线与上下游研究流程。样本规模和精确率目标在G0冻结；可暂以人工确认适配精确率80%作为试点目标，它不是已达到的结果或通用行业标准。

分别报告候选产出、人工适配精确率、有效对象误排除、未知比例和每家有效候选成本。未建立完整相关集合前不宣称全网召回率。AI Hunter原precision只作为抽取产出指标，不能替代本评估。

12.2 必须通过的行为检查

只有阶段运行报告、许可与数据条件、明确费用和真实用户反馈通过后，才允许从受控试点转公网服务。全球覆盖、真实性、送达与获客效果按证据描述，不以开源项目数量或页面能打开替代验收。

13 待评审决策

1. 首期产品/行业、两个目标市场与中英语言验证范围；西语是否同批进入。
2. 先用企业发现和研究工具验证付费，再逐步扩大社交网络的顺序。
3. 联系人补全来源、邮箱核验方法、发送渠道和允许的费用上限。
4. Dittofeed的内部运营/企业授权路线，以及TradePilot的参考、适配或AGPL派生路线。
5. 免费服务边界、个人/团队价格实验和有效对话定义；不得承诺尚未验证的利润或转化率。

任务书形成时仅完成设计和静态调查。后续本地开发、试点决策与运行验证以开发计划和实际开发记录为准。

附录 A 海外基建与建设专题

A.1 用户与首期产品边界

专题服务不同市场的企业、在地机构和从业者，围绕三个决定组织首页。这个标实际采购什么、我能以哪种角色参与、下一步最迟什么时候做。 首期建议从南部非洲道路、桥梁和养护切入，以南非为现场验证市场。把施工、设计监理、设备材料供应和项目配套分别标记。同一个交通项目下，可以同时存在总包、专业分包机会、咨询采购和纯货物采购。第二批优先考虑纳米比亚交通项目，水务、房建、电力和更多市场复用数据模型后分批开放。正式扩围取决于可用来源、实际用户和当地专业贡献者。 纳米比亚道路局公开标讯

能力档案支持先跳过、后补充。企业证照、业绩和投标准备项默认留在自己的工作区。基建专题的首页默认条件复用已保存筛选。工程和服务按工程用途、采购类别和工作内容查找，设备材料可加 HS 商品章。

A.2 来源准入与首批接入

每个国家新增来源前，登记发布人、可采集范围、复用与翻译许可、许可版本、访问条件、刷新频率和故障联系人。来源健康、覆盖日期和实际命中单独展示。国别扩展按工程客群需求、标段字段可取性、补遗时效、运营复核成本及可核实的活跃机会排序。

A.3 专题首页、机会详情和资格判断

入口为「发现 → 基建与建设」。地图用工程发生地定位，独立显示业主所在地。已取得路段或场址时用明确位置，只有国家或省份时用对应行政区范围。地图下按「正式机会」「预告及资格预审」「补遗和截止变化」「业绩与授标」分流。卡片默认只显示标的、所在市场、采购方、可参加的角色、最近强制节点、证据等级和官方链接。补遗自动触发原公告的变动提示，分享链接定位到对应标段和证据版本。

详情按「标的与工期」「资格和参与方式」「截止与补遗」「文件清单」「我的跟进」组织。企业档案逐项比对，输出「已提供依据」「需补资料」「可能不符合」「待人工核对」，并显示原条款、条款所属角色、有效版本和数据缺口。总包门槛只对对应投标角色使用。系统可以提醒核查联合体或分包资格，结论依赖该标段的适用条款和用户提供的资质证据。资格无法确认时可收藏、提问或发起受邀联系。

SANRAL 西开普 N1 扩容样本可展示为「N1 第 1 段 km18.90–33.00 扩容，约 60 个月」。页面将 2026 年 11 月 20 日 10:00 的强制现场说明会单列为较早节点，另外列明 2027 年 2 月 12 日 12:00 南非时间的投标截止和实体投标箱，以及公告列出的 CIDB 9CE、CSD 登记和至少 30% 定向分包条件。当前可参与状态以每次核验和后续补遗为准。 SANRAL 原公告

A.4 数据与证据结构

采用「工程项目 → 采购包 → 标段 → 公告版本」模型，保留来源原生标识。一个版本可关联多个标段，一项补遗可修改其中部分标段的节点或资格。项目及采购包的拆分参考 OC4IDS 与 OCDS。 OC4IDS 项目模型 · OCDS 流程标识

结构化索引、正文、补遗或标段之间有冲突时，展示候选值、来源位置和「截止待核对」，暂停把该节点用于可参与排序和提醒。只有带有明确作用范围和权威引用的有效补遗才覆盖旧节点。日期缺时刻、时区未知或仅写午夜时保留精度。增量查询缺失只影响新鲜度。案例如 SANRAL N2 页头写 11 月 18 日，正文写 11 月 6 日，且列有后续材料。世行马达加斯加修缮公告的索引和正文也存在两种日期。 SANRAL N2 公告 · 世行修缮公告

A.5 海外贡献者与盈利

将海外从业者定位为专业贡献者，审核所在地、可服务专业、资历和利益关系。发布页面显式区分官方发布人、贡献者和审核者。让贡献者先发布可追溯的公开线索、补遗提醒或材料索引，再选择是否提供付费的原创专业服务。

发布流程为「身份核验 → 绑定官方证据和包号 → 重复、时效和权限检查 → 独立编辑确认 → 公示版本 → 异议与更正 → 结算」。审核队列单独处理未公开文件、评标内部资料、他人投标底价、个人证件和利益冲突。分成依据公开写入订单，资金通过经审核的支付与结算服务，账号实名、税务、币种和支付区域按试点所在地校验。世行已经提供免费公告订阅，阿拉丁的付费点集中在资质筛选、关键补遗追踪、双语准备工具、团队协作和本地专家交付。订单和订阅分别核算净收入、作者报酬、审核、翻译、取证、支付与退款成本。 世行订阅服务

A.6 实现分层与阶段验收

现有世界地图、需求流、HS 商品选择、保存筛选、公告快照和近期状态对照、证据抽屉、账号私有备注、运营审核、双向同意会话及阅读偏好可以复用。官方 DSH 用于获准来源的定向补查，Crawl4AI 用于获准页面取证，生成的中文解读绑定原文版本并供编辑核对。新增开发包括工程专题分类与角色匹配、项目及标段实体、按权限采集的适配器、补遗与强制节点判断、资料权利登记，以及贡献审核和订单结算。BettaFish 的多源研判可用于项目环境与风险背景，工程投标条件以对应标段和官方文件的可追溯证据为准。