← 返回目录

第 19 讲　全链案例：普洱跨境

【可执行状态】现在就能做（应用与数据均已就绪，一条链可以真跑一遍）

【本讲对应资产】puer-crossborder 引擎（12 个工具）：puer_status / puer_market / puer_ai_report / puer_design_list / puer_design_generate / puer_design_image / puer_publish / puer_shop / puer_listings / puer_design_script / puer_sales / puer_flow

【本讲原理来源】L3 第 20 课《Function Calling 深度解析》、第 19 课（Agent 成长五步中的“沉淀成技能”）

引子：一条链上，最容易断的是接缝

做过项目的人都知道：单个环节做得再漂亮，接缝处一松，整条链就散了。

例如，市场看板做得漂漂亮亮，可设计廊里的方案跟市场结论对不上；

设计稿出得很好，上架时价格却是拍脑袋填的；

直播话术背得很熟，可卖出去多少、要不要补货，谁也说不清。

每一环都不错，合起来却讲不通一个故事。

打个比方：这就像四人接力，每个人跑得都快，但交棒的时候犹豫一下——

成绩不在个人速度上，在交接的那一下。

这一讲就用一个真实项目（普洱茶跨境）走一遍完整链条，

重点看每一步的“上游交付 → 本步产出 → 交接说明”。

一、场景

杨老师（化名）在云南德宏职业学院教书。德宏挨着缅甸，普洱茶在这条线上本来就有生意。

她手上有一批学生想做的题目：把云南的普洱茶卖到东南亚和北美——选品、出图、上架、直播、复盘，一整套。

过去这类题目的做法是：老师讲一遍流程，学生分组做 PPT，图和数都是“找来的”。

学生学到的是名词，不是链路。

她要的不是这个。她要的是一条能真跑的链：

每一个环节都有真的产出物，每一步的产出物真的交给下一步，最后真的有一批商品挂在网上、真的有一批数据回来。

这一讲就是这个项目（书里叫它“普洱跨境”）从 0 到 1 跑通的完整过程，

由 puer-crossborder 引擎的 12 个工具支撑。

这也是本读本里，“从需求到交付”最完整的一次演示。

二、原理一页：五个环节，三条纪律

打个比方：这条链像一条“茶馆流水线”——进货、拼配、包装、售卖、盘点，

每一道都有上一道的凭据。再比如餐厅后厨：采购单 → 备菜 → 出餐 → 收银 → 盘点，

少一张单子，月底就对不上账。

1. 五环节链路

市场看板 → 设计廊 → 上架 → 直播 → 经营复盘。

这五环画在页面上，就是第 18 讲讲的那个环节链骨架；

五个环节的上游交付、本步产出、交接说明，由 puer_flow 一份契约统一给出，

页面与看板读的是同一份，两处永远一致。

2. 接手任何任务的第一件事：先看现状

puer_status 不用传任何参数，一次就给出：样本量、设计廊状态分布、在架 listing、

普洱购店铺、经营数据是否就绪。接手任何任务前先调它，一眼看清当前走到哪一环。

本书写作时实测的现状是这样的（这些数字后面每一环都要对得上）：

• 数据集 294 条样本
• 设计廊 18 件设计，其中 6 件已上架
• 在架 listing 14 条
• 自有网店「普洱购」在架 14 件，其中 3 件来自设计廊

这四个数字是这条链的账本。 后面每做一步，账本都要能对得上；对不上，就是某一步没真跑。

3. 每一步的“上游交付 → 本步产出 → 交接”

这是这一讲最该带走的一张表。它说明的是：链上的每一步，都靠上一步的东西活着。

看这张表的读法：上一格交给下一格的东西，只有那一样；少一样，下一格就做不了。

第 ③ 环的前置条件写得很死——该设计必须已出图（status=imaged），

这不是建议，是工具会拦住你的硬条件。

例如：市场看板说“礼盒装在 1500 元以内好卖”，设计廊就该出 1500 以内的方案；

再比如设计稿标了“适合送长辈”，直播话术就得沿这个卖点讲——

下游的话，必须是上游结论的下游。

4. 三条纪律（这一讲的骨干）

纪律一：每一步必须真跑。

每一步的产出物，必须由对应的工具真跑出来。报告是 puer_ai_report 跑出来的，

图是 puer_design_image 出的，上架记录是 puer_publish 写进库的——

数字必须是它跑出来的那个数字，不能是“差不多是这个量级”。

纪律二：不许手写替上游产出。

这是最容易犯的错。上游没跑（或者跑失败），就自己写一段“看起来对”的交付物接着往下做。

链在这里断了，而断口是看不见的：页面照样能打开，数据照样漂亮。

但评委只要问一句“这个结论卡是哪一步给的”，就露了。

宁可在这一步卡住把上游补跑，也不要替上游编一个交付物。

纪律三：数字必须能追溯。

页面上的每个数字，都要能指回“哪个工具给的”。

294 条样本是 puer_status 报的；14 条 listing 是 puer_listings 给的；

经营数据里的演示成交，puer_sales 的订单口径里已经标注出来，写材料时如实标，不混进真实成交。

一个数字说不出来源，它就不该出现在交付页面上。

5. 这条链为什么值得摆给学生看

因为它是一条完整的证据链：从一条抓取记录，到一张设计图，到一条写进商品库的上架记录，

到最后一份带口径的经营数据——每一环都有名字、都能被追问。

学生在这条链上学到的不是“跨境电商是什么”，而是一件活从需求到交付要经过哪些手，每一手交什么。

puer_publish 这一环尤其值得讲。它一次完成三件事：

① 生成跨境站点 listing（挂牌价）；② 同步真上架到「普洱购」自有网店；③ 可选自动写直播口播话术 + 逐句配音。

“模拟上架”和“真上架”的区别就在这儿——真上架会写进商品库，

前台分类页立刻可见、可点详情、可加购下单，学生打开手机就能查到。

电商数据链路的四个阶段

例如，把“用数据做生意”这件事往前推二十年：

第一阶段是“凭经验”——选什么货、定什么价，靠老师傅的眼力和人脉；

第二阶段是“看报表”——有了 Excel 和后台数据，事后复盘，但慢半拍；

第三阶段是“上系统”——ERP、CRM 一上，数据实时了，

可系统越上越多，数据反而更碎（一个系统一套口径）；

第四阶段就是这条链在做的事：让环节自己交接——

市场结论交设计、设计交上架、上架交话术、话术交复盘，每一步都有据可查。

再比如，制造业的“看板管理”也是从“凭经验排产”一路走到今天的实时联动。

本质都是同一件事：让数据在同一条链上流动，而不是躺在各自的抽屉里。

带着这个眼光看这一讲，你会发现它讲的不是“怎么卖茶”，

而是“一条业务链该怎么被搭起来”——茶可以换成任何东西。

三、动手三件套

先看一眼：这三步在界面上的样子

这一讲的活，全部在同一个界面上完成：你说一句话，它把看板打开给你看。

看这张图里三件事：

1. 任务标题是「在普洱跨境数智看板标注五环节进度」，而下面那句就是全部输入——

一句话，没有别的设置。

1. 它的回答里写着「已为你打开 叁山普洱·跨境AI数智看板 页面」，

左下角多了一个 puer-kb 引用标签。它真的去开了那个页面，不是描述给你听。

1. 它顺手把五环节进度理了出来：N1–N4 已完成、N5–N6 进行中、N7–N10 未开始。

这张图是全版打开的样子（浏览器里 1920 宽的整屏，不是在某个小窗口里预览）。

关键就在这里：zhenyuonline.cn/puer-kb/ 这个页面，不是一个截图，是一个能点、能刷新、能全屏的活页面。

页面上的每一处都有出处：

这就是本书反复说的那句话：交付不是一个说法，是一个能打开的东西。

一句话指令（逐步推进，一步一确认）

先说总纲，记住这一句：

每一步必须真跑；一次只做一环，验收了再往下。

然后是五条可以直接复制的指令：

1. 看现状：“用 puer_status 看一下普洱跨境现在走到哪一环，把样本量、设计数、已上架数、listing 数、普洱购在架数报给我。”
2. ① 市场看板：“用 puer_market 把市场看板的数据给我（形态分布、价格带、需求主题占比、热销 TOP 10、真实抓取批次），再 puer_ai_report 出一份 AI 市场分析报告。”
3. ② 设计廊：“用 puer_design_generate 生成 2 个新设计方案；然后用 puer_design_image 给它们出图；出完用 puer_design_list 核对状态是不是 imaged。”
4. ③ 上架：“用 puer_publish 把刚出图的那件设计上架，site 传 amazon_sg，with_script 传 True，stock 按库存定；上完用 puer_listings 和 puer_shop 核对。”
5. ④ 直播：“用 puer_design_script 给刚上架的那件出直播口播话术与逐句配音。”
6. ⑤ 经营复盘：“用 puer_sales 把经营数据拉出来，按渠道分开；哪些是演示成交，明确标出来。”

（第 ③ 环想先看货架效果，可以配套用第 18 讲那三个工具：shop_shelf 出货架页看形态，

shop_publish 出上架数据契约，puer_shop_publish 做同一件事的“真写库”版本。）

预期产物

校验点（照着数，别看“页面挺好看”）

1. 账本对得上：puer_status 报的 294 / 18 / 6 / 13 / 13，与交付页面上写的一致
2. 状态推进对：一个新设计的状态轨迹必须是 draft → imaged → published，一步不跳
3. 上架是真写库：puer_publish 之后，去 puer_shop 里能查到那件商品，店铺商品总数增加
4. 交接看得见：puer_flow 里每一步都有上游交付 / 本步产出 / 交接，五环串成闭环
5. 数字可追溯：交付页面上的每个数字，都能说出是哪个工具给的

四、常见错误与排错

错误一：跳环——设计没出图就上架。

表现：直接对一件 status=draft 的设计调 puer_publish，工具拒绝或报错。

原因：第 ③ 环的前置条件写死了“该设计必须已出图（status=imaged）”。

排错：回到第 ② 环，先 puer_design_generate 再 puer_design_image，

用 puer_design_list 确认状态是 imaged，再上架。前置条件不是建议，是门。

错误二：手写替上游产出。

表现：市场那一步没跑，自己写了一段“市场行情分析”当结论卡，接着出设计。

原因：觉得“这步我知道，写一下更快”。

排错：链上任何一格的交付物，必须是工具跑出来的。上游没跑就去补跑——

这一条是这条链能不能被追问的生死线。

错误三：数字对不上——页面改了，链没重跑。

表现：交付页面上写“已有 20 件设计”，puer_status 报的是 18。

原因：改了页面文案，但底下的数据是上一次跑的结果。

排错：以 puer_status 为准，重新跑一遍相关环节。

账本上那五个数字，任何一个对不上都先停下查，不要带着错数往下走。

错误四：把演示数据当真实成交。

表现：把复盘页上的成交额说成真实销售额。

原因：没看订单口径。puer_sales 返回里演示成交是已标注的。

排错：如实写——已上架就说已上架，演示成交就标演示成交，能跑几件说几件。

对外材料里这条尤其重要。

错误五：一次让 AI 把五环全跑完。

表现：一句话下达“把五环全跑一遍”，中间某环失败，后面全歪，要回头收尾一大片。

排错：一次只做一环，验收了再下一环。 这条和第 18 讲那条“一次只改一层”是同一个道理——

链越长，越要一格一格确认。

五、边界与红线

• 数据等级：样本来自公开电商平台的抓取批次（平台、关键词、抓取时间都记录在案），可以直接用；

学生个人信息、未公开的合作方数据不进这条链

• 人的判断不能交出去：工具能出设计、出图、出话术、出补货建议，

但选品定不定、定价定多少、这条线要不要做，是教师和学生的判断，工具给的是依据

• 演示与真实要分开说：供应链、成交数据里凡属演示场景的，页面和材料上都要标注；

不把演示包装成业绩，也不把“上线”说过头

• 学术诚信与署名：环节怎么切、选什么品、话术怎么改，是学生的工作；

平台与工具是技术底座。参赛与结题材料里把这层关系写清楚，既是事实，也是保护

• 可复核：写材料时不要只写“用了 AI”，写成“使用 puer-crossborder 引擎的

puer_market / puer_design_image / puer_publish 完成市场、出图、上架三环”——能复核，才可信

六、拓展与学科迁移

• 同一个作品，两种用场（这一条最实在）：这条链做出来的东西，既能当竞赛作品交上去，

也能当授课案例讲给学生。但两种用场要的东西不一样：

两种用场怕的是同一件事：中间有一环是手写替上去的。

评委一追问就露，学生一照做就断。这就是本讲第 4 点那三条纪律的用处。

• 换品类不换骨架：把“茶”换成咖啡、土陶、山货、文具、地方小吃，

五环节照旧——市场看板（卖什么）→ 产品设计（长什么样）→ 上架（挂到哪个店）→

直播（怎么讲）→ 经营复盘（卖得怎么样）。变的是数据集与卖点，不变的是“每一步都有上游交付物”。

• 跨专业变式：换品就换链的内容——电子商务专业做东南亚美妆、国际经济与贸易专业做小家电出海、

财会专业做跨境结算与成本核算、金融科技与数字经济专业做价格带与需求的量化分析。

五环节骨架不变，换的是数据集与卖点

• 跨角色：教学秘书可以把这条链改写成“招生宣传物料链”（调研→设计→发布→答疑→复盘）；

辅导员可以改成“就业信息链”（采集→筛选→推送→宣讲→跟踪反馈）——

同样是五环，同样是每一步交一样东西给下一步

• 做成一门实训课：把五环节拆成五个课次，每课交一环的产出物，期末交完整条链。

这门课的评分点天然清楚：每一环的交付物在不在、能不能追到来源

• 专业建设与产教融合材料：这条链本身就是一份“专业对接产业”的证据，

写进专业建设方案或教改申报时，比一句“引入企业真实项目”实在得多

• 下一步：如果你的学科也有这样一条重复到第十遍、规则每次一样的链，

它就到了该被做成引擎的时候——第 2 讲末尾说的那句话，在这一讲有了完整的答案

带走一句话

每一步都能追到上一步——追不到，就不是链，是几张拼在一起的图。

数据与平台：本讲全部数字来自 zhenyuonline.cn 的 puer-crossborder 引擎实时状态（2026-09-17 实测）：

数据集 294 条样本、设计廊 18 件（其中 6 件已上架）、在架 listing 14 条、

自有网店「普洱购」在架 14 件（其中 3 件来自设计廊）。

五环节契约由 puer_flow 工具提供，页面与看板共用同一份，保证两处永远一致。

背后的引擎（本讲速查）

本讲要点（速记）

• 五个环节：市场看板 → 设计廊 → 上架 → 直播 → 经营复盘，每一步交一样东西给下一步
• 先看账本：puer_status 一调，294 条样本 / 18 件设计 / 7 件已上架 / 14 条 listing / 普洱购在架 14 件——后面每步都要对得上
• 三条纪律：每一步必须真跑 · 不许手写替上游产出 · 数字必须能追溯
• 一个硬门：设计没出图（status 不到 imaged）就不许上架——前置条件不是建议，是门
• 一次一环：做完一环先验收再往下；链越长，越要一格一格确认
• 一份契约：puer_flow 让页面与看板永远一致；交付必须给能打开的、能追问的真产物