vod-devkit 0.5.4 → 0.5.8
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 +43 -0
- package/QUICKSTART.md +47 -23
- package/README.en.md +7 -2
- package/README.md +6 -2
- package/bin/vod-devkit +12 -1166
- package/contract/tools.schema.json +1 -1
- package/integrations/atomcode/host.json +5 -3
- package/integrations/codeartsdoer/host.json +1 -2
- package/package.json +8 -2
- 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 +446 -0
- package/plugins/vod-devkit/safety/policy.json +48 -0
- package/plugins/vod-devkit/skills/vod-feedback-collect/SKILL.md +13 -4
- package/plugins/vod-devkit/skills/vod-problem-classification-rules/SKILL.md +2 -1
- package/plugins/vod-devkit/skills/vod-scoring-rules/SKILL.md +2 -1
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/plugins/vod-devkit/vod_mcp/__pycache__/__init__.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/attribution.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/net.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/paths.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/policy.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/provenance.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/runtime_state.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/skills_registry.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/__pycache__/tools.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/attribution.py +8 -8
- package/plugins/vod-devkit/vod_mcp/host_adapters/base.py +3 -1
- package/plugins/vod-devkit/vod_mcp/host_adapters/codex.py +16 -3
- package/plugins/vod-devkit/vod_mcp/host_adapters/hermes.py +99 -16
- package/plugins/vod-devkit/vod_mcp/hosts.py +3 -1
- package/plugins/vod-devkit/vod_mcp/net.py +251 -0
- package/plugins/vod-devkit/vod_mcp/packs/__pycache__/__init__.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/packs/__pycache__/collect.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/packs/__pycache__/core.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/packs/__pycache__/knowledge.cpython-314.pyc +0 -0
- package/plugins/vod-devkit/vod_mcp/packs/collect.py +684 -0
- package/plugins/vod-devkit/vod_mcp/packs/core.py +80 -0
- package/plugins/vod-devkit/vod_mcp/packs/knowledge.py +17 -0
- package/plugins/vod-devkit/vod_mcp/paths.py +38 -0
- package/plugins/vod-devkit/vod_mcp/payload.py +3 -1
- package/plugins/vod-devkit/vod_mcp/policy.py +3 -2
- package/plugins/vod-devkit/vod_mcp/provenance.py +3 -2
- package/plugins/vod-devkit/vod_mcp/remote_app.py +25 -0
- package/plugins/vod-devkit/vod_mcp/runtime_state.py +324 -0
- package/plugins/vod-devkit/vod_mcp/server.py +10 -7
- package/plugins/vod-devkit/vod_mcp/skills_registry.py +11 -9
- package/plugins/vod-devkit/vod_mcp/tools.py +23 -1300
- package/plugins/vod-devkit/vod_mcp/transport_remote.py +68 -8
- package/plugins/vod-devkit/vod_mcp/update_check.py +1 -1
- package/skills/vod-feedback-collect/SKILL.md +13 -4
- package/skills/vod-problem-classification-rules/SKILL.md +2 -1
- package/skills/vod-scoring-rules/SKILL.md +2 -1
- package/vod_mcp/__init__.py +1 -1
- package/vod_mcp/attribution.py +8 -8
- package/vod_mcp/host_adapters/__pycache__/__init__.cpython-39.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-39.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-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/dsh.cpython-39.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-39.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/workbuddy.cpython-39.pyc +0 -0
- package/vod_mcp/host_adapters/base.py +3 -1
- package/vod_mcp/host_adapters/codex.py +16 -3
- package/vod_mcp/host_adapters/hermes.py +99 -16
- package/vod_mcp/hosts.py +3 -1
- package/vod_mcp/net.py +251 -0
- 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/collect.py +684 -0
- package/vod_mcp/packs/core.py +80 -0
- package/vod_mcp/packs/knowledge.py +17 -0
- package/vod_mcp/paths.py +38 -0
- package/vod_mcp/payload.py +3 -1
- package/vod_mcp/policy.py +3 -2
- package/vod_mcp/provenance.py +3 -2
- package/vod_mcp/remote_app.py +25 -0
- package/vod_mcp/runtime_state.py +324 -0
- package/vod_mcp/server.py +10 -7
- package/vod_mcp/skills_registry.py +11 -9
- package/vod_mcp/tools.py +23 -1300
- package/vod_mcp/transport_remote.py +68 -8
- package/vod_mcp/update_check.py +1 -1
- package/vodkit_cli/__init__.py +10 -0
- 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/cli.py +86 -0
- package/vodkit_cli/common.py +254 -0
- package/vodkit_cli/doctor.py +269 -0
- package/vodkit_cli/install.py +260 -0
- package/vodkit_cli/remote.py +200 -0
- package/vodkit_cli/uninstall.py +161 -0
- package/vodkit_cli/update.py +45 -0
- /package/plugins/vod-devkit/vod_mcp/{packs.py → packs/__init__.py} +0 -0
- /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.
|
|
4
|
+
"version": "0.5.8",
|
|
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>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "atomcode",
|
|
3
3
|
"cli": "atomcode",
|
|
4
|
-
"detect": {
|
|
4
|
+
"detect": {
|
|
5
|
+
"path": "~/.atomcode"
|
|
6
|
+
},
|
|
5
7
|
"config": "~/.atomcode/mcp.json",
|
|
6
8
|
"skillsDir": "~/.atomcode/skills",
|
|
7
|
-
"notes": "AtomCode 的配置根可由 ATOMCODE_HOME 覆盖(默认 ~/.atomcode),适配器每次调用期读取该 env
|
|
8
|
-
}
|
|
9
|
+
"notes": "AtomCode 的配置根可由 ATOMCODE_HOME 覆盖(默认 ~/.atomcode),适配器每次调用期读取该 env,不缓存。真机验证(2026-11-12,本机 aarch64 Linux 装 atomcode 5.2.6):`atomcode mcp add <name> <cmd>... --global` 写的正是 ~/.atomcode/mcp.json 的 mcpServers.<name>;用它的写入器追加一条后我们的条目原样保留,说明 schema 兼容、可共存。host_matrix --host atomcode → PASS(8 工具,版本=构建版本)。宿主另有 hooks.json 的 pre_tool_use 遥测 hook 与 telemetry 开关——我们刻意不装/不开启。"
|
|
10
|
+
}
|
|
@@ -6,6 +6,5 @@
|
|
|
6
6
|
},
|
|
7
7
|
"config": "~/.codeartsdoer/codearts_cli.json",
|
|
8
8
|
"skillsDir": "~/.codeartsdoer/skills",
|
|
9
|
-
"notes": "CodeArts Agent 是 OpenCode 分支(SCENARIO=codeartsdoer、OPENCODE_CONFIG=codearts_cli.json):mcp 段与 opencode 同 schema(type=local、command=数组、enabled)。实测 2026-11-11:写入 codearts_cli.json 的 mcp.<name> 后 `codearts mcp list` 可见;mcp_settings.json 只对项目级 .codeartsdoer/mcp/ 生效,用户级读 ~/.config/opencode/mcp/,故不要写 ~/.codeartsdoer/mcp/。"
|
|
10
|
-
"productDefault": "CodeArts"
|
|
9
|
+
"notes": "CodeArts Agent 是 OpenCode 分支(SCENARIO=codeartsdoer、OPENCODE_CONFIG=codearts_cli.json):mcp 段与 opencode 同 schema(type=local、command=数组、enabled)。实测 2026-11-11:写入 codearts_cli.json 的 mcp.<name> 后 `codearts mcp list` 可见;mcp_settings.json 只对项目级 .codeartsdoer/mcp/ 生效,用户级读 ~/.config/opencode/mcp/,故不要写 ~/.codeartsdoer/mcp/。"
|
|
11
10
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vod-devkit",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.8",
|
|
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/
|
|
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": [
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.5.
|
|
3
|
-
"commitSha": "
|
|
4
|
-
"builtAt": "2026-11-
|
|
2
|
+
"version": "0.5.8",
|
|
3
|
+
"commitSha": "6186b934264a35ce9fa438675129a37cbfd846cc",
|
|
4
|
+
"builtAt": "2026-11-15T17:25:20",
|
|
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.8",
|
|
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
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vod-feedback-collect
|
|
3
|
-
description: '用户抱怨/体验差/太慢/报错/提单 → 采集原话进 VOD
|
|
3
|
+
description: '用户抱怨/体验差/太慢/报错/提单 → 采集原话进 VOD。识别到抱怨即承接并征得同意(缺产品先问一次是哪个、不猜也不提交;禁止复现排查模式);content=原话逐字;一次抱怨一条;回执 echo 原样转述。详见正文流程与禁令。Triggers: "体验差","太难用","太慢","报错了","出bug了","有bug","反馈问题","反馈建议","提个单","报告问题","不生效","不好使","操作不方便","卡住了","崩溃了","report a problem","bug report","poor experience","feedback"'
|
|
4
4
|
tags: [vod, feedback, capture, consent]
|
|
5
5
|
metadata:
|
|
6
6
|
version: 1
|
|
@@ -180,8 +180,10 @@ metadata:
|
|
|
180
180
|
## 采集流程
|
|
181
181
|
|
|
182
182
|
0. 产品归因(D-product-ask-1,2026-11-12 拍板:不许裸提交 UNKNOWN):
|
|
183
|
-
归因次序 = 用户明确回答 > 原话唯一高置信提及 > 会话记忆(30 分钟) >
|
|
184
|
-
|
|
183
|
+
归因次序 = 用户明确回答 > 原话唯一高置信提及 > 会话记忆(30 分钟) > 安装先验。
|
|
184
|
+
四级都拿不到 → **不猜、不提交**,按下面的追问规则请用户补一句产品名
|
|
185
|
+
(2026-11-12 复评删除 host_default 兜底:宿主产品也是一次推断,错归会进
|
|
186
|
+
引擎幂等/判重域,污染静默且难追溯)。
|
|
185
187
|
- 原话里只有一个产品名、且不是对比/多产品语境 → 直接用,不再问
|
|
186
188
|
- 原话有两个以上产品("CodeArts 比 MaaS 好"、"从 CodeArts 导出到 MaaS")
|
|
187
189
|
→ 视为**低置信**,必须问:"这条反馈是哪个产品的?可用候选:…"
|
|
@@ -217,7 +219,8 @@ metadata:
|
|
|
217
219
|
"网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
|
|
218
220
|
两个 issue;引擎幂等按内容逐字比对,改写即绕过)。多条仅当用户明确
|
|
219
221
|
分条给了多个不同反馈
|
|
220
|
-
4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"
|
|
222
|
+
4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈";
|
|
223
|
+
(若对方是验证者且明确要编号,按第 0 条例外贴 voiceId)——
|
|
221
224
|
**voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
|
|
222
225
|
用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
|
|
223
226
|
5. **无通道 fallback(D-pending-1,插件未安装/无 vod 工具时)**:
|
|
@@ -241,6 +244,12 @@ metadata:
|
|
|
241
244
|
## 纪律
|
|
242
245
|
|
|
243
246
|
0. 回执纪律(F2,成功与失败路径同口径):给用户的话=人话
|
|
247
|
+
|
|
248
|
+
**验证/对账例外(2026-11-12 拍板)**:当对方是**验证者**(运维/研发/负责人在
|
|
249
|
+
核对链路,明确说"把 voiceId 贴出来""我核对下入库")时,允许同样打印
|
|
250
|
+
`voiceId`、`productId`、`productSource`——那是他们的对账主键,不是给反馈提交者看的
|
|
251
|
+
噪音。判据两条同时满足:①对方明确要求要编号;②对方在验证链路而不是在提交自己的
|
|
252
|
+
抱怨。终端用户(提交反馈的人)问"提交了吗",仍只回答状态、不展示编号。
|
|
244
253
|
(成功=已收录/产品团队会看到;失败=提交失败,反馈已暂存本机,
|
|
245
254
|
稍后会自动重试)。**失败时禁止向用户复述内部诊断字段**——HTTP
|
|
246
255
|
状态码、apiKeyFingerprint、tokenTier、堆栈等属于 agent 内部排障
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vod-problem-classification-rules
|
|
3
|
-
description: VOD 问题分类规则(引擎 v2.2 真实口径)— 六类定义、判定细节、LLM
|
|
3
|
+
description: VOD 问题分类规则(引擎 v2.2 真实口径)— 六类定义、判定细节、LLM 分类流程。
|
|
4
4
|
tags: [vod, classification, rules]
|
|
5
5
|
metadata:
|
|
6
6
|
version: 2
|
|
@@ -13,6 +13,7 @@ metadata:
|
|
|
13
13
|
> 体验优化/其他)已废弃,与引擎不符——它来自过期文档。
|
|
14
14
|
> 采集定位:预分类仅作参考 hint(tags),引擎 LLM 按六类重判——
|
|
15
15
|
> 预分类不是终局,别和用户言之凿凿。
|
|
16
|
+
> 对外复述纪律:可讲口径(六类边界/判定要点),不引用仓库路径、文件行号、提交号。
|
|
16
17
|
|
|
17
18
|
## 六类定义(引擎 DEFAULT_TYPE_DEFS 原文)
|
|
18
19
|
|