| 1234567891011121314151617181920212223242526272829 |
- --- r6/references/research-library/operations.md
- +++ local-doubao/references/research-library/operations.md
- @@ -29,7 +29,7 @@
- }}
- ```
-
- -`CHANNEL_READ_FAILED`不单独证明根因。只有脱敏诊断已指向暂时性读传输故障(如空stdout、连接中断或超时)时,保留同一命令、查询、generation及游标,按2/4/8秒退避,首发加三次重试最多4次;每次保留阶段、退出码、字节数和指纹。达到上限即报未完成,不用半截结果作完整分析。`INVALID_READ_PARAMS`/`INPUT_REQUIRED`/`UNKNOWN_SEARCH_FIELD`、权限/授权、指纹或代际错误立即停止该重试路径;解析失败先定位返回合同,不能一概认定为网络抖动。这条重试规则只适用于读取,不用于publish、业务写入或收费请求,也不表示查询运行程序已增加自动重试。
- +`CHANNEL_READ_FAILED`不单独证明根因。只有脱敏诊断已指向暂时性读传输故障(如空stdout、连接中断或超时)时,保留同一命令、查询、generation及游标,按2/4/8秒退避,首发加三次重试最多4次;每次保留阶段、退出码、字节数和指纹。达到上限即报未完成,不用半截结果作完整分析。`INVALID_READ_PARAMS`/`INPUT_REQUIRED`/`UNKNOWN_SEARCH_FIELD`、权限/授权、指纹或代际错误立即停止该重试路径;解析失败先定位返回合同,不能一概认定为网络抖动。这条重试规则只适用于读取,不用于publish、业务写入或外部采集请求,也不表示查询运行程序已增加自动重试。
-
- 需要全范围计数优先aggregate;需要逐条编码、去重或原文分析才遍历search结果。search单次limit上限100;有nextCursor则在相同代际、条件及排序下继续,直至结束。按页保存请求/响应指纹、游标、已读记录键和完成状态,避免漏页或重计。中断后只有确认代际、范围和游标仍有效才从已确认断点续读;否则重建受影响查询。只看一页、游标未穷尽或存在失败页时都不能声称全量。
-
- @@ -42,7 +42,7 @@
- 3. 数值/日期/渠道用字段筛选,主题反馈用正文检索和可见同义组,再沿商品—规格/价格/评价、政策—条款—原文、记录—来源关系回读。明确限定的条件必须保留,未限定维度不擅自补上,不因零结果静默放宽。
- 4. 核对 effectiveQuery,用facets了解范围、aggregate统计,按绑定代际/范围的游标查完。实体与计数基准分开。语义由Agent拆解,FTS和同义表只提供候选,不声称任意语义全召回。
- 5. get/source回读关键记录,核原句、规格、时间、事实/宣称/推断、适用范围及出处。命中可能只是应用建议、标题或历史快照,不能直接下结论;否定和比较对象需读上下文。
- -6. 查询依据保留实际条件、代际、计数单位、读取范围、排除规则、来源及时间,主文按业务用途简述。只看一页不能称全量分析;全范围统计优先aggregate。查库是 [模型分析与补证闭环](../workshop-research-loop.md) 的取证环节:结合模型框架和已有资料形成初答,自主检查会改变判断的缺口,必要时直接按现有权限/预算调VOC外部补证,而不把库内覆盖当研究终点。查询本身不采集、不收费,外部调用按其真实工具合同执行。
- +6. 查询依据保留实际条件、代际、计数单位、读取范围、排除规则、来源及时间,主文按业务用途简述。只看一页不能称全量分析;全范围统计优先aggregate。查库是 [模型分析与补证闭环](../workshop-research-loop.md) 的取证环节:结合模型框架和已有资料形成初答,自主检查会改变判断的缺口,必要时直接按现有权限调VOC外部补证,而不把库内覆盖当研究终点。查询本身不采集,外部调用按其真实工具合同执行。
-
- Agent执行用户已要求的资料入库时,采用既有研究运行组件的受控导入程序,每版新建并校验后切换;不直接改 SQLite、分类字典、旧记录或源文件。更正必须带原记录、来源依据及规则版本,不能按同名品牌或近似标题合并。发布需要实际绑定且可写的registry;只有独立快照时可完成暂存及回读,并明确报告“尚未发布”,不冒称看板已更新。
-
- @@ -50,7 +50,7 @@
-
- 整理商品高频反馈、生成看板概况,或从已授权采集结果准备新一批商品/评价入库时,读 [商品概况与结构化批次](product-overview-and-intake.md)。商品概况按本商品已收录评价统计:默认/错配/规格冲突不参与分析,主题以去重文本计数,评分不跨体系平均,价格不混口径。主题结论须附原评价ID和逐字引文,不能把关键词命中直接说成好评、差评或消费者占比。
-
- -Agent可为九类实体准备批次映射和有引文的主题标注,通过 `/opt/data/skills/ksf-voc-library/scripts/agent_batch.py --batch /opt/data/本批/batch.json --output /opt/data/本批/staging.sqlite` 做只读预检;来源固定到真实文件SHA、JSON Pointer、平台和商品ID。批次构建的--apply只创建新的私有暂存库及来源包;已授权的入库任务可继续用 `update_library.py` 合并并切换已绑定registry,随后回读新代际。用户仅要求预检时不发布。采集工具和付费权限仍须实际存在。
- +Agent可为九类实体准备批次映射和有引文的主题标注,通过 `/opt/data/skills/ksf-voc-library/scripts/agent_batch.py --batch /opt/data/本批/batch.json --output /opt/data/本批/staging.sqlite` 做只读预检;来源固定到真实文件SHA、JSON Pointer、平台和商品ID。批次构建的--apply只创建新的私有暂存库及来源包;已授权的入库任务可继续用 `update_library.py` 合并并切换已绑定registry,随后回读新代际。用户仅要求预检时不发布。采集工具和对应访问权限仍须实际存在。
-
- 合并规则 `ksf.voc-merge.20261106.v1` 按完整来源记录取舍:新候选缺少已知业务字段、较旧或事实冲突时保留当前记录,候选进入历史。先核远端dry返回的实际mergePlan、预计总数、更新/保留及冲突原因;get的mergeHistory可定位候选source回读。取舍与时间规则见[完整结构与入库](full-schema-and-intake.md),不能靠拼接不同来源字段伪造一份完整新响应。
-
|