vod-devkit 0.1.2 → 0.1.4

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -11,6 +11,26 @@ version: 1
11
11
 
12
12
  ## 触发识别
13
13
 
14
+ **本技能是什么(一句话)**:把用户对本产品的反馈整理为一条声音、
15
+ 经用户同意后提交到 VOD、把回执用人话告诉用户。模型在此过程中
16
+ 只做三件事:**识别反馈意图、忠实转写用户原话、征得提交同意**。
17
+ 决定权在用户:说什么、何时提交,都由用户定;模型不补写、不判断、
18
+ 不发散(细则见下方各条禁令——它们是这三件事的实施边界,不是职责本身)。
19
+
20
+ **触发条件(满足任一即加载本技能)**:
21
+ 1. 用户表达对本产品的否定或建议——关键词如:慢、报错、不好用、
22
+ 希望支持、建议增加、为什么不能、体验差;
23
+ 2. 用户明确要求提交反馈——"记下来"、"反馈给产品团队"、"提交这条";
24
+ 3. 连续两轮抱怨同一问题。
25
+ 不满足时本技能不激活(产品问答、闲聊、操作指导等交回宿主通用能力)。
26
+
27
+ **职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
28
+ 产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
29
+ 配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
30
+ 一句"这不在反馈功能范围内"即可,或交回宿主通用能力处理。
31
+ 模型发散=把内部实现端给用户(实锤:'AIShell 是归因产品名之一'+
32
+ 白名单/文档行号整套端出去)。
33
+
14
34
  用户表达针对**本产品(宿主 agent 产品)**的体验反馈,特征:
15
35
  - 抱怨/问题:慢、错、卡、缺失功能、交互别扭
16
36
  - 建议/期望:希望支持、要是能…就好了、建议增加
@@ -47,7 +67,13 @@ version: 1
47
67
  状态码、apiKeyFingerprint、tokenTier、堆栈等属于 agent 内部排障
48
68
  信息,用户看不到也不需要看;匿名档用户没有"凭据"概念,"凭据未
49
69
  配置"对他们是无效信息。voiceId/taskId 是对账主键,在 agent 内部
50
- 使用,不出现在用户可见文案里
70
+ 使用,不出现在用户可见文案里。
71
+ **工具名与机制词同理不外露**:对用户永远说"提交反馈",禁止出现
72
+ vod_submit_voices 等工具名,禁止"调用/被拒/护栏/参数/配额"等
73
+ 机制词(实锤:"vod_submit_voices 被我调用后你拒绝了它"——用户
74
+ 看不懂谁调用了什么、自己为什么成了拒绝者)。主语纪律:动作主体
75
+ 是"我"(agent 替用户提交),系统行为统一说"系统/稍后自动",不
76
+ 把内部裁决说成用户的行为
51
77
  1. 逐次确认:每批提交前用户点头一次,不打包沉默提交(护栏强制,
52
78
  confirmed=false 会被拒)
53
79
  2. 来源标记由插件自动注入(宿主身份),不手填——防伪造