本页内容核对日期 2026-08-11,来源见页尾「真值来源」。
案例演示(caseDemos)
它是什么
案例演示让你把真实发生过的对话挑出来,展示在专家详情页的「使用案例」区。买家能看到你的专家实际是怎么工作的,比任何描述都有说服力。 关键在于它存的是引用而不是副本:showcaseId 指向 chat_session.id,也就是一条真实的会话记录。
字段行为
回落链条只有封面是三级的:
静默过滤
详情接口拿到配置后会去查这些会话,查不到的直接从结果里剔除:配置建议
- 挑过程完整的会话。案例的价值在于展示工作方式,半截的对话说明不了什么。
title别用会话原标题。会话标题通常是自动生成的,写一个说清「解决了什么问题」的标题转化率更高。description补充会话里看不出来的信息——比如这次用了什么特殊方法、结果被采纳了没有。- 用
sortOrder把最有代表性的排在前面,买家通常只看头两个。
工作区种子(workspaceSeed)
设计意图
按数据库列注释的描述,这个字段本应让创作者预置一批文件到沙盒工作区,在该用户 + 该专家的首次沙盒创建时解包,后续创建则跳过以免覆盖用户自己的修改。结构是:当前实际状态
你现在该怎么做
需要给专家预置文件或初始化环境,用已经生效的路径:
等这个字段接通运行时后,本页会更新。
边界与失败态
详情页的案例演示比我配的少
详情页的案例演示比我配的少
有案例引用的会话已被删除或不可访问,这些条目被静默过滤。核对每个
showcaseId 对应的会话是否还在。案例演示的标题不是我填的
案例演示的标题不是我填的
你的
title 为空字符串或未填,回落到了会话自己的标题。填上非空的 title 即可覆盖。案例封面显示的是会话截图不是我上传的图
案例封面显示的是会话截图不是我上传的图
coverImageFileId 没填或文件已失效,回落到了会话封面。配了 workspaceSeed 但沙盒里没有文件
配了 workspaceSeed 但沙盒里没有文件
这是当前的已知状态,不是配置错误。该字段尚未接通运行时,见上文。
改了案例演示但详情页没变
改了案例演示但详情页没变
已上架专家的公开详情读的是发布记录。改动要走「发布新版本 → 审核通过」才生效。
验证
配完案例演示后,用非本人账号打开专家市场详情页:- 数一下「使用案例」区展示了几条,与你配置的条数是否一致——不一致说明有条目被静默过滤
- 确认排序与你的
sortOrder一致 - 点进任一案例,确认会话内容确实是你想展示的那一段
workspaceSeed 无需验证——当前无论怎么配都不会有效果。
真值来源
核对日期 2026-08-11。来源:
- 案例演示富化、回落链、静默过滤:
services/core/src/db/service/expert.ts(enrichCaseDemos) - 两个字段的类型定义与列注释:
packages/db/src/schema/marketplace.ts workspaceSeed无运行时消费方:全仓检索该字段,仅存在于 schema、Core 的存取与发布快照路径,invoke-lifecycle与 agent-runtime 零引用
下一步
Prompt 四层结构
四个输入框各自的注入位置
专家模式
兼容模式与完整模式

