vod-devkit 0.5.9 → 0.5.11

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.
Files changed (152) hide show
  1. package/CHANGELOG.md +58 -0
  2. package/QUICKSTART.md +6 -2
  3. package/README.en.md +23 -2
  4. package/README.md +204 -16
  5. package/{contract → assets/contract}/tools.schema.json +127 -1
  6. package/{skills → assets/skills}/vod-core/SKILL.md +32 -1
  7. package/bin/vod-devkit +21 -1
  8. package/integrations/hermes/hooks/vod_guard.py +127 -0
  9. package/integrations/hermes/hooks/vod_router.py +89 -0
  10. package/integrations/hermes/host.json +4 -1
  11. package/npm/cli.js +6 -1
  12. package/package.json +37 -34
  13. package/packages/dsh/README.md +60 -0
  14. package/packages/dsh/package.json +52 -0
  15. package/plugins/vod-devkit/.codex-plugin/plugin.json +1 -1
  16. package/plugins/vod-devkit/.mcp.json +2 -0
  17. package/plugins/vod-devkit/build-info.json +3 -3
  18. package/plugins/vod-devkit/contract/tools.schema.json +127 -1
  19. package/plugins/vod-devkit/hooks/vod_guard.py +127 -0
  20. package/plugins/vod-devkit/hooks/vod_router.py +89 -0
  21. package/plugins/vod-devkit/skills/vod-core/SKILL.md +32 -1
  22. package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
  23. package/plugins/vod-devkit/vod_mcp/attribution.py +21 -2
  24. package/plugins/vod-devkit/vod_mcp/config_forms.py +22 -6
  25. package/plugins/vod-devkit/vod_mcp/diagnose.py +4 -2
  26. package/plugins/vod-devkit/vod_mcp/host_adapters/base.py +4 -1
  27. package/plugins/vod-devkit/vod_mcp/host_adapters/codex.py +154 -34
  28. package/plugins/vod-devkit/vod_mcp/host_adapters/dsh.py +133 -22
  29. package/plugins/vod-devkit/vod_mcp/host_adapters/hermes.py +216 -59
  30. package/plugins/vod-devkit/vod_mcp/host_adapters/opencode.py +10 -4
  31. package/plugins/vod-devkit/vod_mcp/hosts.py +4 -0
  32. package/plugins/vod-devkit/vod_mcp/net.py +78 -18
  33. package/plugins/vod-devkit/vod_mcp/packs/__init__.py +97 -22
  34. package/plugins/vod-devkit/vod_mcp/packs/collect.py +50 -42
  35. package/plugins/vod-devkit/vod_mcp/packs/core.py +138 -2
  36. package/plugins/vod-devkit/vod_mcp/paths.py +200 -30
  37. package/plugins/vod-devkit/vod_mcp/payload.py +10 -5
  38. package/plugins/vod-devkit/vod_mcp/provenance.py +1 -1
  39. package/plugins/vod-devkit/vod_mcp/remote_app.py +4 -4
  40. package/plugins/vod-devkit/vod_mcp/runtime_state.py +151 -28
  41. package/plugins/vod-devkit/vod_mcp/server.py +52 -7
  42. package/plugins/vod-devkit/vod_mcp/skills_registry.py +29 -8
  43. package/plugins/vod-devkit/vod_mcp/tools.py +21 -3
  44. package/plugins/vod-devkit/vod_mcp/transport_remote.py +22 -3
  45. package/{vod_mcp → src/vod_mcp}/__init__.py +1 -1
  46. package/{vod_mcp → src/vod_mcp}/attribution.py +21 -2
  47. package/{vod_mcp → src/vod_mcp}/config_forms.py +22 -6
  48. package/{vod_mcp → src/vod_mcp}/diagnose.py +4 -2
  49. package/{vod_mcp → src/vod_mcp}/host_adapters/base.py +4 -1
  50. package/{vod_mcp → src/vod_mcp}/host_adapters/codex.py +154 -34
  51. package/{vod_mcp → src/vod_mcp}/host_adapters/dsh.py +133 -22
  52. package/src/vod_mcp/host_adapters/hermes.py +361 -0
  53. package/{vod_mcp → src/vod_mcp}/host_adapters/opencode.py +10 -4
  54. package/{vod_mcp → src/vod_mcp}/hosts.py +4 -0
  55. package/{vod_mcp → src/vod_mcp}/net.py +78 -18
  56. package/src/vod_mcp/packs/__init__.py +142 -0
  57. package/{vod_mcp → src/vod_mcp}/packs/collect.py +50 -42
  58. package/src/vod_mcp/packs/core.py +216 -0
  59. package/src/vod_mcp/paths.py +208 -0
  60. package/{vod_mcp → src/vod_mcp}/payload.py +10 -5
  61. package/{vod_mcp → src/vod_mcp}/provenance.py +1 -1
  62. package/{vod_mcp → src/vod_mcp}/remote_app.py +4 -4
  63. package/{vod_mcp → src/vod_mcp}/runtime_state.py +151 -28
  64. package/{vod_mcp → src/vod_mcp}/server.py +52 -7
  65. package/{vod_mcp → src/vod_mcp}/skills_registry.py +29 -8
  66. package/{vod_mcp → src/vod_mcp}/tools.py +21 -3
  67. package/{vod_mcp → src/vod_mcp}/transport_remote.py +22 -3
  68. package/src/vodkit_cli/auth_cmd.py +81 -0
  69. package/{vodkit_cli → src/vodkit_cli}/cli.py +38 -8
  70. package/{vodkit_cli → src/vodkit_cli}/common.py +14 -3
  71. package/{vodkit_cli → src/vodkit_cli}/doctor.py +147 -9
  72. package/{vodkit_cli → src/vodkit_cli}/install.py +148 -33
  73. package/src/vodkit_cli/packs_cmd.py +329 -0
  74. package/{vodkit_cli → src/vodkit_cli}/remote.py +3 -3
  75. package/src/vodkit_cli/uninstall.py +315 -0
  76. package/vod_mcp/host_adapters/__pycache__/__init__.cpython-314.pyc +0 -0
  77. package/vod_mcp/host_adapters/__pycache__/__init__.cpython-39.pyc +0 -0
  78. package/vod_mcp/host_adapters/__pycache__/atomcode.cpython-314.pyc +0 -0
  79. package/vod_mcp/host_adapters/__pycache__/atomcode.cpython-39.pyc +0 -0
  80. package/vod_mcp/host_adapters/__pycache__/base.cpython-314.pyc +0 -0
  81. package/vod_mcp/host_adapters/__pycache__/base.cpython-39.pyc +0 -0
  82. package/vod_mcp/host_adapters/__pycache__/codearts.cpython-314.pyc +0 -0
  83. package/vod_mcp/host_adapters/__pycache__/codearts.cpython-39.pyc +0 -0
  84. package/vod_mcp/host_adapters/__pycache__/codeartswork.cpython-314.pyc +0 -0
  85. package/vod_mcp/host_adapters/__pycache__/codeartswork.cpython-39.pyc +0 -0
  86. package/vod_mcp/host_adapters/__pycache__/codex.cpython-314.pyc +0 -0
  87. package/vod_mcp/host_adapters/__pycache__/codex.cpython-39.pyc +0 -0
  88. package/vod_mcp/host_adapters/__pycache__/codex_desktop.cpython-314.pyc +0 -0
  89. package/vod_mcp/host_adapters/__pycache__/codex_desktop.cpython-39.pyc +0 -0
  90. package/vod_mcp/host_adapters/__pycache__/dsh.cpython-314.pyc +0 -0
  91. package/vod_mcp/host_adapters/__pycache__/dsh.cpython-39.pyc +0 -0
  92. package/vod_mcp/host_adapters/__pycache__/generic.cpython-314.pyc +0 -0
  93. package/vod_mcp/host_adapters/__pycache__/generic.cpython-39.pyc +0 -0
  94. package/vod_mcp/host_adapters/__pycache__/hermes.cpython-314.pyc +0 -0
  95. package/vod_mcp/host_adapters/__pycache__/hermes.cpython-39.pyc +0 -0
  96. package/vod_mcp/host_adapters/__pycache__/opencode.cpython-314.pyc +0 -0
  97. package/vod_mcp/host_adapters/__pycache__/opencode.cpython-39.pyc +0 -0
  98. package/vod_mcp/host_adapters/__pycache__/workbuddy.cpython-314.pyc +0 -0
  99. package/vod_mcp/host_adapters/__pycache__/workbuddy.cpython-39.pyc +0 -0
  100. package/vod_mcp/host_adapters/hermes.py +0 -204
  101. package/vod_mcp/packs/__init__.py +0 -67
  102. package/vod_mcp/packs/__pycache__/__init__.cpython-314.pyc +0 -0
  103. package/vod_mcp/packs/__pycache__/__init__.cpython-39.pyc +0 -0
  104. package/vod_mcp/packs/__pycache__/collect.cpython-314.pyc +0 -0
  105. package/vod_mcp/packs/__pycache__/collect.cpython-39.pyc +0 -0
  106. package/vod_mcp/packs/__pycache__/core.cpython-314.pyc +0 -0
  107. package/vod_mcp/packs/__pycache__/core.cpython-39.pyc +0 -0
  108. package/vod_mcp/packs/__pycache__/knowledge.cpython-314.pyc +0 -0
  109. package/vod_mcp/packs/__pycache__/knowledge.cpython-39.pyc +0 -0
  110. package/vod_mcp/packs/core.py +0 -80
  111. package/vod_mcp/paths.py +0 -38
  112. package/vodkit_cli/__pycache__/__init__.cpython-314.pyc +0 -0
  113. package/vodkit_cli/__pycache__/__init__.cpython-39.pyc +0 -0
  114. package/vodkit_cli/__pycache__/cli.cpython-314.pyc +0 -0
  115. package/vodkit_cli/__pycache__/cli.cpython-39.pyc +0 -0
  116. package/vodkit_cli/__pycache__/common.cpython-314.pyc +0 -0
  117. package/vodkit_cli/__pycache__/common.cpython-39.pyc +0 -0
  118. package/vodkit_cli/__pycache__/doctor.cpython-314.pyc +0 -0
  119. package/vodkit_cli/__pycache__/doctor.cpython-39.pyc +0 -0
  120. package/vodkit_cli/__pycache__/install.cpython-314.pyc +0 -0
  121. package/vodkit_cli/__pycache__/install.cpython-39.pyc +0 -0
  122. package/vodkit_cli/__pycache__/remote.cpython-314.pyc +0 -0
  123. package/vodkit_cli/__pycache__/remote.cpython-39.pyc +0 -0
  124. package/vodkit_cli/__pycache__/uninstall.cpython-314.pyc +0 -0
  125. package/vodkit_cli/__pycache__/uninstall.cpython-39.pyc +0 -0
  126. package/vodkit_cli/__pycache__/update.cpython-314.pyc +0 -0
  127. package/vodkit_cli/__pycache__/update.cpython-39.pyc +0 -0
  128. package/vodkit_cli/uninstall.py +0 -161
  129. /package/{safety → assets/safety}/policy.json +0 -0
  130. /package/{skills → assets/skills}/vod-core/references/acceptance-criteria.md +0 -0
  131. /package/{skills → assets/skills}/vod-core/references/verification-method.md +0 -0
  132. /package/{skills → assets/skills}/vod-feedback-collect/SKILL.md +0 -0
  133. /package/{skills → assets/skills}/vod-feedback-collect/references/acceptance-criteria.md +0 -0
  134. /package/{skills → assets/skills}/vod-feedback-collect/references/verification-method.md +0 -0
  135. /package/{skills → assets/skills}/vod-problem-classification-rules/SKILL.md +0 -0
  136. /package/{skills → assets/skills}/vod-scoring-rules/SKILL.md +0 -0
  137. /package/{vod_mcp → src/vod_mcp}/detect_framework.py +0 -0
  138. /package/{vod_mcp → src/vod_mcp}/guardrails.py +0 -0
  139. /package/{vod_mcp → src/vod_mcp}/host_adapters/__init__.py +0 -0
  140. /package/{vod_mcp → src/vod_mcp}/host_adapters/atomcode.py +0 -0
  141. /package/{vod_mcp → src/vod_mcp}/host_adapters/codearts.py +0 -0
  142. /package/{vod_mcp → src/vod_mcp}/host_adapters/codeartswork.py +0 -0
  143. /package/{vod_mcp → src/vod_mcp}/host_adapters/codex_desktop.py +0 -0
  144. /package/{vod_mcp → src/vod_mcp}/host_adapters/generic.py +0 -0
  145. /package/{vod_mcp → src/vod_mcp}/host_adapters/workbuddy.py +0 -0
  146. /package/{vod_mcp → src/vod_mcp}/packs/knowledge.py +0 -0
  147. /package/{vod_mcp → src/vod_mcp}/pending.py +0 -0
  148. /package/{vod_mcp → src/vod_mcp}/policy.py +0 -0
  149. /package/{vod_mcp → src/vod_mcp}/runtime.example.json +0 -0
  150. /package/{vod_mcp → src/vod_mcp}/update_check.py +0 -0
  151. /package/{vodkit_cli → src/vodkit_cli}/__init__.py +0 -0
  152. /package/{vodkit_cli → src/vodkit_cli}/update.py +0 -0
@@ -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.9",
4
+ "version": "0.5.11",
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>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
@@ -201,6 +201,132 @@
201
201
  },
202
202
  "backend": "local(无上游;探测时轻量 ping)"
203
203
  },
204
+ "vod_auth_ensure": {
205
+ "description": "身份判定 + 领取(幂等,唯一有副作用的认证工具):有可用令牌就原样返回并只做一次探针;没有或已过期/设备不匹配时,由本服务代理向引擎令牌端点领取零字段匿名令牌、落机器级 state 后复探并返回。调用时机:开始采集前一次(不要每次工具调用都调)。本地 stdio 与远程 HTTP(同机独立部署)同一套语义:请求头 Bearer 优先(source=request,不代领);无 Bearer 时由服务端领/复用机器级匿名令牌(整机一份)。显式配置的 key(env 或 auth init 写入)一律不覆盖,被引擎拒绝时如实报错、不静默降级;引擎不可达时不领取、不判定(verified=null)。返回指纹,不下发明文。",
206
+ "input": {
207
+ "type": "object",
208
+ "properties": {}
209
+ },
210
+ "output": {
211
+ "type": "object",
212
+ "properties": {
213
+ "tier": {
214
+ "type": "string",
215
+ "description": "formal|anonymous|none"
216
+ },
217
+ "source": {
218
+ "type": "string",
219
+ "description": "env(平台注入 key)|request(请求头 Bearer)|runtime-key(auth init 写入)|runtime-anonymous(已缓存匿名令牌)|new-anonymous(本次领取)|none"
220
+ },
221
+ "verified": {
222
+ "type": [
223
+ "boolean",
224
+ "null"
225
+ ],
226
+ "description": "true=引擎确认有效;false=被拒;null=不可达(不判定)"
227
+ },
228
+ "reason": {
229
+ "type": "string"
230
+ },
231
+ "fingerprint": {
232
+ "type": [
233
+ "string",
234
+ "null"
235
+ ]
236
+ },
237
+ "changed": {
238
+ "type": "boolean",
239
+ "description": "是否发生了领取/落盘"
240
+ },
241
+ "base": {
242
+ "type": "string"
243
+ },
244
+ "guidance": {
245
+ "type": "array"
246
+ },
247
+ "note": {
248
+ "type": "string"
249
+ }
250
+ },
251
+ "required": [
252
+ "tier",
253
+ "source",
254
+ "verified",
255
+ "changed"
256
+ ]
257
+ },
258
+ "backend": "local(无令牌时调引擎 /external/token)"
259
+ },
260
+ "vod_packs_configure": {
261
+ "description": "会话内开关能力包(stdio 面):enable/disable 包 id 或 reset=true,立即改工具面并推 tools/list_changed。不写 env/宿主配置、重启即清;持久化用 CLI `vod-devkit packs enable|disable <id> --apply`。core 强制包含;未知 id 报错;采集熔断期间不能开启 collect(安全门禁)。",
262
+ "input": {
263
+ "type": "object",
264
+ "properties": {
265
+ "enable": {
266
+ "type": "array",
267
+ "items": {
268
+ "type": "string"
269
+ },
270
+ "description": "要开启的包 id(core/collect/knowledge)"
271
+ },
272
+ "disable": {
273
+ "type": "array",
274
+ "items": {
275
+ "type": "string"
276
+ },
277
+ "description": "要关闭的包 id"
278
+ },
279
+ "reset": {
280
+ "type": "boolean",
281
+ "description": "恢复按 VOD_PACKS 的启动配置(清会话内开关)"
282
+ }
283
+ }
284
+ },
285
+ "output": {
286
+ "type": "object",
287
+ "properties": {
288
+ "packs": {
289
+ "type": "array",
290
+ "items": {
291
+ "type": "string"
292
+ }
293
+ },
294
+ "added": {
295
+ "type": "array",
296
+ "items": {
297
+ "type": "string"
298
+ }
299
+ },
300
+ "removed": {
301
+ "type": "array",
302
+ "items": {
303
+ "type": "string"
304
+ }
305
+ },
306
+ "tools": {
307
+ "type": "array",
308
+ "items": {
309
+ "type": "string"
310
+ }
311
+ },
312
+ "changed": {
313
+ "type": "boolean"
314
+ },
315
+ "persisted": {
316
+ "type": "boolean"
317
+ },
318
+ "note": {
319
+ "type": "string"
320
+ }
321
+ },
322
+ "required": [
323
+ "packs",
324
+ "changed",
325
+ "persisted"
326
+ ]
327
+ },
328
+ "backend": "local(无上游)"
329
+ },
204
330
  "vod_list_submitted": {
205
331
  "description": "查询本机已提交的声音(只读)。本地账本(cap 200),最新在前;跨机/权威查询随引擎端点(VOD-VOI)。终端用户进度追问由 agent 凭此对账回答。",
206
332
  "input": {
@@ -0,0 +1,127 @@
1
+ #!/usr/bin/env python3
2
+ """vod_guard:Hermes `pre_tool_call` hook —— 只拦"把引擎 key 读进对话"的动作。
3
+
4
+ 为什么要这条机制:runtime.json 里是引擎 key(仓内那份是设备绑定的),而排障时
5
+ 最容易发生的就是 `cat ~/.vod-devkit/payloads/*/vod_mcp/runtime.json`、`grep -r
6
+ key`、`env | grep VOD` —— 一旦打印,key 就进了会话、日志和模型上下文。技能里
7
+ 写"排障只引指纹"靠模型自觉,这条 hook 把它变成机制。
8
+
9
+ 判定窄而明确(只做"读取该文件/导出该变量"这一件事):
10
+ 1) 命令里出现 `runtime.json` 且出现读取类动词 → block;
11
+ 2) 命令是 `env`/`printenv`/`set` 且同时点名 key 变量 → block(给只看变量名的替代写法)。
12
+ 其它一切(包括解析失败、字段缺失、异常)→ **放行**。
13
+
14
+ 失败姿态必须是 fail-open:`pre_tool_call` 是 Hermes 的**阻塞事件**,脚本一坏就是
15
+ "所有工具调用都被拦",伤害远大于漏拦一次。关闭开关:env `VOD_HOOK_READ_GUARD=0`
16
+ (或 `hermes hooks revoke <cmd>`)。
17
+
18
+ 线协议:stdin 收 JSON 载荷(顶层 tool_name / args),stdout 回
19
+ `{"decision": "block", "reason": "..."}`;不拦时零输出。
20
+ """
21
+ import json
22
+ import os
23
+ import re
24
+ import sys
25
+
26
+ # shell 类:命令字符串里判判读动词
27
+ SHELL_TOOLS = {"terminal", "shell", "bash", "run_command", "computer_use", "process"}
28
+ # 文件/代码类:模型读 runtime.json 的常规路径恰好是这几个(不是 shell)
29
+ FILE_TOOLS = {"read_file", "read_files"}
30
+ SEARCH_TOOLS = {"search_files", "search"}
31
+ CODE_TOOLS = {"execute_code"}
32
+
33
+ _READ_VERBS = re.compile(
34
+ r"(?:^|[\s|;&(`])(cat|head|tail|less|more|strings|xxd|base64|od|hexdump|"
35
+ r"grep|rg|awk|sed|jq|sqlite3|python3?|perl|ruby|open|read_text|read_bytes|"
36
+ r"json\.load|json\.loads)\b")
37
+ _READ_FILE = re.compile(r"runtime\.json")
38
+ _ENV_DUMP = re.compile(r"(?:^|[\s|;&(`])(env|printenv|set)\b")
39
+ _KEY_NAMES = re.compile(r"(VOD_JAVA_API_KEY|VOD_[A-Z_]*KEY|java_key|JAVA_API_KEY)")
40
+
41
+ _BLOCK_RUNTIME = (
42
+ "读取 runtime.json 会把引擎 key 打进对话/日志(这个文件里是明文 key)。"
43
+ "要看凭据只引指纹:`vod-devkit auth status`(输出 指纹 + 档位,不含明文)。"
44
+ "确需人工核对请把文件拷到受控位置、由人处理,不要让模型 cat。"
45
+ "(本拦截可用 VOD_HOOK_READ_GUARD=0 关闭;hermes hooks revoke 可摘除本条。)"
46
+ )
47
+ _BLOCK_ENV = (
48
+ "导出 VOD 相关环境变量会带出 key 明文。只想确认变量是否存在/叫什么名,用:"
49
+ "`env | cut -d= -f1 | grep '^VOD_'`(只有名字,没有值);"
50
+ "要看档位用 `vod-devkit auth status`(指纹)。"
51
+ "(可用 VOD_HOOK_READ_GUARD=0 关闭。)"
52
+ )
53
+
54
+
55
+ def _strings(node) -> list:
56
+ """把载荷里的所有字符串摊平(命令可能在 command/cmd/code/script 等键下)。"""
57
+ out = []
58
+ stack = [node]
59
+ while stack:
60
+ cur = stack.pop()
61
+ if isinstance(cur, str):
62
+ out.append(cur)
63
+ elif isinstance(cur, dict):
64
+ stack.extend(cur.values())
65
+ elif isinstance(cur, (list, tuple)):
66
+ stack.extend(cur)
67
+ return out
68
+
69
+
70
+ def verdict(payload: dict) -> str | None:
71
+ """返回 block 文案;放行返回 None。纯函数,用例直接测它。
72
+
73
+ 覆盖三条真实读取路径(评审实测:只拦 shell 等于没拦):
74
+ - shell 类:命令里出现 runtime.json + 读动词;
75
+ - read_file / search_files:参数里点名 runtime.json(或搜 key 名);
76
+ - execute_code:代码里点名 runtime.json(open/read_text/json.load 都算)。
77
+ 其余工具与命令一律放行(fail-open)。
78
+ """
79
+ if not isinstance(payload, dict):
80
+ return None
81
+ tool = str(payload.get("tool_name") or "").strip().lower()
82
+ known = SHELL_TOOLS | FILE_TOOLS | SEARCH_TOOLS | CODE_TOOLS
83
+ if tool and tool not in known:
84
+ return None
85
+ blobs = _strings(payload.get("args") if "args" in payload else payload)
86
+ text = "\n".join(blobs)
87
+ if not text.strip():
88
+ return None
89
+ if tool in FILE_TOOLS or tool in SEARCH_TOOLS:
90
+ # read_file(path=…runtime.json) / search_files(pattern=java_key, path=…)
91
+ if _READ_FILE.search(text):
92
+ return _BLOCK_RUNTIME
93
+ if tool in SEARCH_TOOLS and _KEY_NAMES.search(text):
94
+ return _BLOCK_ENV
95
+ return None
96
+ if tool in CODE_TOOLS:
97
+ # 代码里点名 runtime.json:读它没有别的正当用途(存在性判断也不是排障必需)
98
+ if _READ_FILE.search(text):
99
+ return _BLOCK_RUNTIME
100
+ if _ENV_DUMP.search(text) and _KEY_NAMES.search(text):
101
+ return _BLOCK_ENV
102
+ return None
103
+ if _READ_FILE.search(text) and _READ_VERBS.search(text):
104
+ return _BLOCK_RUNTIME
105
+ if _ENV_DUMP.search(text) and _KEY_NAMES.search(text):
106
+ return _BLOCK_ENV
107
+ return None
108
+
109
+
110
+ def main() -> int:
111
+ if os.environ.get("VOD_HOOK_READ_GUARD", "1").strip() in ("0", "false", "off"):
112
+ return 0
113
+ try:
114
+ raw = sys.stdin.read()
115
+ payload = json.loads(raw) if raw.strip() else {}
116
+ msg = verdict(payload)
117
+ except Exception: # noqa: BLE001 fail-open:解析失败绝不拦
118
+ return 0
119
+ if msg:
120
+ sys.stdout.write(json.dumps({"decision": "block", "reason": msg},
121
+ ensure_ascii=False) + "\n")
122
+ sys.stdout.flush()
123
+ return 0
124
+
125
+
126
+ if __name__ == "__main__":
127
+ sys.exit(main())
@@ -0,0 +1,89 @@
1
+ #!/usr/bin/env python3
2
+ """vod_router:Hermes shell hook(pre_llm_call)——确定性意图路由。
3
+
4
+ 统一架构(D-hook-unify-1):路由不再做成 hermes 插件包(要 plugins.enabled、要
5
+ 宿主进程内 import),而是一个**与宿主无关的钩子脚本**:stdin 读 JSON 事件载荷,
6
+ stdout 输出 {"context": "..."};由各宿主自己的机制注册(hermes=`config.yaml` 的
7
+ hooks.pre_llm_call,子进程隔离、按 (event, command) 首次同意)。线协议见
8
+ hermes docs「Shell Hooks → JSON wire protocol」。
9
+
10
+ 行为:
11
+ - 命中 TRIGGER_WORDS(确定性关键词,非模型判断)→ 注入 directives(含显式
12
+ 「提交反馈」前缀的分支);
13
+ - 未命中 → 什么都不输出(零注入零噪音)。
14
+
15
+ 规则表纪律:新增触发词改 TRIGGER_WORDS(单一事实源),改文案改 DIRECTIVE /
16
+ STRONG_DIRECTIVE;两处都有回归锁(tests/test_router.py)。
17
+ """
18
+ import json
19
+ import re
20
+ import sys
21
+
22
+ TRIGGER_WORDS = (
23
+ "提交反馈", "提单",
24
+ "体验不好", "体验差", "体验很差", "体验糟", "很糟糕", "太糟糕",
25
+ "太慢", "很慢", "回复慢", "响应慢",
26
+ "卡顿", "卡死", "卡",
27
+ "不好用", "很难用",
28
+ "报错", "有bug", "有 bug", "出bug",
29
+ "希望支持", "建议增加", "要是能", "为什么不能",
30
+ )
31
+ _STRONG_PREFIX = "提交反馈"
32
+
33
+ _COMPLAINT_RE = re.compile("|".join(re.escape(w) for w in TRIGGER_WORDS))
34
+
35
+ DIRECTIVE = (
36
+ "[vod-router] 确定性意图路由命中:本消息匹配产品反馈采集意图(规则命中,非模型判断)。"
37
+ "必须按 vod-feedback-collect 技能流程处理:先承接用户,再征得提交同意"
38
+ "(产品未定时必须问一次『这条是哪个产品的反馈』,不许裸提交;"
39
+ "用户说不知道就不提交(缺产品不提交);禁止进入复现排查模式)。"
40
+ "提交时 content=用户原话逐字,一次抱怨一条,回执按 echo 原样转述。"
41
+ )
42
+
43
+ STRONG_DIRECTIVE = (
44
+ "[vod-router] 显式反馈指令(「提交反馈」前缀,确定性短路):必须立即按 "
45
+ "vod-feedback-collect 技能流程执行采集,无需再判断意图。"
46
+ )
47
+
48
+
49
+ def _text_of(payload: dict) -> str:
50
+ """取这一轮的用户原话:real payload 把 user_message 放在 extra 里;
51
+ user_message 可能是多模态列表(取其中的 text 段)。"""
52
+ extra = payload.get("extra") or {}
53
+ msg = extra.get("user_message", payload.get("user_message"))
54
+ if isinstance(msg, list):
55
+ parts = []
56
+ for part in msg:
57
+ if isinstance(part, dict):
58
+ if part.get("type") in (None, "text") and part.get("text"):
59
+ parts.append(str(part["text"]))
60
+ elif isinstance(part, str):
61
+ parts.append(part)
62
+ msg = "\n".join(parts)
63
+ return msg if isinstance(msg, str) else ""
64
+
65
+
66
+ def route(text) -> str | None:
67
+ """返回要注入的指令;未命中/非字符串返回 None(钩子绝不对载荷形状抛错)。"""
68
+ if not isinstance(text, str) or not text.strip():
69
+ return None
70
+ if text.lstrip().startswith(_STRONG_PREFIX):
71
+ return STRONG_DIRECTIVE
72
+ return DIRECTIVE if _COMPLAINT_RE.search(text) else None
73
+
74
+
75
+ def main() -> int:
76
+ try:
77
+ raw = sys.stdin.read()
78
+ payload = json.loads(raw) if raw.strip() else {}
79
+ except (json.JSONDecodeError, OSError):
80
+ return 0 # 载荷不可解析=不注入,绝不打断宿主这一轮
81
+ directive = route(_text_of(payload))
82
+ if directive:
83
+ # 协议:dict 里 "context" 键的文本被追加到本轮用户消息
84
+ sys.stdout.write(json.dumps({"context": directive}, ensure_ascii=False))
85
+ return 0
86
+
87
+
88
+ if __name__ == "__main__":
89
+ sys.exit(main())
@@ -20,6 +20,7 @@ metadata:
20
20
  | 本机已提交过哪些(进度追问) | `vod_list_submitted`(本地账本口径,换机不保留)**仅 stdio 面可用**;远程面改答"本条收录状态" |
21
21
  | 插件版本/来源核验 | `vod_devkit_info`(version + commitSha) |
22
22
  | key/认证状态、引擎连通性 | `vod_auth_status`(只报指纹,不下发明文) |
23
+ | 准备采集前确认身份(尤其 MCP 单独部署/无 key) | `vod_auth_ensure`(有可用令牌就复用,没有则由服务代理领匿名令牌;幂等,一次会话调一次) |
23
24
  | 有哪些技能、规则技能是否可用 | `vod_list_skills` |
24
25
  | 取规则技能全文(分类/评分口径) | `vod_retrieve_skill`(owner pack 被裁剪时返回恢复指引) |
25
26
 
@@ -48,4 +49,34 @@ metadata:
48
49
  5. **不碰内部面**:不尝试数据库直连、不读取或打印凭据;被 deny 时如实告知,
49
50
  不要换措辞重试。
50
51
  6. **规则口径以技能/披露内容为准**:不凭训练数据回答 VOD 分类与评分——
51
- vendored 文本与引擎代码同源。
52
+ vendored 文本与引擎代码同源。
53
+
54
+ ## 身份准备(MCP 单独部署 / 无 key)
55
+
56
+ 采集前要确认身份时,调 **一次** `vod_auth_ensure`(幂等,不要每次工具调用都调):
57
+
58
+ | 返回 | 处理 |
59
+ |---|---|
60
+ | `verified=true` | 直接继续采集;`source` 说明身份来源(`env` 显式 key / `runtime` 本机令牌 / `new-anonymous` 刚领的匿名令牌) |
61
+ | `verified=false` + `reason=rejected` | 显式 key 被引擎拒绝:告诉用户换一把有效 key,**不要**改走匿名档掩盖配置错误 |
62
+ | `verified=null` + `reason=unreachable` | 网络问题不是身份问题:如实说"暂时无法确认身份",不要领新令牌 |
63
+
64
+ 不读环境变量、不翻 `runtime.json`/state 文件判断身份——那是服务进程的事(读也会被 hook 拦回,
65
+ 只引指纹)。匿名档额度是**整机共享**的:别的宿主用多了,这里也会提前撞上限,属于正常语义。
66
+
67
+ MCP 独立部署(同机常驻 server,agent 用 HTTP 连 127.0.0.1:9528)与本地 stdio **同一套流程**:
68
+ 照样调 `vod_auth_ensure`(带 Authorization 就是请求头身份,不带就用整机匿名令牌);
69
+ 两段式 `vod_draft_voices`/`vod_commit_voices` 与 `vod_list_submitted` 在远程面同样可用,
70
+ 但草稿只能由创建它的那个 agent 提交(按宿主隔离,串了会报"不属于当前客户端")。
71
+ 唯一远程没有的是 `vod_packs_configure`(进程内开关)。
72
+
73
+ ## 宿主差异:dsh 的工具名带前缀
74
+
75
+ - dsh(装了 `@deepseek-ai/dsh-mcp-client` 的版本)**工具由 MCP 承载**,注册名是
76
+ `mcp__vod-devkit__vod_search_products` / `mcp__vod-devkit__vod_auth_ensure` /
77
+ `mcp__vod-devkit__vod_submit_voices` …(能力面与其它宿主一致)。
78
+ - 没有 mcp-client 的降级形态,工具由 dsh 壳自注册,只有 6 个**短名**
79
+ (vod_submit_voices / vod_list_submitted / vod_devkit_info / vod_list_skills /
80
+ vod_retrieve_skill / vod_check_update),没有 ensure / draft / commit。
81
+ - 调用前**以宿主 tools/list 里的实际名字为准**;两种形态的采集纪律、同意前置、原话逐字
82
+ 完全相同,只是名字前缀不同。
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.5.9"
8
+ __version__ = "0.5.11"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
@@ -30,6 +30,15 @@ import re
30
30
 
31
31
  MEM_TTL = 30 * 60 # 记忆窗口:负责人拍板 P2-A(机器级 + 30 分钟)
32
32
 
33
+ # 自指词表(2026-11-16 负责人拍板 A,D-product-ask-1 修订):
34
+ # 安装先验(--product 写入的 binding)**只在原话出现自指时**才作为归因证据。
35
+ # 理由:先验是无字面证据的推断,用户在 A 产品插件里吐槽 B 产品时会错归;
36
+ # 而"这个产品/你们家"这类自指说明用户就在说当前产品,此时先验有语境支撑。
37
+ # 收录口径:只放"指向当前语境"的词,不放泛称("产品"单字不收——太容易误命中)。
38
+ SELF_REFERENCE = ("这个产品", "这款产品", "本产品", "该产品", "你们这个", "你们这款",
39
+ "你们的产品", "你们的这个", "本平台", "这个平台", "这个系统",
40
+ "你们家", "你们这", "咱这个", "咱们这个", "这插件")
41
+
33
42
  _SNIPPET_PAD = 20
34
43
  _SNIPPET_MAX = 80
35
44
  _BOUNDARY = set("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-")
@@ -359,8 +368,18 @@ def attribute(text: str, meta: dict, memory: dict | None = None,
359
368
  "at": mem.get("at"), "reason": "memory"}]}
360
369
 
361
370
  if binding:
362
- return {"product": resolve_id(binding, meta), "productName": str(binding),
363
- "source": "install_binding", "evidence": []}
371
+ # D-product-ask-1 修订(2026-11-16 负责人拍板 A):先验必须有语境支撑。
372
+ # 原话出现自指("这个产品/你们家/本平台")→ 承认先验,证据留痕;
373
+ # 没有自指 → 不拿先验硬归(错归会进引擎幂等/判重域,污染静默难追溯),
374
+ # 与"缺产品先问一次"同一条纪律:宁可多问一句,不可无证据归因。
375
+ hit = next((p for p in SELF_REFERENCE if p in text), None)
376
+ if hit:
377
+ idx = text.find(hit)
378
+ snippet = text[max(0, idx - _SNIPPET_PAD): idx + len(hit) + _SNIPPET_PAD]
379
+ return {"product": resolve_id(binding, meta), "productName": str(binding),
380
+ "source": "install_binding",
381
+ "evidence": [{"product": str(binding), "alias": hit,
382
+ "snippet": snippet, "reason": "self-reference"}]}
364
383
 
365
384
  return {"product": None, "productName": None, "source": "unknown",
366
385
  "evidence": [{"reason": "no-evidence"}]}
@@ -23,6 +23,17 @@ _HEADER = re.compile(r"^\[([^\[\]]+)\]$")
23
23
  _MAPPING_ROOT = re.compile(r"^[A-Za-z_][\w.\-]*\s*:")
24
24
  _DSH_ID = "- id: vod-devkit"
25
25
 
26
+ # 托管块标记(D-dsh-mcp-b-1):B 模式下一次写两条 insert 子项(mcp-client + 壳),
27
+ # 用注释行包裹整块 → 幂等替换、卸载只摘自己,且不与无标记的旧形态混淆。
28
+ _DSH_MARK_START = "# vod-devkit DSH integration start"
29
+ _DSH_MARK_END = "# vod-devkit DSH integration end"
30
+
31
+
32
+ def _is_dsh_id_line(stripped: str) -> bool:
33
+ """精确匹配 `- id: vod-devkit`(前缀匹配会把 `- id: vod-devkit-mcp` 也算进来 →
34
+ classify 判成"多个块"直接 refuse,托管块就永远写不进去)。"""
35
+ return stripped == _DSH_ID or stripped.startswith(_DSH_ID + " ")
36
+
26
37
 
27
38
  class Refused(Exception):
28
39
  """文件形态不在已知集合内:调用方必须原样放弃修改(字节不变)。"""
@@ -124,7 +135,7 @@ def classify_dsh_patch(lines: list) -> tuple:
124
135
  return "refuse", f"根节点是 flow 集合({root[:20]}),本插件只写块数组"
125
136
  if _MAPPING_ROOT.match(root):
126
137
  return "refuse", f"根节点是映射({root[:20]}),不是本插件写的顶层数组"
127
- if sum(1 for ln in lines if ln.strip().startswith(_DSH_ID)) > 1:
138
+ if sum(1 for ln in lines if _is_dsh_id_line(ln.strip())) > 1:
128
139
  return "refuse", "出现多个 `- id: vod-devkit` 块(无法判定哪一份是活的)"
129
140
  return "ok", ""
130
141
 
@@ -132,13 +143,18 @@ def classify_dsh_patch(lines: list) -> tuple:
132
143
  def find_dsh_block(lines: list) -> tuple:
133
144
  """定位 vod-devkit 块的 (start, end);不存在返回 (None, None)。
134
145
 
135
- 块边界=下一顶层元素行(`- ` 开头)或 EOF。嵌套铁律(真机实锤):
136
- dsh 只认缩进在 `- insert:` 之下的块——命中行带缩进时 start 向上归并到
137
- 该组头,整组替换;历史平铺形态按原语义顶格替换。install 的幂等 upsert
138
- 与 uninstall 的摘除共用本边界语义(单一实现,防两处扫描规则漂移)。
146
+ 优先按**托管块标记**定位(D-dsh-mcp-b-1:B 模式下块内含 mcp-client 与壳两条子项,
147
+ 只有标记能划出完整边界);无标记时回落到旧形态扫描(`- id: vod-devkit`,
148
+ 兼容已装机实例)。块边界=下一顶层元素行(`- ` 开头)或 EOF。
139
149
  """
140
150
  for i, ln in enumerate(lines):
141
- if ln.strip().startswith(_DSH_ID):
151
+ if ln.strip() == _DSH_MARK_START:
152
+ for j in range(i + 1, len(lines)):
153
+ if lines[j].strip() == _DSH_MARK_END:
154
+ return i, j + 1
155
+ return i, len(lines) # 只有 start(半坏态):整段到 EOF,由 upsert 重写
156
+ for i, ln in enumerate(lines):
157
+ if _is_dsh_id_line(ln.strip()):
142
158
  start = i
143
159
  if ln[:1] == " ": # 嵌套形态:向上归并组头
144
160
  for k in range(i - 1, -1, -1):
@@ -31,8 +31,10 @@ RULES = [
31
31
  "配置", "宿主没读到我们的 MCP 条目", "检查宿主配置文件里的 mcp 段后重装"),
32
32
  (r"skills 目录缺失|技能文件缺失|技能文件漂移|技能原生副本缺失|技能拷贝件",
33
33
  "技能", "技能副本缺失或与安装指纹不符", "重跑 install 恢复"),
34
- (r"路由插件副本落后|vod-feedback-router",
35
- "插件", "仓内话术已更新但装机副本是旧的", "重跑 install --target hermes"),
34
+ (r"预采集 hook 未注册|vod_router|hook 脚本缺失",
35
+ "配置", "config.yaml 的 hooks.pre_llm_call 没登记我们的脚本", "重跑 install --target hermes"),
36
+ (r"旧插件形态仍在|vod-feedback-router",
37
+ "插件", "老插件与 shell hook 同时生效(双份注入)", "重跑 install --target hermes 清理"),
36
38
  (r"AGENTS\.md 仍含旧一代注入|vod-submit-one-liner",
37
39
  "插件", "旧注入教模型跳过征询(红线失效)", "重跑 install --target codex 自动清理"),
38
40
  (r"远程面|远程 MCP|探活|不可达|401",
@@ -31,7 +31,10 @@ def server_env(args, packs: str) -> dict:
31
31
  # 无 key 不写空串(空串会让探针/严格解析器误当字面值;运行时空=未设置,
32
32
  # 自动兜底 runtime.json java_key 或首提申请匿名令牌)
33
33
  env = {"VOD_PACKS": packs,
34
- "VOD_JAVA_API_BASE": args.java_api_base}
34
+ "VOD_JAVA_API_BASE": args.java_api_base,
35
+ # D-token-machine-1:机器级状态目录显式写进宿主配置——
36
+ # 不依赖"默认值恰好一致",也不随载荷版本目录漂移(升级不换令牌)。
37
+ "VOD_DEVKIT_HOME": str(paths.machine_state_home())}
35
38
  key = os.environ.get("VOD_JAVA_API_KEY", "")
36
39
  if key:
37
40
  env["VOD_JAVA_API_KEY"] = key