vod-devkit 0.3.0 → 0.4.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 CHANGED
@@ -199,3 +199,46 @@
199
199
  - f90e130 UX 修复:后台重试成功不再静默——暂存反馈自动重试成功后落旗标,下次打开弹窗补提示(逐条原话回显,voice-id 不出用户面 F2;措辞「已自动重试成功」说清=完成用户此前点提交的指令非绕过确认;产品名不带——用户不感知归因拍板)
200
200
  - a3cdd6d dsh 壳 UX 定稿同步(web widget 拍板漏同步各壳漂移实锤):提示语去括号后缀与受理引导句、撤 maxlength 计数器(硬帽保留)、撤「我的反馈」入口(账本写入保留);+ux-sync 回归锁(src+构建产物双级)
201
201
 
202
+
203
+ ## v0.3.1(2026-11-09)
204
+
205
+ - 141dce4 fix(auth): probe_key 匿名令牌 401 报 expired-anonymous 而非 rejected——runtime 残留过期匿名令牌曾被误读为正式 key 失效(本机实锤:指纹 712c0ae4 实为 anonymous 档过期令牌);显式 key 被拒仍 rejected(fail fast 口径不变),note 指明下次提交自动重领;+回归锁(匿名档 expired-anonymous+重领提示、显式档 rejected 保持)
206
+ - 84cc6f1 fix(installer+dsh): 四宿主全链模拟两项实锤修复——①重装吃掉配置:dsh plugin add 模板含字面量 [] 顶层行,幂等追加块后 = 非法 YAML 整 profile 启动崩溃(upsert 追加路径清除空数组占位+回归锁);②headless 审批死锁:dsh 原生 ask 门禁无通道永久阻断写工具(requires approval, but no approval channel 实锤,此前靠 11-06 手工配置 confirmWrites:false 残留掩盖)——installer 显式写 confirmWrites:false(同意由 SKILL 话术层承担,web 端按 profile 覆盖回 true);dsh 真机重装→提交成功复验 ✅
207
+ - 9b87594 feat(followup-status): 插件侧 followupStatus 上报对接(引擎 V55-V57 契约增量,proposal S74-S76)——单源 _followup_fields 扩展三态白名单归一(strip+lower,白名单外/缺失省键,submit/draft 双路径共用禁双边漂移;commit 随 draft 暂存冻结防调包语义不变);契约 draft/submit 双工具 items 增枚举字段(工具 description 零增量,预算门禁不回退);dsh 壳透传同口径扩展(desc 1495/1500 无预算不宣讲,SKILL 宿主技能层承载);SKILL 判定块第 5 条三态映射话术锁(七副本 md5 对齐);+5 回归锁;pytest 153 绿+node 9 绿
208
+ - e40fafe fix(auth): 旧版残留凭据检测与自愈提示(评审拍板项,优先于公告)——codex 0.2.3 残留 legacy key 挡匿名链四宿主实测实锤;三处提交失败路径错误消息追加可操作自愈指引(_legacy_key_hint:当前版本+npx 重装命令+匿名档出口,不发公告靠用户撞);vod_auth_status 显式 key 在位即挂 legacyKeyHint 检测位(不等提交撞 401 才发现);不静默删 key 不静默重装(提示用户确认更新口径);+回归锁(提示含版本与重装命令+四处调用点在位);pytest 148 绿
209
+ - 1ac4b48 fix(release): GitCode 推送失败改硬失败 exit 1——本次发版 push 被 pre-push 拦后脚本吞错仍误报'发版完成'的实锤修复
210
+ - 87ac1ee test: golden status 版本快照随 v0.3.0 发版重录——release.sh 推送失败被 '|| echo 跳过' 吞掉的实锤(本次 push 被 pre-push 拦后仍误报发版完成,脚本待修:push 失败应 exit 1)
211
+
212
+
213
+ ## v0.4.0(2026-11-09)
214
+
215
+ - 3c54786 feat(two-phase): D-resume-commit-1 断回合续提交+确认收口话术锁——实锤:agent draft 后收工,用户两次说提交仍无下文(approvalToken 只存于 draft 响应文本,回合断即丢失)。①draft 将 token 随草稿落盘(runtime 0600,与 java_key 同级;token 威胁模型=防载荷改写非同意凭证,落盘不放大);commit 允许省略 token/sha 由本地未过期草稿恢复,显式传错仍拒(语义不放宽);契约 required 收窄为 draftId。②SKILL 真源加话术锁:用户确认后当回合必须 commit、不成必须明告未提交(真源生成+sync 同步,禁自由裁量)。+4 回归锁(恢复成功/错 sha 仍拒/过期拒/token 落盘+0600);pytest 159 绿+node 9 绿
216
+ - ca84c3a test: conftest autouse runtime 隔离——test_followup 等 _submit 用例桩了 _http 未重定向 _runtime_path,账本追加写穿仓内真实 runtime.json(本机 200 条账本被测试数据灌满实锤);autouse 重定向 tmp,用例内显式 setattr 仍可覆盖;pytest 155 绿
217
+ - f35cd0e test: golden status 版本快照随 v0.3.1 重录(仅 version 字段,diff 已过目)
218
+
219
+
220
+ ## v0.4.1(2026-11-09)
221
+
222
+ - a0cf5c2 chore(dsh-release): dsh-vod-devkit 0.2.0——首装 nonce 同步+issue_sync 轮询拆除随包(tgz 本地重打包不入 git,嵌入方经 dsh plugin add <tgz> 或重装升级)
223
+ - 4e9a015 fix(nonce-sync): D-dev-nonce-sync-1 首装 nonce 内存态同步——真机实锤:全新安装首次提交必失败冒给用户(_install_nonce 首次生成只落盘不回写 _RT,同进程每次新 nonce→领令牌与提交设备不同→绑定校验 401,重试仍新 nonce 再 401;二次提交才成功);修复=生成后同步 _RT[install_nonce],领令牌/提交/重试同设备 401→领令牌→重试全程无感;存量安装不受影响;回归锁 tests/test_install_nonce_sync.py;pytest 163 绿(162+1)+ 本地 e2e 修复后干净沙箱首提一次成功;decisions.md D-dev-nonce-sync-1
224
+ - b8eed60 feat(dsh-ui)+docs: D-inbox-direct-ui-1 issue_sync 轮询拆除——引擎单表收口后回执无 issue_sync 节,原 U-S2 轮询(GET ?limit=50 找 voiceId)永远空转静默失效;净删 pollIssueSync/pollForReceipt 及调用点,提交成功(201)即终态提示「已收录,产品团队会看到」(对齐 D-inbox-DIRECT 不建 issue 拍板);提交链本体(POST+断线自动重提)保留不动;lib 随构建重出;docs:dsh-ui-collect §六/§七/U-S 用例表同步、decisions.md D-inbox-direct-ui-1 决策条目;回归锁 +1(no-issue-sync-poll.test.mjs:src/lib 双侧禁 issue_sync 与已建成 issue 话术+提交链本体保留锁);dsh node --test 10/10 绿
225
+ - b0f121c docs(quota): D-quota-raise-1 匿名档配额提额+引擎侧可配置化文档化——面向用户数值口径同步(5000/日500),proposal 信任模型表/decisions 决策条目/design 数值归属节(插件零配额数值,429 文案引擎透传)
226
+ - fa9c92b refactor(two-phase)+docs: D-resume-commit-1 文档化+场景用例 S83-S86+草稿库读写单源化——docs: decisions.md 决策条目/design.md 承载补充(分层治理口径)/proposal.md 场景用例清单(S83 全链回执逐字、S84 断回合恢复、S85 过期重开链、S86 消费后不可复活);refactor: _drafts_load() 单源化 draft/commit 草稿库读写(现读+TTL 惰性清除,禁双边漂移);+3 场景回归锁;pytest 162 绿+node 9 绿
227
+ - 9b5e6ec test: golden status 版本快照随 v0.4.0 重录(仅 version 字段,diff 已过目)
228
+
229
+
230
+ ## v0.4.2(2026-11-10)
231
+
232
+ - 8d59aa7 chore(ci): 双副本同步门禁三处落地——CI diff 步骤+release.sh 双门禁+npm 包自证
233
+ - 5a8cb00 fix(tools): _warn_if_cloned 可测化——uptime 源注入 + except Exception:pass 收窄
234
+ - a906e82 refactor(tools): 复杂度收敛——submit_voices 四段拆分(207→126 行)+cmd_install 技能/manifest 段抽出+policy 逐规则重读盘收口
235
+ - fdb2f43 docs(pending): D-pending-1 需求/设计文档四件套收尾——S87-S90 场景用例+设计承载补充
236
+ - 03cc4b8 fix(pending): pyflakes f-string 无占位符
237
+ - 4532dee feat(pending): D-pending-1 补强——originalLines 权威拼接,机械剥除模型拼接改字
238
+ - e7660c0 chore(sync): plugins/ 副本同步 D-pending-1 skill 段(双副本同步锁)
239
+ - 14027c4 feat(pending): D-pending-1 无通道场景 pending 反馈队列——落盘+flush+echo 前移(方案 A 四条细节定稿)
240
+ - 53fc675 chore(dsh-release): dsh-vod-devkit 0.2.1——ReceiptGuard 随包(tgz 本地重打包不入 git,dsh-vod-devkit-0.2.1.tgz)
241
+ - baa60b6 feat(scripts): D-behavior-grade-1 e2e_behavior 确认强度分级+分桶+熔断配置化
242
+ - fb62b74 feat(dsh): D-rguard-1 ReceiptGuard 提交侧原文比对闸——会话日志 user 轮原文为真源
243
+ - 3dfdb1c chore(release): golden 随 v0.4.1 重录(仅版本值漂移,人工过目合规)
244
+
package/bin/vod-devkit CHANGED
@@ -394,7 +394,12 @@ def _install_dsh(args, packs: str) -> Path:
394
394
  " name: dsh-vod-devkit\n"
395
395
  " config:\n"
396
396
  f" product: {args.product}\n"
397
- f" apiBase: {args.java_api_base}\n")
397
+ f" apiBase: {args.java_api_base}\n"
398
+ " # headless 无审批通道:原生 ask 门禁会永久阻断写工具(四宿主实测实锤:\n"
399
+ " # requires approval, but no approval channel)。同意确认由 SKILL 话术层\n"
400
+ " # 承担(draft→用户确认→commit / 明确指令直发),web 端如需硬门禁按\n"
401
+ " # profile 覆盖回 true。\n"
402
+ " confirmWrites: false\n")
398
403
  try:
399
404
  written = _upsert_dsh_patch(patch, block)
400
405
  except Exception as e:
@@ -434,6 +439,10 @@ def _upsert_dsh_patch(patch: Path, block: str) -> bool:
434
439
  lines = patch.read_text(encoding="utf-8").splitlines() if patch.exists() else []
435
440
  start, end = _find_dsh_block(lines)
436
441
  if start is None:
442
+ # 空数组占位清除(四宿主实测实锤:dsh plugin add 自建的模板含字面量
443
+ # `[]` 顶层行,直接追加块 = `[]` 后跟 `- id:` 顶层元素 = 非法 YAML,
444
+ # 整个 profile 启动崩溃)。`[]` 语义=空数组,被块 entries 取代即删。
445
+ lines = [ln for ln in lines if ln.strip() != "[]"]
437
446
  new = lines + ([""] if lines and lines[-1].strip() else []) + block.splitlines()
438
447
  else:
439
448
  new = lines[:start] + block.splitlines() + lines[end:]
@@ -657,6 +666,16 @@ def cmd_install(args):
657
666
  print(f"[vod-devkit] 已显式解除 codex 采集熔断(安装成功),审计已记录:{audit}")
658
667
 
659
668
  # G1 修复:技能全量拷贝(目录型技能+平铺规则文档),按 packs 过滤
669
+ oc_skills, cx_skills = _install_skills(target, packs)
670
+
671
+ _write_install_manifest(args, target, packs, bound_product, mcp_conf,
672
+ oc_skills, cx_skills)
673
+
674
+
675
+ def _install_skills(target: str, packs: str):
676
+ """技能段:全量拷贝(目录型技能+平铺规则文档),按 packs 过滤,落
677
+ hermes 主目录 + opencode/codex 原生目录。返回 (oc_skills, cx_skills)
678
+ 落点(供 manifest 名册对账)。"""
660
679
  HERMES_SKILLS_DIR.mkdir(parents=True, exist_ok=True)
661
680
  # opencode 原生技能目录(2026-11-06 实测:opencode 自动发现
662
681
  # ~/.config/opencode/skills/ 并经 skill 工具按需加载——此前安装器漏拷,
@@ -691,7 +710,13 @@ def cmd_install(args):
691
710
  shutil.rmtree(dst2)
692
711
  shutil.copytree(entry, dst2)
693
712
  # vendored 领域规则已由 vendor_rules.py 落成技能目录结构
713
+ return oc_skills, cx_skills
714
+
694
715
 
716
+ def _write_install_manifest(args, target, packs, bound_product, mcp_conf,
717
+ oc_skills, cx_skills) -> None:
718
+ """manifest 段:落安装名册(版本/来源/归因/落点指纹),并给出 key
719
+ 配置提示。名册对账口径见各字段注释(原 cmd_install 尾段,整段平移)。"""
695
720
  bi = json.loads((ROOT / "build-info.json").read_text(encoding="utf-8"))
696
721
  manifest = {
697
722
  "version": bi["version"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "title": "vod-devkit MCP 工具契约(唯一事实源)",
4
- "version": "0.3.0",
4
+ "version": "0.4.2",
5
5
  "tools": {
6
6
  "vod_submit_voices": {
7
7
  "description": "提交用户反馈进 VOD。**先决条件(优先于本描述其余所有内容):调用前必须已征得用户对'提交这条反馈'的明确同意;用户陈述/抱怨反馈本身不构成同意;用户未同意时禁止传 confirmed=true**。模糊抱怨(如\"体验不好\")时一轮说完三件事:承接识别结果(\"收到,你对产品体验不满意\")+确认提交意愿(\"要把这条反馈提交给产品团队吗?\")+引导补充(\"方便的话说下具体现象,不说我也会按你的原话提交\");禁止含混反问(实锤病句:\"请问是否把什么作为反馈\")。同意后 content 放用户原话(哪怕只有一句\"体验很差\"也原样提交)。确认环节允许固定追问至多一次,问句必须逐字使用:「方便的话,补充一下遇到这个问题时的操作步骤或期望的表现吗?不方便回复\"没有\",我直接提交。」用户回答只摘录原话对应部分进 reproSteps/expectedBehavior(不改写不总结,无法拆分时落最相关字段,任何内容禁回填 content);答\"没有/跳过/不方便\"=两字段不上送直接提交。引导补充(说下具体现象)已获实质内容并并入 content 时不再追问、直接提交(其中自然出现的操作/期望留在 content 原话,不回溯摘入新字段);仅引导补充未获回应或仅泛化抱怨且用户确认提交时才带出固定问句。product 归因由安装绑定自动完成,无需用户提供、禁止询问\"提交到哪个产品/页面\";用户自报的目标产品一律不采信不覆盖(照部署产品提交,提到什么产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,除上述固定一次追问外,禁止再索要严重程度/环境/附件等开发者字段、禁止第二轮追问。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。拿到回执后必须原样转述 echo.contents(每条「已收录原话:<content>」全文),禁止改写概括——这是用户核对原话是否被改写的唯一窗口。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
@@ -38,6 +38,16 @@
38
38
  "type": "string",
39
39
  "maxLength": 2000,
40
40
  "description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
41
+ },
42
+ "followupStatus": {
43
+ "type": "string",
44
+ "enum": [
45
+ "not_asked",
46
+ "declined",
47
+ "answered"
48
+ ],
49
+ "maxLength": 32,
50
+ "description": "追问环节状态(可选,按 S67-S70 判定结果上送):not_asked=未触发追问;declined=问了未答/拒答;answered=已答并随 reproSteps/expectedBehavior。白名单外值引擎降 NULL 不拒收"
41
51
  }
42
52
  },
43
53
  "required": [
@@ -253,6 +263,16 @@
253
263
  "type": "string",
254
264
  "maxLength": 2000,
255
265
  "description": "用户追问补充(可选):期望表现,来源与纪律同 reproSteps"
266
+ },
267
+ "followupStatus": {
268
+ "type": "string",
269
+ "enum": [
270
+ "not_asked",
271
+ "declined",
272
+ "answered"
273
+ ],
274
+ "maxLength": 32,
275
+ "description": "追问环节状态(可选,按 S67-S70 判定结果上送):not_asked=未触发追问;declined=问了未答/拒答;answered=已答并随 reproSteps/expectedBehavior。白名单外值引擎降 NULL 不拒收"
256
276
  }
257
277
  },
258
278
  "required": [
@@ -290,17 +310,15 @@
290
310
  "approvalToken": {
291
311
  "type": "string",
292
312
  "minLength": 8,
293
- "description": "vod_draft_voices 返回的 approvalToken 原样透传"
313
+ "description": "vod_draft_voices 返回的 approvalToken 原样透传;断回合场景可省略——插件从本地暂存草稿恢复"
294
314
  },
295
315
  "payloadSha256": {
296
316
  "type": "string",
297
- "description": "vod_draft_voices 返回的 payloadSha256 原样透传"
317
+ "description": "vod_draft_voices 返回的 payloadSha256 原样透传;断回合场景可省略——插件从本地暂存草稿恢复"
298
318
  }
299
319
  },
300
320
  "required": [
301
- "draftId",
302
- "approvalToken",
303
- "payloadSha256"
321
+ "draftId"
304
322
  ],
305
323
  "additionalProperties": false
306
324
  }
@@ -318,4 +336,4 @@
318
336
  "auth": null
319
337
  }
320
338
  }
321
- }
339
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.3.0",
3
+ "version": "0.4.2",
4
4
  "description": "VOD 用户声音采集插件——MCP server + 技能 + 声明式护栏,把 agent 产品的用户反馈安全送进 VOD 平台",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -22,6 +22,7 @@
22
22
  "vod_mcp/tools.py",
23
23
  "vod_mcp/packs.py",
24
24
  "vod_mcp/policy.py",
25
+ "vod_mcp/pending.py",
25
26
  "vod_mcp/provenance.py",
26
27
  "vod_mcp/runtime.example.json",
27
28
  "vod_mcp/__init__.py",
@@ -29,6 +30,7 @@
29
30
  "vod_mcp/tools.py",
30
31
  "vod_mcp/packs.py",
31
32
  "vod_mcp/policy.py",
33
+ "vod_mcp/pending.py",
32
34
  "vod_mcp/provenance.py",
33
35
  "vod_mcp/runtime.example.json",
34
36
  "plugins/vod-devkit/.codex-plugin/plugin.json",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vod-devkit",
3
- "version": "0.3.0",
3
+ "version": "0.4.2",
4
4
  "description": "VOD user-feedback collection: structured voice capture and submission to the VOD hoarding endpoint.",
5
5
  "keywords": [
6
6
  "feedback",
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.3.0",
3
- "commitSha": "370ee37cb4cd5bc2284cb0cd7874ec02644fb859",
4
- "builtAt": "2026-11-08T20:32:08",
2
+ "version": "0.4.2",
3
+ "commitSha": "cb79134b5b7590696c91dac7490e369a83f7b51f",
4
+ "builtAt": "2026-11-10T00:44:40",
5
5
  "sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
6
6
  }
@@ -112,6 +112,10 @@ version: 1
112
112
  符合诚实回退。**
113
113
  4. 引擎侧承载已就绪(t_vod_voice_inbox.repro_steps/expected_behavior,
114
114
  issue 渲染带「用户追问补充」来源注记)——本话术非空头承诺(S51 自审过)。
115
+ 5. 追问环节状态随行上送(followupStatus,引擎指标字段、issue 不渲染):
116
+ not_asked=未触发追问(已有实质回应/泛化未触发);declined=问了未答
117
+ 或答"没有/不方便";answered=已答并随两字段上送。三态白名单,
118
+ 不确定就不带键(引擎降 NULL)。
115
119
 
116
120
  **反截断红线(2026-11-08 opencode 实锤)**:用户在引导补充后给出的
117
121
  补充句是**完整提交物**,content=该句逐字全量上送,禁止摘取其中片段
@@ -154,8 +158,14 @@ version: 1
154
158
  3. 调用 vod_draft_voices 暂存草稿(必须用户已初步同意)→ 把返回的
155
159
  contents 逐条**原样**展示给用户核对(禁止改写概括)→ 明确问
156
160
  「确认提交吗」→ 用户明确同意后才调 vod_commit_voices(draftId/
157
- approvalToken/payloadSha256 原样透传)。单发工具 vod_submit_voices
161
+ approvalToken/payloadSha256 原样透传;断回合场景 token/sha 可省略,
162
+ 插件从本地草稿恢复)。单发工具 vod_submit_voices
158
163
  仅限无两段式工具的宿主使用。**一次一批**,攒多条一起交也行,但每批都要用户点头
164
+ **用户确认后必须当回合 commit(D-resume-commit-1 话术锁,禁自由裁量)**:
165
+ 用户说了"提交/确认/提吧"之后,本回合必须调 vod_commit_voices 收口——
166
+ 调用失败或草稿过期就重开草稿再 commit;任何原因提交不成,必须明确
167
+ 告诉用户"还没有提交成功",禁止只回一句"好的"就结束(实锤:agent
168
+ draft 后收工,用户说了两次"提交"仍无下文,反馈 40 分钟没进引擎)
159
169
  **一次抱怨=一条声音(2026-11-06 实锤红线)**:用户一次表述只提交一条,
160
170
  content=原话逐字——禁止拆成多条、禁止生成多个改写变体(实锤:一次
161
171
  "网页卡回复慢"被宿主改写成「网页打开,…」+「网页卡,…」两条入库建出
@@ -164,6 +174,23 @@ version: 1
164
174
  4. 拿到回执 → 对用户说人话:"已收录,产品团队会看到这条反馈"——
165
175
  **voiceId 不展示给终端用户**(编号噪音),仅供 agent 对账用;
166
176
  用户追问"提交了吗"时 agent 用 voiceId/taskId 核对后回答状态
177
+ 5. **无通道 fallback(D-pending-1,插件未安装/无 vod 工具时)**:
178
+ - 落盘:把反馈追加写入 `~/.vod-devkit/pending-feedback.jsonl`(JSONL 一行
179
+ 一条,字段 idempotencyKey=sha1(content+confirmAt+source)/content/tags/
180
+ confirmAt/createdAt=当前时间/source=宿主名/echoShown/status="pending"/
181
+ originalLines=用户原话逐行数组(多轮/多行原话必填——flush 以它拼接为
182
+ 权威 content,机械剥除模型拼接时新增的标点连接词,S73 改字技术锁;
183
+ 模型自拟 content 仅供比对))。
184
+ **条目级幂等键,内容级去重归引擎**(同内容重提=skipped),禁止用本键
185
+ 判"用户重复反馈"。
186
+ - echo 前移(两场景诚实区分):能拿到用户输入原文 → 落盘前与 content
187
+ 比对,不一致以原文为准;拿不到 → 先向用户逐字回显将暂存的内容再落盘、
188
+ echoShown=true——这是概率性防线非确定性闸,不假装解决保真。
189
+ - 对用户只说人话:"反馈已暂存(内容:……)。当前环境暂不支持直接提交,
190
+ 恢复后会自动补交。" **禁止出现文件路径/profile/工具名/幂等键**(内部
191
+ 细节进日志不进用户提示;路径属 CWE-209 敏感信息)。
192
+ - 补交:插件恢复后任一次 vod_submit_voices 成功会自动 flush pending
193
+ (引擎幂等防重,用户无需操作);超 30 天未补交的条目会被标记过期。
167
194
 
168
195
  ## 纪律
169
196
 
@@ -200,3 +227,13 @@ version: 1
200
227
  - 渠道/来源一律不提交、不向用户提及(引擎按链路固定赋值)
201
228
  - 提单/工单类诉求:不需要"复现步骤/严重程度/优先级"等开发者工单字段——
202
229
  用户原话即完整提交物,缺什么由运营侧补充
230
+
231
+ ## 教训(D-pending-1 落地过程实锤)
232
+
233
+ - **skill 留白即兴实锤**:无通道场景旧版 skill 未规定任何格式,agent 即兴
234
+ 发明 JSON「暂存记录」输出到对话(工具名/枚举外露+伪落盘=有记录的丢失)。
235
+ 定律再次验证:凡留白处模型必自由裁量——fallback/异常路径必须在 skill 里
236
+ 格式定死,能格式锁的绝不交给话术。
237
+ - **拼接改字第 N 次实锤与机械锁**:模型把两行无标点原话拼成「差劲。使用
238
+ …不流畅。」(S73 判定例在仍违)——originalLines 字段+flush 权威拼接=
239
+ 确定性剥除,规则层锁不死的行为下沉技术层。
@@ -5,7 +5,7 @@
5
5
  2. 外部无 DB 直连路径(护栏 deny 兜底)
6
6
  3. 任务 ID 是唯一对账主键,写类工具返回一律携带
7
7
  """
8
- __version__ = "0.3.0"
8
+ __version__ = "0.4.2"
9
9
  # 默认上游:VOD 测试环境。外部用户本机无 VOD,回环默认值=装完即坏;
10
10
  # 生产地址定型后只改这一处(tools.py 与 bin/vod-devkit 共用本常量)。
11
11
  DEFAULT_JAVA_BASE = "https://vod-dev.topxtopx.com"
@@ -0,0 +1,139 @@
1
+ #!/usr/bin/env python3
2
+ """D-pending-1 无通道场景 pending 反馈队列(2026-11-09,方案 A 四条执行细节定稿)。
3
+
4
+ 背景:宿主 VOD 插件未安装时,vod-feedback-collect skill 兜底把「用户已确认
5
+ 意愿的反馈」落盘为 pending,等插件/通道恢复后由 submit_voices 顺手 flush。
6
+ 此前「暂存」只存在于会话输出(全盘 grep 零落盘实锤),会话结束=有记录的丢失。
7
+
8
+ 四条定稿口径:
9
+ 1. 幂等键 = sha1(content + confirmAt + source):**条目级去重**(同一条 flush
10
+ 两次可识别);**内容级去重由引擎 uk_voice_id 负责**(voiceId=f(source,
11
+ content,nonce),同内容重提=skipped)——两 层分工,禁止混用。
12
+ 2. flush 清理 = 重写 + 原子 rename(tmp+os.replace):文件里永远只有真正
13
+ 待提交的条目;失败的条目保留 status=pending,不因尝试过就标已处理。
14
+ flush 同步执行但失败只记日志、不回滚主提交(文件个位数行,毫秒级;
15
+ 异步留作扩展点,当前规模不值得引入并发写竞态)。
16
+ 3. echo 两场景(skill 层口径,本模块只承载 echoShown 标记):能拿到用户
17
+ 输入原文 → 落盘前比对不一致以原文为准;拿不到 → echoShown=true,
18
+ 承认是概率性防线非确定性闸非安全边界。
19
+ 4. 生命周期:createdAt 超过 EXPIRE_DAYS(30) 的条目 flush 时标记 expired
20
+ 并从文件剔除(不搞定时任务);单次 flush 上限 CAP=100 条(按 createdAt
21
+ 最早优先),文件过大是已知扩展点。
22
+
23
+ 双通道消息分离:用户侧只见「已暂存,恢复后自动补交」,路径/profile/
24
+ 幂等键/flush 结果全部只进日志。
25
+ """
26
+ import datetime
27
+ import hashlib
28
+ import json
29
+ import os
30
+ from pathlib import Path
31
+ from typing import Any
32
+
33
+ PENDING_DIRNAME = ".vod-devkit"
34
+ PENDING_FILENAME = "pending-feedback.jsonl"
35
+ CAP = 100
36
+ EXPIRE_DAYS = 30
37
+ STATUS_PENDING = "pending"
38
+ STATUS_DONE = "done"
39
+ STATUS_EXPIRED = "expired"
40
+
41
+
42
+ def default_path() -> Path:
43
+ return Path(os.path.expanduser("~")) / PENDING_DIRNAME / PENDING_FILENAME
44
+
45
+
46
+ def entry_key(content: str, confirm_at: str, source: str) -> str:
47
+ """条目级幂等键(内容级去重由引擎 uk_voice_id 负责,见模块 docstring)。"""
48
+ return hashlib.sha1(
49
+ (str(content) + "\x00" + str(confirm_at) + "\x00" + str(source)).encode("utf-8")
50
+ ).hexdigest()
51
+
52
+
53
+ def make_entry(content: str, tags: list | None, confirm_at: str, source: str,
54
+ echo_shown: bool = False, original_lines: list | None = None) -> dict:
55
+ now = datetime.datetime.now().isoformat(timespec="seconds")
56
+ return {
57
+ "idempotencyKey": entry_key(content, confirm_at, source),
58
+ "content": str(content),
59
+ "tags": list(tags or []),
60
+ "confirmAt": str(confirm_at),
61
+ "createdAt": now,
62
+ "source": str(source),
63
+ "echoShown": bool(echo_shown),
64
+ "status": STATUS_PENDING,
65
+ **({"originalLines": [str(x) for x in original_lines]}
66
+ if original_lines else {}),
67
+ }
68
+
69
+
70
+ def canonical_content(entry: dict) -> str:
71
+ """权威 content:带 originalLines 的条目以分行原文 `\n` 拼接为真源
72
+ (S73 判定例的技术锁——模型拼接时新增的标点/连接词在此被机械剥除,
73
+ 实锤:模型把两行无标点原话拼成「差劲。使用…不流畅。」)。无
74
+ originalLines 的条目回落 entry 自身 content(行为不变)。"""
75
+ lines = entry.get("originalLines")
76
+ if isinstance(lines, list) and lines:
77
+ return "\n".join(str(x) for x in lines)
78
+ return str(entry.get("content", ""))
79
+
80
+
81
+ def load_entries(path: Path) -> list[dict]:
82
+ """读全量(坏行容忍跳过——手工写入/中断不炸 flush)。"""
83
+ if not path.exists():
84
+ return []
85
+ out = []
86
+ for line in path.read_text(encoding="utf-8").splitlines():
87
+ line = line.strip()
88
+ if not line:
89
+ continue
90
+ try:
91
+ obj = json.loads(line)
92
+ if isinstance(obj, dict):
93
+ out.append(obj)
94
+ except (ValueError, TypeError):
95
+ continue
96
+ return out
97
+
98
+
99
+ def append_entry(path: Path, entry: dict) -> None:
100
+ """追加一行(原子性由「单行一次 write+flush」保证;坏行由 load 容忍)。"""
101
+ path.parent.mkdir(parents=True, exist_ok=True)
102
+ with open(path, "a", encoding="utf-8") as f:
103
+ f.write(json.dumps(entry, ensure_ascii=False) + "\n")
104
+ f.flush()
105
+ os.fsync(f.fileno())
106
+
107
+
108
+ def save_entries(path: Path, entries: list[dict]) -> None:
109
+ """重写 + 原子 rename(D-pending-1 口径 2:tmp + os.replace)。"""
110
+ path.parent.mkdir(parents=True, exist_ok=True)
111
+ tmp = path.with_suffix(path.suffix + ".tmp")
112
+ with open(tmp, "w", encoding="utf-8") as f:
113
+ for e in entries:
114
+ f.write(json.dumps(e, ensure_ascii=False) + "\n")
115
+ f.flush()
116
+ os.fsync(f.fileno())
117
+ os.replace(tmp, path)
118
+
119
+
120
+ def plan_flush(entries: list[dict], now: datetime.datetime | None = None,
121
+ cap: int = CAP, expire_days: int = EXPIRE_DAYS) -> dict[str, Any]:
122
+ """flush 计划(纯函数):to_flush(pending、未过期、最早优先、上限 cap)、
123
+ expired(超期条目,调用方剔除+告知)、kept(留在文件里的其余条目)。"""
124
+ now = now or datetime.datetime.now()
125
+ deadline = now - datetime.timedelta(days=expire_days)
126
+ pending, expired = [], []
127
+ for e in entries:
128
+ created = str(e.get("createdAt", ""))[:19]
129
+ try:
130
+ created_dt = datetime.datetime.fromisoformat(created)
131
+ except ValueError:
132
+ created_dt = now # 无 createdAt 的手工行不误杀
133
+ if e.get("status") == STATUS_PENDING and created_dt < deadline:
134
+ expired.append(e)
135
+ elif e.get("status") == STATUS_PENDING:
136
+ pending.append(e)
137
+ pending.sort(key=lambda e: str(e.get("createdAt", "")) or "9999-12-31T23:59:59")
138
+ return {"to_flush": pending[:cap], "expired": expired,
139
+ "kept": [e for e in pending[cap:]]}
@@ -23,7 +23,7 @@ def _resolve_ref(policy: dict, value):
23
23
  return value
24
24
 
25
25
 
26
- def _match_tool_rule(rule: dict, tool: str, params: dict) -> bool:
26
+ def _match_tool_rule(policy: dict, rule: dict, tool: str, params: dict) -> bool:
27
27
  m = rule["match"]
28
28
  if m.get("tool") != tool:
29
29
  return False
@@ -36,7 +36,7 @@ def _match_tool_rule(rule: dict, tool: str, params: dict) -> bool:
36
36
  if "equals" in m:
37
37
  return actual == m["equals"]
38
38
  if "gt" in m:
39
- limit = _resolve_ref(load_policy(), m["gt"])
39
+ limit = _resolve_ref(policy, m["gt"])
40
40
  try:
41
41
  if isinstance(actual, list):
42
42
  return len(actual) > int(limit)
@@ -44,7 +44,7 @@ def _match_tool_rule(rule: dict, tool: str, params: dict) -> bool:
44
44
  except (TypeError, ValueError):
45
45
  return False
46
46
  if "notIn" in m:
47
- whitelist = _resolve_ref(load_policy(), m["notIn"])
47
+ whitelist = _resolve_ref(policy, m["notIn"])
48
48
  if not isinstance(whitelist, (list, tuple)):
49
49
  return False
50
50
  return actual not in whitelist
@@ -56,7 +56,7 @@ def check_tool_call(policy: dict, tool: str, params: dict) -> list:
56
56
  hits = []
57
57
  for rule in policy.get("rules", []):
58
58
  if "tool" in rule.get("match", {}):
59
- if _match_tool_rule(rule, tool, params):
59
+ if _match_tool_rule(policy, rule, tool, params):
60
60
  hits.append(rule)
61
61
  return hits
62
62