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.
- package/CHANGELOG.md +58 -0
- package/QUICKSTART.md +6 -2
- package/README.en.md +23 -2
- package/README.md +204 -16
- package/{contract → assets/contract}/tools.schema.json +127 -1
- package/{skills → assets/skills}/vod-core/SKILL.md +32 -1
- package/bin/vod-devkit +21 -1
- package/integrations/hermes/hooks/vod_guard.py +127 -0
- package/integrations/hermes/hooks/vod_router.py +89 -0
- package/integrations/hermes/host.json +4 -1
- package/npm/cli.js +6 -1
- package/package.json +37 -34
- package/packages/dsh/README.md +60 -0
- package/packages/dsh/package.json +52 -0
- package/plugins/vod-devkit/.codex-plugin/plugin.json +1 -1
- package/plugins/vod-devkit/.mcp.json +2 -0
- package/plugins/vod-devkit/build-info.json +3 -3
- package/plugins/vod-devkit/contract/tools.schema.json +127 -1
- package/plugins/vod-devkit/hooks/vod_guard.py +127 -0
- package/plugins/vod-devkit/hooks/vod_router.py +89 -0
- package/plugins/vod-devkit/skills/vod-core/SKILL.md +32 -1
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/plugins/vod-devkit/vod_mcp/attribution.py +21 -2
- package/plugins/vod-devkit/vod_mcp/config_forms.py +22 -6
- package/plugins/vod-devkit/vod_mcp/diagnose.py +4 -2
- package/plugins/vod-devkit/vod_mcp/host_adapters/base.py +4 -1
- package/plugins/vod-devkit/vod_mcp/host_adapters/codex.py +154 -34
- package/plugins/vod-devkit/vod_mcp/host_adapters/dsh.py +133 -22
- package/plugins/vod-devkit/vod_mcp/host_adapters/hermes.py +216 -59
- package/plugins/vod-devkit/vod_mcp/host_adapters/opencode.py +10 -4
- package/plugins/vod-devkit/vod_mcp/hosts.py +4 -0
- package/plugins/vod-devkit/vod_mcp/net.py +78 -18
- package/plugins/vod-devkit/vod_mcp/packs/__init__.py +97 -22
- package/plugins/vod-devkit/vod_mcp/packs/collect.py +50 -42
- package/plugins/vod-devkit/vod_mcp/packs/core.py +138 -2
- package/plugins/vod-devkit/vod_mcp/paths.py +200 -30
- package/plugins/vod-devkit/vod_mcp/payload.py +10 -5
- package/plugins/vod-devkit/vod_mcp/provenance.py +1 -1
- package/plugins/vod-devkit/vod_mcp/remote_app.py +4 -4
- package/plugins/vod-devkit/vod_mcp/runtime_state.py +151 -28
- package/plugins/vod-devkit/vod_mcp/server.py +52 -7
- package/plugins/vod-devkit/vod_mcp/skills_registry.py +29 -8
- package/plugins/vod-devkit/vod_mcp/tools.py +21 -3
- package/plugins/vod-devkit/vod_mcp/transport_remote.py +22 -3
- package/{vod_mcp → src/vod_mcp}/__init__.py +1 -1
- package/{vod_mcp → src/vod_mcp}/attribution.py +21 -2
- package/{vod_mcp → src/vod_mcp}/config_forms.py +22 -6
- package/{vod_mcp → src/vod_mcp}/diagnose.py +4 -2
- package/{vod_mcp → src/vod_mcp}/host_adapters/base.py +4 -1
- package/{vod_mcp → src/vod_mcp}/host_adapters/codex.py +154 -34
- package/{vod_mcp → src/vod_mcp}/host_adapters/dsh.py +133 -22
- package/src/vod_mcp/host_adapters/hermes.py +361 -0
- package/{vod_mcp → src/vod_mcp}/host_adapters/opencode.py +10 -4
- package/{vod_mcp → src/vod_mcp}/hosts.py +4 -0
- package/{vod_mcp → src/vod_mcp}/net.py +78 -18
- package/src/vod_mcp/packs/__init__.py +142 -0
- package/{vod_mcp → src/vod_mcp}/packs/collect.py +50 -42
- package/src/vod_mcp/packs/core.py +216 -0
- package/src/vod_mcp/paths.py +208 -0
- package/{vod_mcp → src/vod_mcp}/payload.py +10 -5
- package/{vod_mcp → src/vod_mcp}/provenance.py +1 -1
- package/{vod_mcp → src/vod_mcp}/remote_app.py +4 -4
- package/{vod_mcp → src/vod_mcp}/runtime_state.py +151 -28
- package/{vod_mcp → src/vod_mcp}/server.py +52 -7
- package/{vod_mcp → src/vod_mcp}/skills_registry.py +29 -8
- package/{vod_mcp → src/vod_mcp}/tools.py +21 -3
- package/{vod_mcp → src/vod_mcp}/transport_remote.py +22 -3
- package/src/vodkit_cli/auth_cmd.py +81 -0
- package/{vodkit_cli → src/vodkit_cli}/cli.py +38 -8
- package/{vodkit_cli → src/vodkit_cli}/common.py +14 -3
- package/{vodkit_cli → src/vodkit_cli}/doctor.py +147 -9
- package/{vodkit_cli → src/vodkit_cli}/install.py +148 -33
- package/src/vodkit_cli/packs_cmd.py +329 -0
- package/{vodkit_cli → src/vodkit_cli}/remote.py +3 -3
- package/src/vodkit_cli/uninstall.py +315 -0
- package/vod_mcp/host_adapters/__pycache__/__init__.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/__init__.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/atomcode.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/atomcode.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/base.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/base.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codearts.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codearts.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codeartswork.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codeartswork.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codex.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codex.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codex_desktop.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codex_desktop.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/dsh.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/dsh.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/generic.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/generic.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/hermes.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/hermes.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/opencode.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/opencode.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/workbuddy.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/workbuddy.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/hermes.py +0 -204
- package/vod_mcp/packs/__init__.py +0 -67
- package/vod_mcp/packs/__pycache__/__init__.cpython-314.pyc +0 -0
- package/vod_mcp/packs/__pycache__/__init__.cpython-39.pyc +0 -0
- package/vod_mcp/packs/__pycache__/collect.cpython-314.pyc +0 -0
- package/vod_mcp/packs/__pycache__/collect.cpython-39.pyc +0 -0
- package/vod_mcp/packs/__pycache__/core.cpython-314.pyc +0 -0
- package/vod_mcp/packs/__pycache__/core.cpython-39.pyc +0 -0
- package/vod_mcp/packs/__pycache__/knowledge.cpython-314.pyc +0 -0
- package/vod_mcp/packs/__pycache__/knowledge.cpython-39.pyc +0 -0
- package/vod_mcp/packs/core.py +0 -80
- package/vod_mcp/paths.py +0 -38
- package/vodkit_cli/__pycache__/__init__.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/__init__.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/cli.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/cli.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/common.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/common.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/doctor.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/doctor.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/install.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/install.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/remote.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/remote.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/uninstall.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/uninstall.cpython-39.pyc +0 -0
- package/vodkit_cli/__pycache__/update.cpython-314.pyc +0 -0
- package/vodkit_cli/__pycache__/update.cpython-39.pyc +0 -0
- package/vodkit_cli/uninstall.py +0 -161
- /package/{safety → assets/safety}/policy.json +0 -0
- /package/{skills → assets/skills}/vod-core/references/acceptance-criteria.md +0 -0
- /package/{skills → assets/skills}/vod-core/references/verification-method.md +0 -0
- /package/{skills → assets/skills}/vod-feedback-collect/SKILL.md +0 -0
- /package/{skills → assets/skills}/vod-feedback-collect/references/acceptance-criteria.md +0 -0
- /package/{skills → assets/skills}/vod-feedback-collect/references/verification-method.md +0 -0
- /package/{skills → assets/skills}/vod-problem-classification-rules/SKILL.md +0 -0
- /package/{skills → assets/skills}/vod-scoring-rules/SKILL.md +0 -0
- /package/{vod_mcp → src/vod_mcp}/detect_framework.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/guardrails.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/__init__.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/atomcode.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/codearts.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/codeartswork.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/codex_desktop.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/generic.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/host_adapters/workbuddy.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/packs/knowledge.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/pending.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/policy.py +0 -0
- /package/{vod_mcp → src/vod_mcp}/runtime.example.json +0 -0
- /package/{vod_mcp → src/vod_mcp}/update_check.py +0 -0
- /package/{vodkit_cli → src/vodkit_cli}/__init__.py +0 -0
- /package/{vodkit_cli → src/vodkit_cli}/update.py +0 -0
|
@@ -5,10 +5,14 @@
|
|
|
5
5
|
本模块只依赖 paths 与 stdlib;需要身份(net._eff_key)时**函数内懒导入**,避免
|
|
6
6
|
net ↔ runtime_state 的循环。
|
|
7
7
|
"""
|
|
8
|
+
import datetime
|
|
8
9
|
import json
|
|
9
10
|
import os
|
|
11
|
+
import shutil
|
|
10
12
|
import stat
|
|
13
|
+
import sys
|
|
11
14
|
import threading
|
|
15
|
+
from contextlib import contextmanager
|
|
12
16
|
from pathlib import Path
|
|
13
17
|
|
|
14
18
|
from vod_mcp import attribution as _attrib
|
|
@@ -19,7 +23,9 @@ _RT_LOCK = threading.RLock()
|
|
|
19
23
|
|
|
20
24
|
|
|
21
25
|
def _runtime_path() -> Path:
|
|
22
|
-
|
|
26
|
+
# D-token-machine-1:机器级 state(跨版本/跨宿主一份);每次现读,
|
|
27
|
+
# 长驻进程不冻结(D-state-read-1 的同一条纪律:常量会把"换了 key/搬了目录"冻住)
|
|
28
|
+
return paths.runtime_json_path()
|
|
23
29
|
|
|
24
30
|
|
|
25
31
|
def _runtime_cfg() -> dict:
|
|
@@ -38,37 +44,110 @@ _RT = _runtime_cfg()
|
|
|
38
44
|
|
|
39
45
|
|
|
40
46
|
def _runtime_update(update: dict, replace: bool = False) -> None:
|
|
41
|
-
"""
|
|
47
|
+
"""更新运行期状态:落盘(事务内)→ 内存镜像。
|
|
42
48
|
|
|
49
|
+
落盘的锁由 `_runtime_atomic` 持(嵌套持锁会让 flock 在同一文件上二次加锁而
|
|
50
|
+
死锁——同一进程两个 fd 互斥);镜像只服务本进程,用 _RT_LOCK 单独保护。
|
|
43
51
|
replace=False 时按单参调用 _save_runtime:测试桩普遍是 `lambda u: ...`
|
|
44
52
|
(历史签名),多传一个默认值会把所有桩打红——签名兼容性属于接口契约。
|
|
45
53
|
"""
|
|
54
|
+
if replace:
|
|
55
|
+
_save_runtime(update, replace=True)
|
|
56
|
+
else:
|
|
57
|
+
_save_runtime(update)
|
|
46
58
|
with _RT_LOCK:
|
|
47
|
-
if replace:
|
|
48
|
-
_save_runtime(update, replace=True)
|
|
49
|
-
else:
|
|
50
|
-
_save_runtime(update)
|
|
51
59
|
if replace:
|
|
52
60
|
_RT.clear()
|
|
53
61
|
_RT.update(update)
|
|
54
62
|
|
|
55
63
|
|
|
56
|
-
def
|
|
57
|
-
"""
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
64
|
+
def _lock_path() -> Path:
|
|
65
|
+
"""跨进程锁文件(与 runtime.json 同目录、同名前缀,便于 --clean-global 认出来)。"""
|
|
66
|
+
p = _runtime_path()
|
|
67
|
+
return p.with_name(p.name + ".lock")
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
@contextmanager
|
|
71
|
+
def _file_lock():
|
|
72
|
+
"""跨进程互斥:同一份载荷 runtime.json 被同一台机器上多个宿主的 server 进程共用。
|
|
73
|
+
|
|
74
|
+
`_RT_LOCK` 只保护**进程内**;多进程同时"读→改→写"会互相覆盖(实测:4 进程各写
|
|
75
|
+
25 次,落盘只剩 36 条;`pending.py` 那条低价值补交队列反而是原子的)。
|
|
76
|
+
POSIX 用 `fcntl.flock`;没有 fcntl 的平台退化为空上下文——那里没有对等的成熟机制,
|
|
77
|
+
硬造一个只会引入新故障,README 按"仅 POSIX 覆盖"标注。
|
|
78
|
+
"""
|
|
79
|
+
try:
|
|
80
|
+
import fcntl
|
|
81
|
+
except ImportError: # pragma: no cover - Windows
|
|
82
|
+
yield
|
|
83
|
+
return
|
|
84
|
+
p = _lock_path()
|
|
85
|
+
try:
|
|
86
|
+
p.parent.mkdir(parents=True, exist_ok=True)
|
|
87
|
+
f = open(p, "a+", encoding="utf-8")
|
|
88
|
+
except OSError: # 锁不可用不该让写入失败(宁可有竞态也不要写不进)
|
|
89
|
+
yield
|
|
90
|
+
return
|
|
91
|
+
try:
|
|
92
|
+
fcntl.flock(f.fileno(), fcntl.LOCK_EX)
|
|
93
|
+
yield
|
|
94
|
+
finally:
|
|
95
|
+
try:
|
|
96
|
+
fcntl.flock(f.fileno(), fcntl.LOCK_UN)
|
|
97
|
+
finally:
|
|
98
|
+
f.close()
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
def _quarantine_bad_runtime(p: Path, err: Exception) -> Path | None:
|
|
102
|
+
"""坏文件**先备份再继续**,绝不静默丢弃。
|
|
103
|
+
|
|
104
|
+
为什么不选"拒绝覆盖":那会让插件在坏文件之后完全不能提交/记账(用户看到的是
|
|
105
|
+
"插件坏了"),而备份已经保住可恢复性。备份名带时间戳,告警里给绝对路径。
|
|
106
|
+
"""
|
|
107
|
+
ts = datetime.datetime.now().strftime("%Y%m%d-%H%M%S")
|
|
108
|
+
dst = p.with_name(f"{p.name}.corrupt-{ts}")
|
|
109
|
+
try:
|
|
110
|
+
shutil.copy2(p, dst)
|
|
111
|
+
except OSError as e:
|
|
112
|
+
msg = f"runtime.json 解析失败({err})且备份失败({e})——本次以空状态继续"
|
|
113
|
+
_warn(msg)
|
|
114
|
+
print(f"[vod-devkit] warn: {msg}", file=sys.stderr)
|
|
115
|
+
return None
|
|
116
|
+
msg = (f"runtime.json 解析失败({err}):原文件已备份到 {dst},"
|
|
117
|
+
"本次以空状态继续(可人工核对/恢复)")
|
|
118
|
+
_warn(msg)
|
|
119
|
+
# 这份文件里有 key 与账本:宿主必须当场看到(stdio 面的 stderr 会透给用户),
|
|
120
|
+
# 只写 /tmp 日志等于没有告警。
|
|
121
|
+
print(f"[vod-devkit] warn: {msg}", file=sys.stderr)
|
|
122
|
+
return dst
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def _read_cfg_unlocked(p: Path) -> dict:
|
|
126
|
+
"""锁内读(调用方已持 _RT_LOCK + 文件锁)。坏文件先备份再继续。"""
|
|
127
|
+
if not p.exists():
|
|
128
|
+
return {}
|
|
129
|
+
try:
|
|
130
|
+
return json.loads(p.read_text(encoding="utf-8"))
|
|
131
|
+
except Exception as e: # noqa: BLE001 坏文件:备份后继续
|
|
132
|
+
_quarantine_bad_runtime(p, e)
|
|
133
|
+
return {}
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
def _write_cfg_unlocked(p: Path, cfg: dict) -> None:
|
|
137
|
+
"""锁内原子写:tmp → chmod 0600 → os.replace。"""
|
|
138
|
+
tmp = p.with_name(p.name + ".tmp")
|
|
139
|
+
tmp.write_text(json.dumps(cfg, ensure_ascii=False, indent=2), encoding="utf-8")
|
|
140
|
+
try:
|
|
141
|
+
os.chmod(tmp, 0o600) # 先给权限再替换,不留 0644 窗口
|
|
142
|
+
except OSError:
|
|
143
|
+
pass
|
|
144
|
+
os.replace(tmp, p)
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
def _verify_perms(p: Path) -> None:
|
|
148
|
+
"""S1 式写后验(借 huaweicloud-devkit ensurePrivateMode 模式):chmod 0600 并 stat
|
|
149
|
+
回验——不假设 chmod 按文档工作(WSL/drvfs 会静默忽略),验的是效果不是动作;
|
|
150
|
+
runtime.json 含 java_key 明文,权限失效必须告警。"""
|
|
72
151
|
try:
|
|
73
152
|
os.chmod(p, 0o600)
|
|
74
153
|
mode = stat.S_IMODE(os.stat(p).st_mode)
|
|
@@ -79,6 +158,41 @@ def _save_runtime(update: dict, replace: bool = False) -> None:
|
|
|
79
158
|
_warn(f"runtime.json 权限校验失败:{e}")
|
|
80
159
|
|
|
81
160
|
|
|
161
|
+
def _runtime_atomic(mutate) -> dict:
|
|
162
|
+
"""**事务式读改写**:进程内 RLock + 跨进程 flock 一起持,读 → mutate → 原子写。
|
|
163
|
+
|
|
164
|
+
为什么必须是事务(2026-11-16 第二轮评审实测):只给"写"上锁不够。调用方若在锁外
|
|
165
|
+
`_runtime_cfg()` 读到整份 submissions、再在锁内整键覆盖,后写者会盖掉先写者——
|
|
166
|
+
4 进程各 25 条账本只剩 40-53 条。凡是"读整键→改→写整键"的路径都必须走这里。
|
|
167
|
+
|
|
168
|
+
mutate(cfg) 返回 False 表示"不改、不用落盘"(例如账本被 local_ledger=false 关闭)。
|
|
169
|
+
返回最终落盘的 cfg 快照(调用方可据此更新内存镜像)。
|
|
170
|
+
"""
|
|
171
|
+
p = _runtime_path()
|
|
172
|
+
with _RT_LOCK:
|
|
173
|
+
p.parent.mkdir(parents=True, exist_ok=True)
|
|
174
|
+
with _file_lock():
|
|
175
|
+
cfg = _read_cfg_unlocked(p)
|
|
176
|
+
if mutate(cfg) is not False:
|
|
177
|
+
_write_cfg_unlocked(p, cfg)
|
|
178
|
+
_verify_perms(p)
|
|
179
|
+
return cfg
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
def _save_runtime(update: dict, replace: bool = False) -> None:
|
|
183
|
+
"""原子差分更新(公共 API):把 update 合并进现有 cfg。
|
|
184
|
+
|
|
185
|
+
内部整段持锁(进程内 + 跨进程),所以"不同顶层键"的并发更新不会互相覆盖。
|
|
186
|
+
需要"读整键→改→写整键"的调用方**不要**用它(那会丢失并发新增),改走
|
|
187
|
+
`_runtime_atomic(mutate)`。
|
|
188
|
+
"""
|
|
189
|
+
def _mutate(cfg: dict) -> None:
|
|
190
|
+
if replace:
|
|
191
|
+
cfg.clear()
|
|
192
|
+
cfg.update(update)
|
|
193
|
+
_runtime_atomic(_mutate)
|
|
194
|
+
|
|
195
|
+
|
|
82
196
|
def _log(line: str, path: str = "/tmp/vod_mcp_server.log") -> None:
|
|
83
197
|
"""统一日志出口,1MB 截断轮转
|
|
84
198
|
(D-key-guard-3⑤:客户机长期运行防无限增长;截断保留尾部近期日志)。"""
|
|
@@ -128,6 +242,13 @@ def _ensure_first_boot(rt_path: Path | None = None) -> dict:
|
|
|
128
242
|
自动清零伤害半径为零,拒启会把误判放大成全功能瘫痪。
|
|
129
243
|
firstBootAt 首启写入,此后不再触发(防误伤正常运行中的安装)。"""
|
|
130
244
|
p = rt_path or _runtime_path()
|
|
245
|
+
if rt_path is None:
|
|
246
|
+
# D-token-machine-1 首启迁移:state 无 runtime 而旧版本目录有 → 复制一次
|
|
247
|
+
# (保留 install_nonce/key/账本,改造当天不重领令牌、不换设备锚点)
|
|
248
|
+
mig = paths.migrate_state_once()
|
|
249
|
+
if mig.get("migrated"):
|
|
250
|
+
_log(f"state migrated: {mig['from']} -> {_runtime_path()}")
|
|
251
|
+
p = _runtime_path()
|
|
131
252
|
if not p.exists():
|
|
132
253
|
return {"action": "none"}
|
|
133
254
|
try:
|
|
@@ -288,13 +409,15 @@ def _ledger_append(entries: list) -> None:
|
|
|
288
409
|
vod_list_submitted 随之不可用——留痕是可选项不是义务。"""
|
|
289
410
|
if not entries:
|
|
290
411
|
return
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
if
|
|
294
|
-
return
|
|
295
|
-
ledger = (
|
|
412
|
+
|
|
413
|
+
def _mutate(cfg: dict):
|
|
414
|
+
if cfg.get("local_ledger") is False:
|
|
415
|
+
return False # 企业数据驻留:账本关闭,不写也不改
|
|
416
|
+
ledger = (cfg.get(_LEDGER_KEY) or [])[-_LEDGER_CAP:]
|
|
296
417
|
ledger.extend(entries)
|
|
297
|
-
|
|
418
|
+
cfg[_LEDGER_KEY] = ledger[-_LEDGER_CAP:]
|
|
419
|
+
|
|
420
|
+
_runtime_atomic(_mutate) # 读整键 → 改 → 写整键 必须整段在锁内
|
|
298
421
|
|
|
299
422
|
|
|
300
423
|
_DRAFT_KEY = "drafts"
|
|
@@ -15,7 +15,19 @@ from pathlib import Path
|
|
|
15
15
|
# 其余所有资源路径一律走 vod_mcp/paths.py(含 VOD_DEVKIT_ROOT 覆盖)。
|
|
16
16
|
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
# 解释器版本 guard 必须在 import vod_mcp 之前:本模块与下游(tools/guardrails)
|
|
19
|
+
# 的注解用了 PEP 604(`dict | None`),在 3.9 上会在 def 求值时抛 TypeError
|
|
20
|
+
# traceback——那是"响失败"但不可读。一行 guard 把残余风险变成可读诊断。
|
|
21
|
+
if sys.version_info < (3, 10):
|
|
22
|
+
sys.stderr.write(
|
|
23
|
+
"[vod-devkit] MCP server 需要 Python >= 3.10(当前 %d.%d)。\n"
|
|
24
|
+
" 插件 .mcp.json 的 command 若走 PATH 上的 python3,请指向 3.10+ 解释器"
|
|
25
|
+
"(如 /usr/bin/python3.12),\n"
|
|
26
|
+
" 或重跑安装器由它用本机 3.10+ 解释器重写该文件。\n"
|
|
27
|
+
% sys.version_info[:2])
|
|
28
|
+
sys.exit(2)
|
|
29
|
+
|
|
30
|
+
from vod_mcp import guardrails, packs, runtime_state, skills_registry, tools # noqa: E402
|
|
19
31
|
|
|
20
32
|
_PROTOCOL_VERSION = "2025-06-18"
|
|
21
33
|
_client_info = {}
|
|
@@ -29,10 +41,11 @@ def _error(req_id, code, message):
|
|
|
29
41
|
return {"jsonrpc": "2.0", "id": req_id, "error": {"code": code, "message": message}}
|
|
30
42
|
|
|
31
43
|
|
|
32
|
-
def handle(message: dict, client_info: dict | None = None) -> dict | None:
|
|
44
|
+
def handle(message: dict, client_info: dict | None = None) -> dict | list | None:
|
|
33
45
|
"""JSON-RPC 分派(两面共用:stdio 逐行调用;HTTP 面每请求调用一次)。
|
|
34
46
|
|
|
35
47
|
client_info 由传输层提供(HTTP 面=固定标识 + 认证形态,stdio 面=握手自报)。
|
|
48
|
+
返回 list 时=一条响应后跟通知(当前只有 tools/list_changed 这一处)。
|
|
36
49
|
"""
|
|
37
50
|
method = message.get("method", "")
|
|
38
51
|
req_id = message.get("id")
|
|
@@ -41,7 +54,9 @@ def handle(message: dict, client_info: dict | None = None) -> dict | None:
|
|
|
41
54
|
_client_info = client_info or (message.get("params") or {}).get("clientInfo") or {}
|
|
42
55
|
return _result(req_id, {
|
|
43
56
|
"protocolVersion": _PROTOCOL_VERSION,
|
|
44
|
-
|
|
57
|
+
# listChanged:会话内开关(vod_packs_configure)改工具面后由服务端推
|
|
58
|
+
# notifications/tools/list_changed;不声明的话合规客户端不会重拉 tools/list。
|
|
59
|
+
"capabilities": {"tools": {"listChanged": True}},
|
|
45
60
|
"instructions": (
|
|
46
61
|
"vod-devkit 采集资产与纪律:技能 vod-feedback-collect 处理用户对"
|
|
47
62
|
"本产品的不满/建议/期望(触发词:慢/报错/体验差/希望支持/提单等)。"
|
|
@@ -50,6 +65,13 @@ def handle(message: dict, client_info: dict | None = None) -> dict | None:
|
|
|
50
65
|
"禁止改写、概括、增删字词。product 归因:原话唯一命中可直接用;"
|
|
51
66
|
"未命中或多产品歧义时必须问用户一次\"这条是哪个产品的反馈\","
|
|
52
67
|
"回答填 product;用户说不知道就告知他缺产品不能提交,不要猜。不许不填直接提交。"
|
|
68
|
+
# 技能读取教法(对齐 devkit 的"动作优先"):树路径在 initialize 就给,
|
|
69
|
+
# 让 agent 不必先调目录工具;先直读、被拒再回落、不反复请求。
|
|
70
|
+
" 技能树:" + str(skills_registry.SKILLS_ROOT)
|
|
71
|
+
+ "(本机路径)。读法=动作优先:先直接读 "
|
|
72
|
+
"skillRoot/<技能名>/SKILL.md(尝试本身即可达性检查,不做预判);"
|
|
73
|
+
"被拒或读取失败才用 vod_retrieve_skill 取全文(无需文件权限),"
|
|
74
|
+
"绝不反复请求。"
|
|
53
75
|
),
|
|
54
76
|
"serverInfo": {
|
|
55
77
|
"name": "vod-devkit",
|
|
@@ -71,11 +93,17 @@ def handle(message: dict, client_info: dict | None = None) -> dict | None:
|
|
|
71
93
|
return _error(req_id, code, msg)
|
|
72
94
|
try:
|
|
73
95
|
out = tools.dispatch(name, args, _client_info)
|
|
74
|
-
|
|
96
|
+
resp = _result(req_id, {
|
|
75
97
|
"content": [{"type": "text", "text": json.dumps(out, ensure_ascii=False)}],
|
|
76
98
|
"structuredContent": out,
|
|
77
99
|
"isError": False,
|
|
78
100
|
})
|
|
101
|
+
# 会话内开关改了工具面 → 按 MCP 规范推通知(stdio 面只有这一处增量输出;
|
|
102
|
+
# 远程面每请求现造 server 无会话,该工具已在 REMOTE_WITHHELD 里摘除)
|
|
103
|
+
if name == "vod_packs_configure" and isinstance(out, dict) and out.get("changed"):
|
|
104
|
+
return [resp, {"jsonrpc": "2.0",
|
|
105
|
+
"method": "notifications/tools/list_changed"}]
|
|
106
|
+
return resp
|
|
79
107
|
except tools.ToolError as e:
|
|
80
108
|
return _error(req_id, e.code, str(e))
|
|
81
109
|
if req_id is not None:
|
|
@@ -93,6 +121,10 @@ def _consume_payload_marker() -> None:
|
|
|
93
121
|
|
|
94
122
|
|
|
95
123
|
def main():
|
|
124
|
+
# 入口显式设根(宿主直接按脚本路径拉起时,这里就是"入口")
|
|
125
|
+
from vod_mcp import paths as _paths
|
|
126
|
+
os.environ.setdefault("VOD_DEVKIT_SRC_ROOT", str(_paths.SRC_ROOT))
|
|
127
|
+
os.environ.setdefault("VOD_DEVKIT_DIST_ROOT", str(_paths.DIST_ROOT))
|
|
96
128
|
_consume_payload_marker()
|
|
97
129
|
import argparse
|
|
98
130
|
ap = argparse.ArgumentParser(prog="vod-mcp-server",
|
|
@@ -102,8 +134,19 @@ def main():
|
|
|
102
134
|
"一个进程服务多个 agent)")
|
|
103
135
|
ap.add_argument("--port", type=int, default=9528, help="remote 端口(默认 9528)")
|
|
104
136
|
ap.add_argument("--host", default="127.0.0.1", help="remote 绑定地址(默认回环)")
|
|
137
|
+
ap.add_argument("--allow-anon-mint", action="store_true",
|
|
138
|
+
help="非回环绑定时仍允许服务端代领匿名令牌(默认关闭;"
|
|
139
|
+
"单机可信网络才开,见 D-token-machine-1)")
|
|
105
140
|
args, _unknown = ap.parse_known_args()
|
|
106
141
|
|
|
142
|
+
# VOD_PACKS 未知 id 启动即报错(D-packs-config-1,对齐 devkit 口径):
|
|
143
|
+
# 静默过滤会让"配了"和"生效"分叉,排障时没人能看出是拼写错还是没装。
|
|
144
|
+
try:
|
|
145
|
+
packs.enabled_packs()
|
|
146
|
+
except packs.UnknownPack as e:
|
|
147
|
+
print(f"[vod-devkit] {e}", file=sys.stderr)
|
|
148
|
+
sys.exit(2)
|
|
149
|
+
|
|
107
150
|
# 启动自诊(排障:写 /tmp,宿主过滤环境变量时可观察实际 env)
|
|
108
151
|
try:
|
|
109
152
|
runtime_state._ensure_first_boot() # D-key-guard-3①:首启标记+构建机残留清理(preset 兜底)
|
|
@@ -121,7 +164,7 @@ def main():
|
|
|
121
164
|
" pip install 'vod-devkit[remote]' # 或 pip install 'mcp>=1.0'\n"
|
|
122
165
|
f"(stdio 形态不需要任何第三方依赖;导入失败:{e})", file=sys.stderr)
|
|
123
166
|
sys.exit(2)
|
|
124
|
-
sys.exit(transport_remote.serve(args.host, args.port))
|
|
167
|
+
sys.exit(transport_remote.serve(args.host, args.port, args.allow_anon_mint))
|
|
125
168
|
|
|
126
169
|
for line in sys.stdin:
|
|
127
170
|
line = line.strip()
|
|
@@ -133,8 +176,10 @@ def main():
|
|
|
133
176
|
resp = _error(None, -32700, "解析错误")
|
|
134
177
|
else:
|
|
135
178
|
resp = handle(message)
|
|
136
|
-
if resp is not None
|
|
137
|
-
|
|
179
|
+
out_msgs = resp if isinstance(resp, list) else ([resp] if resp is not None else [])
|
|
180
|
+
for m in out_msgs:
|
|
181
|
+
sys.stdout.write(json.dumps(m, ensure_ascii=False) + "\n")
|
|
182
|
+
if out_msgs:
|
|
138
183
|
sys.stdout.flush()
|
|
139
184
|
|
|
140
185
|
|
|
@@ -68,25 +68,46 @@ def _server_face() -> bool:
|
|
|
68
68
|
|
|
69
69
|
|
|
70
70
|
def list_skills(params: dict) -> dict:
|
|
71
|
-
"""列出可披露的技能(元技能一并列出,标出 pack 与是否原生安装)。
|
|
71
|
+
"""列出可披露的技能(元技能一并列出,标出 pack 与是否原生安装)。
|
|
72
|
+
|
|
73
|
+
字段对齐 devkit 的技能目录:name/description/version/引用文件名,外加
|
|
74
|
+
skillRoot 与每个技能的绝对路径——**只在 stdio 面给**(远程面不给服务器本机路径)。
|
|
75
|
+
给路径的目的不是装饰:教法是"动作优先",agent 先按路径直读 SKILL.md
|
|
76
|
+
(尝试本身即可达性检查),读不到才回落 vod_retrieve_skill,绝不反复请求。
|
|
77
|
+
"""
|
|
72
78
|
from vod_mcp import packs
|
|
73
|
-
enabled = set(packs.
|
|
79
|
+
enabled = set(packs.effective_packs())
|
|
74
80
|
items = []
|
|
75
81
|
for d in _skill_dirs():
|
|
76
82
|
text = (d / "SKILL.md").read_text(encoding="utf-8")
|
|
77
83
|
meta = _frontmatter(text)
|
|
78
84
|
pack = SKILL_PACK.get(d.name, "core")
|
|
79
|
-
|
|
85
|
+
item = {
|
|
80
86
|
"name": d.name,
|
|
81
87
|
"pack": pack,
|
|
82
88
|
"enabled": pack in enabled,
|
|
83
89
|
"native": d.name in META_SKILLS,
|
|
84
90
|
"description": meta.get("description", ""),
|
|
85
91
|
"chars": len(text),
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
"
|
|
89
|
-
|
|
92
|
+
}
|
|
93
|
+
if meta.get("version"):
|
|
94
|
+
item["version"] = meta["version"]
|
|
95
|
+
refs = sorted(p.name for p in (d / "references").glob("*")
|
|
96
|
+
if p.is_file()) if (d / "references").is_dir() else []
|
|
97
|
+
if refs:
|
|
98
|
+
item["references"] = refs
|
|
99
|
+
if not _server_face():
|
|
100
|
+
item["path"] = str(d / "SKILL.md")
|
|
101
|
+
items.append(item)
|
|
102
|
+
out = {"skills": items, "packs": sorted(enabled),
|
|
103
|
+
"note": "领域规则技能用 vod_retrieve_skill 取全文;元技能由宿主原生"
|
|
104
|
+
"加载,只在本工具里列名以便路由。"}
|
|
105
|
+
if not _server_face():
|
|
106
|
+
out["skillRoot"] = str(SKILLS_ROOT)
|
|
107
|
+
out["readHint"] = ("动作优先:先直接读 skillRoot/<name>/SKILL.md(尝试本身"
|
|
108
|
+
"即可达性检查,不做预判);被拒/失败才回落 vod_retrieve_skill,"
|
|
109
|
+
"绝不反复请求。")
|
|
110
|
+
return out
|
|
90
111
|
|
|
91
112
|
|
|
92
113
|
def retrieve_skill(params: dict) -> dict:
|
|
@@ -101,7 +122,7 @@ def retrieve_skill(params: dict) -> dict:
|
|
|
101
122
|
known = [p.name for p in _skill_dirs()]
|
|
102
123
|
raise SkillError(f"未知技能 {name!r};可用:{'、'.join(known)}", -32602)
|
|
103
124
|
pack = SKILL_PACK.get(name, "core")
|
|
104
|
-
enabled = set(packs.
|
|
125
|
+
enabled = set(packs.effective_packs())
|
|
105
126
|
if pack not in enabled:
|
|
106
127
|
raise SkillError(
|
|
107
128
|
f"技能 {name} 属于 {pack} pack,当前安装未启用(VOD_PACKS="
|
|
@@ -46,15 +46,33 @@ _HANDLERS = {
|
|
|
46
46
|
"vod_list_submitted": collect.list_submitted,
|
|
47
47
|
"vod_devkit_info": core.devkit_info,
|
|
48
48
|
"vod_auth_status": core.auth_status,
|
|
49
|
+
"vod_auth_ensure": core.auth_ensure,
|
|
50
|
+
"vod_packs_configure": core.packs_configure,
|
|
49
51
|
"vod_draft_voices": collect.draft_voices,
|
|
50
52
|
"vod_commit_voices": collect.commit_voices,
|
|
51
53
|
}
|
|
52
54
|
|
|
53
55
|
|
|
56
|
+
def _needs_client_info(handler) -> bool:
|
|
57
|
+
"""handler 是否吃 client_info(按签名判,不靠手写清单)。
|
|
58
|
+
|
|
59
|
+
为什么不用元组白名单:新增双参 handler 忘登记时**静默收到 None**,宿主归因/
|
|
60
|
+
设备标识这类字段就丢了,不报错也不告警(本次 vod_packs_configure 只因不吃
|
|
61
|
+
client_info 才没暴露)。签名判参把这类漏登记一次性消掉。
|
|
62
|
+
"""
|
|
63
|
+
import inspect
|
|
64
|
+
try:
|
|
65
|
+
params = list(inspect.signature(handler).parameters.values())
|
|
66
|
+
except (TypeError, ValueError): # 内建/不可反射:按单参处理(原行为)
|
|
67
|
+
return False
|
|
68
|
+
positional = [p for p in params
|
|
69
|
+
if p.kind in (p.POSITIONAL_ONLY, p.POSITIONAL_OR_KEYWORD)]
|
|
70
|
+
has_varargs = any(p.kind == p.VAR_POSITIONAL for p in params)
|
|
71
|
+
return has_varargs or len(positional) >= 2
|
|
72
|
+
|
|
73
|
+
|
|
54
74
|
def dispatch(name: str, params: dict, client_info: dict | None = None) -> dict:
|
|
55
75
|
handler = _HANDLERS.get(name)
|
|
56
76
|
if handler is None:
|
|
57
77
|
raise ToolError(f"未知工具: {name}", code=-32601)
|
|
58
|
-
|
|
59
|
-
collect.draft_voices, collect.commit_voices)
|
|
60
|
-
return handler(params, client_info) if needs_host else handler(params)
|
|
78
|
+
return handler(params, client_info) if _needs_client_info(handler) else handler(params)
|
|
@@ -16,8 +16,9 @@ devkit 的契约(mcp-server-remote.ts + test/remote-mcp-server.test.ts 实测
|
|
|
16
16
|
用一个小的 ASGI 适配层把 stdlib http.server 的请求转成 scope/receive/send。
|
|
17
17
|
协议处理仍然全部在 SDK 里,与 devkit 同源。
|
|
18
18
|
|
|
19
|
-
身份:请求头 Authorization: Bearer
|
|
20
|
-
|
|
19
|
+
身份:请求头 Authorization: Bearer *** 逐请求注入(见 tools._REQ_KEY),优先生效;
|
|
20
|
+
没有 Bearer 时与本地同链——由服务端领/复用**机器级匿名令牌**提交(同机独立部署的
|
|
21
|
+
默认形态,D-token-machine-1)。
|
|
21
22
|
"""
|
|
22
23
|
import asyncio
|
|
23
24
|
import json
|
|
@@ -329,10 +330,28 @@ class _Handler(BaseHTTPRequestHandler):
|
|
|
329
330
|
"error": {"code": -32603, "message": str(e)}})
|
|
330
331
|
|
|
331
332
|
|
|
332
|
-
def
|
|
333
|
+
def _apply_anon_mint_policy(host: str, allow: bool) -> bool:
|
|
334
|
+
"""按绑定地址决定是否允许服务端代领匿名令牌(返回是否开启)。
|
|
335
|
+
|
|
336
|
+
回环(同机独立部署的默认形态)→ 开启,与本地 stdio 一致;
|
|
337
|
+
非回环(可能经反代/公网触达)→ 默认关闭,需 `--allow-anon-mint` 显式开启。
|
|
338
|
+
理由:服务面无内建鉴权,代领 = 任何能连端口的进程都能用本机身份提交、消耗额度。
|
|
339
|
+
"""
|
|
340
|
+
from vod_mcp import net
|
|
341
|
+
enabled = (host in LOOPBACK) or bool(allow)
|
|
342
|
+
net.ANON_MINT_DISABLED = not enabled
|
|
343
|
+
return enabled
|
|
344
|
+
|
|
345
|
+
|
|
346
|
+
def serve(host: str, port: int, allow_anon_mint: bool = False) -> int:
|
|
347
|
+
anon = _apply_anon_mint_policy(host, allow_anon_mint)
|
|
333
348
|
if host not in LOOPBACK:
|
|
334
349
|
print(f"[vod-devkit] 警告:远程 MCP 绑定非回环地址 {host}——本进程无内建鉴权,"
|
|
335
350
|
"不要把它匿名暴露到公网;TLS 与身份校验应由反代承担。", file=sys.stderr)
|
|
351
|
+
if not anon:
|
|
352
|
+
print("[vod-devkit] 匿名令牌代领已关闭(非回环绑定):调用方须带 "
|
|
353
|
+
"Authorization: Bearer <key>;单机可信网络确需代领时加 --allow-anon-mint",
|
|
354
|
+
file=sys.stderr)
|
|
336
355
|
runtime = RemoteRuntime(host, port)
|
|
337
356
|
runtime.start()
|
|
338
357
|
httpd = ThreadingHTTPServer((host, port), _Handler)
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
"""auth 子命令:凭据的唯一写入入口(对齐 devkit `auth init` 的"单一入口"设计)。
|
|
2
|
+
|
|
3
|
+
为什么需要(D-auth-init-1):此前换 key 的唯一路径是"删 runtime.json 再重装"——
|
|
4
|
+
运维不可解释,也没人能回答"这台机器现在用的是哪把钥匙"。本命令把写 key 收成一个
|
|
5
|
+
入口,并把回显固定为**指纹**(绝不打印明文)。
|
|
6
|
+
|
|
7
|
+
优先级链(写进文档、也在这里实现):
|
|
8
|
+
环境变量 VOD_JAVA_API_KEY(平台/CI 注入,最高)
|
|
9
|
+
> runtime 里的显式 key(本命令写入)
|
|
10
|
+
> 匿名令牌自动领取(设备绑定,无 key 时首次提交或 vod_auth_ensure 时自动领)。
|
|
11
|
+
注意:真正的现读顺序在 net._live()(env 优先于 runtime,D-state-read-1),本命令
|
|
12
|
+
只负责"写入 runtime"这一条入口,不改变读取优先级。
|
|
13
|
+
"""
|
|
14
|
+
import sys
|
|
15
|
+
|
|
16
|
+
from vod_mcp import net, runtime_state
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def _fingerprint(key: str) -> str | None:
|
|
20
|
+
return net._fingerprint(key)
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def _current() -> dict:
|
|
24
|
+
return runtime_state._runtime_cfg()
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def cmd_auth(args=None):
|
|
28
|
+
action = (getattr(args, "auth_action", "") or "status").strip()
|
|
29
|
+
if action == "status":
|
|
30
|
+
cfg = _current()
|
|
31
|
+
base = cfg.get("java_base") or paths_default_base()
|
|
32
|
+
key = cfg.get("java_key") or ""
|
|
33
|
+
tier = cfg.get("token_tier") or ("key" if key else "anonymous")
|
|
34
|
+
print(f"引擎:{base}")
|
|
35
|
+
if key and tier == "key":
|
|
36
|
+
print(f"key:已配置(指纹 {_fingerprint(key)})——显式凭据,最高优先级")
|
|
37
|
+
elif key:
|
|
38
|
+
print(f"匿名令牌:已缓存(指纹 {_fingerprint(key)},档位 {tier})"
|
|
39
|
+
"——设备绑定领取,不是显式 key;要换显式 key 用 auth init")
|
|
40
|
+
else:
|
|
41
|
+
print("key:未配置 —— 走匿名令牌自动领取(设备绑定;首次提交或 vod_auth_ensure 时领取)")
|
|
42
|
+
return
|
|
43
|
+
|
|
44
|
+
# init:把 key 写进 runtime.json(唯一入口)
|
|
45
|
+
key = (getattr(args, "key", "") or "").strip()
|
|
46
|
+
if not key:
|
|
47
|
+
import os
|
|
48
|
+
key = (os.environ.get("VOD_JAVA_API_KEY") or "").strip()
|
|
49
|
+
if not key:
|
|
50
|
+
print("用法:vod-devkit auth init --key <引擎签发的 key> [--apply]\n"
|
|
51
|
+
" (也可用环境变量 VOD_JAVA_API_KEY 传;缺省只做校验不写盘)",
|
|
52
|
+
file=sys.stderr)
|
|
53
|
+
sys.exit(2)
|
|
54
|
+
if any(ch.isspace() for ch in key) or len(key) < 8:
|
|
55
|
+
print("[vod-devkit] key 形态可疑(含空白或长度 < 8)——拒绝写入,请核对后重试",
|
|
56
|
+
file=sys.stderr)
|
|
57
|
+
sys.exit(2)
|
|
58
|
+
chk = net.probe_key(key)
|
|
59
|
+
if chk.get("ok") is False:
|
|
60
|
+
# 引擎可达却判拒:写进去只会让后续提交全 401,当场拒
|
|
61
|
+
print(f"[vod-devkit] 引擎判该 key 无效({chk.get('reason')},指纹 "
|
|
62
|
+
f"{chk.get('fingerprint')})——未写入。请核对/续期后重试。", file=sys.stderr)
|
|
63
|
+
sys.exit(2)
|
|
64
|
+
if chk.get("ok") is None:
|
|
65
|
+
print(f"warn: 引擎不可达({chk.get('reason')}),无法验证 key 有效性;"
|
|
66
|
+
"仍可写入,后续提交会由引擎最终判定", file=sys.stderr)
|
|
67
|
+
fp = _fingerprint(key)
|
|
68
|
+
if not getattr(args, "apply", False):
|
|
69
|
+
print(f"将写入 key(指纹 {fp})到 {runtime_state._runtime_path()};"
|
|
70
|
+
"未写盘——加 --apply 生效(重启宿主会话后使用新 key)")
|
|
71
|
+
return
|
|
72
|
+
runtime_state._runtime_update({"java_key": key, "token_tier": "key"})
|
|
73
|
+
back = _current().get("java_key")
|
|
74
|
+
if back != key:
|
|
75
|
+
raise SystemExit(f"[vod-devkit] 写入后读回不一致:{runtime_state._runtime_path()}")
|
|
76
|
+
print(f"已写入 key(指纹 {fp}):{runtime_state._runtime_path()}(0600;重启宿主会话生效)")
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def paths_default_base() -> str:
|
|
80
|
+
from vod_mcp import DEFAULT_JAVA_BASE
|
|
81
|
+
return DEFAULT_JAVA_BASE
|