scope-note.json 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321
  1. {
  2. "schema": "ksf.scope-note.v1",
  3. "at": "2026-11-09T01:20:00+08:00",
  4. "aboutArtifact": "c5vzRWqux6",
  5. "aboutSource": "8RgNyujlzh",
  6. "generation": "82b104fc024b49a75d2f5376bf9778ced6f63a9433b5fc5a6daa3c458d05d5ea",
  7. "verdict": "核查结束(用户已复核通过)。本文件按结项结论更正两处摘要,并与线上报告原文的口径分开表述。",
  8. "tableA_banmian_117": {
  9. "displayed": "拌面 117 条",
  10. "actualQuery": {
  11. "command": "aggregate",
  12. "request": {
  13. "entities": [
  14. "reviews"
  15. ],
  16. "filters": {
  17. "brand": "康师傅"
  18. },
  19. "groupBy": [
  20. "category"
  21. ],
  22. "limit": 50
  23. },
  24. "effectiveFilters": "brand=ksf(品类不限,按 category 分组)",
  25. "quality": "analysis(默认:排除默认评价、身份待核/错配、规格冲突;未指定品类时不强制猜品类)"
  26. },
  27. "whatItIs": "在 brand=康师傅 全量评价(505 条)内,按 category 分组后 banmian 这一桶的 recordCount",
  28. "metrics": {
  29. "recordCount": 117,
  30. "linkedProductCount": 7,
  31. "distinctTextCount": 116,
  32. "note": "recordCount=记录数;linkedProductCount=关联商品去重数;distinctTextCount=按归一化文字去重数。三者都不是销量、独立消费者数或用户占比。"
  33. },
  34. "denominator": {
  35. "value": 505,
  36. "meaning": "brand=康师傅 且 quality=analysis 的全部评价记录",
  37. "share": "117/505=23.2%",
  38. "caveat": "分母是本批收录,不是康师傅市场总量"
  39. },
  40. "paging": {
  41. "groupBy": "category",
  42. "truncated": false,
  43. "groupsReturned": 5,
  44. "note": "aggregate 一次性返回全部分组,无分页"
  45. },
  46. "eligibility": "分析资格=quality:analysis;属于「本批合格、已判定集合内的分布」,不外推全体消费者",
  47. "clarityNote": "117 是分组桶值,不是筛选命中数。若读者要的是「确认是拌面购买的评价数」,应用 29(search + category=banmian + analysis)。"
  48. },
  49. "tableB_ksf_29": {
  50. "displayed": "康师傅 29 条",
  51. "actualQuery": {
  52. "command": "search",
  53. "request": {
  54. "entities": [
  55. "reviews"
  56. ],
  57. "filters": {
  58. "brand": "康师傅",
  59. "category": "banmian"
  60. },
  61. "limit": 100
  62. },
  63. "effectiveFilters": "brand=ksf AND category=banmian",
  64. "quality": "analysis"
  65. },
  66. "whatItIs": "康师傅品牌下、品类明确为拌面 的评价条数(totalMatched)",
  67. "isPagingArtifact": false,
  68. "paging": {
  69. "limit": 100,
  70. "returned": 29,
  71. "totalMatched": 29,
  72. "nextCursor": null,
  73. "conclusion": "29 是精确匹配总数,已全部取回,不是首屏条数、不是截断值"
  74. },
  75. "metrics": {
  76. "totalMatched": 29,
  77. "distinctLinkedProducts": 2,
  78. "distinctTextFingerprints": 28
  79. },
  80. "denominator": {
  81. "value": 29,
  82. "meaning": "康师傅∧拌面 且 quality=analysis 的评价记录"
  83. },
  84. "crossCheck": {
  85. "banmian_全品牌": {
  86. "totalMatched": 49,
  87. "distinctLinkedProducts": 4
  88. },
  89. "note": "29 ⊂ 49;康师傅占全品牌拌面评价 29/49=59.2%(本批收录内)"
  90. },
  91. "clarityNote": "29 是合格评价记录数,不等于 29 位消费者、29 笔独立交易或经外部核验的真实购买人数。"
  92. },
  93. "criticalDistinction": {
  94. "why_117_ne_29": "两次查询都是 quality=analysis,品质等级相同。差异来自:显式限定 category=banmian 会触发附加资格规则,即购买规格须与品类一致(category_state=consistent);未限定品类的查询不触发该规则。117 是未限定品类时、关联商品品类为拌面的记录数(购买规格可以尚未确认与拌面一致);29 是同品牌显式限定品类且满足购买规格一致的合格记录数。",
  95. "reconciliation_verified": {
  96. "audit_对照": "同条件下 quality=audit:分组桶 banmian=472,独立筛选 category=banmian=472,两者完全相等 -> 说明分组与筛选口径本身一致,差异只由 quality 规则产生",
  97. "analysis_差额": "analysis 下 分组桶117 vs 独立筛选29,差 88 条。原因:默认 defaultReviewPolicy 写明'指定品类时购买规格也须明确,未指定品类时不强制猜品类'。aggregate 未指定品类筛选,故 117 含规格未明确的记录;search 显式指定 category=banmian,故 29 必须购买规格明确符合。",
  98. "conclusion": "差额机制由实际查询、有效查询说明和共同的查询构造规则共同支持;audit 下 472 与 472 相等只作旁证,不单独充当因果判断。",
  99. "notDoing": "不为确认机制逐条拉取全部 88 条;逐条是否应重新分类属另一项数据治理工作,本轮不开展。"
  100. },
  101. "action": "不得把 117 与 29 并作同一口径,也不得互相验算;引用时必须带上各自的 quality 与是否显式指定 category 两个条件"
  102. },
  103. "brandTable_unmatched": {
  104. "displayed": "今麦郎 / 日清 / 农心 未命中",
  105. "fromQuery": {
  106. "command": "search",
  107. "filters": {
  108. "brand": "<品牌>",
  109. "category": "banmian"
  110. },
  111. "quality": "analysis"
  112. },
  113. "scope": "仅限该次查询条件(该品牌 ∧ 拌面 ∧ analysis 品质)下的结果",
  114. "mustNotConclude": [
  115. "研究库完全未收录该品牌",
  116. "该品牌不存在拌面产品",
  117. "市场无该品牌拌面"
  118. ],
  119. "supportingEvidence": "按 brand 分组 aggregate(不限品类)返回 9 组:8 个已知品牌+1 个未知品牌(null,30 条)。其中今麦郎 jinmailang 28 条、日清 riqing 40 条、农心 nongxin 20 条——三品牌在库内均有评价,只是未落在「拌面」这一品类桶内。",
  120. "status": "该三品牌是否有拌面产品,需另查品类标注覆盖,标为待核"
  121. },
  122. "queryEvidenceIndex": [
  123. {
  124. "label": "品类分布(505/304/117/50/25/9)",
  125. "command": "aggregate",
  126. "request": {
  127. "entities": [
  128. "reviews"
  129. ],
  130. "filters": {
  131. "brand": "康师傅"
  132. },
  133. "groupBy": [
  134. "category"
  135. ],
  136. "limit": 50
  137. },
  138. "result": {
  139. "ok": true,
  140. "groups": 5,
  141. "truncated": false,
  142. "records": 505
  143. },
  144. "file": "/tmp/recheck/out_a.json"
  145. },
  146. {
  147. "label": "品牌分布(9组=8个已知品牌+1个未知品牌)",
  148. "command": "aggregate",
  149. "request": {
  150. "entities": [
  151. "reviews"
  152. ],
  153. "groupBy": [
  154. "brand"
  155. ],
  156. "limit": 50
  157. },
  158. "result": {
  159. "ok": true,
  160. "groups": 9,
  161. "truncated": false,
  162. "namedBrands": 8,
  163. "unknownBrand": 1,
  164. "detail": {
  165. "ksf": 505,
  166. "akuan": 48,
  167. "baixiang": 41,
  168. "riqing": 40,
  169. "wugudaochang": 34,
  170. "null": 30,
  171. "jinmailang": 28,
  172. "tongyi": 25,
  173. "nongxin": 20
  174. }
  175. },
  176. "file": "/tmp/recheck/out_b1.json"
  177. },
  178. {
  179. "label": "康师傅∧拌面=29",
  180. "command": "search",
  181. "request": {
  182. "entities": [
  183. "reviews"
  184. ],
  185. "filters": {
  186. "brand": "康师傅",
  187. "category": "banmian"
  188. },
  189. "limit": 100
  190. },
  191. "result": {
  192. "ok": true,
  193. "totalMatched": 29,
  194. "nextCursor": null
  195. },
  196. "file": "/tmp/recheck/o_d2.json"
  197. },
  198. {
  199. "label": "拌面全品牌=49",
  200. "command": "search",
  201. "request": {
  202. "entities": [
  203. "reviews"
  204. ],
  205. "filters": {
  206. "category": "banmian"
  207. },
  208. "limit": 100
  209. },
  210. "result": {
  211. "ok": true,
  212. "totalMatched": 49,
  213. "nextCursor": null
  214. },
  215. "file": "/tmp/recheck/o_d1.json"
  216. },
  217. {
  218. "label": "康师傅全部=505",
  219. "command": "search",
  220. "request": {
  221. "entities": [
  222. "reviews"
  223. ],
  224. "filters": {
  225. "brand": "康师傅"
  226. },
  227. "limit": 100
  228. },
  229. "result": {
  230. "ok": true,
  231. "totalMatched": 505,
  232. "recordsReturned": 100,
  233. "hasNextCursor": true,
  234. "note": "totalMatched=505 是总匹配数;包内取回的是首批 100 条,尚有下一游标。不可写成 505 条正文均已取回。"
  235. },
  236. "file": "/tmp/recheck/o_d3.json"
  237. }
  238. ],
  239. "sourceObjectClarification": {
  240. "8RgNyujlzh": "本次保存时形成的 KfSource 对象,是「这次报告的来源记录」本身",
  241. "isUpstreamEvidenceForNumbers": false,
  242. "reason": "各表数字的上游是研究库 generation %s 下的检索结果,不是 8RgNyujlzh。成果对象只承载引用关系,不能反过来当数据来源。",
  243. "correctUpstream": "研究库 generation=82b104fc024b49a75d2f5376bf9778ced6f63a9433b5fc5a6daa3c458d05d5ea,经 ssh-channel 只读检索(databaseWrites=0,readOnly=true)"
  244. },
  245. "completionBoundary": {
  246. "doesComplete": "业务链路验收(保存→编号回读→公开看板→桌面浏览器)",
  247. "doesNotComplete": [
  248. "课表第一节「供给树、需求树、供需连接图谱」",
  249. "机会卡、项目、方案",
  250. "正式报告发布"
  251. ],
  252. "reportsPosition": "本成果是库内分布小结(S1 品类结构),不足以标记第一节全完成"
  253. },
  254. "archiveClarification": {
  255. "employeeAccountsProvisioned_false": "不是课堂保存的阻断条件。保存与看板均已在 provisioned=false 下成功。",
  256. "employeeConfirmed_false": "表示尚未正式确认报告,与通讯录实名核验是不同字段",
  257. "employeeIdentity_status": "pending,reason=WECOM_DIRECTORY_NOT_CONFIGURED(通讯录未配置,需单独核验,不能只由 'provisioned' 一个标志推断)",
  258. "writesThisRound": {
  259. "primaryObjects": [
  260. "KfArtifact c5vzRWqux6",
  261. "KfSource 8RgNyujlzh"
  262. ],
  263. "note": "不等于数据库总写入仅两次——保存还更新会话等关联记录。"
  264. }
  265. },
  266. "boundaries": {
  267. "reinstalled": false,
  268. "collected": false,
  269. "paidCalls": 0,
  270. "repeatedSave": false,
  271. "modifiedReport": false,
  272. "modifiedSkill": false,
  273. "changedAuth": false,
  274. "queryMode": "只读复算(readOnly=true, databaseWrites=0),用于核实口径,非新采集"
  275. },
  276. "auditCrossCheck": {
  277. "command": "aggregate/search + quality=audit",
  278. "banmian_bucket_audit": 472,
  279. "banmian_filter_audit": 472,
  280. "brand_ksf_total_audit": 2681,
  281. "note": "audit 含默认/待核/冲突数据,仅作口径核对,不得当有效观点样本。audit 筛选为 totalMatched=472、首批返回 100 条、有下一游标,不是 472 条正文全部导出。"
  282. },
  283. "archival": {
  284. "onlineReportModified": false,
  285. "thisNote": "作为补充证据归档,下一次内容修订时并入线上报告的统计范围说明",
  286. "loopStatus": "统一 Skill 安装 + 一次 S1 真实报告的保存/回读/看板/桌面展示闭环继续维持通过",
  287. "pendingSeparately": [
  288. "品类全景图谱",
  289. "机会卡",
  290. "项目",
  291. "方案",
  292. "正式发布"
  293. ]
  294. },
  295. "correctionsAppliedThisRound": [
  296. {
  297. "item": "品牌分组组数",
  298. "was": "7 组(按早前输出误记)",
  299. "now": "9 组=8 已知品牌+1 未知品牌(null 30 条)",
  300. "evidence": "out_b1.json rows=9, truncated=false"
  301. },
  302. {
  303. "item": "康师傅全量查询",
  304. "was": "505(易被读成 505 条正文已取回)",
  305. "now": "totalMatched=505,首批返回 100 条,有下一游标",
  306. "evidence": "o_d3.json returned=100, nextCursor 非空"
  307. },
  308. {
  309. "item": "audit 筛选",
  310. "was": "472",
  311. "now": "totalMatched=472,首批 100 条,有下一游标",
  312. "evidence": "o_e1.json returned=100, nextCursor 非空"
  313. },
  314. {
  315. "item": "117 vs 29 成因表述",
  316. "was": "品质等级不同(错)",
  317. "now": "同为 analysis,差异是显式限定品类触发的购买规格一致附加规则",
  318. "evidence": "effectiveQuery 两份 quality 均为 analysis"
  319. }
  320. ]
  321. }