workshop-delivery.md 21 KB
逐环节保存与看板核对
用于课表各环节的资料、调研和报告同步。只使用 workshop-tasks.md 及当前合同已支持的命令，不新增写入口。环节、处理和核心产出见 workshop-course-flow.md。用户已要求执行并同步时，在任务范围内完成保存，无需每次再问“是否上传”。
1. 接续上下文与任务
从可信当前消息核员工和执行Agent，沿用正确的workshopKey、sessionId、小组与课题。首次实质入库或上传仍按主Skill确认看板称呼；昵称不是身份凭据。读取前序成果、项目当前stageCode和已提交的环节版本，再执行任务。
在既有/opt/data/ksf-workshop-state/下记录本题任务状态，不保存凭据。topicKey、moduleId和以下状态仅是本地跟踪字段，不能加进API顶层输入。
- topicKey：首次确定课题后生成并持久保留的本地业务键；同题续做沿用，换题另建。不能只按显示姓名或当前时间推断是同一题。
- 任务：课表moduleId、系统stageCode、适用对象的objectKey、taskKey、版本、实际请求号、输入文件指纹、来源编号、报告/机会/项目/方案编号。
- 状态：已查范围、已取得/复用资料、入库及回读结果、公开投影核对、页面核对、未决问题和下一节。
本地状态按课表环节的内容顺序接续；原课表日期、钟点和课时不作执行锁或等待条件。恢复任务核前序成果及缺口，不按当前系统时间自动跳节或重置。
taskKey可按<topicKey>:<moduleId>:<objectKey>生成，控制在200字符内；普通单份成果可使用固定objectKey，同一环节的证言池、社媒报告、痛点库分别用各自固定对象键，候选机会分别用持久机会键，不能用会变的展示序号作对象键。发现已有记录时沿原键和版本，即使旧任务使用别的环节标记也不重命名数据库键，不从示例照抄不存在的编号。
保存前核实课题、会话及实际关联项目，按课表内容选择成果阶段；合同样例或旧taskKey中的S3等字样不作当前阶段依据。旧成果的键保持稳定，阶段差异的原因及可采用的修订方式按当前合同核清；后期项目补核前序材料时保留其实际阶段，不为修正显示而倒退项目、重置会话或复制一份相同成果。
任务再次执行时先核输入和保存回执：相同内容已完成则回读并返回原链接；结果未知则先查询实际状态。失败重试沿用原requestId及原输入；实质内容修改才按合同增版本和新的操作标记，不换键制造重复。读、导入、保存、推进等不同操作分别留请求号。
D1-04的 任务下达 另留稳定假设/任务键、各组接收对象、配置版本、实际投递/接收及排程回执。本地或报告中的任务卡已保存、看板可见，不证明另一工作台收到、排程生效或已经运行；这些按真实证据分别回读，未知投递结果先查原记录，不重复派发。
D1-N的 自驱调研 另留已处理查询/页码/游标、原件指纹、固定代际或独立新原件批次、资格/标注规则及清单、簇成员和统计n/N、已消耗及报告编号。中断先核请求/原件/账本和保存回执，再续未完成单元；按可审阅进展更新同一报告系列，不把收件接受或本地文件当生产研究发布。
D2上午沿“验收集合→稳定需求键/成员→机会线索键→候选系列键及真实卡号”保留对应，引用每段实际报告/配置版本。只在报告/本地明细记录验收、KANO/矩阵/指标/五力及缺口，不加API顶层字段或改研究资格。独立卡和V1汇总各自留保存请求/版本，部分失败先核原结果，清单不伪填尚未返回的编号。
D2下午沿“V1全池→证据核验/等级及待评→回推条件与V2→价值主张/卖点→实际质询与V3”留逐候选对应。完整清单包含未评估/暂缓/排除及原因；成本、模型、工厂/合规、文案和真实反馈各留依据及适用版本。独立方案、提案报告、项目完成与正式发布各自核实；具体操作见 下午收尾细则。
2. 把本节资料保存或引用到正确位置
| 本节内容 | 处理路线 | 完成依据 |
|---|---|---|
| 已在研究库的商品、价格、评价、社媒和政策 | 同代际查询并回读关键原文，复用实体ID、source_record_id、来源定位与时间 | 保留查询及实际记录，不重复当作新采集 |
| 新取得的研究原件 | 原件留存、字段映射与校验，经本Skill 研究模块 的既有暂存/授权发布路线处理 | 远端研究库实际发布与同代际回读才算研究入库完成 |
| 需要用于业务报告引文的真实原文 | 先查业务库已有来源；没有时按现有来源登记/导入路线保存实际取得的原文和必要出处 | 取得真实KfSource编号并回读，供sourceIds及report.evidence使用 |
| 业务品类、原料、工艺、人群/场景、证据等 | 按合同支持的实体执行workshop-dedup、workshop-import并回读 | 逐条真实objectId、created/unchanged及失败项 |
| 本节研究结论、证言表、数据覆盖与报告 | 按本节artifactType使用workshop-save | 真实artifactId、版本、阶段及回读内容 |
| 独立机会卡、项目、方案 | workshop-save的opportunity、project-create/progress、concept-save各自完成 | 各命令自己的真实编号与回读结果 |
研究记录ID不等于业务库Pointer。只有研究引用还未建立KfSource桥接时，先登记原文再写report.evidence，不拿研究ID冒充sourceId，不把Agent写的摘要当消费者原话。可只保存本节实际引用的最小原文及必要上下文，保留完整原件定位，不为验证引文下载整个库。
具体桥接按 业务引文来源桥接 执行：先复用真实来源/证据，无可复用编号时用workshop-import保存有实际原文及定位的KfEvidence，取得sourceId与证据objectId后分别回读。该入口要求1–200条records，不支持只填source或records空数组；来源登记、证据导入和报告保存分项核验，不能把workshop-save自动生成的报告来源当外部原文。
采集回执、原件、正文资格、结构化入库和分析结论分别列出。部分成功保留真实编号并列待办；只保存了任务计划，不能写成数据已采到。只作资料整理的小节也保存可阅读的索引/覆盖报告，使课堂看板能直接查看本节实际做了什么。
不要把全部研究原始数据复制到业务报告。业务引用保留对应来源，研究主库保持原有归属；尚未发布研究主库的新原件可如实标“原件已取得、研究入库待完成”，已完成的业务报告可以独立保存，不用一个“已同步”掩盖两者差异。
证言池或Listing较大时，完整记录留在研究库，课堂报告展示覆盖、统计、必要的原句和可回查的记录索引，链接现有资料页；有实际导出文件才给导出链接。报告章节、正文长度、sourceIds和导入批量遵守当前合同上限，超过时拆成有真实编号的分册及导航，不截掉证据后冒充全量，也不把数千条正文硬塞成一个保存请求。
3. 保存一份可读的小节报告
报告标题建议包含“课题简称／D1-03等环节／成果名”，归属和小组由现有session注入。不要把真实账号、整段私人聊天或凭据写入公开报告。
workshop-save沿用现有字段：sessionId、可选projectId、taskKey、version、stageCode、title、artifactType、category、rawText、sourceIds、pendingQuestions、report，以及需要时的opportunity。不添加moduleId、syncStatus、topicKey、conceptId等新顶层字段；课表环节放标题/章节，方案实际编号可放正文关联表。不要在save输入里增加dataMode或dashboardState，它们由现有会话及服务流程决定。清单V1.0/V2.0/V3.0与API version分开记录。
rawText保存本次成果正文；report.executive给简洁结论，report.chapters组织以下适用内容：
摘要先回答本节得到什么发现、关键依据/适用范围、建议怎样行动及决定性待验证项；结论可以是条件式建议或证据不足，不要求每节强行选产品。质量与追溯明细放后，避免学员先看到满屏校验状态却看不到研究判断。
- 本节问题、范围、使用资料与前序成果。
- 实际数据/证言/分析表，以及查询、质量、分母和去重口径。
- 结论、支持和反对证据，事实与待验证判断分开。
- 缺口、下一步与来源/成果导航。
小节短时可合并章节，不为凑结构灌水。正文表格用现有kind: table及data.cols/data.rows，段落用para/longpara，避免自造渲染类型。引文使用report.evidence绑定已保存sourceIds中的真实原文；每一项来源都按返回编号回读核实。
按本节要求列出实际应交的核心内容，逐项对应待保存的章节/表格和来源。图谱须保存可读的供给层级、需求层级及连接明细，配置卡须保存实际规则、核查记录和遗留状态；修订日志或一句摘要不能代替这些正文。HTML等辅助文件与后台报告呈现方式可以不同，核心分析内容和版本须对应。rawText同样保留实质正文，不只填简介；提交前先按合同核结构、合法类型和白名单字段，不能通过多次猜字段试写来构造报告。
在最新实际成果的导航章节列本题已完成环节、前序报告/机会/方案的真实编号与版本/链接、当前环节、影响后续判断的待办及下一步。没有独立报告的核心产出标明所在报告与章节，不把本地路径当公开下载链接，不预填后续空ID。当前报告的编号保存后才获得，直接在回报中给链接，无需为补自己的编号再保存一版。已有阶段页/成员页沿现有归属查看，不新增课程导航页面或为每次进展单建一份报告。
现有para/longpara和普通table单元格展示文本，不解析Markdown/HTML，也不把URL自动变成超链接。正文导航使用清晰的真实标题、编号/版本和URL文本；在课堂消息中另给相应可点击Markdown链接，学员也可从现有成果列表进入。证据键已有原文按钮可沿现有结构使用，不把导航伪造为证据；未实际核到组件能力时不承诺正文标题可点击跳转。
同一节有多张候选机会卡时，分别保存对应报告与opportunity，建立真实编号导航；每份保存成功就回读，单张失败不把成功卡全重做。只给一篇含多条机会的聊天文稿不算已建立独立机会卡。
候选清单的优先级/可行性报告可按现有合同在未建项目时保存；不要把project-create当全池比较前置条件。已关联项目的报告阶段仍须与该项目一致。清单V1/V2/V3引用稳定机会键和实际卡号，逐项记录保留、修改、暂缓或排除及依据；清单变化记录不代表自动修改独立卡片或项目。
空白计划或构造示范沿sample规则；有真实资料的分析按其实际模式及当前会话处理。真人的真实研究可以留下未决条件，不能为了把课堂草稿变正式结论而改模式或删除待验证项。
4. 精确回读，核对看板
保存返回成功后，用workshop-read {className:"KfArtifact",objectId:实际artifactId}核对标题、stageCode、version、正文、来源和归属；机会卡按KfOpportunity回读，已建项目用project-status，方案核项目返回的当前concept。不要只按相似标题搜索来证明是刚保存的那一份。
对照应交内容逐项核实际回读响应中的章节、关键行、引文及来源，不只核章数、标题或摘要；回读请求文件也不是响应证据。报告自身自动生成的KfSource不是第二份KfArtifact，不代表上游证据已桥接。多份成果分别核className、实际编号、版本和正文；要求独立保存的卡片须有自己的真实成果编号，合并交付时明确其所在章节及范围，不将一个报告和它的来源报成两份报告。
concept-save的pendingQuestions存于项目meta，须由project-status的project.meta回读；不因concept对象没该字段重复保存。方案版本沿当前方案连续递增，报告业务清单V3不代表方案version=3。公开看板没有独立方案页时，在真实报告页呈现方案内容及编号/版本，不能凭空拼路由或把报告可见当独立方案已保存。
随后通过实际可用的看板公共读接口或浏览器，确认该确切artifactId/机会编号已进入公开投影；使用现有部署配置，不读取或传出凭据。按本节实际对象打开：
| 查看内容 | 已有页面 |
|---|---|
| 本节报告 | https://kangshifu.fmode.cn/report/<实际artifactId> |
| 各小节所属阶段的成果 | https://kangshifu.fmode.cn/stages，按已有阶段/本人或小组筛选 |
| 个人或小组归属 | https://kangshifu.fmode.cn/members |
| 候选机会卡 | https://kangshifu.fmode.cn/pool/<实际opportunityId> |
| 研究底料与行业资料 | https://kangshifu.fmode.cn/library、https://kangshifu.fmode.cn/industry，仅对已发布可见资料报可查 |
部署域名变化时取实际看板地址；不凭空拼项目/方案详情路由或未经确认的筛选参数。既有看板页面可能需要刷新取新数据，不承诺推送、固定延迟或无需刷新。HTTP200可能只是前端外壳，不证明目标成果已渲染。
核对公开数据包含本节确切编号与版本后，可报“已同步可查看”；浏览器实际打开并核对本节正文后，再报“页面已打开核对”。无浏览器但已核公共数据时，明确“公开数据已核，浏览器未核”。只完成业务回读时给报告链接并写“已保存并回读，页面待核”，不能把服务返回boardVisible=true单独当浏览器验收。展示链失败只排查读取/筛选/投影，不因链接打不开重建成果、重启服务或改网关。
5. 每个环节的结果反馈
回复与报告按 产品反馈与产出标准 组织：先给本节产品认识、必要依据和取舍，再附实际成果及简短状态。简单回应不套固定模板，复杂比较给足可讨论内容；覆盖限制跟随具体结论，技术明细后置。员工不用先下载附件或读操作日志也应看懂结果。读取失败等影响结果的阻断仍直接说明。
按用途控制交付数量：普通分析在对话展示有效内容，需要解释复杂关系、共同评审或后续复用时可随结果提供有用的图片、图表或文件；以 下节 判断。不要用ZIP、原始JSON、哈希清单及同内容多格式导出代替正文。有实质阶段成果且已授权同步时，给后台报告链接和简短核对状态；未到报告交付点不为制造附件建空报告。用户要求案例留档、导出、排障或交接原件时，可将所需材料集中为一个ZIP，避免散发多个重复文件；无需为了减少附件取消完整过程记录。
全过程留档在既有本地状态/案例目录持续追加，保存实际提示词、完整回复、用户反馈、报告版本及必要证据；按用户需要分轮或集中打包，不增加无业务必要的回传要求。最终案例演示以一个可离线打开的HTML呈现正式提示词、业务回复、报告和实际取舍，链接真实后台成果。路径、哈希、调用日志、原始JSON和调试痕迹留原始档案，不占课堂展示正文；完整原件保留可回查。展示整理不改写真实数据、结论、决策或完成状态。共享材料按实际公开权限处理。
按约定逐轮时交当前结果后暂停，反馈问题只涉及真实业务取舍；用户已要求连续执行时在其范围内接续。已授权的当前查询/保存无需重复请示，新的费用、范围和正式确认边界保持原要求。
章节已完成但同步失败时，本地留完整成果和稳定任务输入，报告“分析已完成、保存/回读/页面核对停在哪一步”，不要只返回一条笼统错误，也不要报全部完成。正式报告确认与发布继续走report-preview、真人确认、report-submit，不用来代替日常课堂同步。
研究查询只读与业务成果写入分别报告：本轮保存或导入过成果时，不能笼统称“本轮只读/未写库”。按真实回执列新增/更新的业务对象及必要关联；对象数量也不冒称数据库总写入次数。
6. 必要的图片、图表与文件
在当前研究范围内，材料有助于理解、比较、选择或复用时直接制作，不必另问是否生成图片或文件。选择最有用的形式，不给每轮配置固定附件套餐，也不为配图增加未授权采集、付费调用或公开上传。
| 需要解决的事情 | 可选产出与使用条件 |
|---|---|
| 看清品类层级和供需联系 | 供给/需求树、连接图或可展开HTML；节点定义和关系有依据，事实、宣称、假设和未知可区分，不把连线当因果证明 |
| 比较代表产品和使用过程 | 对照图、真实商品图拼版或步骤图；商品图用已取得且身份可核的素材，缺图用文字卡，不生成包装照片冒充实物；未知步骤不补画为事实 |
| 理解数量、分布或可比差异 | 用已核数据生成统计图，注明范围、单位、时段和分母；未知不填零，无跨期数据不画增长趋势，不用生成式图片绘制精确数据图 |
| 小组复算、补证或交接 | 可编辑比较表、证言编码表或验证任务表；保留来源、计算口径与待填项，不能把空模板称为已完成调研 |
| 阶段汇报或案例演示 | 按实际需要生成报告文件、演示页或HTML；与真实成果版本相符，案例只含真实发生的输入输出与决策，不自动生成整套重复格式 |
用户或实际交接要求可编辑文件时，在当前工具确实支持的格式中交可编辑比较表、验证表或提案，并实际回读内容、公式/单位与来源；不把HTML截图或同名改后缀称为可编辑PPT/Excel。需要PPT/文档而工具不具备时，提供可复用的逐页/逐章业务内容并明确格式未交付，不据此声称目标实例已具备制稿能力。未要求文件时以可直接讨论的正文和真实成果链接为主，不为展示能力额外生成多格式附件。
产出前确定它帮助回答的具体问题；制作后实际打开、渲染或用当前可用方式检查内容。核图中文字、布局、单位/图例、来源对应和未知标记，图中结论与正文一致。可编辑表实际回读，核公式/数据和计算基数；HTML检查主要内容和导航。无法检查时说明具体未核部分，不称已验收，也不因缺渲染工具反复改环境。工具不具备时改用已支持且可检查的形式。
视觉检查与研究内容检查分列：图和正文互相一致，只能证明两处使用相同结果，主要数字仍须回到实际记录或计算；页面不溢出也不证明小字可读。复杂图在窄屏改用分区、文字卡或图容器内滚动等可读形式，实际看清节点与图例，不把整图缩成不可读缩略图就报移动端通过。
关系图逐条核“起点、终点、关系陈述、证据索引和状态”：节点各有来源不等于两者之间的联系已有证明，用户说分量够不把标题克重自动升级为经测量的饱腹机制。线型/颜色与图例、连接表逐项对应；消费者表达存在与我方产品优劣仍是不同判断。分类树须有实际父子层级，独立属性卡列可作辅助，不能以有树形标题或箭头就称供给树已完成。关键数字和关系未核时先修受影响部分，其余可保留，不为通过展示验收静默删除反证或补造连线。
交付时给一句读图/使用说明及能实际打开的预览或文件链接，本地生成不冒称已上传。每张图和文件关联所属任务、真实成果编号/版本（尚未保存则明确本地草稿）和来源索引；修订时同步核对受影响内容。技术日志、哈希和全量原件仍留档，不挤占业务正文。产品概念图需标“概念示意/待验证”，不冒充已有产品、已证性能或量产方案。
看板当前支持的章节和附件能力以合同及实际页面为准。图片/HTML或导出文件可辅助课堂讨论，已要求后台同步的报告仍保存完整可读正文与必要表格，再分列回读、看板和页面状态；不把新增文件等同于看板已支持新渲染类型或已对外发布。