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
package/bin/vod-devkit CHANGED
@@ -7,10 +7,19 @@
7
7
 
8
8
  首个参数是 `serve` 时整体透传给 MCP server(不读任何安装配置)。
9
9
  """
10
+ import os
10
11
  import sys
11
12
  from pathlib import Path
12
13
 
13
- sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
14
+ # 入口显式设根(D-structure-1 S3:paths.py 只读不猜)。仓内形态=包在 src/、
15
+ # 分发态在仓根;载荷/插件副本形态两者同指(包与资产都平铺在根下)。
16
+ _DIST = Path(__file__).resolve().parent.parent
17
+ _SRC = _DIST / "src" if (_DIST / "src" / "vod_mcp").is_dir() else _DIST
18
+ # 注意:**不在 import 期写 env**——本文件会被测试用 SourceFileLoader 当模块加载
19
+ # (取 PRESETS/detect_targets),import 期写 env 会把"外层仓的根"泄漏进整场测试,
20
+ # 让"复制仓再跑安装器"的用例把 manifest 写到外层仓(实测踩过)。sys.path 无此风险。
21
+ sys.path.insert(0, str(_SRC))
22
+ sys.path.insert(0, str(_DIST))
14
23
 
15
24
  from vodkit_cli import main # noqa: E402
16
25
  from vodkit_cli.common import PRESETS, build_info, write_build_info # noqa: E402
@@ -20,4 +29,15 @@ from vodkit_cli.install import detect_targets # noqa: E402
20
29
  __all__ = ["main", "PRESETS", "detect_targets", "build_info", "write_build_info"]
21
30
 
22
31
  if __name__ == "__main__":
32
+ # 继承到一个**过期**的根会让整个 CLI 用错仓(表现是"未知宿主 xxx(可选:)"这类
33
+ # 无从解释的错,评审实测复现过一次)。显式设置仍被尊重(测试注入/重定位要用它),
34
+ # 但必须当场说清是哪来的——静默用错根比报错更难查。
35
+ for _name, _want in (("VOD_DEVKIT_SRC_ROOT", _SRC), ("VOD_DEVKIT_DIST_ROOT", _DIST)):
36
+ _got = os.environ.get(_name)
37
+ if _got and Path(_got).resolve() != _want.resolve():
38
+ why = "" if Path(_got).is_dir() else "(该路径不存在)"
39
+ print(f"[vod-devkit] warn: 继承的 {_name}={_got}{why} 不是本入口所在的仓"
40
+ f"({_want})——若命令行为异常,先 unset 它", file=sys.stderr)
41
+ os.environ.setdefault("VOD_DEVKIT_SRC_ROOT", str(_SRC))
42
+ os.environ.setdefault("VOD_DEVKIT_DIST_ROOT", str(_DIST))
23
43
  main()
@@ -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())
@@ -10,11 +10,14 @@
10
10
  "mcpConfigFile": {
11
11
  "default": "~/.hermes/mcp/vod-devkit.json"
12
12
  },
13
+ "profileConfig": {
14
+ "default": "~/.hermes/config.yaml"
15
+ },
13
16
  "skillsDir": {
14
17
  "default": "~/.hermes/skills/devops/vod-devkit"
15
18
  },
16
19
  "managedPaths": [
17
20
  "~/.hermes/plugins/vod-feedback-router"
18
21
  ],
19
- "notes": "配置通过官方 hermes mcp add 写入;这里同时落一份独立 json 便于 doctor 与迁移"
22
+ "notes": "MCP 条目经 hermes mcp add 写入 config.yaml;预采集路由走 config.yaml 的 hooks.pre_llm_call(shell hook,子进程隔离),不再装 Python 插件;managedPaths 只剩旧插件形态的清理对象"
20
23
  }
package/npm/cli.js CHANGED
@@ -12,6 +12,8 @@ import { dirname, join } from 'node:path';
12
12
 
13
13
  const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
14
14
  const installer = join(ROOT, 'bin', 'vod-devkit');
15
+ // 入口显式设根(与 bin/vod-devkit 同一契约):npx 场景两种布局都可能出现
16
+ const SRC = existsSync(join(ROOT, 'src', 'vod_mcp')) ? join(ROOT, 'src') : ROOT;
15
17
 
16
18
  const candidates = [process.env.VOD_PYTHON, 'python3', 'python3.12', 'python3.11', 'python3.10', 'python']
17
19
  .filter(Boolean);
@@ -35,5 +37,8 @@ if (!existsSync(installer)) {
35
37
  process.exit(1);
36
38
  }
37
39
 
38
- const result = spawnSync(py, [installer, ...process.argv.slice(2)], { stdio: 'inherit' });
40
+ const result = spawnSync(py, [installer, ...process.argv.slice(2)], {
41
+ stdio: 'inherit',
42
+ env: { ...process.env, VOD_DEVKIT_SRC_ROOT: SRC, VOD_DEVKIT_DIST_ROOT: ROOT },
43
+ });
39
44
  process.exit(result.status ?? 1);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.5.9",
3
+ "version": "0.5.11",
4
4
  "description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -8,40 +8,14 @@
8
8
  "vod-devkit": "./npm/cli.js"
9
9
  },
10
10
  "files": [
11
- "npm/cli.js",
12
11
  "bin/vod-devkit",
13
- "vodkit_cli",
14
- "skills/",
15
- "contract/",
12
+ "npm/cli.js",
13
+ "src/vodkit_cli",
14
+ "assets/skills",
15
+ "assets/contract",
16
+ "assets/safety",
16
17
  "integrations/",
17
- "safety/",
18
- "QUICKSTART.md",
19
- "README.md",
20
- "CHANGELOG.md",
21
- "LICENSE.txt",
22
- "vod_mcp/__init__.py",
23
- "vod_mcp/server.py",
24
- "vod_mcp/tools.py",
25
- "vod_mcp/net.py",
26
- "vod_mcp/runtime_state.py",
27
- "vod_mcp/packs",
28
- "vod_mcp/paths.py",
29
- "vod_mcp/policy.py",
30
- "vod_mcp/config_forms.py",
31
- "vod_mcp/skills_registry.py",
32
- "vod_mcp/update_check.py",
33
- "vod_mcp/hosts.py",
34
- "vod_mcp/transport_remote.py",
35
- "vod_mcp/remote_app.py",
36
- "vod_mcp/guardrails.py",
37
- "vod_mcp/pending.py",
38
- "vod_mcp/provenance.py",
39
- "vod_mcp/attribution.py",
40
- "vod_mcp/runtime.example.json",
41
- "vod_mcp/payload.py",
42
- "vod_mcp/diagnose.py",
43
- "vod_mcp/detect_framework.py",
44
- "vod_mcp/host_adapters/",
18
+ "packages/dsh/package.json",
45
19
  "plugins/vod-devkit/.codex-plugin/plugin.json",
46
20
  "plugins/vod-devkit/.mcp.json",
47
21
  "plugins/vod-devkit/build-info.json",
@@ -49,7 +23,36 @@
49
23
  "plugins/vod-devkit/skills",
50
24
  "plugins/vod-devkit/contract",
51
25
  "plugins/vod-devkit/safety",
52
- "plugins/.agents/plugins/marketplace.json"
26
+ "plugins/vod-devkit/hooks",
27
+ "plugins/.agents/plugins/marketplace.json",
28
+ "skills/",
29
+ "QUICKSTART.md",
30
+ "README.md",
31
+ "CHANGELOG.md",
32
+ "LICENSE.txt",
33
+ "src/vod_mcp/__init__.py",
34
+ "src/vod_mcp/attribution.py",
35
+ "src/vod_mcp/config_forms.py",
36
+ "src/vod_mcp/detect_framework.py",
37
+ "src/vod_mcp/diagnose.py",
38
+ "src/vod_mcp/guardrails.py",
39
+ "src/vod_mcp/hosts.py",
40
+ "src/vod_mcp/net.py",
41
+ "src/vod_mcp/paths.py",
42
+ "src/vod_mcp/payload.py",
43
+ "src/vod_mcp/pending.py",
44
+ "src/vod_mcp/policy.py",
45
+ "src/vod_mcp/provenance.py",
46
+ "src/vod_mcp/remote_app.py",
47
+ "src/vod_mcp/runtime.example.json",
48
+ "src/vod_mcp/runtime_state.py",
49
+ "src/vod_mcp/server.py",
50
+ "src/vod_mcp/skills_registry.py",
51
+ "src/vod_mcp/tools.py",
52
+ "src/vod_mcp/transport_remote.py",
53
+ "src/vod_mcp/update_check.py",
54
+ "src/vod_mcp/host_adapters/",
55
+ "src/vod_mcp/packs/"
53
56
  ],
54
57
  "keywords": [
55
58
  "mcp",
@@ -0,0 +1,60 @@
1
+ # dsh-vod-devkit
2
+
3
+ VOD 用户声音采集插件 —— DeepSeek Harness (dsh) 薄壳。
4
+
5
+ ## 形态
6
+
7
+ - 纯采集:3 工具(`vod_submit_voices` / `vod_list_submitted` / `vod_devkit_info`)
8
+ - 插件=引擎客户端,只走 HTTPS(VOD external API),不 import 任何引擎模块
9
+ - 与 vod-devkit(MCP 形态,同仓 `../vod_mcp`)语义对齐:
10
+ - voiceId = f(source, content, 调用级 nonce):同调用幂等、跨调用保声量
11
+ - 归因=运行期从用户原话解析(引擎产品名录别名,含中文/长别名),唯一命中才采信;
12
+ 优先级:字面证据 > 记忆(30 分钟)> 配置 product 先验 > 未知(引擎 UNKNOWN 池)
13
+ - 多产品命中=歧义 → 不带 product 上送(宁可人工归因,不可错归;与 vod_mcp 同口径)
14
+ - 无 key/401 → POST /external/token 零字段匿名令牌 → 本地落盘 → 重试一次
15
+ - 本地账本 data/runtime.json(cap 200 环形,读改写只动目标键)
16
+
17
+ ## 安装
18
+
19
+ ```
20
+ npx --yes vod-devkit install --target dsh --profile <name> [--product <产品>] # 推荐(--product 可选先验;给了即硬校验)
21
+ ```
22
+
23
+ > ⚠️ 不要用 `dsh plugin add dsh-vod-devkit` 裸装:只装插件本体不写配置——
24
+ > apiBase/uiBase 缺失时工具半不可用、UI 提交会发往 dsh 同源(404 → 本地暂存
25
+ > 发不出去,嵌入方真机实锤)。裸装后补救:跑一次上面的 npx 命令即可(幂等)。
26
+ > product 不再是必填:归因默认从用户原话解析,配置值只是无证据时的先验。
27
+
28
+ 装后配置落在 profile 的 cordis.patch.yml(npx 包装命令自动写入):
29
+
30
+ ```yaml
31
+ - id: vod-devkit
32
+ config:
33
+ product: '' # 可选先验(无字面证据且无记忆时兜底);归因主路径=用户原话解析
34
+ # apiBase: https://vod-dev.topxtopx.com # 工具半(Node 服务端)用,缺省即此
35
+ # uiBase: https://vod-dev.topxtopx.com # 浏览器半(反馈按钮)直连用,缺省即此
36
+ ```
37
+
38
+ ### UI 半(反馈按钮)部署前提——二选一
39
+
40
+ - **uiBase 直连**(默认,本包形态):浏览器直接请求 uiBase 指向的引擎地址。
41
+ 依赖:引擎侧 CORS 允许 dsh 页面源(本地 dsh 为 `http://127.0.0.1:<port>`)。
42
+ 引擎 CORS 收敛(白名单制)落地时,白名单必须含 dsh 本地源,随其上线同步验证。
43
+ - **宿主代理**(嵌入方自建,可选):由 dsh 部署侧把 `/external/*` 反代到引擎,
44
+ 此时 uiBase 可留空走同源。当前 dsh 不自带此代理,默认勿依赖。
45
+
46
+ ## 配置(dsh 插件设置)
47
+
48
+ | 字段 | 默认 | 说明 |
49
+ |---|---|---|
50
+ | apiBase | https://vod-dev.topxtopx.com | VOD external API 基址(工具半/服务端用) |
51
+ | uiBase | 同 apiBase | 浏览器半(反馈按钮)直连基址;同源代理形态可留空 |
52
+ | apiKey | (空) | 缺省走零字段匿名令牌;灰度期可用运营签发 key |
53
+ | product | (空) | 可选归因先验(如 codearts):仅在无字面证据且无记忆时生效;空=完全靠原话解析,歧义落 UNKNOWN |
54
+ | confirmWrites | true | 写操作走 dsh 审批通道(tools/pre-execute → ask) |
55
+ | timeoutSec | 30 | HTTP 超时 |
56
+
57
+ ## 安全
58
+
59
+ - apiKey 标记 `.role('secret')`:不跨 wire 回传,展示一律 sha1[:8] 指纹
60
+ - 写操作默认弹确认;单批 ≤50;content ≤2000 逐条校验
@@ -0,0 +1,52 @@
1
+ {
2
+ "name": "dsh-vod-devkit",
3
+ "version": "0.5.11",
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
+ "type": "module",
6
+ "main": "lib/index.js",
7
+ "files": [
8
+ "lib/**/*.js",
9
+ "cordis.patch.yml",
10
+ "README.md"
11
+ ],
12
+ "license": "MIT",
13
+ "dsh": {
14
+ "bundle": {
15
+ "patch": "./cordis.patch.yml"
16
+ },
17
+ "client": {
18
+ "platform": "web",
19
+ "inject": [
20
+ "@deepseek-ai/dsh-client-ui-chat"
21
+ ]
22
+ }
23
+ },
24
+ "engines": {
25
+ "node": ">=18"
26
+ },
27
+ "peerDependencies": {
28
+ "@deepseek-ai/cordis": ">=4.0.0",
29
+ "@deepseek-ai/dsh-tools": ">=0.0.1-0",
30
+ "@deepseek-ai/schemastery": ">=3.18.0"
31
+ },
32
+ "keywords": [
33
+ "dsh",
34
+ "deepseek-harness",
35
+ "dsh-plugin",
36
+ "vod",
37
+ "feedback"
38
+ ],
39
+ "devDependencies": {
40
+ "esbuild": "^0.28.2",
41
+ "react": "^19.3.1"
42
+ },
43
+ "exports": {
44
+ ".": "./lib/index.js",
45
+ "./client": "./lib/client.js",
46
+ "./package.json": "./package.json"
47
+ },
48
+ "scripts": {
49
+ "test": "node --test test/*.test.mjs",
50
+ "build-client": "esbuild src/client.jsx --jsx=automatic --format=cjs --minify --outfile=/tmp/client-cjs.js && python3 scripts/wrap_client.py"
51
+ }
52
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.5.9",
3
+ "version": "0.5.11",
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,8 @@
1
1
  {
2
+ "$schema": "agent-plugins.org/schemas/1.0.0/mcp.schema.json",
2
3
  "mcpServers": {
3
4
  "vod-devkit": {
5
+ "type": "stdio",
4
6
  "command": "vod-devkit",
5
7
  "args": ["serve"],
6
8
  "env": { "VOD_PACKS": "core,collect" }
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.5.9",
3
- "commitSha": "3c4fb77c8af5c119e1ce85f821672d4fcb522856",
4
- "builtAt": "2026-11-15T18:03:35",
2
+ "version": "0.5.11",
3
+ "commitSha": "6c42fa7929c26de62ec63ba94be9dd254d1f7afc",
4
+ "builtAt": "2026-11-16T10:56:54",
5
5
  "sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
6
6
  }