vod-devkit 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -120,3 +120,45 @@
120
120
  ## v0.2.1(2026-11-05)
121
121
 
122
122
 
123
+
124
+ ## v0.2.2(2026-11-06)
125
+
126
+ - e2928cb test(D-codex-plugin-1 增补2 补): 自包含契约锁断言更新为 serve 入口形态(相对路径断言随 .mcp.json 定稿移除,失败原因留注释);skills 随包断言补入
127
+ - 4cd6d84 fix(D-codex-plugin-1 增补2): ①SKILL.md 清除 V16 前废弃旧职责残留(四节 content 模板/声音来源字段/detect_channel——与工具描述新契约直接冲突,codex 真机会话实锤模型按旧模板走偏:翻仓库找提交规范→要工单字段→用户原话丢失未提交);frontmatter 触发词补 提单/提 issue②工具描述补提单语义+话术前置强化(content=原话即完整提交物,禁止追问补齐/索要开发者字段)③.mcp.json 定稿 vod-devkit serve(相对路径+cwd 在 codex 0.166 实测不解析到插件目录)④sync_plugin.py 补 skills 同步(此前只同步 vod_mcp=又一漂移面)
128
+ - 4418a91 feat(D-golden-1 扩展+D-probe-1 探针工具化): ①tests/probe.py 可复用 stdio 探针(initialize/tools/call/护栏 error 分流——多轮真机手法沉淀)+pack 门控真实装配层锁(VOD_PACKS 两种取值 tools/list 协议级断言)②golden 扩展:status 原样 manifest 契约(HOME/REPO/ORIGIN/SHA/installedAt 归一化+skillHashes 值不锁归漂移锁专项)+preset update 固定拒绝语;_assert_golden 复用 helper;78 用例绿。proposal S43/S44
129
+ - 2782f5e feat(D-golden-1 doctor/verify golden 基线): 用户可见输出快照比对(devkit doctor-golden 对表,差距清单①第一步)——易变段归一化(HOME/REPO/SHA12),口径漂移即红,有意变更 UPDATE_GOLDEN=1 重录并在失败 diff 人工过目;无 key 确定性基线(key 探针行含易变指纹不入基线);顺带修测试基建 bug:shutil.ignore_patterns 只匹配基名,'vod_mcp/runtime.json' 带斜杠模式永不命中致 clone 混入真源账本。proposal S42+design golden 节;76 用例绿
130
+ - 28c1f80 feat(D-release-1 一键发版体系+包内容门): release.sh 重写对齐 devkit release-please 语义——bump 从提交历史推导+版本落点表驱动 EXTRA_FILES+整行正则替换+全落点硬断言(根治静默 no-op);新增 scripts/pack_verify.py 包内容门(pack --dry-run 必含/危险项断言)——首跑即实锤 0.1.12 曾含 runtime.json 凭据残留(已 deprecate,0.2.0 起文件级白名单结构性排除,npm 0.1.12 残留令牌仅对已销毁本地库有效);package.json files 改文件级白名单+npm 分发补 plugins/ 随包(0.2.0 漏项致 npx codex 路径必挂,0.2.1 修复);RELEASING.md 发版手册;proposal S41+decisions D-release-1;一键发版真机闭环 v0.2.0/v0.2.1(npx codex 原生插件安装复验通过)
131
+
132
+
133
+ ## v0.2.3(2026-11-06)
134
+
135
+ - b3a9a19 S52/S53 场景用例独立成条(极端选择兜底/纠正闭环,从S50补口拆出)+design话术分层同步至S49-S53+D-option引用;router冗余前缀判断合并(in text[:20]为startswith超集,语义不变,既有回归锁覆盖两分支)
136
+ - d30c76a S50 补两口(用户确认):只提追加句括号兜底不进并列选项+纠正闭环(不辩论/按纠正理解走/content仍原话逐字/禁新定性改写);S51 泛化落档 D-option-executability-1(话术选项可执行性纪律:写选项前逐项问代码路径在哪);7例回归锁(115绿)
137
+ - 54d08e3 S49-S51 追加反馈定性话术定稿:先定性再问+留纠正口子+禁空头承诺(无承载机制不得进话术选项);双副本同步锁+frontmatter完整性回归(plugins副本漏同步太慢/吞frontmatter实锤修复);proposal/design/test 三件套齐(113例绿)
138
+ - 5e926b1 skill(collect): 追加反馈定性话术——确认环节用户追加表达时先定性再问(定性是 agent 职责,用户只拍板范围),补模糊话术闭环
139
+ - a16f52d test+docs(router): M1 描述前置回归锁(57字符可见预算+长度上限+词表一致性三断言)——实锤补「太慢」缺失进四副本 description;design §五 多宿主对表与来源分级+M 用例承载表
140
+ - cd4f995 docs(router): 矩阵来源分级+官方文档校正——codex 预算参照改官方 8000 默认(5440=实测值)、钩子事件表官方依据;opencode 官方通道正名 prompt admission hook+description 1-1024 官方上限;dsh/hermes 行标注内部依据(可追溯性纪律)
141
+ - 087f005 docs(router): 矩阵修正——codex「无钩子面」事实错误更正(钩子面存在但输出截断+注入路径不一致方为不做理由,两行合一);hermes 预算表述精确化(57字符索引预算由描述前置吸收);opencode 补截断阈值依据
142
+ - 02f68f5 docs+test+refactor(router): 需求/设计文档正式化(docs/hermes-feedback-router/)+场景用例 H1-H4/R5-R8 承载映射+触发词表单一事实源重构(TRIGGER_WORDS 正则自动组装,补「很糟糕/太糟糕」变体——R5 长句用例暴露覆盖缺口实锤)+register 契约回归锁;修指令文案笔误
143
+ - 37af96f docs(router): 多宿主矩阵更新——opencode 钩子能力实锤结案(chat.message+合成消息双通路,前提高不成立);codex 注入路径不一致风险补记(#37463/#33945)
144
+ - e7d2bf3 docs(router): 多宿主对表——opencode/codex/dsh 激活现状/截断暴露/强制评估可行性矩阵
145
+ - 4a4e095 docs(router): hermes-router.md 补入版本库(上笔提交遗漏 add,untracked 实锤——多会话并行时提交前必须核对文件清单)
146
+ - 5ca9960 feat(docs+gate): S45-S48 场景用例+D-desc-budget-1 截断预算门禁+安装器块扫描重构——①proposal 三·八新增 S45-S48(dsh 安装硬校验拒/放/幂等落盘/修复指引、description 500 字窗口与 Codex 5440 预算存活、归因口径单源)+S11 刷新安装器通道+决策表两行;design 五节 dsh target/六节预算门禁承载;②tests/test_desc_budget.py 4 用例:B1 先决条件<500 字符(dsh 最严窗口)/B2 总长≤1500/双载体(contract+dsh lib 组合串提取)/漂移锁禁旧宽容口径回流;③重构 _find_dsh_block 单一实现供 upsert/uninstall 共用(防双处扫描规则漂移),uninstall 净化;101 pytest+7 node 绿,pyflakes 净
147
+ - e8a21f9 feat(hook): D-hook-1 强制评估路由插件 vod-feedback-router——pre_llm_call 确定性意图路由(业界 forced-eval ~84% 模式),H1-H4 回归锁+installer 集成+decisions 记档
148
+ - 50f754c feat(installer+dsh): D-dsh-install-1 安装期硬校验落 dsh 壳——install --target dsh(--profile 必填先校验后 add、产品 meta 硬校验复用、幂等 upsert profile cordis.patch.yml config 段、dsh 缺失 exit2、写失败 exit1 带修复指引、manifest dshProfile+uninstall 摘除);生效通道真机实证(profile patch config override,banner+桩提交链);dsh 壳 description 归因漂移修复(旧宽容口径句→部署配置权威);INSTALL/dsh README 口径更新;9 回归+golden 重录(仅 +dshProfile 键);93 pytest+7 node 绿
149
+ - 8bdc225 fix(collect-skill): description 触发词前置(Hermes 索引仅前57字符可见,「体验差」原在截断边缘——业界截断静默失败教训)+禁复现排查模式句
150
+ - 7261ec0 docs(dsh): 归因注释对齐 D-attrib-A(实现本就只读配置绑定,模型传参不采信——天然免疫宿主名错归)
151
+ - 53579b0 feat(attribution): D-attrib-A 归因只由安装绑定决定——运行期显式传参仅绑定一致才采信(宿主名自报忽略+ignoredRuntimeProduct 留痕+productSource 可观测),6 回归锁覆盖拍板五场景;推翻 2026-11-03 宽容口径
152
+ - 8f8dca9 fix(collect-skill): 一次抱怨=一条声音红线——禁拆分禁改写变体(实锤:一次抱怨被宿主改写成两条入库建两 issue,引擎逐字幂等被绕过)
153
+ - cd4cccc fix(roster): 多宿主落点并集合并+HOME 隔离剪枝(实锤:按最近安装覆盖互相冲掉落点;fake-home 吞真实 HOME 历史落点)
154
+ - d67ad1b chore(plugin): sync+重烧 build-info
155
+ - a14b857 feat(doctor+instructions+e2e): 名册对账逐宿主核对技能副本+codex 目录补拷;initialize instructions 主动披露采集纪律;free-choice 行为回归脚本(B 熔断违规计数)——huaweicloud-devkit 三防线借鉴落地
156
+ - b3d6030 feat(echo): 提交回执强制原话回显(方案 A 拍板落地)——echo{requiresUserEcho,instruction,contents}+契约 schema/description+2 回归锁;decisions.md 记 D-echo-A-1(A 默认/B 宿主级熔断触发条件)
157
+ - ede20d7 fix(installer): manifest 重复 product 死键删除+golden 键序重录(值不变,product 移至绑定位置)
158
+ - 28c8f5f fix(installer): opencode 目标补拷原生技能到 ~/.config/opencode/skills/(opencode 原生 skill 机制实测识别,此前仅工具描述单通道)
159
+ - 0f4b9d2 feat(contract): vod_submit_voices 描述前置模糊反馈固定话术(MCP-only 宿主唯一约束源,opencode 交互三件套补齐)
160
+ - 5b97527 chore(plugin): sync vod_mcp+skills 自包含包+重烧 build-info(8bfb9f6)
161
+ - 8bfb9f6 fix(submit): 囤积回执缺 voiceIds 不得兜底计成功+引擎 rejected 透出(codex 谎报成功实锤修复);采集技能模糊反馈固定话术(F3 观测定稿)
162
+ - bb312e3 test: golden status 重录版本号 0.2.1→0.2.2(v0.2.2 发版漏重录,pre-push 门禁被存量红挡)
163
+ - b111900 fix(D-consent-desc-1): 确认纪律前置进工具描述——opencode 把用户陈述反馈当同意直提单实锤(契约 description 立即调用话术与 confirm 纪律冲突,MCP-only 宿主不加载技能唯描述可依)+dsh 壳同步+回归锁
164
+
package/bin/vod-devkit CHANGED
@@ -82,6 +82,44 @@ def _server_env(args, packs: str) -> dict:
82
82
  return env
83
83
 
84
84
 
85
+ def _skill_installs(manifest_path: Path, oc_skills, cx_skills) -> list:
86
+ """多宿主技能落点并集(名册对账):manifest 按「最近一次安装」覆盖会
87
+ 互相冲掉落点(实锤:codex 装完 opencode 落点消失),按 host+dir
88
+ 去重保留历史落点。"""
89
+ import json as _json
90
+ import os
91
+ home = str(Path.home()) + os.sep
92
+ prev = {}
93
+ if manifest_path.exists():
94
+ try:
95
+ for si in _json.loads(manifest_path.read_text(encoding="utf-8")).get("skillInstalls") or []:
96
+ d = si.get("dir") or ""
97
+ # 只保留「当前 HOME 之下且目录真实存在」的落点——隔离环境
98
+ # (fake-home 测试)不吞真实 HOME 的历史落点,卸载残留自动剪枝
99
+ if d.startswith(home) and Path(d).is_dir():
100
+ prev[(si["host"], d)] = si
101
+ except Exception:
102
+ pass
103
+ for h, d in (("hermes", HERMES_SKILLS_DIR),
104
+ ("opencode", oc_skills), ("codex", cx_skills)):
105
+ if d is not None:
106
+ prev[(h, str(d))] = {"host": h, "dir": str(d)}
107
+ return sorted(prev.values(), key=lambda x: (x["host"], x["dir"]))
108
+
109
+
110
+ def _dir_hashes(base: Path) -> dict:
111
+ """对既有目录树计算相对 sha256 指纹(roster 对账用)。"""
112
+ import hashlib
113
+ out = {}
114
+ for skill in sorted(Path(base).iterdir()):
115
+ if skill.is_dir():
116
+ for f in sorted(skill.rglob("*")):
117
+ if f.is_file():
118
+ out[f"{skill.name}/{f.relative_to(skill)}"] = (
119
+ hashlib.sha256(f.read_bytes()).hexdigest())
120
+ return out
121
+
122
+
85
123
  def _skill_hashes() -> dict:
86
124
  """技能拷贝件指纹(D-drift-lock):安装时记录 sha256,verify/doctor 比对
87
125
  ——拷贝件与安装产物漂移可检(vendor 规则漂移实锤的针对性防线)。"""
@@ -125,6 +163,17 @@ def _install_hermes(args, packs: str) -> Path:
125
163
  ["hermes", "mcp", "add", "vod-devkit", "--command", sys.executable,
126
164
  *["--env"] + env_args, "--args", _server_entry()],
127
165
  input="y\ny\n", capture_output=True, text=True)
166
+ # D-hook-1:强制评估路由插件(pre_llm_call 确定性意图路由,业界 forced-eval 模式)
167
+ import shutil as _sh
168
+ plug_src = ROOT / "hermes-plugin" / "vod-feedback-router"
169
+ plug_dst = Path.home() / ".hermes" / "plugins" / "vod-feedback-router"
170
+ if plug_src.is_dir():
171
+ if plug_dst.exists():
172
+ _sh.rmtree(plug_dst)
173
+ _sh.copytree(plug_src, plug_dst)
174
+ print("已安装 vod-feedback-router 路由插件(~/.hermes/plugins/);"
175
+ "需在 plugins.enabled 加入该名单后生效"
176
+ "(hermes config set plugins.enabled ...,重启会话生效)")
128
177
  if r.returncode == 0:
129
178
  print("已注册 Hermes MCP(hermes mcp list 可见;重启会话生效)")
130
179
  else:
@@ -264,8 +313,106 @@ def _install_codex(args, packs: str) -> Path:
264
313
  return conf
265
314
 
266
315
 
316
+ def _install_dsh(args, packs: str) -> Path:
317
+ """dsh 工具壳(D-dsh-install-1,2026-11-06 用户拍板 A):三壳口径统一——
318
+ --product 安装期硬校验(cmd_install 已先行,到达此处必已过)+ 校验先于
319
+ add + 幂等写 profile cordis.patch.yml config override。
320
+ 生效通道真机实测(2026-11-06,dsh 0.2.1-rc.5):profile cordis.patch.yml
321
+ 的 id-targeted config override 是工具壳读取 product/apiBase/confirmWrites
322
+ 的唯一运行时通道(启动 banner + 桩引擎提交链实证)。dsh plugin add 会自建
323
+ profile,无需前置。"""
324
+ dsh = shutil.which("dsh")
325
+ profile = (getattr(args, "dsh_profile", "") or "").strip()
326
+ if not profile:
327
+ # argparse 进入安装前校验(cmd_install 已兜底,直调防御)
328
+ print("[vod-devkit] --profile 必填:dsh 按 profile 组织插件与配置"
329
+ "(--profile <name>)", file=sys.stderr)
330
+ sys.exit(2)
331
+ if not dsh:
332
+ print("[vod-devkit] 未找到 dsh CLI(PATH),拒绝安装(宁可不装不可装错)。"
333
+ "前置:npm i -g @deepseek-ai/dsh(需 pnpm)", file=sys.stderr)
334
+ sys.exit(2)
335
+ r = subprocess.run([dsh, "plugin", "--profile", profile,
336
+ "add", "dsh-vod-devkit"],
337
+ capture_output=True, text=True, timeout=300)
338
+ if r.returncode != 0:
339
+ print(f"[vod-devkit] dsh plugin add 失败:{(r.stderr or r.stdout).strip()[-300:]}",
340
+ file=sys.stderr)
341
+ sys.exit(1)
342
+ print(f"已安装 dsh 插件 dsh-vod-devkit(profile={profile},dsh plugin list 可见)")
343
+
344
+ patch = Path.home() / ".dsh" / "profiles" / profile / "cordis.patch.yml"
345
+ block = ("- id: vod-devkit\n"
346
+ " config:\n"
347
+ f" product: {args.product}\n"
348
+ f" apiBase: {args.java_api_base}\n")
349
+ try:
350
+ written = _upsert_dsh_patch(patch, block)
351
+ except Exception as e:
352
+ # 回滚/修复指引:插件已装但配置未写 = 半成品,给明确的手动修复格式
353
+ print(f"[vod-devkit] 插件已装入 profile={profile},但配置写入失败"
354
+ f"({e.__class__.__name__})。请手动把下段并入 {patch}"
355
+ f"(顶层 YAML 数组元素,已有 - id: vod-devkit 段则原位替换):\n"
356
+ f"{block}", file=sys.stderr)
357
+ sys.exit(1)
358
+ if written:
359
+ print(f"已写入归因/引擎配置(幂等 upsert):{patch}")
360
+ else:
361
+ print(f"配置未变化(幂等跳过):{patch}")
362
+ return patch
363
+
364
+
365
+ def _find_dsh_block(lines):
366
+ """定位 cordis.patch.yml 中 `- id: vod-devkit` 顶层块的 (start, end);
367
+ 不存在返回 (None, None)。块边界=下一顶层元素行(`- ` 开头)或 EOF。
368
+ install 的幂等 upsert 与 uninstall 的摘除共用同一边界语义(单一实现,
369
+ 防两处扫描规则漂移——双载体漂移已在本仓 dsh/UI 壳实锤过)。"""
370
+ for i, ln in enumerate(lines):
371
+ if ln.strip().startswith("- id: vod-devkit"):
372
+ end = len(lines)
373
+ for j in range(i + 1, len(lines)):
374
+ if lines[j].startswith("- "): # 下一顶层元素:本块结束
375
+ end = j
376
+ break
377
+ return i, end
378
+ return None, None
379
+
380
+
381
+ def _upsert_dsh_patch(patch: Path, block: str) -> bool:
382
+ """幂等写 profile cordis.patch.yml:已存在 `- id: vod-devkit` 段则原位整块
383
+ 替换(不重复插入);无则追加。按行扫描块边界(下一行 `- ` 顶层元素或 EOF),
384
+ 不引 YAML 依赖(本仓零第三方依赖红线)。返回是否有写入。"""
385
+ lines = patch.read_text(encoding="utf-8").splitlines() if patch.exists() else []
386
+ start, end = _find_dsh_block(lines)
387
+ if start is None:
388
+ new = lines + ([""] if lines and lines[-1].strip() else []) + block.splitlines()
389
+ else:
390
+ new = lines[:start] + block.splitlines() + lines[end:]
391
+ new_text = "\n".join(new).rstrip("\n") + "\n"
392
+ old_text = patch.read_text(encoding="utf-8") if patch.exists() else ""
393
+ if new_text == old_text:
394
+ return False
395
+ patch.parent.mkdir(parents=True, exist_ok=True)
396
+ patch.write_text(new_text, encoding="utf-8")
397
+ return True
398
+
399
+
400
+ def _remove_dsh_patch_block(patch: Path) -> bool:
401
+ """从 cordis.patch.yml 摘除 vod-devkit 块(uninstall 用)。返回是否摘除。"""
402
+ if not patch.exists():
403
+ return False
404
+ lines = patch.read_text(encoding="utf-8").splitlines()
405
+ start, end = _find_dsh_block(lines)
406
+ if start is None:
407
+ return False
408
+ patch.write_text(
409
+ "\n".join(lines[:start] + lines[end:]).rstrip("\n") + "\n",
410
+ encoding="utf-8")
411
+ return True
412
+
413
+
267
414
  _INSTALLERS = {"hermes": _install_hermes, "opencode": _install_opencode,
268
- "codex": _install_codex}
415
+ "codex": _install_codex, "dsh": _install_dsh}
269
416
 
270
417
 
271
418
  def detect_targets() -> list:
@@ -277,6 +424,8 @@ def detect_targets() -> list:
277
424
  found.append("opencode")
278
425
  if (Path.home() / ".codex").exists():
279
426
  found.append("codex")
427
+ if shutil.which("dsh"):
428
+ found.append("dsh")
280
429
  return found
281
430
 
282
431
 
@@ -389,6 +538,12 @@ def cmd_install(args):
389
538
  " GET /external/products",
390
539
  file=sys.stderr)
391
540
  sys.exit(2)
541
+ # D-dsh-install-1:--profile 必填在进入任何安装动作前校验(先校验后写入)
542
+ if target == "dsh" and not (args.dsh_profile or "").strip():
543
+ print("[vod-devkit] --profile 必填:dsh 按 profile 组织插件与配置。\n"
544
+ " 例:npx vod-devkit install --target dsh --profile web --product CodeArts",
545
+ file=sys.stderr)
546
+ sys.exit(2)
392
547
  bound_product = args.product
393
548
  # D-product-id-2(2026-11-05 用户拍板 B,推翻"宿主名是显式合法值"宽容口径):
394
549
  # 安装期产品硬校验——--product 必须命中 meta productCatalog(名字大小写不敏感
@@ -424,7 +579,22 @@ def cmd_install(args):
424
579
 
425
580
  # G1 修复:技能全量拷贝(目录型技能+平铺规则文档),按 packs 过滤
426
581
  HERMES_SKILLS_DIR.mkdir(parents=True, exist_ok=True)
582
+ # opencode 原生技能目录(2026-11-06 实测:opencode 自动发现
583
+ # ~/.config/opencode/skills/ 并经 skill 工具按需加载——此前安装器漏拷,
584
+ # opencode 只有工具描述一条约束通道,话术类约束全部失效)
585
+ oc_skills = None
586
+ cx_skills = None
587
+ if target == "opencode":
588
+ import platform as _pf
589
+ oc_base = Path.home() / (".config/opencode" if _pf.system() != "Windows"
590
+ else "AppData/Local/opencode")
591
+ oc_skills = oc_base / "skills"
592
+ oc_skills.mkdir(parents=True, exist_ok=True)
593
+ elif target == "codex":
594
+ cx_skills = Path.home() / ".codex" / "skills"
595
+ cx_skills.mkdir(parents=True, exist_ok=True)
427
596
  pack_set = set(p for p in packs.split(",") if p)
597
+ extra_skill_dirs = [d for d in (oc_skills, cx_skills) if d is not None]
428
598
  for entry in sorted((ROOT / "skills").iterdir()):
429
599
  if entry.is_dir(): # vod-core / vod-feedback-collect
430
600
  skill = entry.name
@@ -436,11 +606,15 @@ def cmd_install(args):
436
606
  if dst.exists():
437
607
  shutil.rmtree(dst)
438
608
  shutil.copytree(entry, dst)
609
+ for oc_dst in extra_skill_dirs:
610
+ dst2 = oc_dst / skill
611
+ if dst2.exists():
612
+ shutil.rmtree(dst2)
613
+ shutil.copytree(entry, dst2)
439
614
  # vendored 领域规则已由 vendor_rules.py 落成技能目录结构
440
615
 
441
616
  bi = json.loads((ROOT / "build-info.json").read_text(encoding="utf-8"))
442
617
  manifest = {
443
- "product": "vod-devkit",
444
618
  "version": bi["version"],
445
619
  "source": {"type": "git", "remote": bi["sourceRemote"],
446
620
  "ref": subprocess.run(["git", "rev-parse", "--abbrev-ref", "HEAD"],
@@ -452,8 +626,15 @@ def cmd_install(args):
452
626
  "distribution": getattr(args, "distribution", "devkit"),
453
627
  "product": bound_product,
454
628
  "packs": packs,
629
+ "dshProfile": (getattr(args, "dsh_profile", "") or "").strip() or None,
455
630
  "mcpConfig": str(mcp_conf),
456
631
  "skillsDir": str(HERMES_SKILLS_DIR),
632
+ # 名册对账(huaweicloud-devkit doctor 模式借鉴,2026-11-06):
633
+ # 每个原生技能落点的独立指纹——漏装/漂移可被 doctor 逐落点抓出,
634
+ # 不再只盯 hermes 单目录(opencode 漏拷静默失效的针对性防线)。
635
+ # 多宿主并集合并:manifest 按「最近一次安装」覆盖会互相冲掉落点
636
+ # (实锤:codex 装完 opencode 落点消失),按 host+dir 去重保留历史
637
+ "skillInstalls": _skill_installs(manifest_path(), oc_skills, cx_skills),
457
638
  "skillHashes": _skill_hashes(),
458
639
  }
459
640
  manifest_path().write_text(json.dumps(manifest, ensure_ascii=False, indent=2),
@@ -502,6 +683,21 @@ def cmd_doctor(_args):
502
683
  if drifted:
503
684
  problems.append("技能拷贝件与安装产物漂移(D-drift-lock):"
504
685
  + "、".join(drifted) + "——重跑 install 恢复")
686
+ # 名册对账(逐原生落点):漏装/漂移按宿主点名(借鉴 devkit doctor)
687
+ for si in mf.get("skillInstalls") or []:
688
+ d = Path(si["dir"])
689
+ if not d.exists():
690
+ problems.append(f"技能原生副本缺失({si['host']}):{d} 不存在"
691
+ "——重跑 install 恢复")
692
+ continue
693
+ import hashlib
694
+ expect = mf.get("skillHashes") or {}
695
+ for rel, sha in expect.items():
696
+ f = d / rel
697
+ if not f.exists():
698
+ problems.append(f"技能文件缺失({si['host']}):{rel}")
699
+ elif hashlib.sha256(f.read_bytes()).hexdigest() != sha:
700
+ problems.append(f"技能文件漂移({si['host']}):{rel}")
505
701
  if problems:
506
702
  for x in problems:
507
703
  print("FAIL:", x)
@@ -610,6 +806,16 @@ def cmd_uninstall(_args):
610
806
  if oc_cmd.exists():
611
807
  oc_cmd.unlink()
612
808
  print("removed:", oc_cmd)
809
+ # dsh 壳(D-dsh-install-1):摘插件 + 从 profile patch 移除 config 段
810
+ dsh = shutil.which("dsh")
811
+ if dsh:
812
+ prof = (mf.get("dshProfile") or "").strip()
813
+ if prof:
814
+ subprocess.run([dsh, "plugin", "--profile", prof, "remove",
815
+ "dsh-vod-devkit"], capture_output=True, text=True)
816
+ patch = Path.home() / ".dsh" / "profiles" / prof / "cordis.patch.yml"
817
+ if _remove_dsh_patch_block(patch):
818
+ print("removed vod-devkit config block:", patch)
613
819
  p.unlink()
614
820
  print("removed:", p)
615
821
  else:
@@ -620,7 +826,8 @@ def main():
620
826
  ap = argparse.ArgumentParser(prog="vod-devkit")
621
827
  sub = ap.add_subparsers(dest="cmd", required=True)
622
828
  sp = sub.add_parser("install")
623
- sp.add_argument("--target", default="auto", help="hermes|opencode|codex|auto(默认探测)")
829
+ sp.add_argument("--target", default="auto",
830
+ help="hermes|opencode|codex|dsh|auto(默认探测)")
624
831
  sp.add_argument("--preset", default="collect", choices=list(PRESETS),
625
832
  help="collect=对外默认(采集者);full=内部全量")
626
833
  sp.add_argument("--api-base", default="http://127.0.0.1:8000")
@@ -632,6 +839,8 @@ def main():
632
839
  sp.add_argument("--distribution", default="devkit", choices=["devkit", "preset"],
633
840
  help="devkit=开发/运维自装(默认);preset=产品随 agent 分发(禁 key 随包/"
634
841
  "禁自更新/客户机首启重生成状态)")
842
+ sp.add_argument("--profile", dest="dsh_profile", default="",
843
+ help="dsh 专用:profile 名(--target dsh 时必填)")
635
844
  sp.add_argument("--no-local-ledger", action="store_true",
636
845
  help="关闭本地提交账本(企业数据驻留要求;vod_list_submitted 将不可用)")
637
846
  sp.set_defaults(fn=cmd_install)
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "title": "vod-devkit MCP 工具契约(唯一事实源)",
4
- "version": "0.2.1",
4
+ "version": "0.2.3",
5
5
  "tools": {
6
6
  "vod_submit_voices": {
7
- "description": "提交用户反馈。product 归因由安装绑定自动完成(install --product 必配且经产品名录硬校验),调用时无需用户提供、禁止向用户询问\"提交到什么产品\";用户自报的目标产品一律不采信不覆盖(照部署产品提交,提到什么产品随正文原样传达)。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值)。缺 key 时自动获取零字段匿名令牌。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
7
+ "description": "提交用户反馈进 VOD。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止传 confirmed=true**。模糊抱怨(如\"体验不好\")时一轮说完三件事:承接识别结果(\"收到,你对产品体验不满意\")+确认提交意愿(\"要把这条反馈提交给产品团队吗?\")+引导补充(\"方便的话说下具体现象,不说我也会按你的原话提交\");禁止含混反问(实锤病句:\"请问是否把什么作为反馈\")。同意后 content 放用户原话(哪怕只有一句\"体验很差\"也原样提交),不要为补齐信息而追问——缺的细节由运营侧补充。product 归因由安装绑定自动完成,无需用户提供、禁止询问\"提交到哪个产品/页面\";用户自报的目标产品一律不采信不覆盖(照部署产品提交,提到什么产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,禁止索要复现步骤/严重程度/环境/附件等开发者字段。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。拿到回执后必须原样转述 echo.contents(每条「已收录原话:<content>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
8
8
  "input": {
9
9
  "type": "object",
10
10
  "properties": {
@@ -74,11 +74,47 @@
74
74
  ]
75
75
  },
76
76
  "description": "引擎分析任务 ID(与 voiceIds 对位;幂等重发为 null)"
77
+ },
78
+ "echo": {
79
+ "type": "object",
80
+ "description": "原话回显(方案 A,检测型防线):requiresUserEcho=true 时 agent 必须向用户逐条原样转述 contents(「已收录原话:<content>」),禁止改写/概括;用户借此当场发现宿主模型是否改写了原话",
81
+ "properties": {
82
+ "requiresUserEcho": {
83
+ "type": "boolean"
84
+ },
85
+ "instruction": {
86
+ "type": "string"
87
+ },
88
+ "contents": {
89
+ "type": "array",
90
+ "items": {
91
+ "type": "object",
92
+ "properties": {
93
+ "voiceId": {
94
+ "type": "string"
95
+ },
96
+ "content": {
97
+ "type": "string"
98
+ }
99
+ },
100
+ "required": [
101
+ "voiceId",
102
+ "content"
103
+ ]
104
+ }
105
+ }
106
+ },
107
+ "required": [
108
+ "requiresUserEcho",
109
+ "instruction",
110
+ "contents"
111
+ ]
77
112
  }
78
113
  },
79
114
  "required": [
80
115
  "accepted",
81
- "voiceIds"
116
+ "voiceIds",
117
+ "echo"
82
118
  ]
83
119
  },
84
120
  "backend": "java(VOD_JAVA_API_BASE+VOD_JAVA_API_KEY);现有 /external/voice/submit"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "VOD user-feedback collection: structured voice capture and submission to the VOD hoarding endpoint.",
5
5
  "keywords": [
6
6
  "feedback",
@@ -1,9 +1,8 @@
1
1
  {
2
2
  "mcpServers": {
3
3
  "vod-devkit": {
4
- "command": "python3",
5
- "args": ["./vod_mcp/server.py"],
6
- "cwd": ".",
4
+ "command": "vod-devkit",
5
+ "args": ["serve"],
7
6
  "env": { "VOD_PACKS": "core,collect" }
8
7
  }
9
8
  }
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.2.1",
3
- "commitSha": "bad4fec6576ec2f19bc070433206c5c4ca04f388",
4
- "builtAt": "2026-11-05T23:41:27",
2
+ "version": "0.2.3",
3
+ "commitSha": "b3a9a19937de041a0f9a1996602cecc98ffc97ef",
4
+ "builtAt": "2026-11-06T13:24:45",
5
5
  "sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
6
6
  }
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: vod-core
3
+ description: 'VOD 用户声音分析插件路由入口。任何"分析用户声音/反馈、发起 VOD 分析任务、查任务状态/结果、VOD 评分/分类规则、KB 检索"类请求先经本技能路由到对应工具与领域技能。写操作(发起分析)必须先获用户确认(confirm 护栏)。'
4
+ version: 1
5
+ ---
6
+
7
+ # VOD Core
8
+
9
+ VOD 分析能力入口。按意图路由:
10
+
11
+ | 意图 | 动作 |
12
+ |---|---|
13
+ | 发起分析 | 工具 vod_run_analysis(confirm:必须用户确认后传 confirmed=true;taskId 为对账主键) |
14
+ | 查任务进度/结果 | vod_task_status / vod_task_result |
15
+ | 知识库检索 | vod_kb_search |
16
+ | 插件自述/来源核验 | vod_devkit_info |
17
+ | 分类匹配/问题分类/评分规则 | 领域技能(由 vendor 机制从 VOD-Project 真源拉取:vod-category-matching / vod-problem-classification / vod-scoring-rules) |
18
+
19
+ 纪律:
20
+ 1. 任务 ID 是唯一对账主键,发起后一切追问以 taskId 对账,不凭记忆描述
21
+ 2. 单任务条数上限、product 白名单由护栏强制,超限直接拒
22
+ 3. 任何 DB 直连/凭据读取意图会被 deny——不要尝试
23
+ 4. 领域规则以 vendored 技能文件为准,不凭训练数据回答 VOD 评分口径
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: vod-feedback-collect
3
- description: Use when 用户表达对本产品的反馈、不满、建议或明确要求提交反馈(慢/错/卡/希望支持/记下来反馈给产品团队)。采集-确认-提交-回执一条线;产品归由安装绑定自动完成,不问用户
3
+ description: '用户抱怨/体验差/太慢/报错/提单 → 采集原话进 VOD。识别到抱怨即承接并征得同意(禁止问哪个产品,禁止复现排查模式);content=原话逐字;一次抱怨一条;回执 echo 原样转述。详见正文流程与禁令。'
4
+ version: 1
4
5
  ---
5
6
 
6
7
  # VOD 用户反馈采集
@@ -45,6 +46,42 @@ description: Use when 用户表达对本产品的反馈、不满、建议或明
45
46
  **不追问原则**:内容太泛时引导一次("说下具体现象?"),用户不补
46
47
  就按原话提交或放弃——禁止反复追问,禁止替用户脑补现象细节。
47
48
 
49
+ **模糊反馈固定话术(2026-11-06 真实观测定稿,F3 闭环)**:用户只说
50
+ 泛化抱怨("体验不好/很差劲")时,一次性说清三件事,禁止含混反问
51
+ (实锤病句:"请问是否把什么作为反馈"——用户听不懂在问什么):
52
+ 1. 承接识别结果("收到,你对产品体验不满意");
53
+ 2. 确认收录意愿("要把这条反馈提交给产品团队吗?");
54
+ 3. 引导补充+兜底承诺("方便的话说下具体现象,不说我也会按你的
55
+ 原话提交")。
56
+ 整段一轮说完,不拆两轮、不复读式追问。
57
+
58
+ **追加反馈定性话术(2026-11-06 定稿,S49-S51)**:用户在确认
59
+ 环节追加表达(如「我看怎么说,你才明白」这类对沟通过程的
60
+ 挫败)时,**先给一句定性再问**,不把「这句话算不算反馈」的
61
+ 判断丢给用户;定性必须标注为 **agent 的理解**并留纠正口子,
62
+ 不许当事实断言:
63
+ 1. 定性(一句话说清这是什么+留口:「这句听起来更像是对刚才
64
+ 沟通没被理解的挫败——我理解得对吗?」;「听起来更像」
65
+ 而非「就是」,用户可纠正,agent 不替用户下结论);
66
+ 2. 确认范围,仅两个真实可执行选项:「连同最初那句一起提交」
67
+ /「只提交最初那句」——用户一句话拍板(都提/只提原句),
68
+ 不纠缠、不加第三选项抬高决策成本。括号兜底不进并列选项:
69
+ 「想只提交第二句也可以直接说」——极端选择有出口但不抬
70
+ 高常规决策成本;
71
+ 3. 用户纠正定性后的行为(S50 纠正闭环):不辩论,按用户纠正
72
+ 后的理解走,但提交内容仍是用户原话逐字——禁止拿纠正后的
73
+ 「新定性」改写 content(一次抱怨一条+原话红线不因纠正豁免);
74
+ 话术模板尾句:「如果我理解得不对,直接纠正,我按你说的
75
+ 原话提交,不改写」。
76
+ **禁空头承诺(S51)**:不许向用户提供引擎/插件不存在的机制
77
+ ——如「这句作为过程反馈单独记录、不混入产品声量」:客户端
78
+ 无过程反馈通道,引擎无此分类档(content 入库后由引擎重判),
79
+ 承诺即空头支票,用户选了实际做不到。「过程反馈与产品声量
80
+ 分离」若确需,属引擎侧新承载,先有承载再进话术。
81
+ 依据:对 agent 沟通体验的挫败同样指向宿主产品体验,属真实
82
+ 信号;定性由 agent 完成(降低用户决策成本),提交范围决策权
83
+ 在用户。
84
+
48
85
  **职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
49
86
  产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
50
87
  配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
@@ -76,6 +113,11 @@ description: Use when 用户表达对本产品的反馈、不满、建议或明
76
113
  - tags:明显的主题词(性能/功能/易用性),最多 3 个
77
114
  3. 调用 vod_submit_voices(必须用户已确认,confirmed=true)——
78
115
  **一次一批**,攒多条一起交也行,但每批都要用户点头
116
+ **一次抱怨=一条声音(2026-11-06 实锤红线)**:用户一次表述只提交一条,
117
+ content=原话逐字——禁止拆成多条、禁止生成多个改写变体(实锤:一次
118
+ "网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
119
+ 两个 issue;引擎幂等按内容逐字比对,改写即绕过)。多条仅当用户明确
120
+ 分条给了多个不同反馈
79
121
  4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
80
122
  **voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
81
123
  用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
@@ -104,42 +146,14 @@ description: Use when 用户表达对本产品的反馈、不满、建议或明
104
146
  5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
105
147
  6. 单批上限 50 条,超限分批
106
148
 
107
- ## 对齐 VOD-Project 采集标准(2026-11-04 二轮修订,待一次真实用户观测后定稿)
108
-
109
- 学习源=VOD-Project skills/bbs-suggestion + vod-sync/SKILL.md(深读):
110
-
111
- ### content 模板(替代自由拼装,四节加粗标签)
112
- ```
113
- 用户原话(不加标签,保留措辞)
114
-
115
- **使用场景:**
116
- (agent 推断,不允许空——空=拒提交,逼推断)
117
-
118
- **当前影响:**(可选)
119
-
120
- **期望能力:**
121
-
122
- **声音来源:**
123
- (agent 会话平台:cli/飞书/企业微信…——运行时从宿主会话上下文
124
- 获取,禁止硬编码默认值;对齐 detect_channel 纪律)
125
- ```
126
- - 有对话上下文时:最近 5 轮用户消息格式化为 `> 用户:原话` 引用块
127
- 置顶(过滤触发词、与 content 重复的最后一条去掉)
128
-
129
- ### 分类(采集层三分类,不越层)
130
- - 给用户的选项=功能建议/用户体验/产品缺陷(云声表单标准);
131
- 六类是引擎 n01 分析层内部枚举,agent 侧不使用、不自造第四个枚举
132
- - 落 tags=["problem_type:<三分类值>"],引擎以【类型名】标题前缀正式
133
- 入库,n01 照常重判——两层并存,agent 不许宣称"分类即定案"
149
+ ## 对齐 VOD-Project 采集标准(V16 起口径,2026-11-05 修订)
134
150
 
135
- ### 路由纪律
136
- - 用户说"反馈/报告问题/提 issue"→引擎 ISYNC 审核队列路径(本技能
137
- 提交即入队,运营复审后建 issue),agent 不直接建 GitCode issue
138
- - 用户明确"提建议"且要求直上渠道时才提及云声链(bbs-suggestion 为
139
- VOD-Project 内部资产,外部 agent 不分发)
151
+ 历史版本曾有"四节 content 模板/声音来源字段"——已废弃(囤积端点原话提交、
152
+ 渠道由引擎赋值客户端零字段不自报)。现行口径:
140
153
 
141
- ### 自检清单(提交前逐条过,不过不提交)
142
- - [ ] content 含四节模板且使用场景/期望能力非空?
143
- - [ ] 声音来源=真实会话平台(非硬编码)?
144
- - [ ] 分类(若有)是三分类枚举值?
145
- - [ ] 未把 agent 自己的评价混进用户原话?
154
+ - content=用户原话即可提交,**无模板、无必填推断节**(囤积端点无模板校验;
155
+ 旧模板的"空=拒提交"作废)
156
+ - 分类可选:用户表述明显时填三分类 tags,判断不了不填(n01 引擎重判兜底)
157
+ - 渠道/来源一律不提交、不向用户提及(引擎按链路固定赋值)
158
+ - 提单/工单类诉求:不需要"复现步骤/严重程度/优先级"等开发者工单字段——
159
+ 用户原话即完整提交物,缺什么由运营侧补充
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: vod-problem-classification-rules
3
+ description: VOD 问题分类规则(引擎 v2.2 真实口径)— 六类定义、判定细节、LLM 分类流程。真源=workflow/src/n01_classify.py(VOD-Project 2bb3fc82 实测核对)。
4
+ version: 2
5
+ ---
6
+
7
+ # VOD 问题分类规则(引擎 v2 口径)
8
+
9
+ > 真源纪律:本技能内容以引擎代码为准(n01_classify.py DEFAULT_TYPE_DEFS
10
+ > + 分类 prompt),2026-11-03 逐行核对。旧四类口径(BUG/功能需求/
11
+ > 体验优化/其他)已废弃,与引擎不符——它来自过期文档。
12
+ > 采集定位:预分类仅作参考 hint(tags),引擎 LLM 按六类重判——
13
+ > 预分类不是终局,别和用户言之凿凿。
14
+
15
+ ## 六类定义(引擎 DEFAULT_TYPE_DEFS 原文)
16
+
17
+ | 类型 | 判定 |
18
+ |---|---|
19
+ | 产品缺陷 | Bug / 功能不可用 / 报错崩溃 |
20
+ | 技术/业务咨询 | 询问用法 / 支持能力 |
21
+ | 体验改进 | 可用但体验差,求优化交互/性能/UI |
22
+ | 主观评价 | 纯感受 / 评分 / 对比,无具体诉求 |
23
+ | 无效问题 | 内容不完整 / 无意义 / 重复 / 非产品(唯一跳过后续分析的类型) |
24
+ | 功能需求 | 要求新增功能 / 能力 |
25
+
26
+ ## 判定细则(引擎分类 prompt 摘要)
27
+
28
+ - NPS 打分开头 → 主观评价
29
+ - 竞品对比但无具体差异 → 主观评价
30
+ - 纯情绪无场景 → 主观评价
31
+ - 定价/价格类诉求:有具体功能建议 → 功能需求/体验改进;无 → 主观评价
32
+ - 纯好评无建议 → 主观评价
33
+ - 「希望 XX」按实际归类:功能/能力 → 功能需求;交互/UI/性能 → 体验改进
34
+
35
+ ## 引擎分类流程(v2.2)
36
+
37
+ 全量走 LLM 六段式分类(规则预判已移除),fewshot 示例动态检索;
38
+ 少数派结果自动重试。旧 problem_classifier.py 的两类口径
39
+ (问题反馈/产品咨询)为遗留代码,不在 v2 主链。
40
+
41
+ ## 采集用法
42
+
43
+ agent 采集时按上表打 tags(如 problem_type=体验改进),仅作预分类
44
+ 参考;不确定就不填,别硬猜——引擎 LLM 会重判,错误预分类比留空
45
+ 更糟(可能干扰 fewshot 检索)。
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: vod-scoring-rules
3
+ description: VOD 评分规则(引擎 v2 真实公式)— 四项加法、上下限、优先级映射。真源=workflow/src/workflow_v2.py(VOD-Project 2bb3fc82 实测核对)。
4
+ version: 2
5
+ ---
6
+
7
+ # VOD 评分规则(引擎 v2 口径)
8
+
9
+ > 真源纪律:以 workflow_v2.py 评分函数为准,2026-11-03 逐行核对。
10
+ > 旧版"五项维度含用户价值"口径作废——引擎是四项,且非重点问题
11
+ > 上限不同(下方原文),旧文档没写。
12
+
13
+ ## 评分公式(引擎代码原文语义)
14
+
15
+ ```
16
+ 评分 = 声音等级分 + 场景范围分 + 功能重要性分 + 友商对比分
17
+ ```
18
+
19
+ | 项 | 取值 |
20
+ |---|---|
21
+ | 声音等级分 | L1=5.0 / L2=4.0 / L3=3.0 / L4=2.0 / L5=1.0 |
22
+ | 功能重要性分 | 高=1.5 / 中=1.0 / 低=0.5(无一级特性归 0) |
23
+ | 场景范围分 / 友商对比分 | 按分组与竞品数据计算 |
24
+
25
+ ## 上下限(引擎代码,两条都要记)
26
+
27
+ - **重点问题:clamp 1.0 ~ 10.5**
28
+ - **非重点问题:clamp 1.0 ~ 10.0**(2026-09-22 用户定稿"方案甲",
29
+ 旧文档只写 10.5 是不完整口径)
30
+
31
+ 无标签记录:无范围分,仅 等级+重要性+友商 三项。
32
+
33
+ ## 采集用法
34
+
35
+ 用户追问"这条反馈多重要/会不会被优先处理"时按四项口径解释
36
+ (可指出:L1 且涉及友商对比的反馈分最高)。涉及友商对比的反馈
37
+ 是高价值维度——采集时值得追问"之前用的是什么产品"补全该维度。
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.2.1"
8
+ __version__ = "0.2.3"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
@@ -35,6 +35,13 @@ def handle(message: dict) -> dict | None:
35
35
  return _result(req_id, {
36
36
  "protocolVersion": _PROTOCOL_VERSION,
37
37
  "capabilities": {"tools": {}},
38
+ "instructions": (
39
+ "vod-devkit 采集资产与纪律:技能 vod-feedback-collect 处理用户对"
40
+ "本产品的不满/建议/期望(触发词:慢/报错/体验差/希望支持/提单等)。"
41
+ "提交前必须征得用户明确同意(用户抱怨本身不构成同意);提交回执"
42
+ "echo.contents 必须逐条原样转述给用户(「已收录原话:<content>」),"
43
+ "禁止改写、概括、增删字词。product 归因由安装绑定完成,禁止询问用户。"
44
+ ),
38
45
  "serverInfo": {
39
46
  "name": "vod-devkit",
40
47
  "version": tools.load_contract()["version"],
@@ -151,27 +151,35 @@ _PRODUCT_MAP = {
151
151
  }
152
152
 
153
153
 
154
- def _resolve_product(params: dict) -> str | None:
155
- """归因(「宿主即产品」口径,2026-11-03 拍板·不设白名单):
156
- ①调用方显式传参 ②安装绑定(runtime.json product——安装器默认写入宿主名,
157
- hermes/opencode/codex 装在哪就归哪)③都没有 → 返回 None(body 不带
158
- product,引擎落 UNKNOWN 档人工归因解析,V19)——不再 -32013 本地拦截。
154
+ def _resolve_product(params: dict) -> tuple[str | None, str | None]:
155
+ """归因(D-attrib-A:2026-11-06 负责人拍板,方案 A 收紧):
156
+ 归因只由 install 绑定(runtime.json product)决定——运行期显式传参
157
+ 仅当与绑定一致(忽略大小写)才采信;不一致=宿主模型自报,一律忽略
158
+ 回退绑定值(实锤:hermes 会话模型传 product="hermes" 覆盖 CodeArts
159
+ 绑定,[HERMES] 未注册错归)。无绑定 → None(引擎 UNKNOWN 档兜底)。
160
+ 返回 (product, ignored_runtime_product)。
159
161
  T7i(方案 A,2026-11-05 拍板):产品归因主键化——
160
162
  ①纯数字串=平台主键 id,原样透传(引擎 selectById 精确命中)
161
163
  ②名字→meta productCatalog 按名解析出平台 id 后提交(对账主键化,
162
164
  归一化/改名漂移不进提交链路);_PRODUCT_MAP 先归一短码再查目录
163
165
  ③目录无此名/目录不可用→规范名原样上送(引擎 name 兼容通道,
164
166
  命中同样补落 product_id)——不静默丢提交。"""
165
- raw = str(params.get("product") or _RT.get("product") or "").strip()
166
- if not raw:
167
- return None
168
- if raw.isdigit():
169
- return raw
170
- name = _PRODUCT_MAP.get(raw.lower(), raw)
167
+ binding = str(_RT.get("product") or "").strip()
168
+ raw = str(params.get("product") or "").strip()
169
+ ignored = None
170
+ if raw and (not binding or raw.lower() != binding.lower()):
171
+ ignored = raw # 运行期自报≠绑定(或无绑定)→ 忽略留痕,不采信
172
+ raw = ""
173
+ product = raw or binding or None
174
+ if not product:
175
+ return None, ignored
176
+ if product.isdigit():
177
+ return product, ignored
178
+ name = _PRODUCT_MAP.get(product.lower(), product)
171
179
  for item in (_load_meta().get("catalog") or []):
172
180
  if str(item.get("name") or "").lower() == name.lower():
173
- return str(item.get("id"))
174
- return name
181
+ return str(item.get("id")), ignored
182
+ return name, ignored
175
183
 
176
184
 
177
185
  _SUBMIT_HOARDING = "/rest/developer/manager/hdvodmngservice/v1/external/voices"
@@ -237,7 +245,7 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
237
245
  """
238
246
  import uuid
239
247
  host = (client_info or {}).get("name") or "unknown-host"
240
- product = _resolve_product(params)
248
+ product, ignored_runtime = _resolve_product(params)
241
249
  accepted, voice_ids, task_ids, rejected = 0, [], [], []
242
250
  global JAVA_KEY
243
251
  voices_in = params.get("voices", [])
@@ -254,6 +262,19 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
254
262
  if not items:
255
263
  return {"accepted": 0, "voiceIds": [], "taskIds": [], "rejected": rejected}
256
264
 
265
+ def _echo(vids):
266
+ """方案 A(2026-11-06 拍板):提交回执强制携带原话回显。
267
+ 检测型防线——宿主模型改写用户原话(实锤:"体验不好"→"不友好")
268
+ 在回执处当场可见;agent 必须原样转述,改写露馅。"""
269
+ ok = [(vid, items[min(i, len(items) - 1)][2])
270
+ for i, vid in enumerate(vids) if vid]
271
+ return {
272
+ "requiresUserEcho": bool(ok),
273
+ "instruction": ("请向用户原样转述已收录内容:每条以「已收录原话:」开头,"
274
+ "后接 content 全文。禁止改写、概括、增删字词。"),
275
+ "contents": [{"voiceId": vid, "content": c} for vid, c in ok],
276
+ }
277
+
257
278
  def _ledger(vids, tids):
258
279
  import time as _time
259
280
  entries = [{"voiceId": vid, "taskId": tid,
@@ -324,15 +345,32 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
324
345
  if not fallback:
325
346
  server_ids = (out.get("voiceIds") or out.get("data", {}).get("voiceIds")
326
347
  or [])
327
- accepted = len(server_ids) or len(hoard_voices)
328
- voice_ids.extend(server_ids if server_ids else [""] * len(hoard_voices))
348
+ # 引擎侧 rejected(产品校验拒绝等)透出,不吞(对齐 widget rejected 口径)
349
+ engine_rejected = ((out or {}).get("rejected")
350
+ or ((out or {}).get("data") or {}).get("rejected")
351
+ or [])
352
+ if server_ids:
353
+ accepted = len(server_ids)
354
+ voice_ids.extend(server_ids)
355
+ else:
356
+ # 回执缺失/整批被拒 → 不得兜底计成功(实锤缺陷:空 voiceId 记成功
357
+ # 且宿主模型据此谎报"已提交")。accepted 以真实回执为准。
358
+ accepted = 0
359
+ voice_ids.extend([""] * len(hoard_voices))
360
+ if not engine_rejected:
361
+ engine_rejected = [{"reason": "引擎回执未含 voiceIds(提交结果未知),请勿视为已收录"}]
329
362
  task_ids.extend([None] * len(hoard_voices)) # 囤积语义:无即时任务
330
363
  result = {"accepted": accepted, "voiceIds": voice_ids,
331
- "taskIds": task_ids, "rejected": rejected,
364
+ "taskIds": task_ids, "rejected": rejected + engine_rejected,
332
365
  "analysis": "deferred", # 囤积语义明示(V6 运营批量消费)
333
- "path": "hoarding"}
366
+ "path": "hoarding",
367
+ "echo": _echo(voice_ids)}
334
368
  if out.get("productRegistered") is not None:
335
369
  result["productRegistered"] = out.get("productRegistered")
370
+ # D-attrib-A 可观测:模型试图改归因留痕,不静默吞
371
+ result["productSource"] = "install_binding"
372
+ if ignored_runtime:
373
+ result["ignoredRuntimeProduct"] = ignored_runtime
336
374
  _ledger(voice_ids, task_ids)
337
375
  return result
338
376
  # ---- 过渡回落:老链单条提交(仅囤积端点 404 触发) ----
@@ -371,7 +409,8 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
371
409
  rejected.append({"index": i, "reason": msg[:120]})
372
410
  result = {"accepted": accepted, "voiceIds": voice_ids,
373
411
  "taskIds": task_ids, "rejected": rejected,
374
- "path": "legacy-fallback"}
412
+ "path": "legacy-fallback",
413
+ "echo": _echo(voice_ids)}
375
414
  _ledger(voice_ids, task_ids)
376
415
  return result
377
416
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: vod-feedback-collect
3
- description: '采集 agent 产品用户反馈进 VOD。用户在会话中表达对本产品的不满、建议、期望("补全太慢""希望支持XX")时激活:结构化为声音 → 逐次征得用户同意 → vod_submit_voices 提交 → 回执 voiceId 告知已收录。'
3
+ description: '用户抱怨/体验差/太慢/报错/提单 → 采集原话进 VOD。识别到抱怨即承接并征得同意(禁止问哪个产品,禁止复现排查模式);content=原话逐字;一次抱怨一条;回执 echo 原样转述。详见正文流程与禁令。'
4
4
  version: 1
5
5
  ---
6
6
 
@@ -46,6 +46,42 @@ version: 1
46
46
  **不追问原则**:内容太泛时引导一次("说下具体现象?"),用户不补
47
47
  就按原话提交或放弃——禁止反复追问,禁止替用户脑补现象细节。
48
48
 
49
+ **模糊反馈固定话术(2026-11-06 真实观测定稿,F3 闭环)**:用户只说
50
+ 泛化抱怨("体验不好/很差劲")时,一次性说清三件事,禁止含混反问
51
+ (实锤病句:"请问是否把什么作为反馈"——用户听不懂在问什么):
52
+ 1. 承接识别结果("收到,你对产品体验不满意");
53
+ 2. 确认收录意愿("要把这条反馈提交给产品团队吗?");
54
+ 3. 引导补充+兜底承诺("方便的话说下具体现象,不说我也会按你的
55
+ 原话提交")。
56
+ 整段一轮说完,不拆两轮、不复读式追问。
57
+
58
+ **追加反馈定性话术(2026-11-06 定稿,S49-S51)**:用户在确认
59
+ 环节追加表达(如「我看怎么说,你才明白」这类对沟通过程的
60
+ 挫败)时,**先给一句定性再问**,不把「这句话算不算反馈」的
61
+ 判断丢给用户;定性必须标注为 **agent 的理解**并留纠正口子,
62
+ 不许当事实断言:
63
+ 1. 定性(一句话说清这是什么+留口:「这句听起来更像是对刚才
64
+ 沟通没被理解的挫败——我理解得对吗?」;「听起来更像」
65
+ 而非「就是」,用户可纠正,agent 不替用户下结论);
66
+ 2. 确认范围,仅两个真实可执行选项:「连同最初那句一起提交」
67
+ /「只提交最初那句」——用户一句话拍板(都提/只提原句),
68
+ 不纠缠、不加第三选项抬高决策成本。括号兜底不进并列选项:
69
+ 「想只提交第二句也可以直接说」——极端选择有出口但不抬
70
+ 高常规决策成本;
71
+ 3. 用户纠正定性后的行为(S50 纠正闭环):不辩论,按用户纠正
72
+ 后的理解走,但提交内容仍是用户原话逐字——禁止拿纠正后的
73
+ 「新定性」改写 content(一次抱怨一条+原话红线不因纠正豁免);
74
+ 话术模板尾句:「如果我理解得不对,直接纠正,我按你说的
75
+ 原话提交,不改写」。
76
+ **禁空头承诺(S51)**:不许向用户提供引擎/插件不存在的机制
77
+ ——如「这句作为过程反馈单独记录、不混入产品声量」:客户端
78
+ 无过程反馈通道,引擎无此分类档(content 入库后由引擎重判),
79
+ 承诺即空头支票,用户选了实际做不到。「过程反馈与产品声量
80
+ 分离」若确需,属引擎侧新承载,先有承载再进话术。
81
+ 依据:对 agent 沟通体验的挫败同样指向宿主产品体验,属真实
82
+ 信号;定性由 agent 完成(降低用户决策成本),提交范围决策权
83
+ 在用户。
84
+
49
85
  **职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
50
86
  产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
51
87
  配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
@@ -77,6 +113,11 @@ version: 1
77
113
  - tags:明显的主题词(性能/功能/易用性),最多 3 个
78
114
  3. 调用 vod_submit_voices(必须用户已确认,confirmed=true)——
79
115
  **一次一批**,攒多条一起交也行,但每批都要用户点头
116
+ **一次抱怨=一条声音(2026-11-06 实锤红线)**:用户一次表述只提交一条,
117
+ content=原话逐字——禁止拆成多条、禁止生成多个改写变体(实锤:一次
118
+ "网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
119
+ 两个 issue;引擎幂等按内容逐字比对,改写即绕过)。多条仅当用户明确
120
+ 分条给了多个不同反馈
80
121
  4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
81
122
  **voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
82
123
  用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
@@ -105,42 +146,14 @@ version: 1
105
146
  5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
106
147
  6. 单批上限 50 条,超限分批
107
148
 
108
- ## 对齐 VOD-Project 采集标准(2026-11-04 二轮修订,待一次真实用户观测后定稿)
109
-
110
- 学习源=VOD-Project skills/bbs-suggestion + vod-sync/SKILL.md(深读):
111
-
112
- ### content 模板(替代自由拼装,四节加粗标签)
113
- ```
114
- 用户原话(不加标签,保留措辞)
115
-
116
- **使用场景:**
117
- (agent 推断,不允许空——空=拒提交,逼推断)
118
-
119
- **当前影响:**(可选)
120
-
121
- **期望能力:**
122
-
123
- **声音来源:**
124
- (agent 会话平台:cli/飞书/企业微信…——运行时从宿主会话上下文
125
- 获取,禁止硬编码默认值;对齐 detect_channel 纪律)
126
- ```
127
- - 有对话上下文时:最近 5 轮用户消息格式化为 `> 用户:原话` 引用块
128
- 置顶(过滤触发词、与 content 重复的最后一条去掉)
129
-
130
- ### 分类(采集层三分类,不越层)
131
- - 给用户的选项=功能建议/用户体验/产品缺陷(云声表单标准);
132
- 六类是引擎 n01 分析层内部枚举,agent 侧不使用、不自造第四个枚举
133
- - 落 tags=["problem_type:<三分类值>"],引擎以【类型名】标题前缀正式
134
- 入库,n01 照常重判——两层并存,agent 不许宣称"分类即定案"
149
+ ## 对齐 VOD-Project 采集标准(V16 起口径,2026-11-05 修订)
135
150
 
136
- ### 路由纪律
137
- - 用户说"反馈/报告问题/提 issue"→引擎 ISYNC 审核队列路径(本技能
138
- 提交即入队,运营复审后建 issue),agent 不直接建 GitCode issue
139
- - 用户明确"提建议"且要求直上渠道时才提及云声链(bbs-suggestion 为
140
- VOD-Project 内部资产,外部 agent 不分发)
151
+ 历史版本曾有"四节 content 模板/声音来源字段"——已废弃(囤积端点原话提交、
152
+ 渠道由引擎赋值客户端零字段不自报)。现行口径:
141
153
 
142
- ### 自检清单(提交前逐条过,不过不提交)
143
- - [ ] content 含四节模板且使用场景/期望能力非空?
144
- - [ ] 声音来源=真实会话平台(非硬编码)?
145
- - [ ] 分类(若有)是三分类枚举值?
146
- - [ ] 未把 agent 自己的评价混进用户原话?
154
+ - content=用户原话即可提交,**无模板、无必填推断节**(囤积端点无模板校验;
155
+ 旧模板的"空=拒提交"作废)
156
+ - 分类可选:用户表述明显时填三分类 tags,判断不了不填(n01 引擎重判兜底)
157
+ - 渠道/来源一律不提交、不向用户提及(引擎按链路固定赋值)
158
+ - 提单/工单类诉求:不需要"复现步骤/严重程度/优先级"等开发者工单字段——
159
+ 用户原话即完整提交物,缺什么由运营侧补充
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.2.1"
8
+ __version__ = "0.2.3"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
package/vod_mcp/server.py CHANGED
@@ -35,6 +35,13 @@ def handle(message: dict) -> dict | None:
35
35
  return _result(req_id, {
36
36
  "protocolVersion": _PROTOCOL_VERSION,
37
37
  "capabilities": {"tools": {}},
38
+ "instructions": (
39
+ "vod-devkit 采集资产与纪律:技能 vod-feedback-collect 处理用户对"
40
+ "本产品的不满/建议/期望(触发词:慢/报错/体验差/希望支持/提单等)。"
41
+ "提交前必须征得用户明确同意(用户抱怨本身不构成同意);提交回执"
42
+ "echo.contents 必须逐条原样转述给用户(「已收录原话:<content>」),"
43
+ "禁止改写、概括、增删字词。product 归因由安装绑定完成,禁止询问用户。"
44
+ ),
38
45
  "serverInfo": {
39
46
  "name": "vod-devkit",
40
47
  "version": tools.load_contract()["version"],
package/vod_mcp/tools.py CHANGED
@@ -151,27 +151,35 @@ _PRODUCT_MAP = {
151
151
  }
152
152
 
153
153
 
154
- def _resolve_product(params: dict) -> str | None:
155
- """归因(「宿主即产品」口径,2026-11-03 拍板·不设白名单):
156
- ①调用方显式传参 ②安装绑定(runtime.json product——安装器默认写入宿主名,
157
- hermes/opencode/codex 装在哪就归哪)③都没有 → 返回 None(body 不带
158
- product,引擎落 UNKNOWN 档人工归因解析,V19)——不再 -32013 本地拦截。
154
+ def _resolve_product(params: dict) -> tuple[str | None, str | None]:
155
+ """归因(D-attrib-A:2026-11-06 负责人拍板,方案 A 收紧):
156
+ 归因只由 install 绑定(runtime.json product)决定——运行期显式传参
157
+ 仅当与绑定一致(忽略大小写)才采信;不一致=宿主模型自报,一律忽略
158
+ 回退绑定值(实锤:hermes 会话模型传 product="hermes" 覆盖 CodeArts
159
+ 绑定,[HERMES] 未注册错归)。无绑定 → None(引擎 UNKNOWN 档兜底)。
160
+ 返回 (product, ignored_runtime_product)。
159
161
  T7i(方案 A,2026-11-05 拍板):产品归因主键化——
160
162
  ①纯数字串=平台主键 id,原样透传(引擎 selectById 精确命中)
161
163
  ②名字→meta productCatalog 按名解析出平台 id 后提交(对账主键化,
162
164
  归一化/改名漂移不进提交链路);_PRODUCT_MAP 先归一短码再查目录
163
165
  ③目录无此名/目录不可用→规范名原样上送(引擎 name 兼容通道,
164
166
  命中同样补落 product_id)——不静默丢提交。"""
165
- raw = str(params.get("product") or _RT.get("product") or "").strip()
166
- if not raw:
167
- return None
168
- if raw.isdigit():
169
- return raw
170
- name = _PRODUCT_MAP.get(raw.lower(), raw)
167
+ binding = str(_RT.get("product") or "").strip()
168
+ raw = str(params.get("product") or "").strip()
169
+ ignored = None
170
+ if raw and (not binding or raw.lower() != binding.lower()):
171
+ ignored = raw # 运行期自报≠绑定(或无绑定)→ 忽略留痕,不采信
172
+ raw = ""
173
+ product = raw or binding or None
174
+ if not product:
175
+ return None, ignored
176
+ if product.isdigit():
177
+ return product, ignored
178
+ name = _PRODUCT_MAP.get(product.lower(), product)
171
179
  for item in (_load_meta().get("catalog") or []):
172
180
  if str(item.get("name") or "").lower() == name.lower():
173
- return str(item.get("id"))
174
- return name
181
+ return str(item.get("id")), ignored
182
+ return name, ignored
175
183
 
176
184
 
177
185
  _SUBMIT_HOARDING = "/rest/developer/manager/hdvodmngservice/v1/external/voices"
@@ -237,7 +245,7 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
237
245
  """
238
246
  import uuid
239
247
  host = (client_info or {}).get("name") or "unknown-host"
240
- product = _resolve_product(params)
248
+ product, ignored_runtime = _resolve_product(params)
241
249
  accepted, voice_ids, task_ids, rejected = 0, [], [], []
242
250
  global JAVA_KEY
243
251
  voices_in = params.get("voices", [])
@@ -254,6 +262,19 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
254
262
  if not items:
255
263
  return {"accepted": 0, "voiceIds": [], "taskIds": [], "rejected": rejected}
256
264
 
265
+ def _echo(vids):
266
+ """方案 A(2026-11-06 拍板):提交回执强制携带原话回显。
267
+ 检测型防线——宿主模型改写用户原话(实锤:"体验不好"→"不友好")
268
+ 在回执处当场可见;agent 必须原样转述,改写露馅。"""
269
+ ok = [(vid, items[min(i, len(items) - 1)][2])
270
+ for i, vid in enumerate(vids) if vid]
271
+ return {
272
+ "requiresUserEcho": bool(ok),
273
+ "instruction": ("请向用户原样转述已收录内容:每条以「已收录原话:」开头,"
274
+ "后接 content 全文。禁止改写、概括、增删字词。"),
275
+ "contents": [{"voiceId": vid, "content": c} for vid, c in ok],
276
+ }
277
+
257
278
  def _ledger(vids, tids):
258
279
  import time as _time
259
280
  entries = [{"voiceId": vid, "taskId": tid,
@@ -324,15 +345,32 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
324
345
  if not fallback:
325
346
  server_ids = (out.get("voiceIds") or out.get("data", {}).get("voiceIds")
326
347
  or [])
327
- accepted = len(server_ids) or len(hoard_voices)
328
- voice_ids.extend(server_ids if server_ids else [""] * len(hoard_voices))
348
+ # 引擎侧 rejected(产品校验拒绝等)透出,不吞(对齐 widget rejected 口径)
349
+ engine_rejected = ((out or {}).get("rejected")
350
+ or ((out or {}).get("data") or {}).get("rejected")
351
+ or [])
352
+ if server_ids:
353
+ accepted = len(server_ids)
354
+ voice_ids.extend(server_ids)
355
+ else:
356
+ # 回执缺失/整批被拒 → 不得兜底计成功(实锤缺陷:空 voiceId 记成功
357
+ # 且宿主模型据此谎报"已提交")。accepted 以真实回执为准。
358
+ accepted = 0
359
+ voice_ids.extend([""] * len(hoard_voices))
360
+ if not engine_rejected:
361
+ engine_rejected = [{"reason": "引擎回执未含 voiceIds(提交结果未知),请勿视为已收录"}]
329
362
  task_ids.extend([None] * len(hoard_voices)) # 囤积语义:无即时任务
330
363
  result = {"accepted": accepted, "voiceIds": voice_ids,
331
- "taskIds": task_ids, "rejected": rejected,
364
+ "taskIds": task_ids, "rejected": rejected + engine_rejected,
332
365
  "analysis": "deferred", # 囤积语义明示(V6 运营批量消费)
333
- "path": "hoarding"}
366
+ "path": "hoarding",
367
+ "echo": _echo(voice_ids)}
334
368
  if out.get("productRegistered") is not None:
335
369
  result["productRegistered"] = out.get("productRegistered")
370
+ # D-attrib-A 可观测:模型试图改归因留痕,不静默吞
371
+ result["productSource"] = "install_binding"
372
+ if ignored_runtime:
373
+ result["ignoredRuntimeProduct"] = ignored_runtime
336
374
  _ledger(voice_ids, task_ids)
337
375
  return result
338
376
  # ---- 过渡回落:老链单条提交(仅囤积端点 404 触发) ----
@@ -371,7 +409,8 @@ def submit_voices(params: dict, client_info: dict | None = None) -> dict:
371
409
  rejected.append({"index": i, "reason": msg[:120]})
372
410
  result = {"accepted": accepted, "voiceIds": voice_ids,
373
411
  "taskIds": task_ids, "rejected": rejected,
374
- "path": "legacy-fallback"}
412
+ "path": "legacy-fallback",
413
+ "echo": _echo(voice_ids)}
375
414
  _ledger(voice_ids, task_ids)
376
415
  return result
377
416