vod-devkit 0.1.1 → 0.1.3

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/README.md CHANGED
@@ -17,16 +17,17 @@ MCP / skills / packs / policy),面向"服务面插件"的护栏更保守。
17
17
 
18
18
  ## 安装(外部用户,零配置)
19
19
 
20
+ 完整分宿主指南见 [INSTALL.md](INSTALL.md)。速览:
21
+
20
22
  ```bash
21
- # 任意 MCP 宿主(Hermes / OpenCode / Codex 客户端等):
22
- npx github:yangaiwu/vod-devkit # 引导器自动探测宿主并安装
23
+ # 任意 MCP 宿主(Hermes / OpenCode / Codex 客户端等):npm 公网已发布
24
+ npx --yes vod-devkit install --target opencode --product codearts
23
25
 
24
26
  # WorkBuddy / CodeBuddy(GitHub 仓即市场,无审核):
25
27
  /plugin marketplace add yangaiwu/vod-devkit
26
28
 
27
- # DeepSeek Harness (dsh):npm 包 dsh-vod-devkit(薄壳同语义);
28
- # npm 首发后可在 dsh 社区目录一键安装,暂可用本地包:
29
- dsh plugin --profile <profile> add dsh/dsh-vod-devkit-0.1.0.tgz
29
+ # DeepSeek Harness (dsh):薄壳包 dsh-vod-devkit(npm 同名);目录收录审核中
30
+ dsh plugin --profile <profile> add dsh-vod-devkit
30
31
  ```
31
32
 
32
33
  安装后即用:平台地址有默认值,首次提交自动申请零字段匿名令牌。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -11,19 +11,29 @@ version: 1
11
11
 
12
12
  ## 触发识别
13
13
 
14
+ **职责边界(先于一切)**:本技能只做一件事=采集-确认-提交-回执。
15
+ 产品问答("AIShell 是什么")、产品对比、内部机制解释(归因/白名单/
16
+ 配额)一律**不在职责内**:不读仓库文档作答、不展开、不主动科普——
17
+ 一句"这不在反馈功能范围内"即可,或交回宿主通用能力处理。
18
+ 模型发散=把内部实现端给用户(实锤:'AIShell 是归因产品名之一'+
19
+ 白名单/文档行号整套端出去)。
20
+
14
21
  用户表达针对**本产品(宿主 agent 产品)**的体验反馈,特征:
15
22
  - 抱怨/问题:慢、错、卡、缺失功能、交互别扭
16
23
  - 建议/期望:希望支持、要是能…就好了、建议增加
17
24
  - 区分边界:用户抱怨的是**宿主产品**才走本技能;用户在讨论第三方
18
25
  事物(某网站、某文档)不采集;用户要求提交"工单"类诉求时可询问
19
- 是否愿意同步收录为产品反馈
26
+ 是否愿意同步收录为产品反馈(只确认收录意愿,不问产品归属)
20
27
 
21
28
  ## 采集流程
22
29
 
23
- 0. 产品归因(先于一切):这条反馈关于哪个产品?
24
- 优先级=用户明示("你们 AIShell 的补全太慢")> 安装绑定默认 >
25
- **询问用户**。禁止静默猜——归因错误会污染目标产品的数据
26
- (护栏会拦:无归因直接报错并给出三种解法)
30
+ 0. 产品归因(安装时已配置,不问用户):产品=安装/部署时绑定的
31
+ 宿主产品(install --product / dsh profile config),工具与引擎
32
+ 自动赋值——**禁止向用户追问"哪个产品"**(用户不知道也不该知道
33
+ 采集侧的归因配置)。**用户自报的目标产品一律不采信、不覆盖**
34
+ (S1 同源原则:话术可以把反馈投到任意产品=污染别人产品数据)。
35
+ 用户说"这是给 XX 的反馈"→ 照常按部署产品提交,内容原样保留
36
+ (提到什么产品随正文传达);不要确认、不要改归因
27
37
  1. 识别到反馈意图 → 先口头确认收录意愿("要把这条反馈提交给产品
28
38
  团队吗?")
29
39
  2. 用户同意 → 结构化为声音(不篡改原意):
@@ -38,8 +48,19 @@ version: 1
38
48
 
39
49
  ## 纪律
40
50
 
41
- 0. 回执纪律(F2):给用户的话=人话(已收录/产品团队会看到);
42
- voiceId/taskId 是对账主键,在 agent 内部使用,不出现在用户可见文案里
51
+ 0. 回执纪律(F2,成功与失败路径同口径):给用户的话=人话
52
+ (成功=已收录/产品团队会看到;失败=提交失败,反馈已暂存本机,
53
+ 稍后会自动重试)。**失败时禁止向用户复述内部诊断字段**——HTTP
54
+ 状态码、apiKeyFingerprint、tokenTier、堆栈等属于 agent 内部排障
55
+ 信息,用户看不到也不需要看;匿名档用户没有"凭据"概念,"凭据未
56
+ 配置"对他们是无效信息。voiceId/taskId 是对账主键,在 agent 内部
57
+ 使用,不出现在用户可见文案里。
58
+ **工具名与机制词同理不外露**:对用户永远说"提交反馈",禁止出现
59
+ vod_submit_voices 等工具名,禁止"调用/被拒/护栏/参数/配额"等
60
+ 机制词(实锤:"vod_submit_voices 被我调用后你拒绝了它"——用户
61
+ 看不懂谁调用了什么、自己为什么成了拒绝者)。主语纪律:动作主体
62
+ 是"我"(agent 替用户提交),系统行为统一说"系统/稍后自动",不
63
+ 把内部裁决说成用户的行为
43
64
  1. 逐次确认:每批提交前用户点头一次,不打包沉默提交(护栏强制,
44
65
  confirmed=false 会被拒)
45
66
  2. 来源标记由插件自动注入(宿主身份),不手填——防伪造