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,204 +0,0 @@
1
- """Hermes 宿主适配:官方 hermes mcp add + 路由插件部署。
2
-
3
- 落点与探测来自 integrations/hermes/host.json(数据驱动,代码里不许出现第二份
4
- 路径字面量);新增 Hermes 特定逻辑只改本模块。
5
- """
6
- import json
7
- import shutil
8
- import subprocess
9
- import sys
10
- from pathlib import Path
11
-
12
- from vod_mcp import hosts as host_specs
13
- from vod_mcp.host_adapters.base import ROOT, server_env, server_entry
14
-
15
- HOST = "hermes"
16
- SUPPORTS_REMOTE = True
17
- def _spec() -> dict:
18
- """调用期现读:host.json 的 ~ 必须在调用期按当前 HOME 解析。
19
-
20
- 2026-11-12 实锤:模块 import 期求值 _MCP_DIR 后,测试里 monkeypatch HOME
21
- 写不到隔离目录,直接把真实 ~/.hermes/mcp/vod-devkit.json 覆盖成了桩值
22
- (command=/x/vod_mcp/server.py)——真机 doctor 当场读到坏条目。
23
- """
24
- return host_specs.load("hermes")
25
-
26
-
27
- def skills_dir(args):
28
- return Path(_spec()["skillsDir"])
29
-
30
-
31
- PLUGIN_NAME = "vod-feedback-router"
32
-
33
-
34
- def _enabled_plugins() -> list:
35
- """读 hermes 配置里的 plugins.enabled(CLI 输出是 "- name" 行)。
36
-
37
- 无 CLI 直接返回空:裸 subprocess 会抛 FileNotFoundError 打崩整个 install
38
- (CI/无宿主机器上实测)——缺 CLI 是"降级"不是"失败"。
39
- """
40
- if not shutil.which("hermes"):
41
- return []
42
- r = subprocess.run(["hermes", "config", "get", "plugins.enabled"],
43
- capture_output=True, text=True, timeout=60)
44
- if r.returncode != 0:
45
- return []
46
- out = []
47
- for line in (r.stdout or "").splitlines():
48
- line = line.strip()
49
- if line.startswith("- "):
50
- out.append(line[2:].strip())
51
- elif line.startswith("-"):
52
- out.append(line[1:].strip())
53
- return [x for x in out if x]
54
-
55
-
56
- def enable_plugin(name: str = PLUGIN_NAME) -> str:
57
- """把路由插件加进 plugins.enabled(幂等)。返回 created / unchanged / skipped。
58
-
59
- 只追加一个名字:读现有名单 → 追加 → `hermes config set plugins.enabled '[...]'`。
60
- 不整文件改 config.yaml(用户可能手改过格式/注释),失败只提示不动。
61
- """
62
- import json as _json
63
- if not shutil.which("hermes"):
64
- print("提示:未找到 hermes CLI,路由插件需手动在 plugins.enabled 中加入 "
65
- f"{name} 后生效")
66
- return "skipped"
67
- cur = _enabled_plugins()
68
- if name in cur:
69
- return "unchanged"
70
- merged = cur + [name]
71
- r = subprocess.run(["hermes", "config", "set", "plugins.enabled",
72
- _json.dumps(merged)], capture_output=True, text=True, timeout=60)
73
- if r.returncode != 0:
74
- print("提示:自动启用路由插件失败(" + (r.stderr or r.stdout).strip()[:120]
75
- + ");请手动把 " + name + " 加入 plugins.enabled")
76
- return "skipped"
77
- return "created"
78
-
79
-
80
- def install(args, packs: str) -> Path:
81
- """Hermes:官方途径 hermes mcp add(config.yaml mcp_servers)。"""
82
- conf = Path(_spec()["configPath"]).parent / "vod-devkit.json"
83
- conf.parent.mkdir(parents=True, exist_ok=True)
84
- conf.write_text(json.dumps({
85
- "name": "vod-devkit", "command": sys.executable,
86
- "args": [server_entry()], "env": server_env(args, packs),
87
- }, ensure_ascii=False, indent=2), encoding="utf-8")
88
- env_args = []
89
- for k, v in server_env(args, packs).items():
90
- env_args.extend([k + "=" + v])
91
- # 无 CLI 时不裸 exec(FileNotFoundError 会打崩 install):JSON 已落盘,
92
- # 用户可手工并入 config.yaml —— 缺 CLI 是降级,不是失败。
93
- if shutil.which("hermes"):
94
- r = subprocess.run(
95
- ["hermes", "mcp", "add", "vod-devkit", "--command", sys.executable,
96
- *["--env"] + env_args, "--args", server_entry()],
97
- input="y\ny\n", capture_output=True, text=True)
98
- else:
99
- r = None
100
- print(f"提示:未找到 hermes CLI(PATH),已写出配置片段:{conf}\n"
101
- " 将其并入 ~/.hermes/config.yaml 的 mcp_servers 后重启会话生效",
102
- file=sys.stderr)
103
- # D-hook-1:强制评估路由插件(pre_llm_call 确定性意图路由,业界 forced-eval 模式)
104
- plug_src = ROOT / "hermes-plugin" / "vod-feedback-router"
105
- plug_dst = Path.home() / ".hermes" / "plugins" / PLUGIN_NAME
106
- if plug_src.is_dir():
107
- if plug_dst.exists():
108
- shutil.rmtree(plug_dst)
109
- shutil.copytree(plug_src, plug_dst)
110
- state = enable_plugin()
111
- verb = {"created": "已自动加入 plugins.enabled",
112
- "unchanged": "已在 plugins.enabled 中",
113
- "skipped": "未自动启用(见上方提示)"}[state]
114
- print(f"已安装 {PLUGIN_NAME} 路由插件(~/.hermes/plugins/,{verb};重启会话生效)")
115
- if r is None:
116
- pass # 无 CLI:上面已经给过指引
117
- elif r.returncode == 0:
118
- print("已注册 Hermes MCP(hermes mcp list 可见;重启会话生效)")
119
- else:
120
- print(f"提示:hermes mcp add 未成功({r.stderr.strip()[:150]});"
121
- f"可将 {conf} 内容并入 Hermes 配置")
122
- return conf
123
-
124
-
125
- def install_remote(args, url, token):
126
- """hermes mcp add --url:token 经 env 注入,配置里只留 ${MCP_VOD_DEVKIT_API_KEY} 引用。
127
-
128
- B1(2026-11-13 真机实锤):hermes mcp add 对已存在条目的交互链是三问
129
- (Overwrite? → 认证? → Enable all tools?),管道 input 只给两个 y 时第三问
130
- 读不到输入 → hermes 端 Cancelled 且仍 exit 0 → 安装器打印"已注册"但
131
- config.yaml 纹丝不动(静默假绿)。修法两道:
132
- ①stdin 喂不封顶的 y 流(迭代器持续供给,hermes 问几问答几个——多问多答、
133
- 少问即 EOF 收尾),不再数提示个数;
134
- ②rc=0 不算数——读回 hermes 配置真源(config.yaml mcp_servers.vod-devkit
135
- 的 url),断言远程条目真的写进去了;没写进去就非零退出报"未注册",
136
- 绝不静默。
137
- """
138
- import os
139
- env = os.environ.copy()
140
- env["MCP_VOD_DEVKIT_API_KEY"] = token
141
-
142
- def _yes_forever():
143
- # 交互问数随 hermes 版本变化(首次装=2 问,覆盖装=3 问),流式供给不数数
144
- for _ in range(64):
145
- yield "y\n"
146
-
147
- r = subprocess.run(
148
- ["hermes", "mcp", "add", "vod-devkit", "--url", url, "--auth", "header"],
149
- input="".join(_yes_forever()), capture_output=True, text=True, env=env,
150
- timeout=180)
151
- # 防静默:读回 config.yaml 断言远程条目在(Cancelled 会 rc=0 但不落配置)
152
- registered = _hermes_registration_is_remote(url)
153
- if r.returncode != 0 or not registered:
154
- reason = (f"hermes mcp add rc={r.returncode},"
155
- + ("配置读回未见远程条目(交互确认被跳过即静默取消)" if not registered
156
- else f"stderr={(r.stderr or '').strip()[-150:]}"))
157
- print(f"[vod-devkit] Hermes 远程 MCP 注册未落盘:{reason}\n"
158
- " 可手工执行:hermes mcp add vod-devkit --url <url> --auth header "
159
- "(逐问回答 y)", file=sys.stderr)
160
- sys.exit(1)
161
- conf = Path(_spec()["configPath"]).parent / "vod-devkit.json"
162
- conf.parent.mkdir(parents=True, exist_ok=True)
163
- conf.write_text(json.dumps({"name": "vod-devkit", "url": url,
164
- "headers": {"Authorization": "Bearer ${MCP_VOD_DEVKIT_API_KEY}"}},
165
- ensure_ascii=False, indent=2), encoding="utf-8")
166
- print(f"已注册 Hermes 远程 MCP({url};token 存 ~/.hermes/.env,配置内只留引用)")
167
- return conf
168
-
169
-
170
- def _hermes_registration_is_remote(url: str) -> bool:
171
- """读回 hermes 内部注册真源(config.yaml mcp_servers),断言 vod-devkit 是远程条目。
172
-
173
- hermes mcp add 写 ~/.hermes/config.yaml 的 mcp_servers.vod-devkit(url 字段
174
- 为远程形态标志);Cancelled 的假绿在这里现形。无 yaml 依赖红线:远端
175
- 安装器零第三方依赖,这里用受限文本扫描(顶层 mcp_servers: 段下缩进块内
176
- 找 vod-devkit 与 url 行),而非完整 yaml 解析。
177
- """
178
- cfg = Path.home() / ".hermes" / "config.yaml"
179
- if not cfg.is_file():
180
- return False
181
- in_section = False
182
- saw_entry = False
183
- saw_url = False
184
- for raw_line in cfg.read_text(encoding="utf-8").splitlines():
185
- if not raw_line.strip() or raw_line.lstrip().startswith("#"):
186
- continue
187
- indented = raw_line[0] == " "
188
- stripped = raw_line.strip()
189
- if not indented:
190
- in_section = stripped.startswith("mcp_servers:")
191
- continue
192
- if not in_section:
193
- continue
194
- # mcp_servers 段内的行:条目名(一级缩进)与字段(更深缩进)
195
- if stripped.startswith("vod-devkit:"):
196
- saw_entry = True
197
- elif saw_entry and stripped.startswith("url:"):
198
- if url in stripped:
199
- saw_url = True
200
- break
201
- elif saw_entry and not raw_line.startswith(" vod-devkit") and stripped.endswith(":"):
202
- if not raw_line.startswith(" " * 4): # 下一个一级条目:停止
203
- break
204
- return saw_entry and saw_url
@@ -1,67 +0,0 @@
1
- """packs 裁剪:VOD_PACKS=core,workflow,kb(逗号分隔,默认全装)。
2
-
3
- core 常驻(vod_devkit_info + vod-core 技能);未启用的 pack 工具不注册。
4
- """
5
- import os
6
- import sys
7
-
8
- ALL_PACKS = ("core", "collect", "knowledge")
9
-
10
- PACK_TOOLS = {
11
- # vod_search_products:问用户"是哪个产品"前给候选(只读,D-product-ask-1)
12
- "core": ["vod_devkit_info", "vod_auth_status", "vod_check_update",
13
- "vod_search_products"],
14
- # 两段式(D-token-approval-2 极简形态)随 collect 下发;codex 话术走 draft→commit
15
- "collect": ["vod_submit_voices", "vod_draft_voices", "vod_commit_voices", "vod_list_submitted"],
16
- # 领域规则技能披露(第二轨):知道有哪几本规则、按需取全文。
17
- # 只读、零上游调用、零依赖——与"纯知识包"的定位一致。
18
- "knowledge": ["vod_list_skills", "vod_retrieve_skill"],
19
- }
20
-
21
-
22
- BREAKER_MARKERS = (
23
- # 熔断标记(D-codex-circuit-breaker-1):install 门禁可被
24
- # `VOD_PACKS=core,collect serve` 绕过——运行期同查标记强制降级
25
- os.path.expanduser("~/.codex/vod-collect-suspended.json"),
26
- )
27
-
28
-
29
- def enabled_packs() -> tuple:
30
- raw = os.environ.get("VOD_PACKS", "").strip()
31
- if not raw:
32
- return ALL_PACKS
33
- # kb=knowledge 旧称别名(历史文档/用户习惯;深审 P0-2 配套:安装口
34
- # 旧值不因运行口改名而静默失效)
35
- packs = tuple(p.strip() for p in raw.split(","))
36
- packs = tuple("knowledge" if p == "kb" else p for p in packs)
37
- packs = tuple(p for p in packs if p in ALL_PACKS)
38
- if "core" not in packs:
39
- packs = ("core",) + packs
40
- if "collect" in packs and any(os.path.isfile(m) for m in BREAKER_MARKERS):
41
- # 运行期熔断门禁:collect 强制摘除(非静默——stderr 告警)。
42
- # 解除=删熔断标记(install --ack-suspension 即此语义)
43
- packs = tuple(p for p in packs if p != "collect")
44
- print("[vod-devkit] 采集熔断生效(codex 未确认提交 ≥2 次,"
45
- "D-codex-circuit-breaker-1):collect 已强制摘除。"
46
- "恢复前置=token 化上线并过回归;--ack-suspension 解除安装门禁,"
47
- "运行期解除须删熔断标记", file=sys.stderr)
48
- return packs
49
-
50
-
51
- # 服务面(HTTP 传输)摘除的"写本机状态"工具——对齐 huaweicloud-devkit 的
52
- # remoteSurface 门控语义:远程面没有"本机"这个概念。
53
- # draft/commit:草稿暂存在本机 runtime.json,HTTP 面由多客户端共享一个进程,
54
- # "本机草稿"既不隔离也不可审计;
55
- # list_submitted:本地账本是装机维度的记录,服务面读它不是客户端想要的答案
56
- # (跨机对账走引擎端点)。
57
- # 注意:submit 不摘——它对 VOD 的唯一动作是调用引擎 HTTP API,落库是服务端的事。
58
- REMOTE_WITHHELD = ("vod_draft_voices", "vod_commit_voices", "vod_list_submitted")
59
-
60
-
61
- def enabled_tools(remote: bool = False) -> list:
62
- tools = []
63
- for pack in enabled_packs():
64
- tools.extend(PACK_TOOLS[pack])
65
- if remote:
66
- tools = [t for t in tools if t not in REMOTE_WITHHELD]
67
- return tools
@@ -1,80 +0,0 @@
1
- """core pack:自述、认证自检、版本提醒、产品候选检索(只读,零写盘副作用)。"""
2
- from vod_mcp import attribution as _attrib
3
- from vod_mcp import net, provenance
4
-
5
-
6
- def search_products(params: dict) -> dict:
7
- """产品候选检索(只读):给模型 3-5 个候选去问用户,而不是从名录里瞎猜。
8
- 名录=引擎 meta 接口的 productCatalog(长度随运营变更,插件不内置)。"""
9
- query = str(params.get("query") or "").strip()
10
- limit = int(params.get("limit") or 5)
11
- limit = max(1, min(limit, 20))
12
- meta = net._load_meta()
13
- catalog = meta.get("catalog") or []
14
- if not query:
15
- return {"candidates": [], "total": len(catalog)}
16
- idx = _attrib.build_alias_index(meta)
17
- hits = _attrib.match_products(query, idx)
18
- seen, cands = set(), []
19
- for h in hits:
20
- pid = str(h.get("id") or "")
21
- if not pid or pid in seen:
22
- continue
23
- seen.add(pid)
24
- cands.append({"id": pid, "name": h["product"],
25
- "score": round(min(1.0, len(h["alias"]) / max(len(query), 1)), 2),
26
- "matchReason": f"alias:{h['alias']}"})
27
- if not cands: # 别名没命中:退回名字子串(用户可能打错/只说一半)
28
- q = query.lower()
29
- for item in catalog:
30
- name = str(item.get("name") or "")
31
- if q and (q in name.lower() or name.lower() in q):
32
- cands.append({"id": str(item.get("id")), "name": name, "score": 0.5,
33
- "matchReason": "name-substring"})
34
- if not cands: # 完全无关联词:给名录前 N 个当"可选项"(问用户用)
35
- for item in catalog[:limit]:
36
- cands.append({"id": str(item.get("id")), "name": str(item.get("name") or ""),
37
- "score": 0.0, "matchReason": "catalog-default"})
38
- cands.sort(key=lambda c: (c["score"], len(c["name"])), reverse=True)
39
- return {"candidates": cands[:limit], "total": len(catalog)}
40
-
41
-
42
- def devkit_info(params: dict, client_info: dict | None = None) -> dict:
43
- return provenance.info_payload(client_info)
44
-
45
-
46
- def auth_status(params: dict, client_info: dict | None = None) -> dict:
47
- """认证自检:指纹化输出(明文永不出现),无 key 也跑并给引导。
48
-
49
- 远程面(HTTP)缺陷修正:keyCheck 探针旧实现只看本地 net.JAVA_KEY(env/runtime),
50
- 远程面没有本地 key 时 keyCheck 永远 null——远程 agent 永远无法验证自己
51
- 请求头里的 key(真实场景:坏 key 装上、提交才 401)。修法:服务面下探
52
- net._eff_key()(请求头 Bearer),本地态 javaKey 段照实报"本机未配置",另加
53
- requestKey 段报请求头 key 的指纹与探针结果——身份随请求走,两段不混。
54
- """
55
- req_key = net._eff_key() if net._SERVER_FACE.get() else None
56
- out = {
57
- "javaKey": net._key_state(),
58
- "packs": sorted(__import__("vod_mcp.packs", fromlist=["enabled_packs"]).enabled_packs()),
59
- }
60
- if req_key:
61
- out["requestKey"] = {"fingerprint": net._fingerprint(req_key),
62
- "note": "服务面:身份来自请求头 Bearer"}
63
- # 探针显式传请求头 key(net.probe_key 默认取本地 net.JAVA_KEY——服务面必须覆盖)
64
- out["keyCheck"] = net.probe_key(req_key)
65
- elif net.JAVA_KEY:
66
- # 主动探针(devkit auth init 真调 IAM 的廉价版):用户问"key 好没好"有确定答案
67
- out["keyCheck"] = net.probe_key()
68
- if net._explicit_key():
69
- # 旧版残留凭据检测位(评审拍板项):显式 key 存活即在位提示自愈路径,
70
- # 不等提交撞 401 才发现(codex 0.2.3 残留 key 挡匿名链的实锤教训)
71
- out["legacyKeyHint"] = net._legacy_key_hint()
72
- if not net.JAVA_KEY and not req_key:
73
- out["guidance"] = net._KEY_GUIDANCE
74
- out["tokenReady"] = "首次提交时将自动申请匿名令牌(零字段,日限额低)"
75
- return out
76
-
77
-
78
- def check_update(params: dict, client_info: dict | None = None) -> dict:
79
- from vod_mcp import update_check as uc
80
- return uc.check(params)
package/vod_mcp/paths.py DELETED
@@ -1,38 +0,0 @@
1
- """根定位单一真源(P1)。
2
-
3
- 此前有 11 处各自用 `Path(__file__).resolve().parent.parent` 反推仓库根:
4
- tools / server / skills_registry / policy / provenance / hosts /
5
- transport_remote / payload / host_adapters.base / bin。分散的代价不是不好看,
6
- 而是“想挪文件”本身有成本——每挪一个模块都要重算相对深度,于是没人敢动目录。
7
-
8
- 三种根形态必须同时成立(都已实测):
9
- ① 仓内直跑:ROOT = 仓库根(vod_mcp 的父目录)
10
- ② 载荷:~/.vod-devkit/payloads/<ver>/(payload.stage 固化,含 vod_mcp 与资源)
11
- ③ 插件副本:plugins/vod-devkit/(宿主隔离安装的独立根,资源随包携带)
12
- 三者的共同点:`<ROOT>/vod_mcp/`、`<ROOT>/contract/`、`<ROOT>/safety/`、`<ROOT>/skills/`
13
- 都在同一层。所以“ROOT = vod_mcp 的父目录”这个算式对三者都成立——前提是这三份
14
- 形态都真的把资源带齐(插件副本此前缺 contract/safety,靠本提交补齐)。
15
-
16
- 环境变量优先是为了把隐式相对路径变成显式契约:宿主在隔离安装里把插件目录整块
17
- 拷走时,可以在启动配置里声明 VOD_DEVKIT_ROOT,而不是赌 __file__ 的深度。
18
- """
19
- import os
20
- from pathlib import Path
21
-
22
- # 物理默认根:本包目录的父目录。不读环境变量,供 sys.path 自举等“必须物理正确”
23
- # 的场合使用(见 server.py 的 bootstrap)。
24
- DEFAULT_ROOT = Path(__file__).resolve().parent.parent
25
-
26
-
27
- def root() -> Path:
28
- """运行期根:环境变量优先,物理位置兜底。"""
29
- env = os.environ.get("VOD_DEVKIT_ROOT")
30
- return Path(env).expanduser().resolve() if env else DEFAULT_ROOT
31
-
32
-
33
- ROOT = root()
34
- SKILLS = ROOT / "skills"
35
- CONTRACT = ROOT / "contract" / "tools.schema.json"
36
- POLICY = ROOT / "safety" / "policy.json"
37
- INSTALL_MANIFEST = ROOT / "install-manifest.json"
38
- RUNTIME_JSON = ROOT / "vod_mcp" / "runtime.json"