vod-devkit 0.5.5 → 0.5.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/QUICKSTART.md +47 -23
  3. package/README.en.md +7 -2
  4. package/README.md +6 -2
  5. package/bin/vod-devkit +12 -1164
  6. package/contract/tools.schema.json +1 -1
  7. package/package.json +11 -2
  8. package/plugins/vod-devkit/.codex-plugin/plugin.json +1 -1
  9. package/plugins/vod-devkit/build-info.json +3 -3
  10. package/plugins/vod-devkit/contract/tools.schema.json +446 -0
  11. package/plugins/vod-devkit/safety/policy.json +48 -0
  12. package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
  13. package/plugins/vod-devkit/vod_mcp/host_adapters/base.py +3 -1
  14. package/plugins/vod-devkit/vod_mcp/host_adapters/codex.py +14 -0
  15. package/plugins/vod-devkit/vod_mcp/host_adapters/hermes.py +88 -11
  16. package/plugins/vod-devkit/vod_mcp/hosts.py +3 -1
  17. package/plugins/vod-devkit/vod_mcp/net.py +251 -0
  18. package/plugins/vod-devkit/vod_mcp/packs/collect.py +684 -0
  19. package/plugins/vod-devkit/vod_mcp/packs/core.py +80 -0
  20. package/plugins/vod-devkit/vod_mcp/packs/knowledge.py +17 -0
  21. package/plugins/vod-devkit/vod_mcp/paths.py +38 -0
  22. package/plugins/vod-devkit/vod_mcp/payload.py +3 -1
  23. package/plugins/vod-devkit/vod_mcp/policy.py +3 -2
  24. package/plugins/vod-devkit/vod_mcp/provenance.py +3 -2
  25. package/plugins/vod-devkit/vod_mcp/runtime_state.py +324 -0
  26. package/plugins/vod-devkit/vod_mcp/server.py +10 -7
  27. package/plugins/vod-devkit/vod_mcp/skills_registry.py +5 -4
  28. package/plugins/vod-devkit/vod_mcp/tools.py +23 -1298
  29. package/plugins/vod-devkit/vod_mcp/transport_remote.py +21 -9
  30. package/plugins/vod-devkit/vod_mcp/update_check.py +1 -1
  31. package/vod_mcp/__init__.py +1 -1
  32. package/vod_mcp/host_adapters/__pycache__/__init__.cpython-39.pyc +0 -0
  33. package/vod_mcp/host_adapters/__pycache__/atomcode.cpython-39.pyc +0 -0
  34. package/vod_mcp/host_adapters/__pycache__/base.cpython-314.pyc +0 -0
  35. package/vod_mcp/host_adapters/__pycache__/base.cpython-39.pyc +0 -0
  36. package/vod_mcp/host_adapters/__pycache__/codearts.cpython-39.pyc +0 -0
  37. package/vod_mcp/host_adapters/__pycache__/codeartswork.cpython-39.pyc +0 -0
  38. package/vod_mcp/host_adapters/__pycache__/codex.cpython-314.pyc +0 -0
  39. package/vod_mcp/host_adapters/__pycache__/codex.cpython-39.pyc +0 -0
  40. package/vod_mcp/host_adapters/__pycache__/codex_desktop.cpython-39.pyc +0 -0
  41. package/vod_mcp/host_adapters/__pycache__/dsh.cpython-39.pyc +0 -0
  42. package/vod_mcp/host_adapters/__pycache__/generic.cpython-39.pyc +0 -0
  43. package/vod_mcp/host_adapters/__pycache__/hermes.cpython-314.pyc +0 -0
  44. package/vod_mcp/host_adapters/__pycache__/hermes.cpython-39.pyc +0 -0
  45. package/vod_mcp/host_adapters/__pycache__/opencode.cpython-39.pyc +0 -0
  46. package/vod_mcp/host_adapters/__pycache__/workbuddy.cpython-39.pyc +0 -0
  47. package/vod_mcp/host_adapters/base.py +3 -1
  48. package/vod_mcp/host_adapters/codex.py +14 -0
  49. package/vod_mcp/host_adapters/hermes.py +88 -11
  50. package/vod_mcp/hosts.py +3 -1
  51. package/vod_mcp/net.py +251 -0
  52. package/vod_mcp/packs/__pycache__/__init__.cpython-314.pyc +0 -0
  53. package/vod_mcp/packs/__pycache__/__init__.cpython-39.pyc +0 -0
  54. package/vod_mcp/packs/__pycache__/collect.cpython-314.pyc +0 -0
  55. package/vod_mcp/packs/__pycache__/collect.cpython-39.pyc +0 -0
  56. package/vod_mcp/packs/__pycache__/core.cpython-314.pyc +0 -0
  57. package/vod_mcp/packs/__pycache__/core.cpython-39.pyc +0 -0
  58. package/vod_mcp/packs/__pycache__/knowledge.cpython-314.pyc +0 -0
  59. package/vod_mcp/packs/__pycache__/knowledge.cpython-39.pyc +0 -0
  60. package/vod_mcp/packs/collect.py +684 -0
  61. package/vod_mcp/packs/core.py +80 -0
  62. package/vod_mcp/packs/knowledge.py +17 -0
  63. package/vod_mcp/paths.py +38 -0
  64. package/vod_mcp/payload.py +3 -1
  65. package/vod_mcp/policy.py +3 -2
  66. package/vod_mcp/provenance.py +3 -2
  67. package/vod_mcp/runtime_state.py +324 -0
  68. package/vod_mcp/server.py +10 -7
  69. package/vod_mcp/skills_registry.py +5 -4
  70. package/vod_mcp/tools.py +23 -1298
  71. package/vod_mcp/transport_remote.py +21 -9
  72. package/vod_mcp/update_check.py +1 -1
  73. package/vodkit_cli/__init__.py +10 -0
  74. package/vodkit_cli/__pycache__/__init__.cpython-314.pyc +0 -0
  75. package/vodkit_cli/__pycache__/__init__.cpython-39.pyc +0 -0
  76. package/vodkit_cli/__pycache__/cli.cpython-314.pyc +0 -0
  77. package/vodkit_cli/__pycache__/cli.cpython-39.pyc +0 -0
  78. package/vodkit_cli/__pycache__/common.cpython-314.pyc +0 -0
  79. package/vodkit_cli/__pycache__/common.cpython-39.pyc +0 -0
  80. package/vodkit_cli/__pycache__/doctor.cpython-314.pyc +0 -0
  81. package/vodkit_cli/__pycache__/doctor.cpython-39.pyc +0 -0
  82. package/vodkit_cli/__pycache__/install.cpython-314.pyc +0 -0
  83. package/vodkit_cli/__pycache__/install.cpython-39.pyc +0 -0
  84. package/vodkit_cli/__pycache__/remote.cpython-314.pyc +0 -0
  85. package/vodkit_cli/__pycache__/remote.cpython-39.pyc +0 -0
  86. package/vodkit_cli/__pycache__/uninstall.cpython-314.pyc +0 -0
  87. package/vodkit_cli/__pycache__/uninstall.cpython-39.pyc +0 -0
  88. package/vodkit_cli/__pycache__/update.cpython-314.pyc +0 -0
  89. package/vodkit_cli/__pycache__/update.cpython-39.pyc +0 -0
  90. package/vodkit_cli/cli.py +86 -0
  91. package/vodkit_cli/common.py +254 -0
  92. package/vodkit_cli/doctor.py +269 -0
  93. package/vodkit_cli/install.py +260 -0
  94. package/vodkit_cli/remote.py +200 -0
  95. package/vodkit_cli/uninstall.py +161 -0
  96. package/vodkit_cli/update.py +45 -0
  97. /package/plugins/vod-devkit/vod_mcp/{packs.py → packs/__init__.py} +0 -0
  98. /package/vod_mcp/{packs.py → packs/__init__.py} +0 -0
@@ -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.5",
4
+ "version": "0.5.9",
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": "vod-devkit",
3
- "version": "0.5.5",
3
+ "version": "0.5.9",
4
4
  "description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -10,6 +10,7 @@
10
10
  "files": [
11
11
  "npm/cli.js",
12
12
  "bin/vod-devkit",
13
+ "vodkit_cli",
13
14
  "skills/",
14
15
  "contract/",
15
16
  "integrations/",
@@ -21,7 +22,10 @@
21
22
  "vod_mcp/__init__.py",
22
23
  "vod_mcp/server.py",
23
24
  "vod_mcp/tools.py",
24
- "vod_mcp/packs.py",
25
+ "vod_mcp/net.py",
26
+ "vod_mcp/runtime_state.py",
27
+ "vod_mcp/packs",
28
+ "vod_mcp/paths.py",
25
29
  "vod_mcp/policy.py",
26
30
  "vod_mcp/config_forms.py",
27
31
  "vod_mcp/skills_registry.py",
@@ -43,6 +47,8 @@
43
47
  "plugins/vod-devkit/build-info.json",
44
48
  "plugins/vod-devkit/vod_mcp",
45
49
  "plugins/vod-devkit/skills",
50
+ "plugins/vod-devkit/contract",
51
+ "plugins/vod-devkit/safety",
46
52
  "plugins/.agents/plugins/marketplace.json"
47
53
  ],
48
54
  "keywords": [
@@ -59,5 +65,8 @@
59
65
  },
60
66
  "engines": {
61
67
  "node": ">=18"
68
+ },
69
+ "scripts": {
70
+ "prepack": "python3 scripts/sync_plugin.py > /dev/null"
62
71
  }
63
72
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.5.5",
3
+ "version": "0.5.9",
4
4
  "description": "VOD user-feedback collection: structured voice capture and submission to the VOD hoarding endpoint.",
5
5
  "keywords": [
6
6
  "feedback",
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.5.5",
3
- "commitSha": "f3fa14da66a8f1b6ae81b413b01bb6426385dd8b",
4
- "builtAt": "2026-11-13T01:46:16",
2
+ "version": "0.5.9",
3
+ "commitSha": "3c4fb77c8af5c119e1ce85f821672d4fcb522856",
4
+ "builtAt": "2026-11-15T18:03:35",
5
5
  "sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
6
6
  }
@@ -0,0 +1,446 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "vod-devkit MCP 工具契约(唯一事实源)",
4
+ "version": "0.5.9",
5
+ "tools": {
6
+ "vod_submit_voices": {
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
+ "input": {
9
+ "type": "object",
10
+ "properties": {
11
+ "voices": {
12
+ "type": "array",
13
+ "minItems": 1,
14
+ "maxItems": 50,
15
+ "items": {
16
+ "type": "object",
17
+ "properties": {
18
+ "content": {
19
+ "type": "string",
20
+ "minLength": 1,
21
+ "maxLength": 2000
22
+ },
23
+ "userType": {
24
+ "type": "string"
25
+ },
26
+ "tags": {
27
+ "type": "array",
28
+ "items": {
29
+ "type": "string"
30
+ },
31
+ "description": "采集层分类标注(可选):分类值写成 `problem_type:<六类之一>`,值域=引擎 meta.problemTypes;白名单外的 problem_type 值由插件丢弃并在回执 invalidTags 里报出(不拒收声音)。其它语义的 tag 不参与分类校验、原样保留"
32
+ },
33
+ "reproSteps": {
34
+ "type": "string",
35
+ "maxLength": 2000,
36
+ "description": "用户追问补充(可选):复现步骤,来自固定追问一次的用户原话摘录;禁止改写/混入 content;超 2000 截断;未追问或用户答“没有”不得传"
37
+ },
38
+ "expectedBehavior": {
39
+ "type": "string",
40
+ "maxLength": 2000,
41
+ "description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
42
+ },
43
+ "followupStatus": {
44
+ "type": "string",
45
+ "enum": [
46
+ "not_asked",
47
+ "declined",
48
+ "answered"
49
+ ],
50
+ "maxLength": 32,
51
+ "description": "追问环节状态(可选,按 S67-S70 判定结果上送):not_asked=未触发追问;declined=问了未答/拒答;answered=已答并随 reproSteps/expectedBehavior。白名单外值引擎降 NULL 不拒收"
52
+ }
53
+ },
54
+ "required": [
55
+ "content"
56
+ ],
57
+ "description": "用户反馈声音列表(content 必填;reproSteps/expectedBehavior 仅追问有答时上送)"
58
+ },
59
+ "description": "用户反馈声音列表(content 必填)"
60
+ },
61
+ "confirmed": {
62
+ "type": "boolean",
63
+ "default": false,
64
+ "description": "用户已确认为 true 才执行(confirm 护栏,逐次同意)"
65
+ },
66
+ "product": {
67
+ "type": "string",
68
+ "description": "用户明确回答的产品(产品名或平台主键 ID)。**只有在已经问过用户、并得到回答后才能填**;不要用模型自己的猜测。插件仍会先用用户原话里的产品名做归因,回答只用于补齐。"
69
+ },
70
+ "productNotSpecified": {
71
+ "type": "boolean",
72
+ "default": false,
73
+ "description": "用户明确表示不知道/随便/不指定时传 true → 按宿主产品记录,回执标 productSource=host_default、confidence=low,可被运营修正。不是用来跳过询问的开关。"
74
+ }
75
+ },
76
+ "required": [
77
+ "voices"
78
+ ]
79
+ },
80
+ "output": {
81
+ "type": "object",
82
+ "properties": {
83
+ "accepted": {
84
+ "type": "integer"
85
+ },
86
+ "voiceIds": {
87
+ "type": "array",
88
+ "items": {
89
+ "type": "string"
90
+ }
91
+ },
92
+ "rejected": {
93
+ "type": "array"
94
+ },
95
+ "taskIds": {
96
+ "type": "array",
97
+ "items": {
98
+ "type": [
99
+ "integer",
100
+ "null"
101
+ ]
102
+ },
103
+ "description": "引擎分析任务 ID(与 voiceIds 对位;幂等重发为 null)"
104
+ },
105
+ "echo": {
106
+ "type": "object",
107
+ "description": "原话回显(方案 A,检测型防线):requiresUserEcho=true 时 agent 必须向用户逐条原样转述 contents(「已收录原话:<content>」),禁止改写/概括;用户借此当场发现宿主模型是否改写了原话",
108
+ "properties": {
109
+ "requiresUserEcho": {
110
+ "type": "boolean"
111
+ },
112
+ "instruction": {
113
+ "type": "string"
114
+ },
115
+ "contents": {
116
+ "type": "array",
117
+ "items": {
118
+ "type": "object",
119
+ "properties": {
120
+ "voiceId": {
121
+ "type": "string"
122
+ },
123
+ "content": {
124
+ "type": "string"
125
+ }
126
+ },
127
+ "required": [
128
+ "voiceId",
129
+ "content"
130
+ ]
131
+ }
132
+ }
133
+ },
134
+ "required": [
135
+ "requiresUserEcho",
136
+ "instruction",
137
+ "contents"
138
+ ]
139
+ }
140
+ },
141
+ "required": [
142
+ "accepted",
143
+ "voiceIds",
144
+ "echo"
145
+ ]
146
+ },
147
+ "backend": "java(VOD_JAVA_API_BASE+VOD_JAVA_API_KEY);现有 /external/voice/submit"
148
+ },
149
+ "vod_devkit_info": {
150
+ "description": "插件自述(只读,core pack 常驻):版本/commitSHA/宿主身份/安装信息。",
151
+ "input": {
152
+ "type": "object",
153
+ "properties": {}
154
+ },
155
+ "output": {
156
+ "type": "object",
157
+ "properties": {
158
+ "version": {
159
+ "type": "string"
160
+ },
161
+ "commitSha": {
162
+ "type": "string"
163
+ },
164
+ "hostClient": {
165
+ "type": "object"
166
+ }
167
+ },
168
+ "required": [
169
+ "version",
170
+ "commitSha"
171
+ ]
172
+ },
173
+ "backend": "local(无上游)"
174
+ },
175
+ "vod_auth_status": {
176
+ "description": "认证自检(只读,无 key 也能跑):报告双后端 key 配置态(指纹非明文)、连通性、环境指向、生效 packs。缺 key 时输出结构化引导(申请步骤)。",
177
+ "input": {
178
+ "type": "object",
179
+ "properties": {}
180
+ },
181
+ "output": {
182
+ "type": "object",
183
+ "properties": {
184
+ "javaKey": {
185
+ "type": "object"
186
+ },
187
+ "workflowKey": {
188
+ "type": "object"
189
+ },
190
+ "packs": {
191
+ "type": "array"
192
+ },
193
+ "guidance": {
194
+ "type": "array"
195
+ }
196
+ },
197
+ "required": [
198
+ "javaKey",
199
+ "workflowKey"
200
+ ]
201
+ },
202
+ "backend": "local(无上游;探测时轻量 ping)"
203
+ },
204
+ "vod_list_submitted": {
205
+ "description": "查询本机已提交的声音(只读)。本地账本(cap 200),最新在前;跨机/权威查询随引擎端点(VOD-VOI)。终端用户进度追问由 agent 凭此对账回答。",
206
+ "input": {
207
+ "type": "object",
208
+ "properties": {
209
+ "limit": {
210
+ "type": "integer",
211
+ "minimum": 1,
212
+ "maximum": 100,
213
+ "default": 20
214
+ }
215
+ }
216
+ },
217
+ "output": {
218
+ "type": "object",
219
+ "properties": {
220
+ "total": {
221
+ "type": "integer"
222
+ },
223
+ "submissions": {
224
+ "type": "array"
225
+ },
226
+ "scope": {
227
+ "type": "string"
228
+ }
229
+ },
230
+ "required": [
231
+ "total",
232
+ "submissions"
233
+ ]
234
+ },
235
+ "backend": "local(无上游;读本机 runtime.json 账本)"
236
+ },
237
+ "vod_draft_voices": {
238
+ "description": "提交用户反馈的第一步(两段式 draft→commit)。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止调用**。本工具只暂存草稿并签发一次性令牌,不会提交任何数据。返回 draftId/approvalToken/contents——拿到后必须把 contents 里的每条内容原样展示给用户核对(禁止改写概括),明确问'确认提交吗',用户同意后才能调用 vod_commit_voices;用户不同意则不调用(草稿自动过期作废)。content 放用户原话逐字(哪怕只有一句'体验很差')。追问纪律同 vod_submit_voices:确认环节固定追问至多一次(问句逐字见其描述),答案只摘录进 reproSteps/expectedBehavior 禁回填 content;答\"没有\"直接进入确认展示。product 归因由插件从用户原话解析(安装绑定仅作先验),禁止询问用户'提交到哪个产品',模型/用户自报的目标产品不采信。禁止向用户解释内部机制(令牌/草稿/配额/归因)。",
239
+ "input": {
240
+ "type": "object",
241
+ "properties": {
242
+ "voices": {
243
+ "type": "array",
244
+ "minItems": 1,
245
+ "maxItems": 50,
246
+ "items": {
247
+ "type": "object",
248
+ "properties": {
249
+ "content": {
250
+ "type": "string",
251
+ "minLength": 1,
252
+ "maxLength": 2000
253
+ },
254
+ "userType": {
255
+ "type": "string"
256
+ },
257
+ "tags": {
258
+ "type": "array",
259
+ "items": {
260
+ "type": "string"
261
+ },
262
+ "description": "采集层分类标注(可选):分类值写成 `problem_type:<六类之一>`,值域=引擎 meta.problemTypes;白名单外的 problem_type 值由插件丢弃并在回执 invalidTags 里报出(不拒收声音)。其它语义的 tag 不参与分类校验、原样保留"
263
+ },
264
+ "reproSteps": {
265
+ "type": "string",
266
+ "maxLength": 2000,
267
+ "description": "用户追问补充(可选):复现步骤,来自固定追问一次的用户原话摘录;禁止改写/混入 content;超 2000 截断;未追问或用户答“没有”不得传"
268
+ },
269
+ "expectedBehavior": {
270
+ "type": "string",
271
+ "maxLength": 2000,
272
+ "description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
273
+ },
274
+ "followupStatus": {
275
+ "type": "string",
276
+ "enum": [
277
+ "not_asked",
278
+ "declined",
279
+ "answered"
280
+ ],
281
+ "maxLength": 32,
282
+ "description": "追问环节状态(可选,按 S67-S70 判定结果上送):not_asked=未触发追问;declined=问了未答/拒答;answered=已答并随 reproSteps/expectedBehavior。白名单外值引擎降 NULL 不拒收"
283
+ }
284
+ },
285
+ "required": [
286
+ "content"
287
+ ],
288
+ "description": "用户反馈声音列表(content 必填;reproSteps/expectedBehavior 仅追问有答时上送)"
289
+ },
290
+ "description": "用户反馈声音列表(content 必填)"
291
+ },
292
+ "confirmed": {
293
+ "type": "boolean",
294
+ "default": false,
295
+ "description": "用户已确认为 true 才执行(confirm 护栏,逐次同意)"
296
+ },
297
+ "product": {
298
+ "type": "string",
299
+ "description": "用户明确回答的产品(产品名或平台主键 ID)。**只有在已经问过用户、并得到回答后才能填**;不要用模型自己的猜测。插件仍会先用用户原话里的产品名做归因,回答只用于补齐。"
300
+ },
301
+ "productNotSpecified": {
302
+ "type": "boolean",
303
+ "default": false,
304
+ "description": "用户明确表示不知道/随便/不指定时传 true → 按宿主产品记录,回执标 productSource=host_default、confidence=low,可被运营修正。不是用来跳过询问的开关。"
305
+ }
306
+ },
307
+ "required": [
308
+ "voices"
309
+ ]
310
+ }
311
+ },
312
+ "vod_commit_voices": {
313
+ "description": "提交用户反馈的第二步(两段式 draft→commit),只能在 vod_draft_voices 之后调用。**先决条件:用户已看过草稿内容(draft 返回的 contents)并明确说'确认提交';用户未明确同意禁止调用**。参数 draftId/approvalToken/payloadSha256 全部取自 vod_draft_voices 的返回原样透传,禁止改动。提交成功后把回执 echo.contents 逐条向用户转述(每条以「已收录原话:」开头,content 全文,禁止改写概括增删字词)。令牌一次性:重复 commit 会被拒。禁止向用户解释内部机制。",
314
+ "input": {
315
+ "type": "object",
316
+ "properties": {
317
+ "draftId": {
318
+ "type": "string",
319
+ "minLength": 8,
320
+ "description": "vod_draft_voices 返回的 draftId 原样透传"
321
+ },
322
+ "approvalToken": {
323
+ "type": "string",
324
+ "minLength": 8,
325
+ "description": "vod_draft_voices 返回的 approvalToken 原样透传;断回合场景可省略——插件从本地暂存草稿恢复"
326
+ },
327
+ "payloadSha256": {
328
+ "type": "string",
329
+ "description": "vod_draft_voices 返回的 payloadSha256 原样透传;断回合场景可省略——插件从本地暂存草稿恢复"
330
+ }
331
+ },
332
+ "required": [
333
+ "draftId"
334
+ ],
335
+ "additionalProperties": false
336
+ }
337
+ },
338
+ "vod_list_skills": {
339
+ "description": "列出本插件可用的技能(名称/归属 pack/是否启用/是否原生安装/描述)。只读、零网络。用在两处:①需要判断某个采集或规则问题该读哪本技能时;②确认某个领域规则技能是否因 pack 裁剪而不可用(enabled=false 即不可用,重跑 install 带 --packs 恢复)。领域规则技能用 vod_retrieve_skill 取全文;元技能(vod-core/vod-feedback-collect)由宿主原生技能机制加载,这里只列名用于路由。",
340
+ "input": {
341
+ "type": "object",
342
+ "properties": {},
343
+ "additionalProperties": false
344
+ }
345
+ },
346
+ "vod_retrieve_skill": {
347
+ "description": "按名取一份技能全文(SKILL.md 原文,含 frontmatter)。只读、零网络。用途:当前宿主没有该技能的原生副本(例如没有技能目录的宿主),或本机副本与插件版本不一致时,取与插件同版本的规则全文。领域规则技能(问题分类/评分)归属 knowledge pack——被裁剪时本工具返回错误并给出恢复命令,不会静默返回空。先用 vod_list_skills 查名字;不认识的技能名会连可用清单一起返回。返回里 note 非空时表示内容含内部表名/连接串字样,向用户复述时不要照抄。",
348
+ "input": {
349
+ "type": "object",
350
+ "properties": {
351
+ "name": {
352
+ "type": "string",
353
+ "description": "技能名(来自 vod_list_skills,例如 vod-problem-classification-rules)"
354
+ }
355
+ },
356
+ "required": [
357
+ "name"
358
+ ],
359
+ "additionalProperties": false
360
+ }
361
+ },
362
+ "vod_check_update": {
363
+ "description": "检查本机插件版本是否落后(npm registry latest,24 小时缓存,失败静默)。只读、只在用户问到版本/升级或会话首次自检时调用,不要每轮调用。返回 currentVersion/latestVersion/updateAvailable;有新版时给 upgradeCommand(重跑 install 或 vod-devkit update,本工具从不自升级)。用户不想被提醒时传 dismiss=true,跳过 3 天;用户点名某个版本别再提时传 skip=true(只压该版本,下个版本仍会提醒),clearSkip=true 撤销。preset(产品分发)形态不发外呼,直接告知版本随 agent 发版管理。",
364
+ "input": {
365
+ "type": "object",
366
+ "properties": {
367
+ "dismiss": {
368
+ "type": "boolean",
369
+ "description": "用户明确表示不想再被提醒时传 true(3 天冷却)"
370
+ },
371
+ "skip": {
372
+ "type": "boolean",
373
+ "description": "用户明确说「就这个版本别再提醒」时传 true:只跳过当前 latest 这一个版本,下个版本照常提醒(不提供永久静音)"
374
+ },
375
+ "clearSkip": {
376
+ "type": "boolean",
377
+ "description": "撤销之前的版本跳过设置,恢复正常提醒"
378
+ }
379
+ },
380
+ "additionalProperties": false
381
+ }
382
+ },
383
+ "vod_search_products": {
384
+ "description": "按关键词检索产品名录,返回候选产品(含主键 ID)。用于**问用户是哪个产品之前**给 3-5 个候选,或在用户回答后把名字解析成 ID。只读,不触上游写接口。",
385
+ "input": {
386
+ "type": "object",
387
+ "properties": {
388
+ "query": {
389
+ "type": "string",
390
+ "description": "关键词(用户原话片段或用户回答的产品名)"
391
+ },
392
+ "limit": {
393
+ "type": "integer",
394
+ "default": 5,
395
+ "description": "返回候选数上限(默认 5)"
396
+ }
397
+ },
398
+ "required": [
399
+ "query"
400
+ ]
401
+ },
402
+ "output": {
403
+ "type": "object",
404
+ "properties": {
405
+ "candidates": {
406
+ "type": "array",
407
+ "items": {
408
+ "type": "object",
409
+ "properties": {
410
+ "id": {
411
+ "type": "string"
412
+ },
413
+ "name": {
414
+ "type": "string"
415
+ },
416
+ "score": {
417
+ "type": "number",
418
+ "description": "匹配强度(0-1)"
419
+ }
420
+ }
421
+ }
422
+ },
423
+ "total": {
424
+ "type": "integer"
425
+ }
426
+ },
427
+ "required": [
428
+ "candidates"
429
+ ]
430
+ },
431
+ "backend": "local"
432
+ }
433
+ },
434
+ "backends": {
435
+ "java": {
436
+ "base": "VOD_JAVA_API_BASE",
437
+ "key": "VOD_JAVA_API_KEY",
438
+ "auth": "ExternalApiKeyFilter Bearer"
439
+ },
440
+ "local": {
441
+ "base": null,
442
+ "key": null,
443
+ "auth": null
444
+ }
445
+ }
446
+ }
@@ -0,0 +1,48 @@
1
+ {
2
+ "version": "0.1.0",
3
+ "maxVoicesPerSubmit": 50,
4
+ "rules": [
5
+ {
6
+ "id": "vod-write-submit-voices",
7
+ "category": "write",
8
+ "severity": "confirm",
9
+ "match": {
10
+ "tool": "vod_submit_voices",
11
+ "param": "confirmed",
12
+ "equals": false
13
+ },
14
+ "message": "提交用户反馈声音(内容入库),需用户逐次确认:重试并传 confirmed=true"
15
+ },
16
+ {
17
+ "id": "vod-voices-batch-limit",
18
+ "category": "write",
19
+ "severity": "deny",
20
+ "match": {
21
+ "tool": "vod_submit_voices",
22
+ "param": "voices",
23
+ "gt": "maxVoicesPerSubmit"
24
+ },
25
+ "message": "单批声音条数超上限"
26
+ },
27
+ {
28
+ "id": "vod-no-db-direct",
29
+ "category": "exfil",
30
+ "severity": "deny",
31
+ "match": {
32
+ "field": "text",
33
+ "regex": "(mysql|jdbc|t_vod_|\\bselect\\b.+\\bfrom\\b)\\s"
34
+ },
35
+ "message": "外部工具不允许数据库直连意图"
36
+ },
37
+ {
38
+ "id": "vod-no-credential",
39
+ "category": "exfil",
40
+ "severity": "deny",
41
+ "match": {
42
+ "field": "text",
43
+ "regex": "(access[_-]?key|secret[_-]?key|x[_-]?auth[_-]?token|password|passwd|private[_-]?key)[^\\n]{0,6}(:|=|值|发|读|取)"
44
+ },
45
+ "message": "凭据读取意图被拦截"
46
+ }
47
+ ]
48
+ }
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.5.5"
8
+ __version__ = "0.5.9"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
@@ -4,7 +4,9 @@ import os
4
4
  import shutil
5
5
  from pathlib import Path
6
6
 
7
- ROOT = Path(__file__).resolve().parent.parent.parent
7
+ from vod_mcp import paths
8
+
9
+ ROOT = paths.ROOT
8
10
 
9
11
  # 载荷目录(bin 在 install 前用 payload.stage() 落好并 set_payload_dir 指过来)
10
12
  _PAYLOAD_DIR = None
@@ -149,6 +149,20 @@ def install(args, packs: str) -> Path:
149
149
  agents.write_text(cleaned + "\n", encoding="utf-8")
150
150
  print(f"已移除旧 AGENTS.md 技能块(原生 skill 取代):{agents}")
151
151
  mp_root = ROOT / "plugins"
152
+ # 插件副本是生成物(v0.5.9 起零提交,见 .gitignore)。仓内直跑安装时若还没生成,
153
+ # 这里补一次——否则 codex 只会报“marketplace 里找不到 vod-devkit”,看不出是没 sync。
154
+ if not (mp_root / "vod-devkit" / "vod_mcp").is_dir():
155
+ _sync = ROOT / "scripts" / "sync_plugin.py"
156
+ if _sync.is_file():
157
+ r = subprocess.run([sys.executable, str(_sync)], cwd=ROOT,
158
+ capture_output=True, text=True, timeout=300)
159
+ if r.returncode != 0:
160
+ print(f"[vod-devkit] 生成插件副本失败:{r.stderr[-300:]}", file=sys.stderr)
161
+ sys.exit(2)
162
+ print("已生成插件副本(scripts/sync_plugin.py)")
163
+ else:
164
+ print(f"[vod-devkit] 插件副本缺失:{mp_root / 'vod-devkit'}(npm 包损坏?)", file=sys.stderr)
165
+ sys.exit(2)
152
166
 
153
167
  def _run(cmd):
154
168
  r = subprocess.run(cmd, capture_output=True, text=True, timeout=120)