Files
mini-openclaw-v2/docs/v2/23-completion-spec.md
T

28 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 最终收尾规格与验收
日期2026-10-01,用户授权继续完成一期项目。以 fa4163b 为代码恢复点;沿用21号规格与批准的深色导航/浅色工作区,不重建业务平台。
术语:可用模型指受信地址和名称已配置;连接通过仅证明无业务资料的请求成功。反馈统计比较冻结预审和实际会议,不能当作已校准概率。真实效果仍须独立后续数据。
BR-68:管理员可读取脱敏模型状态,保存本机受信模型设置,发起不含业务材料的连接检查。设置供既有预审和经验提炼共同使用;环境配置优先且不可由页面覆盖。密钥不返回、不进审计、Git和错误内容。
BR-69:会议反馈仅使用本项目、预测完成早于会议、材料快照匹配的运行;更正后旧记录排除,多个当前结果歧义排除,暂缓/未送审/未映射不当否决。展示样本量、建议推进组实际通过占比、排除原因和分歧案例。
BR-70:配置管理员可完成改进审核发布入口,独立审核和不可变发布门禁不变。
BR-71:Skill文件路径按Windows大小写不敏感规则拒绝重复,原始文件不覆盖。
E-42 MODEL_SETTINGS_INVALID /「模型设置不合法,请使用受信地址和有效模型名称」;参数校验失败不改旧设置。
E-43 MODEL_ENV_LOCKED /「模型由环境配置管理,请联系部署管理员修改」;不覆盖环境。
E-44 MODEL_CONNECTION_FAILED /「连接未完成,请检查模型服务、名称和密钥」;不返回原始HTTP或密钥。
AC-78 Given管理员/经理与非法地址 When读写设置 Then仅管理员可写、密钥不返回、非法地址拒绝(BR68/E42)。
AC-79 Given本机文件配置或环境锁定 When保存和重读 Then持久可用或明确拒绝,所有模型调用复用同一设置(BR68/E43)。
AC-80 Given连接成功/失败 When探测 Then真实请求且无业务材料、失败脱敏(BR68/E44)。
AC-81 Given晚于会议预测、重复、更正、暂缓记录 When统计 Then只算合格唯一样本,并列排除原因,空分母返回null(BR69)。
AC-82 Given配置管理员与独立审核约束 When发布 Then入口可用且不能自批(BR70)。
AC-83 Given大小写冲突的文件路径 When导入 Then拒绝且无文件覆盖(BR71/E38)。
架构:新增model_settings模块只管理运行目录私有文件,assistant_model仍唯一模型执行入口;library API提供管理员设置/连接及项目反馈只读接口。反馈模块依赖冻结run与review_outcome,不写预测、不训练或发布。新面板嵌入既有历史经验和会议结果,不增加第四导航或Tool卡。
契约:GET/PUT library/model-settings,返回available/name/provider/key_configured/managed_by;PUT endpoint/name/api_key(null保留旧key,空字符串清除)。POST library/model-settings/probe返回ok/message;GET library/projects/{id}/feedback返回observed/excluded/advance_group/rows/probability_status。
UI:设置折叠面板,仅管理员可编辑;连接检查loading禁止重复提交,成功/失败消息独立;密码输入无回显,成功后清空。反馈面板empty/loading/error/ready、null占比显示待积累,详情保留run/outcome引用。视觉沿用v2-workbench现有token,文案组件内中文维护。规格、架构、详细设计、UI定案,无阻塞实施的未决项;真实模型服务和数据仍属外部验收。