vod-devkit 0.0.0-stage → 0.1.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 +13 -0
- package/LICENSE.txt +21 -0
- package/QUICKSTART.md +79 -0
- package/README.en.md +75 -0
- package/README.md +84 -2
- package/bin/vod-devkit +464 -0
- package/contract/tools.schema.json +187 -0
- package/npm/cli.js +39 -0
- package/package.json +28 -4
- package/safety/policy.json +48 -0
- package/skills/vod-core/SKILL.md +23 -0
- package/skills/vod-feedback-collect/SKILL.md +90 -0
- package/skills/vod-problem-classification-rules/SKILL.md +45 -0
- package/skills/vod-scoring-rules/SKILL.md +37 -0
- package/vod_mcp/__init__.py +11 -0
- package/vod_mcp/__pycache__/__init__.cpython-314.pyc +0 -0
- package/vod_mcp/__pycache__/packs.cpython-314.pyc +0 -0
- package/vod_mcp/__pycache__/policy.cpython-314.pyc +0 -0
- package/vod_mcp/__pycache__/provenance.cpython-314.pyc +0 -0
- package/vod_mcp/__pycache__/server.cpython-314.pyc +0 -0
- package/vod_mcp/__pycache__/tools.cpython-314.pyc +0 -0
- package/vod_mcp/packs.py +30 -0
- package/vod_mcp/policy.py +98 -0
- package/vod_mcp/provenance.py +43 -0
- package/vod_mcp/runtime.example.json +6 -0
- package/vod_mcp/runtime.json +1473 -0
- package/vod_mcp/server.py +105 -0
- package/vod_mcp/tools.py +620 -0
package/package.json
CHANGED
|
@@ -1,6 +1,30 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vod-devkit",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"vod-devkit": "./npm/cli.js"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"npm/cli.js",
|
|
12
|
+
"bin/vod-devkit",
|
|
13
|
+
"vod_mcp/",
|
|
14
|
+
"skills/",
|
|
15
|
+
"contract/",
|
|
16
|
+
"safety/",
|
|
17
|
+
"QUICKSTART.md",
|
|
18
|
+
"README.md",
|
|
19
|
+
"CHANGELOG.md",
|
|
20
|
+
"LICENSE.txt"
|
|
21
|
+
],
|
|
22
|
+
"keywords": ["mcp", "vod", "feedback", "voice-of-customer", "agent", "plugin"],
|
|
23
|
+
"repository": {
|
|
24
|
+
"type": "git",
|
|
25
|
+
"url": "git+https://github.com/yangaiwu/vod-devkit.git"
|
|
26
|
+
},
|
|
27
|
+
"engines": {
|
|
28
|
+
"node": ">=18"
|
|
29
|
+
}
|
|
30
|
+
}
|
|
@@ -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
|
+
}
|
|
@@ -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,90 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-feedback-collect
|
|
3
|
+
description: '采集 agent 产品用户反馈进 VOD。用户在会话中表达对本产品的不满、建议、期望("补全太慢""希望支持XX")时激活:结构化为声音 → 逐次征得用户同意 → vod_submit_voices 提交 → 回执 voiceId 告知已收录。'
|
|
4
|
+
version: 1
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD 用户反馈采集
|
|
8
|
+
|
|
9
|
+
闭环:用户反馈 → agent 识别 → 用户确认 → 入库(不触发分析)→ 运营择机
|
|
10
|
+
批量分析 → 报告/看板 → 产品改进。
|
|
11
|
+
|
|
12
|
+
## 触发识别
|
|
13
|
+
|
|
14
|
+
用户表达针对**本产品(宿主 agent 产品)**的体验反馈,特征:
|
|
15
|
+
- 抱怨/问题:慢、错、卡、缺失功能、交互别扭
|
|
16
|
+
- 建议/期望:希望支持、要是能…就好了、建议增加
|
|
17
|
+
- 区分边界:用户抱怨的是**宿主产品**才走本技能;用户在讨论第三方
|
|
18
|
+
事物(某网站、某文档)不采集;用户要求提交"工单"类诉求时可询问
|
|
19
|
+
是否愿意同步收录为产品反馈
|
|
20
|
+
|
|
21
|
+
## 采集流程
|
|
22
|
+
|
|
23
|
+
0. 产品归因(先于一切):这条反馈关于哪个产品?
|
|
24
|
+
优先级=用户明示("你们 AIShell 的补全太慢")> 安装绑定默认 >
|
|
25
|
+
**询问用户**。禁止静默猜——归因错误会污染目标产品的数据
|
|
26
|
+
(护栏会拦:无归因直接报错并给出三种解法)
|
|
27
|
+
1. 识别到反馈意图 → 先口头确认收录意愿("要把这条反馈提交给产品
|
|
28
|
+
团队吗?")
|
|
29
|
+
2. 用户同意 → 结构化为声音(不篡改原意):
|
|
30
|
+
- content:用户反馈内容(尽量保留用户原话措辞,可轻度去噪)
|
|
31
|
+
- userType:可判断时填(企业/个人),不确定不填
|
|
32
|
+
- tags:明显的主题词(性能/功能/易用性),最多 3 个
|
|
33
|
+
3. 调用 vod_submit_voices(必须用户已确认,confirmed=true)——
|
|
34
|
+
**一次一批**,攒多条一起交也行,但每批都要用户点头
|
|
35
|
+
4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
|
|
36
|
+
**voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
|
|
37
|
+
用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
|
|
38
|
+
|
|
39
|
+
## 纪律
|
|
40
|
+
|
|
41
|
+
0. 回执纪律(F2):给用户的话=人话(已收录/产品团队会看到);
|
|
42
|
+
voiceId/taskId 是对账主键,在 agent 内部使用,不出现在用户可见文案里
|
|
43
|
+
1. 逐次确认:每批提交前用户点头一次,不打包沉默提交(护栏强制,
|
|
44
|
+
confirmed=false 会被拒)
|
|
45
|
+
2. 来源标记由插件自动注入(宿主身份),不手填——防伪造
|
|
46
|
+
3. content 是用户原话,agent 不加自己的评价/总结进 content
|
|
47
|
+
4. 不提交用户身份信息(姓名/账号/工号)——内容里的凭据类内容
|
|
48
|
+
会被 deny 护栏拦截
|
|
49
|
+
5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
|
|
50
|
+
6. 单批上限 50 条,超限分批
|
|
51
|
+
|
|
52
|
+
## 对齐 VOD-Project 采集标准(2026-11-04 二轮修订,待一次真实用户观测后定稿)
|
|
53
|
+
|
|
54
|
+
学习源=VOD-Project skills/bbs-suggestion + vod-sync/SKILL.md(深读):
|
|
55
|
+
|
|
56
|
+
### content 模板(替代自由拼装,四节加粗标签)
|
|
57
|
+
```
|
|
58
|
+
用户原话(不加标签,保留措辞)
|
|
59
|
+
|
|
60
|
+
**使用场景:**
|
|
61
|
+
(agent 推断,不允许空——空=拒提交,逼推断)
|
|
62
|
+
|
|
63
|
+
**当前影响:**(可选)
|
|
64
|
+
|
|
65
|
+
**期望能力:**
|
|
66
|
+
|
|
67
|
+
**声音来源:**
|
|
68
|
+
(agent 会话平台:cli/飞书/企业微信…——运行时从宿主会话上下文
|
|
69
|
+
获取,禁止硬编码默认值;对齐 detect_channel 纪律)
|
|
70
|
+
```
|
|
71
|
+
- 有对话上下文时:最近 5 轮用户消息格式化为 `> 用户:原话` 引用块
|
|
72
|
+
置顶(过滤触发词、与 content 重复的最后一条去掉)
|
|
73
|
+
|
|
74
|
+
### 分类(采集层三分类,不越层)
|
|
75
|
+
- 给用户的选项=功能建议/用户体验/产品缺陷(云声表单标准);
|
|
76
|
+
六类是引擎 n01 分析层内部枚举,agent 侧不使用、不自造第四个枚举
|
|
77
|
+
- 落 tags=["problem_type:<三分类值>"],引擎以【类型名】标题前缀正式
|
|
78
|
+
入库,n01 照常重判——两层并存,agent 不许宣称"分类即定案"
|
|
79
|
+
|
|
80
|
+
### 路由纪律
|
|
81
|
+
- 用户说"反馈/报告问题/提 issue"→引擎 ISYNC 审核队列路径(本技能
|
|
82
|
+
提交即入队,运营复审后建 issue),agent 不直接建 GitCode issue
|
|
83
|
+
- 用户明确"提建议"且要求直上渠道时才提及云声链(bbs-suggestion 为
|
|
84
|
+
VOD-Project 内部资产,外部 agent 不分发)
|
|
85
|
+
|
|
86
|
+
### 自检清单(提交前逐条过,不过不提交)
|
|
87
|
+
- [ ] content 含四节模板且使用场景/期望能力非空?
|
|
88
|
+
- [ ] 声音来源=真实会话平台(非硬编码)?
|
|
89
|
+
- [ ] 分类(若有)是三分类枚举值?
|
|
90
|
+
- [ ] 未把 agent 自己的评价混进用户原话?
|
|
@@ -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.1.0"
|
|
9
|
+
# 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
|
|
10
|
+
# 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
|
|
11
|
+
DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/vod_mcp/packs.py
ADDED
|
@@ -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
|
+
}
|