abelien-harness 0.7.0 → 0.7.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "abelien-harness",
3
- "version": "0.7.0",
3
+ "version": "0.7.1",
4
4
  "description": "npx-installable multi-agent skill harness: generic kernel + pluggable domain packs",
5
5
  "type": "module",
6
6
  "engines": {
@@ -28,7 +28,7 @@ compatibility:
28
28
  1. **核对对象与版本。** 明确是整机还是部位、当前作品/基线、固定区域、允许变化范围、用户要求和参考来源。过期图片或旧渲染不能覆盖新版。
29
29
  2. **建立外观目标。** 将整体轮廓、比例、分件、特征位置、颜色、材质、纹理、透明/发光表现整理成稳定目标;区分硬要求、偏好、观察事实、推断和未知。
30
30
  3. **提出编辑。** 输出改变前后、影响部位、所用参考及预期视图。纯 CMF 变化不假装结构改变;新增摄像头、开口或可动部位时通知 hardware/structure。
31
- 4. **按需生成视觉资产。** 无现成 CAD 的文字 Studio 目标是在需求足够后先出概念图,默认沿用原图绑定真实硬件并交 structure;缺图明确回生图阶段,用户明确重画才准备新图版本,不能把单图默认写成永久禁止再生成。已有符合需求的真实 CAD 时,概念图不应成为首次展示的硬性前置。概念探索可使用图像生成;需要图生网格时调用同级 `abelien-3dgen`。生成图或网格是外观候选,不是可制造 CAD,也不代表已经采用。
31
+ 4. **按需生成视觉资产。** 无现成 CAD 的文字 Studio 目标是在需求足够后先出概念图,默认沿用原图绑定真实硬件并交 structure;缺图、自然语言重试与重画统一按 workspace 的[图片请求规则](../abelien-workspace/references/user-journey.md#image-retry-intent)承接。已有符合需求的真实 CAD 时,概念图不应成为首次展示的硬性前置。概念探索可使用图像生成;需要图生网格时调用同级 `abelien-3dgen`。生成图或网格是外观候选,不是可制造 CAD,也不代表已经采用。
32
32
  5. **交给 structure 实现。** 提供形态目标、视图、比例基准、必须保留的特征和允许妥协范围。structure 返回空间/制造冲突、实际模型、相机信息和真实渲染。
33
33
  6. **实际视觉审查。** 读[视觉审查](references/visual-review.md),真正查看目标参考与本版实际渲染;分别记录 pass、conflict、unknown、not_checked。脚本通过或文字自述“很像”不能替代看图。
34
34
  7. **迭代或交回。** 可在授权范围内修正外观目标,受工程约束影响的方案回到 structure。只有影响用户目标或需要其取舍时进入 B2;完成后把同版提案、证据和视觉结论交回 workspace。
@@ -18,9 +18,9 @@ compatibility:
18
18
 
19
19
  1. **识别本轮操作。** 区分咨询、新创作、需求变更、答复、收尾/返回编辑、确认和工具结果。纯咨询先回答;需要细化需求语义、指代或混合意图时交 clarify,不在 guide 再实现一套提取规则。
20
20
  2. **取得当前上下文。** 按 workspace 的[领域模型](../abelien-workspace/references/domain-model.md)及[调用与恢复说明](../abelien-workspace/references/harness-binding.md)恢复作品、事件、任务和证据。已有运行先恢复,读取失败交回具体缺口。
21
- 3. **按需调用 clarify。** 新增、修改、撤回需求或影响需求的答复需要整理时,读取其入口,提供同版原话、当前完整需求、本次操作、相关方案、授权与会话约束;答卡附原题和真实答复事件。纯确认或仅工具回传不机械重跑 clarify。
21
+ 3. **按需调用 clarify。** 新增、修改、撤回需求或影响需求的答复需要整理时,读取其入口,提供同版原话、当前完整需求、本次操作、相关方案、授权与会话约束;答卡附原题和真实答复事件;工具结果中的用户原文仍按 user 来源处理,只采明确子集,不用生成的聊天 message 冒充回答事件。纯确认或仅工具回传不机械重跑 clarify。
22
22
  4. **承接需求建议。** clarify 返回 `result / questions / note`;按其契约复核语义与结构,再按 workspace 的采用规则交给实际服务。没有 result 时沿用当前需求。需求变更按 workspace 的 [PRD 契约](../abelien-workspace/references/prd-contract.md)在本轮登记/修改/撤回条目并回读,不等最终确认;只调度该契约,不在 guide 复制模板或登记逻辑。必要问题结合当前上下文呈现,不把问题提出或用户回答当作方案已修改。
23
- 5. **选择下一步。** 依据 workspace 的[完整旅程](../abelien-workspace/references/user-journey.md)核对推进条件,按其能力绑定选择领域 skill、workflow 或产品服务。目标旅程先复用符合需求的真实 CAD;没有现成 CAD 时依宿主阶段生成概念图并自动选型、绑定原图、构建 CAD/审查;实际安装版本不支持时报告能力缺口,不调用未注册工具。必要问题发持久卡并承接原任务。可选交互邀请遵守宿主实际展示门(核对实际版本的 3D 加载与适用审查),不得因需求足够就抢先覆盖必要问题卡;按旅程 §4.1 的通用目标告知随时可收尾,不插入需求版 PRD 展示关卡。点击“随时收尾”后按 §4.2 调用宿主成果体验模式,核对仿真或 Three.js 行为演示能力,并保留 PRD 查看/导出入口。调用前读对应 skill;能力不存在时报告具体缺口。实际能力返回后回到当前事实重判,不自行选择型号、算法或编造工程结论。
23
+ 5. **选择下一步。** 依据 workspace 的[完整旅程](../abelien-workspace/references/user-journey.md)核对推进条件,按其能力绑定选择领域 skill、workflow 或产品服务。目标旅程先复用符合需求的真实 CAD;没有现成 CAD 时依宿主阶段生成概念图并自动选型、绑定原图、构建 CAD/审查;实际安装版本不支持时报告能力缺口,不调用未注册工具。必要问题只调用宿主已注册的 `publish_agent_card(kind=question)`,持久绑定原模型调用后结束执行,用户独立提交后以原调用的工具结果承接原任务;不等待 HTTP/Worker、不先把 card_id 返回为最终答案、不继续执行依赖答案的工具批次。可选交互邀请遵守宿主实际展示门(核对实际版本的 3D 加载与适用审查),不得因需求足够就抢先覆盖必要问题卡;按旅程 §4.1 的通用目标告知随时可收尾,不插入需求版 PRD 展示关卡。点击“随时收尾”后按 §4.2 调用宿主成果体验模式,核对仿真或 Three.js 行为演示能力,并保留 PRD 查看/导出入口。调用前读对应 skill;能力不存在时报告具体缺口。实际能力返回后回到当前事实重判,不自行选择型号、算法或编造工程结论。
24
24
  6. **向用户交代结果。** 根据真实产物说明本次变化、当前缺口和下一步,区分 PRD 已登记的需求与仍待实现/检查的方案;没有写入回执就明确尚未保存。首版展示、必要取舍及确认邀请的时机均采用 workspace 规则;表达方式采用共用表达规则。
25
25
 
26
26
  图片、链接或“做同款”仍走同一入口,不自动开启另一条整机还原流程。入口按本轮意图调度:还原现成产品(restore)、创造新产品(create)或基于现成产品修改(modify)共用同一旅程,差别只在首先展示什么、参考资料怎么用、哪些特征锁定,依据是原话而不是输入形式,详见[意图路由](../../docs/architecture/intent-routing.md)。还原与改现成先识别产品,展示原产品图及来源后继续;新创先参考相似产品再出概念图,用户已有明确设计图时直接沿用。意图、目标深度与识别结果在首版之前不单独发问:按推断继续,作为系统假设展示并可随时修改;型号识别冲突时保留候选,用户切换即视为需求修订。改轮廓、颜色、材质、表面语言或参考匹配时调用 [appearance](../abelien-appearance/SKILL.md);空间约束、布局、装配、Build123d 或几何检查调用 [structure](../abelien-structure/SKILL.md)。外壳形状同时涉及两者时,由 appearance 定义目标、structure 实现并回传实际渲染、appearance 做视觉验收。只把必须由用户决定的差异交回用户,不让内部视觉审查成为额外的必答关卡。
@@ -39,6 +39,8 @@ compatibility:
39
39
 
40
40
  当前输入、证据与授权仍支持下一步时继续推进。需要用户决定、等待真实任务、缺必要能力或已达到本轮交接条件时,交代结果与下一步并结束本轮;无新依据时不重复请求。
41
41
 
42
+ 原生答卡按[问题工具接续契约](../../docs/architecture/question-card.md)消费:选项 ID 和自由原文走原 toolCallId 的 tool 结果,不能包装成新 User 消息。旧卡缺可信原调用时只走明确旧协议或说明缺口;不伪造调用,不把答卡、暂停追问或物理接续 run 当作品确认。可选交互邀请沿用非阻塞接口,不使用必要问题的等待机制。
43
+
42
44
  workflow 的恢复、advance、cancel 及确认后的交接均按 workspace 的运行约定执行。guide 只消费真实回执,不把工具成功、需求建议或自己的总结当成作品已采用、已确认或已交付。
43
45
 
44
46
  用户看到的是方案、变化、问题和产物;内部阶段编号、HTTL、cursor 与资源 ID 留在工作上下文。
@@ -36,6 +36,7 @@ node <skills目录>/abelien-harness/scripts/ab.mjs --workdir <作品工作目录
36
36
 
37
37
  - 阶段、采用、版本及确认条件以本包规则为准。clarify 的结构校验和领域阶段成功不替代作品确认条件。
38
38
  - 当前引擎是顺序 workflow v1,不解释 `journey` 分支,也不校验 `input.optional`、`replySchema` 或 B3。业务规则由 Agent 按真实证据执行;产品服务仍须提供实际写入与验证契约。
39
+ - 必要问题的工具等待与回答结果见[卡片调用契约](../../docs/architecture/question-card.md):宿主持久原调用后结束执行,独立答卡请求接上原 tool 结果,不构造 User 答案;真实用户原文仍保留 user 来源。
39
40
  - 普通进度、必要问题和等待任务保持 `awaiting_agent`。只有达到本包交接条件才 advance;具体修改按作品规则回流。
40
41
  - 收尾/返回编辑是同一作品的展示模式切换;成果体验中的 machine states 只驱动行为演示,不替代 A1–C、workflow 状态或确认条件。
41
42
  - 初始 input 只是启动快照。后续需求、采用方案、版本、决定与任务从宿主/产品回读,缺接口就说明缺口。
@@ -67,7 +67,7 @@ stdout 的 `ok:true` 表示命令取得了回执。workflow 调用还必须检
67
67
  | 仿真/Three.js 状态动作 | 宿主须回报同版可用仿真环境或动作播放器;AI 可根据需求和模型能力提出状态/动作编排,由实际播放器校验并执行。当前未注册播放器或仿真 capability;状态定义文本、3D 文件和视频都不能代替可玩的实际响应,也不使用内核 machine 状态冒充演示 |
68
68
  | 当前组合检查 | 通用CLI未注册match_solution;Web product_check覆盖七族并保留明确未知/阻塞。硬件/算法verified不能代替完整组合的实物验证 |
69
69
  | 可选交互邀请卡片 | 按旅程 §4.1 呈现继续细化/先收尾两个选项;宿主须支持非阻塞操作选择,不能直接套用必要 question 的 pending 门禁或完成 handoff 前提。尚未绑定时不声称已弹卡,不虚构 kind/action key |
70
- | 产品卡片发布与跳转 | 目标分层与前端 wire 见 [Agent Card 协议](../../../docs/architecture/question-card.md):clarify/ACL 都不是工具,唯一的 `publish_agent_card` 发布 question 或 handoff;模型只给 action key,Runtime 解析站内 route/白名单 HTTPS 目标,前端须等用户点击。当前该工具尚未注册,可先在宿主询问或给普通链接,但不声称卡片持久化、版本绑定或受控跳转已实现 |
70
+ | 产品问题工具接续与引导 | 见 [Agent Card 协议](../../../docs/architecture/question-card.md):clarify/ACL 不是工具。宿主原生 `publish_agent_card(kind=question)` 持久等待,用户独立 HTTP 提交后以原调用的 tool 结果接续,不包装成 User 答案。2026-10-12 本地 Web v3 接线与 Harness/外部宿主分别核验;当前 Harness broker 尚未注册,handoff 不在本地注册表,不能据文档调用 `ab capability` 或声称受控导航已实现。只在真实完成且宿主已接导航时选择注册 action key,由用户点击 |
71
71
  | 逐轮 PRD 条目维护 | 通用CLI不内置产品写库;Web从已持久facts派生现行七块模板PRD/BOM、来源/假设/未知,不能可靠映射的实现保留同版附录。缺宿主时只交接待登记差异 |
72
72
  | 版本采用、确认及 PRD 导出 | Web product_adopt只接真实同版候选,确认仅用户版本绑定concept命令;租约事务保存私有不可变快照、授权JSON/Markdown导出,主旅程通过可信verifyCompletion核对回执。原生CLI缺宿主仍失败关闭;旧workspace.getPrd/confirmPlan不可替代 |
73
73
 
@@ -90,6 +90,8 @@ Studio 修改与首次创建均不设固定修复次数。沿用同一个 operat
90
90
 
91
91
  点击“随时收尾”由宿主切换成果体验并收起编辑面板,不提交 workflow 完成,也不取消作品。真实任务与确认条件独立保留;后续结果不自动恢复面板或追问。返回编辑、播放/重置演示、查看或导出草稿都不重启主入口、不升产品版本。
92
92
 
93
+ 必要答卡等待只属于宿主工具生命周期:保存原 assistant 调用及私有检查点后结束 HTTP/Worker,收到用户决定后以匹配的 tool 结果发起下一次模型请求。原任务/toolCallId 不随后继物理 run 改变;答卡与发卡都保持 Harness awaiting_agent,不提交 advance。完整 wire、幂等、部分回答、旧卡与安装边界见 Agent Card 协议 §5–§8。
94
+
93
95
  同版确认事件经 B3 复核、快照真实保存且真实交付状态已交代后,按 replySchema 提交一次交接。PRD/BOM/分享/视频分别注明已就绪、进行中、失败或未接入及依据;预订不是必经步骤。若产品已接 `publish_agent_card(handoff)`,可在完成回执后引导用户主动点击“去保存与预约”;未接时只给普通入口,不伪造卡片。页面打开不等于预约、订单或支付成功。内核不解析业务语义或完整 replySchema,但 `completionGuard:workspace.confirmed-snapshot` 必须由可信宿主 `verifyCompletion` 回读确认、当前版本、组合检查、快照与交付状态。未接或未通过时返回 `WORKFLOW_COMPLETION_REQUIRED`,保持 awaiting_agent;普通 resource.put 和模型自填引用不能代替回执。done 仍不代表制造或实物交付通过。C 后修改按真实产品新工作版继续,已 done 的 run 不再 advance。
94
96
 
95
97
  **迁移防误用:** 旧名 `user-journey` 的实例若仍含 25 步、review-views 或 review-plan,保留只读原始 status,不取新版 HTTL 或 advance。v1 重载同名最新定义,不冻结旧定义;不得手改 run 名或 cursor。此禁令**内核已强制**:advance 与 `status --httl` 比对实例记录的步序列与当前同名定义,不同构即报 `WORKFLOW_DRIFTED` 并拒绝(不落盘、不静默跳过未执行步骤);只读 `status`/`list` 不比对,原始状态仍取得到。`user-journey-mock` 定义已删除,其实例也只读原始 status;不重放旧 mock,不改历史文件。真实作品从产品服务回读后按新入口接续。
@@ -40,7 +40,7 @@ GATE 是独立第七块,不硬塞进三个编辑入口,也不新增“量产
40
40
  | 信息 | 维护规则 |
41
41
  | --- | --- |
42
42
  | 稳定身份 | 保留 clarify 的 reaction/limits ID;场景等无独立 ID 的字段按已有契约的稳定路径定位。PRD 行号不是需求身份,REQ 示例号不能替代真实需求 ID |
43
- | 原话与来源 | 保留真实事件引用、需求全文、user/system 来源及 hard/preference;系统假设不能升级成用户原话 |
43
+ | 原话与来源 | 保留真实事件引用、需求全文、user/system 来源及 hard/preference;原生答卡通过工具结果传入时,从受信用户回答事件取原题/明确答案/原文,仍为 user 来源,不靠新 User message 证明归属;系统假设不能升级成用户原话 |
44
44
  | 条目内容 | 明确谁在什么场景、前提、触发、响应、结束/重触发及相关异常;当前未知部分显式留空或待定,不补造 |
45
45
  | 验收/决策口径 | 已知指标、条件及依据随条目登记;未知数值不猜。需用户取舍的问题与仅需工程查证的缺口分开 |
46
46
  | 实现映射 | 关联一个或多个 HW/SPEC/FW/M/3D/GATE 行 ID、实际采用资产与实现依据;多对多,不强制一需求一器件 |
@@ -4,9 +4,9 @@
4
4
 
5
5
  产品首要目标是最快展示可信真实 CAD:优先从 OSS 复用整机、子装配和已选组件,只补建缺失部分;确认没有可用资产才考虑自行建模。无权限、网络失败、摘要失败和宿主不支持导入都不是“没有资产”。原生组件保持真实尺寸;包络、自建模型和真实源件分开标注。已有符合需求的真实 CAD 应尽早只读预览,审查、用户采用和交付独立把关。
6
6
 
7
- 无现成 CAD 的目标文字链为:保存需求 → concept 首图 → hardware 自动选型登记 → real_image 原图绑定 → CAD preview → review → 必要 repair/复检。real_image 是历史 key,不是再次生图;无可用图转入有生图工具的 concept,用户明确重画则建立新执行版本并保留旧产物。未知/在途调用只恢复原身份。硬件待确认项按草稿合同披露,不把整体 verified 作为首图前置。
7
+ 无现成 CAD 的目标文字链为:保存需求 → concept 首图 → hardware 自动选型登记 → real_image 原图绑定 → CAD preview → review → 必要 repair/复检。real_image 是历史 key,不是再次生图;无可用图转入有生图工具的 concept,重试与重画按[图片请求规则](#image-retry-intent)结合上下文处理。未知/在途调用只恢复原身份。硬件待确认项按草稿合同披露,不把整体 verified 作为首图前置。
8
8
 
9
- 提问时机(2026-10-12 裁定)。首版 CAD 之前默认不向用户提问:按原话和合理默认继续,按默认处理的事项登记为系统假设或待确认项,由宿主展示、用户可随时修改;首版之后,把仍按默认处理的事项合并成一张问题卡。唯一例外:用户提出的硬要求缺少取值、无法合理默认,且按默认继续会做出错误结果(例如“必须放进这个卡槽”却没给尺寸)时,可以在首版之前提问,至多一张卡,沿用问题卡上限(最多三题、每题最多三个选项)。问题卡持久保存;答复承接原任务、阶段和待执行动作。系统依据落盘结果继续,不在每段末尾询问是否开始下一段。模型不能在绑定阶段调用未注册的生图工具。普通咨询不触发执行。
9
+ 提问时机(2026-10-12 裁定)。首版 CAD 之前默认不向用户提问:按原话和合理默认继续,按默认处理的事项登记为系统假设或待确认项,由宿主展示、用户可随时修改;首版之后,把仍按默认处理的事项合并成一张问题卡。唯一例外:用户提出的硬要求缺少取值、无法合理默认,且按默认继续会做出错误结果(例如“必须放进这个卡槽”却没给尺寸)时,可以在首版之前提问,至多一张卡,沿用问题卡上限(最多三题、每题最多三个选项)。问题卡按持久问题工具调用保存;用户独立提交后以原工具调用的结果承接原任务、阶段和待执行动作,等待期间不保持 HTTP/Worker。系统依据落盘结果继续,不在每段末尾询问是否开始下一段。模型不能在绑定阶段调用未注册的生图工具。普通咨询不触发执行。
10
10
 
11
11
  Web 已提交基线 91fac59a 仍在 real_image 生图;原图绑定、CAD 原图像素输入及 review 后自动首显属于本地未交付修复。组件资产导入与“审查前自动首显”仍有接线缺口。以上目标不代表宿主已实现,实际准入始终按安装版本读取。具体实现与验证边界由 abelienwebapplication 的 docs/studio-user-journey.md 及实际宿主契约维护;已安装 release 不因源文档更新自动升级。下文 A1–C、通用领域反馈和体验目标按其范围适用,不能覆盖宿主当前受控工具。
12
12
 
@@ -15,6 +15,29 @@ Web 已提交基线 91fac59a 仍在 real_image 生图;原图绑定、CAD 原
15
15
 
16
16
  本文由 abelien-workspace 维护,是产品与宿主 Agent 共用的完整用户旅程及判定规则,作为唯一正文维护入口。guide 依据本文组织调用与对话;clarify 负责需求语义。职责与作品上下文见[领域模型](domain-model.md)。A1–C 用于解释用户所处的位置,不要求增加持久化阶段字段,也不代表对应功能已经上线。实际接入情况与旧 MVP 演示的边界集中在附录。
17
17
 
18
+ <a id="image-retry-intent"></a>
19
+
20
+ ### 图片重试、重画与重复调用(2026-10-12)
21
+
22
+ 由当前 Agent 结合用户原话、此前问答、待完成的图片任务和真实回执识别意图,不要求固定关键词或固定句式。问号不等于咨询:“可以再试一次吗?”在图片失败的上下文中可以是执行请求;“为什么失败?”通常是在询问原因。答复“确认”只在能承接此前具体图片请求时沿用该请求,不能因为一个肯定词就扩大授权。只有确实存在多个目标或相互冲突的意图时才澄清,不要求用户换成标准提示词。
23
+
24
+ “如果失败就再试”是条件性执行请求:实际条件成立且宿主状态允许时承接,区别于只讨论假设。需求未变化的重试复用已保存需求与目标,不为重试伪造需求版本;用户确实修改需求时才按 PRD 契约登记变化。
25
+
26
+ | 当前上下文与用户意图 | 承接动作 |
27
+ | --- | --- |
28
+ | 图片未成功,用户要求“再试一下”“继续弄” | 承接原图片任务,先读真实状态;宿主允许新的尝试时才执行重试 |
29
+ | 已有图片,用户要求改变外观或再画一张 | 按修改范围准备新图操作,保留旧产物与未修改内容 |
30
+ | 已有适用图片,用户要求继续选型、建模或后续流程 | 复用原图推进,不自行重画 |
31
+ | 咨询原因、费用、可行性,假设讨论或明确否定生成 | 回答或遵守否定,不提交新的图片操作 |
32
+
33
+ 默认复用已结算且适用的图片。没有新的用户请求或授权范围内确需图片修改的需求变化,不自行重画;不能仅因模型觉得效果不够好、未看到回显、等待太久或后续阶段需要图而另开生成。首图仍遵守现有旅程准入;这些规则不增加生图工具、变体数或宿主权限。
34
+
35
+ 一次用户提交及其触发的处理构成一个请求边界,不是整个会话。工具回执、自动接续、刷新和断线恢复仍承接原请求。请求可以包含用户要求的多步修改;不设每回合或整段会话的次数配额。后续用户再次要求修改或重画是新的请求,可以形成新操作,即使文字相同也不能仅凭文本去重。宿主分配并保存实际请求/操作身份;重复提交同一操作只恢复原结果,不能让模型改 ID 绕过幂等、阶段或预算限制。
36
+
37
+ 意图识别不替代执行准入。unknown、在途或未结算调用只用原 invocation/wait/operation 身份读取和恢复,禁止换身份重发;“再试一次”也不能解除此约束。确定失败时仍先核对计量是否已结算及宿主是否允许新尝试;已成功图片的新修改按宿主当前版本准备新执行。缺少恢复接口时说明缺口,不能把新调用冒充恢复。
38
+
39
+ 费用以真实供应商执行与可信计量为准,失败不代表免费。重复工具调用不应新增同一操作的供应商请求、预算预留或重复结算;合法的新生成仍可能产生费用。意图误判而创建了合法新操作也可能增加费用,预算限制只限制支出、不证明意图正确。宿主保留身份、幂等、来源/版本、状态、预算与结算保护;规则更新不修改计费,也不宣称已安装包自动升级。模型行为、实际供应商提交次数和账务去重由宿主分别验收,本文不是新的计费或状态机实现。
40
+
18
41
  ## 1. 用户最终得到什么
19
42
 
20
43
  用户带着一句硬件创意,或选中一个可二创的参考作品,进入同一套创作流程:明确必要需求,获得可修改的首版起点,通过外观、组件和互动的反复调整,随时收尾进入成果体验;需要继续时回到编辑,满足条件后可确认一份有来源、有版本、保留真实未知项的方案。
@@ -308,10 +331,12 @@ B2 解决的是用户取舍:意图有歧义、硬要求缺值或冲突、是
308
331
  - 必要澄清沿用 clarify 的输出契约:每题最多三个有区别、用户能感知后果的实质选项,始终允许自由输入;可以少于三个,或省略 options 只用自由输入,不为凑选项编造不存在的方案。“暂不决定”只在确实可以保留原状时提供。
309
332
  - 有适用图片配图,无图用文字。换机、换件、加功能的选择不主动夹带价格。
310
333
  - 当前已有待答卡时不叠发另一张;答复必须结合原题、上下文与适用版本消费。
311
- - 部分回答只解决对应事项;自由输入可能是新需求,不能强塞进旧选项。
334
+ - 部分回答只解决明确子集并消费整卡,其余问题由 guide/clarify 按新事实重判;自由输入可能是新需求,不能强塞进旧选项。原生 v3 选项与“其他”原文均作为原调用的 tool 结果,不另发包含答案的 User message;普通聊天仍是 User 消息。
312
335
  - 未答、超时、跳过、“怎么还没好”都不构成授权。“你定/直接做”只覆盖上下文中的具体决定。
313
336
  - 用户说“先别问了”后暂停追问,也不代替他作尚未授权的选择。
314
337
 
338
+ 问题工具接续、原调用证据、版本/归属校验、换版 superseded、暂停追问与旧卡兼容见[Agent Card 协议](../../../docs/architecture/question-card.md)。原文证据来自受信回答事件;工具通道不改变 user 来源。发布/答卡不 advance,不当 approval、生成授权或产品确认;可选邀请不使用必要问题等待机制。
339
+
315
340
  相关决定解决后回 B1 执行、采用、检查。回答本身不代表方案已经修改成功。当前未接卡片发布能力时,可在对话中询问,但不声称已经创建产品卡片或取得版本绑定回执。
316
341
 
317
342
  ## 8. B3:全部必要细化完成,第二次邀请确认
@@ -358,7 +358,7 @@
358
358
  "authority": "../references/user-journey.md",
359
359
  "priority": "最快展示可信真实 CAD;优先 OSS 整机、子装配和组件,仅补建缺失部分。图片、自建包络和来源 CAD 分别标注。",
360
360
  "assetFailure": "读取失败、无权限、摘要失败和不支持导入不是没有可用 CAD,恢复原引用或报告能力缺口。",
361
- "imageReuse": "默认复用已结算且适用的原图;缺图显式转入注册生图工具的阶段,用户明确要求重画时在旧调用结算后准备新执行版本。不是永久禁止生图。",
361
+ "imageReuse": "按 authority 的 #image-retry-intent 结合上下文识别重试/重画,不要求固定关键词;默认复用已结算且适用的原图,缺图转入注册生图工具的阶段。咨询、否定和后续推进不自行重画;新尝试仍须宿主状态、版本及预算准入,未知/在途/未结算只恢复原身份。后续用户新修改可形成新操作,同一操作重复调用复用结果,不设回合次数配额。",
362
362
  "recovery": "未知/在途调用只恢复原 invocation/wait,不因等待或缺回显重发。",
363
363
  "preview": "身份和完整性通过的真实 CAD 尽早只读预览;未审查明确标记,视觉/工程审查、显式采用与同版交付分别验收。",
364
364
  "hostBoundary": "产品目标不是能力声明;按实际注册工具、source-contract 和固定 release 执行。文档更新不自动替换宿主安装包。"