vod-devkit 0.1.12 → 0.2.1
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 +14 -0
- package/bin/vod-devkit +129 -13
- package/contract/tools.schema.json +2 -2
- package/package.json +22 -3
- package/plugins/.agents/plugins/marketplace.json +19 -0
- package/plugins/vod-devkit/.codex-plugin/plugin.json +27 -0
- package/plugins/vod-devkit/.mcp.json +10 -0
- package/plugins/vod-devkit/build-info.json +6 -0
- package/plugins/vod-devkit/skills/vod-feedback-collect/SKILL.md +145 -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/vod_mcp/__init__.py +1 -1
- 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/runtime.json +0 -1473
package/CHANGELOG.md
CHANGED
|
@@ -106,3 +106,17 @@
|
|
|
106
106
|
- a0bd37f feat: 身份界定定稿(归属/授权分离,外部分析对表:三处不采纳+签名回执记P2);内容边界≤2000落码(U32);方案一页纸;S14-S16/U32-U34,24 用例全绿
|
|
107
107
|
- 01e61cc ci: pre-push 本地机器门禁(平台 Actions 不可用期间的替代,实测隔离为账号级平台问题)
|
|
108
108
|
|
|
109
|
+
|
|
110
|
+
## v0.2.0(2026-11-05)
|
|
111
|
+
|
|
112
|
+
- cd37786 feat(D-drift-lock+宿主接入对表): devkit 对表三件落地——①技能拷贝件漂移锁:install 记 skillHashes 指纹→doctor 比对(篡改/缺失 FAIL 引导重装;拒绝 skills-as-MCP-data 架构迁移的依据=规模变量,漂移可检先落地)②opencode /vod-doctor 自检命令随装(devkit_info/auth_status/list_submitted+key 禁令)③scripts/smoke_hosts.py 三宿主连通冒烟(无宿主 SKIP 语义;真机三 PASS)。hooks 层拒绝理由修正为威胁面对照(devkit hook=封 shell 里 hcloud 绕行路 2665 行对抗;囤积链无破坏面无绕行路)。proposal S38-S40+design 九节对照表;75 用例绿
|
|
113
|
+
- 80117b4 docs+test(D-codex-plugin-1 收口): ①proposal 新增 S36(插件自包含+stale 缓存治理+校验设备锚点)/S37(设备锚点一致性协议级)场景用例 ②design 增第八节 Codex 原生插件接入(机制实测/约束三层分工表/自包含与缓存治理/宿主能力判定纪律)③新增 S37 协议级测试:桩引擎捕获 token/meta 请求头比对设备锚点+UA 一致性+纯 hex 断言;73 用例绿
|
|
114
|
+
- 4c65af6 feat(D-codex-plugin-1 增补): devkit 对表三件采纳——①install 前清 stale 插件缓存(~/.codex/plugins/{marketplaces,cache}/vod-local,缓存不自动失效)②插件自包含:.mcp.json 改 python3+./vod_mcp/server.py 相对路径+cwd(去 npm -g 前置),sync_plugin.py 同步 vod_mcp+烧录 build-info.json 进插件包(第四版本失位点实锤:契约 version 滞留 0.1.0,vod_devkit_info 假象——release.sh 同步点 3→4)③plugin.json 补 interface 元数据;安装器校验探针补设备锚点(token/meta 同 device+UA,S1 设备绑定);自包含契约锁测试新增;72 用例绿;真机闭环:重装→codex exec 报 version=0.1.12
|
|
115
|
+
- 3ea554b feat(D-codex-plugin-1 codex 原生插件接入终态): 实测推翻'codex 无 skill 机制'——0.166 有 codex plugin add/marketplace+.codex-plugin/plugin.json(skills+mcpServers)+skills 渐进式加载;AGENTS.md 方案作废(降级模拟),改原生插件:仓内 plugins/vod-devkit(SKILL.md 采集工作流全量+.mcp.json)+本地 marketplace 清单;bin 新增 serve 子命令(.mcp.json 可移植入口);install --target codex 切原生路径+清理旧 config.toml 段/AGENTS.md 块(同名双注册防);工具描述修 S1 口径冲突(用户自报产品不采信不覆盖)。proposal S35+decisions D-codex-plugin-1(含方法论教训:判定宿主能力必须翻全 --help 子命令树);真机闭环(marketplace→add→提单不反问→product_id 落库);72 用例绿
|
|
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
|
+
- 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
|
+
|
|
119
|
+
|
|
120
|
+
## v0.2.1(2026-11-05)
|
|
121
|
+
|
|
122
|
+
|
package/bin/vod-devkit
CHANGED
|
@@ -82,6 +82,34 @@ def _server_env(args, packs: str) -> dict:
|
|
|
82
82
|
return env
|
|
83
83
|
|
|
84
84
|
|
|
85
|
+
def _skill_hashes() -> dict:
|
|
86
|
+
"""技能拷贝件指纹(D-drift-lock):安装时记录 sha256,verify/doctor 比对
|
|
87
|
+
——拷贝件与安装产物漂移可检(vendor 规则漂移实锤的针对性防线)。"""
|
|
88
|
+
import hashlib
|
|
89
|
+
out = {}
|
|
90
|
+
for entry in sorted((ROOT / "skills").iterdir()):
|
|
91
|
+
if entry.is_dir():
|
|
92
|
+
for f in sorted(entry.rglob("*")):
|
|
93
|
+
if f.is_file():
|
|
94
|
+
rel = f"{entry.name}/{f.relative_to(entry)}"
|
|
95
|
+
out[rel] = hashlib.sha256(f.read_bytes()).hexdigest()
|
|
96
|
+
return out
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
def _drifted_skills(manifest: dict) -> list:
|
|
100
|
+
"""比对 skillsDir 拷贝件与 manifest.skillHashes,返回漂移文件清单。"""
|
|
101
|
+
import hashlib
|
|
102
|
+
base = Path(manifest["skillsDir"])
|
|
103
|
+
drifted = []
|
|
104
|
+
for rel, sha in (manifest.get("skillHashes") or {}).items():
|
|
105
|
+
f = base / rel
|
|
106
|
+
if not f.exists():
|
|
107
|
+
drifted.append(f"{rel}(缺失)")
|
|
108
|
+
elif hashlib.sha256(f.read_bytes()).hexdigest() != sha:
|
|
109
|
+
drifted.append(f"{rel}(内容被改)")
|
|
110
|
+
return drifted
|
|
111
|
+
|
|
112
|
+
|
|
85
113
|
def _install_hermes(args, packs: str) -> Path:
|
|
86
114
|
"""Hermes:官方途径 hermes mcp add(config.yaml mcp_servers)。"""
|
|
87
115
|
conf = HERMES_MCP_DIR / "vod-devkit.json"
|
|
@@ -130,6 +158,20 @@ def _install_opencode(args, packs: str) -> Path:
|
|
|
130
158
|
}
|
|
131
159
|
conf.write_text(json.dumps(cfg, ensure_ascii=False, indent=2), encoding="utf-8")
|
|
132
160
|
print(f"已写入 OpenCode 配置:{conf}(重启 OpenCode 会话生效)")
|
|
161
|
+
cmd_dir = base / "command"
|
|
162
|
+
cmd_dir.mkdir(parents=True, exist_ok=True)
|
|
163
|
+
(cmd_dir / "vod-doctor.md").write_text(
|
|
164
|
+
"---\n"
|
|
165
|
+
"description: 自检 VOD DevKit 就绪状态(MCP 连通/版本/key/账本)。\n"
|
|
166
|
+
"---\n\n"
|
|
167
|
+
"使用 vod-devkit 工具做就绪自检,按序执行并汇总 OK/缺失:\n"
|
|
168
|
+
"1. 调用 vod_devkit_info:确认 version 与 commitSha 非空(版本/来源溯源)。\n"
|
|
169
|
+
"2. 调用 vod_auth_status:报告 key 配置态与引擎连通性;无 key 属正常(首次提交自动取匿名令牌)。\n"
|
|
170
|
+
"3. 调用 vod_list_submitted(limit 5):报告本机已提交反馈数(本地账本口径)。\n"
|
|
171
|
+
"4. 汇总:installed(OK)vs 缺失(需处理项)。不要打印任何 key/令牌明文。\n"
|
|
172
|
+
"若 MCP 工具不可用(刚装完未重启),提示用户重启 OpenCode 会话。\n",
|
|
173
|
+
encoding="utf-8")
|
|
174
|
+
print(f"已写入 OpenCode 自检命令:/vod-doctor({cmd_dir / 'vod-doctor.md'})")
|
|
133
175
|
return conf
|
|
134
176
|
|
|
135
177
|
|
|
@@ -153,20 +195,72 @@ def _strip_codex_vod_blocks(text: str) -> str:
|
|
|
153
195
|
return "\n".join(out).rstrip()
|
|
154
196
|
|
|
155
197
|
|
|
198
|
+
_AGENTS_MARKER_BEGIN = "<!-- vod-devkit:feedback-skill BEGIN -->"
|
|
199
|
+
_AGENTS_MARKER_END = "<!-- vod-devkit:feedback-skill END -->"
|
|
200
|
+
|
|
201
|
+
|
|
202
|
+
def _strip_agents_vod_block(text: str) -> str:
|
|
203
|
+
"""幂等剥离 AGENTS.md 中带标记的 vod-devkit 技能块(历史方案清理)。"""
|
|
204
|
+
lines, skipping, out = text.splitlines(), False, []
|
|
205
|
+
for line in lines:
|
|
206
|
+
if line.strip() == _AGENTS_MARKER_BEGIN:
|
|
207
|
+
skipping = True
|
|
208
|
+
continue
|
|
209
|
+
if line.strip() == _AGENTS_MARKER_END:
|
|
210
|
+
skipping = False
|
|
211
|
+
continue
|
|
212
|
+
if not skipping:
|
|
213
|
+
out.append(line)
|
|
214
|
+
return "\n".join(out).rstrip()
|
|
215
|
+
|
|
216
|
+
|
|
156
217
|
def _install_codex(args, packs: str) -> Path:
|
|
157
|
-
"""Codex
|
|
218
|
+
"""Codex(D-codex-agents-1 终态):原生插件路径——
|
|
219
|
+
codex plugin marketplace add <仓>/plugins + plugin add vod-devkit@vod-local,
|
|
220
|
+
打包 skills(渐进式按需加载的采集工作流)+ .mcp.json(vod-devkit serve)。
|
|
221
|
+
历史遗留清理:旧 config.toml [mcp_servers.vod-devkit] 段与 AGENTS.md 技能块
|
|
222
|
+
一并移除(与原生插件同名会双注册;AGENTS.md 方案被原生 skill 取代)。
|
|
223
|
+
前置:codex CLI 与 vod-devkit 命令在 PATH(npm i -g vod-devkit ≥0.1.12)。"""
|
|
224
|
+
codex = shutil.which("codex")
|
|
225
|
+
if not codex:
|
|
226
|
+
print("[vod-devkit] 未找到 codex CLI,无法走原生插件安装", file=sys.stderr)
|
|
227
|
+
sys.exit(2)
|
|
158
228
|
conf = Path.home() / ".codex" / "config.toml"
|
|
159
|
-
conf.
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
229
|
+
if conf.exists(): # 历史遗留:config.toml MCP 段与插件同名=双注册,移除
|
|
230
|
+
text = conf.read_text(encoding="utf-8")
|
|
231
|
+
cleaned = _strip_codex_vod_blocks(text)
|
|
232
|
+
if cleaned != text.rstrip():
|
|
233
|
+
conf.write_text(cleaned + "\n", encoding="utf-8")
|
|
234
|
+
print(f"已移除旧 config.toml MCP 段(原生插件取代):{conf}")
|
|
235
|
+
agents = Path.home() / ".codex" / "AGENTS.md"
|
|
236
|
+
if agents.exists(): # 历史遗留:AGENTS.md 技能块已被原生 skill 取代
|
|
237
|
+
text = agents.read_text(encoding="utf-8")
|
|
238
|
+
cleaned = _strip_agents_vod_block(text)
|
|
239
|
+
if cleaned != text.rstrip():
|
|
240
|
+
agents.write_text(cleaned + "\n", encoding="utf-8")
|
|
241
|
+
print(f"已移除旧 AGENTS.md 技能块(原生 skill 取代):{agents}")
|
|
242
|
+
mp_root = ROOT / "plugins"
|
|
243
|
+
|
|
244
|
+
def _run(cmd):
|
|
245
|
+
r = subprocess.run(cmd, capture_output=True, text=True, timeout=120)
|
|
246
|
+
if r.returncode != 0:
|
|
247
|
+
raise RuntimeError(f"{' '.join(cmd)} → {r.stderr.strip() or r.stdout.strip()}")
|
|
248
|
+
return r.stdout
|
|
249
|
+
|
|
250
|
+
mp_name = "vod-local"
|
|
251
|
+
# devkit 卫生实践:stale cache 先清——codex 插件缓存不自动失效,不清则
|
|
252
|
+
# 重装/升级后旧版本残留(marketplace 指向与 cache 内容漂移)
|
|
253
|
+
for stale in (Path.home() / ".codex" / "plugins" / "marketplaces" / mp_name,
|
|
254
|
+
Path.home() / ".codex" / "plugins" / "cache" / mp_name):
|
|
255
|
+
if stale.exists():
|
|
256
|
+
shutil.rmtree(stale)
|
|
257
|
+
print(f"已清理 stale 插件缓存:{stale}")
|
|
258
|
+
ml = subprocess.run([codex, "plugin", "marketplace", "list"], capture_output=True, text=True, timeout=120).stdout
|
|
259
|
+
if mp_name not in ml:
|
|
260
|
+
_run([codex, "plugin", "marketplace", "add", str(mp_root)])
|
|
261
|
+
print(f"已注册本地 marketplace:{mp_root}")
|
|
262
|
+
_run([codex, "plugin", "add", f"vod-devkit@{mp_name}"])
|
|
263
|
+
print("已安装 codex 原生插件 vod-devkit(skills + MCP,重启 Codex 会话生效)")
|
|
170
264
|
return conf
|
|
171
265
|
|
|
172
266
|
|
|
@@ -192,14 +286,21 @@ def _validate_product_or_exit(product: str, base: str) -> bool:
|
|
|
192
286
|
未命中/目录不可达一律拒绝安装并给可执行引导(宁可不装不可装错)。"""
|
|
193
287
|
import urllib.request
|
|
194
288
|
import urllib.error
|
|
289
|
+
import uuid
|
|
195
290
|
api_prefix = "/rest/developer/manager/hdvodmngservice/v1"
|
|
196
291
|
key = os.environ.get("VOD_JAVA_API_KEY", "")
|
|
197
292
|
token = ""
|
|
293
|
+
# 全程一致的设备锚点(S1 设备绑定:token 与后续请求必须同 device/UA,
|
|
294
|
+
# 否则 meta 401 设备不匹配;每次装机一个新锚点,一次校验只耗一枚令牌)
|
|
295
|
+
device = uuid.uuid4().hex[:32]
|
|
296
|
+
ua = "vod-devkit-installer/1"
|
|
198
297
|
|
|
199
298
|
def _get(url: str):
|
|
200
299
|
auth = key or token
|
|
201
300
|
req = urllib.request.Request(url, headers={
|
|
202
301
|
"content-type": "application/json",
|
|
302
|
+
"X-Vod-Device-Id": device,
|
|
303
|
+
"User-Agent": ua,
|
|
203
304
|
**({"authorization": f"Bearer {auth}"} if auth else {}),
|
|
204
305
|
})
|
|
205
306
|
with urllib.request.urlopen(req, timeout=10) as resp:
|
|
@@ -209,7 +310,8 @@ def _validate_product_or_exit(product: str, base: str) -> bool:
|
|
|
209
310
|
if not key:
|
|
210
311
|
req = urllib.request.Request( # 零字段匿名令牌(方案 C 同链)
|
|
211
312
|
f"{base}{api_prefix}/external/token", data=b"{}",
|
|
212
|
-
headers={"content-type": "application/json"
|
|
313
|
+
headers={"content-type": "application/json", "X-Vod-Device-Id": device,
|
|
314
|
+
"User-Agent": ua}, method="POST")
|
|
213
315
|
with urllib.request.urlopen(req, timeout=10) as resp:
|
|
214
316
|
body = json.loads(resp.read().decode("utf-8", "replace") or "{}")
|
|
215
317
|
token = (body.get("data") or {}).get("token") or body.get("token") or ""
|
|
@@ -352,6 +454,7 @@ def cmd_install(args):
|
|
|
352
454
|
"packs": packs,
|
|
353
455
|
"mcpConfig": str(mcp_conf),
|
|
354
456
|
"skillsDir": str(HERMES_SKILLS_DIR),
|
|
457
|
+
"skillHashes": _skill_hashes(),
|
|
355
458
|
}
|
|
356
459
|
manifest_path().write_text(json.dumps(manifest, ensure_ascii=False, indent=2),
|
|
357
460
|
encoding="utf-8")
|
|
@@ -395,6 +498,10 @@ def cmd_doctor(_args):
|
|
|
395
498
|
problems.append("MCP 配置文件缺失")
|
|
396
499
|
if not Path(mf["skillsDir"]).exists():
|
|
397
500
|
problems.append("skills 目录缺失")
|
|
501
|
+
drifted = _drifted_skills(mf)
|
|
502
|
+
if drifted:
|
|
503
|
+
problems.append("技能拷贝件与安装产物漂移(D-drift-lock):"
|
|
504
|
+
+ "、".join(drifted) + "——重跑 install 恢复")
|
|
398
505
|
if problems:
|
|
399
506
|
for x in problems:
|
|
400
507
|
print("FAIL:", x)
|
|
@@ -499,6 +606,10 @@ def cmd_uninstall(_args):
|
|
|
499
606
|
if path.exists():
|
|
500
607
|
shutil.rmtree(path) if path.is_dir() else path.unlink()
|
|
501
608
|
print("removed:", path)
|
|
609
|
+
oc_cmd = Path.home() / ".config/opencode/command/vod-doctor.md"
|
|
610
|
+
if oc_cmd.exists():
|
|
611
|
+
oc_cmd.unlink()
|
|
612
|
+
print("removed:", oc_cmd)
|
|
502
613
|
p.unlink()
|
|
503
614
|
print("removed:", p)
|
|
504
615
|
else:
|
|
@@ -530,6 +641,11 @@ def main():
|
|
|
530
641
|
s = sub.add_parser(name)
|
|
531
642
|
s.set_defaults(fn=fn)
|
|
532
643
|
sub.add_parser("build-info").set_defaults(fn=lambda a: write_build_info(strict=False))
|
|
644
|
+
|
|
645
|
+
def _serve(_a):
|
|
646
|
+
"""codex 原生插件 .mcp.json 入口:exec MCP stdio server(可移植分发)。"""
|
|
647
|
+
os.execv(sys.executable, [sys.executable, str(ROOT / "vod_mcp" / "server.py")])
|
|
648
|
+
sub.add_parser("serve").set_defaults(fn=_serve)
|
|
533
649
|
args = ap.parse_args()
|
|
534
650
|
args.fn(args)
|
|
535
651
|
|
|
@@ -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.1
|
|
4
|
+
"version": "0.2.1",
|
|
5
5
|
"tools": {
|
|
6
6
|
"vod_submit_voices": {
|
|
7
|
-
"description": "
|
|
7
|
+
"description": "提交用户反馈。product 归因由安装绑定自动完成(install --product 必配且经产品名录硬校验),调用时无需用户提供、禁止向用户询问\"提交到什么产品\";用户自报的目标产品一律不采信不覆盖(照部署产品提交,提到什么产品随正文原样传达)。批式提交对接囤积端点 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.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -10,14 +10,33 @@
|
|
|
10
10
|
"files": [
|
|
11
11
|
"npm/cli.js",
|
|
12
12
|
"bin/vod-devkit",
|
|
13
|
-
"vod_mcp/",
|
|
14
13
|
"skills/",
|
|
15
14
|
"contract/",
|
|
16
15
|
"safety/",
|
|
17
16
|
"QUICKSTART.md",
|
|
18
17
|
"README.md",
|
|
19
18
|
"CHANGELOG.md",
|
|
20
|
-
"LICENSE.txt"
|
|
19
|
+
"LICENSE.txt",
|
|
20
|
+
"vod_mcp/__init__.py",
|
|
21
|
+
"vod_mcp/server.py",
|
|
22
|
+
"vod_mcp/tools.py",
|
|
23
|
+
"vod_mcp/packs.py",
|
|
24
|
+
"vod_mcp/policy.py",
|
|
25
|
+
"vod_mcp/provenance.py",
|
|
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"
|
|
21
40
|
],
|
|
22
41
|
"keywords": [
|
|
23
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.1",
|
|
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,145 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-feedback-collect
|
|
3
|
+
description: Use when 用户表达对本产品的反馈、不满、建议或明确要求提交反馈(慢/错/卡/希望支持/记下来反馈给产品团队)。采集-确认-提交-回执一条线;产品归由安装绑定自动完成,不问用户
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# VOD 用户反馈采集
|
|
7
|
+
|
|
8
|
+
闭环:用户反馈 → agent 识别 → 用户确认 → 入库(不触发分析)→ 运营择机
|
|
9
|
+
批量分析 → 报告/看板 → 产品改进。
|
|
10
|
+
|
|
11
|
+
## 触发识别
|
|
12
|
+
|
|
13
|
+
**本技能是什么(一句话)**:把用户对本产品的反馈整理为一条声音、
|
|
14
|
+
经用户同意后提交到 VOD、把回执用人话告诉用户。模型在此过程中
|
|
15
|
+
只做三件事:**识别反馈意图、忠实转写用户原话、征得提交同意**。
|
|
16
|
+
决定权在用户:说什么、何时提交,都由用户定;模型不补写、不判断、
|
|
17
|
+
不发散(细则见下方各条禁令——它们是这三件事的实施边界,不是职责本身)。
|
|
18
|
+
|
|
19
|
+
**触发条件(满足任一即加载本技能)**:
|
|
20
|
+
1. 用户表达对本产品的否定或建议——关键词如:慢、报错、不好用、
|
|
21
|
+
希望支持、建议增加、为什么不能、体验差;
|
|
22
|
+
2. 用户明确要求提交反馈——"记下来"、"反馈给产品团队"、"提交这条";
|
|
23
|
+
3. 连续两轮抱怨同一问题。
|
|
24
|
+
不满足时本技能不激活(产品问答、闲聊、操作指导等交回宿主通用能力)。
|
|
25
|
+
|
|
26
|
+
**字段处理分级(借鉴 gitcode-issue-creator,先于一切)**:
|
|
27
|
+
| 字段 | 处理 | 规则 |
|
|
28
|
+
|------|------|------|
|
|
29
|
+
| content | 🔒 原样保留 | 用户原话忠实转写,只做脱敏(密钥替换);禁止改写、扩展、补充情感结论(如"体验不好")或任何用户没说的内容 |
|
|
30
|
+
| title | 🧠 推断摘要 | 从用户表述提炼核心问题(引擎自动截前 64 字,无需手拼) |
|
|
31
|
+
| 分类 | 🧠 推断 | 从内容判断三分类之一;判断不了不选(引擎重判兜底) |
|
|
32
|
+
|
|
33
|
+
**推断 ≠ 编造(关键辨析)**:
|
|
34
|
+
- ✅ 推断:用户说"AIShell 补全经常卡住" → content 原样保留,分类=产品缺陷(从"经常卡住"提取重组)
|
|
35
|
+
- ❌ 编造:用户只说了"AIShell" → 写成"AIShell 产品体验不好"(用户没说体验不好——情感结论是编造,实锤事故)
|
|
36
|
+
- ✅ 推断:用户说"希望支持扫码授权" → 分类=功能建议
|
|
37
|
+
- ❌ 编造:用户问"AIShell 是什么"(提问不是反馈)→ 不采集,需澄清
|
|
38
|
+
|
|
39
|
+
**调用前强制预检(不过不许调用)**:
|
|
40
|
+
检查 1: content 是否等于用户原话?(≠ → 改回原话)
|
|
41
|
+
检查 2: 用户的话是否构成一条反馈(有具体对象/现象)?裸产品名、
|
|
42
|
+
纯提问、闲聊 → 停止采集,先澄清用户想说什么
|
|
43
|
+
检查 3: 分类是否与内容相符?(不符 → 重新推断)
|
|
44
|
+
|
|
45
|
+
**不追问原则**:内容太泛时引导一次("说下具体现象?"),用户不补
|
|
46
|
+
就按原话提交或放弃——禁止反复追问,禁止替用户脑补现象细节。
|
|
47
|
+
|
|
48
|
+
**职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
|
|
49
|
+
产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
|
|
50
|
+
配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
|
|
51
|
+
一句"这不在反馈功能范围内"即可,或交回宿主通用能力处理。
|
|
52
|
+
模型发散=把内部实现端给用户(实锤:'AIShell 是归因产品名之一'+
|
|
53
|
+
白名单/文档行号整套端出去)。
|
|
54
|
+
|
|
55
|
+
用户表达针对**本产品(宿主 agent 产品)**的体验反馈,特征:
|
|
56
|
+
- 抱怨/问题:慢、错、卡、缺失功能、交互别扭
|
|
57
|
+
- 建议/期望:希望支持、要是能…就好了、建议增加
|
|
58
|
+
- 区分边界:用户抱怨的是**宿主产品**才走本技能;用户在讨论第三方
|
|
59
|
+
事物(某网站、某文档)不采集;用户要求提交"工单"类诉求时可询问
|
|
60
|
+
是否愿意同步收录为产品反馈(只确认收录意愿,不问产品归属)
|
|
61
|
+
|
|
62
|
+
## 采集流程
|
|
63
|
+
|
|
64
|
+
0. 产品归因(安装时已配置,不问用户):产品=安装/部署时绑定的
|
|
65
|
+
宿主产品(install --product / dsh profile config),工具与引擎
|
|
66
|
+
自动赋值——**禁止向用户追问"哪个产品"**(用户不知道也不该知道
|
|
67
|
+
采集侧的归因配置)。**用户自报的目标产品一律不采信、不覆盖**
|
|
68
|
+
(S1 同源原则:话术可以把反馈投到任意产品=污染别人产品数据)。
|
|
69
|
+
用户说"这是给 XX 的反馈"→ 照常按部署产品提交,内容原样保留
|
|
70
|
+
(提到什么产品随正文传达);不要确认、不要改归因
|
|
71
|
+
1. 识别到反馈意图 → 先口头确认收录意愿("要把这条反馈提交给产品
|
|
72
|
+
团队吗?")
|
|
73
|
+
2. 用户同意 → 结构化为声音(不篡改原意):
|
|
74
|
+
- content:用户反馈内容(尽量保留用户原话措辞,可轻度去噪)
|
|
75
|
+
- userType:可判断时填(企业/个人),不确定不填
|
|
76
|
+
- tags:明显的主题词(性能/功能/易用性),最多 3 个
|
|
77
|
+
3. 调用 vod_submit_voices(必须用户已确认,confirmed=true)——
|
|
78
|
+
**一次一批**,攒多条一起交也行,但每批都要用户点头
|
|
79
|
+
4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
|
|
80
|
+
**voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
|
|
81
|
+
用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
|
|
82
|
+
|
|
83
|
+
## 纪律
|
|
84
|
+
|
|
85
|
+
0. 回执纪律(F2,成功与失败路径同口径):给用户的话=人话
|
|
86
|
+
(成功=已收录/产品团队会看到;失败=提交失败,反馈已暂存本机,
|
|
87
|
+
稍后会自动重试)。**失败时禁止向用户复述内部诊断字段**——HTTP
|
|
88
|
+
状态码、apiKeyFingerprint、tokenTier、堆栈等属于 agent 内部排障
|
|
89
|
+
信息,用户看不到也不需要看;匿名档用户没有"凭据"概念,"凭据未
|
|
90
|
+
配置"对他们是无效信息。voiceId/taskId 是对账主键,在 agent 内部
|
|
91
|
+
使用,不出现在用户可见文案里。
|
|
92
|
+
**工具名与机制词同理不外露**:对用户永远说"提交反馈",禁止出现
|
|
93
|
+
vod_submit_voices 等工具名,禁止"调用/被拒/护栏/参数/配额"等
|
|
94
|
+
机制词(实锤:"vod_submit_voices 被我调用后你拒绝了它"——用户
|
|
95
|
+
看不懂谁调用了什么、自己为什么成了拒绝者)。主语纪律:动作主体
|
|
96
|
+
是"我"(agent 替用户提交),系统行为统一说"系统/稍后自动",不
|
|
97
|
+
把内部裁决说成用户的行为
|
|
98
|
+
1. 逐次确认:每批提交前用户点头一次,不打包沉默提交(护栏强制,
|
|
99
|
+
confirmed=false 会被拒)
|
|
100
|
+
2. 来源标记由插件自动注入(宿主身份),不手填——防伪造
|
|
101
|
+
3. content 是用户原话,agent 不加自己的评价/总结进 content
|
|
102
|
+
4. 不提交用户身份信息(姓名/账号/工号)——内容里的凭据类内容
|
|
103
|
+
会被 deny 护栏拦截
|
|
104
|
+
5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
|
|
105
|
+
6. 单批上限 50 条,超限分批
|
|
106
|
+
|
|
107
|
+
## 对齐 VOD-Project 采集标准(2026-11-04 二轮修订,待一次真实用户观测后定稿)
|
|
108
|
+
|
|
109
|
+
学习源=VOD-Project skills/bbs-suggestion + vod-sync/SKILL.md(深读):
|
|
110
|
+
|
|
111
|
+
### content 模板(替代自由拼装,四节加粗标签)
|
|
112
|
+
```
|
|
113
|
+
用户原话(不加标签,保留措辞)
|
|
114
|
+
|
|
115
|
+
**使用场景:**
|
|
116
|
+
(agent 推断,不允许空——空=拒提交,逼推断)
|
|
117
|
+
|
|
118
|
+
**当前影响:**(可选)
|
|
119
|
+
|
|
120
|
+
**期望能力:**
|
|
121
|
+
|
|
122
|
+
**声音来源:**
|
|
123
|
+
(agent 会话平台:cli/飞书/企业微信…——运行时从宿主会话上下文
|
|
124
|
+
获取,禁止硬编码默认值;对齐 detect_channel 纪律)
|
|
125
|
+
```
|
|
126
|
+
- 有对话上下文时:最近 5 轮用户消息格式化为 `> 用户:原话` 引用块
|
|
127
|
+
置顶(过滤触发词、与 content 重复的最后一条去掉)
|
|
128
|
+
|
|
129
|
+
### 分类(采集层三分类,不越层)
|
|
130
|
+
- 给用户的选项=功能建议/用户体验/产品缺陷(云声表单标准);
|
|
131
|
+
六类是引擎 n01 分析层内部枚举,agent 侧不使用、不自造第四个枚举
|
|
132
|
+
- 落 tags=["problem_type:<三分类值>"],引擎以【类型名】标题前缀正式
|
|
133
|
+
入库,n01 照常重判——两层并存,agent 不许宣称"分类即定案"
|
|
134
|
+
|
|
135
|
+
### 路由纪律
|
|
136
|
+
- 用户说"反馈/报告问题/提 issue"→引擎 ISYNC 审核队列路径(本技能
|
|
137
|
+
提交即入队,运营复审后建 issue),agent 不直接建 GitCode issue
|
|
138
|
+
- 用户明确"提建议"且要求直上渠道时才提及云声链(bbs-suggestion 为
|
|
139
|
+
VOD-Project 内部资产,外部 agent 不分发)
|
|
140
|
+
|
|
141
|
+
### 自检清单(提交前逐条过,不过不提交)
|
|
142
|
+
- [ ] content 含四节模板且使用场景/期望能力非空?
|
|
143
|
+
- [ ] 声音来源=真实会话平台(非硬编码)?
|
|
144
|
+
- [ ] 分类(若有)是三分类枚举值?
|
|
145
|
+
- [ ] 未把 agent 自己的评价混进用户原话?
|
|
@@ -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.1"
|
|
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"]
|