vod-devkit 0.2.0 → 0.2.2
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 +13 -0
- package/contract/tools.schema.json +2 -2
- package/package.json +15 -2
- package/plugins/.agents/plugins/marketplace.json +19 -0
- package/plugins/vod-devkit/.codex-plugin/plugin.json +27 -0
- package/plugins/vod-devkit/.mcp.json +9 -0
- package/plugins/vod-devkit/build-info.json +6 -0
- package/plugins/vod-devkit/skills/vod-core/SKILL.md +23 -0
- package/plugins/vod-devkit/skills/vod-feedback-collect/SKILL.md +118 -0
- package/plugins/vod-devkit/skills/vod-problem-classification-rules/SKILL.md +45 -0
- package/plugins/vod-devkit/skills/vod-scoring-rules/SKILL.md +37 -0
- package/plugins/vod-devkit/vod_mcp/__init__.py +11 -0
- package/plugins/vod-devkit/vod_mcp/packs.py +30 -0
- package/plugins/vod-devkit/vod_mcp/policy.py +98 -0
- package/plugins/vod-devkit/vod_mcp/provenance.py +43 -0
- package/plugins/vod-devkit/vod_mcp/runtime.example.json +6 -0
- package/plugins/vod-devkit/vod_mcp/server.py +105 -0
- package/plugins/vod-devkit/vod_mcp/tools.py +639 -0
- package/skills/vod-feedback-collect/SKILL.md +10 -38
- package/vod_mcp/__init__.py +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -116,3 +116,16 @@
|
|
|
116
116
|
- 599478b feat(D-codex-agents-1): codex 技能层载体落地——codex 无 skill 机制,采集质量方法论(触发三条件/content🔒字段分级/推断≠编造禁例/预检三项/不追问/回执话术/职责边界)此前在 codex 上裸奔(工具描述只装硬约束)。install --target codex 随装幂等写入 ~/.codex/AGENTS.md 技能紧凑块(标记剥离幂等,用户自有内容保留)。工具描述同步修口径冲突:删除'用户明确要求其他产品可显式传参覆盖'(违背 S1 同源原则——用户自报产品一律不采信不覆盖,照部署产品提交正文原样)。tags 语义注释(problem_type:云声三分类入标题前缀,非 n01 六类)。新增 AGENTS.md 幂等/内容保留测试锁;72 用例绿
|
|
117
117
|
- acfcc4d fix(D-product-id-2 收口): submit_voices 描述补归因话术并前置——codex 等 MCP-only 宿主不加载 skill,模型唯一约束源是工具描述;原描述零归因话术导致用户提单时被反问'什么产品'(T7d 后已废除的旧职责话机复活)。话术前置防宿主描述截断;外部对表建议采纳:约束三层(工具描述/参数描述/非required 结构)+AGENTS.md 仅冗余;其 .codex-plugin/capability_directories 体系与本机 codex CLI v0.166 实测机制不符未采纳(待证据)。71 用例绿;codex 真机行为验证:提单不带 product 不再反问、直接安装绑定归因提交落库
|
|
118
118
|
|
|
119
|
+
|
|
120
|
+
## v0.2.1(2026-11-05)
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
## v0.2.2(2026-11-06)
|
|
125
|
+
|
|
126
|
+
- e2928cb test(D-codex-plugin-1 增补2 补): 自包含契约锁断言更新为 serve 入口形态(相对路径断言随 .mcp.json 定稿移除,失败原因留注释);skills 随包断言补入
|
|
127
|
+
- 4cd6d84 fix(D-codex-plugin-1 增补2): ①SKILL.md 清除 V16 前废弃旧职责残留(四节 content 模板/声音来源字段/detect_channel——与工具描述新契约直接冲突,codex 真机会话实锤模型按旧模板走偏:翻仓库找提交规范→要工单字段→用户原话丢失未提交);frontmatter 触发词补 提单/提 issue②工具描述补提单语义+话术前置强化(content=原话即完整提交物,禁止追问补齐/索要开发者字段)③.mcp.json 定稿 vod-devkit serve(相对路径+cwd 在 codex 0.166 实测不解析到插件目录)④sync_plugin.py 补 skills 同步(此前只同步 vod_mcp=又一漂移面)
|
|
128
|
+
- 4418a91 feat(D-golden-1 扩展+D-probe-1 探针工具化): ①tests/probe.py 可复用 stdio 探针(initialize/tools/call/护栏 error 分流——多轮真机手法沉淀)+pack 门控真实装配层锁(VOD_PACKS 两种取值 tools/list 协议级断言)②golden 扩展:status 原样 manifest 契约(HOME/REPO/ORIGIN/SHA/installedAt 归一化+skillHashes 值不锁归漂移锁专项)+preset update 固定拒绝语;_assert_golden 复用 helper;78 用例绿。proposal S43/S44
|
|
129
|
+
- 2782f5e feat(D-golden-1 doctor/verify golden 基线): 用户可见输出快照比对(devkit doctor-golden 对表,差距清单①第一步)——易变段归一化(HOME/REPO/SHA12),口径漂移即红,有意变更 UPDATE_GOLDEN=1 重录并在失败 diff 人工过目;无 key 确定性基线(key 探针行含易变指纹不入基线);顺带修测试基建 bug:shutil.ignore_patterns 只匹配基名,'vod_mcp/runtime.json' 带斜杠模式永不命中致 clone 混入真源账本。proposal S42+design golden 节;76 用例绿
|
|
130
|
+
- 28c1f80 feat(D-release-1 一键发版体系+包内容门): release.sh 重写对齐 devkit release-please 语义——bump 从提交历史推导+版本落点表驱动 EXTRA_FILES+整行正则替换+全落点硬断言(根治静默 no-op);新增 scripts/pack_verify.py 包内容门(pack --dry-run 必含/危险项断言)——首跑即实锤 0.1.12 曾含 runtime.json 凭据残留(已 deprecate,0.2.0 起文件级白名单结构性排除,npm 0.1.12 残留令牌仅对已销毁本地库有效);package.json files 改文件级白名单+npm 分发补 plugins/ 随包(0.2.0 漏项致 npx codex 路径必挂,0.2.1 修复);RELEASING.md 发版手册;proposal S41+decisions D-release-1;一键发版真机闭环 v0.2.0/v0.2.1(npx codex 原生插件安装复验通过)
|
|
131
|
+
|
|
@@ -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.2.
|
|
4
|
+
"version": "0.2.2",
|
|
5
5
|
"tools": {
|
|
6
6
|
"vod_submit_voices": {
|
|
7
|
-
"description": "
|
|
7
|
+
"description": "用户要反馈/提单时立即调用本工具:content 放用户原话(哪怕只有一句\"体验很差\"也原样提交),不要为补齐信息而追问——缺的细节由运营侧补充。product 归因由安装绑定自动完成,无需用户提供、禁止询问\"提交到哪个产品/页面\";用户自报的目标产品一律不采信不覆盖(照部署产品提交,提到什么产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,禁止索要复现步骤/严重程度/环境/附件等开发者字段。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
|
8
8
|
"input": {
|
|
9
9
|
"type": "object",
|
|
10
10
|
"properties": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vod-devkit",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -23,7 +23,20 @@
|
|
|
23
23
|
"vod_mcp/packs.py",
|
|
24
24
|
"vod_mcp/policy.py",
|
|
25
25
|
"vod_mcp/provenance.py",
|
|
26
|
-
"vod_mcp/runtime.example.json"
|
|
26
|
+
"vod_mcp/runtime.example.json",
|
|
27
|
+
"vod_mcp/__init__.py",
|
|
28
|
+
"vod_mcp/server.py",
|
|
29
|
+
"vod_mcp/tools.py",
|
|
30
|
+
"vod_mcp/packs.py",
|
|
31
|
+
"vod_mcp/policy.py",
|
|
32
|
+
"vod_mcp/provenance.py",
|
|
33
|
+
"vod_mcp/runtime.example.json",
|
|
34
|
+
"plugins/vod-devkit/.codex-plugin/plugin.json",
|
|
35
|
+
"plugins/vod-devkit/.mcp.json",
|
|
36
|
+
"plugins/vod-devkit/build-info.json",
|
|
37
|
+
"plugins/vod-devkit/vod_mcp",
|
|
38
|
+
"plugins/vod-devkit/skills",
|
|
39
|
+
"plugins/.agents/plugins/marketplace.json"
|
|
27
40
|
],
|
|
28
41
|
"keywords": [
|
|
29
42
|
"mcp",
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "vod-local",
|
|
3
|
+
"plugins": [
|
|
4
|
+
{
|
|
5
|
+
"name": "vod-devkit",
|
|
6
|
+
"source": {
|
|
7
|
+
"source": "local",
|
|
8
|
+
"path": "./vod-devkit"
|
|
9
|
+
},
|
|
10
|
+
"policy": {
|
|
11
|
+
"installation": "AVAILABLE",
|
|
12
|
+
"authentication": "ON_INSTALL",
|
|
13
|
+
"products": [
|
|
14
|
+
"CODEX"
|
|
15
|
+
]
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
]
|
|
19
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "vod-devkit",
|
|
3
|
+
"version": "0.2.2",
|
|
4
|
+
"description": "VOD user-feedback collection: structured voice capture and submission to the VOD hoarding endpoint.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"feedback",
|
|
7
|
+
"vod",
|
|
8
|
+
"voice",
|
|
9
|
+
"collection"
|
|
10
|
+
],
|
|
11
|
+
"license": "MIT",
|
|
12
|
+
"interface": {
|
|
13
|
+
"displayName": "VOD DevKit",
|
|
14
|
+
"shortDescription": "Collect user feedback voices into VOD (product-bound attribution, safe defaults).",
|
|
15
|
+
"category": "Developer Tools",
|
|
16
|
+
"capabilities": [
|
|
17
|
+
"Read",
|
|
18
|
+
"Interactive"
|
|
19
|
+
],
|
|
20
|
+
"defaultPrompt": [
|
|
21
|
+
"我想反馈一个产品问题",
|
|
22
|
+
"帮我把这条意见提交给产品团队"
|
|
23
|
+
]
|
|
24
|
+
},
|
|
25
|
+
"skills": "./skills/",
|
|
26
|
+
"mcpServers": "./.mcp.json"
|
|
27
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-core
|
|
3
|
+
description: 'VOD 用户声音分析插件路由入口。任何"分析用户声音/反馈、发起 VOD 分析任务、查任务状态/结果、VOD 评分/分类规则、KB 检索"类请求先经本技能路由到对应工具与领域技能。写操作(发起分析)必须先获用户确认(confirm 护栏)。'
|
|
4
|
+
version: 1
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD Core
|
|
8
|
+
|
|
9
|
+
VOD 分析能力入口。按意图路由:
|
|
10
|
+
|
|
11
|
+
| 意图 | 动作 |
|
|
12
|
+
|---|---|
|
|
13
|
+
| 发起分析 | 工具 vod_run_analysis(confirm:必须用户确认后传 confirmed=true;taskId 为对账主键) |
|
|
14
|
+
| 查任务进度/结果 | vod_task_status / vod_task_result |
|
|
15
|
+
| 知识库检索 | vod_kb_search |
|
|
16
|
+
| 插件自述/来源核验 | vod_devkit_info |
|
|
17
|
+
| 分类匹配/问题分类/评分规则 | 领域技能(由 vendor 机制从 VOD-Project 真源拉取:vod-category-matching / vod-problem-classification / vod-scoring-rules) |
|
|
18
|
+
|
|
19
|
+
纪律:
|
|
20
|
+
1. 任务 ID 是唯一对账主键,发起后一切追问以 taskId 对账,不凭记忆描述
|
|
21
|
+
2. 单任务条数上限、product 白名单由护栏强制,超限直接拒
|
|
22
|
+
3. 任何 DB 直连/凭据读取意图会被 deny——不要尝试
|
|
23
|
+
4. 领域规则以 vendored 技能文件为准,不凭训练数据回答 VOD 评分口径
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-feedback-collect
|
|
3
|
+
description: '采集 agent 产品用户反馈进 VOD。用户表达对本产品的不满、建议、期望("补全太慢""希望支持XX""提单:体验很差")或明确要求提交反馈/提单/提 issue 时激活:content=用户原话即完整提交物(无工单模板字段)→ 逐次征得用户同意 → vod_submit_voices 提交 → 人话回执。'
|
|
4
|
+
version: 1
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD 用户反馈采集
|
|
8
|
+
|
|
9
|
+
闭环:用户反馈 → agent 识别 → 用户确认 → 入库(不触发分析)→ 运营择机
|
|
10
|
+
批量分析 → 报告/看板 → 产品改进。
|
|
11
|
+
|
|
12
|
+
## 触发识别
|
|
13
|
+
|
|
14
|
+
**本技能是什么(一句话)**:把用户对本产品的反馈整理为一条声音、
|
|
15
|
+
经用户同意后提交到 VOD、把回执用人话告诉用户。模型在此过程中
|
|
16
|
+
只做三件事:**识别反馈意图、忠实转写用户原话、征得提交同意**。
|
|
17
|
+
决定权在用户:说什么、何时提交,都由用户定;模型不补写、不判断、
|
|
18
|
+
不发散(细则见下方各条禁令——它们是这三件事的实施边界,不是职责本身)。
|
|
19
|
+
|
|
20
|
+
**触发条件(满足任一即加载本技能)**:
|
|
21
|
+
1. 用户表达对本产品的否定或建议——关键词如:慢、报错、不好用、
|
|
22
|
+
希望支持、建议增加、为什么不能、体验差;
|
|
23
|
+
2. 用户明确要求提交反馈——"记下来"、"反馈给产品团队"、"提交这条";
|
|
24
|
+
3. 连续两轮抱怨同一问题。
|
|
25
|
+
不满足时本技能不激活(产品问答、闲聊、操作指导等交回宿主通用能力)。
|
|
26
|
+
|
|
27
|
+
**字段处理分级(借鉴 gitcode-issue-creator,先于一切)**:
|
|
28
|
+
| 字段 | 处理 | 规则 |
|
|
29
|
+
|------|------|------|
|
|
30
|
+
| content | 🔒 原样保留 | 用户原话忠实转写,只做脱敏(密钥替换);禁止改写、扩展、补充情感结论(如"体验不好")或任何用户没说的内容 |
|
|
31
|
+
| title | 🧠 推断摘要 | 从用户表述提炼核心问题(引擎自动截前 64 字,无需手拼) |
|
|
32
|
+
| 分类 | 🧠 推断 | 从内容判断三分类之一;判断不了不选(引擎重判兜底) |
|
|
33
|
+
|
|
34
|
+
**推断 ≠ 编造(关键辨析)**:
|
|
35
|
+
- ✅ 推断:用户说"AIShell 补全经常卡住" → content 原样保留,分类=产品缺陷(从"经常卡住"提取重组)
|
|
36
|
+
- ❌ 编造:用户只说了"AIShell" → 写成"AIShell 产品体验不好"(用户没说体验不好——情感结论是编造,实锤事故)
|
|
37
|
+
- ✅ 推断:用户说"希望支持扫码授权" → 分类=功能建议
|
|
38
|
+
- ❌ 编造:用户问"AIShell 是什么"(提问不是反馈)→ 不采集,需澄清
|
|
39
|
+
|
|
40
|
+
**调用前强制预检(不过不许调用)**:
|
|
41
|
+
检查 1: content 是否等于用户原话?(≠ → 改回原话)
|
|
42
|
+
检查 2: 用户的话是否构成一条反馈(有具体对象/现象)?裸产品名、
|
|
43
|
+
纯提问、闲聊 → 停止采集,先澄清用户想说什么
|
|
44
|
+
检查 3: 分类是否与内容相符?(不符 → 重新推断)
|
|
45
|
+
|
|
46
|
+
**不追问原则**:内容太泛时引导一次("说下具体现象?"),用户不补
|
|
47
|
+
就按原话提交或放弃——禁止反复追问,禁止替用户脑补现象细节。
|
|
48
|
+
|
|
49
|
+
**职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
|
|
50
|
+
产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
|
|
51
|
+
配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
|
|
52
|
+
一句"这不在反馈功能范围内"即可,或交回宿主通用能力处理。
|
|
53
|
+
模型发散=把内部实现端给用户(实锤:'AIShell 是归因产品名之一'+
|
|
54
|
+
白名单/文档行号整套端出去)。
|
|
55
|
+
|
|
56
|
+
用户表达针对**本产品(宿主 agent 产品)**的体验反馈,特征:
|
|
57
|
+
- 抱怨/问题:慢、错、卡、缺失功能、交互别扭
|
|
58
|
+
- 建议/期望:希望支持、要是能…就好了、建议增加
|
|
59
|
+
- 区分边界:用户抱怨的是**宿主产品**才走本技能;用户在讨论第三方
|
|
60
|
+
事物(某网站、某文档)不采集;用户要求提交"工单"类诉求时可询问
|
|
61
|
+
是否愿意同步收录为产品反馈(只确认收录意愿,不问产品归属)
|
|
62
|
+
|
|
63
|
+
## 采集流程
|
|
64
|
+
|
|
65
|
+
0. 产品归因(安装时已配置,不问用户):产品=安装/部署时绑定的
|
|
66
|
+
宿主产品(install --product / dsh profile config),工具与引擎
|
|
67
|
+
自动赋值——**禁止向用户追问"哪个产品"**(用户不知道也不该知道
|
|
68
|
+
采集侧的归因配置)。**用户自报的目标产品一律不采信、不覆盖**
|
|
69
|
+
(S1 同源原则:话术可以把反馈投到任意产品=污染别人产品数据)。
|
|
70
|
+
用户说"这是给 XX 的反馈"→ 照常按部署产品提交,内容原样保留
|
|
71
|
+
(提到什么产品随正文传达);不要确认、不要改归因
|
|
72
|
+
1. 识别到反馈意图 → 先口头确认收录意愿("要把这条反馈提交给产品
|
|
73
|
+
团队吗?")
|
|
74
|
+
2. 用户同意 → 结构化为声音(不篡改原意):
|
|
75
|
+
- content:用户反馈内容(尽量保留用户原话措辞,可轻度去噪)
|
|
76
|
+
- userType:可判断时填(企业/个人),不确定不填
|
|
77
|
+
- tags:明显的主题词(性能/功能/易用性),最多 3 个
|
|
78
|
+
3. 调用 vod_submit_voices(必须用户已确认,confirmed=true)——
|
|
79
|
+
**一次一批**,攒多条一起交也行,但每批都要用户点头
|
|
80
|
+
4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
|
|
81
|
+
**voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
|
|
82
|
+
用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
|
|
83
|
+
|
|
84
|
+
## 纪律
|
|
85
|
+
|
|
86
|
+
0. 回执纪律(F2,成功与失败路径同口径):给用户的话=人话
|
|
87
|
+
(成功=已收录/产品团队会看到;失败=提交失败,反馈已暂存本机,
|
|
88
|
+
稍后会自动重试)。**失败时禁止向用户复述内部诊断字段**——HTTP
|
|
89
|
+
状态码、apiKeyFingerprint、tokenTier、堆栈等属于 agent 内部排障
|
|
90
|
+
信息,用户看不到也不需要看;匿名档用户没有"凭据"概念,"凭据未
|
|
91
|
+
配置"对他们是无效信息。voiceId/taskId 是对账主键,在 agent 内部
|
|
92
|
+
使用,不出现在用户可见文案里。
|
|
93
|
+
**工具名与机制词同理不外露**:对用户永远说"提交反馈",禁止出现
|
|
94
|
+
vod_submit_voices 等工具名,禁止"调用/被拒/护栏/参数/配额"等
|
|
95
|
+
机制词(实锤:"vod_submit_voices 被我调用后你拒绝了它"——用户
|
|
96
|
+
看不懂谁调用了什么、自己为什么成了拒绝者)。主语纪律:动作主体
|
|
97
|
+
是"我"(agent 替用户提交),系统行为统一说"系统/稍后自动",不
|
|
98
|
+
把内部裁决说成用户的行为
|
|
99
|
+
1. 逐次确认:每批提交前用户点头一次,不打包沉默提交(护栏强制,
|
|
100
|
+
confirmed=false 会被拒)
|
|
101
|
+
2. 来源标记由插件自动注入(宿主身份),不手填——防伪造
|
|
102
|
+
3. content 是用户原话,agent 不加自己的评价/总结进 content
|
|
103
|
+
4. 不提交用户身份信息(姓名/账号/工号)——内容里的凭据类内容
|
|
104
|
+
会被 deny 护栏拦截
|
|
105
|
+
5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
|
|
106
|
+
6. 单批上限 50 条,超限分批
|
|
107
|
+
|
|
108
|
+
## 对齐 VOD-Project 采集标准(V16 起口径,2026-11-05 修订)
|
|
109
|
+
|
|
110
|
+
历史版本曾有"四节 content 模板/声音来源字段"——已废弃(囤积端点原话提交、
|
|
111
|
+
渠道由引擎赋值客户端零字段不自报)。现行口径:
|
|
112
|
+
|
|
113
|
+
- content=用户原话即可提交,**无模板、无必填推断节**(囤积端点无模板校验;
|
|
114
|
+
旧模板的"空=拒提交"作废)
|
|
115
|
+
- 分类可选:用户表述明显时填三分类 tags,判断不了不填(n01 引擎重判兜底)
|
|
116
|
+
- 渠道/来源一律不提交、不向用户提及(引擎按链路固定赋值)
|
|
117
|
+
- 提单/工单类诉求:不需要"复现步骤/严重程度/优先级"等开发者工单字段——
|
|
118
|
+
用户原话即完整提交物,缺什么由运营侧补充
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-problem-classification-rules
|
|
3
|
+
description: VOD 问题分类规则(引擎 v2.2 真实口径)— 六类定义、判定细节、LLM 分类流程。真源=workflow/src/n01_classify.py(VOD-Project 2bb3fc82 实测核对)。
|
|
4
|
+
version: 2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD 问题分类规则(引擎 v2 口径)
|
|
8
|
+
|
|
9
|
+
> 真源纪律:本技能内容以引擎代码为准(n01_classify.py DEFAULT_TYPE_DEFS
|
|
10
|
+
> + 分类 prompt),2026-11-03 逐行核对。旧四类口径(BUG/功能需求/
|
|
11
|
+
> 体验优化/其他)已废弃,与引擎不符——它来自过期文档。
|
|
12
|
+
> 采集定位:预分类仅作参考 hint(tags),引擎 LLM 按六类重判——
|
|
13
|
+
> 预分类不是终局,别和用户言之凿凿。
|
|
14
|
+
|
|
15
|
+
## 六类定义(引擎 DEFAULT_TYPE_DEFS 原文)
|
|
16
|
+
|
|
17
|
+
| 类型 | 判定 |
|
|
18
|
+
|---|---|
|
|
19
|
+
| 产品缺陷 | Bug / 功能不可用 / 报错崩溃 |
|
|
20
|
+
| 技术/业务咨询 | 询问用法 / 支持能力 |
|
|
21
|
+
| 体验改进 | 可用但体验差,求优化交互/性能/UI |
|
|
22
|
+
| 主观评价 | 纯感受 / 评分 / 对比,无具体诉求 |
|
|
23
|
+
| 无效问题 | 内容不完整 / 无意义 / 重复 / 非产品(唯一跳过后续分析的类型) |
|
|
24
|
+
| 功能需求 | 要求新增功能 / 能力 |
|
|
25
|
+
|
|
26
|
+
## 判定细则(引擎分类 prompt 摘要)
|
|
27
|
+
|
|
28
|
+
- NPS 打分开头 → 主观评价
|
|
29
|
+
- 竞品对比但无具体差异 → 主观评价
|
|
30
|
+
- 纯情绪无场景 → 主观评价
|
|
31
|
+
- 定价/价格类诉求:有具体功能建议 → 功能需求/体验改进;无 → 主观评价
|
|
32
|
+
- 纯好评无建议 → 主观评价
|
|
33
|
+
- 「希望 XX」按实际归类:功能/能力 → 功能需求;交互/UI/性能 → 体验改进
|
|
34
|
+
|
|
35
|
+
## 引擎分类流程(v2.2)
|
|
36
|
+
|
|
37
|
+
全量走 LLM 六段式分类(规则预判已移除),fewshot 示例动态检索;
|
|
38
|
+
少数派结果自动重试。旧 problem_classifier.py 的两类口径
|
|
39
|
+
(问题反馈/产品咨询)为遗留代码,不在 v2 主链。
|
|
40
|
+
|
|
41
|
+
## 采集用法
|
|
42
|
+
|
|
43
|
+
agent 采集时按上表打 tags(如 problem_type=体验改进),仅作预分类
|
|
44
|
+
参考;不确定就不填,别硬猜——引擎 LLM 会重判,错误预分类比留空
|
|
45
|
+
更糟(可能干扰 fewshot 检索)。
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-scoring-rules
|
|
3
|
+
description: VOD 评分规则(引擎 v2 真实公式)— 四项加法、上下限、优先级映射。真源=workflow/src/workflow_v2.py(VOD-Project 2bb3fc82 实测核对)。
|
|
4
|
+
version: 2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD 评分规则(引擎 v2 口径)
|
|
8
|
+
|
|
9
|
+
> 真源纪律:以 workflow_v2.py 评分函数为准,2026-11-03 逐行核对。
|
|
10
|
+
> 旧版"五项维度含用户价值"口径作废——引擎是四项,且非重点问题
|
|
11
|
+
> 上限不同(下方原文),旧文档没写。
|
|
12
|
+
|
|
13
|
+
## 评分公式(引擎代码原文语义)
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
评分 = 声音等级分 + 场景范围分 + 功能重要性分 + 友商对比分
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
| 项 | 取值 |
|
|
20
|
+
|---|---|
|
|
21
|
+
| 声音等级分 | L1=5.0 / L2=4.0 / L3=3.0 / L4=2.0 / L5=1.0 |
|
|
22
|
+
| 功能重要性分 | 高=1.5 / 中=1.0 / 低=0.5(无一级特性归 0) |
|
|
23
|
+
| 场景范围分 / 友商对比分 | 按分组与竞品数据计算 |
|
|
24
|
+
|
|
25
|
+
## 上下限(引擎代码,两条都要记)
|
|
26
|
+
|
|
27
|
+
- **重点问题:clamp 1.0 ~ 10.5**
|
|
28
|
+
- **非重点问题:clamp 1.0 ~ 10.0**(2026-09-22 用户定稿"方案甲",
|
|
29
|
+
旧文档只写 10.5 是不完整口径)
|
|
30
|
+
|
|
31
|
+
无标签记录:无范围分,仅 等级+重要性+友商 三项。
|
|
32
|
+
|
|
33
|
+
## 采集用法
|
|
34
|
+
|
|
35
|
+
用户追问"这条反馈多重要/会不会被优先处理"时按四项口径解释
|
|
36
|
+
(可指出:L1 且涉及友商对比的反馈分最高)。涉及友商对比的反馈
|
|
37
|
+
是高价值维度——采集时值得追问"之前用的是什么产品"补全该维度。
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
"""vod-devkit:VOD 分析能力的 MCP 插件薄壳。
|
|
2
|
+
|
|
3
|
+
铁律(见 docs/design.md):
|
|
4
|
+
1. 只允许经 HTTP 调 workflow/api.py,禁止 import 引擎内部模块
|
|
5
|
+
2. 外部无 DB 直连路径(护栏 deny 兜底)
|
|
6
|
+
3. 任务 ID 是唯一对账主键,写类工具返回一律携带
|
|
7
|
+
"""
|
|
8
|
+
__version__ = "0.2.2"
|
|
9
|
+
# 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
|
|
10
|
+
# 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
|
|
11
|
+
DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
"""packs 裁剪:VOD_PACKS=core,workflow,kb(逗号分隔,默认全装)。
|
|
2
|
+
|
|
3
|
+
core 常驻(vod_devkit_info + vod-core 技能);未启用的 pack 工具不注册。
|
|
4
|
+
"""
|
|
5
|
+
import os
|
|
6
|
+
|
|
7
|
+
ALL_PACKS = ("core", "collect", "knowledge")
|
|
8
|
+
|
|
9
|
+
PACK_TOOLS = {
|
|
10
|
+
"core": ["vod_devkit_info", "vod_auth_status"],
|
|
11
|
+
"collect": ["vod_submit_voices", "vod_list_submitted"],
|
|
12
|
+
"knowledge": [], # 纯技能包:3 个领域规则技能,零工具零依赖
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def enabled_packs() -> tuple:
|
|
17
|
+
raw = os.environ.get("VOD_PACKS", "").strip()
|
|
18
|
+
if not raw:
|
|
19
|
+
return ALL_PACKS
|
|
20
|
+
packs = tuple(p.strip() for p in raw.split(",") if p.strip() in ALL_PACKS)
|
|
21
|
+
if "core" not in packs:
|
|
22
|
+
packs = ("core",) + packs
|
|
23
|
+
return packs
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def enabled_tools() -> list:
|
|
27
|
+
tools = []
|
|
28
|
+
for pack in enabled_packs():
|
|
29
|
+
tools.extend(PACK_TOOLS[pack])
|
|
30
|
+
return tools
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
"""声明式护栏:safety/policy.json 规则执行(deny/confirm)。
|
|
2
|
+
|
|
3
|
+
规则匹配分两类:
|
|
4
|
+
- 工具参数规则(match.tool 指定):在 tools/call 前置检查
|
|
5
|
+
- 文本规则(match.field=text):供 hook 层与工具参数串一起检查
|
|
6
|
+
"""
|
|
7
|
+
import json
|
|
8
|
+
import re
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
|
|
11
|
+
_POLICY_PATH = Path(__file__).resolve().parent.parent / "safety" / "policy.json"
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def load_policy() -> dict:
|
|
15
|
+
with open(_POLICY_PATH, encoding="utf-8") as f:
|
|
16
|
+
return json.load(f)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def _resolve_ref(policy: dict, value):
|
|
20
|
+
"""match 里 'maxVoicesPerTask' 这类引用政策顶层的值。"""
|
|
21
|
+
if isinstance(value, str) and value in policy:
|
|
22
|
+
return policy[value]
|
|
23
|
+
return value
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def _match_tool_rule(rule: dict, tool: str, params: dict) -> bool:
|
|
27
|
+
m = rule["match"]
|
|
28
|
+
if m.get("tool") != tool:
|
|
29
|
+
return False
|
|
30
|
+
p = m.get("param")
|
|
31
|
+
if p is None:
|
|
32
|
+
return True
|
|
33
|
+
actual = params.get(p)
|
|
34
|
+
if actual is None and "equals" in m and m["equals"] is False:
|
|
35
|
+
actual = False # 缺省视为未确认
|
|
36
|
+
if "equals" in m:
|
|
37
|
+
return actual == m["equals"]
|
|
38
|
+
if "gt" in m:
|
|
39
|
+
limit = _resolve_ref(load_policy(), m["gt"])
|
|
40
|
+
try:
|
|
41
|
+
if isinstance(actual, list):
|
|
42
|
+
return len(actual) > int(limit)
|
|
43
|
+
return actual is not None and int(actual) > int(limit)
|
|
44
|
+
except (TypeError, ValueError):
|
|
45
|
+
return False
|
|
46
|
+
if "notIn" in m:
|
|
47
|
+
whitelist = _resolve_ref(load_policy(), m["notIn"])
|
|
48
|
+
if not isinstance(whitelist, (list, tuple)):
|
|
49
|
+
return False
|
|
50
|
+
return actual not in whitelist
|
|
51
|
+
return False
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
def check_tool_call(policy: dict, tool: str, params: dict) -> list:
|
|
55
|
+
"""返回命中的规则列表(空=放行)。deny 命中=拒绝;confirm 命中=要求确认。"""
|
|
56
|
+
hits = []
|
|
57
|
+
for rule in policy.get("rules", []):
|
|
58
|
+
if "tool" in rule.get("match", {}):
|
|
59
|
+
if _match_tool_rule(rule, tool, params):
|
|
60
|
+
hits.append(rule)
|
|
61
|
+
return hits
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def guard_scope(params: dict) -> dict:
|
|
65
|
+
"""文本规则的扫描面(E4 修复):剔除用户内容字段——拦"凭据读取意图"
|
|
66
|
+
不误杀"反馈内容里引用凭据"。voices[].content 与 data 是用户原话,
|
|
67
|
+
不进文本规则;scene/tags/query/product 等结构性字段仍扫描。"""
|
|
68
|
+
scope = {}
|
|
69
|
+
for k, v in (params or {}).items():
|
|
70
|
+
if k in ("data",): # run_analysis 的声音数据=用户原话
|
|
71
|
+
scope[k] = "<%d records>" % len(v) if isinstance(v, list) else "..."
|
|
72
|
+
elif k == "voices": # 采集的反馈内容=用户原话,仅扫非 content 字段
|
|
73
|
+
scope[k] = [{kk: vv for kk, vv in (item or {}).items() if kk != "content"}
|
|
74
|
+
for item in v] if isinstance(v, list) else v
|
|
75
|
+
else:
|
|
76
|
+
scope[k] = v
|
|
77
|
+
return scope
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
def check_text(policy: dict, text: str) -> list:
|
|
81
|
+
"""文本类 deny 规则(DB 直连/凭据模式),供 hook 与参数串调用。"""
|
|
82
|
+
hits = []
|
|
83
|
+
for rule in policy.get("rules", []):
|
|
84
|
+
m = rule.get("match", {})
|
|
85
|
+
if m.get("field") == "text":
|
|
86
|
+
if re.search(m["regex"], text or ""):
|
|
87
|
+
hits.append(rule)
|
|
88
|
+
return hits
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
def decide(hits: list) -> tuple:
|
|
92
|
+
"""(verdict, message);verdict ∈ {allow, confirm, deny}。"""
|
|
93
|
+
if not hits:
|
|
94
|
+
return "allow", ""
|
|
95
|
+
denies = [r for r in hits if r["severity"] == "deny"]
|
|
96
|
+
if denies:
|
|
97
|
+
return "deny", denies[0]["message"]
|
|
98
|
+
return "confirm", hits[0]["message"]
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
"""溯源与宿主身份:build-info.json(构建烧录)+ 握手 clientInfo + install-manifest。"""
|
|
2
|
+
import json
|
|
3
|
+
from pathlib import Path
|
|
4
|
+
|
|
5
|
+
_ROOT = Path(__file__).resolve().parent.parent
|
|
6
|
+
_BUILD_INFO = _ROOT / "build-info.json"
|
|
7
|
+
_MANIFEST = _ROOT / "install-manifest.json"
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def read_build_info() -> dict:
|
|
11
|
+
if _BUILD_INFO.exists():
|
|
12
|
+
with open(_BUILD_INFO, encoding="utf-8") as f:
|
|
13
|
+
return json.load(f)
|
|
14
|
+
return {"version": "dev", "commitSha": None, "builtAt": None, "sourceRemote": None}
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def read_manifest() -> dict:
|
|
18
|
+
if _MANIFEST.exists():
|
|
19
|
+
with open(_MANIFEST, encoding="utf-8") as f:
|
|
20
|
+
return json.load(f)
|
|
21
|
+
return {}
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def host_identity() -> dict:
|
|
25
|
+
"""安装清单的 target + 握手 clientInfo(由 server.py 注入 _HOST)。"""
|
|
26
|
+
return read_manifest().get("target") or {}
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def info_payload(client_info: dict | None = None) -> dict:
|
|
30
|
+
bi = read_build_info()
|
|
31
|
+
mf = read_manifest()
|
|
32
|
+
host = client_info or mf.get("clientInfo") or {}
|
|
33
|
+
return {
|
|
34
|
+
"version": bi.get("version"),
|
|
35
|
+
"commitSha": bi.get("commitSha"),
|
|
36
|
+
"packs": sorted(__import__("vod_mcp.packs", fromlist=["enabled_packs"]).enabled_packs()),
|
|
37
|
+
"hostClient": host,
|
|
38
|
+
"manifestSummary": {
|
|
39
|
+
"target": mf.get("target"),
|
|
40
|
+
"installedAt": mf.get("installedAt"),
|
|
41
|
+
"source": mf.get("source"),
|
|
42
|
+
},
|
|
43
|
+
}
|