OPC 桌面伙伴 Final v7.1.0（MiniCPM Pet 结构注入）

| 变更 | v7.0.1 | v7.1.0 | |------|--------|--------| | Agent-Script契约 | ❌ | ✅ 结构化输出块 [OPC_RESULT] | | 幂等性 | ❌ 重复生成 | ✅ sha256缓存,相同输入复用 | | 状态诊断 | ❌ 仅JSON | ✅ --status / --debug / --stop | | 借鉴来源 | — | MiniCPM Pet Skill [DEPLOY_RESULT] 模式 |

这是一个上下文联动版 OPC 桌面工作伙伴，定位不是"所有能力都自己生成最终成品"，而是一个诚实的桌面路由器与工作流中枢。

v7.1.0 新增: Agent-Script 契约

借鉴 MiniCPM Pet Skill 的 [DEPLOY_RESULT] 设计，每次执行输出 JSON + 结构化摘要块:

[OPC_RESULT]
version=7.1.0
route=sales
status=success_generated
mode=builtin_sales_alchemist
quality=draft
score=64
files=2
file_types=sales_report_md,sales_analysis_json
ollama_ok=True
model=qwen2.5:1.5b
warnings=none
[/OPC_RESULT]

Agent 调用者先解析这个块做快速判断，不用读完 JSON。

三级诊断

--status   # 快速状态: 运行次数/产物数/缓存数/最后路由
--debug    # 详细诊断: 环境/磁盘/Ollama/专业skill路径
--stop     # 清理: 删除所有幂等缓存

幂等缓存

相同输入+路由 → sha256哈希 → 写入 .idem_{route}_{hash}.json 再次相同输入 → 直接返回已有产物, mode=idempotent_cache --force 跳过缓存强制重新生成

核心能力

Reid 风格分诊:先判断任务属于内容、画布、生图、销售对话、邮件、日报、排程等哪一类。
内容/画布:优先检测并调用本地 opc-content-suite,调用失败时降级到内置 Markdown 初稿。
生图/视觉:检测 miaoyanshe-image-lab,生成平台化 image brief 与 prompt;不假装生成真实图片。
销售对话:内置"销售对话炼金师",输出 Reid 分诊、风险标签、销售评分、改进建议、下一轮问题、跟进话术。
自由适配器:销售分析核心函数支持 adapter(payload),可由不同 agent 注入 LLM、CRM、知识库评分、图片/PPT 生成器,不绑定 baidu-image-gen 或任何固定供应商。
文件交付:每次运行落地 Markdown / JSON / run-record。

状态口径

success_generated:已生成可编辑结构化草稿。
partial_success:流程跑通,但产物是 brief / prompt / 模板级,不是成品。
fallback_success:专业 skill 或模型不可用,已使用内置模板降级输出。
error:运行失败。
idempotent_cache:幂等命中（v7.1.0新增）。

示例

python scripts/main.py --scan
python scripts/main.py --status
python scripts/main.py "@销售 客户:太贵了,我们再考虑一下。 销售:我们效果很好,今天定吧。"
# 再调用一次 → 输出 [OPC_RESULT] mode=idempotent_cache
python scripts/main.py --force "@销售 客户:太贵了,我们再考虑一下。"  # 强制重新生成

注入的技能模式

| 来源 | 注入内容 | |------|---------| | opc-content-suite v2 | 诚实降级(placeholder→template), 重试逻辑 | | opc-commercial-architect | 多维度评估框架 | | reid-operating-system | 优化前/后对比, 版本一致性检查 | | skill-creator | invoke字段+circuit_breaker规范 | | MiniCPM Pet Skill | 结构化输出块+幂等性+三级诊断 |

本 skill 融合了此前 OPC 桌面伙伴 v6.5 的内容路由、生图 brief 路由，以及 Reid OS 的"分诊台 + 协议执行 + 结构化输出"思想，并将销售对话炼金师能力内置为可运行函数。v7.0.1 增加了模型自动检测+指数退避重试。v7.1.0 借鉴 MiniCPM Pet Skill 的 Agent-Script 契约设计，加入结构化输出块、幂等缓存和三级诊断。

timo