vod-devkit 0.5.12 → 0.5.13
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 +7 -0
- package/README.md +16 -0
- package/assets/contract/tools.schema.json +1 -1
- package/package.json +1 -1
- package/packages/dsh/package.json +1 -1
- package/plugins/vod-devkit/.codex-plugin/plugin.json +1 -1
- package/plugins/vod-devkit/build-info.json +3 -3
- package/plugins/vod-devkit/contract/tools.schema.json +1 -1
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/plugins/vod-devkit/vod_mcp/host_adapters/dsh.py +2 -2
- package/plugins/vod-devkit/vod_mcp/payload.py +72 -1
- package/src/vod_mcp/__init__.py +1 -1
- package/src/vod_mcp/host_adapters/dsh.py +2 -2
- package/src/vod_mcp/payload.py +72 -1
- package/src/vodkit_cli/cli.py +16 -1
- package/src/vodkit_cli/prune_cmd.py +75 -0
- package/src/vodkit_cli/remote.py +40 -5
- package/src/vodkit_cli/uninstall.py +7 -0
package/CHANGELOG.md
CHANGED
|
@@ -436,3 +436,10 @@
|
|
|
436
436
|
|
|
437
437
|
- 7574e3c docs(dsh): 接入手册按 0.5.11 实现重写(两种形态 / 托管块 / 身份两套账本)
|
|
438
438
|
|
|
439
|
+
|
|
440
|
+
## v0.5.13(2026-11-16)
|
|
441
|
+
|
|
442
|
+
- fd804b0 fix(query/prune): 门禁边界 + basetemp 判据 + 壳 add 超时 + prune 文档(评审 a/b/c/d)
|
|
443
|
+
- 4d60d67 fix(release): 发版前必须无未提交改动 + 补交 0.5.12 漏掉的源码(D1/D2/D3/D4)
|
|
444
|
+
- e9e525b feat(prune): 显式清载荷 + 产品校验复用 state 令牌(D3/D6)
|
|
445
|
+
|
package/README.md
CHANGED
|
@@ -82,8 +82,24 @@ npx -y vod-devkit@latest uninstall --target codex --clean-global # 并清载
|
|
|
82
82
|
npx -y vod-devkit@latest auth status # 引擎地址 + 凭据指纹 + 档位(key / 匿名令牌)
|
|
83
83
|
npx -y vod-devkit@latest auth init --key <k> # 校验并显示指纹(缺省不写盘)
|
|
84
84
|
npx -y vod-devkit@latest auth init --key <k> --apply # 写 runtime.json(唯一入口,0600)
|
|
85
|
+
npx -y vod-devkit@latest prune --payloads # 列出可清旧载荷(默认 dry-run,不删)
|
|
86
|
+
npx -y vod-devkit@latest prune --payloads --apply --yes # 真删(保留当前版本与在用的版本)
|
|
85
87
|
```
|
|
86
88
|
|
|
89
|
+
### 旧载荷清理(prune)
|
|
90
|
+
|
|
91
|
+
每升一版会在 `~/.vod-devkit/payloads/<版本>/` 落一份载荷(宿主入口指向它,与 npx 缓存解耦)。
|
|
92
|
+
旧版本**不会自动删**——install 永不隐式删用户文件(删错=某宿主配置指向的 `server.py` 消失)。
|
|
93
|
+
要收空间用显式命令:
|
|
94
|
+
|
|
95
|
+
- **只清清单内**:`payloads/<版本>/` 且带 `payload.json`(安装器 `stage()` 落的);
|
|
96
|
+
没有该文件的手工目录与残留一律不在此列,绝不按 glob 删目录;
|
|
97
|
+
- **保留**:当前版本 + 任何安装行 `payloadDir` 在用的版本;`--keep N` 额外保留最新 N 份;
|
|
98
|
+
- **默认 dry-run**(打印 版本/大小/路径 + 总量);`--apply` 才删,交互式再问 y/N,
|
|
99
|
+
非 tty 必须 `--yes`,否则拒绝执行(exit 2);
|
|
100
|
+
- **只删载荷**,不碰机器级 state(令牌/账本);单条删除失败记录后继续,最后非零退出;
|
|
101
|
+
- 拿不准先看 `doctor` 的 `[doctor] 载荷:在用 …;未被任何安装行引用 […]` 那一行。
|
|
102
|
+
|
|
87
103
|
凭据优先级:显式 key(`auth init` 写入)> 环境变量 `VOD_JAVA_API_KEY`(平台/CI 注入)
|
|
88
104
|
> 匿名令牌自动领取(设备绑定)。**换 key 不需要重启宿主会话**:插件在每次调用引擎前现读
|
|
89
105
|
runtime.json 的身份值(`auth init --apply` 之后的下一次提交立刻用新 key)。**不要把 key 写进宿主 MCP 配置的 `env`**——明文,且会随
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"tools": {
|
|
6
6
|
"vod_submit_voices": {
|
|
7
7
|
"description": "提交用户反馈进 VOD。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止传 confirmed=true**。模糊抱怨(如\"体验不好\")时一轮说完三件事:承接识别结果(\"收到,你对产品体验不满意\")+确认提交意愿(\"要把这条反馈提交给产品团队吗?\")+引导补充(\"方便的话说下具体现象,不说我也会按你的原话提交\");禁止含混反问(实锤病句:\"请问是否把什么作为反馈\")。同意后 content 放用户原话(哪怕只有一句\"体验很差\"也原样提交)。确认环节允许固定追问至多一次,问句必须逐字使用:「方便的话,补充一下遇到这个问题时的操作步骤或期望的表现吗?不方便回复\"没有\",我直接提交。」用户回答只摘录原话对应部分进 reproSteps/expectedBehavior(不改写不总结,无法拆分时落最相关字段,任何内容禁回填 content);答\"没有/跳过/不方便\"=两字段不上送直接提交。引导补充(说下具体现象)已获实质内容并并入 content 时不再追问、直接提交(其中自然出现的操作/期望留在 content 原话,不回溯摘入新字段);仅引导补充未获回应或仅泛化抱怨且用户确认提交时才带出固定问句。product 归因由插件从用户原话解析(安装绑定仅作先验),无需用户提供、禁止询问\"提交到哪个产品/页面\";模型/用户自报的目标产品一律不采信(提到的产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,除上述固定一次追问外,禁止再索要严重程度/环境/附件等开发者字段、禁止第二轮追问。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。拿到回执后必须原样转述 echo.contents(每条「已收录原话:<content>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-vod-devkit",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.13",
|
|
4
4
|
"description": "VOD user-voice collection tools for DeepSeek Harness (dsh). Thin shell over the VOD external HTTP API — mirrors vod-devkit (MCP) collect semantics.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.5.
|
|
3
|
-
"commitSha": "
|
|
4
|
-
"builtAt": "2026-11-16T11:
|
|
2
|
+
"version": "0.5.13",
|
|
3
|
+
"commitSha": "98b1621de69aebb4b8e0f8ed1175c29b4391b529",
|
|
4
|
+
"builtAt": "2026-11-16T11:53:45",
|
|
5
5
|
"sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
|
|
6
6
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
3
|
"title": "vod-devkit MCP 工具契约(唯一事实源)",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
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>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
|
@@ -167,13 +167,13 @@ def install(args, packs: str) -> Path:
|
|
|
167
167
|
from vod_mcp import __version__ as _ver
|
|
168
168
|
pkg = f"dsh-vod-devkit@{_ver}"
|
|
169
169
|
r = subprocess.run([dsh, "plugin", "--profile", profile, "add", pkg],
|
|
170
|
-
capture_output=True, text=True, timeout=
|
|
170
|
+
capture_output=True, text=True, timeout=60)
|
|
171
171
|
if r.returncode != 0:
|
|
172
172
|
print(f"[vod-devkit] dsh plugin add {pkg} 失败,回落不钉版本:"
|
|
173
173
|
f"{(r.stderr or r.stdout).strip()[-200:]}", file=sys.stderr)
|
|
174
174
|
r = subprocess.run([dsh, "plugin", "--profile", profile,
|
|
175
175
|
"add", "dsh-vod-devkit"],
|
|
176
|
-
capture_output=True, text=True, timeout=
|
|
176
|
+
capture_output=True, text=True, timeout=60)
|
|
177
177
|
if r.returncode != 0:
|
|
178
178
|
print(f"[vod-devkit] dsh plugin add 失败:{(r.stderr or r.stdout).strip()[-300:]}",
|
|
179
179
|
file=sys.stderr)
|
|
@@ -178,4 +178,75 @@ def residue() -> list:
|
|
|
178
178
|
if not base.is_dir():
|
|
179
179
|
return []
|
|
180
180
|
return [p for p in sorted(base.iterdir())
|
|
181
|
-
if p.is_dir() and not (p / "payload.json").exists()]
|
|
181
|
+
if p.is_dir() and not (p / "payload.json").exists()]
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
def _vkey(name: str) -> tuple:
|
|
185
|
+
"""版本目录名排序键(0.5.9 < 0.5.10 < 0.5.11;非数字段落当 0,不抛异常)。"""
|
|
186
|
+
out = []
|
|
187
|
+
for part in str(name).replace("-", ".").split("."):
|
|
188
|
+
out.append(int(part) if part.isdigit() else 0)
|
|
189
|
+
return tuple(out)
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
def _tree_size(p: Path) -> int:
|
|
193
|
+
try:
|
|
194
|
+
return sum(f.stat().st_size for f in p.rglob("*") if f.is_file())
|
|
195
|
+
except OSError:
|
|
196
|
+
return 0
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
def prune_candidates(rows=None, keep: int = 0) -> list:
|
|
200
|
+
"""可清理的旧载荷清单 —— 只认安装器自己落过的,且没有宿主在跑(D3,0.5.13)。
|
|
201
|
+
|
|
202
|
+
约束(负责人 2026-11-16 定案):
|
|
203
|
+
· 只删清单内:必须是 `<payload_home>/payloads/<ver>/` 且带 `payload.json`
|
|
204
|
+
(= stage() 落的),绝不按 glob 删目录;
|
|
205
|
+
· 保留当前版本,以及任何安装行 payloadDir 指向的版本(在用的不碰);
|
|
206
|
+
· keep>0 时额外保留最新的 keep 份;
|
|
207
|
+
· 只读 payloads/ 目录,不碰机器级 state(令牌/账本)。
|
|
208
|
+
返回 [(path, version, size_bytes)],按版本升序(最旧的在前)。
|
|
209
|
+
"""
|
|
210
|
+
from vod_mcp import __version__
|
|
211
|
+
base = payload_home() / "payloads"
|
|
212
|
+
if not base.is_dir():
|
|
213
|
+
return []
|
|
214
|
+
used = set()
|
|
215
|
+
for r in (rows or []):
|
|
216
|
+
d = str(r.get("payloadDir") or "").strip()
|
|
217
|
+
if d:
|
|
218
|
+
try:
|
|
219
|
+
used.add(str(Path(d).resolve()))
|
|
220
|
+
except OSError:
|
|
221
|
+
used.add(d)
|
|
222
|
+
cand = []
|
|
223
|
+
for d in sorted(base.iterdir(), key=lambda p: _vkey(p.name)):
|
|
224
|
+
if not d.is_dir() or not (d / "payload.json").exists():
|
|
225
|
+
continue
|
|
226
|
+
try:
|
|
227
|
+
if str(d.resolve()) in used:
|
|
228
|
+
continue
|
|
229
|
+
except OSError:
|
|
230
|
+
continue
|
|
231
|
+
if d.name == __version__:
|
|
232
|
+
continue
|
|
233
|
+
cand.append(d)
|
|
234
|
+
if keep > 0:
|
|
235
|
+
cand = cand[:-keep] if len(cand) > keep else []
|
|
236
|
+
return [(d, d.name, _tree_size(d)) for d in cand]
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
def remove_payloads(cands, quiet: bool = False) -> tuple:
|
|
240
|
+
"""按清单删除载荷目录:单条失败记录后继续,返回 (removed, failed)。"""
|
|
241
|
+
removed, failed = [], []
|
|
242
|
+
for path, ver, _size in cands:
|
|
243
|
+
try:
|
|
244
|
+
shutil.rmtree(path)
|
|
245
|
+
removed.append(str(path))
|
|
246
|
+
if not quiet:
|
|
247
|
+
print(f"removed old payload {ver}: {path}")
|
|
248
|
+
except OSError as e: # noqa: BLE001 单条失败不中断整体
|
|
249
|
+
failed.append((str(path), str(e)))
|
|
250
|
+
if not quiet:
|
|
251
|
+
print(f"[warn] 删除失败 {path}: {e}")
|
|
252
|
+
return removed, failed
|
package/src/vod_mcp/__init__.py
CHANGED
|
@@ -167,13 +167,13 @@ def install(args, packs: str) -> Path:
|
|
|
167
167
|
from vod_mcp import __version__ as _ver
|
|
168
168
|
pkg = f"dsh-vod-devkit@{_ver}"
|
|
169
169
|
r = subprocess.run([dsh, "plugin", "--profile", profile, "add", pkg],
|
|
170
|
-
capture_output=True, text=True, timeout=
|
|
170
|
+
capture_output=True, text=True, timeout=60)
|
|
171
171
|
if r.returncode != 0:
|
|
172
172
|
print(f"[vod-devkit] dsh plugin add {pkg} 失败,回落不钉版本:"
|
|
173
173
|
f"{(r.stderr or r.stdout).strip()[-200:]}", file=sys.stderr)
|
|
174
174
|
r = subprocess.run([dsh, "plugin", "--profile", profile,
|
|
175
175
|
"add", "dsh-vod-devkit"],
|
|
176
|
-
capture_output=True, text=True, timeout=
|
|
176
|
+
capture_output=True, text=True, timeout=60)
|
|
177
177
|
if r.returncode != 0:
|
|
178
178
|
print(f"[vod-devkit] dsh plugin add 失败:{(r.stderr or r.stdout).strip()[-300:]}",
|
|
179
179
|
file=sys.stderr)
|
package/src/vod_mcp/payload.py
CHANGED
|
@@ -178,4 +178,75 @@ def residue() -> list:
|
|
|
178
178
|
if not base.is_dir():
|
|
179
179
|
return []
|
|
180
180
|
return [p for p in sorted(base.iterdir())
|
|
181
|
-
if p.is_dir() and not (p / "payload.json").exists()]
|
|
181
|
+
if p.is_dir() and not (p / "payload.json").exists()]
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
def _vkey(name: str) -> tuple:
|
|
185
|
+
"""版本目录名排序键(0.5.9 < 0.5.10 < 0.5.11;非数字段落当 0,不抛异常)。"""
|
|
186
|
+
out = []
|
|
187
|
+
for part in str(name).replace("-", ".").split("."):
|
|
188
|
+
out.append(int(part) if part.isdigit() else 0)
|
|
189
|
+
return tuple(out)
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
def _tree_size(p: Path) -> int:
|
|
193
|
+
try:
|
|
194
|
+
return sum(f.stat().st_size for f in p.rglob("*") if f.is_file())
|
|
195
|
+
except OSError:
|
|
196
|
+
return 0
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
def prune_candidates(rows=None, keep: int = 0) -> list:
|
|
200
|
+
"""可清理的旧载荷清单 —— 只认安装器自己落过的,且没有宿主在跑(D3,0.5.13)。
|
|
201
|
+
|
|
202
|
+
约束(负责人 2026-11-16 定案):
|
|
203
|
+
· 只删清单内:必须是 `<payload_home>/payloads/<ver>/` 且带 `payload.json`
|
|
204
|
+
(= stage() 落的),绝不按 glob 删目录;
|
|
205
|
+
· 保留当前版本,以及任何安装行 payloadDir 指向的版本(在用的不碰);
|
|
206
|
+
· keep>0 时额外保留最新的 keep 份;
|
|
207
|
+
· 只读 payloads/ 目录,不碰机器级 state(令牌/账本)。
|
|
208
|
+
返回 [(path, version, size_bytes)],按版本升序(最旧的在前)。
|
|
209
|
+
"""
|
|
210
|
+
from vod_mcp import __version__
|
|
211
|
+
base = payload_home() / "payloads"
|
|
212
|
+
if not base.is_dir():
|
|
213
|
+
return []
|
|
214
|
+
used = set()
|
|
215
|
+
for r in (rows or []):
|
|
216
|
+
d = str(r.get("payloadDir") or "").strip()
|
|
217
|
+
if d:
|
|
218
|
+
try:
|
|
219
|
+
used.add(str(Path(d).resolve()))
|
|
220
|
+
except OSError:
|
|
221
|
+
used.add(d)
|
|
222
|
+
cand = []
|
|
223
|
+
for d in sorted(base.iterdir(), key=lambda p: _vkey(p.name)):
|
|
224
|
+
if not d.is_dir() or not (d / "payload.json").exists():
|
|
225
|
+
continue
|
|
226
|
+
try:
|
|
227
|
+
if str(d.resolve()) in used:
|
|
228
|
+
continue
|
|
229
|
+
except OSError:
|
|
230
|
+
continue
|
|
231
|
+
if d.name == __version__:
|
|
232
|
+
continue
|
|
233
|
+
cand.append(d)
|
|
234
|
+
if keep > 0:
|
|
235
|
+
cand = cand[:-keep] if len(cand) > keep else []
|
|
236
|
+
return [(d, d.name, _tree_size(d)) for d in cand]
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
def remove_payloads(cands, quiet: bool = False) -> tuple:
|
|
240
|
+
"""按清单删除载荷目录:单条失败记录后继续,返回 (removed, failed)。"""
|
|
241
|
+
removed, failed = [], []
|
|
242
|
+
for path, ver, _size in cands:
|
|
243
|
+
try:
|
|
244
|
+
shutil.rmtree(path)
|
|
245
|
+
removed.append(str(path))
|
|
246
|
+
if not quiet:
|
|
247
|
+
print(f"removed old payload {ver}: {path}")
|
|
248
|
+
except OSError as e: # noqa: BLE001 单条失败不中断整体
|
|
249
|
+
failed.append((str(path), str(e)))
|
|
250
|
+
if not quiet:
|
|
251
|
+
print(f"[warn] 删除失败 {path}: {e}")
|
|
252
|
+
return removed, failed
|
package/src/vodkit_cli/cli.py
CHANGED
|
@@ -3,7 +3,8 @@ import argparse
|
|
|
3
3
|
import os
|
|
4
4
|
import sys
|
|
5
5
|
|
|
6
|
-
from vodkit_cli import auth_cmd, common, doctor, install, packs_cmd,
|
|
6
|
+
from vodkit_cli import (auth_cmd, common, doctor, install, packs_cmd, prune_cmd,
|
|
7
|
+
uninstall, update)
|
|
7
8
|
|
|
8
9
|
|
|
9
10
|
def main():
|
|
@@ -95,6 +96,20 @@ def main():
|
|
|
95
96
|
sp_auth.add_argument("--apply", action="store_true",
|
|
96
97
|
help="真正写盘(缺省只校验并显示指纹)")
|
|
97
98
|
sp_auth.set_defaults(fn=auth_cmd.cmd_auth)
|
|
99
|
+
def _prune(a):
|
|
100
|
+
"""cmd_prune 返回退出码(0=干净/no-op,1=有删除失败,2=参数/确认问题)。"""
|
|
101
|
+
sys.exit(prune_cmd.cmd_prune(a))
|
|
102
|
+
|
|
103
|
+
sp_prune = sub.add_parser("prune", help="显式清理旧载荷(默认 dry-run;二次确认)")
|
|
104
|
+
sp_prune.add_argument("--payloads", action="store_true",
|
|
105
|
+
help="清理旧载荷版本(当前唯一的清理对象)")
|
|
106
|
+
sp_prune.add_argument("--keep", type=int, default=0,
|
|
107
|
+
help="额外保留最新的 N 份旧载荷(默认 0)")
|
|
108
|
+
sp_prune.add_argument("--apply", action="store_true",
|
|
109
|
+
help="真正删除(缺省只打印清单,dry-run 优先)")
|
|
110
|
+
sp_prune.add_argument("--yes", action="store_true",
|
|
111
|
+
help="非交互环境确认删除(交互式会再问一次 y/N)")
|
|
112
|
+
sp_prune.set_defaults(fn=_prune)
|
|
98
113
|
sub.add_parser("build-info").set_defaults(fn=lambda a: common.write_build_info(strict=False))
|
|
99
114
|
|
|
100
115
|
def _serve(a):
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
"""prune:显式清理旧载荷(D3,2026-11-16 负责人定案)。
|
|
2
|
+
|
|
3
|
+
为什么单独一个命令、而不是 install 顺手删:
|
|
4
|
+
· 安装时删用户文件不可接受(无法回滚、误删风险高、用户没预期);
|
|
5
|
+
· 卸载才清理又太晚(很多机器只升级不卸载,旧载荷永远留着)。
|
|
6
|
+
|
|
7
|
+
约束(定案原文的落法):
|
|
8
|
+
· 只删清单内:`payload.prune_candidates()` 只认 `<payload_home>/payloads/<ver>/`
|
|
9
|
+
且带 `payload.json`(stage() 落的)的目录,绝不 glob 盲删;
|
|
10
|
+
· 保留当前版本 + 任何安装行 payloadDir 指向的版本;`--keep N` 额外保留最新 N 份;
|
|
11
|
+
· 默认 dry-run(只打印清单);真删要 `--apply`;
|
|
12
|
+
· 二次确认:交互式 y/N;非 tty 必须 `--yes`,否则拒绝;
|
|
13
|
+
· 逐条打印 路径/版本/大小;
|
|
14
|
+
· 只删载荷目录,不碰机器级 state;
|
|
15
|
+
· 单条删除失败记录后继续,最后以非零退出码收尾。
|
|
16
|
+
"""
|
|
17
|
+
import sys
|
|
18
|
+
|
|
19
|
+
from vod_mcp import payload as _payload
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def _fmt(n: float) -> str:
|
|
23
|
+
for unit in ("B", "KB", "MB", "GB"):
|
|
24
|
+
if n < 1024 or unit == "GB":
|
|
25
|
+
return f"{n:.0f}{unit}" if unit == "B" else f"{n:.1f}{unit}"
|
|
26
|
+
n /= 1024
|
|
27
|
+
return f"{n:.1f}GB"
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def _rows() -> list:
|
|
31
|
+
from vodkit_cli import common
|
|
32
|
+
import json
|
|
33
|
+
p = common.manifest_path()
|
|
34
|
+
if not p.exists():
|
|
35
|
+
return []
|
|
36
|
+
try:
|
|
37
|
+
mf = json.loads(p.read_text(encoding="utf-8"))
|
|
38
|
+
except (OSError, ValueError):
|
|
39
|
+
return []
|
|
40
|
+
return mf.get("installs") or ([mf] if mf.get("target") else [])
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def cmd_prune(args) -> int:
|
|
44
|
+
if not getattr(args, "payloads", False):
|
|
45
|
+
print("只支持 --payloads(当前唯一的清理对象)", file=sys.stderr)
|
|
46
|
+
return 2
|
|
47
|
+
rows = _rows()
|
|
48
|
+
keep = int(getattr(args, "keep", 0) or 0)
|
|
49
|
+
cands = _payload.prune_candidates(rows, keep=keep)
|
|
50
|
+
if not cands:
|
|
51
|
+
print("没有可清理的旧载荷(当前版本与安装行在用的都保留)")
|
|
52
|
+
return 0
|
|
53
|
+
total = sum(size for _p, _v, size in cands)
|
|
54
|
+
print(f"可清理 {len(cands)} 份旧载荷,共 {_fmt(total)}"
|
|
55
|
+
+ (f"(额外保留最新 {keep} 份)" if keep else ""))
|
|
56
|
+
for path, ver, size in cands:
|
|
57
|
+
print(f" - {ver:<10s} {_fmt(size):>9s} {path}")
|
|
58
|
+
print(" 保留:当前版本 + 安装行在用的版本 + 机器级 state(不在本命令范围内)")
|
|
59
|
+
|
|
60
|
+
if not getattr(args, "apply", False):
|
|
61
|
+
print("(dry-run:未删除。确认后加 --apply 执行)")
|
|
62
|
+
return 0
|
|
63
|
+
if not getattr(args, "yes", False):
|
|
64
|
+
if not sys.stdin.isatty():
|
|
65
|
+
print("非交互环境需加 --yes 才执行删除(二次确认)", file=sys.stderr)
|
|
66
|
+
return 2
|
|
67
|
+
ans = input(f"确认删除上述 {len(cands)} 份载荷?[y/N] ").strip().lower()
|
|
68
|
+
if ans not in ("y", "yes"):
|
|
69
|
+
print("已取消")
|
|
70
|
+
return 0
|
|
71
|
+
|
|
72
|
+
removed, failed = _payload.remove_payloads(cands)
|
|
73
|
+
print(f"已删除 {len(removed)} 份"
|
|
74
|
+
+ (f",失败 {len(failed)} 份(见上)" if failed else ""))
|
|
75
|
+
return 1 if failed else 0
|
package/src/vodkit_cli/remote.py
CHANGED
|
@@ -166,10 +166,35 @@ def _validate_product_or_exit(product: str, base: str) -> bool:
|
|
|
166
166
|
with urllib.request.urlopen(req, timeout=10) as resp:
|
|
167
167
|
return resp.status, resp.read().decode("utf-8", "replace")
|
|
168
168
|
|
|
169
|
+
def _state_identity() -> tuple:
|
|
170
|
+
"""机器级 state 里已存的匿名令牌 + 它的设备锚点(install_nonce)。
|
|
171
|
+
|
|
172
|
+
装机校验**不该每次新签一枚**:引擎对"同网络当日签发次数"有限流
|
|
173
|
+
(实测撞到 100/日 → 429,整批装机全被挡)。复用 state 的令牌既省配额,
|
|
174
|
+
又避免一次新的设备锚点漂移;device 必须用 state 的 install_nonce,
|
|
175
|
+
否则令牌与设备不配对(S1 设备绑定)。
|
|
176
|
+
"""
|
|
177
|
+
try:
|
|
178
|
+
from vod_mcp import runtime_state as _rt
|
|
179
|
+
cfg = _rt._runtime_cfg() or {}
|
|
180
|
+
if str(cfg.get("token_tier") or "") != "anonymous":
|
|
181
|
+
return ("", "")
|
|
182
|
+
tok = str(cfg.get("java_key") or "")
|
|
183
|
+
dev = str(_rt._install_nonce() or "")
|
|
184
|
+
return (tok, dev) if (tok and dev) else ("", "")
|
|
185
|
+
except Exception: # noqa: BLE001 读不到就当没有,回落新签
|
|
186
|
+
return ("", "")
|
|
187
|
+
|
|
169
188
|
def _catalog_once():
|
|
170
|
-
"""
|
|
171
|
-
|
|
172
|
-
|
|
189
|
+
"""一个回合:有 state 令牌就复用,否则新设备锚点 + 领令牌 → 读目录。"""
|
|
190
|
+
reuse_tok, reuse_dev = _state_identity()
|
|
191
|
+
if key:
|
|
192
|
+
device, token = uuid.uuid4().hex[:32], key
|
|
193
|
+
elif reuse_tok:
|
|
194
|
+
device, token = reuse_dev, reuse_tok
|
|
195
|
+
else:
|
|
196
|
+
device = uuid.uuid4().hex[:32]
|
|
197
|
+
token = _mint(device)
|
|
173
198
|
status, text = _get(f"{base}{api_prefix}/external/meta", token, device)
|
|
174
199
|
data = (json.loads(text) or {}).get("data") or {}
|
|
175
200
|
cat = data.get("productCatalog")
|
|
@@ -179,7 +204,7 @@ def _validate_product_or_exit(product: str, base: str) -> bool:
|
|
|
179
204
|
cat = data if isinstance(data, list) else None
|
|
180
205
|
return cat
|
|
181
206
|
|
|
182
|
-
catalog, unauthorized, last_exc = None, False, None
|
|
207
|
+
catalog, unauthorized, rate_limited, last_exc = None, False, False, None
|
|
183
208
|
for attempt in (1, 2):
|
|
184
209
|
try:
|
|
185
210
|
catalog = _catalog_once()
|
|
@@ -189,6 +214,10 @@ def _validate_product_or_exit(product: str, base: str) -> bool:
|
|
|
189
214
|
last_exc = e
|
|
190
215
|
if e.code == 401:
|
|
191
216
|
unauthorized = True
|
|
217
|
+
if e.code == 429:
|
|
218
|
+
# 限流:重试只会更糟(配额头是"当日/网络"),立刻停
|
|
219
|
+
rate_limited = True
|
|
220
|
+
break
|
|
192
221
|
if attempt == 2:
|
|
193
222
|
break
|
|
194
223
|
except Exception as e: # noqa: BLE001 网络抖动也重试一次
|
|
@@ -197,7 +226,13 @@ def _validate_product_or_exit(product: str, base: str) -> bool:
|
|
|
197
226
|
break
|
|
198
227
|
|
|
199
228
|
if catalog is None:
|
|
200
|
-
if
|
|
229
|
+
if rate_limited:
|
|
230
|
+
print("[vod-devkit] 产品校验失败:令牌签发被限流(HTTP 429,同网络当日签发次数上限)。\n"
|
|
231
|
+
" 这不是装机器本身的问题——安装器每校验一次都要一枚匿名令牌,"
|
|
232
|
+
"密集重装/联调会把日配额打满。\n"
|
|
233
|
+
" 处置:配 VOD_JAVA_API_KEY 走正式 key(不占匿名配额);或明天再试;"
|
|
234
|
+
"或找 VOD 运营调整限流。", file=sys.stderr)
|
|
235
|
+
elif unauthorized:
|
|
201
236
|
print("[vod-devkit] 产品校验失败:引擎鉴权异常(HTTP 401)——刚签发的匿名令牌被"
|
|
202
237
|
"校验侧拒绝。\n"
|
|
203
238
|
" 典型原因:引擎多实例的令牌存储/缓存不同步(重试一次通常就过),"
|
|
@@ -222,6 +222,13 @@ def _clean_global(rows: list, remaining: list | None = None) -> None:
|
|
|
222
222
|
continue
|
|
223
223
|
shutil.rmtree(res, ignore_errors=True)
|
|
224
224
|
print("removed payload residue:", res)
|
|
225
|
+
# 旧载荷(带 payload.json 的安装器产物):与 `prune --payloads` 同一实现
|
|
226
|
+
#(D3 定案:显式、只删清单内、保留 remaining 宿主仍在引用的版本)。
|
|
227
|
+
old = _payload.prune_candidates(remaining or [])
|
|
228
|
+
if old:
|
|
229
|
+
_removed, _failed = _payload.remove_payloads(old)
|
|
230
|
+
if _failed:
|
|
231
|
+
print(f"[warn] 旧载荷删除失败 {len(_failed)} 份(见上)")
|
|
225
232
|
# D-token-machine-1:机器级 state(跨版本/跨宿主共享的那一份)。
|
|
226
233
|
state = _paths.machine_state_home()
|
|
227
234
|
if remaining:
|