vod-devkit 0.5.14 → 0.5.16

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
@@ -449,3 +449,13 @@
449
449
  - 5fafa27 feat(quota): 产品名录缓存 + 巡检跳过校验(S149)
450
450
  - dea16a6 docs: D3/D6 决策入 ADR + 装机失败分层排查 + 发版纪律教训
451
451
 
452
+
453
+ ## v0.5.15(2026-11-16)
454
+
455
+ - 6ce9752 fix(matrix): 巡检不再假绿 + S149 边界(a/b/c/d)(D-matrix-probe-1 / S150)
456
+
457
+
458
+ ## v0.5.16(2026-11-16)
459
+
460
+ - 34d05ee fix(doctor): 自愈不再切断/降级 dsh 托管块(D-doctor-repair-1 / S151)
461
+
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "title": "vod-devkit MCP 工具契约(唯一事实源)",
4
- "version": "0.5.14",
4
+ "version": "0.5.16",
5
5
  "tools": {
6
6
  "vod_submit_voices": {
7
7
  "description": "提交用户反馈进 VOD。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止传 confirmed=true**。模糊抱怨(如\"体验不好\")时一轮说完三件事:承接识别结果(\"收到,你对产品体验不满意\")+确认提交意愿(\"要把这条反馈提交给产品团队吗?\")+引导补充(\"方便的话说下具体现象,不说我也会按你的原话提交\");禁止含混反问(实锤病句:\"请问是否把什么作为反馈\")。同意后 content 放用户原话(哪怕只有一句\"体验很差\"也原样提交)。确认环节允许固定追问至多一次,问句必须逐字使用:「方便的话,补充一下遇到这个问题时的操作步骤或期望的表现吗?不方便回复\"没有\",我直接提交。」用户回答只摘录原话对应部分进 reproSteps/expectedBehavior(不改写不总结,无法拆分时落最相关字段,任何内容禁回填 content);答\"没有/跳过/不方便\"=两字段不上送直接提交。引导补充(说下具体现象)已获实质内容并并入 content 时不再追问、直接提交(其中自然出现的操作/期望留在 content 原话,不回溯摘入新字段);仅引导补充未获回应或仅泛化抱怨且用户确认提交时才带出固定问句。product 归因由插件从用户原话解析(安装绑定仅作先验),无需用户提供、禁止询问\"提交到哪个产品/页面\";模型/用户自报的目标产品一律不采信(提到的产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,除上述固定一次追问外,禁止再索要严重程度/环境/附件等开发者字段、禁止第二轮追问。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。拿到回执后必须原样转述 echo.contents(每条「已收录原话:<content>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.5.14",
3
+ "version": "0.5.16",
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": "dsh-vod-devkit",
3
- "version": "0.5.14",
3
+ "version": "0.5.16",
4
4
  "description": "VOD user-voice collection tools for DeepSeek Harness (dsh). Thin shell over the VOD external HTTP API — mirrors vod-devkit (MCP) collect semantics.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.5.14",
3
+ "version": "0.5.16",
4
4
  "description": "VOD user-feedback collection: structured voice capture and submission to the VOD hoarding endpoint.",
5
5
  "keywords": [
6
6
  "feedback",
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.5.14",
3
- "commitSha": "170bbd652b084a33431047fb346c0b5822a914eb",
4
- "builtAt": "2026-11-16T12:07:23",
2
+ "version": "0.5.16",
3
+ "commitSha": "621f4fe4317fe670d9a7472c31bd2b42b8146045",
4
+ "builtAt": "2026-11-16T13:21:23",
5
5
  "sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
6
6
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "title": "vod-devkit MCP 工具契约(唯一事实源)",
4
- "version": "0.5.14",
4
+ "version": "0.5.16",
5
5
  "tools": {
6
6
  "vod_submit_voices": {
7
7
  "description": "提交用户反馈进 VOD。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止传 confirmed=true**。模糊抱怨(如\"体验不好\")时一轮说完三件事:承接识别结果(\"收到,你对产品体验不满意\")+确认提交意愿(\"要把这条反馈提交给产品团队吗?\")+引导补充(\"方便的话说下具体现象,不说我也会按你的原话提交\");禁止含混反问(实锤病句:\"请问是否把什么作为反馈\")。同意后 content 放用户原话(哪怕只有一句\"体验很差\"也原样提交)。确认环节允许固定追问至多一次,问句必须逐字使用:「方便的话,补充一下遇到这个问题时的操作步骤或期望的表现吗?不方便回复\"没有\",我直接提交。」用户回答只摘录原话对应部分进 reproSteps/expectedBehavior(不改写不总结,无法拆分时落最相关字段,任何内容禁回填 content);答\"没有/跳过/不方便\"=两字段不上送直接提交。引导补充(说下具体现象)已获实质内容并并入 content 时不再追问、直接提交(其中自然出现的操作/期望留在 content 原话,不回溯摘入新字段);仅引导补充未获回应或仅泛化抱怨且用户确认提交时才带出固定问句。product 归因由插件从用户原话解析(安装绑定仅作先验),无需用户提供、禁止询问\"提交到哪个产品/页面\";模型/用户自报的目标产品一律不采信(提到的产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,除上述固定一次追问外,禁止再索要严重程度/环境/附件等开发者字段、禁止第二轮追问。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。拿到回执后必须原样转述 echo.contents(每条「已收录原话:<content>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.5.14"
8
+ __version__ = "0.5.16"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.5.14"
8
+ __version__ = "0.5.16"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
@@ -6,6 +6,7 @@ import shutil
6
6
  import subprocess
7
7
  import sys
8
8
  from pathlib import Path
9
+ from types import SimpleNamespace
9
10
 
10
11
  from vod_mcp import hosts as host_specs
11
12
  from vod_mcp import paths as paths_mod
@@ -39,19 +40,24 @@ def cmd_status(args=None):
39
40
 
40
41
 
41
42
  def _repair_dsh_patch_block(mf: dict) -> str | None:
42
- """doctor 自愈(S58/A):profile cordis.patch.yml 的 vod-devkit 块缺失或
43
- 打平(未缩进在 - insert: 之下)时,按 manifest 的 product/apiBase 重建
44
- 正确嵌套块。返回修复的文件路径;块完好返回 None。
43
+ """doctor 自愈(S58/A + B 模式 D-dsh-mcp-b-1):profile 的 vod-devkit 块缺失/打平/
44
+ 形态与当前环境不符时,按 manifest 重建。
45
45
 
46
- 嵌套铁律(真机实锤):id/name/config 必须缩进在 `- insert:` 之下——
47
- dsh 的配置序列化只保留它能识别的块,手工游离块会被下次写盘冲掉。
46
+ 关键(0.5.15 真机实锤):重建必须**复用安装器的 `_patch_block`**——有 mcp-client 就写
47
+ `vod-devkit-mcp` + 壳两条 insert(壳 `registerTools:false`)。旧实现手写"只有壳块"的
48
+ 形态,doctor 跑一次就把 MCP 工具面打回 6 工具降级(headless 的 vod-devkit-mcp 被抹掉,
49
+ audit 从"MCP 模式 PASS"变成"降级 PASS")——自愈不能改变形态。
50
+
51
+ 嵌套铁律(真机实锤):id/name/config 必须缩进在 `- insert:` 之下。
48
52
  """
49
53
  prof = mf["dshProfile"]
50
54
  patch = Path(host_specs.load("dsh", prof)["configPath"])
51
55
  if not patch.exists():
52
56
  return None
53
57
  from vod_mcp import config_forms as cf
54
- lines = patch.read_text(encoding="utf-8").splitlines()
58
+ from vod_mcp.host_adapters import dsh as _dsh
59
+ text = patch.read_text(encoding="utf-8")
60
+ lines = text.splitlines()
55
61
  try:
56
62
  verdict, reason = cf.classify_dsh_patch(lines)
57
63
  except cf.Refused as e:
@@ -61,34 +67,26 @@ def _repair_dsh_patch_block(mf: dict) -> str | None:
61
67
  print(f"[doctor] skip(cordis.patch.yml 形态不受支持,未自愈):{reason}",
62
68
  file=sys.stderr)
63
69
  return None
64
- vod_idx = next((i for i, ln in enumerate(lines)
65
- if ln.strip().startswith("- id: vod-devkit")), None)
66
- if vod_idx is not None and lines[vod_idx].startswith((" ", "\t")):
67
- # 已嵌套且在 insert 组内(简化判定:缩进+前文存在 - insert: 行)→ 完好
68
- has_insert = any(ln.strip() == "- insert:" for ln in lines[:vod_idx])
69
- has_name = any("name: dsh-vod-devkit" in ln
70
- for ln in lines[vod_idx:vod_idx + 3])
71
- if has_insert and has_name:
72
- return None
73
- # 需要重建:先摘除旧块(块边界=下一个 `- ` 群组项,任何缩进),再追加正确嵌套组
74
- if vod_idx is not None:
75
- end = next((j for j in range(vod_idx + 1, len(lines))
76
- if lines[j].strip().startswith("- ")), len(lines))
77
- del lines[vod_idx:end]
78
- if lines and lines[-1].strip():
79
- lines.append("")
80
- product = mf.get("product") or ""
81
- api_base = mf.get("apiBase") or ""
82
- lines += [
83
- "- insert:",
84
- " - id: vod-devkit",
85
- " name: dsh-vod-devkit",
86
- " config:",
87
- f" product: {product}",
88
- f" apiBase: {api_base}",
89
- f" uiBase: {api_base}", # D-uiBase-direct:浏览器半直连,与 install 同口径
90
- ]
91
- patch.write_text("\n".join(lines).rstrip("\n") + "\n", encoding="utf-8")
70
+
71
+ dsh_cli = shutil.which("dsh")
72
+ mcp_ver = _dsh._mcp_client_version(_dsh._dsh_root(dsh_cli)) if dsh_cli else None
73
+ payload = Path(str(mf.get("payloadDir") or ""))
74
+ args = SimpleNamespace(product=mf.get("product") or "",
75
+ java_api_base=mf.get("apiBase") or "")
76
+ expected = _dsh._patch_block(args, mcp_ver, payload, str(mf.get("packs") or "core"))
77
+ if expected in text:
78
+ # 已是安装器该写的样子(有 mcp 块 + 壳 registerTools:false,或降级形态)→ 不动
79
+ return None
80
+ try:
81
+ # upsert 按托管标记划界(标记优先),不靠 "- " 猜边界:mcp 块的 args 列表项
82
+ # 形如 "- /root/.../server.py",旧实现会把块从中间切断,留下残块(0.5.15 实锤)。
83
+ _dsh.upsert_patch(patch, expected)
84
+ except Exception as e: # noqa: BLE001 自愈失败只报告,不动字节
85
+ print(f"[doctor] dsh patch 自愈失败({e.__class__.__name__}: {e})——"
86
+ "多半是文件里有多份 vod-devkit 块;请人工确认后删掉多余那份"
87
+ f"(本插件的块在 `# vod-devkit DSH integration start/end` 之间):{patch}",
88
+ file=sys.stderr)
89
+ return None
92
90
  return str(patch)
93
91
 
94
92
 
@@ -139,10 +139,24 @@ def _catalog_cache_path():
139
139
  return _paths.machine_state_home() / "product-catalog.json"
140
140
 
141
141
 
142
+ def _ttl_seconds() -> float:
143
+ """名录缓存 TTL(秒)。配错(如 `7d`)按默认 7 天并告警——不许因为一个 env 值
144
+ 把安装整个打断(真机实锤:VOD_PRODUCT_CATALOG_TTL=7d 直接抛 ValueError traceback)。"""
145
+ raw = os.environ.get("VOD_PRODUCT_CATALOG_TTL")
146
+ if raw is None or not str(raw).strip():
147
+ return 7 * 86400
148
+ try:
149
+ return float(str(raw).strip())
150
+ except ValueError:
151
+ print(f"[vod-devkit] VOD_PRODUCT_CATALOG_TTL={raw!r} 不是秒数,按默认 7 天处理"
152
+ "(示例:604800 = 7 天,0 = 禁用缓存)", file=sys.stderr)
153
+ return 7 * 86400
154
+
155
+
142
156
  def _read_catalog_cache(base: str):
143
157
  """命中返回 (catalog, age_secs),否则 None。TTL 可用 VOD_PRODUCT_CATALOG_TTL 覆盖(秒)。"""
144
158
  import time
145
- ttl = float(os.environ.get("VOD_PRODUCT_CATALOG_TTL") or 7 * 86400)
159
+ ttl = _ttl_seconds()
146
160
  if ttl <= 0:
147
161
  return None
148
162
  p = _catalog_cache_path()
@@ -162,15 +176,28 @@ def _read_catalog_cache(base: str):
162
176
 
163
177
 
164
178
  def _write_catalog_cache(base: str, catalog: list) -> None:
179
+ """原子写(tmp → os.replace,0600):与 state 其它写入口同款纪律,
180
+ 并发读到半截会当 miss(可接受,但不要留下半文件)。"""
165
181
  import time
166
182
  p = _catalog_cache_path()
183
+ tmp = p.with_name(p.name + ".tmp")
167
184
  try:
168
185
  p.parent.mkdir(parents=True, exist_ok=True)
169
- p.write_text(json.dumps({"base": str(base), "at": time.time(), "catalog": catalog},
170
- ensure_ascii=False), encoding="utf-8")
171
- os.chmod(p, 0o600)
186
+ tmp.write_text(json.dumps({"base": str(base), "at": time.time(), "catalog": catalog},
187
+ ensure_ascii=False), encoding="utf-8")
188
+ try:
189
+ os.chmod(tmp, 0o600)
190
+ except OSError as e: # noqa: BLE001 权限设不上要能看见(缓存里有产品名录,不算密钥)
191
+ print(f"[vod-devkit] 产品名录缓存权限设置失败({e}),继续使用", file=sys.stderr)
192
+ os.replace(tmp, p)
172
193
  except OSError:
173
194
  pass # 缓存写不进不是安装的失败条件
195
+ finally:
196
+ if tmp.exists():
197
+ try:
198
+ tmp.unlink()
199
+ except OSError:
200
+ pass
174
201
 
175
202
 
176
203
  def _validate_product_or_exit(product: str, base: str, refresh: bool = False) -> bool:
@@ -248,9 +275,11 @@ def _validate_product_or_exit(product: str, base: str, refresh: bool = False) ->
248
275
  cat = data if isinstance(data, list) else None
249
276
  return cat
250
277
 
251
- if os.environ.get("VOD_SKIP_PRODUCT_CHECK") == "1":
252
- print("[vod-devkit] 跳过产品校验(VOD_SKIP_PRODUCT_CHECK=1:巡检/离线场景;"
253
- "归因名单在装机时已验过)", file=sys.stderr)
278
+ # 只认巡检内部注入:必须**同时**有 VOD_MATRIX=1。这行 env 若被从审计日志里抄去单用,
279
+ # 就等于绕过 D-product-id-2 的"宁可不装不可装错",装出一台产品归属未验证的机器。
280
+ if os.environ.get("VOD_SKIP_PRODUCT_CHECK") == "1" and os.environ.get("VOD_MATRIX") == "1":
281
+ print("[vod-devkit] 跳过产品校验(巡检内部注入:VOD_MATRIX=1 + "
282
+ "VOD_SKIP_PRODUCT_CHECK=1;归因名单在装机时已验过)", file=sys.stderr)
254
283
  return True
255
284
 
256
285
  catalog, unauthorized, rate_limited, last_exc = None, False, False, None
@@ -320,7 +349,9 @@ def _validate_product_or_exit(product: str, base: str, refresh: bool = False) ->
320
349
  print(f"[vod-devkit] --product '{product}' 不在产品名录(t_vod_product),拒绝安装。\n"
321
350
  " 归因前提无效=内置采集技能/分类/透传全部空转且用户无感知(归因错误比报错更糟)。\n"
322
351
  f" 权威名单:GET {api_prefix}/external/products(共 {len(catalog)} 项),"
323
- f"示例:{sample} …",
352
+ f"示例:{sample} …\n"
353
+ " 提示:若该产品刚上线(本地名录缓存可能还是 7 天前的),"
354
+ "加 --refresh-product-catalog 重拉后再试。",
324
355
  file=sys.stderr)
325
356
  sys.exit(2)
326
357
  return True