vod-devkit 0.3.0 → 0.4.1
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 +27 -0
- package/bin/vod-devkit +10 -1
- package/contract/tools.schema.json +25 -7
- package/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/skills/vod-feedback-collect/SKILL.md +11 -1
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/plugins/vod-devkit/vod_mcp/tools.py +58 -14
- package/skills/vod-feedback-collect/SKILL.md +11 -1
- package/vod_mcp/__init__.py +1 -1
- package/vod_mcp/tools.py +58 -14
package/CHANGELOG.md
CHANGED
|
@@ -199,3 +199,30 @@
|
|
|
199
199
|
- f90e130 UX 修复:后台重试成功不再静默——暂存反馈自动重试成功后落旗标,下次打开弹窗补提示(逐条原话回显,voice-id 不出用户面 F2;措辞「已自动重试成功」说清=完成用户此前点提交的指令非绕过确认;产品名不带——用户不感知归因拍板)
|
|
200
200
|
- a3cdd6d dsh 壳 UX 定稿同步(web widget 拍板漏同步各壳漂移实锤):提示语去括号后缀与受理引导句、撤 maxlength 计数器(硬帽保留)、撤「我的反馈」入口(账本写入保留);+ux-sync 回归锁(src+构建产物双级)
|
|
201
201
|
|
|
202
|
+
|
|
203
|
+
## v0.3.1(2026-11-09)
|
|
204
|
+
|
|
205
|
+
- 141dce4 fix(auth): probe_key 匿名令牌 401 报 expired-anonymous 而非 rejected——runtime 残留过期匿名令牌曾被误读为正式 key 失效(本机实锤:指纹 712c0ae4 实为 anonymous 档过期令牌);显式 key 被拒仍 rejected(fail fast 口径不变),note 指明下次提交自动重领;+回归锁(匿名档 expired-anonymous+重领提示、显式档 rejected 保持)
|
|
206
|
+
- 84cc6f1 fix(installer+dsh): 四宿主全链模拟两项实锤修复——①重装吃掉配置:dsh plugin add 模板含字面量 [] 顶层行,幂等追加块后 = 非法 YAML 整 profile 启动崩溃(upsert 追加路径清除空数组占位+回归锁);②headless 审批死锁:dsh 原生 ask 门禁无通道永久阻断写工具(requires approval, but no approval channel 实锤,此前靠 11-06 手工配置 confirmWrites:false 残留掩盖)——installer 显式写 confirmWrites:false(同意由 SKILL 话术层承担,web 端按 profile 覆盖回 true);dsh 真机重装→提交成功复验 ✅
|
|
207
|
+
- 9b87594 feat(followup-status): 插件侧 followupStatus 上报对接(引擎 V55-V57 契约增量,proposal S74-S76)——单源 _followup_fields 扩展三态白名单归一(strip+lower,白名单外/缺失省键,submit/draft 双路径共用禁双边漂移;commit 随 draft 暂存冻结防调包语义不变);契约 draft/submit 双工具 items 增枚举字段(工具 description 零增量,预算门禁不回退);dsh 壳透传同口径扩展(desc 1495/1500 无预算不宣讲,SKILL 宿主技能层承载);SKILL 判定块第 5 条三态映射话术锁(七副本 md5 对齐);+5 回归锁;pytest 153 绿+node 9 绿
|
|
208
|
+
- e40fafe fix(auth): 旧版残留凭据检测与自愈提示(评审拍板项,优先于公告)——codex 0.2.3 残留 legacy key 挡匿名链四宿主实测实锤;三处提交失败路径错误消息追加可操作自愈指引(_legacy_key_hint:当前版本+npx 重装命令+匿名档出口,不发公告靠用户撞);vod_auth_status 显式 key 在位即挂 legacyKeyHint 检测位(不等提交撞 401 才发现);不静默删 key 不静默重装(提示用户确认更新口径);+回归锁(提示含版本与重装命令+四处调用点在位);pytest 148 绿
|
|
209
|
+
- 1ac4b48 fix(release): GitCode 推送失败改硬失败 exit 1——本次发版 push 被 pre-push 拦后脚本吞错仍误报'发版完成'的实锤修复
|
|
210
|
+
- 87ac1ee test: golden status 版本快照随 v0.3.0 发版重录——release.sh 推送失败被 '|| echo 跳过' 吞掉的实锤(本次 push 被 pre-push 拦后仍误报发版完成,脚本待修:push 失败应 exit 1)
|
|
211
|
+
|
|
212
|
+
|
|
213
|
+
## v0.4.0(2026-11-09)
|
|
214
|
+
|
|
215
|
+
- 3c54786 feat(two-phase): D-resume-commit-1 断回合续提交+确认收口话术锁——实锤:agent draft 后收工,用户两次说提交仍无下文(approvalToken 只存于 draft 响应文本,回合断即丢失)。①draft 将 token 随草稿落盘(runtime 0600,与 java_key 同级;token 威胁模型=防载荷改写非同意凭证,落盘不放大);commit 允许省略 token/sha 由本地未过期草稿恢复,显式传错仍拒(语义不放宽);契约 required 收窄为 draftId。②SKILL 真源加话术锁:用户确认后当回合必须 commit、不成必须明告未提交(真源生成+sync 同步,禁自由裁量)。+4 回归锁(恢复成功/错 sha 仍拒/过期拒/token 落盘+0600);pytest 159 绿+node 9 绿
|
|
216
|
+
- ca84c3a test: conftest autouse runtime 隔离——test_followup 等 _submit 用例桩了 _http 未重定向 _runtime_path,账本追加写穿仓内真实 runtime.json(本机 200 条账本被测试数据灌满实锤);autouse 重定向 tmp,用例内显式 setattr 仍可覆盖;pytest 155 绿
|
|
217
|
+
- f35cd0e test: golden status 版本快照随 v0.3.1 重录(仅 version 字段,diff 已过目)
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
## v0.4.1(2026-11-09)
|
|
221
|
+
|
|
222
|
+
- a0cf5c2 chore(dsh-release): dsh-vod-devkit 0.2.0——首装 nonce 同步+issue_sync 轮询拆除随包(tgz 本地重打包不入 git,嵌入方经 dsh plugin add <tgz> 或重装升级)
|
|
223
|
+
- 4e9a015 fix(nonce-sync): D-dev-nonce-sync-1 首装 nonce 内存态同步——真机实锤:全新安装首次提交必失败冒给用户(_install_nonce 首次生成只落盘不回写 _RT,同进程每次新 nonce→领令牌与提交设备不同→绑定校验 401,重试仍新 nonce 再 401;二次提交才成功);修复=生成后同步 _RT[install_nonce],领令牌/提交/重试同设备 401→领令牌→重试全程无感;存量安装不受影响;回归锁 tests/test_install_nonce_sync.py;pytest 163 绿(162+1)+ 本地 e2e 修复后干净沙箱首提一次成功;decisions.md D-dev-nonce-sync-1
|
|
224
|
+
- b8eed60 feat(dsh-ui)+docs: D-inbox-direct-ui-1 issue_sync 轮询拆除——引擎单表收口后回执无 issue_sync 节,原 U-S2 轮询(GET ?limit=50 找 voiceId)永远空转静默失效;净删 pollIssueSync/pollForReceipt 及调用点,提交成功(201)即终态提示「已收录,产品团队会看到」(对齐 D-inbox-DIRECT 不建 issue 拍板);提交链本体(POST+断线自动重提)保留不动;lib 随构建重出;docs:dsh-ui-collect §六/§七/U-S 用例表同步、decisions.md D-inbox-direct-ui-1 决策条目;回归锁 +1(no-issue-sync-poll.test.mjs:src/lib 双侧禁 issue_sync 与已建成 issue 话术+提交链本体保留锁);dsh node --test 10/10 绿
|
|
225
|
+
- b0f121c docs(quota): D-quota-raise-1 匿名档配额提额+引擎侧可配置化文档化——面向用户数值口径同步(5000/日500),proposal 信任模型表/decisions 决策条目/design 数值归属节(插件零配额数值,429 文案引擎透传)
|
|
226
|
+
- fa9c92b refactor(two-phase)+docs: D-resume-commit-1 文档化+场景用例 S83-S86+草稿库读写单源化——docs: decisions.md 决策条目/design.md 承载补充(分层治理口径)/proposal.md 场景用例清单(S83 全链回执逐字、S84 断回合恢复、S85 过期重开链、S86 消费后不可复活);refactor: _drafts_load() 单源化 draft/commit 草稿库读写(现读+TTL 惰性清除,禁双边漂移);+3 场景回归锁;pytest 162 绿+node 9 绿
|
|
227
|
+
- 9b5e6ec test: golden status 版本快照随 v0.4.0 重录(仅 version 字段,diff 已过目)
|
|
228
|
+
|
package/bin/vod-devkit
CHANGED
|
@@ -394,7 +394,12 @@ def _install_dsh(args, packs: str) -> Path:
|
|
|
394
394
|
" name: dsh-vod-devkit\n"
|
|
395
395
|
" config:\n"
|
|
396
396
|
f" product: {args.product}\n"
|
|
397
|
-
f" apiBase: {args.java_api_base}\n"
|
|
397
|
+
f" apiBase: {args.java_api_base}\n"
|
|
398
|
+
" # headless 无审批通道:原生 ask 门禁会永久阻断写工具(四宿主实测实锤:\n"
|
|
399
|
+
" # requires approval, but no approval channel)。同意确认由 SKILL 话术层\n"
|
|
400
|
+
" # 承担(draft→用户确认→commit / 明确指令直发),web 端如需硬门禁按\n"
|
|
401
|
+
" # profile 覆盖回 true。\n"
|
|
402
|
+
" confirmWrites: false\n")
|
|
398
403
|
try:
|
|
399
404
|
written = _upsert_dsh_patch(patch, block)
|
|
400
405
|
except Exception as e:
|
|
@@ -434,6 +439,10 @@ def _upsert_dsh_patch(patch: Path, block: str) -> bool:
|
|
|
434
439
|
lines = patch.read_text(encoding="utf-8").splitlines() if patch.exists() else []
|
|
435
440
|
start, end = _find_dsh_block(lines)
|
|
436
441
|
if start is None:
|
|
442
|
+
# 空数组占位清除(四宿主实测实锤:dsh plugin add 自建的模板含字面量
|
|
443
|
+
# `[]` 顶层行,直接追加块 = `[]` 后跟 `- id:` 顶层元素 = 非法 YAML,
|
|
444
|
+
# 整个 profile 启动崩溃)。`[]` 语义=空数组,被块 entries 取代即删。
|
|
445
|
+
lines = [ln for ln in lines if ln.strip() != "[]"]
|
|
437
446
|
new = lines + ([""] if lines and lines[-1].strip() else []) + block.splitlines()
|
|
438
447
|
else:
|
|
439
448
|
new = lines[:start] + block.splitlines() + lines[end:]
|
|
@@ -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.
|
|
4
|
+
"version": "0.4.1",
|
|
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>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
|
@@ -38,6 +38,16 @@
|
|
|
38
38
|
"type": "string",
|
|
39
39
|
"maxLength": 2000,
|
|
40
40
|
"description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
|
|
41
|
+
},
|
|
42
|
+
"followupStatus": {
|
|
43
|
+
"type": "string",
|
|
44
|
+
"enum": [
|
|
45
|
+
"not_asked",
|
|
46
|
+
"declined",
|
|
47
|
+
"answered"
|
|
48
|
+
],
|
|
49
|
+
"maxLength": 32,
|
|
50
|
+
"description": "追问环节状态(可选,按 S67-S70 判定结果上送):not_asked=未触发追问;declined=问了未答/拒答;answered=已答并随 reproSteps/expectedBehavior。白名单外值引擎降 NULL 不拒收"
|
|
41
51
|
}
|
|
42
52
|
},
|
|
43
53
|
"required": [
|
|
@@ -253,6 +263,16 @@
|
|
|
253
263
|
"type": "string",
|
|
254
264
|
"maxLength": 2000,
|
|
255
265
|
"description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
|
|
266
|
+
},
|
|
267
|
+
"followupStatus": {
|
|
268
|
+
"type": "string",
|
|
269
|
+
"enum": [
|
|
270
|
+
"not_asked",
|
|
271
|
+
"declined",
|
|
272
|
+
"answered"
|
|
273
|
+
],
|
|
274
|
+
"maxLength": 32,
|
|
275
|
+
"description": "追问环节状态(可选,按 S67-S70 判定结果上送):not_asked=未触发追问;declined=问了未答/拒答;answered=已答并随 reproSteps/expectedBehavior。白名单外值引擎降 NULL 不拒收"
|
|
256
276
|
}
|
|
257
277
|
},
|
|
258
278
|
"required": [
|
|
@@ -290,17 +310,15 @@
|
|
|
290
310
|
"approvalToken": {
|
|
291
311
|
"type": "string",
|
|
292
312
|
"minLength": 8,
|
|
293
|
-
"description": "vod_draft_voices 返回的 approvalToken
|
|
313
|
+
"description": "vod_draft_voices 返回的 approvalToken 原样透传;断回合场景可省略——插件从本地暂存草稿恢复"
|
|
294
314
|
},
|
|
295
315
|
"payloadSha256": {
|
|
296
316
|
"type": "string",
|
|
297
|
-
"description": "vod_draft_voices 返回的 payloadSha256
|
|
317
|
+
"description": "vod_draft_voices 返回的 payloadSha256 原样透传;断回合场景可省略——插件从本地暂存草稿恢复"
|
|
298
318
|
}
|
|
299
319
|
},
|
|
300
320
|
"required": [
|
|
301
|
-
"draftId"
|
|
302
|
-
"approvalToken",
|
|
303
|
-
"payloadSha256"
|
|
321
|
+
"draftId"
|
|
304
322
|
],
|
|
305
323
|
"additionalProperties": false
|
|
306
324
|
}
|
|
@@ -318,4 +336,4 @@
|
|
|
318
336
|
"auth": null
|
|
319
337
|
}
|
|
320
338
|
}
|
|
321
|
-
}
|
|
339
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
3
|
-
"commitSha": "
|
|
4
|
-
"builtAt": "2026-11-
|
|
2
|
+
"version": "0.4.1",
|
|
3
|
+
"commitSha": "a0cf5c26e2798205007ae693f2d3400d0dea7729",
|
|
4
|
+
"builtAt": "2026-11-09T17:47:25",
|
|
5
5
|
"sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
|
|
6
6
|
}
|
|
@@ -112,6 +112,10 @@ version: 1
|
|
|
112
112
|
符合诚实回退。**
|
|
113
113
|
4. 引擎侧承载已就绪(t_vod_voice_inbox.repro_steps/expected_behavior,
|
|
114
114
|
issue 渲染带「用户追问补充」来源注记)——本话术非空头承诺(S51 自审过)。
|
|
115
|
+
5. 追问环节状态随行上送(followupStatus,引擎指标字段、issue 不渲染):
|
|
116
|
+
not_asked=未触发追问(已有实质回应/泛化未触发);declined=问了未答
|
|
117
|
+
或答"没有/不方便";answered=已答并随两字段上送。三态白名单,
|
|
118
|
+
不确定就不带键(引擎降 NULL)。
|
|
115
119
|
|
|
116
120
|
**反截断红线(2026-11-08 opencode 实锤)**:用户在引导补充后给出的
|
|
117
121
|
补充句是**完整提交物**,content=该句逐字全量上送,禁止摘取其中片段
|
|
@@ -154,8 +158,14 @@ version: 1
|
|
|
154
158
|
3. 调用 vod_draft_voices 暂存草稿(必须用户已初步同意)→ 把返回的
|
|
155
159
|
contents 逐条**原样**展示给用户核对(禁止改写概括)→ 明确问
|
|
156
160
|
「确认提交吗」→ 用户明确同意后才调 vod_commit_voices(draftId/
|
|
157
|
-
approvalToken/payloadSha256
|
|
161
|
+
approvalToken/payloadSha256 原样透传;断回合场景 token/sha 可省略,
|
|
162
|
+
插件从本地草稿恢复)。单发工具 vod_submit_voices
|
|
158
163
|
仅限无两段式工具的宿主使用。**一次一批**,攒多条一起交也行,但每批都要用户点头
|
|
164
|
+
**用户确认后必须当回合 commit(D-resume-commit-1 话术锁,禁自由裁量)**:
|
|
165
|
+
用户说了"提交/确认/提吧"之后,本回合必须调 vod_commit_voices 收口——
|
|
166
|
+
调用失败或草稿过期就重开草稿再 commit;任何原因提交不成,必须明确
|
|
167
|
+
告诉用户"还没有提交成功",禁止只回一句"好的"就结束(实锤:agent
|
|
168
|
+
draft 后收工,用户说了两次"提交"仍无下文,反馈 40 分钟没进引擎)
|
|
159
169
|
**一次抱怨=一条声音(2026-11-06 实锤红线)**:用户一次表述只提交一条,
|
|
160
170
|
content=原话逐字——禁止拆成多条、禁止生成多个改写变体(实锤:一次
|
|
161
171
|
"网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
|
|
@@ -30,12 +30,17 @@ _FOLLOWUP_DECLINES = frozenset({
|
|
|
30
30
|
|
|
31
31
|
def _followup_fields(voice: dict) -> dict:
|
|
32
32
|
"""D-followup-impl-2 单源提取(submit 主路径与 draft 暂存共用,禁双边漂移):
|
|
33
|
-
仅 trim 非空且非拒答词才含键;引擎同口径截 2000;内容永不回流 content。
|
|
33
|
+
仅 trim 非空且非拒答词才含键;引擎同口径截 2000;内容永不回流 content。
|
|
34
|
+
followupStatus(评审八点 #3 引擎侧承载的插件上报):三态白名单归一
|
|
35
|
+
(strip+lower),白名单外/缺失省键——引擎侧降 NULL 不拒收,插件侧同口径双保险。"""
|
|
34
36
|
out = {}
|
|
35
37
|
for _f in ("reproSteps", "expectedBehavior"):
|
|
36
38
|
_val = str(voice.get(_f) or "").strip()
|
|
37
39
|
if _val and _val.lower() not in _FOLLOWUP_DECLINES:
|
|
38
40
|
out[_f] = _val[:2000]
|
|
41
|
+
_st = str(voice.get("followupStatus") or "").strip().lower()
|
|
42
|
+
if _st in ("not_asked", "declined", "answered"):
|
|
43
|
+
out["followupStatus"] = _st
|
|
39
44
|
return out
|
|
40
45
|
|
|
41
46
|
_CONTRACT_PATH = Path(__file__).resolve().parent.parent / "contract" / "tools.schema.json"
|
|
@@ -221,6 +226,13 @@ def _install_nonce() -> str:
|
|
|
221
226
|
if not n:
|
|
222
227
|
import uuid
|
|
223
228
|
n = uuid.uuid4().hex[:8]
|
|
229
|
+
# 首装 nonce 必须同步回写内存态 _RT(D-dev-nonce-sync,2026-11-09 真机实锤):
|
|
230
|
+
# _RT 仅模块导入时加载一次,_save_runtime 只落盘——不同步则同进程内每次调用
|
|
231
|
+
# 生成新 nonce:领令牌(设备 A)与提交(设备 B)设备绑定校验失败,重试仍
|
|
232
|
+
# 新 nonce(设备 C)再 401——全新安装首次提交必失败冒给用户(存量安装
|
|
233
|
+
# runtime.json 已有 nonce 不受影响)。同步后领令牌/提交同设备,401→领令牌
|
|
234
|
+
# →重试全程进程内无感。
|
|
235
|
+
_RT["install_nonce"] = n
|
|
224
236
|
try:
|
|
225
237
|
_save_runtime({"install_nonce": n})
|
|
226
238
|
except Exception:
|
|
@@ -238,6 +250,15 @@ def _voice_id(source: str, content: str, nonce: str) -> str:
|
|
|
238
250
|
return f"ext_{source}_{hashlib.sha1((content + nonce).encode('utf-8')).hexdigest()[:12]}"
|
|
239
251
|
|
|
240
252
|
|
|
253
|
+
def _legacy_key_hint() -> str:
|
|
254
|
+
"""旧版残留凭据自愈提示(评审拍板项):出错时给可操作路径,不发公告靠用户撞。
|
|
255
|
+
含当前插件版本与重装命令——重装会刷新 runtime/清掉旧 key 残留。"""
|
|
256
|
+
version = getattr(__import__("vod_mcp"), "__version__", "unknown")
|
|
257
|
+
return ("若为旧版安装残留凭据:更新插件(当前 v" + version + ")并重装即可清除——"
|
|
258
|
+
"npx vod-devkit@latest install --target <宿主> --product <产品名>;"
|
|
259
|
+
"或移除 VOD_JAVA_API_KEY 环境变量走匿名档")
|
|
260
|
+
|
|
261
|
+
|
|
241
262
|
def _explicit_key() -> bool:
|
|
242
263
|
"""当前 JAVA_KEY 是否为显式配置(正式/宿主 key)而非本会话自动领取的匿名令牌。
|
|
243
264
|
|
|
@@ -354,8 +375,8 @@ def submit_voices(params: dict, client_info: dict | None = None,
|
|
|
354
375
|
#(归因错位比报错更糟,同 AIShell 错归病根)
|
|
355
376
|
raise ToolError(
|
|
356
377
|
f"注入的 key 被引擎拒绝(指纹 {_fingerprint(JAVA_KEY)}):"
|
|
357
|
-
"请核对 key 是否过期/被吊销,或移除 key
|
|
358
|
-
|
|
378
|
+
"请核对 key 是否过期/被吊销,或移除 key 走匿名档。"
|
|
379
|
+
+ _legacy_key_hint(),
|
|
359
380
|
code=-32012)
|
|
360
381
|
# 缺 key/匿名令牌失效 → 零字段匿名令牌 → 落 runtime.json → 重试一次
|
|
361
382
|
token = _fetch_anon_token()
|
|
@@ -417,7 +438,8 @@ def submit_voices(params: dict, client_info: dict | None = None,
|
|
|
417
438
|
# 显式 key 被拒 → fail fast(同囤积主路径口径,防静默降级)
|
|
418
439
|
raise ToolError(
|
|
419
440
|
f"注入的 key 被引擎拒绝(指纹 {_fingerprint(JAVA_KEY)}):"
|
|
420
|
-
"请核对 key 是否过期/被吊销,或移除 key
|
|
441
|
+
"请核对 key 是否过期/被吊销,或移除 key 走匿名档。"
|
|
442
|
+
+ _legacy_key_hint(), code=-32012)
|
|
421
443
|
# 零字段匿名令牌:缺 key/401 → 自动取令牌 → 落 runtime.json → 重试一次
|
|
422
444
|
token = _fetch_anon_token()
|
|
423
445
|
if token:
|
|
@@ -479,6 +501,12 @@ def probe_key(key: str | None = None, timeout: int = 8) -> dict:
|
|
|
479
501
|
except ToolError as ex:
|
|
480
502
|
code = ex.code
|
|
481
503
|
if code == 401 or code == -32012:
|
|
504
|
+
# 匿名令牌 401 ≠ 配置错误:报"过期待重领"而非"rejected",
|
|
505
|
+
# 避免 runtime 残留过期匿名令牌时被误读为正式 key 失效
|
|
506
|
+
# (显式 key 被拒仍报 rejected——fail fast 口径不变)
|
|
507
|
+
if not _explicit_key():
|
|
508
|
+
return {"ok": False, "reason": "expired-anonymous", "fingerprint": fp,
|
|
509
|
+
"note": "匿名令牌已过期:下次提交自动重领,无需操作"}
|
|
482
510
|
return {"ok": False, "reason": "rejected", "fingerprint": fp}
|
|
483
511
|
return {"ok": None, "reason": "unreachable", "fingerprint": fp}
|
|
484
512
|
|
|
@@ -504,6 +532,10 @@ def auth_status(params: dict, client_info: dict | None = None) -> dict:
|
|
|
504
532
|
if JAVA_KEY:
|
|
505
533
|
# 主动探针(devkit auth init 真调 IAM 的廉价版):用户问"key 好没好"有确定答案
|
|
506
534
|
out["keyCheck"] = probe_key()
|
|
535
|
+
if _explicit_key():
|
|
536
|
+
# 旧版残留凭据检测位(评审拍板项):显式 key 存活即在位提示自愈路径,
|
|
537
|
+
# 不等提交撞 401 才发现(codex 0.2.3 残留 key 挡匿名链的实锤教训)
|
|
538
|
+
out["legacyKeyHint"] = _legacy_key_hint()
|
|
507
539
|
if not JAVA_KEY:
|
|
508
540
|
out["guidance"] = _KEY_GUIDANCE
|
|
509
541
|
out["tokenReady"] = "首次提交时将自动申请匿名令牌(零字段,日限额低)"
|
|
@@ -709,6 +741,11 @@ def _drafts_purge(store: dict) -> dict:
|
|
|
709
741
|
if v.get("expiresAt", 0) > now}
|
|
710
742
|
|
|
711
743
|
|
|
744
|
+
def _drafts_load() -> dict:
|
|
745
|
+
"""草稿库现读 + 过期惰性清除(draft/commit 单源共用,禁双边漂移)。"""
|
|
746
|
+
return _drafts_purge(_runtime_cfg().get(_DRAFT_KEY) or {})
|
|
747
|
+
|
|
748
|
+
|
|
712
749
|
def draft_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
713
750
|
"""两段式第一步:校验+暂存草稿+签发一次性令牌(不提交任何数据)。"""
|
|
714
751
|
import time as _time
|
|
@@ -744,10 +781,14 @@ def draft_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
|
744
781
|
payload_sha = hashlib.sha256(
|
|
745
782
|
json.dumps(payload, sort_keys=True, ensure_ascii=False).encode()).hexdigest()
|
|
746
783
|
|
|
747
|
-
|
|
748
|
-
store = _drafts_purge(fresh.get(_DRAFT_KEY) or {})
|
|
784
|
+
store = _drafts_load()
|
|
749
785
|
store[draft_id] = {
|
|
750
786
|
"payload": payload, "payloadSha256": payload_sha, "tokenHash": _sha256(token),
|
|
787
|
+
# D-resume-commit-1:token 明文随草稿落盘(runtime.json 0600,与 java_key
|
|
788
|
+
# 同级保护)。token 的威胁模型是"防载荷改写"而非"同意凭证"——落盘不放大
|
|
789
|
+
# 风险,换断回合可续:agent 回合中断后凭 draftId 即可恢复提交(此前
|
|
790
|
+
# approvalToken 只存在于 draft 响应文本,回合断即丢失,只能重开草稿)
|
|
791
|
+
"token": token,
|
|
751
792
|
"product": product, "createdAt": _time.strftime("%Y-%m-%dT%H:%M:%S"),
|
|
752
793
|
"expiresAt": _time.time() + _DRAFT_TTL,
|
|
753
794
|
}
|
|
@@ -770,19 +811,22 @@ def draft_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
|
770
811
|
|
|
771
812
|
|
|
772
813
|
def commit_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
773
|
-
"""两段式第二步:令牌校验→单次消费→复用 submit_voices 既有提交链。
|
|
814
|
+
"""两段式第二步:令牌校验→单次消费→复用 submit_voices 既有提交链。
|
|
815
|
+
|
|
816
|
+
D-resume-commit-1:approvalToken/payloadSha256 可省略——draftId 命中本地
|
|
817
|
+
未过期草稿时自动恢复(断回合续提交)。显式传入仍走原校验(传了假 sha
|
|
818
|
+
照样拒),恢复路径的完整性由签发时落盘的 sha/token 保证,语义不放宽。
|
|
819
|
+
"""
|
|
774
820
|
draft_id = str(params.get("draftId", ""))
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
if not draft_id or not token or not payload_sha:
|
|
778
|
-
raise ToolError("draftId/approvalToken/payloadSha256 为必填(取自 vod_draft_voices 返回原样透传)",
|
|
779
|
-
code=-32602)
|
|
821
|
+
if not draft_id:
|
|
822
|
+
raise ToolError("draftId 为必填(取自 vod_draft_voices 返回原样透传)", code=-32602)
|
|
780
823
|
|
|
781
|
-
|
|
782
|
-
store = _drafts_purge(fresh.get(_DRAFT_KEY) or {})
|
|
824
|
+
store = _drafts_load()
|
|
783
825
|
draft = store.get(draft_id)
|
|
784
826
|
if draft is None:
|
|
785
827
|
raise ToolError("草稿不存在或已过期(10 分钟 TTL),请重新 vod_draft_voices", code=-32011)
|
|
828
|
+
token = str(params.get("approvalToken", "")) or str(draft.get("token", ""))
|
|
829
|
+
payload_sha = str(params.get("payloadSha256", "")) or str(draft["payloadSha256"])
|
|
786
830
|
if draft["tokenHash"] != _sha256(token):
|
|
787
831
|
raise ToolError("审批令牌不匹配(draft 返回的 approvalToken 原样透传)", code=-32011)
|
|
788
832
|
if draft["payloadSha256"] != payload_sha:
|
|
@@ -112,6 +112,10 @@ version: 1
|
|
|
112
112
|
符合诚实回退。**
|
|
113
113
|
4. 引擎侧承载已就绪(t_vod_voice_inbox.repro_steps/expected_behavior,
|
|
114
114
|
issue 渲染带「用户追问补充」来源注记)——本话术非空头承诺(S51 自审过)。
|
|
115
|
+
5. 追问环节状态随行上送(followupStatus,引擎指标字段、issue 不渲染):
|
|
116
|
+
not_asked=未触发追问(已有实质回应/泛化未触发);declined=问了未答
|
|
117
|
+
或答"没有/不方便";answered=已答并随两字段上送。三态白名单,
|
|
118
|
+
不确定就不带键(引擎降 NULL)。
|
|
115
119
|
|
|
116
120
|
**反截断红线(2026-11-08 opencode 实锤)**:用户在引导补充后给出的
|
|
117
121
|
补充句是**完整提交物**,content=该句逐字全量上送,禁止摘取其中片段
|
|
@@ -154,8 +158,14 @@ version: 1
|
|
|
154
158
|
3. 调用 vod_draft_voices 暂存草稿(必须用户已初步同意)→ 把返回的
|
|
155
159
|
contents 逐条**原样**展示给用户核对(禁止改写概括)→ 明确问
|
|
156
160
|
「确认提交吗」→ 用户明确同意后才调 vod_commit_voices(draftId/
|
|
157
|
-
approvalToken/payloadSha256
|
|
161
|
+
approvalToken/payloadSha256 原样透传;断回合场景 token/sha 可省略,
|
|
162
|
+
插件从本地草稿恢复)。单发工具 vod_submit_voices
|
|
158
163
|
仅限无两段式工具的宿主使用。**一次一批**,攒多条一起交也行,但每批都要用户点头
|
|
164
|
+
**用户确认后必须当回合 commit(D-resume-commit-1 话术锁,禁自由裁量)**:
|
|
165
|
+
用户说了"提交/确认/提吧"之后,本回合必须调 vod_commit_voices 收口——
|
|
166
|
+
调用失败或草稿过期就重开草稿再 commit;任何原因提交不成,必须明确
|
|
167
|
+
告诉用户"还没有提交成功",禁止只回一句"好的"就结束(实锤:agent
|
|
168
|
+
draft 后收工,用户说了两次"提交"仍无下文,反馈 40 分钟没进引擎)
|
|
159
169
|
**一次抱怨=一条声音(2026-11-06 实锤红线)**:用户一次表述只提交一条,
|
|
160
170
|
content=原话逐字——禁止拆成多条、禁止生成多个改写变体(实锤:一次
|
|
161
171
|
"网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
|
package/vod_mcp/__init__.py
CHANGED
package/vod_mcp/tools.py
CHANGED
|
@@ -30,12 +30,17 @@ _FOLLOWUP_DECLINES = frozenset({
|
|
|
30
30
|
|
|
31
31
|
def _followup_fields(voice: dict) -> dict:
|
|
32
32
|
"""D-followup-impl-2 单源提取(submit 主路径与 draft 暂存共用,禁双边漂移):
|
|
33
|
-
仅 trim 非空且非拒答词才含键;引擎同口径截 2000;内容永不回流 content。
|
|
33
|
+
仅 trim 非空且非拒答词才含键;引擎同口径截 2000;内容永不回流 content。
|
|
34
|
+
followupStatus(评审八点 #3 引擎侧承载的插件上报):三态白名单归一
|
|
35
|
+
(strip+lower),白名单外/缺失省键——引擎侧降 NULL 不拒收,插件侧同口径双保险。"""
|
|
34
36
|
out = {}
|
|
35
37
|
for _f in ("reproSteps", "expectedBehavior"):
|
|
36
38
|
_val = str(voice.get(_f) or "").strip()
|
|
37
39
|
if _val and _val.lower() not in _FOLLOWUP_DECLINES:
|
|
38
40
|
out[_f] = _val[:2000]
|
|
41
|
+
_st = str(voice.get("followupStatus") or "").strip().lower()
|
|
42
|
+
if _st in ("not_asked", "declined", "answered"):
|
|
43
|
+
out["followupStatus"] = _st
|
|
39
44
|
return out
|
|
40
45
|
|
|
41
46
|
_CONTRACT_PATH = Path(__file__).resolve().parent.parent / "contract" / "tools.schema.json"
|
|
@@ -221,6 +226,13 @@ def _install_nonce() -> str:
|
|
|
221
226
|
if not n:
|
|
222
227
|
import uuid
|
|
223
228
|
n = uuid.uuid4().hex[:8]
|
|
229
|
+
# 首装 nonce 必须同步回写内存态 _RT(D-dev-nonce-sync,2026-11-09 真机实锤):
|
|
230
|
+
# _RT 仅模块导入时加载一次,_save_runtime 只落盘——不同步则同进程内每次调用
|
|
231
|
+
# 生成新 nonce:领令牌(设备 A)与提交(设备 B)设备绑定校验失败,重试仍
|
|
232
|
+
# 新 nonce(设备 C)再 401——全新安装首次提交必失败冒给用户(存量安装
|
|
233
|
+
# runtime.json 已有 nonce 不受影响)。同步后领令牌/提交同设备,401→领令牌
|
|
234
|
+
# →重试全程进程内无感。
|
|
235
|
+
_RT["install_nonce"] = n
|
|
224
236
|
try:
|
|
225
237
|
_save_runtime({"install_nonce": n})
|
|
226
238
|
except Exception:
|
|
@@ -238,6 +250,15 @@ def _voice_id(source: str, content: str, nonce: str) -> str:
|
|
|
238
250
|
return f"ext_{source}_{hashlib.sha1((content + nonce).encode('utf-8')).hexdigest()[:12]}"
|
|
239
251
|
|
|
240
252
|
|
|
253
|
+
def _legacy_key_hint() -> str:
|
|
254
|
+
"""旧版残留凭据自愈提示(评审拍板项):出错时给可操作路径,不发公告靠用户撞。
|
|
255
|
+
含当前插件版本与重装命令——重装会刷新 runtime/清掉旧 key 残留。"""
|
|
256
|
+
version = getattr(__import__("vod_mcp"), "__version__", "unknown")
|
|
257
|
+
return ("若为旧版安装残留凭据:更新插件(当前 v" + version + ")并重装即可清除——"
|
|
258
|
+
"npx vod-devkit@latest install --target <宿主> --product <产品名>;"
|
|
259
|
+
"或移除 VOD_JAVA_API_KEY 环境变量走匿名档")
|
|
260
|
+
|
|
261
|
+
|
|
241
262
|
def _explicit_key() -> bool:
|
|
242
263
|
"""当前 JAVA_KEY 是否为显式配置(正式/宿主 key)而非本会话自动领取的匿名令牌。
|
|
243
264
|
|
|
@@ -354,8 +375,8 @@ def submit_voices(params: dict, client_info: dict | None = None,
|
|
|
354
375
|
#(归因错位比报错更糟,同 AIShell 错归病根)
|
|
355
376
|
raise ToolError(
|
|
356
377
|
f"注入的 key 被引擎拒绝(指纹 {_fingerprint(JAVA_KEY)}):"
|
|
357
|
-
"请核对 key 是否过期/被吊销,或移除 key
|
|
358
|
-
|
|
378
|
+
"请核对 key 是否过期/被吊销,或移除 key 走匿名档。"
|
|
379
|
+
+ _legacy_key_hint(),
|
|
359
380
|
code=-32012)
|
|
360
381
|
# 缺 key/匿名令牌失效 → 零字段匿名令牌 → 落 runtime.json → 重试一次
|
|
361
382
|
token = _fetch_anon_token()
|
|
@@ -417,7 +438,8 @@ def submit_voices(params: dict, client_info: dict | None = None,
|
|
|
417
438
|
# 显式 key 被拒 → fail fast(同囤积主路径口径,防静默降级)
|
|
418
439
|
raise ToolError(
|
|
419
440
|
f"注入的 key 被引擎拒绝(指纹 {_fingerprint(JAVA_KEY)}):"
|
|
420
|
-
"请核对 key 是否过期/被吊销,或移除 key
|
|
441
|
+
"请核对 key 是否过期/被吊销,或移除 key 走匿名档。"
|
|
442
|
+
+ _legacy_key_hint(), code=-32012)
|
|
421
443
|
# 零字段匿名令牌:缺 key/401 → 自动取令牌 → 落 runtime.json → 重试一次
|
|
422
444
|
token = _fetch_anon_token()
|
|
423
445
|
if token:
|
|
@@ -479,6 +501,12 @@ def probe_key(key: str | None = None, timeout: int = 8) -> dict:
|
|
|
479
501
|
except ToolError as ex:
|
|
480
502
|
code = ex.code
|
|
481
503
|
if code == 401 or code == -32012:
|
|
504
|
+
# 匿名令牌 401 ≠ 配置错误:报"过期待重领"而非"rejected",
|
|
505
|
+
# 避免 runtime 残留过期匿名令牌时被误读为正式 key 失效
|
|
506
|
+
# (显式 key 被拒仍报 rejected——fail fast 口径不变)
|
|
507
|
+
if not _explicit_key():
|
|
508
|
+
return {"ok": False, "reason": "expired-anonymous", "fingerprint": fp,
|
|
509
|
+
"note": "匿名令牌已过期:下次提交自动重领,无需操作"}
|
|
482
510
|
return {"ok": False, "reason": "rejected", "fingerprint": fp}
|
|
483
511
|
return {"ok": None, "reason": "unreachable", "fingerprint": fp}
|
|
484
512
|
|
|
@@ -504,6 +532,10 @@ def auth_status(params: dict, client_info: dict | None = None) -> dict:
|
|
|
504
532
|
if JAVA_KEY:
|
|
505
533
|
# 主动探针(devkit auth init 真调 IAM 的廉价版):用户问"key 好没好"有确定答案
|
|
506
534
|
out["keyCheck"] = probe_key()
|
|
535
|
+
if _explicit_key():
|
|
536
|
+
# 旧版残留凭据检测位(评审拍板项):显式 key 存活即在位提示自愈路径,
|
|
537
|
+
# 不等提交撞 401 才发现(codex 0.2.3 残留 key 挡匿名链的实锤教训)
|
|
538
|
+
out["legacyKeyHint"] = _legacy_key_hint()
|
|
507
539
|
if not JAVA_KEY:
|
|
508
540
|
out["guidance"] = _KEY_GUIDANCE
|
|
509
541
|
out["tokenReady"] = "首次提交时将自动申请匿名令牌(零字段,日限额低)"
|
|
@@ -709,6 +741,11 @@ def _drafts_purge(store: dict) -> dict:
|
|
|
709
741
|
if v.get("expiresAt", 0) > now}
|
|
710
742
|
|
|
711
743
|
|
|
744
|
+
def _drafts_load() -> dict:
|
|
745
|
+
"""草稿库现读 + 过期惰性清除(draft/commit 单源共用,禁双边漂移)。"""
|
|
746
|
+
return _drafts_purge(_runtime_cfg().get(_DRAFT_KEY) or {})
|
|
747
|
+
|
|
748
|
+
|
|
712
749
|
def draft_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
713
750
|
"""两段式第一步:校验+暂存草稿+签发一次性令牌(不提交任何数据)。"""
|
|
714
751
|
import time as _time
|
|
@@ -744,10 +781,14 @@ def draft_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
|
744
781
|
payload_sha = hashlib.sha256(
|
|
745
782
|
json.dumps(payload, sort_keys=True, ensure_ascii=False).encode()).hexdigest()
|
|
746
783
|
|
|
747
|
-
|
|
748
|
-
store = _drafts_purge(fresh.get(_DRAFT_KEY) or {})
|
|
784
|
+
store = _drafts_load()
|
|
749
785
|
store[draft_id] = {
|
|
750
786
|
"payload": payload, "payloadSha256": payload_sha, "tokenHash": _sha256(token),
|
|
787
|
+
# D-resume-commit-1:token 明文随草稿落盘(runtime.json 0600,与 java_key
|
|
788
|
+
# 同级保护)。token 的威胁模型是"防载荷改写"而非"同意凭证"——落盘不放大
|
|
789
|
+
# 风险,换断回合可续:agent 回合中断后凭 draftId 即可恢复提交(此前
|
|
790
|
+
# approvalToken 只存在于 draft 响应文本,回合断即丢失,只能重开草稿)
|
|
791
|
+
"token": token,
|
|
751
792
|
"product": product, "createdAt": _time.strftime("%Y-%m-%dT%H:%M:%S"),
|
|
752
793
|
"expiresAt": _time.time() + _DRAFT_TTL,
|
|
753
794
|
}
|
|
@@ -770,19 +811,22 @@ def draft_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
|
770
811
|
|
|
771
812
|
|
|
772
813
|
def commit_voices(params: dict, client_info: dict | None = None) -> dict:
|
|
773
|
-
"""两段式第二步:令牌校验→单次消费→复用 submit_voices 既有提交链。
|
|
814
|
+
"""两段式第二步:令牌校验→单次消费→复用 submit_voices 既有提交链。
|
|
815
|
+
|
|
816
|
+
D-resume-commit-1:approvalToken/payloadSha256 可省略——draftId 命中本地
|
|
817
|
+
未过期草稿时自动恢复(断回合续提交)。显式传入仍走原校验(传了假 sha
|
|
818
|
+
照样拒),恢复路径的完整性由签发时落盘的 sha/token 保证,语义不放宽。
|
|
819
|
+
"""
|
|
774
820
|
draft_id = str(params.get("draftId", ""))
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
if not draft_id or not token or not payload_sha:
|
|
778
|
-
raise ToolError("draftId/approvalToken/payloadSha256 为必填(取自 vod_draft_voices 返回原样透传)",
|
|
779
|
-
code=-32602)
|
|
821
|
+
if not draft_id:
|
|
822
|
+
raise ToolError("draftId 为必填(取自 vod_draft_voices 返回原样透传)", code=-32602)
|
|
780
823
|
|
|
781
|
-
|
|
782
|
-
store = _drafts_purge(fresh.get(_DRAFT_KEY) or {})
|
|
824
|
+
store = _drafts_load()
|
|
783
825
|
draft = store.get(draft_id)
|
|
784
826
|
if draft is None:
|
|
785
827
|
raise ToolError("草稿不存在或已过期(10 分钟 TTL),请重新 vod_draft_voices", code=-32011)
|
|
828
|
+
token = str(params.get("approvalToken", "")) or str(draft.get("token", ""))
|
|
829
|
+
payload_sha = str(params.get("payloadSha256", "")) or str(draft["payloadSha256"])
|
|
786
830
|
if draft["tokenHash"] != _sha256(token):
|
|
787
831
|
raise ToolError("审批令牌不匹配(draft 返回的 approvalToken 原样透传)", code=-32011)
|
|
788
832
|
if draft["payloadSha256"] != payload_sha:
|