vod-devkit 0.2.2 → 0.3.0
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 +70 -0
- package/bin/vod-devkit +379 -13
- package/contract/tools.schema.json +138 -4
- 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 +87 -3
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/plugins/vod-devkit/vod_mcp/packs.py +23 -2
- package/plugins/vod-devkit/vod_mcp/server.py +7 -0
- package/plugins/vod-devkit/vod_mcp/tools.py +203 -21
- package/skills/vod-feedback-collect/SKILL.md +87 -3
- package/vod_mcp/__init__.py +1 -1
- package/vod_mcp/packs.py +23 -2
- package/vod_mcp/server.py +7 -0
- package/vod_mcp/tools.py +203 -21
|
@@ -1,10 +1,10 @@
|
|
|
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.3.0",
|
|
5
5
|
"tools": {
|
|
6
6
|
"vod_submit_voices": {
|
|
7
|
-
"description": "
|
|
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>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
|
8
8
|
"input": {
|
|
9
9
|
"type": "object",
|
|
10
10
|
"properties": {
|
|
@@ -28,11 +28,22 @@
|
|
|
28
28
|
"items": {
|
|
29
29
|
"type": "string"
|
|
30
30
|
}
|
|
31
|
+
},
|
|
32
|
+
"reproSteps": {
|
|
33
|
+
"type": "string",
|
|
34
|
+
"maxLength": 2000,
|
|
35
|
+
"description": "用户追问补充(可选):复现步骤,来自固定追问一次的用户原话摘录;禁止改写/混入 content;超 2000 截断;未追问或用户答“没有”不得传"
|
|
36
|
+
},
|
|
37
|
+
"expectedBehavior": {
|
|
38
|
+
"type": "string",
|
|
39
|
+
"maxLength": 2000,
|
|
40
|
+
"description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
|
|
31
41
|
}
|
|
32
42
|
},
|
|
33
43
|
"required": [
|
|
34
44
|
"content"
|
|
35
|
-
]
|
|
45
|
+
],
|
|
46
|
+
"description": "用户反馈声音列表(content 必填;reproSteps/expectedBehavior 仅追问有答时上送)"
|
|
36
47
|
},
|
|
37
48
|
"description": "用户反馈声音列表(content 必填)"
|
|
38
49
|
},
|
|
@@ -74,11 +85,47 @@
|
|
|
74
85
|
]
|
|
75
86
|
},
|
|
76
87
|
"description": "引擎分析任务 ID(与 voiceIds 对位;幂等重发为 null)"
|
|
88
|
+
},
|
|
89
|
+
"echo": {
|
|
90
|
+
"type": "object",
|
|
91
|
+
"description": "原话回显(方案 A,检测型防线):requiresUserEcho=true 时 agent 必须向用户逐条原样转述 contents(「已收录原话:<content>」),禁止改写/概括;用户借此当场发现宿主模型是否改写了原话",
|
|
92
|
+
"properties": {
|
|
93
|
+
"requiresUserEcho": {
|
|
94
|
+
"type": "boolean"
|
|
95
|
+
},
|
|
96
|
+
"instruction": {
|
|
97
|
+
"type": "string"
|
|
98
|
+
},
|
|
99
|
+
"contents": {
|
|
100
|
+
"type": "array",
|
|
101
|
+
"items": {
|
|
102
|
+
"type": "object",
|
|
103
|
+
"properties": {
|
|
104
|
+
"voiceId": {
|
|
105
|
+
"type": "string"
|
|
106
|
+
},
|
|
107
|
+
"content": {
|
|
108
|
+
"type": "string"
|
|
109
|
+
}
|
|
110
|
+
},
|
|
111
|
+
"required": [
|
|
112
|
+
"voiceId",
|
|
113
|
+
"content"
|
|
114
|
+
]
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
"required": [
|
|
119
|
+
"requiresUserEcho",
|
|
120
|
+
"instruction",
|
|
121
|
+
"contents"
|
|
122
|
+
]
|
|
77
123
|
}
|
|
78
124
|
},
|
|
79
125
|
"required": [
|
|
80
126
|
"accepted",
|
|
81
|
-
"voiceIds"
|
|
127
|
+
"voiceIds",
|
|
128
|
+
"echo"
|
|
82
129
|
]
|
|
83
130
|
},
|
|
84
131
|
"backend": "java(VOD_JAVA_API_BASE+VOD_JAVA_API_KEY);现有 /external/voice/submit"
|
|
@@ -170,6 +217,93 @@
|
|
|
170
217
|
]
|
|
171
218
|
},
|
|
172
219
|
"backend": "local(无上游;读本机 runtime.json 账本)"
|
|
220
|
+
},
|
|
221
|
+
"vod_draft_voices": {
|
|
222
|
+
"description": "提交用户反馈的第一步(两段式 draft→commit)。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止调用**。本工具只暂存草稿并签发一次性令牌,不会提交任何数据。返回 draftId/approvalToken/contents——拿到后必须把 contents 里的每条内容原样展示给用户核对(禁止改写概括),明确问'确认提交吗',用户同意后才能调用 vod_commit_voices;用户不同意则不调用(草稿自动过期作废)。content 放用户原话逐字(哪怕只有一句'体验很差')。追问纪律同 vod_submit_voices:确认环节固定追问至多一次(问句逐字见其描述),答案只摘录进 reproSteps/expectedBehavior 禁回填 content;答\"没有\"直接进入确认展示。product 归因由安装绑定自动完成,禁止询问用户'提交到哪个产品',用户自报的目标产品不采信。禁止向用户解释内部机制(令牌/草稿/配额/归因)。",
|
|
223
|
+
"input": {
|
|
224
|
+
"type": "object",
|
|
225
|
+
"properties": {
|
|
226
|
+
"voices": {
|
|
227
|
+
"type": "array",
|
|
228
|
+
"minItems": 1,
|
|
229
|
+
"maxItems": 50,
|
|
230
|
+
"items": {
|
|
231
|
+
"type": "object",
|
|
232
|
+
"properties": {
|
|
233
|
+
"content": {
|
|
234
|
+
"type": "string",
|
|
235
|
+
"minLength": 1,
|
|
236
|
+
"maxLength": 2000
|
|
237
|
+
},
|
|
238
|
+
"userType": {
|
|
239
|
+
"type": "string"
|
|
240
|
+
},
|
|
241
|
+
"tags": {
|
|
242
|
+
"type": "array",
|
|
243
|
+
"items": {
|
|
244
|
+
"type": "string"
|
|
245
|
+
}
|
|
246
|
+
},
|
|
247
|
+
"reproSteps": {
|
|
248
|
+
"type": "string",
|
|
249
|
+
"maxLength": 2000,
|
|
250
|
+
"description": "用户追问补充(可选):复现步骤,来自固定追问一次的用户原话摘录;禁止改写/混入 content;超 2000 截断;未追问或用户答“没有”不得传"
|
|
251
|
+
},
|
|
252
|
+
"expectedBehavior": {
|
|
253
|
+
"type": "string",
|
|
254
|
+
"maxLength": 2000,
|
|
255
|
+
"description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
|
|
256
|
+
}
|
|
257
|
+
},
|
|
258
|
+
"required": [
|
|
259
|
+
"content"
|
|
260
|
+
],
|
|
261
|
+
"description": "用户反馈声音列表(content 必填;reproSteps/expectedBehavior 仅追问有答时上送)"
|
|
262
|
+
},
|
|
263
|
+
"description": "用户反馈声音列表(content 必填)"
|
|
264
|
+
},
|
|
265
|
+
"confirmed": {
|
|
266
|
+
"type": "boolean",
|
|
267
|
+
"default": false,
|
|
268
|
+
"description": "用户已确认为 true 才执行(confirm 护栏,逐次同意)"
|
|
269
|
+
},
|
|
270
|
+
"product": {
|
|
271
|
+
"type": "string",
|
|
272
|
+
"description": "反馈关于的产品(宿主即产品,不设白名单)。归因顺序:本参数显式指定 > 安装绑定默认(install --product,缺省=宿主名,装在 hermes 归 hermes/dsh 归 DSH)> 不带(引擎落 UNKNOWN 档人工归因)。宿主工具自报产品名原样上送,引擎宽松归一(折叠空白+别名收编)。"
|
|
273
|
+
}
|
|
274
|
+
},
|
|
275
|
+
"required": [
|
|
276
|
+
"voices"
|
|
277
|
+
]
|
|
278
|
+
}
|
|
279
|
+
},
|
|
280
|
+
"vod_commit_voices": {
|
|
281
|
+
"description": "提交用户反馈的第二步(两段式 draft→commit),只能在 vod_draft_voices 之后调用。**先决条件:用户已看过草稿内容(draft 返回的 contents)并明确说'确认提交';用户未明确同意禁止调用**。参数 draftId/approvalToken/payloadSha256 全部取自 vod_draft_voices 的返回原样透传,禁止改动。提交成功后把回执 echo.contents 逐条向用户转述(每条以「已收录原话:」开头,content 全文,禁止改写概括增删字词)。令牌一次性:重复 commit 会被拒。禁止向用户解释内部机制。",
|
|
282
|
+
"input": {
|
|
283
|
+
"type": "object",
|
|
284
|
+
"properties": {
|
|
285
|
+
"draftId": {
|
|
286
|
+
"type": "string",
|
|
287
|
+
"minLength": 8,
|
|
288
|
+
"description": "vod_draft_voices 返回的 draftId 原样透传"
|
|
289
|
+
},
|
|
290
|
+
"approvalToken": {
|
|
291
|
+
"type": "string",
|
|
292
|
+
"minLength": 8,
|
|
293
|
+
"description": "vod_draft_voices 返回的 approvalToken 原样透传"
|
|
294
|
+
},
|
|
295
|
+
"payloadSha256": {
|
|
296
|
+
"type": "string",
|
|
297
|
+
"description": "vod_draft_voices 返回的 payloadSha256 原样透传"
|
|
298
|
+
}
|
|
299
|
+
},
|
|
300
|
+
"required": [
|
|
301
|
+
"draftId",
|
|
302
|
+
"approvalToken",
|
|
303
|
+
"payloadSha256"
|
|
304
|
+
],
|
|
305
|
+
"additionalProperties": false
|
|
306
|
+
}
|
|
173
307
|
}
|
|
174
308
|
},
|
|
175
309
|
"backends": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
3
|
-
"commitSha": "
|
|
4
|
-
"builtAt": "2026-11-
|
|
2
|
+
"version": "0.3.0",
|
|
3
|
+
"commitSha": "370ee37cb4cd5bc2284cb0cd7874ec02644fb859",
|
|
4
|
+
"builtAt": "2026-11-08T20:32:08",
|
|
5
5
|
"sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
|
|
6
6
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vod-feedback-collect
|
|
3
|
-
description: '
|
|
3
|
+
description: '用户抱怨/体验差/太慢/报错/提单 → 采集原话进 VOD。识别到抱怨即承接并征得同意(禁止问哪个产品,禁止复现排查模式);content=原话逐字;一次抱怨一条;回执 echo 原样转述。详见正文流程与禁令。Triggers: "体验差","太难用","太慢","报错了","出bug了","有bug","反馈问题","反馈建议","提个单","报告问题","不生效","不好使","操作不方便","卡住了","崩溃了","report a problem","bug report","poor experience","feedback"'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -46,6 +46,82 @@ version: 1
|
|
|
46
46
|
**不追问原则**:内容太泛时引导一次("说下具体现象?"),用户不补
|
|
47
47
|
就按原话提交或放弃——禁止反复追问,禁止替用户脑补现象细节。
|
|
48
48
|
|
|
49
|
+
**模糊反馈固定话术(2026-11-06 真实观测定稿,F3 闭环)**:用户只说
|
|
50
|
+
泛化抱怨("体验不好/很差劲")时,一次性说清三件事,禁止含混反问
|
|
51
|
+
(实锤病句:"请问是否把什么作为反馈"——用户听不懂在问什么):
|
|
52
|
+
1. 承接识别结果("收到,你对产品体验不满意");
|
|
53
|
+
2. 确认收录意愿("要把这条反馈提交给产品团队吗?");
|
|
54
|
+
3. 引导补充+兜底承诺("方便的话说下具体现象,不说我也会按你的
|
|
55
|
+
原话提交")。
|
|
56
|
+
整段一轮说完,不拆两轮、不复读式追问。
|
|
57
|
+
|
|
58
|
+
**追加反馈定性话术(2026-11-06 定稿,S49-S51)**:用户在确认
|
|
59
|
+
环节追加表达(如「我看怎么说,你才明白」这类对沟通过程的
|
|
60
|
+
挫败)时,**先给一句定性再问**,不把「这句话算不算反馈」的
|
|
61
|
+
判断丢给用户;定性必须标注为 **agent 的理解**并留纠正口子,
|
|
62
|
+
不许当事实断言:
|
|
63
|
+
1. 定性(一句话说清这是什么+留口:「这句听起来更像是对刚才
|
|
64
|
+
沟通没被理解的挫败——我理解得对吗?」;「听起来更像」
|
|
65
|
+
而非「就是」,用户可纠正,agent 不替用户下结论);
|
|
66
|
+
2. 确认范围,仅两个真实可执行选项:「连同最初那句一起提交」
|
|
67
|
+
/「只提交最初那句」——用户一句话拍板(都提/只提原句),
|
|
68
|
+
不纠缠、不加第三选项抬高决策成本。括号兜底不进并列选项:
|
|
69
|
+
「想只提交第二句也可以直接说」——极端选择有出口但不抬
|
|
70
|
+
高常规决策成本;
|
|
71
|
+
3. 用户纠正定性后的行为(S50 纠正闭环):不辩论,按用户纠正
|
|
72
|
+
后的理解走,但提交内容仍是用户原话逐字——禁止拿纠正后的
|
|
73
|
+
「新定性」改写 content(一次抱怨一条+原话红线不因纠正豁免);
|
|
74
|
+
话术模板尾句:「如果我理解得不对,直接纠正,我按你说的
|
|
75
|
+
原话提交,不改写」。
|
|
76
|
+
**禁空头承诺(S51)**:不许向用户提供引擎/插件不存在的机制
|
|
77
|
+
——如「这句作为过程反馈单独记录、不混入产品声量」:客户端
|
|
78
|
+
无过程反馈通道,引擎无此分类档(content 入库后由引擎重判),
|
|
79
|
+
承诺即空头支票,用户选了实际做不到。「过程反馈与产品声量
|
|
80
|
+
分离」若确需,属引擎侧新承载,先有承载再进话术。
|
|
81
|
+
依据:对 agent 沟通体验的挫败同样指向宿主产品体验,属真实
|
|
82
|
+
信号;定性由 agent 完成(降低用户决策成本),提交范围决策权
|
|
83
|
+
在用户。
|
|
84
|
+
|
|
85
|
+
**追问补充固定话术(D-followup-impl-2,2026-11-08 负责人确认)**:用户已
|
|
86
|
+
明确要提交(确认环节内)时,允许固定追问**至多一次、一次一问**,问句
|
|
87
|
+
必须逐字使用、禁止改写/拆分/追加第二轮:
|
|
88
|
+
「方便的话,补充一下遇到这个问题时的操作步骤或期望的表现吗?不方便回复"没有",我直接提交。」
|
|
89
|
+
纪律(四约束,违者=引导性提问制造"被暗示的复现步骤"):
|
|
90
|
+
1. 仅摘录用户回答中对应部分进 reproSteps(操作步骤)/ expectedBehavior
|
|
91
|
+
(期望表现)两个独立字段——不改写、不总结;无法拆分时按用户原话落
|
|
92
|
+
入最相关字段;**任何内容禁回填 content**(content 与旧流程逐字一致);
|
|
93
|
+
2. 答"没有/跳过/不方便"或未回答 = 两字段不上送,立即提交(诚实回退,
|
|
94
|
+
不注记不编造);
|
|
95
|
+
3. 除本次固定追问外,禁止再索要严重程度/环境/附件等开发者字段;
|
|
96
|
+
**触发判定块(2026-11-08 负责人确认并二次微调,禁自由裁量)**——固定
|
|
97
|
+
追问不是默认流程,按以下三层可执行判定走:
|
|
98
|
+
1. 触发前置:仅在用户明确说"提交/提吧"后、确认环节内,至多一次;
|
|
99
|
+
不得与引导补充连续两轮问。
|
|
100
|
+
2. 跳过条件:引导补充已获具体现象/场景/报错等非泛化反馈内容且并入
|
|
101
|
+
content → 不触发固定追问。引导补充中自然出现的操作/期望仍保留在
|
|
102
|
+
content 原话,**不回溯摘入新字段**;新字段仅承载固定追问的原样回答
|
|
103
|
+
(来源唯一,content 不被污染、不重复)。
|
|
104
|
+
3. 触发条件:引导补充未获回应,或只得到泛化抱怨,用户又确认提交 →
|
|
105
|
+
才原样带出固定问句至多一次。答了按摘录规则进两字段;答"没有/
|
|
106
|
+
不方便"立即提交、不追问。
|
|
107
|
+
判定例(可执行口径):"未回应"=用户未针对引导补充给出任何具体信息
|
|
108
|
+
(如仅回复"提交/嗯/没有");"泛化抱怨"=仅表达负面评价、无具体现象/
|
|
109
|
+
场景/报错(如"就是有问题/不好用/赶紧修")。
|
|
110
|
+
一句话口径:**跳过固定追问时,reproSteps/expectedBehavior 不上送,
|
|
111
|
+
payload 不含对应键,issue 不出现「(用户追问补充)」段、不作来源注记,
|
|
112
|
+
符合诚实回退。**
|
|
113
|
+
4. 引擎侧承载已就绪(t_vod_voice_inbox.repro_steps/expected_behavior,
|
|
114
|
+
issue 渲染带「用户追问补充」来源注记)——本话术非空头承诺(S51 自审过)。
|
|
115
|
+
|
|
116
|
+
**反截断红线(2026-11-08 opencode 实锤)**:用户在引导补充后给出的
|
|
117
|
+
补充句是**完整提交物**,content=该句逐字全量上送,禁止摘取其中片段
|
|
118
|
+
(实锤:用户说"操作不方便,流程合理",模型自行判断"最新具体抱怨是
|
|
119
|
+
操作不方便"只交了半句——"最新片段"不是裁量对象,整句才是原话)。
|
|
120
|
+
用户多轮分散表达时,把各轮原话按序拼接为 content,同样禁增删改写。
|
|
121
|
+
**拼接判定例(2026-11-08 opencode 第二次实锤后补)**:逐字=含语气词、
|
|
122
|
+
含原有标点,禁删语气词(实锤:原话"产品体验很差劲啊"被拼成"产品体验
|
|
123
|
+
很差劲。"——删"啊"补句号=改写)、禁补标点、禁规范措辞。轮次衔接用
|
|
124
|
+
换行或空格分隔,不新增标点;拼接结果必须能用逐字符比对还原回各轮原文。
|
|
49
125
|
**职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
|
|
50
126
|
产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
|
|
51
127
|
配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
|
|
@@ -75,8 +151,16 @@ version: 1
|
|
|
75
151
|
- content:用户反馈内容(尽量保留用户原话措辞,可轻度去噪)
|
|
76
152
|
- userType:可判断时填(企业/个人),不确定不填
|
|
77
153
|
- tags:明显的主题词(性能/功能/易用性),最多 3 个
|
|
78
|
-
3. 调用
|
|
79
|
-
|
|
154
|
+
3. 调用 vod_draft_voices 暂存草稿(必须用户已初步同意)→ 把返回的
|
|
155
|
+
contents 逐条**原样**展示给用户核对(禁止改写概括)→ 明确问
|
|
156
|
+
「确认提交吗」→ 用户明确同意后才调 vod_commit_voices(draftId/
|
|
157
|
+
approvalToken/payloadSha256 原样透传)。单发工具 vod_submit_voices
|
|
158
|
+
仅限无两段式工具的宿主使用。**一次一批**,攒多条一起交也行,但每批都要用户点头
|
|
159
|
+
**一次抱怨=一条声音(2026-11-06 实锤红线)**:用户一次表述只提交一条,
|
|
160
|
+
content=原话逐字——禁止拆成多条、禁止生成多个改写变体(实锤:一次
|
|
161
|
+
"网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
|
|
162
|
+
两个 issue;引擎幂等按内容逐字比对,改写即绕过)。多条仅当用户明确
|
|
163
|
+
分条给了多个不同反馈
|
|
80
164
|
4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
|
|
81
165
|
**voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
|
|
82
166
|
用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
|
|
@@ -3,23 +3,44 @@
|
|
|
3
3
|
core 常驻(vod_devkit_info + vod-core 技能);未启用的 pack 工具不注册。
|
|
4
4
|
"""
|
|
5
5
|
import os
|
|
6
|
+
import sys
|
|
6
7
|
|
|
7
8
|
ALL_PACKS = ("core", "collect", "knowledge")
|
|
8
9
|
|
|
9
10
|
PACK_TOOLS = {
|
|
10
11
|
"core": ["vod_devkit_info", "vod_auth_status"],
|
|
11
|
-
|
|
12
|
+
# 两段式(D-token-approval-2 极简形态)随 collect 下发;codex 话术走 draft→commit
|
|
13
|
+
"collect": ["vod_submit_voices", "vod_draft_voices", "vod_commit_voices", "vod_list_submitted"],
|
|
12
14
|
"knowledge": [], # 纯技能包:3 个领域规则技能,零工具零依赖
|
|
13
15
|
}
|
|
14
16
|
|
|
15
17
|
|
|
18
|
+
BREAKER_MARKERS = (
|
|
19
|
+
# 熔断标记(D-codex-circuit-breaker-1):install 门禁可被
|
|
20
|
+
# `VOD_PACKS=core,collect serve` 绕过——运行期同查标记强制降级
|
|
21
|
+
os.path.expanduser("~/.codex/vod-collect-suspended.json"),
|
|
22
|
+
)
|
|
23
|
+
|
|
24
|
+
|
|
16
25
|
def enabled_packs() -> tuple:
|
|
17
26
|
raw = os.environ.get("VOD_PACKS", "").strip()
|
|
18
27
|
if not raw:
|
|
19
28
|
return ALL_PACKS
|
|
20
|
-
|
|
29
|
+
# kb=knowledge 旧称别名(历史文档/用户习惯;深审 P0-2 配套:安装口
|
|
30
|
+
# 旧值不因运行口改名而静默失效)
|
|
31
|
+
packs = tuple(p.strip() for p in raw.split(","))
|
|
32
|
+
packs = tuple("knowledge" if p == "kb" else p for p in packs)
|
|
33
|
+
packs = tuple(p for p in packs if p in ALL_PACKS)
|
|
21
34
|
if "core" not in packs:
|
|
22
35
|
packs = ("core",) + packs
|
|
36
|
+
if "collect" in packs and any(os.path.isfile(m) for m in BREAKER_MARKERS):
|
|
37
|
+
# 运行期熔断门禁:collect 强制摘除(非静默——stderr 告警)。
|
|
38
|
+
# 解除=删熔断标记(install --ack-suspension 即此语义)
|
|
39
|
+
packs = tuple(p for p in packs if p != "collect")
|
|
40
|
+
print("[vod-devkit] 采集熔断生效(codex 未确认提交 ≥2 次,"
|
|
41
|
+
"D-codex-circuit-breaker-1):collect 已强制摘除。"
|
|
42
|
+
"恢复前置=token 化上线并过回归;--ack-suspension 解除安装门禁,"
|
|
43
|
+
"运行期解除须删熔断标记", file=sys.stderr)
|
|
23
44
|
return packs
|
|
24
45
|
|
|
25
46
|
|
|
@@ -35,6 +35,13 @@ def handle(message: dict) -> dict | None:
|
|
|
35
35
|
return _result(req_id, {
|
|
36
36
|
"protocolVersion": _PROTOCOL_VERSION,
|
|
37
37
|
"capabilities": {"tools": {}},
|
|
38
|
+
"instructions": (
|
|
39
|
+
"vod-devkit 采集资产与纪律:技能 vod-feedback-collect 处理用户对"
|
|
40
|
+
"本产品的不满/建议/期望(触发词:慢/报错/体验差/希望支持/提单等)。"
|
|
41
|
+
"提交前必须征得用户明确同意(用户抱怨本身不构成同意);提交回执"
|
|
42
|
+
"echo.contents 必须逐条原样转述给用户(「已收录原话:<content>」),"
|
|
43
|
+
"禁止改写、概括、增删字词。product 归因由安装绑定完成,禁止询问用户。"
|
|
44
|
+
),
|
|
38
45
|
"serverInfo": {
|
|
39
46
|
"name": "vod-devkit",
|
|
40
47
|
"version": tools.load_contract()["version"],
|