添加拼装动画状态
This commit is contained in:
@@ -326,6 +326,7 @@ interface UserView {
|
||||
```ts
|
||||
type RepoStatus = 'CREATING' | 'READY' | 'FAILED';
|
||||
type PublishStatus = 'UNPUBLISHED' | 'PUBLISHED' | 'BLOCKED';
|
||||
type AssemblyAnimationStatus = 'UNPROCESSED' | 'IN_PROGRESS' | 'COMPLETED';
|
||||
|
||||
interface ProjectInput {
|
||||
name: string;
|
||||
@@ -369,6 +370,7 @@ interface ProjectView {
|
||||
|
||||
interface ManagedProjectView {
|
||||
project: ProjectView;
|
||||
assemblyAnimationStatus: AssemblyAnimationStatus;
|
||||
moderationStatus: 'NORMAL' | 'BLOCKED';
|
||||
moderationReason: string | null;
|
||||
deleted: boolean;
|
||||
@@ -394,6 +396,7 @@ interface TypeView {
|
||||
| publishStatus | `UNPUBLISHED` 未发布;`PUBLISHED` 已发布;`BLOCKED` 管理员下架 |
|
||||
| publishedCommitSha | 社区当前已发布的文件版本,**不是工作区最新版本** |
|
||||
| moderationStatus / moderationReason | 后台治理状态及下架原因;BLOCKED 与 publishStatus=BLOCKED 对应 |
|
||||
| assemblyAnimationStatus | 拼装动画制作状态:`UNPROCESSED` 未处理(默认)、`IN_PROGRESS` 进行中、`COMPLETED` 已完成;位于 ManagedProjectView 顶层,仅管理端返回 |
|
||||
| sourceProjectCode / sourceCommitSha | 从社区内部 Fork 的来源;没有则为 null |
|
||||
| sourceRepositoryUrl / sourceLicense | 在线迁移项目的外部来源和许可证;没有或未取得则为 null |
|
||||
| urdfMainUrl / urdfBaseUrl | 已绑定的 URDF 主文件和资源基地址;未绑定则为 null |
|
||||
@@ -438,6 +441,7 @@ interface TypeView {
|
||||
| publishStatus | UNPUBLISHED / PUBLISHED / BLOCKED |
|
||||
| repoStatus | CREATING / READY / FAILED |
|
||||
| moderationStatus | NORMAL / BLOCKED |
|
||||
| assemblyAnimationStatus | UNPROCESSED / IN_PROGRESS / COMPLETED;省略时查询全部,非法值返回 400 |
|
||||
| sort | 可选:`CREATED_AT_DESC`(默认)、`PUBLISHED_AT_DESC`、`RESOURCES_FIRST`;其他值返回 400 |
|
||||
|
||||
结果只包含未删除项目。排序模式:
|
||||
@@ -489,11 +493,24 @@ interface TypeView {
|
||||
"updatedAt": "2026-10-20T02:30:00"
|
||||
},
|
||||
"moderationStatus": "NORMAL",
|
||||
"assemblyAnimationStatus": "UNPROCESSED",
|
||||
"moderationReason": null,
|
||||
"deleted": false
|
||||
}
|
||||
```
|
||||
|
||||
#### 拼装动画制作状态
|
||||
|
||||
`PUT /admin-api/projects/{projectCode}/assembly-animation-status` → `ManagedProjectView`。
|
||||
|
||||
```json
|
||||
{ "status": "IN_PROGRESS" }
|
||||
```
|
||||
|
||||
`status` 必填且仅接受 `UNPROCESSED`、`IN_PROGRESS`、`COMPLETED`,可以在三种状态之间自由切换。新建及历史项目默认未处理。此接口仅限管理员,按项目编码更新数据库状态及系统更新时间,返回可直接用于回显的完整管理详情;不存在或已删除项目返回 404。仓库未就绪时也可设置状态,不触发资源上传、绑定或发布。重复设置同一状态不更新系统时间;并发操作由项目锁串行处理,以最后一次成功写入为准。
|
||||
|
||||
前端在「装配与仿真」页的「刷新资源绑定」右侧显示状态下拉框,选择后自动保存,保存期间禁用重复操作,失败时保留原显示值并提示错误。项目列表显示同一字段,筛选携带 `assemblyAnimationStatus`;清空或重置时省略此参数,查询、分页和发布时间倒序沿用原有规则。
|
||||
|
||||
### 5.4 创建、编辑、删除
|
||||
|
||||
`POST /admin-api/projects` → `ProjectView`,body:
|
||||
|
||||
@@ -8,6 +8,18 @@
|
||||
|
||||
治理相关字段为 moderation_reason(管理员下架原因)和 repo_write_status(跨进程写入状态)。下架直接使用现有 publish_status=BLOCKED,不再增加独立治理状态。GitHub来源标识、地址、默认分支和许可证属于迁移任务,统一放在 project_import_task;第一版只支持GitHub,不存平台类型,也不额外区分用户创建与后台创建。
|
||||
|
||||
## 已有数据库增加拼装动画制作状态
|
||||
|
||||
升级社区端、管理端和导入工具前,已有数据库先手工执行以下 SQL;新建数据库的 `database.md` 已包含该字段,不要重复执行。已有项目和新建项目均默认为未处理,Fork 的新项目也独立从未处理开始。
|
||||
|
||||
```sql
|
||||
ALTER TABLE project
|
||||
ADD COLUMN assembly_animation_status VARCHAR(16) NOT NULL DEFAULT 'UNPROCESSED'
|
||||
COMMENT '拼装动画制作状态 UNPROCESSED未处理 IN_PROGRESS进行中 COMPLETED已完成';
|
||||
```
|
||||
|
||||
状态仅供后台制作进度管理,独立于仓库、资源绑定和发布状态;修改时只更新此字段及系统更新时间,不修改文件、资源绑定或发布信息。
|
||||
|
||||
## 已有数据库增加 STEP 单文件字段
|
||||
|
||||
已有数据库手工执行以下 SQL,再升级社区端、管理端和导入工具;新建数据库的 `database.md` 已包含这三个字段,不要重复执行。应用不自动迁库,不新增上传批次表。
|
||||
|
||||
@@ -0,0 +1,382 @@
|
||||
# CAD AI 独立 Python 后台重构实施方案
|
||||
|
||||
日期:2026-11-16。状态:本轮代码与模拟验收已完成,新 Python 后台、Rust/WASM v2 客户端及主站桥接均已创建。Python 280 项(含隔离 PostgreSQL/Redis)、主站 89 项、Rust Web 82 项及 UI 定向 4 项通过;完整 WASM、新网页包和真实浏览器 7 组跨端冒烟通过。未调用真实模型,尚未切换 8091 或部署生产。实际交付及未验收项以新工程 `docs/implementation.md` 为准。下面的任务清单保留为最初设计基准,不代表所有生产验收已经完成。首期不依赖私有 OSS,不支持关闭或刷新 CAD 页面后继续旧任务。
|
||||
|
||||
## 1. 已确认的决策与范围
|
||||
|
||||
- 新建独立的 CAD AI Python 后台项目,建议项目名 cad-ai-server,独立依赖、测试、镜像、配置和发布。
|
||||
- 使用官方 Deep Agents Python SDK。Deep Agents 底层运行于 LangGraph;一个 Agent 图负责推理和工具循环,不再增加第二套推理循环。
|
||||
- 使用 PostgreSQL 保存 Agent 检查点及 CAD AI 业务状态,Redis 用于通知、限流和临时协调。
|
||||
- 首期不要求私有 OSS,不建设 AI 文档恢复快照或通用附件上传服务。受限的大型工具文本/JSON 结果保存到 PostgreSQL 专用结果表,按权限、字段或页读取。
|
||||
- 复用当前网站账号和 CAD 项目权限,通过现有 Java HTTP 接口校验。新后台不读取或修改原站 MySQL、会话 Redis、登录实现或其他业务。
|
||||
- 首期不支持关闭、刷新页面或浏览器崩溃后继续旧任务。正常离开时尽力通知取消;异常离开通过执行端租约过期停止任务。重开后建立新执行端绑定,需要重新发起任务。
|
||||
- 保留同一页面、同一内存文档仍有效时的短暂断线重连、事件补发及有限模型重试,不把一次 SSE 断流直接视为用户取消。
|
||||
- 首期以单用户稳定性和小范围灰度为验收目标,不预先承诺特定并发量。
|
||||
- 保留新增知识库、流式输出、浏览器 CAD 执行器、权限门禁和文档保护;模型厂商及协议不静默改变。
|
||||
- 账号、项目、手动保存、社区 AI、CAD 内核均保留现有实现。旧 Java CAD AI 在灰度期保留,作为新会话的回退入口。
|
||||
- 不修改当前项目的 .sql 文件。新数据库 DDL 单独交付,字段及表使用中文注释;框架自带检查点表按固定依赖版本的官方迁移机制管理。
|
||||
|
||||
“独立”指代码、数据及部署独立;网站仍然是账号和项目权限的权威来源。原站鉴权不可用时,新后台应暂停需要授权的操作;页面绑定失效或超过等待期限后明确结束任务,不放行或伪报成功。
|
||||
|
||||
## 2. 当前代码基线与需要保留的能力
|
||||
|
||||
CAD 当前本地基线:solidcraft-main 的 ade571ebe,2026-11-16,已合并上游 0.43.0。Java 基线:community 的 6b96ca1,另有用户现存未提交知识生成记录,实施不得覆盖。
|
||||
|
||||
| 部位 | 当前实现 | 重构方式 |
|
||||
| --- | --- | --- |
|
||||
| Java CAD AI | CadAiService 处理一次模型推理,输出 SSE | v2 迁往新 Python 后台;Java v1 保留灰度回退 |
|
||||
| Rust/WASM | PlatformBackend 维护历史、模型请求重试、工具执行和任务循环 | v2 改成任务客户端;复用工具执行与文档保护 |
|
||||
| 主站 JavaScript | 账号、项目、agentChat/agentKnowledge 桥接、修订绑定 | 增加独立 AgentClient,连接新后台,复用原业务接口 |
|
||||
| 流式展示 | TextPreview 为尝试级草稿,完成后确认正式回答 | 保留预览与确认的分离,增加断线后事件补发 |
|
||||
| 文档保存 | createSnapshot、IndexedDB 草稿、SaveCoordinator | 保留原保存及草稿行为;首期不增加 AI 快照、快照上传或跨页面恢复 |
|
||||
| 工具 | 白名单、Schema、门禁、顺序执行、撤销分组 | Python 与浏览器双重校验;文档修改保持单写者 |
|
||||
| Skills | 随 CAD 源码更新,Java 资源包曾落后 | 建立单一来源、版本清单与发布校验 |
|
||||
| 知识库 | 阅读目录、按 document_id 读取 Markdown、版本和 SHA256 | 原样迁入 Python 资源,保留选择与 not_found 语义 |
|
||||
|
||||
当前 Skills 同步发现:原包 17 个,最新源 19 个,新增 makecad-layers 和 makecad-sheetmetal,14 个既有 SKILL.md 有变化。新方案的资源基线必须采用本次同步后的版本,不能沿用旧包。
|
||||
|
||||
主要源码位置:
|
||||
|
||||
- Java 推理服务:/Users/lk/Projects/vibemake相关项目/community/vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/CadAiService.java
|
||||
- Java 知识读取:/Users/lk/Projects/vibemake相关项目/community/vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/CadAiKnowledge.java
|
||||
- Java Skills:/Users/lk/Projects/vibemake相关项目/community/vibemake-service/src/main/resources/cad/ai/skills.json
|
||||
- 浏览器助手:/Users/lk/Projects/vibemake相关项目/solidcraft-main/apps/solidcraft-web/src/agent.rs
|
||||
- 助手公共事件:/Users/lk/Projects/vibemake相关项目/solidcraft-main/crates/ui-egui/src/agent_chat/backend.rs
|
||||
- 文档与快照桥接:/Users/lk/Projects/vibemake相关项目/solidcraft-main/apps/solidcraft-web/src/platform.rs
|
||||
- CAD 工具门禁:/Users/lk/Projects/vibemake相关项目/solidcraft-main/crates/ui-egui/src/agent_chat/gate.rs
|
||||
- 主站桥接:/Users/lk/Projects/vibemake相关项目/vibemake/js/cad/app.js
|
||||
- 主站请求:/Users/lk/Projects/vibemake相关项目/vibemake/js/cad/api.js
|
||||
- 本地草稿:/Users/lk/Projects/vibemake相关项目/vibemake/js/cad/drafts.js
|
||||
|
||||
## 3. 目标架构与职责
|
||||
|
||||
浏览器 CAD / Rust-WASM 助手面板
|
||||
→ 新 Python CAD AI HTTP API / SSE
|
||||
→ Deep Agents + LangGraph + Worker
|
||||
→ 模型厂商、PostgreSQL、Redis
|
||||
|
||||
浏览器继续通过原 Java API 登录、读取项目和手动保存。
|
||||
Python 只通过固定的原站接口验证当前用户和项目访问权。
|
||||
LangGraph 需要执行 CAD 工具时持久化调用意图,然后等待浏览器领取、执行和回传;Python 不直接执行几何,也不在服务器启动桌面 CAD。
|
||||
|
||||
建议技术组成:FastAPI、Pydantic、Deep Agents、LangGraph、官方 PostgreSQL checkpointer、psycopg 连接池、Redis 客户端、异步 HTTP 客户端、pytest。首期无需 OSS SDK 或对象存储部署。具体依赖版本在第一阶段联合验证后锁定,提交锁文件,不默认追随最新版本。
|
||||
|
||||
同一代码库提供 API 与 Worker 两种进程。首期可以单实例部署,但队列、检查点、文档租约和状态都要持久化,不能把生产任务只放在 FastAPI 的内存后台任务中。服务进程重启后,只有原页面和原文档仍有效、执行授权重新确认时才能继续;旧页面已经消失的任务不得自动恢复 CAD 操作。
|
||||
|
||||
服务端只有一套模型重试预算。浏览器 v2 只负责连接恢复和工具执行,不再自行重跑模型。
|
||||
|
||||
## 4. 新后台工作清单
|
||||
|
||||
### 4.1 工程、边界和契约
|
||||
|
||||
- [ ] 创建独立工程、锁定依赖、格式和类型检查、测试目录、容器及部署示例。
|
||||
- [ ] 定义 cad-agent-v2,对旧 cad-agent-v1 不做含义不明的字段复用。
|
||||
- [ ] 实现能力接口:支持的协议、工具集、CAD 构建、Skills/知识版本、模型能力、配额。
|
||||
- [ ] 复用已有工具 JSON Schema,建立与 CAD 源码可核对的版本清单,避免两份手工维护的 Schema。
|
||||
- [ ] 文档写操作单写者;模型即使一次返回多个工具,也按原始顺序逐个授权与执行。
|
||||
- [ ] 默认不加载通用 shell、任意真实文件系统、任意网络访问或能修改 CAD 的子 Agent。处理 Deep Agents 默认 execute 与 CAD execute 的命名冲突。
|
||||
|
||||
### 4.2 身份和项目权限适配
|
||||
|
||||
当前原站使用服务端保存的随机 Bearer Token,不是可让新后台自行验签的 JWT。
|
||||
|
||||
新后台通过原有接口校验:
|
||||
|
||||
- GET /api/users/me:取得可信 userCode,只使用所需身份字段,不保存邮箱等无关资料。
|
||||
- GET /api/cad/workspace/projects/{cadProjectCode}:校验该 Token 对项目的当前权限及项目是否有效。
|
||||
|
||||
- [ ] 浏览器从现有登录上下文向新后台发起请求;不额外要求用户登录一次。
|
||||
- [ ] 用户与项目只能从校验结果绑定,不能相信请求正文中的 userCode。
|
||||
- [ ] 原站 Token 不落数据库、检查点、模型上下文或日志,不传给模型厂商,不通过 URL 传递。
|
||||
- [ ] 新建/同页面继续任务、领取工具、提交回执、读取事件及大型工具结果都检查权限。
|
||||
- [ ] SSE 长连接期间周期性重新检查授权;心跳与短期执行租约控制离线和权限失效窗口。
|
||||
- [ ] 账号退出、封禁或权限丢失时停止新工具授权并结束当前执行绑定;原站校验暂时不可用时在等待期限内暂停,超期结束。已完成修改按现有保存机制处理。
|
||||
- [ ] 原站地址由服务端配置固定,禁止模型或客户端指定鉴权回调地址。
|
||||
|
||||
### 4.3 任务、持久化和调度
|
||||
|
||||
建议状态:queued、running、waiting_tool、waiting_user、retrying、reconnecting、paused_conflict、paused_budget、reconciling、completed、failed、cancelled。执行端丢失以明确的 executor_lost 原因结束,不能保留为跨页面可续跑状态。
|
||||
|
||||
- [ ] 区分 conversation/session、run/用户任务、model attempt、tool call 和事件编码。
|
||||
- [ ] 同一会话禁止并发提交两个修改任务;同一文档仅有一个有效写入者。
|
||||
- [ ] 用户消息通过 clientMessageCode 幂等提交,重复 HTTP 请求返回同一 runCode。
|
||||
- [ ] 接收成功前先持久化输入和待办记录,Worker 通过可恢复的工作记录领取任务。
|
||||
- [ ] Redis 仅提供唤醒、限流、缓存,不作为唯一队列或唯一任务状态。
|
||||
- [ ] Worker 使用租约和 fencing 代次,旧 Worker 不能继续提交;重新领取未完成任务后先确认原执行端仍有效,不能只凭检查点继续分发修改。
|
||||
- [ ] Graph thread 与账号、项目、会话及 pageInstanceCode 绑定;执行器、模型配置、Skills、知识和工具版本固定到任务。页面实例标识只保留在本页内存中,不从本地存储恢复旧执行权。
|
||||
- [ ] 等待浏览器或用户时使用持久暂停,不占用持续轮询的模型调用;暂停及继续仅在当前页面绑定有效时开放。
|
||||
- [ ] 记录待处理问题和用户答复,重复答复不得触发重复恢复。
|
||||
- [ ] 检查点推进、工具账本与事件日志之间设计对账流程;不假设框架写检查点会自动与业务表成为一个事务。
|
||||
|
||||
### 4.4 浏览器工具代理与防重复执行
|
||||
|
||||
每次工具调用至少绑定:runCode、toolCallCode、dispatchCode、工具顺序、参数哈希、文档绑定、beforeRevision、引擎/工具版本、执行租约代次。
|
||||
|
||||
安全执行顺序:
|
||||
|
||||
1. 模型本次输出完整结束,工具名及参数通过校验。
|
||||
2. 新后台持久化工具意图和顺序,生成可领取记录。
|
||||
3. 浏览器获得通知后,调用领取接口确认该操作仍未执行且租约有效。
|
||||
4. 浏览器再次检查账号、项目、当前文档、修订、权限门禁和参数 Schema。
|
||||
5. 执行前在当前页面内存记录待执行状态;文档修改串行进行。
|
||||
6. 执行完成后先在当前页面记录结果、前后修订和创建/修改/移除对象,再进行异步回传。首期不为每一步生成或上传文档快照。
|
||||
7. 网络恢复时重发同一工具回执,服务端确认收据。重发回执不得重新执行该工具;未确认收据时不得开始依赖它的下一次修改。
|
||||
8. 服务端按 toolCallCode 幂等接收;相同编码不同参数或结果属于冲突,不覆盖既有收据。
|
||||
9. Graph 从持久账本获取结果继续推理,已确认的工具不再执行。
|
||||
|
||||
浏览器内几何修改与服务端提交不是一个跨端事务,不能承诺数学意义的 exactly-once。同一页面仍存活但回执丢失时,先用页面内收据、服务端账本和前后修订对账;无法确认时暂停或结束,禁止盲目重放修改。页面崩溃或刷新后不恢复旧执行权,旧任务最终结束;新任务先读取当前文档再规划,不能自动重放旧待执行操作。
|
||||
|
||||
LangGraph 的 interrupt 恢复可能重新进入节点;所有外部副作用都要放在可幂等查询的账本边界后,不能只依赖“这个节点应该执行过”。
|
||||
|
||||
### 4.5 同页面断线、退出与撤销边界
|
||||
|
||||
- [ ] 为每个页面实例建立短期执行端绑定。页面仍存活且文档绑定不变时,允许在可配置宽限期内自动重连,初始建议 60 秒。
|
||||
- [ ] SSE 单次断开只触发传输恢复,不取消任务、不重发用户消息、不重跑已执行工具。事件订阅与执行端心跳分别判断。
|
||||
- [ ] 连接或授权过期期间停止签发新 CAD 操作;宽限期内对账通过后继续,超期以 executor_lost 等明确原因结束。
|
||||
- [ ] 正常关闭、刷新、退出账号或切换项目时尽力通知取消,同时立即废弃当前执行端的本地授权;不依赖浏览器退出回调保证通知必达。
|
||||
- [ ] 页面异常消失由执行端租约过期兜底。新页面生成新 pageInstanceCode,不能接管旧页面的未完成任务。
|
||||
- [ ] 不因 visibilitychange/document.hidden 单独判定页面退出;后台标签冻结或浏览器节流导致超时后可以安全结束,但不能让旧租约继续执行。
|
||||
- [ ] 正在运行的工具只能在其安全边界停止;取消不声称自动撤销已完成修改。迟到结果可用于记账,但不能把终态任务重新变成运行中。
|
||||
- [ ] 手动修改、引擎变化或多标签页冲突时停止新修改并要求校验;只有原页面及原绑定仍有效时才考虑继续。
|
||||
- [ ] 已完成的设计修改按现有手动保存和本地草稿机制处理,首期不新增 AI 自动保存承诺,不改变正式项目版本。
|
||||
- [ ] 保留当前页面内的撤销分组,不新增 AI 专用 IndexedDB 快照、不做跨页面任务恢复或跨页面撤销。
|
||||
|
||||
### 4.6 模型、错误分类与恢复预算
|
||||
|
||||
保留现有协议:OpenAI/豆包使用 Responses;DeepSeek 使用 Chat Completions。模型、endpoint、思考参数和输出上限显式迁移到新后台,禁止静默降级或切换。
|
||||
|
||||
- [ ] 每个供应商有独立 profile、能力声明、协议适配和模拟契约测试。
|
||||
- [ ] 验证自定义 endpoint、工具调用编码、推理状态续接、图片和 usage,不能假设所有 compatible 地址语义相同。
|
||||
- [ ] 模型配置由新后台的版本化配置和安全密钥注入管理;前端只提交允许的 profileCode,不接受任意 endpoint 和密钥。
|
||||
- [ ] 模型切换在安全轮次边界进行。跨厂商不直接重放不兼容的推理状态;首期默认新建会话或明确转换。
|
||||
- [ ] 输出未结束、参数分片不完整、JSON 损坏、重复调用编码时不得下发 CAD 操作。
|
||||
- [ ] 区分空输出、截断、拒绝、HTTP 错误、网络断流、参数错误、上下文超限、权限失效和任务预算耗尽。
|
||||
- [ ] 短暂网络/429/部分 5xx 做有限退避,遵守 Retry-After;401、权限、余额、配置错误不能反复重试。
|
||||
- [ ] 上下文超限先触发受控压缩或减量,再尝试;不重复发送同一超限请求。
|
||||
- [ ] 协议/参数错误允许有限纠错。模型正常返回的工具执行错误交回模型,允许调整参数或方案。
|
||||
- [ ] 只有 runtime 维护模型重试预算;关闭或计入 SDK、HTTP、Graph 中其他自动重试,避免乘法放大。
|
||||
- [ ] 单次模型超时、整个任务预算、同页面重连宽限期分开,不用一个 300 秒请求截止时间杀掉整个持久任务;也不因保留检查点而无限等待已退出的页面。
|
||||
- [ ] 推理次数、CAD 修改次数、总 token 和费用受限;可恢复的预算耗尽显示为暂停,继续入口仅对仍有效的原页面开放。
|
||||
|
||||
## 5. 上下文与 token 控制
|
||||
|
||||
上下文方案保留摘要、大结果按需读取与 CAD 任务记忆。首期结果外置使用 PostgreSQL 专用结果表,不依赖 OSS;必须配置模型窗口和大小/保留限额,不能只启用默认值。
|
||||
|
||||
| 层次 | 保存内容 | 用途 |
|
||||
| --- | --- | --- |
|
||||
| 完整会话记录 | 用户消息、确认回答、工具原文/结果句柄、事件 | UI、审计、排错、回看 |
|
||||
| 模型有效上下文 | 当前目标、任务记忆、最近步骤和按需读取的参考 | 控制每次输入大小 |
|
||||
| 结构化任务状态 | 用户约束、单位、参数、关键对象、未完成项、文档版本、最近验证 | 同页面任务续接与摘要后防止丢失关键事实 |
|
||||
|
||||
- [ ] 每次模型请求前执行 token 预算检查,而不是只在新用户轮次按消息条数裁剪。
|
||||
- [ ] 为模型 profile 配置窗口、输出/推理预留和安全余量;未知模型不盲信统一 fallback。
|
||||
- [ ] 按预算优先压缩可重读目录、旧 Schema、旧只读结果,再摘要旧对话;保留最近错误、用户约束及工具调用配对。
|
||||
- [ ] 参数、对象编码、单位、执行状态及文档版本保存为结构化数据,不能只依赖自然语言摘要。
|
||||
- [ ] 受限的工具文本/JSON 原文放 PostgreSQL 的 cad_ai_tool_result 表(TEXT/JSONB),图状态只保存短结果和 resultCode;需要时鉴权后按页、字段读取。限制单条大小、每任务总量和保留期,禁止把数据库当作无上限文件仓库。
|
||||
- [ ] 截图与用户图片继续遵守既有数量、大小和模型能力限制;按当前请求/会话受限传递,不新增通用附件上传。若需要随检查点保存小图片,使用有总量及 TTL 限制的 PostgreSQL BYTEA 记录,不放公开 URL。
|
||||
- [ ] 不能把大量原文塞进图状态虚拟文件后,误以为它不会再增加检查点体积;模型视图与完整存储分离。
|
||||
- [ ] 继续使用已实现的 list_commands 精简目录、分页和 describe_command 精确读取,不丢失命令可发现性。
|
||||
- [ ] 静态命令 Schema 按引擎版本缓存;enabled、disabled_reason 等动态结果按当前文档重新检查。
|
||||
- [ ] 知识与 Skills 按有效上下文去重;正文已经被摘要/淘汰时允许重新读取。
|
||||
- [ ] 图片缩放及保留策略配置化,清理旧图后留下说明,不让长对话不断携带所有截图。
|
||||
- [ ] 记录系统说明、工具定义、目录、知识、Skills、历史、图片和推理状态的分类用量;区分估算和上游实际 usage。
|
||||
- [ ] 摘要和恢复调用也计入任务费用。缓存命中减少费用不等于缩小上下文。
|
||||
|
||||
## 6. Skills 与新增知识库
|
||||
|
||||
### 6.1 Skills 随 CAD 发布同步
|
||||
|
||||
- 当前 Java 资源先通过 solidcraft-main/scripts/sync-cad-ai-skills.mjs 同步,与最新源逐字节核对。
|
||||
- 新 Python 项目引入只读、版本化 Skills 资源。CAD 源码保持权威来源,发布生成清单包含 sourceCommit、engineBuild、skillsRevision、各文件 SHA256。
|
||||
- CI 检查漏项、旧版本、引用文件缺失、超限及路径穿越;校验失败不能发布。
|
||||
- 运行时只注入技能目录和说明,按任务读取正文及 references,避免每次推理都塞入全部文档。
|
||||
- 终端用户建模技能与仓库开发/发布技能分组。首期保留全部源资源,是否暴露某个分组使用明确配置;不要因打包过滤而悄悄删除建模能力。
|
||||
- Skills 无权提高工具权限;文档中提到桌面文件或系统能力,不会让网页绕过 gate。
|
||||
|
||||
### 6.2 新增知识库完整迁移
|
||||
|
||||
- 阅读目录与其登记的 17 份文档、版本、文件路径映射及 Markdown 原文迁入新服务构建资源。
|
||||
- 保留 knowledge_lookup(document_id)、knowledgeMode、cad-knowledge-v1 兼容含义及未知文档 not_found。
|
||||
- 保留模型自行选择文档的机制,不增加关键词强制路由或前置分类器。
|
||||
- 知识来源仍是受维护目录,不把模型传入的任意路径作为文件路径。
|
||||
- 保留正文完整性和有效历史去重;正文超大时可外置并提供完整重读,不直接按普通文本限额剪掉后半部分。
|
||||
- 新旧后台资源逐文件哈希对照,回归已知文档、未知编码、关闭模式、裁剪后重读及跨用户隔离。
|
||||
- 新 Python 服务直接读取自身打包资源;灰度期 Java 知识接口继续服务 v1,两个发布包都记录知识版本。
|
||||
|
||||
## 7. 前端改造清单
|
||||
|
||||
现有前端有两层,不需要改为 Vue/React。
|
||||
|
||||
| 层与位置 | 必须修改的内容 | 保留能力 |
|
||||
| --- | --- | --- |
|
||||
| Rust/WASM agent.rs、agent_tools.rs | 为 v2 增加服务端任务客户端,移除该路径的模型主循环和模型重试;消费状态、工具意图和确认事件 | v1 平台入口及桌面 API/ACP 的独立行为 |
|
||||
| 公共 backend.rs、mod.rs、panel.rs | 映射任务状态、流式预览、同页面暂停/继续、输入问题、重连状态和可定位错误 | 现有聊天、工具卡片、权限确认和当前页面撤销分组 |
|
||||
| platform.rs | AI 工具领取、执行、回执与修订校验,绑定页面实例和租约代次;不增加 AI 快照链路 | 现有文档桥接、内核与普通命令 API |
|
||||
| 主站 app.js | 绑定新 AgentClient;页面离开或账号/项目切换时废弃旧执行权;页面重开使用新绑定 | 登录、打开项目、原本地草稿恢复和手动保存流程 |
|
||||
| 主站 api.js / 新 agent-client.js | 新服务地址、鉴权、会话/任务 API、fetch SSE 游标续接、传输退避 | 原 CadApi 普通项目接口 |
|
||||
| 当前页面 AI 状态 | 在本页内存保存页面实例、最后事件游标、工具收据和待确认操作;首期不新增 AI IndexedDB 持久层 | 原本地草稿和普通保存日志保持现有结构 |
|
||||
| 构建与缓存 | 能力协商、版本化 WASM、资源哈希、灰度开关和旧构建保留 | 不手改生成的 cad/js 产物 |
|
||||
| 自动化测试 | Node API、Rust 助手、Playwright、同页面断线、页面退出及租约失效场景 | 既有 CAD 手动操作回归 |
|
||||
|
||||
普通文本、工具状态、询问用户和权限审批是不同事件。用户补充尺寸等业务信息时使用问题卡片,原页面有效时答复后继续同一任务,不能把“问用户”做成普通终止。持久化问题记录不赋予新页面继续旧任务的能力。
|
||||
|
||||
流式展示约束:
|
||||
|
||||
1. 合法正文增量立即展示为当前 attempt 的临时文字。
|
||||
2. 未完整结束的正文不进入正式会话记录,也不能触发工具。
|
||||
3. 服务端确认一次模型步骤后,发出正文确认事件,前端以消息编码替换草稿。
|
||||
4. 当前尝试失败后清除其草稿,显示恢复状态;下一次尝试使用新的 attemptCode。
|
||||
5. SSE 重连根据序号去重,只补 UI 事件,不重新提交任务。
|
||||
6. 工具通知的事件回放不能作为执行授权;必须重新领取待执行工具。
|
||||
7. 取消、退出、换项目后清理未确认预览,已确认回答和设计修改保留。
|
||||
|
||||
## 8. 新接口与持久化清单
|
||||
|
||||
建议独立路由前缀 /api/cad-agent/v2;反向代理仅把这一前缀交给 Python,原 /api/cad/ai 与其他 Java 路由保持原行为。
|
||||
|
||||
| 接口 | 职责 |
|
||||
| --- | --- |
|
||||
| GET /capabilities | 能力、模型 profile、协议与资源版本 |
|
||||
| POST /sessions | 建立账号、项目、页面实例及内存文档绑定的执行会话;刷新后新建绑定 |
|
||||
| POST /sessions/{sessionCode}/messages | 幂等提交用户任务,返回 runCode |
|
||||
| GET /runs/{runCode} | 查询任务权威状态 |
|
||||
| GET /runs/{runCode}/events?afterSequence=... | fetch SSE 订阅和事件补发 |
|
||||
| POST /runs/{runCode}/heartbeat | 更新执行端在线状态与短期绑定 |
|
||||
| POST /runs/{runCode}/tools/{toolCallCode}/claim | 领取并校验当前执行授权 |
|
||||
| POST /runs/{runCode}/tools/{toolCallCode}/result | 幂等提交工具回执 |
|
||||
| POST /runs/{runCode}/pause、resume、cancel | 显式控制任务;resume 仅用于原页面仍有效的暂停/重连,校验页面与文档,不支持退出后续跑 |
|
||||
| POST /runs/{runCode}/answers | 回复持久化问题或审批 |
|
||||
| GET /tool-results/{resultCode} | 鉴权后分页/按字段读取受限的工具结果,无对象存储或上传签名接口 |
|
||||
|
||||
事件至少包含 eventCode、sequence、sessionCode、runCode、attemptCode、事件类型和内容;所有对外身份均使用业务编码,不暴露数据库主键。
|
||||
|
||||
SSE 只承担传输;业务事件先持久化再发布。事件日志有保留期限与状态基线补齐机制,游标过旧时先返回当前状态及已确认消息;这里的状态基线不包含 CAD 文档快照。断开订阅不等于取消 run,但原执行端离开或租约超期后必须结束旧任务。
|
||||
|
||||
建议应用表:
|
||||
|
||||
| 表 | 用途 |
|
||||
| --- | --- |
|
||||
| cad_ai_session | 用户、项目、资源版本和会话配置 |
|
||||
| cad_ai_run | 用户任务、状态、预算、页面绑定及执行端丢失原因 |
|
||||
| cad_ai_message | 确认消息及内容引用 |
|
||||
| cad_ai_tool_execution | 意图、顺序、参数哈希、执行状态与回执 |
|
||||
| cad_ai_event | 有序、可补发的业务事件 |
|
||||
| cad_ai_tool_result | 受限工具文本/JSON,以及按需启用的受限小图片;记录归属、哈希、大小和保留期,不保存 CAD 恢复快照 |
|
||||
| cad_ai_work_item | 可恢复调度、待发布通知/续接任务 |
|
||||
| cad_ai_document_lease | 文档写入租约、代次和过期时间 |
|
||||
| cad_ai_question | 等待用户的问题、审批和幂等答复 |
|
||||
|
||||
Graph 检查点使用官方 PostgreSQL 适配器自身的表,单独记录版本及升级流程,不手写一套检查点序列化。所有用户数据有归属、创建/更新时间、保留策略与删除流程。重要唯一约束包括用户提交编码、run+toolCallCode、会话+事件序号。
|
||||
|
||||
## 9. 部署、隐私和运维
|
||||
|
||||
- [ ] 新后台、PostgreSQL 和 Redis 使用独立凭据与数据命名空间,不共享原业务数据库权限。
|
||||
- [ ] 首期部署不要求 OSS、对象存储密钥或私有路径。工具结果按账号/项目/任务鉴权读取,禁止为省事改用公开 URL。
|
||||
- [ ] 同源代理优先,生产检查 SSE 缓冲、心跳、空闲超时和连接清理;API 与 SSE 禁止 Service Worker 缓存。
|
||||
- [ ] 本地继续从 8091 进入;新增后台只通过受控本机/容器网络接入,不随意启动额外前端端口。
|
||||
- [ ] health/readiness、优雅停机、Worker 租约回收、连接池和队列背压作为首期交付内容。
|
||||
- [ ] 各用户/项目的速率、并发、模型调用、修改次数、token、图片大小及数据库结果存储配额受限。
|
||||
- [ ] 建立任务、事件及数据库工具结果的保留和清理策略,活动检查点仍引用的必要结果不得提前删除。
|
||||
- [ ] 监控模型失败、恢复次数、暂停原因、首字时间、工具耗时、token 分类、队列和存储用量。
|
||||
- [ ] 日志包含 requestId、sessionCode、runCode、toolCallCode、供应商、模型 profile、阶段、错误类别、耗时和资源版本。
|
||||
- [ ] 不记录密码、Token、签名 URL、原始推理、完整设计及未处理的上游错误正文。CAD 数据不默认上传外部 tracing 平台。
|
||||
- [ ] 发布固定 Graph/状态格式版本。服务更新期间只对仍有效的原页面任务进行校验后续接;不兼容时明确结束,不让旧代码误读检查点后继续修改。
|
||||
|
||||
## 10. 必须通过的验收清单
|
||||
|
||||
| 测试组 | 必须验证的行为 |
|
||||
| --- | --- |
|
||||
| 模型协议 | 现有三厂商协议不变,工具参数、续接和模型配置正确;不调用真实厂商的模拟测试先通过 |
|
||||
| SSE | 中文 UTF-8 分片、CRLF、跨包、心跳、断流、缺终态、重复/乱序事件及过旧游标 |
|
||||
| 尝试级预览 | completed 前可看到文字;失败草稿清除;重连不重复提交回答 |
|
||||
| 服务端恢复 | 原页面与文档仍有效时,在模型等待、写回执前后或 Graph 续接前后重启 Worker,校验执行端后继续且不重跑确认操作;执行端丢失则结束 |
|
||||
| 浏览器连接与退出 | 同页面短暂断线后补事件和回执;关闭、刷新、崩溃或重连超时后旧任务结束,新页面不能接管旧任务 |
|
||||
| 操作不确定窗口 | CAD 成功但回执丢失时先用原页面收据对账;页面已丢失或无法确认时不盲重放、不伪报成功 |
|
||||
| 文档一致性 | 手动修改、云版本变化、引擎变化、多标签、旧租约和迟到响应都不能修改错误文档 |
|
||||
| 权限 | 用户/项目/会话/工具结果隔离;登录失效、删除项目、原站权限接口不可用时拒绝新授权 |
|
||||
| 上下文 | 长对话与单轮多工具都在请求前控预算;摘要后保留约束和对象编码;大结果可完整回读 |
|
||||
| 目录与知识 | list_commands 不漏可发现命令;Skills 与源一致;知识原文/路由/模式/裁剪后重新读取正确 |
|
||||
| 预算 | 重试无叠加,单次调用与整个任务预算分离;耗尽后可解释并按规则暂停,继续仅限有效原页面 |
|
||||
| 取消 | 停止后无新操作,正在执行的步骤真实收尾,已修改内容准确保留 |
|
||||
| 原业务 | 账号、社区 AI、CAD 打开、手动保存、普通业务接口与原有限额不回归 |
|
||||
| 升级/回退 | 新旧前端、后端、资源清单及缓存组合正确;会话不在 v1/v2 中途互相接管 |
|
||||
|
||||
真实模型使用固定 profile、参数、CAD 初始文档和任务样例,分别记录建模成功、恢复成功、总输入/输出、费用及耗时。先测当前基线,再确定真实任务成功率门槛;模拟测试全部通过不等于模型任务 100% 成功。
|
||||
|
||||
旧验收记录中存在一次 CadAiTest 异步 SSE 结果为空、复测通过但根因未明的情况。新实现必须以可控时钟/事件同步与断连故障注入覆盖生命周期,不能把偶然复测通过当作修复。
|
||||
|
||||
## 11. 实施顺序与阶段验收
|
||||
|
||||
| 阶段 | 可评审交付与退出条件 |
|
||||
| --- | --- |
|
||||
| 基线与技术验证 | 固定 0.43 资源;验证三协议、浏览器工具等待/同页面续接、PG 检查点和版本化工具集,包含退出后旧任务失效 |
|
||||
| 新后台骨架与持久任务 | 独立服务、原站鉴权适配、会话/任务、PG/Redis、执行端租约和事件日志;服务重启先校验原页面 |
|
||||
| 工具桥与页面保护 | Rust/JS 执行授权、顺序执行、幂等回执、同页面重连和修订冲突处理;无已确认操作自动重复执行 |
|
||||
| 模型/上下文/资源迁移 | 三协议适配、预算、摘要、PG 工具结果按需读取、Skills 和知识完整校验 |
|
||||
| 流式与任务交互 | 实时文字、清理草稿、状态卡、提问、同页面继续/停止及执行端丢失提示 |
|
||||
| 故障回归与小范围灰度 | 自动化、真实样例基线、小规模压力观察、打包部署、回退演练和已知限制 |
|
||||
|
||||
实施优先顺序:工具与文档安全 → 同页面断线和重试可靠性 → 流式与上下文 → 小范围真实模型质量 → 按数据扩容。跨页面任务恢复、AI 文档快照、对象存储、联网搜索、多子 Agent、语义向量知识库和管理控制台作为后续独立增强,不阻挡首期交付。
|
||||
|
||||
## 12. 灰度与回退
|
||||
|
||||
1. 单独部署 Python API/Worker、PostgreSQL 和 Redis,不要求对象存储,不替换原 Java 服务。
|
||||
2. 新前端以账号/会话灰度开关选择 v1 或 v2;同一会话固定运行时。
|
||||
3. 先用模拟模型完成断线、重启、重复回执和文档冲突测试。
|
||||
4. 固定模型与样例小范围验证,核对模型配置、资源版本、token 和恢复效果。
|
||||
5. 灰度期保留旧 WASM/manifest,校验实际 HTTP 文件长度及哈希,防止旧缓存混用。
|
||||
6. 新任务可关闭 v2 回到 Java v1;已有 v2 任务先停止分发、明确结束并保留记录,不把中途任务直接交给旧循环。设计修改由原有保存/草稿机制处理。
|
||||
7. 新后台自身回退需检查 Graph/状态格式兼容,不通过删除新库记录作为“回滚”。
|
||||
|
||||
## 13. 完成后的效果与边界
|
||||
|
||||
| 用户能看到的效果 | 形成该效果的机制 | 边界 |
|
||||
| --- | --- | --- |
|
||||
| 同页面网络短暂波动后继续 | 有效原页面、持久事件、SSE 续接、回执对账和有限模型重试 | 页面退出、文档绑定失效或超过宽限期后旧任务结束 |
|
||||
| 不要求私有 OSS 即可部署 | 大型工具文本/JSON 在受限 PG 结果表中保存并鉴权读取 | 首期不提供退出后续跑、AI 文档快照或通用附件服务 |
|
||||
| 长对话输入受控 | 每步预算、摘要、结构化记忆、数据库大结果按需读取 | 摘要有质量风险,不能承诺无限任务或零信息损失 |
|
||||
| 失败原因可定位 | 固定错误类别、阶段、关联编码和恢复次数 | 不能让上游永远返回正确响应 |
|
||||
| 不因重试重复挤出/删除 | 幂等账本、领取授权、页面与文档代次、不确定状态对账 | 无法对账时暂停或结束,不冒险重放或声称 exactly-once |
|
||||
| 正文持续流式显示 | 尝试级草稿和确认事件 | 模型思考等待期间显示状态,不伪造正文 |
|
||||
| 多模型选择可控 | 版本化 profile、协议适配与能力协商 | 更换模型会改变质量,不自动切厂商 |
|
||||
| 知识与技能继续有效 | 原文、哈希、按需读取、有效上下文去重 | Skills 不能代替权限或几何验证 |
|
||||
| 产品具有多用户隔离基础 | 独立归属、租约、限额、工具结果鉴权和脱敏监控 | 首期不宣称未经压测的并发容量 |
|
||||
| 原站其他业务保持原行为 | 新服务与新路由隔离,Java 只被调用现有读接口 | 原站授权不可用时需要安全暂停 |
|
||||
|
||||
## 14. 最终交付物
|
||||
|
||||
- 独立 Python 后台工程、依赖锁文件、CI、镜像及 API 契约。
|
||||
- Rust/WASM 与主站 JavaScript 改造、构建包和对应版本清单。
|
||||
- CAD AI PostgreSQL 数据设计与单独 DDL、官方检查点迁移及备份说明。
|
||||
- Skills/知识完整迁移和资源同步/打包校验。
|
||||
- 任务/工具/事件状态机、同页面重连、页面退出及冲突处理说明。
|
||||
- 模拟故障回归、真实模型同条件基线、小范围灰度记录。
|
||||
- 部署配置、监控、数据保留、清理、升级与回退操作说明。
|
||||
|
||||
## 15. 框架依据
|
||||
|
||||
以下为官方资料路径;实施时以锁定版本的公开接口和实际契约测试为准:
|
||||
|
||||
- `https://docs.langchain.com/oss/python/deepagents/overview`
|
||||
- `https://docs.langchain.com/oss/python/deepagents/context-engineering`
|
||||
- `https://docs.langchain.com/oss/python/deepagents/backends`
|
||||
- `https://docs.langchain.com/oss/python/deepagents/skills`
|
||||
- `https://docs.langchain.com/oss/python/langgraph/persistence`
|
||||
- `https://docs.langchain.com/oss/python/langgraph/interrupts`
|
||||
- `https://docs.langchain.com/oss/python/langgraph/durable-execution`
|
||||
|
||||
Deep Agents 提供 Agent 工程基础,LangGraph 提供状态与持久化基础。首期仍须完成浏览器几何副作用、原站权限、页面绑定、业务事件回放和产品级故障验收;跨页面任务恢复及文档快照已明确延后。
|
||||
|
||||
## 16. 本次 Java Skills 同步结果
|
||||
|
||||
- 来源提交:ade571ebe95bd3b2dff3fff744ee33f584f76fe0(本地 CAD 0.43.0 基线)。
|
||||
- 使用既有 sync-cad-ai-skills.mjs 同步,19 个 Skills、32 个文件,新增 2 项,14 个既有 SKILL.md 正文更新。
|
||||
- 资源 revision:b9c715912afefe96fa839a749f804d42d86724b258a7e56c48c32d73c2ccbca1。
|
||||
- skills.json 文件 SHA256:9d71ac78011b890c182e4ef28da15a52cc9714cc777f7fef2c806e63489a90a6。
|
||||
- 4 个既有测试文件同步更新技能数量及资源哈希断言;Java 生产代码和模型配置未改。
|
||||
- JDK 21 下 6 个 CAD AI 测试类共 120 项通过,0 失败、0 错误、0 跳过;覆盖资源、协议、模型适配、知识读取和 API。
|
||||
- 首次沙箱测试因本机模拟 HTTP 端口绑定被拒绝;获得执行权限后相同测试全部通过,未调用真实模型。
|
||||
- 最终 JAR 内 Skills 与源文件字节完全一致,37 个打包知识资源与当前源哈希一致,40 个受检知识源文件未改。
|
||||
- 发现并移除 1 个仅存在于 target/classes 的过时知识文件后重新打包,未修改知识源文件。
|
||||
- 验证记录:/Users/lk/Projects/vibemake相关项目/community/target/cad-ai-skills-sync-20261116/verification-summary.json。
|
||||
- 构建完成,未重启运行服务,未提交 Git。
|
||||
@@ -0,0 +1,618 @@
|
||||
# CAD Agent 建模能力、Skills 与提示词全量梳理
|
||||
|
||||
审计日期:2026-11-17。目标:为继续优化 CAD 生成效果建立可核对的能力清单,重点是几何构造、参数化、工具使用、建模规范和验收;不展开摘要、缓存、会话恢复等通用 Agent 工程。
|
||||
|
||||
本报告基于当前本地工作区源码。核对了 community 的 Java v1、独立 cad-ai-server 的 Python v2,以及 solidcraft-main 的共享技能和原生工具实现。没有调用真实模型,没有改业务代码或运行中的服务。本次同步检查成功,不代表线上部署已核对,也不代表建模效果已重新验证。
|
||||
|
||||
## 1. 先明确当前到底有多少内容
|
||||
|
||||
| 层次 | 当前实际内容 | 如何影响生成 |
|
||||
| --- | --- | --- |
|
||||
| 共享常驻工作流 | `solidcraft-main/skills/agent-workflow.md` | 每次推理的系统提示包含它,规定先理解、计算、分阶段构建、测量、改参、修复 |
|
||||
| makeCAD Skill 集合 | **19 个 Skill、32 个文本文件** | 系统提示包含目录和描述,正文通过 `skill_reference` 按需读取,并非 19 份全文常驻 |
|
||||
| 直接相关 Skill | **5 个核心建模 Skill+1 个故障复现/报告 Skill** | modeling、editing、checking、mechanisms、sheetmetal;辅助 reporting |
|
||||
| 零件专用运行规程 | **17 份:15 份齿轮/传动+球轴承+XZ 筋板风险提示** | 通过 `knowledge_lookup` 按目录读取,属于实际建模知识,但并不是 17 个 `makecad-*` Skill |
|
||||
| 工具契约 | 11 个基础浏览器 CAD 工具,另有 Skill/知识读取及 v2 的研究、读图等服务工具 | 限定怎样发现命令、执行、测量、校验和观察 |
|
||||
| 离线知识 | 203 类分类目录、6 个完整零件族、9 份共享特征、6 份完整示例,以及候选和历史证据 | 不会因为存在于仓库就自动进入生产模型上下文 |
|
||||
|
||||
**最需要避免的误解:**“有文件”“已打包”“模型能读取”“这次确实读了”“依规程执行了”“最终几何正确”“改参仍正确”“统计上提高成功率”,是不同层次。
|
||||
|
||||
历史资料多处仍写 17 个通用 Skill。当前实际已是 19 个;同步脚本校验结果一致,不能继续用旧数字判断现状。
|
||||
|
||||
## 2. 真正生效的提示词来自哪里
|
||||
|
||||
### 2.1 Java v1:community
|
||||
|
||||
入口:[ArkCadAiClient.java](../vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/ArkCadAiClient.java),主要看 `SYSTEM` 和 `instructions()`。
|
||||
|
||||
系统提示组合:
|
||||
|
||||
1. [CadAiTools.java](../vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/CadAiTools.java) 读取打包的 [skills.json](../vibemake-service/src/main/resources/cad/ai/skills.json)。
|
||||
2. 拼接共享 `workflow`、19 个 Skill 的名称、描述和文件目录。
|
||||
3. 知识功能开启且请求声明 `cad-knowledge-v1` 时,拼接 [CadAiKnowledge.INSTRUCTIONS](../vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/CadAiKnowledge.java)。
|
||||
4. 再拼接浏览器环境规则:仅修改当前设计、精确查询命令、优先参数表达式、按测量证据报告、不能通过工具保存云端文件等;这部分明确优先于 Skill 中的桌面示例。
|
||||
5. 协议恢复时再追加纠错提示;不属于新增建模知识。
|
||||
|
||||
Java 知识提示有一条很具体的质量约束:**除用户明确要求运动学占位,不能把齿轮擅自降级为无齿圆柱。**
|
||||
|
||||
读取目录的 17 项名称和摘要由 `knowledgeDefinition()` 放进 `knowledge_lookup` 工具说明。Java 的新读取请求需要 `document_id`。知识默认配置为 `off`;`pilot` 和 `enabled` 都展示同一个直读工具,当前不再按 experimental/approved 决定哪些正文可读。这里只描述代码默认值,没有读取私有 `.env` 推断现场设置。
|
||||
|
||||
### 2.2 Python v2:cad-ai-server
|
||||
|
||||
入口:[resources.py](../../cad-ai-server/src/cad_ai/resources.py),主要看 `Resources.prompt`、`skill()`、`knowledge()`;实际模型调用覆盖见 [runtime.py](../../cad-ai-server/src/cad_ai/runtime.py) 的 `CadRuntimeMiddleware.awrap_model_call()`。
|
||||
|
||||
系统提示组合:
|
||||
|
||||
1. `codex_reference/agent_rules.md`:自主完成、只按证据报告、错误后诊断等通用操作规则。
|
||||
2. 同一份共享 `workflow`。
|
||||
3. 同一份 19 个 Skill 目录。
|
||||
4. 浏览器执行、参考图、公开资料研究等规则。
|
||||
5. 当前文档修订等运行数据;与建模知识本身分开。
|
||||
|
||||
v2 与建模效果直接相关的补充:
|
||||
|
||||
- **参考图先读再建模**:记录看得清的尺寸和未解决细节;历史截图不能当成当前文档;精确几何优先用 CAD 测量。
|
||||
- `read_image` 可重新读取会话中的参考图或截图,能力取决于所选模型 profile 是否支持图像。
|
||||
- **外部规格有依据**:需要时用 `web_search`、`read_web_page` 查公开事实,优先制造商/一手来源,保留单位并区分事实与假设。
|
||||
- [search.py](../../cad-ai-server/src/cad_ai/search.py) 另有研究提示,要求返回来源、精确单位、不猜缺失事实;返回的是有来源的摘要,不等于网页全文。
|
||||
- 只为无法推断或检查、且影响正确性的必要问题使用 `ask_user`。
|
||||
- 不知道参数时读 Schema,已有准确 Schema 可以复用。
|
||||
|
||||
**重要差异:**v2 的 `knowledge_lookup({})` 先返回目录,带 `document_id` 才读正文;17 条摘要没有像 v1 那样直接展开在工具说明里。v2 没有自动拼入 Java 的 `CadAiKnowledge.INSTRUCTIONS`,包括其中明确的“齿轮不得降为无齿圆柱”原句。是否影响选文和降级行为,需要正式任务比较,不能仅凭提示差异宣布效果下降。
|
||||
|
||||
**不要改错提示文件:**`cad-ai-server/src/cad_ai/codex_reference/prompt.md` 是上下文摘要提示,`runtime.py` 将它读为 `COMPACT_PROMPT`;它不是日常建模主提示。通用模型行为在 `agent_rules.md`,建模行为主要在 `Resources.prompt` 与共享工作流/Skills。
|
||||
|
||||
### 2.3 权威来源和同步关系
|
||||
|
||||
```text
|
||||
solidcraft-main/skills/
|
||||
├─ agent-workflow.md
|
||||
└─ makecad-*/SKILL.md、reference、scripts、templates
|
||||
│ scripts/sync-cad-ai-skills.mjs
|
||||
▼
|
||||
community/vibemake-service/src/main/resources/cad/ai/skills.json
|
||||
│ cad-ai-server/scripts/sync_resources.py
|
||||
▼
|
||||
cad-ai-server/src/cad_ai/data/skills.json
|
||||
|
||||
community/knowledge/cad-parts/generation/reading-catalog.json
|
||||
└─ 精确登记的 17 份 Markdown
|
||||
├─ Java Maven resources 打包为 classpath 资源
|
||||
└─ Python sync_resources.py 复制为 data/knowledge/ 资源
|
||||
```
|
||||
|
||||
修改原生建模 Skill 应改 `solidcraft-main/skills/`,再同步;不要仅手改 Java/Python 的副本。修改零件规程应改 community 中目录实际指向的 canonical Markdown,再同步 Python 资源。发布仍须构建相应 Java/WASM/Python 产物;本报告未执行发布。
|
||||
|
||||
## 3. 常驻工作流已经规定了哪些建模规范
|
||||
|
||||
来源:[agent-workflow.md](../../solidcraft-main/skills/agent-workflow.md)。
|
||||
|
||||
| 阶段 | 当前要求 | 试图避免的问题 |
|
||||
| --- | --- | --- |
|
||||
| 理解需求 | 将自然语言转成功能、零件/装配结构、尺寸、参数、特征顺序和验收条件 | 只按外观关键词堆几何,漏结构 |
|
||||
| 缺省信息 | 关键缺失先澄清,普通选择声明合理假设 | 任意编造安装尺寸或反复问无关问题 |
|
||||
| 初始检查 | 即使看起来是空白,也先精简 `inspect_design` | 误清已有设计、误判当前状态 |
|
||||
| 数学规划 | 先算参数、位置、阶段体积、包围盒及拾取世界坐标 | 边建边猜、无法知道结果是否合理 |
|
||||
| 命令发现 | 筛选 `list_commands`、准确 `describe_command` | 猜工具名、命令 ID 或参数字段 |
|
||||
| 构建策略 | 分阶段 batch、命名特征;板/块/柱/孔等优先带表达式的原语 | 大量脆弱草图、无可编辑参数链 |
|
||||
| 特征顺序 | 一般先外圆角再抽壳,再内部结构,最后贯墙孔槽 | 抽壳失败、后加材料堵孔 |
|
||||
| 孔深度 | 盲孔及只穿空心件一层壁的孔必须明确深度 | 默认 through-all 误穿另一壁 |
|
||||
| 参数传播 | 相关尺寸/位置必须存为表达式、草图尺寸或阵列间距 | 看似参数化,修改后孔位等不动 |
|
||||
| 草图 | `sketch.solve` 验证 dof=0 | 改参后漂移、翻边、无报错变形 |
|
||||
| 拾取 | 使用计算过并验证的世界坐标,不能乱猜 | 圆角/抽壳挑错边面 |
|
||||
| 阶段验收 | measure 对比独立计算;查实体数、bbox、圆柱轴等 | `ok` 但切空、Join 未接上、孔位错 |
|
||||
| 改参测试 | `check_parameters` 并确认恢复;或修改、测量、恢复 | 只对默认尺寸有效 |
|
||||
| 修复 | 优先改原特征/参数,checkpoint 做有限试验 | 整件重建、重复操作、破坏下游 |
|
||||
| 完成标准 | 报实际结果、测量证据和剩余限制 | 仅凭截图或结束话术宣称完成 |
|
||||
|
||||
这些是模型侧要求,读取或遵循并非全部有程序硬门禁;后面单列硬检查。
|
||||
|
||||
## 4. 直接相关的 6 个 Skill
|
||||
|
||||
### 4.1 makecad-modeling:新零件如何构造
|
||||
|
||||
来源:[SKILL.md](../../solidcraft-main/skills/makecad-modeling/SKILL.md)、[reference.md](../../solidcraft-main/skills/makecad-modeling/reference.md)。
|
||||
|
||||
**适用:**新零件、壳体、支架、安装板、法兰及其他实体。通常与 checking 同用。
|
||||
|
||||
具体内容:
|
||||
|
||||
- 建模前列参数、原点、全部特征与拾取点、预期体积和包围盒。
|
||||
- 常见顺序:参数/草图/首特征 → 圆角与抽壳 → 孔、切除、阵列。风险布尔单独一个 batch。
|
||||
- 已有合适原语时直接用 box/cylinder/hole 等;其他轮廓用草图。
|
||||
- 位置要通过表达式、相对边引用或草图尺寸跟随参数;普通数字不会自动变成依赖。
|
||||
- 草图 ID 按类型计数,但矩形构造对角线、轴约束新增构造线等会改变后续编号,不能忽略。
|
||||
- 选边点是普通数值世界坐标;存储的拓扑拾取可随改参跟随,不应把表达式塞进 edge pick。
|
||||
- 原生镜像/阵列保留参数依赖;不能把一个 mirror/pattern 特征再次当作同类特征的输入;某些情形可改用 bodies。
|
||||
- 多个草图区域的默认拉伸含嵌套孔洞语义;不能把第三个内圆生成的独立圆盘误当孔。
|
||||
- 圆角/抽壳有例外:被移除面边缘的圆角应在抽壳后;曲面之间的圆角可能导致抽壳不支持。
|
||||
- 曲面相切处 primitive boolean 失败时,用草图轮廓拉伸切除等已有替代策略。
|
||||
- 每阶段量体积/bbox/面数;改参后复测;孔柱位置用圆柱轴/原点/半径核对;末尾看 iso,内部特征补 top。
|
||||
|
||||
**reference 的实际价值:**不是泛泛“画得准确”,而是具体命令形状、单位、坐标、ID、错误修复和一个可运行安装板示例。
|
||||
|
||||
特别容易影响效果的规则:
|
||||
|
||||
1. 平面映射:XY=(+X,+Y),法向+Z;**XZ=(+X,−Z),法向+Y**;YZ=(+Y,+Z),法向+X。
|
||||
2. `rectangle.center` 额外产生两条构造对角线,不能按普通四线矩形推断所有 ID。
|
||||
3. 圆心用 `c1.center`,不是猜一个 `p1`;尺寸到圆边与到圆心不同。
|
||||
4. 草图距离通常无符号,几何要先画在正确一侧。
|
||||
5. 圆角拾取按最近拓扑解析;多个体位置重合时应限定 body。
|
||||
6. 空切可能返回成功;显式 `operation` 和 `targets` 很重要。
|
||||
7. pattern count 包含原件,重复实体名称可能被自动改名,后续必须用实际创建结果。
|
||||
8. `measure` 有数值误差,不能把统一的零误差当所有模型的目标。
|
||||
|
||||
**贡献的能力:**通用实体生成策略、稳定的命令使用方式、可编辑性、基础尺寸/位置验证。
|
||||
|
||||
### 4.2 makecad-editing:已有模型如何改和修
|
||||
|
||||
来源:[SKILL.md](../../solidcraft-main/skills/makecad-editing/SKILL.md)。
|
||||
|
||||
- 先精简 inspect,再用 `parameters.list {filter:"feature"}` 一次找特征输入 d1/d2 等,并做 measure 基线。
|
||||
- 改数值优先 `parameters.change`;固定值参数化:先加用户参数,再替换原输入表达式。
|
||||
- 改 profiles、方向、operation、拾取等结构性信息时用 `timeline.inspect`+`timeline.edit`。
|
||||
- 中间插入特征用 `timeline.roll_to`,插入后回时间线末尾,核对所有下游特征。
|
||||
- 删除前读 `timeline.dependents`。
|
||||
- 风险编辑先单独 checkpoint;restore 会消耗该 checkpoint,不能无限复用;只保留最近 16 个。
|
||||
- “高 2 mm”优先保留原相对设计意图,例如 wall+6 → wall+8,说明理解。
|
||||
- 成组独立修改后对照总预期变化;不匹配再还原、分项定位。
|
||||
- 位置变化可不改变体积,必须查世界坐标或质心变化;内部特征补顶视。
|
||||
- 改参验证后恢复原值;不通过删除重建掩盖原问题。
|
||||
|
||||
**贡献的能力:**保留历史、参数依赖与零件身份,局部修复,减少“修改一次整件重画”。
|
||||
|
||||
**浏览器边界:**文中的 open/save、崩溃恢复 CLI 等桌面能力不等于网页端可调用;受宿主工具限制。
|
||||
|
||||
### 4.3 makecad-checking:防止无报错但做错
|
||||
|
||||
来源:[SKILL.md](../../solidcraft-main/skills/makecad-checking/SKILL.md)。
|
||||
|
||||
核心检查:
|
||||
|
||||
- 参数注释写范围和整数性;当前引擎不会因为写了注释就强制所有用户改参都遵守范围。
|
||||
- 共用表达式提升为命名参数,用户关注的结构各自命名;可把驱动参数设 favourite。
|
||||
- 每个草图 dof=0;量体积、bbox、质心,关注 warning。
|
||||
- 遍历参数允许范围两端,并连续改回默认;有些错误在“到达零尺寸后的下一次修改”才出现。
|
||||
- 计数 0 会重建失败,分数可能被圆整,但位置表达式未圆整,导致阵列和居中不一致;应写清整数并统一 `round(n)` 语义。
|
||||
- 零距离尺寸可能丢失所在侧;需要通过对齐约束或外部基准避免跨零。
|
||||
- 外切正多边形即便有尺寸和一条竖边,也可能剩 1 dof,需 polygon 约束。
|
||||
- Boolean retry 的 warning 可能伴随真实几何错误,也可能是体积吻合的小扰动,不能一律当成功或失败。
|
||||
- 表达式支持的函数和单位有边界:无 if/比较运算;asin/acos/atan/atan2 有角度单位;计数必须无量纲。
|
||||
- 重名 body 会静默重命名,targets 可能只指向第一件。
|
||||
|
||||
附属文件与可用边界:
|
||||
|
||||
| 文件 | 做什么 | 当前网页 Agent 能直接执行吗 |
|
||||
| --- | --- | --- |
|
||||
| `scripts/run.py` | 调 CLI 执行脚本,输出 FAIL/WARN/SKETCH/BODY;可检查中间状态 | 不能;读取源码不等于具备 shell/CLI |
|
||||
| `scripts/scb.py` | 生成 fully constrained 的圆、六角形、圆角矩形与定位尺寸;拒绝重名 | 不能;可作为离线构造辅助 |
|
||||
| `scripts/compare_step.py` | 独立 STEP 形体对称差/xor,默认阈值 1e-3 mm³,并定位差异块 | 不能;需要外部运行环境与 STEP 文件 |
|
||||
| `reference/porting.md` | 迁移模型的坐标对齐、显式近似、逐参数 STEP 对比 | 只能理解流程,执行取决于外部能力 |
|
||||
| `templates/test_design.py` | 同一会话连续参数变化,对比冻结的体积/面积/COM/bbox | 不能;供仓库中的设计回归 |
|
||||
| `scripts/tests/test_*.py` | 校验上述助手、行为陷阱和约定本身 | 离线维护测试,不是模型自动验收 |
|
||||
|
||||
**贡献的能力:**参数稳健性、错误识别、独立几何比较。最重要的是补上“工具没有报错”与“满足设计”之间的差距。
|
||||
|
||||
### 4.4 makecad-mechanisms:装配与运动
|
||||
|
||||
来源:[SKILL.md](../../solidcraft-main/skills/makecad-mechanisms/SKILL.md)、[reference.md](../../solidcraft-main/skills/makecad-mechanisms/reference.md)。
|
||||
|
||||
- 先计算组件、固定件、关节、世界点/轴、限位、传动比、闭环关系与最终回到的姿态。
|
||||
- 运动上是两件的东西必须拆组件,例如执行器筒体与活塞杆。
|
||||
- 每条运动链最终连到固定件;浮动链 dof=6,驱动可能 `moved:false`。
|
||||
- 已经摆好位置的件优先 as-built joint;两端同世界轴时 `flip:true` 避免装配后翻转 180°。
|
||||
- 使用明确 occurrence;多次实例化的子装配还要对应 path,防止关节连到另一份实例。
|
||||
- 开链可批量加,闭环关节分开加并检查 conflicts;加入关节前后比较 occurrence.properties,防止零件跳位。
|
||||
- 角度用度,位移 mm;关节超限可能被钳制,并不一定报错。
|
||||
- motion_link:b=ratio*a+offset;ratio 要按两侧单位计算,不能把 mm/rad 直接当 mm/deg。
|
||||
- gear/rack_pinion/screw 由半径、齿距等参数派生;cam 有轮廓、刀尖/滚轮/平底从动件等定义。
|
||||
- 闭环检查行程与铰角的独立几何关系;只驱动主动关节,从动件由约束求解。
|
||||
- contact、interference、clearance、joint.sweep/find_limits、motion.study/play/export/trace/plot 分别解决碰撞、范围、轨迹和速度等检查。
|
||||
- `truncated` 或 `unchecked` 不能被理解成全程无干涉;静态姿态正确不能代表动态正确。
|
||||
- 最后恢复约定姿态;URDF 是树,不能保留所有闭环关节。
|
||||
|
||||
**贡献的能力:**正确的组件/关节建模、传动单位、闭环、限位与运动验收。它不负责把光滑圆柱变成真实轮齿,也不等于接触仿真。
|
||||
|
||||
### 4.5 makecad-sheetmetal:钣金与自然语言折弯
|
||||
|
||||
来源:[SKILL.md](../../solidcraft-main/skills/makecad-sheetmetal/SKILL.md)、[reference.md](../../solidcraft-main/skills/makecad-sheetmetal/reference.md)。
|
||||
|
||||
- 按 sheet metal 特征建,不用普通块体拼出来后就声称可展开。
|
||||
- 先查 `sheet.rules`,厚度、K-factor、半径、避让和 gap 来自规则;K-factor 不能凭空编造。
|
||||
- base flange 先于 edge flange;支持 path_flange、hem、fold、convert、unfold/refold 等。
|
||||
- `segments` 是对一条边的连续分区,from/to 为 0..1 纯数字,不接受表达式;从 0 铺到 1,不能留洞、重叠或误当 set-back。
|
||||
- 不对称分区必须核对方向;段上的 angle/height/flip 覆盖边级/特征级值;flip 不是相对翻转。
|
||||
- segments 与 then 不兼容;弯曲窄于 relief 可能产生 warning;普通实体特征改变钣金体后可能不能再生成 flat pattern。
|
||||
- 折弯算术:BA=θ(R+kT),θ 为弧度;回退量、腿长、展开尺寸由 angle/position/height_from 共同决定。
|
||||
- `sheet.flat_pattern` 与 JSON bend table 复核展开外形、折线、角度、方向、长度、allowance;还要做配合干涉/间隙检查。
|
||||
- 自然语言推断要说明分区/角度的假设、置信度与备选;几何与描述矛盾则先解决。
|
||||
- 优化最多 8 组分区/角度/高度/侧向候选,以干涉为零、间隙够、板材放得下、半径满足规则为目标,并记录数值。
|
||||
|
||||
**贡献的能力:**制造语义较强的钣金构造、折弯参数解释、展开检查与有限搜索。
|
||||
|
||||
**版本边界:**文内仍有 feature branch / PR #9911 等说明,不能用文件存在推断当前部署全部支持;要查询实际命令 Schema。网页导出文件也受宿主权限约束。
|
||||
|
||||
### 4.6 makecad-reporting:把建模失败转成可定位问题
|
||||
|
||||
来源:[SKILL.md](../../solidcraft-main/skills/makecad-reporting/SKILL.md)、[report-template.md](../../solidcraft-main/skills/makecad-reporting/reference/report-template.md)。
|
||||
|
||||
- 记录版本、确切命令和错误、预期与实际数值。
|
||||
- 在独立设计中复现,删到不能再删的最小脚本;找边界如圆角 5 失败而 4.9 成功。
|
||||
- 空切、选错边等不能只信 ok,必须实际测量。
|
||||
- 对慢操作记录每步耗时及规模变化;不能无限盲等或原样重试崩溃命令。
|
||||
- 报告模板整理复现、预期、实际、截图与限制,用户文件不能擅自上传。
|
||||
|
||||
**贡献的能力:**更快定位“提示错误、参数错误、几何方法错误、内核问题”。主要为失败排查服务,不直接增加某类零件构造能力。
|
||||
|
||||
## 5. 当前可读的 17 份零件规程:逐份做了什么
|
||||
|
||||
真源:[reading-catalog.json](../knowledge/cad-parts/generation/reading-catalog.json)。下述“检查”是正文要求,不代表本次或每次都会自动执行。
|
||||
|
||||
### K01 外渐开线直齿轮
|
||||
|
||||
- ID:`involute-spur-gear`;版本 0.2.0;[原文](../knowledge/cad-parts/generation/candidates/involute-spur-gear-equation-v2.md)。
|
||||
- **构造:**根圆柱 → 两条方程渐开线+径向根线+齿顶弧闭合单齿 → 单齿 Join → 特征圆周阵列 → 按需轮毂/孔/键槽。
|
||||
- **解决:**手工展开采样点出错、漏掉 `sqrt(1+t^2)` 导致一圈圆包、角度/弧度错、未 Join 就阵列成多体、键槽不与轴孔贯通。
|
||||
- **检查/边界:**20°、零变位/侧隙、18–40 齿,基圆以下径向简化;检查实际曲线、齿厚/齿数、单体和孔槽。`atan(t)/(1 rad)` 必须保留;键槽从孔腔切到用户给定槽底,不能留月牙。
|
||||
|
||||
### K02 内直齿轮
|
||||
|
||||
- ID:`internal-spur-gear`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/internal-spur-gear-v1.md)。
|
||||
- **构造:**环坯 → 从内孔跨入材料的闭合渐开线齿槽 → Cut → 阵列齿槽特征。
|
||||
- **解决:**内/外齿公式混用、把外齿缩小放到环里、齿槽不连通、切穿外缘。
|
||||
- **检查/边界:**36–100 齿,`outerRadius>rootRadius>tipRadius>baseRadius>0` 等条件;内齿顶朝内、齿根朝外;区分 +X 齿中心和槽中心,检查实际齿廓与最薄轮缘。
|
||||
|
||||
### K03 外斜齿圆柱齿轮
|
||||
|
||||
- ID:`helical-cylindrical-gear`;版本 0.1.2;[原文](../knowledge/cad-parts/generation/candidates/helical-cylindrical-gear-v1-2.md)。
|
||||
- **构造:**开口扇区链在草图圆周阵列成完整闭合齿圈 → 轴线路径上 parallel sweep+twist → 再孔槽。
|
||||
- **解决:**单齿扭转后逐齿 Join 布尔缝失败、法向模数直接当端面模数、β 被直接当总 twist、根圆/基圆分支画错。
|
||||
- **检查/边界:**`mt=mn/cosβ`,总扭转 `b*tanβ/rp`;根圆小于/大于基圆有不同扇区;沿 Z 检查真实曲线相位、齿向和旋向,不能只看体积。
|
||||
|
||||
### K04 直齿齿条
|
||||
|
||||
- ID:`straight-rack`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/straight-rack-v1.md)。
|
||||
- **构造:**基座+伸入基座的梯形单齿 Join+线性特征阵列。
|
||||
- **解决:**误用圆齿轮渐开线、三角齿、齿底只相贴、阵列连基座一起复制、齿数多算一个。
|
||||
- **检查/边界:**p=πm、节线齿厚=p/2、压力角直线斜率、完整 N 齿/内部 N−1 槽、解析体积;用户指定总长时不能静默替换成 Np。
|
||||
|
||||
### K05 斜齿齿条
|
||||
|
||||
- ID:`helical-rack`;版本 0.1.1;[原文](../knowledge/cad-parts/generation/candidates/helical-rack-v1-1.md)。
|
||||
- **构造:**法向转端面参数 → 梯形齿 → 有横向位移的直线路径 parallel sweep → Join+直线阵列,不加 twist。
|
||||
- **解决:**把直齿条整体旋转当斜齿条、用扭转代替平移、XZ 符号错、端部齿被裁掉。
|
||||
- **检查/边界:**1–96 齿,0<|β|≤35°;ΔX=b*tanβ,样板长度 Npt+|ΔX| 不是用户总长的默认替代;检查实际斜齿线、工作面共面性和两端完整齿数。
|
||||
|
||||
### K06 ZA 圆柱蜗杆
|
||||
|
||||
- ID:`worm`;版本 0.1.1;[原文](../knowledge/cad-parts/generation/candidates/worm-za-v1-1.md)。
|
||||
- **构造:**延长芯轴+YZ 轴向梯形草图的 solid.coil Join → 多头特征圆周阵列 → 两端裁切。
|
||||
- **解决:**多头时仍用 πm 当导程、默认圆截面 coil 变弹簧、把梯形旋转成圆环、混用法向/轴向模数。
|
||||
- **检查/边界:**ZA、轴向压力角20°、1–4头;lead=sπm;核对实际轴向齿形、头数、端面、导程和旋向;不覆盖 ZI/ZN/ZK 或制造级包络蜗杆。
|
||||
|
||||
### K07 直齿锥齿轮
|
||||
|
||||
- ID:`straight-bevel-gear`;版本 0.1.1;[原文](../knowledge/cad-parts/generation/candidates/straight-bevel-gear-scaled-section-v1-1.md)。
|
||||
- **构造:**完整大端渐开线齿圈 → 沿轴线整体缩放扫掠 → 后切圆柱孔。
|
||||
- **解决:**母线齿宽直接当轴向高度、每齿独立布尔、大小端不共顶点、孔随齿圈缩放成锥孔。
|
||||
- **检查/边界:**18–40齿、锥半角20–65°、缩比0.45–0.9;H=b*cosδ;检查同源点共顶点、缩比及截面积积分体积;明确为缩放近似,不是制造级共轭齿面。
|
||||
|
||||
### K08 螺旋锥齿轮
|
||||
|
||||
- ID:`spiral-bevel-gear`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/spiral-bevel-gear-axial-twist-v1.md)。
|
||||
- **构造:**完整大端齿圈整体缩放+线性轴向 twist,轴线路径过齿圈中心。
|
||||
- **解决:**等径斜齿冒充锥齿、扫掠绕单齿中心自转、误称恒螺旋角、圆孔变锥孔。
|
||||
- **检查/边界:**中高齿线角5–35°,其余有锥齿域约束;检查 r(z) 与 phase(z),中高相位为总 twist 一半;不声称 Gleason/Klingelnberg 加工齿面或共轭制造模型。
|
||||
|
||||
### K09 示意蜗轮
|
||||
|
||||
- ID:`worm-wheel`;版本 0.1.2;[原文](../knowledge/cad-parts/generation/candidates/worm-wheel-toroidal-throat-illustration-v1-2.md)。
|
||||
- **构造:**有 1.5m 齿顶毛坯余量的完整齿圈整体扭转 → 独立 torus Cut 出环面凹喉部 → 再孔槽。
|
||||
- **解决:**普通斜齿改名蜗轮、只切中部不切两端、根部圆弧端点误抄导致草图断开、把 torus 半径当直径。
|
||||
- **检查/边界:**18–40齿,参考头数1–4;严格检查喉部定义域和全宽余量;采样环面方程及齿相位,体积按切喉后的截面积积分;仍是示意,不是配对蜗杆滚切包络。
|
||||
|
||||
### K10 平行轴外齿轮副
|
||||
|
||||
- ID:`gear-pair`;版本 0.2.0;[原文](../knowledge/cad-parts/generation/candidates/gear-pair-fixed-axis-v2.md)。
|
||||
- **补接口:**各轮另读单轮规程;a=r1+r2,斜齿两轮旋向相反,在同一轴向截面计算实际相位。
|
||||
- **解决:**相加齿顶半径算轴距、两轮默认零角度齿对齿、定位后绕世界原点旋转使轴心绕走。
|
||||
- **检查/边界:**相位满足 `z1(λ1−φ1)+z2(λ2−φ2)=180° mod 360°`;侧隙必须显式选择和报告,不能缩轮/改齿数躲穿透;静态无穿透不等于全程接触验证。
|
||||
|
||||
### K11 齿轮齿条机构
|
||||
|
||||
- ID:`rack-and-pinion`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/rack-and-pinion-straight-v1.md)。
|
||||
- **补接口:**轮心距节线 rp、两个独立实体、共模数/压力角/齿宽;齿条齿数奇偶决定中心接触初相位。
|
||||
- **解决:**轮心按齿顶半径定位、齿对齿、移动轮但孔留原点、两体误 Join。
|
||||
- **检查/边界:**运动按需再建 revolute/slider 和 rack_pinion;s=rp*θrad,明确 mm/deg 换算、实际方向和有限有效齿段。
|
||||
|
||||
### K12 蜗轮蜗杆机构
|
||||
|
||||
- ID:`worm-drive`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/worm-drive-illustrative-v1.md)。
|
||||
- **补接口:**蜗轮轴 Z,蜗杆轴 X,轴线正交但不相交,中心距 r1+r2;两件独立定位,Cut/Join 限定部件。
|
||||
- **解决:**“正交”误成轴线穿过同一中心、按 πm 而非头数导程算相位、把运动比正确当齿面正确。
|
||||
- **检查/边界:**参考单体是 ZA 蜗杆+示意蜗轮,局部干涉仍可能存在;运动比绝对值 n/z2,方向取决于轴向/旋向/安装侧,不以挪远零件宣称标准啮合。
|
||||
|
||||
### K13 行星齿轮机构
|
||||
|
||||
- ID:`planetary-gear-mechanism`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/planetary-gear-mechanism-straight-v1.md)。
|
||||
- **补接口:**太阳轮、行星轮、内齿圈、架分别建;`zr=zs+2zp`,等分装配 `(zs+zr)/n` 为整数,核对相邻行星和销轴间隙。
|
||||
- **解决:**只等分中心不计算每轮相位、销轴把行星轮一起 Join、把固定轴齿轮联动直接套给公转行星。
|
||||
- **检查/边界:**每轮本地建后按独立相位定位;Willis 关系 `zs(ωs−ωc)+zr(ωr−ωc)=0`;静态、运动比、干涉、接触各自验证。
|
||||
|
||||
### K14 球轴承
|
||||
|
||||
- ID:`ball-bearing`;版本 0.1.0;[原文](../knowledge/cad-parts/generation/candidates/ball-bearing-open-deep-groove-v1.md)。
|
||||
- **构造:**独立内/外圈 → 两圈 torus 滚道 → 独立球体阵列 → 带球窝薄环保持架。
|
||||
- **解决:**标准件 bearing 实际只是包络圆环,没有滚珠;用名称或遮盖解释缺球;把球和圈 Join;只搬套圈留下球。
|
||||
- **检查/边界:**N 球+两圈+保持架预期 N+3 个体;球数参数 unit="";检查球心节圆、轴向中面、间距、滚道/球窝/壁厚与改参。6202 的外形尺寸不证明球径/球数/内部结构为原厂值,默认结构是示意。
|
||||
|
||||
### K15 XZ 三角筋方向
|
||||
|
||||
- ID:`ribbed-bearing-housing`;版本 0.2.0;[原文](../knowledge/cad-parts/generation/candidates/xz-rib-orientation-risk-v2.md)。
|
||||
- **仅风险提示:**XZ 局部第二坐标对应世界 −Z;世界 (X,Z) 写成 [X,−Z];筋沿 Y 居中,offset=−t/2,挤出 t 并 Join 实际座体。
|
||||
- **解决:**把筋画到板下,出现不连接的多个 shell;后加筋堵座孔。
|
||||
- **边界:**不是完整轴承座教程;先筋再切座孔,检查筋与底板/支承均实际连通。
|
||||
|
||||
### K16 无槽连续人字齿
|
||||
|
||||
- ID:`herringbone-gear`;版本 0.1.1;[原文](../knowledge/cad-parts/generation/candidates/herringbone-continuous-v1-1.md)。
|
||||
- **构造:**完整下半截面扭转成 new 实体 → 关于中面镜像整个半体并 combine,不先造重合芯轴。
|
||||
- **解决:**两半同旋向、中面错半齿/有槽、预建根圆芯与扫掠体布尔失败、展开 φ±A(t) 符号写错。
|
||||
- **检查/边界:**18–30齿、|β|5–25°、G=0;两端同相、中面连续、相位导数反号、一个连通体;显式提供两侧 equation_curve 短 JSON 保留括号,不声称制造级中面过渡。
|
||||
|
||||
### K17 带中央槽双斜齿
|
||||
|
||||
- ID:`double-helical-gear`;版本 0.1.1;[原文](../knowledge/cad-parts/generation/candidates/double-helical-central-gap-v1-1.md)。
|
||||
- **构造:**下齿带整体扭转 new → 只从下带端面向中面接半槽根圆芯 → 整半体镜像合并。
|
||||
- **解决:**两件悬空斜齿冒充一件、槽中残齿、两边相位不对、整段重合芯布尔失败,以及方程曲线符号抄错。
|
||||
- **检查/边界:**0<G<W,每齿带宽 (W−G)/2;槽内仅连续 rootRadius 芯;体积是 S(W−G)+πrf²G 再扣孔,不能用 SW;不以带槽代替用户要的无槽人字齿。
|
||||
|
||||
### 这些规程共同包含的规范
|
||||
|
||||
- 尺寸来自需求或已声明假设,不把试验尺寸升级为默认规格。
|
||||
- 法向/端面/轴向模数、半径/直径、母线宽/轴向高、角度/弧度要分开。
|
||||
- 齿形、槽、孔、轮毂、轴承等必须是实际要求的结构,不用名称替代。
|
||||
- 参数公式要保存为原生表达式;选配结构只按用户需求加。
|
||||
- 最终几何验收优先于时间线名字、源草图外观或截图。
|
||||
- `model.edges.mid/length` 来自显示折线,不能一概当精确曲线内点/弧长;复杂齿侧使用实际曲线/曲面求值脚点并注明有限采样边界。
|
||||
- 原生参数可修改不等于全部依赖正确传播,修改关键参数后仍须重新验收。
|
||||
- 近似模型不能被宣称制造级共轭、接触、强度或公差认证。
|
||||
|
||||
## 6. 工具如何支撑这些规则,什么是硬检查
|
||||
|
||||
### 6.1 与建模直接相关的工具
|
||||
|
||||
| 工具 | 实际作用 | 不是它保证的内容 |
|
||||
| --- | --- | --- |
|
||||
| `list_commands` | 筛选/分页发现当前命令 | 查到了命令不等于当前参数可用 |
|
||||
| `describe_command` | 读取准确输入 Schema | 不负责判断需求该用什么建模策略 |
|
||||
| `inspect_design` | 参数、时间线、实体、草图和装配状态 | 不证明外形、尺寸或所有位置正确 |
|
||||
| `execute` | 单命令修改/查询,可带 expect | 返回 ok 不等于满足需求 |
|
||||
| `batch` | 顺序构建,默认失败回滚,支持合并参数重算 | expect 不匹配不会因此回滚;不是所有错误都可整批重放 |
|
||||
| `measure` | 体积、面积、bbox、COM,及指定几何项测量 | 体积相等不证明孔位、旋向或齿形相同 |
|
||||
| `body_topology` | 指定体边面、圆柱轴/半径/范围 | 全拓扑枚举不自动完成语义检查 |
|
||||
| `set_parameter` | 用户参数创建/修改与重建 | 不强制工程允许范围或整数性 |
|
||||
| `check_parameters` | 临时改参、测量/圆柱/错误报告并恢复 | 一组输入通过不等于全部参数域通过 |
|
||||
| `screenshot` | 多视图视觉观察 | 不代替精确尺寸、连通性、参数验证 |
|
||||
| `undo` | 撤销当前轮允许范围内修改 | 不能无限回退或代替状态核对 |
|
||||
| `skill_reference` | 读取注册技能文本 | 不执行附带 Python,不增加 shell 或文件权限 |
|
||||
| `knowledge_lookup` | 读取目录与实际知识 Markdown | 不替模型自动执行构造,不证明几何已合格 |
|
||||
|
||||
### 6.2 已有程序硬检查
|
||||
|
||||
- Java `CadAiTools.validateCall` 和 Python `Resources.validation_error` 检查工具名称/JSON Schema;浏览器与原生引擎还会做权限、命令及实际参数检查。
|
||||
- Java 补充校验 set_parameter 的 value/expression 别名、screenshot 的 view/camera 互斥、batch 不支持嵌套及部分工具步骤等。
|
||||
- `execute`/`batch` 的 **expect 是可选的测量断言**,可检查总 volume_mm3、实体数 bodies、bbox 和容差。真正比较在 `solidcraft-main/crates/mcp/src/tools.rs` 的 `Expect` / `with_expectation`。
|
||||
- expect 不符合会产生工具错误和 mismatch;**设计保持构建后的状态**,不能按普通失败想当然整批重做。
|
||||
- `check_parameters` 底层用 checkpoint 恢复;结果必须明确 restored,恢复失败为工具失败,不能无视。
|
||||
|
||||
### 6.3 目前主要靠模型遵循的要求
|
||||
|
||||
- 是否真的阅读了相关 Skill/规程。
|
||||
- 是否选对零件类型、近似层级和建模方法。
|
||||
- 是否把用户全部要求转换为验收项。
|
||||
- 是否给应参数化的位置保存了正确依赖。
|
||||
- 是否检查 dof、连通性、孔位、旋向、相位、壁厚、适用不等式。
|
||||
- 是否独立计算预期量、是否填写 expect、是否完成改参测试。
|
||||
- 是否正确解释 warning、有限采样与测量误差。
|
||||
|
||||
因此不能简单把“后端协议校验严格”理解成“后端有完整的自动建模质量判定”。已有引擎能力可以检查很多项目,但仍需发起准确查询并解释结果。
|
||||
|
||||
## 7. 哪些资料存在,但当前模型默认读不到
|
||||
|
||||
### 7.1 6 个完整族与 9 份共享特征
|
||||
|
||||
离线完整族:[安装板](../knowledge/cad-parts/references/families/mounting-plate.md)、[台阶轴](../knowledge/cad-parts/references/families/stepped-shaft.md)、[外六角头螺栓](../knowledge/cad-parts/references/families/hex-head-bolt.md)、[带轮毂/键槽外直齿轮](../knowledge/cad-parts/references/families/involute-spur-gear.md)、[带筋轴承座](../knowledge/cad-parts/references/families/ribbed-bearing-housing.md)、[带盖薄壁壳体](../knowledge/cad-parts/references/families/covered-thin-wall-enclosure.md)。有完整参数 Schema、尺寸语义、交叉约束、修改依赖和示例,但不在当前直读知识目录中。
|
||||
|
||||
9 份共享特征具体内容:
|
||||
|
||||
| 特征 | 有用的建模知识 |
|
||||
| --- | --- |
|
||||
| coaxial-steps | 共轴直线而非仅平行;独占段长的累计起点;台阶孔的深度基准 |
|
||||
| cover-interface | 盖/壳共用一套孔中心;两个独立零件;轴向 gap 与侧隙/公差分开 |
|
||||
| hex-head | 外六角与内六角不同;对边 s 对应外接半径 s/√3;验收实际对边 |
|
||||
| holes | 轴线/直径/起面/终止方式共同定义孔;通孔只穿指定件;孔系边距与间距 |
|
||||
| hub-keyway | 轮毂突出长与总长分开;键槽从孔腔切通;检查外角剩余材料 |
|
||||
| involute | 渐开线公式、齿厚角、基圆/根圆分支与径向简化 |
|
||||
| ribs | 筋的附着、方向、厚度和实际连通;先并结构再切通孔的意义 |
|
||||
| simplified-thread | 简化圆柱+语义标注不等于实体螺旋牙型;螺距与导程分开 |
|
||||
| thin-wall-boss | 底厚/壁厚独立;凸柱从内底起高;盲孔余底、局部壁厚与腔体 |
|
||||
|
||||
目录:[references/features](../knowledge/cad-parts/references/features/)。这些可以作为后续提炼新短规程的素材,不能据此宣称运行模型已获得全部能力。
|
||||
|
||||
### 7.2 运行目录之外的候选与旧机制
|
||||
|
||||
- candidates 目录当前有 **35 个 Markdown**,只有阅读目录指向的 17 个可经当前知识工具读取,其余 18 个是旧版本、基础样板规程或被替换的风险提示;完整名单在附录。
|
||||
- Java Maven 配置还会打包 candidates/archive 的 Markdown,但读取器仍只按阅读目录定位;“在 JAR 内”不等于模型有读取 ID。
|
||||
- Python 同步脚本只复制当前阅读目录里的 17 份正文。
|
||||
- `knowledge/cad-parts/SKILL.md` 是离线知识工具入口,不是运行时 19 个 makeCAD Skill 之一;其中 generation-context/experimental 等旧离线流程不能用来解释当前网页直读行为。
|
||||
- `generation/catalog.json`、`policy.json`、分类索引和旧正则路由测试不构成当前生产知识读取门槛。
|
||||
- 旧报告里的 approved/experimental/pilot/构建准入结论要结合时间和正文版本读;不能把历史部署开关当当前协议事实。
|
||||
|
||||
## 8. 目前看到的具体问题与优化机会
|
||||
|
||||
下表将源码可确认的问题与效果推测分开。建议项均尚未实施。
|
||||
|
||||
| 优先级 | 观察 | 对生成的可能影响 | 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| P0 | reporting/SKILL.md 第56行写拾取“没有距离限制”;modeling/SKILL.md 第40行写超过体尺寸5%会拒绝 | 同一套技能给不同拾取心智模型 | 用当前实际引擎行为更新旧叙述,并加行为回归;本次只确认文本冲突,未重新跑所有拾取情况 |
|
||||
| P0 | modeling/SKILL.md 第27行写 batch 失败修一步再发整批;工具实现的 expect 失败保留设计 | 把断言失败当回滚,造成重复结构 | 明确区分命令失败回滚、rollback=false、expect 失败未回滚、结果不确定;重试前读状态 |
|
||||
| P0 | editing/SKILL.md 第50行要求每个 warning=null;checking/modeling 又承认部分布尔 warning 在测量吻合时可接受 | 模型可能无意义反复修 warning,或误报失败 | 统一 warning 分级、需要的测量证据和允许交付条件 |
|
||||
| P0 | 规程/Skills 描述检查很多,但多数没有强制执行证据 | 模型跳过检查仍可用自然语言宣布完成 | 在建模计划/结果中列关键要求→检查方法→结果;优先用已有 expect、拓扑和改参工具,不只补一句“仔细检查” |
|
||||
| P1 | 常驻 workflow 明确列新建/编辑/检查/机构/报告,却没有单独 sheetmetal 触发项 | 钣金虽在目录但未必及时加载 | 在共享工作流补明确钣金触发与 base/rule/展开验收流程,保留全部原 Skill |
|
||||
| P1 | 全局要求每个草图 dof=0;钣金完整示例直接画矩形,没有展示尺寸约束和 solve 证据 | 示例与全约束目标不一致 | 实际检查该示例及参数变化,再让示例显式表达约束/solve;本报告没有把“未展示”直接判成几何失败 |
|
||||
| P1 | v1 直接展示知识摘要+明确反降级规则;v2 需先发现目录,未拼 Java 专用规则 | 可能漏读专用规程或退回圆环/圆柱占位 | 用同题记录实际知识读取与生成,必要时补短用途导引和反占位规则;不恢复关键词正则拒读 |
|
||||
| P1 | 人字齿、蜗轮等关键符号、单位转换、三角函数展开仍由 LLM 抄写 | 即使读到正文也可能造错或不能闭合 | 保留短的完整 JSON;对反复出错算法评估下沉已有引擎命令/确定性构造器,同时保留原生可编辑参数和同等验收 |
|
||||
| P1 | 通用 Skills 同时包含桌面、CLI、导出和网页示例 | 模型可能尝试当前宿主没有的能力 | 阅读入口明确宿主能力;可按任务分组展示说明,保持原 Skill 可访问,不因优化直接删除原集合 |
|
||||
| P1 | 大量历史资料描述旧17技能、旧查询审批和旧政策 | 优化时容易修改无效入口或照旧机制设计 | 给历史材料明确标注“非运行真源”;维护当前资源映射和生效链路 |
|
||||
| P2 | 当前专用知识明显集中齿传动,很多能力没有短规程 | 螺纹、复杂曲面、壳盖配合等可能仍靠通用推理 | 先找真实失败,再决定是否提炼螺纹、壳盖接口、槽孔/筋等短规程,不以分类数量为目标 |
|
||||
|
||||
尤其不要把“尚未证明稳定收益”等同“无用”,也不要重新用后端正则替模型决定自然语言类别。现有维护规范已经明确保留自主选文和用户需求优先。
|
||||
|
||||
## 9. 已有验证说明了什么
|
||||
|
||||
### 9.1 Skill 自身已有的回归
|
||||
|
||||
`solidcraft-main/crates/mcp/src/tests.rs` 包含:
|
||||
|
||||
- `skill_reference_example_builds_as_documented`:直接解析建模 reference 中的示例构造,核对尺寸相关几何及改参。
|
||||
- `sketch_plane_axes_match_the_skill_reference`:平面轴向约定。
|
||||
- `mechanisms_skill_example_moves_as_documented`:闭环执行器、联动和限位的解析预期。
|
||||
- `sheetmetal_skill_example_builds_as_documented`:分段翻边示例、体积与折弯表。
|
||||
- `skills_name_only_real_tools_and_commands`:扫描核心技能调用名,检查名称真实存在。**不是逐条完整 JSON Schema、语义、全部部署能力或 LLM 遵循率验证。**
|
||||
|
||||
checking 的独立 Python 测试还覆盖其脚本与行为陷阱。技能 README 明确它们使用 PATH 中 CLI,且不在该处所述 CI 中自动运行。此次没有执行这些几何测试,不能将“测试存在”报告为“本次通过”。
|
||||
|
||||
### 9.2 历史模型证据应如何看
|
||||
|
||||
- [外直齿首轮同版 A/B](../knowledge/cad-parts/reports/gear-integration-20261111/README.md):一对相同配置任务观察到 A 无实体、B 完整齿轮通过独立检查;是有限题目的质量收益,不是整体成功率或速度结论。
|
||||
- [齿传动逐类历史覆盖](../knowledge/cad-parts/reports/gear-family-expansion-20261112/CURRENT-COVERAGE.md):多个单体和齿条接口有有限通过样例;行星等保留失败/证据缺口。该页部分版本、读取机制说明已旧,当前正文以 reading-catalog 为准。
|
||||
- [五样板与两种人字齿](../knowledge/cad-parts/reports/five-samples-herringbone-20261112/README.md):五类有通过产物,副本关键改参5/5;正式两种人字齿没有通过。0.1.1 的符号澄清不能继承成“模型效果已通过”。
|
||||
- [球轴承报告](../knowledge/cad-parts/reports/ball-bearing-knowledge-20261112/README.md):native/WASM 的独立参考与改参有通过;当次正式模型选择/生成与收益未测,模型请求为0。
|
||||
|
||||
“15/15、21/21”等通常是同一产物的检查项数,不是独立生成次数;不能拿来计算成功率。旧路由几百例通过,也不能证明最终 CAD 建对。
|
||||
|
||||
## 10. 建议的下一轮优化顺序
|
||||
|
||||
### 第一阶段:先把明确冲突修齐
|
||||
|
||||
1. 统一边拾取、batch/expect 回滚、warning 处理三处规则。
|
||||
2. 给 workflow 补钣金明确触发;让示例显式支持参数化、solve 和检查要求。
|
||||
3. 对齐 v1/v2 中应一致的建模底线,例如实际轮齿/滚珠与占位包络的区别;保留各自宿主差异。
|
||||
4. 使用现有同步脚本确保三处资源一致。该阶段先不一口气改几何策略,便于判断效果来源。
|
||||
|
||||
### 第二阶段:把需求与验收对应起来
|
||||
|
||||
建议每个任务保留简短的、面向设计的记录:
|
||||
|
||||
```text
|
||||
目标件/组件及数量
|
||||
必须结构 / 明确不要的结构 / 可选结构
|
||||
驱动参数、单位、允许范围
|
||||
局部坐标与装配基准
|
||||
特征依赖和构造阶段
|
||||
关键几何预期:体积、bbox、孔轴/齿形/间隙/相位
|
||||
每项实际验证及未验证项
|
||||
改参测试值、传播结果、恢复结果
|
||||
```
|
||||
|
||||
这是一种拟议的建模质量记录,不是已有后端字段,也不建议再造另一套推理循环。能通过现有工具验证的要求,优先给出可执行检查。
|
||||
|
||||
### 第三阶段:集中解决“读了仍做错”的具体算法
|
||||
|
||||
优先候选:渐开线截面与角度换算、人字齿两臂同相和反向输运、蜗轮全宽毛坯余量、装配相位、局部到世界坐标。
|
||||
|
||||
先用当前引擎完成确定性参考与至少一组关键改参,再决定用更清楚的短调用还是增加原生命令。工具结果仍要可量测、可编辑,不用预制网格掩盖错误。任何新构造方法都需要同一组最终几何验收。
|
||||
|
||||
### 第四阶段:按失败位置评估,避免盲目扩写
|
||||
|
||||
| 失败发生在哪 | 应优先检查 |
|
||||
| --- | --- |
|
||||
| 没选到知识 | 工具是否可见、目录用途是否清楚、v1/v2 差异、任务表达;不先加长正文 |
|
||||
| 读了但单位/公式错 | 对照实际调用,缩小最易误抄的完整操作单元 |
|
||||
| 确定性参考也失败 | 公式、定义域、工具和内核策略;不是只调模型提示 |
|
||||
| 实体有了但结构/位置错 | 连通、孔轴、坐标变换、相位、必须结构和禁止结构 |
|
||||
| 默认值通过但改参失败 | 参数表达式、零尺寸、整数计数、拓扑引用和下游依赖 |
|
||||
| 只截图像、测量不对 | 独立解析预期、测量来源、实际曲面与必要局部检查 |
|
||||
| 服务异常无产物 | 独立记录系统故障,不冒充几何策略失败 |
|
||||
|
||||
正式评估固定模型/思考设置、共同提示、Skills、引擎、前后端和题目,一轮只改一个因素。保留第一次失败和补测,不人工修补被评分产物。分别记录完整任务通过、结构语义、尺寸/位置、参数传播、知识选择与正文送达、修复次数和时间。不能仅以文档变长/变短或一次生成更快判断质量。
|
||||
|
||||
## 11. 本次核对结果与边界
|
||||
|
||||
已执行:
|
||||
|
||||
```sh
|
||||
node ../solidcraft-main/scripts/sync-cad-ai-skills.mjs --check .
|
||||
python3 ../cad-ai-server/scripts/sync_resources.py --community . --cad ../solidcraft-main --check
|
||||
```
|
||||
|
||||
两项均通过:19 Skills、32 Skill 文件、17 知识正文。Skills 源文件、Java skills.json 与 Python 打包资源一致;17 份知识源文件与 Python 打包资源一致。Java 的 Maven 知识资源复制配置已核对,本次未构建或检查部署中的 JAR。
|
||||
|
||||
- Skills revision:`b9c715912afefe96fa839a749f804d42d86724b258a7e56c48c32d73c2ccbca1`。
|
||||
- Python 打包 knowledge revision:`85fe41e1250dea76e67f1e08e282aff5353713c561bf69b57005da7f2306d57b`。
|
||||
|
||||
本次新增这份梳理文档;没有改提示词、建模算法、测试源码、数据库、部署或用户模型。上述优化项是基于源码和历史证据的建议,需要后续独立实施与模型效果验证。
|
||||
|
||||
## 附录 A:19 个 Skill 全目录与 32 个文件
|
||||
|
||||
除前述 6 个直接相关 Skill 外,其余 13 个主要服务于开发维护。以下按名称排序保留完整清单;开发维护内容不等于生产建模模型应每题读取的知识。
|
||||
|
||||
| Skill | 类别 | 实际职责 | 打包文件 |
|
||||
| --- | --- | --- | --- |
|
||||
| [makecad-agent-tools](../../solidcraft-main/skills/makecad-agent-tools/SKILL.md) | 工具开发辅助 | 运行应用、控制通道、MCP工具与技能同步;不是新增零件构造法 | `SKILL.md` |
|
||||
| [makecad-checking](../../solidcraft-main/skills/makecad-checking/SKILL.md) | 核心建模 | 参数范围、全约束、无报错几何错误、离线STEP与回归 | `SKILL.md`<br>`reference/porting.md`<br>`scripts/compare_step.py`<br>`scripts/run.py`<br>`scripts/scb.py`<br>`scripts/tests/test_compare_step.py`<br>`scripts/tests/test_facts.py`<br>`scripts/tests/test_run.py`<br>`scripts/tests/test_scb.py`<br>`templates/test_design.py` |
|
||||
| [makecad-commands](../../solidcraft-main/skills/makecad-commands/SKILL.md) | 命令开发 | CommandSpec、Schema、命令入口和开发分层 | `SKILL.md` |
|
||||
| [makecad-contributing](../../solidcraft-main/skills/makecad-contributing/SKILL.md) | 贡献开发 | 选题、PR、验证、审查及协作流程 | `SKILL.md` |
|
||||
| [makecad-crash-safety](../../solidcraft-main/skills/makecad-crash-safety/SKILL.md) | 稳定性开发 | Rust错误处理、输入上限、崩溃与恢复;不是零件设计规范 | `SKILL.md` |
|
||||
| [makecad-editing](../../solidcraft-main/skills/makecad-editing/SKILL.md) | 核心建模 | 已有设计的参数修改、局部结构编辑与下游修复 | `SKILL.md` |
|
||||
| [makecad-file-formats](../../solidcraft-main/skills/makecad-file-formats/SKILL.md) | 格式开发 | 设计格式兼容、导入/导出与文件安全 | `SKILL.md` |
|
||||
| [makecad-ground-rules](../../solidcraft-main/skills/makecad-ground-rules/SKILL.md) | 工程规范 | 独立实现、许可、资源归属和产品命名 | `SKILL.md` |
|
||||
| [makecad-layers](../../solidcraft-main/skills/makecad-layers/SKILL.md) | 架构开发 | makeCAD与solidcore、内核与ops的职责边界 | `SKILL.md` |
|
||||
| [makecad-mechanisms](../../solidcraft-main/skills/makecad-mechanisms/SKILL.md) | 核心建模 | 组件、关节、固定、传动、闭环、碰撞和运动检查 | `SKILL.md`<br>`reference.md` |
|
||||
| [makecad-modeling](../../solidcraft-main/skills/makecad-modeling/SKILL.md) | 核心建模 | 新零件的几何规划、命令与参数化构建、阶段验收 | `SKILL.md`<br>`reference.md` |
|
||||
| [makecad-packaging](../../solidcraft-main/skills/makecad-packaging/SKILL.md) | 发布开发 | 构建、打包、版本、签名和发布产物 | `SKILL.md` |
|
||||
| [makecad-performance](../../solidcraft-main/skills/makecad-performance/SKILL.md) | 性能开发 | 不阻塞窗口、实际性能测量、WASM限制 | `SKILL.md` |
|
||||
| [makecad-preferences](../../solidcraft-main/skills/makecad-preferences/SKILL.md) | 产品开发 | 默认行为兼容和设置项 | `SKILL.md` |
|
||||
| [makecad-reporting](../../solidcraft-main/skills/makecad-reporting/SKILL.md) | 故障辅助 | 最小复现、期望/实际对照和错误报告 | `SKILL.md`<br>`reference/report-template.md` |
|
||||
| [makecad-sheetmetal](../../solidcraft-main/skills/makecad-sheetmetal/SKILL.md) | 核心建模 | 钣金规则、分段折弯、展开、自然语言推断和有限优化 | `SKILL.md`<br>`reference.md` |
|
||||
| [makecad-tests](../../solidcraft-main/skills/makecad-tests/SKILL.md) | 测试开发 | 测试放置、参考值来源、几何oracle、回归和CI | `SKILL.md` |
|
||||
| [makecad-ui](../../solidcraft-main/skills/makecad-ui/SKILL.md) | 界面开发 | 容器、控件、主题、相机和UI验证 | `SKILL.md` |
|
||||
| [makecad-ui-text](../../solidcraft-main/skills/makecad-ui-text/SKILL.md) | 文案开发 | 本地化目录、术语、消息与排序 | `SKILL.md` |
|
||||
|
||||
## 附录 B:不在当前阅读目录中的 18 个 candidates 文件
|
||||
|
||||
这些文件的存在不意味着当前模型能通过 knowledge_lookup 读取。分类为历史/未登记是基于当前目录,不重新判断其内容是否有用。
|
||||
|
||||
- [covered-enclosure-shared-interface-v1.md](../knowledge/cad-parts/generation/candidates/covered-enclosure-shared-interface-v1.md)
|
||||
- [double-helical-central-gap-v1.md](../knowledge/cad-parts/generation/candidates/double-helical-central-gap-v1.md)
|
||||
- [double-helical-gap-risk-v2.md](../knowledge/cad-parts/generation/candidates/double-helical-gap-risk-v2.md)
|
||||
- [gear-pair-fixed-axis-v1.md](../knowledge/cad-parts/generation/candidates/gear-pair-fixed-axis-v1.md)
|
||||
- [helical-cylindrical-gear-v1-1.md](../knowledge/cad-parts/generation/candidates/helical-cylindrical-gear-v1-1.md)
|
||||
- [helical-cylindrical-gear-v1.md](../knowledge/cad-parts/generation/candidates/helical-cylindrical-gear-v1.md)
|
||||
- [helical-rack-v1.md](../knowledge/cad-parts/generation/candidates/helical-rack-v1.md)
|
||||
- [herringbone-continuous-risk-v2.md](../knowledge/cad-parts/generation/candidates/herringbone-continuous-risk-v2.md)
|
||||
- [herringbone-continuous-v1.md](../knowledge/cad-parts/generation/candidates/herringbone-continuous-v1.md)
|
||||
- [hex-head-bolt-simplified-v1.md](../knowledge/cad-parts/generation/candidates/hex-head-bolt-simplified-v1.md)
|
||||
- [mounting-plate-through-holes-v1.md](../knowledge/cad-parts/generation/candidates/mounting-plate-through-holes-v1.md)
|
||||
- [ribbed-bearing-housing-y-bore-v1.md](../knowledge/cad-parts/generation/candidates/ribbed-bearing-housing-y-bore-v1.md)
|
||||
- [stepped-shaft-cumulative-v1.md](../knowledge/cad-parts/generation/candidates/stepped-shaft-cumulative-v1.md)
|
||||
- [straight-bevel-gear-scaled-section-v1.md](../knowledge/cad-parts/generation/candidates/straight-bevel-gear-scaled-section-v1.md)
|
||||
- [worm-wheel-risk-notes-v2.md](../knowledge/cad-parts/generation/candidates/worm-wheel-risk-notes-v2.md)
|
||||
- [worm-wheel-toroidal-throat-illustration-v1-1.md](../knowledge/cad-parts/generation/candidates/worm-wheel-toroidal-throat-illustration-v1-1.md)
|
||||
- [worm-wheel-toroidal-throat-illustration-v1.md](../knowledge/cad-parts/generation/candidates/worm-wheel-toroidal-throat-illustration-v1.md)
|
||||
- [worm-za-v1.md](../knowledge/cad-parts/generation/candidates/worm-za-v1.md)
|
||||
|
||||
## 附录 C:后续修改时的最短入口
|
||||
|
||||
| 要优化什么 | 优先修改位置 |
|
||||
| --- | --- |
|
||||
| 通用建模、坐标、阶段检查 | [agent-workflow.md](../../solidcraft-main/skills/agent-workflow.md)、[makecad-modeling/](../../solidcraft-main/skills/makecad-modeling/) |
|
||||
| 修改模型和局部修复 | [makecad-editing/](../../solidcraft-main/skills/makecad-editing/) |
|
||||
| 参数稳健性和验收 | [makecad-checking/](../../solidcraft-main/skills/makecad-checking/),以及实际引擎检查接口 |
|
||||
| 机构与运动 | [makecad-mechanisms/](../../solidcraft-main/skills/makecad-mechanisms/) |
|
||||
| 钣金 | [makecad-sheetmetal/](../../solidcraft-main/skills/makecad-sheetmetal/) |
|
||||
| 某类零件的具体错误 | [reading-catalog.json](../knowledge/cad-parts/generation/reading-catalog.json) 指向的正文 |
|
||||
| Java v1 常驻规则/工具描述 | [ArkCadAiClient.java](../vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/ArkCadAiClient.java)、[CadAiTools.java](../vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/CadAiTools.java)、[CadAiKnowledge.java](../vibemake-service/src/main/java/com/linkerbot/vibemake/service/cad/ai/CadAiKnowledge.java) |
|
||||
| Python v2 常驻规则/知识发现/读图研究 | [resources.py](../../cad-ai-server/src/cad_ai/resources.py)、[search.py](../../cad-ai-server/src/cad_ai/search.py) |
|
||||
| 易错几何算法确定性实现 | 先按 solidcraft-main 的 AGENTS.md 和 layers 规范定位引擎/solidcore-ops/内核职责 |
|
||||
@@ -41,6 +41,7 @@ CREATE TABLE project (
|
||||
model_parts_files JSON NOT NULL DEFAULT (JSON_ARRAY()) COMMENT '零件GLB文件清单,包含relativePath和sizeBytes',
|
||||
assembly_json_object_key VARCHAR(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL DEFAULT '' COMMENT '拼装步骤JSON环境相对路径,不含域名和环境根目录',
|
||||
assembly_json_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '拼装步骤JSON文件大小,单位字节',
|
||||
assembly_animation_status VARCHAR(16) NOT NULL DEFAULT 'UNPROCESSED' COMMENT '拼装动画制作状态 UNPROCESSED未处理 IN_PROGRESS进行中 COMPLETED已完成',
|
||||
walking_resources_prefix VARCHAR(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL DEFAULT '' COMMENT '行走资源环境相对目录,以斜杠开头和结尾',
|
||||
walking_resources_files JSON NOT NULL DEFAULT (JSON_ARRAY()) COMMENT '行走资源文件清单,包含relativePath和sizeBytes',
|
||||
project_type VARCHAR(64) NOT NULL COMMENT '配置中的项目类型编码',
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
# 开发环境更新记录(2026-11-19)
|
||||
|
||||
## 范围与版本
|
||||
|
||||
- 仅更新开发服务器 `39.105.93.138`,SSH 别名 `cad_ai_dev`,主机名 `lingmiaodongli`。
|
||||
- 发布编号:`20261119T085751Z`。已恢复对外访问。
|
||||
- 社区 API:`vibemake-api`,继续使用端口 `8993`。
|
||||
- 管理 API:`vibemake-adminapi`,继续使用端口 `8994`。
|
||||
- 管理前端:`https://dev-vibemake-admin.robotquan.com/`。
|
||||
- 接口入口:`https://dev-vibemake-api.robotquan.com`,分别使用 `/api` 和 `/admin-api`。
|
||||
- 本次未操作正式服务器 `101.200.225.61`,未更新 CAD 前端或 Python CAD 服务。
|
||||
|
||||
构建来自当前两个工作区的独立源码快照,包含当时未提交的修改,未使用旧的 `dist.zip`。社区仓库基准提交为 `6b96ca1eb042bad58521543dc6f1f5c0681cd6d9`,管理前端仓库基准提交为 `25acae2c8b32ebd3eb0b62fe4b1713dcdb7a1052`。发布目录中的两个 `*-source-manifest.json` 记录完整快照文件摘要;构建后已核对源文件未漂移。
|
||||
|
||||
## 本次变化
|
||||
|
||||
- 管理端增加拼装动画制作状态的展示、切换和筛选,状态为 `UNPROCESSED`、`IN_PROGRESS`、`COMPLETED`。
|
||||
- 管理 API 增加 `PUT /admin-api/projects/{projectCode}/assembly-animation-status`,项目列表接受 `assemblyAnimationStatus` 参数。
|
||||
- 两个 Java 应用一起更新,使用相同的新项目实体。其余当前工作区的已构建修改同时纳入此次发布。
|
||||
- 保留现有容器环境变量、端口、日志挂载、网络、重启策略及其他 HostConfig;凭据未输出到部署记录。
|
||||
- 基于原服务器镜像,仅替换应用 JAR;未在线升级 JDK、Docker、MySQL 或其他服务。
|
||||
- 静态资源先上传,入口 `index.html` 最后原子替换,旧的带摘要资源文件保留。
|
||||
- 切换期间对两个开发 API 路径临时返回 503,恢复后代理文件与备份逐字节一致;未永久变更反向代理或 CORS。
|
||||
|
||||
## 数据库变更
|
||||
|
||||
开发库 `community` 的实体字段已逐一核对,只有下列字段缺失。在备份数据库并停止两个旧 Java 服务后执行;未修改仓库内的 `.sql` 文件:
|
||||
|
||||
```sql
|
||||
ALTER TABLE project
|
||||
ADD COLUMN assembly_animation_status VARCHAR(16) NOT NULL DEFAULT 'UNPROCESSED'
|
||||
COMMENT '拼装动画制作状态 UNPROCESSED未处理 IN_PROGRESS进行中 COMPLETED已完成';
|
||||
```
|
||||
|
||||
更新后原有 111 个项目均为 `UNPROCESSED`。切换前后仓库状态均为 `IDLE=108`、`REVIEW=3`;迁移任务仍为 `SUCCEEDED/LINKED=4`、`FAILED/MIGRATING=3`,未重试或清理既有失败、待核对记录。没有执行全量历史迁移。
|
||||
|
||||
## 验证结果
|
||||
|
||||
- 使用 Homebrew JDK 21 完成 `mvn -B -ntp verify`,全部模块构建成功。764 项测试,750 项通过、14 项真实外部环境测试按配置跳过,无失败或错误。
|
||||
- 本地测试显式禁用真实 AI、OSS、Git 外部集成;测试类内的模拟功能测试按各自配置运行。这些参数没有覆盖服务器现有应用配置。
|
||||
- 首轮测试曾遇到一次 AI 搜索 SSE 用例事件为空;未修改代码,随后完整测试通过,最终发布基于成功的整轮构建。
|
||||
- 管理前端 `npm run build:dev` 成功,状态功能、环境地址、日期相关的 22 项 Playwright 测试全部通过。
|
||||
- 服务器两个新容器均正常运行、重启次数为 0,启动及验收时的应用标准输出日志未发现 ERROR。运行中 JAR 与本地产物 SHA-256 一致。
|
||||
- 公网管理首页 HTTP 200,HTML 摘要与本地新构建一致,部署的 22 个前端文件摘要全部一致。
|
||||
- 实际 Chromium 打开开发管理站,登录界面正常、新入口脚本已加载,无页面异常或本站静态资源错误。
|
||||
- 公网项目类型和项目列表均为 HTTP 200 / `OK`,验证了新实体在现有 MySQL 库上的读取。
|
||||
- 管理端匿名访问返回 HTTP 401 / `UNAUTHORIZED`。
|
||||
- 开发管理 Origin 的登录 POST、状态更新 PUT 预检均 HTTP 200,允许来源正确。
|
||||
- 运行中管理 API 的 OpenAPI 确认新状态 PUT 接口及列表筛选参数均已注册。
|
||||
- Python CAD API、worker 保持原启动时间,未重启。
|
||||
|
||||
未使用真实管理员密码登录,也未在现有业务项目上执行状态写入;状态保存、筛选、权限和旧元数据覆盖保护由隔离的后端及前端测试验证。
|
||||
|
||||
## 产物摘要
|
||||
|
||||
| 产物 | SHA-256 |
|
||||
| --- | --- |
|
||||
| `vibemake-api.jar` | `309565f62970082e27c585f40609a796dd14f13bede689b10ed02f0dbba84940` |
|
||||
| `vibemake-adminapi.jar` | `5e758ea3d1b711804e8971730798ca899a1e7d3613100cf6f65a8cc9e62f2b1d` |
|
||||
| 管理前端 `index.html` | `d32969a62483eb3ee371ed6f08abe2c07ceefae415699c0452f253b49e62d943` |
|
||||
|
||||
## 备份与回退
|
||||
|
||||
服务器发布目录:`/opt/vibemake-deploy/releases/20261119T085751Z`。
|
||||
|
||||
服务器备份目录:`/opt/vibemake-deploy/backups/20261119T085751Z`,根目录权限为 700,包含:
|
||||
|
||||
- 两次数据库备份:`community-before.mysql.gz`、`community-stopped.mysql.gz`,备份退出状态、压缩文件可读性、大小及摘要已验证。内容仅保存在服务器受保护目录。
|
||||
- 原容器完整配置 `containers.json`,包含敏感环境变量,禁止复制到 Git 或公开输出。
|
||||
- 原管理前端 `admin-dist.tar.gz` 及文件摘要。
|
||||
- 原开发域名配置及两个 API 代理文件。
|
||||
|
||||
旧容器保留为 `vibemake-api-backup-20261119T085751Z` 和 `vibemake-adminapi-backup-20261119T085751Z`。旧容器已停止,自动重启已关闭,避免主机重启时与当前版本争抢端口;当前新容器保持原来的 `always` 重启策略。
|
||||
|
||||
如确认需要回退应用,在核对没有新导入或写入任务后,执行以下命令。该命令是实际回退操作,未在本次验收中运行:
|
||||
|
||||
```bash
|
||||
ssh cad_ai_dev 'cd /opt/vibemake-deploy/releases/20261119T085751Z && python3 rollback_release.py'
|
||||
```
|
||||
|
||||
回退脚本会临时开启维护、恢复旧容器及其重启策略、恢复旧前端入口,再恢复代理。**保留新增字段及其数据,不自动回滚数据库或删除对象。** 如有正在运行的任务或未排空写入,先处理任务,不能强制回退。数据库备份只供必要时人工恢复,不应覆盖更新后产生的新业务数据。
|
||||
|
||||
服务器剩余磁盘约 6.3 GiB(使用率 91%),已保留此次回退所需镜像和容器,未执行全局清理。后续发布前需继续检查磁盘与内存余量。
|
||||
@@ -0,0 +1,85 @@
|
||||
# 正式环境发布记录(2026-11-19)
|
||||
|
||||
## 发布范围
|
||||
|
||||
- 服务器:`101.200.225.61`,SSH 别名 `lk_a`,主机名 `iZ2zeaflbjvw94civ7z5yhZ`。
|
||||
- 发布编号:`20261119T094355Z`;晋级自已验收的开发版本 `20261119T085751Z`。
|
||||
- 社区 API:`vibemake-api`,端口 `8993`。
|
||||
- 管理 API:`vibemake-adminapi`,端口 `8994`。
|
||||
- 管理前端:`https://vibemake-admin.robotquan.com/`。
|
||||
- 接口域名:`https://vibemake-api.robotquan.com`。
|
||||
- 静态目录:`/opt/1panel/www/sites/vibemake-admin.robotquan.com/index/dist`。
|
||||
|
||||
两个后端 JAR 直接复用开发环境通过全量构建和验收的产物,SHA-256 完全一致。管理前端使用同一份冻结源码执行 `npm run build:prod`,浏览器已确认请求正式 API。此次没有更新 CAD 前端、Python CAD API/worker 或开发服务器。
|
||||
|
||||
本次主要新增拼装动画制作状态的展示、切换和筛选,同时晋级开发环境已验收的其他当前源码改动。源码摘要位于发布目录的 `community-source-manifest.json`、`vibemake-admin-source-manifest.json`;版本来源见 `release.json`。
|
||||
|
||||
## 数据库与切换
|
||||
|
||||
正式业务库是 RDS 上的 `vibemake`。发布前已对照实体核对全部列,只有 `project.assembly_animation_status` 缺失。完成表结构和数据备份、暂停入口流量、确认无活跃任务并停止两个旧服务后,执行以下增量变更;未修改仓库 `.sql` 文件,也未执行全量历史 SQL:
|
||||
|
||||
```sql
|
||||
ALTER TABLE project
|
||||
ADD COLUMN assembly_animation_status VARCHAR(16) NOT NULL DEFAULT 'UNPROCESSED'
|
||||
COMMENT '拼装动画制作状态 UNPROCESSED未处理 IN_PROGRESS进行中 COMPLETED已完成';
|
||||
```
|
||||
|
||||
发布后已有 408 个项目的新增状态均为 `UNPROCESSED`。以下原有任务状态在切换前后相同,没有重试、删除或清空历史记录:
|
||||
|
||||
| 项目或任务 | 原状态及数量 |
|
||||
| --- | --- |
|
||||
| 项目仓库写入状态 | `IDLE=337`,`REVIEW=71` |
|
||||
| 导入任务 | `SUCCEEDED/LINKED=144`,`FAILED/MIGRATING=50`,`REVIEW/MIGRATING=7`,`REVIEW/VERIFYING=1`,`REVIEW/CLEANING=1`,`REVIEW/NORMALIZING=1` |
|
||||
| 普通仓库写入凭据 | `SUCCEEDED=335`,`NEEDS_REVIEW=7` |
|
||||
|
||||
两个新镜像分别基于正式服务器原有镜像,仅替换 JAR。保留正式环境的 `prod` profile、全部 Env、端口、日志挂载、实际 `1panel-network` 连接和重启策略。旧社区容器的 HostConfig.NetworkMode 为 bridge、实际网络为 1panel-network,已按实际配置完整保留。Docker 将旧配置中未设定的 `OomKillDisable=null` 规范化为默认的 `false`,验证时仅将这一等价表示视为一致。
|
||||
|
||||
切换期间只在正式 API 的两个现有代理块中临时返回 503,两个应用就绪并验收后恢复。恢复后的 `root.conf`、`admin.conf` 与发布前备份逐字节相同。原跨域配置已允许正式管理 Origin 的 POST 和 PUT,无永久代理或跨域改动。
|
||||
|
||||
前端资源先部署,`index.html` 最后原子替换,旧带摘要资源继续保留。Python CAD API/worker 的启动时间保持不变。
|
||||
|
||||
## 验证结果
|
||||
|
||||
- 继承开发环境的后端验证:764 项测试中 750 项通过、14 项外部环境测试跳过,失败和错误为 0;正式运行中 JAR 与这些已验证产物摘要一致。
|
||||
- 前端来自开发环境已通过 22 项浏览器测试的同一冻结源码,正式模式构建成功。
|
||||
- 两个正式新容器正常运行,重启次数均为 0,启动及验收时的应用日志未发现 ERROR。
|
||||
- 正式项目类型、项目列表请求均 HTTP 200 / `OK`,已验证新实体在正式 MySQL 库上的读取。
|
||||
- 管理端匿名请求及状态资源匿名请求均返回 HTTP 401。
|
||||
- 正式管理站 HTTP 200,入口 HTML 摘要与新构建一致,部署的 22 个前端文件摘要全部通过校验。
|
||||
- 真实 Chromium 加载正式管理站和新的 `index-DJBL3-Ou.js`,登录界面正常,无页面异常或本站静态资源错误。
|
||||
- 浏览器登录请求通过本地拦截验证,目标为 `https://vibemake-api.robotquan.com/admin-api/auth/login`;该检查没有向真实登录接口提交账号密码。
|
||||
- 真实公网登录 POST、状态更新 PUT 的 OPTIONS 预检均 HTTP 200,允许的 Origin 正确。
|
||||
- `prod` 配置及产物中关闭 OpenAPI/Swagger 的设置保持不变。
|
||||
|
||||
没有使用真实管理员凭据登录,也没有对现有项目执行状态保存。功能保存、筛选、权限及防旧元数据覆盖由开发版本的隔离测试覆盖。
|
||||
|
||||
## 产物摘要
|
||||
|
||||
| 产物 | SHA-256 |
|
||||
| --- | --- |
|
||||
| `vibemake-api.jar` | `309565f62970082e27c585f40609a796dd14f13bede689b10ed02f0dbba84940` |
|
||||
| `vibemake-adminapi.jar` | `5e758ea3d1b711804e8971730798ca899a1e7d3613100cf6f65a8cc9e62f2b1d` |
|
||||
| 正式管理前端 `index.html` | `52617e0a2153f4d872bf14c69b7e1e31a9f634bbccceafbc840a2ac315f6f646` |
|
||||
|
||||
## 备份与回退
|
||||
|
||||
服务器发布目录:`/opt/vibemake-deploy/releases/20261119T094355Z`。
|
||||
|
||||
服务器备份目录:`/opt/vibemake-deploy/backups/20261119T094355Z`,目录权限 700。保存发布前及停机后的两次 MySQL 表结构与数据备份、旧前端及其摘要、旧代理和站点配置、原容器完整配置。MySQL 备份命令成功退出,压缩文件完整可读并记录摘要,文件权限为 600。凭据只在服务器内存中读取,未写入部署命令参数或本文档;包含敏感 Env 的 `containers.json` 仅留在受保护的服务器目录,不得提交 Git。
|
||||
|
||||
本次保留的旧容器:
|
||||
|
||||
- `vibemake-api-backup-20261119T094355Z`
|
||||
- `vibemake-adminapi-backup-20261119T094355Z`
|
||||
|
||||
旧容器已停止并关闭自动重启,避免服务器重启时与当前版本争抢端口。当前新容器保留原有 `always` 重启策略。未执行 Docker 全局清理,也未删除其他历史容器。
|
||||
|
||||
如需要回退,先确认没有新导入、仓库写入等活跃任务,再执行以下实际回退命令;该命令未在发布验收中执行:
|
||||
|
||||
```bash
|
||||
ssh lk_a 'cd /opt/vibemake-deploy/releases/20261119T094355Z && python3 deploy_prod.py rollback'
|
||||
```
|
||||
|
||||
脚本先核对任务、开启维护并再次核对任务,然后恢复旧容器及其原重启策略、旧前端入口和代理。新增字段及其状态数据保留,不自动恢复数据库,不删除对象。数据库备份仅供必要时人工恢复,不得覆盖发布后产生的新业务数据。
|
||||
|
||||
服务器发布目录同时保留 `artifact-manifest.json`、`java-test-summary.json`、`verification.json`、`public-verification.json` 和 `browser-verification.json`,供后续追溯。
|
||||
@@ -1,6 +1,10 @@
|
||||
# CAD 零件知识库:当前交接
|
||||
|
||||
更新:2026-11-12。先读本文及[维护规范](MAINTENANCE.md),再核对实际文件、进程和队列。本文不注入生成模型。[精简前交接快照](../reports/utility-pruning-20261112/handoff-before-utility-v1.txt)保存此前发布和试验细节。
|
||||
更新:2026-11-13。先读本文及[维护规范](MAINTENANCE.md),再核对实际文件、进程和队列。本文不注入生成模型。[精简前交接快照](../reports/utility-pruning-20261112/handoff-before-utility-v1.txt)保存此前发布和试验细节。
|
||||
|
||||
## CAD助手模型配置(2026-11-13)
|
||||
|
||||
用户要求改为`gpt-6.1-sol`、极高`xhigh`。本机`.env`已切为`CAD_AI_PROVIDER=openai`、`CAD_AI_OPENAI_MODEL=gpt-6.1-sol`、`CAD_AI_OPENAI_REASONING_EFFORT=xhigh`,保留既有上游、密钥和其他配置。先确认生成全部结束,再于11:35(Asia/Shanghai)沿用下述球轴承冻结JAR重启共享8993,PID观察80050;JAR SHA仍为`80c647921b6c7a6298eb2d914bedffdc1b8c58b4fc1b997d57e6d267f56439b8`。上游最小流式ping工具调用通过;正式登录编辑器能力接口确认`openai/gpt-6.1-sol/xhigh`,65536输出、pilot知识模式、13工具及524288字节文本限制保持。前端、引擎、知识正文与原Skill/工具循环未改,独立8994未操作。本次CAD生成请求0,不重跑旧题,不声称新模型效果已验收。原页面有未保存设计,应先保存再刷新并新建对话。详见[切换核验](../reports/cad-model-switch-20261113/README.md)。
|
||||
|
||||
## 球轴承增量(2026-11-12,当前优先读)
|
||||
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
# CAD 助手模型切换(2026-11-13)
|
||||
|
||||
用户要求将 CAD 编辑器 AI 助手后端改为 `gpt-6.1-sol`,推理强度“极高”(`xhigh`)。本次仅修改本机 `.env` 的三项 CAD 配置:`CAD_AI_PROVIDER=doubao → openai`、`CAD_AI_OPENAI_MODEL=gpt-6.1-terra → gpt-6.1-sol`、`CAD_AI_OPENAI_REASONING_EFFORT=high → xhigh`。沿用既有上游地址和凭据,不改社区助手及其他服务配置。
|
||||
|
||||
## 实际发布
|
||||
|
||||
2026-11-13 11:35(Asia/Shanghai),先确认正式编辑器已完成当前轮生成,并逐请求核对当前进程日志(69次开始均已结束,包含连接关闭终态),再将8993从PID30800重启为PID80050。沿用球轴承发布的冻结JAR,SHA256为`80c647921b6c7a6298eb2d914bedffdc1b8c58b4fc1b997d57e6d267f56439b8`;没有重新打包,没有修改前端、引擎、知识正文、原17个通用Skill或工具循环。8091前端PID2522与独立8994后端PID65032未操作。PID只是本次观察值,后续操作前重核。
|
||||
|
||||
## 已证实的结果
|
||||
|
||||
- 现有上游一次最小流式Responses工具调用返回HTTP200和completed,返回模型`gpt-6.1-sol`、`reasoning.effort=xhigh`,ping函数名及空参数正确。本次连通性检查不传CAD设计或历史,不导出凭据。
|
||||
- 8993成功启动;正式8091编辑器复用正常登录会话,通过原`CadApi.aiCapabilities()`读取实际能力:`enabled=true`、`provider=openai`、`model=gpt-6.1-sol`、`reasoningEffort=xhigh`。输出上限65536、知识模式pilot、13个工具及524288字节文本上限保留。
|
||||
- 本次CAD生成请求0,未重跑历史模型试验,不据此声称几何质量或速度提高。公开官方模型文档本次未能取得有效内容;这里只确认当前已配置上游实际接受的模型名、强度和流式工具协议,不扩展推断其他接口能力。
|
||||
|
||||
非敏感核验字段见[verification.json](verification.json)。运行日志在本机`target/cad-model-switch-20261113/backend.log`,没有保存整份.env或登录状态。
|
||||
|
||||
## 使用与后续
|
||||
|
||||
原编辑器仍有尚未保存的设计,本次未刷新或改动设计。先保存,再刷新并开始新对话,避免携带豆包会话的旧推理历史。后续生成使用新配置;如另行开展效果对比,需独立版本并保留原失败。
|
||||
@@ -0,0 +1,83 @@
|
||||
{
|
||||
"changed_at": "2026-11-13T11:35:33.521400+08:00",
|
||||
"old_pid": 30800,
|
||||
"new_pid": 80050,
|
||||
"port": 8993,
|
||||
"jar": "/Users/lk/Projects/cad-generation-benchmark/experiments/ball-bearing-knowledge-20261112/backend-bearing-v1/vibemake-api-0.0.1-SNAPSHOT.jar",
|
||||
"jar_sha256": "80c647921b6c7a6298eb2d914bedffdc1b8c58b4fc1b997d57e6d267f56439b8",
|
||||
"provider": "openai",
|
||||
"model": "gpt-6.1-sol",
|
||||
"reasoning_effort": "xhigh",
|
||||
"idle_requests_verified": 69,
|
||||
"changes": [
|
||||
"CAD_AI_PROVIDER",
|
||||
"CAD_AI_OPENAI_MODEL",
|
||||
"CAD_AI_OPENAI_REASONING_EFFORT"
|
||||
],
|
||||
"frontend_rebuilt": false,
|
||||
"backend_rebuilt": false,
|
||||
"engine_rebuilt": false,
|
||||
"upstream_probe": {
|
||||
"checked_at": "2026-11-13T11:34:35.099994+08:00",
|
||||
"requested_model": "gpt-6.1-sol",
|
||||
"requested_reasoning_effort": "xhigh",
|
||||
"stream": true,
|
||||
"store": false,
|
||||
"cad_generation_requests": 0,
|
||||
"connectivity_requests": 1,
|
||||
"http_status": 200,
|
||||
"content_type": "text/event-stream",
|
||||
"event_counts": {
|
||||
"response.created": 1,
|
||||
"response.in_progress": 1,
|
||||
"response.output_item.added": 1,
|
||||
"response.function_call_arguments.delta": 1,
|
||||
"response.function_call_arguments.done": 1,
|
||||
"response.output_item.done": 1,
|
||||
"response.completed": 1
|
||||
},
|
||||
"response_status": "completed",
|
||||
"response_model": "gpt-6.1-sol",
|
||||
"response_reasoning": {
|
||||
"context": "all_turns",
|
||||
"effort": "xhigh",
|
||||
"mode": "standard",
|
||||
"summary": "detailed"
|
||||
},
|
||||
"usage": {
|
||||
"input_tokens": 18488,
|
||||
"input_tokens_details": {
|
||||
"cached_tokens": 0
|
||||
},
|
||||
"output_tokens": 14,
|
||||
"output_tokens_details": {
|
||||
"reasoning_tokens": 0
|
||||
},
|
||||
"total_tokens": 18502
|
||||
},
|
||||
"output_types": [
|
||||
"function_call"
|
||||
],
|
||||
"ping_call_valid": true,
|
||||
"encrypted_reasoning_present": false,
|
||||
"success": true,
|
||||
"duration_seconds": 4.22
|
||||
},
|
||||
"authenticated_capabilities": {
|
||||
"verified_at": "2026-11-13T11:38:56.866552+08:00",
|
||||
"source": "正式8091编辑器的既有登录会话,通过原CadApi.aiCapabilities读取;不导出登录状态或Token",
|
||||
"enabled": true,
|
||||
"provider": "openai",
|
||||
"model": "gpt-6.1-sol",
|
||||
"reasoningEffort": "xhigh",
|
||||
"maxOutputTokens": 65536,
|
||||
"knowledgeMode": "pilot",
|
||||
"toolCount": 13,
|
||||
"textBytes": 524288
|
||||
},
|
||||
"cad_generation_requests": 0,
|
||||
"endpoint_changed": false,
|
||||
"frontend_pid_unchanged": 2522,
|
||||
"independent_8994_pid_unchanged": 65032,
|
||||
"historical_results_modified": false
|
||||
}
|
||||
+9
@@ -39,6 +39,7 @@ public class AdminProjectController {
|
||||
@RequestParam(required = false) String publishStatus,
|
||||
@RequestParam(required = false) String repoStatus,
|
||||
@RequestParam(required = false) String moderationStatus,
|
||||
@RequestParam(required = false) String assemblyAnimationStatus,
|
||||
@RequestParam(defaultValue = "CREATED_AT_DESC") String sort) {
|
||||
return ApiResponse.success(
|
||||
management.projects(
|
||||
@@ -50,6 +51,7 @@ public class AdminProjectController {
|
||||
publishStatus,
|
||||
repoStatus,
|
||||
moderationStatus,
|
||||
assemblyAnimationStatus,
|
||||
sort));
|
||||
}
|
||||
|
||||
@@ -80,6 +82,13 @@ public class AdminProjectController {
|
||||
return ApiResponse.success(null);
|
||||
}
|
||||
|
||||
@PutMapping("/{projectCode}/assembly-animation-status")
|
||||
public ApiResponse<ManagedProjectView> assemblyAnimationStatus(
|
||||
@PathVariable String projectCode,
|
||||
@Valid @RequestBody AssemblyAnimationStatusInput input) {
|
||||
return ApiResponse.success(management.assemblyAnimationStatus(projectCode, input.status()));
|
||||
}
|
||||
|
||||
@GetMapping("/{projectCode}/tree")
|
||||
public ApiResponse<TreeView> tree(
|
||||
@PathVariable String projectCode,
|
||||
|
||||
+1
-1
@@ -53,6 +53,6 @@ public class AdminUserController {
|
||||
@RequestParam(defaultValue = "1") long page,
|
||||
@RequestParam(defaultValue = "20") long size) {
|
||||
return ApiResponse.success(
|
||||
service.projects(page, size, userCode, null, null, null, null, null, null));
|
||||
service.projects(page, size, userCode, null, null, null, null, null, null, null));
|
||||
}
|
||||
}
|
||||
|
||||
+101
@@ -365,6 +365,107 @@ class AdminWorkflowTest {
|
||||
request(signed(get("/admin-api/projects").param("sort", invalid)), 400);
|
||||
}
|
||||
|
||||
@Test
|
||||
void assemblyAnimationStatusDefaultsAndPersistsIndependentlyOfOtherMetadata() throws Exception {
|
||||
String code = createProject();
|
||||
String endpoint = "/admin-api/projects/" + code;
|
||||
JsonNode initial = request(signed(get(endpoint)), 200).path("data");
|
||||
assertThat(initial.path("assemblyAnimationStatus").asText()).isEqualTo("UNPROCESSED");
|
||||
com.fasterxml.jackson.databind.node.ObjectNode expectedProject = initial.path("project").deepCopy();
|
||||
expectedProject.remove("updatedAt");
|
||||
for (String status : List.of("IN_PROGRESS", "COMPLETED", "UNPROCESSED")) {
|
||||
JsonNode saved = request(signed(body(put(endpoint + "/assembly-animation-status"),
|
||||
Map.of("status", status))), 200).path("data");
|
||||
assertThat(saved.path("assemblyAnimationStatus").asText()).isEqualTo(status);
|
||||
com.fasterxml.jackson.databind.node.ObjectNode actualProject = saved.path("project").deepCopy();
|
||||
actualProject.remove("updatedAt");
|
||||
assertThat(actualProject).isEqualTo(expectedProject);
|
||||
assertThat(request(signed(get(endpoint)), 200).path("data")
|
||||
.path("assemblyAnimationStatus").asText()).isEqualTo(status);
|
||||
assertThat(jdbc.queryForObject("SELECT assembly_animation_status FROM project WHERE project_code=?",
|
||||
String.class, code)).isEqualTo(status);
|
||||
}
|
||||
jdbc.update("UPDATE project SET repo_status='CREATING' WHERE project_code=?", code);
|
||||
assertThat(request(signed(body(put(endpoint + "/assembly-animation-status"),
|
||||
Map.of("status", "IN_PROGRESS"))), 200).path("data")
|
||||
.path("assemblyAnimationStatus").asText()).isEqualTo("IN_PROGRESS");
|
||||
}
|
||||
|
||||
@Test
|
||||
void assemblyAnimationStatusSurvivesStaleMetadataUpdatesAndRepeatedRequests() throws Exception {
|
||||
String code = createProject();
|
||||
String endpoint = "/admin-api/projects/" + code;
|
||||
Project stale = projects.selectOne(new com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<Project>()
|
||||
.eq(Project::getProjectCode, code));
|
||||
JsonNode saved = request(signed(body(put(endpoint + "/assembly-animation-status"),
|
||||
Map.of("status", "COMPLETED"))), 200).path("data");
|
||||
JsonNode repeated = request(signed(body(put(endpoint + "/assembly-animation-status"),
|
||||
Map.of("status", "COMPLETED"))), 200).path("data");
|
||||
assertThat(repeated.path("project").path("updatedAt")).isEqualTo(saved.path("project").path("updatedAt"));
|
||||
stale.setName("其他业务更新的名称");
|
||||
assertThat(projects.updateById(stale)).isEqualTo(1);
|
||||
JsonNode current = request(signed(get(endpoint)), 200).path("data");
|
||||
assertThat(current.path("assemblyAnimationStatus").asText()).isEqualTo("COMPLETED");
|
||||
assertThat(current.path("project").path("name").asText()).isEqualTo("其他业务更新的名称");
|
||||
}
|
||||
|
||||
@Test
|
||||
void assemblyAnimationStatusFiltersBeforePaginationAndCombinesWithExistingFilters() throws Exception {
|
||||
String first = createProject();
|
||||
String second = createProject();
|
||||
String untouched = createProject();
|
||||
for (String code : List.of(first, second))
|
||||
request(signed(body(put("/admin-api/projects/" + code + "/assembly-animation-status"),
|
||||
Map.of("status", "COMPLETED"))), 200);
|
||||
Set<String> found = new HashSet<>();
|
||||
for (int page = 1; page <= 2; page++) {
|
||||
JsonNode data = request(signed(get("/admin-api/projects")
|
||||
.param("assemblyAnimationStatus", "COMPLETED").param("page", Integer.toString(page))
|
||||
.param("size", "1").param("sort", "PUBLISHED_AT_DESC")
|
||||
.param("type", "WHEELED").param("keyword", "测试")
|
||||
.param("repoStatus", "READY").param("publishStatus", "UNPUBLISHED")
|
||||
.param("moderationStatus", "NORMAL")), 200).path("data");
|
||||
assertThat(data.path("total").asLong()).isEqualTo(2);
|
||||
assertThat(data.path("items")).hasSize(1);
|
||||
JsonNode item = data.path("items").get(0);
|
||||
assertThat(item.path("assemblyAnimationStatus").asText()).isEqualTo("COMPLETED");
|
||||
found.add(item.path("project").path("projectCode").asText());
|
||||
}
|
||||
assertThat(found).containsExactlyInAnyOrder(first, second);
|
||||
JsonNode unprocessed = request(signed(get("/admin-api/projects")
|
||||
.param("assemblyAnimationStatus", "UNPROCESSED")), 200).path("data");
|
||||
assertThat(unprocessed.path("total").asLong()).isEqualTo(1);
|
||||
assertThat(unprocessed.path("items").get(0).path("project").path("projectCode").asText())
|
||||
.isEqualTo(untouched);
|
||||
assertThat(request(signed(get("/admin-api/projects").param("assemblyAnimationStatus", "IN_PROGRESS")), 200)
|
||||
.path("data").path("total").asLong()).isZero();
|
||||
assertThat(request(signed(get("/admin-api/projects")), 200).path("data").path("total").asLong())
|
||||
.isEqualTo(3);
|
||||
}
|
||||
|
||||
@Test
|
||||
void assemblyAnimationStatusRejectsInvalidValuesAndProtectsMissingOrDeletedProjects() throws Exception {
|
||||
String code = createProject();
|
||||
String endpoint = "/admin-api/projects/" + code + "/assembly-animation-status";
|
||||
for (String invalid : List.of("", " ", "unknown", "in_progress", "已完成")) {
|
||||
request(signed(body(put(endpoint), Map.of("status", invalid))), 400);
|
||||
request(signed(get("/admin-api/projects").param("assemblyAnimationStatus", invalid)), 400);
|
||||
}
|
||||
request(signed(body(put(endpoint), Map.of())), 400);
|
||||
request(signed(put(endpoint).contentType(MediaType.APPLICATION_JSON).content("{\"status\":null}")), 400);
|
||||
Map<String, String> input = Map.of("status", "COMPLETED");
|
||||
request(body(put(endpoint), input), 401);
|
||||
String ordinaryToken = tokens.issue(ordinary.getId(), ordinary.getSessionVersion());
|
||||
request(body(put(endpoint), input).header("Authorization", "Bearer " + ordinaryToken), 403);
|
||||
assertThat(request(signed(get("/admin-api/projects/" + code)), 200).path("data")
|
||||
.path("assemblyAnimationStatus").asText()).isEqualTo("UNPROCESSED");
|
||||
request(signed(body(put("/admin-api/projects/missing/assembly-animation-status"), input)), 404);
|
||||
request(signed(delete("/admin-api/projects/" + code)), 200);
|
||||
request(signed(body(put(endpoint), input)), 404);
|
||||
assertThat(request(signed(get("/admin-api/projects").param("assemblyAnimationStatus", "UNPROCESSED")), 200)
|
||||
.path("data").path("total").asLong()).isZero();
|
||||
}
|
||||
|
||||
private MockHttpServletRequestBuilder uploadRequest(String code, String sha) {
|
||||
return signed(multipart("/admin-api/projects/" + code + "/uploads/commit")
|
||||
.file(new MockMultipartFile("files", "sample.txt", "text/plain", "hello".getBytes()))
|
||||
|
||||
@@ -189,7 +189,7 @@ class CadAiTest {
|
||||
assertThat(body).doesNotContain("cad-test-placeholder", "apiKey", "endpoint", "SolidCraft");
|
||||
assertThat(json.readTree(body).path("data").path("tools")).anySatisfy(tool -> {
|
||||
assertThat(tool.path("name").asText()).isEqualTo("skill_reference");
|
||||
assertThat(tool.path("parameters").path("properties").path("skill").path("enum")).hasSize(17);
|
||||
assertThat(tool.path("parameters").path("properties").path("skill").path("enum")).hasSize(19);
|
||||
assertThat(tool.path("parameters").path("properties").path("file").path("default").asText()).isEqualTo("SKILL.md");
|
||||
});
|
||||
assertThat(json.readTree(body).path("data").has("id")).isFalse();
|
||||
|
||||
@@ -45,6 +45,9 @@ public final class AdminContracts {
|
||||
|
||||
public record ReasonInput(@NotBlank @Size(max = 500) String reason) {}
|
||||
|
||||
public record AssemblyAnimationStatusInput(
|
||||
@NotBlank @Pattern(regexp = "UNPROCESSED|IN_PROGRESS|COMPLETED") String status) {}
|
||||
|
||||
public record UserView(
|
||||
String userCode,
|
||||
String nickname,
|
||||
@@ -105,6 +108,7 @@ public final class AdminContracts {
|
||||
|
||||
public record ManagedProjectView(
|
||||
ProjectView project,
|
||||
String assemblyAnimationStatus,
|
||||
String moderationStatus,
|
||||
String moderationReason,
|
||||
boolean deleted) {}
|
||||
|
||||
@@ -28,6 +28,10 @@ public class Project extends BaseEntity {
|
||||
private String modelPartsFiles = "[]";
|
||||
private String assemblyJsonObjectKey = "";
|
||||
private Long assemblyJsonSizeBytes = 0L;
|
||||
// 仅由制作状态接口局部更新,避免其他业务持有的旧项目快照覆盖进度。
|
||||
@com.baomidou.mybatisplus.annotation.TableField(
|
||||
updateStrategy = com.baomidou.mybatisplus.annotation.FieldStrategy.NEVER)
|
||||
private String assemblyAnimationStatus = "UNPROCESSED";
|
||||
private String walkingResourcesPrefix = "";
|
||||
private String walkingResourcesFiles = "[]";
|
||||
private String projectType;
|
||||
|
||||
+33
-1
@@ -27,6 +27,8 @@ import java.util.Set;
|
||||
@RequiredArgsConstructor
|
||||
public class AdminManagementService {
|
||||
private static final Logger log = LoggerFactory.getLogger(AdminManagementService.class);
|
||||
private static final Set<String> ASSEMBLY_ANIMATION_STATUSES =
|
||||
Set.of("UNPROCESSED", "IN_PROGRESS", "COMPLETED");
|
||||
private final UserMapper users;
|
||||
private final ProjectMapper mapper;
|
||||
private final ProjectService projects;
|
||||
@@ -190,10 +192,13 @@ public class AdminManagementService {
|
||||
String publishStatus,
|
||||
String repoStatus,
|
||||
String moderationStatus,
|
||||
String assemblyAnimationStatus,
|
||||
String sort) {
|
||||
requireAdmin();
|
||||
ProjectSupport.pageCheck(page, size);
|
||||
checkKeyword(keyword);
|
||||
if (assemblyAnimationStatus != null && !ASSEMBLY_ANIMATION_STATUSES.contains(assemblyAnimationStatus))
|
||||
throw BusinessException.badRequest("拼装动画制作状态不合法");
|
||||
LambdaQueryWrapper<Project> query =
|
||||
ProjectSort.fromParameter(sort).query().eq(Project::getDeleted, false);
|
||||
query.select(Project.class, field -> !Set.of("urdfFiles", "modelPartsFiles", "walkingResourcesFiles")
|
||||
@@ -201,7 +206,8 @@ public class AdminManagementService {
|
||||
if (ownerCode != null) query.eq(Project::getOwnerUserId, user(ownerCode).getId());
|
||||
query.eq(type != null, Project::getProjectType, type)
|
||||
.eq(publishStatus != null, Project::getPublishStatus, publishStatus)
|
||||
.eq(repoStatus != null, Project::getRepoStatus, repoStatus);
|
||||
.eq(repoStatus != null, Project::getRepoStatus, repoStatus)
|
||||
.eq(assemblyAnimationStatus != null, Project::getAssemblyAnimationStatus, assemblyAnimationStatus);
|
||||
if (moderationStatus != null) {
|
||||
if (!Set.of("NORMAL", "BLOCKED").contains(moderationStatus))
|
||||
throw BusinessException.badRequest("治理状态不合法");
|
||||
@@ -222,6 +228,7 @@ public class AdminManagementService {
|
||||
managed.add(
|
||||
new AdminContracts.ManagedProjectView(
|
||||
views.get(index),
|
||||
project.getAssemblyAnimationStatus(),
|
||||
"BLOCKED".equals(project.getPublishStatus()) ? "BLOCKED" : "NORMAL",
|
||||
project.getModerationReason(),
|
||||
Boolean.TRUE.equals(project.getDeleted())));
|
||||
@@ -233,6 +240,7 @@ public class AdminManagementService {
|
||||
requireAdmin();
|
||||
return new AdminContracts.ManagedProjectView(
|
||||
projects.view(project, null),
|
||||
project.getAssemblyAnimationStatus(),
|
||||
"BLOCKED".equals(project.getPublishStatus()) ? "BLOCKED" : "NORMAL",
|
||||
project.getModerationReason(),
|
||||
Boolean.TRUE.equals(project.getDeleted()));
|
||||
@@ -248,6 +256,30 @@ public class AdminManagementService {
|
||||
return projects.create(owner.getId(), input.project());
|
||||
}
|
||||
|
||||
public AdminContracts.ManagedProjectView assemblyAnimationStatus(String code, String status) {
|
||||
requireAdmin();
|
||||
if (status == null || !ASSEMBLY_ANIMATION_STATUSES.contains(status))
|
||||
throw BusinessException.badRequest("拼装动画制作状态不合法");
|
||||
return locks.serial(
|
||||
code,
|
||||
() -> {
|
||||
Project project = projects.owner(0, code);
|
||||
if (status.equals(project.getAssemblyAnimationStatus())) return projectView(project);
|
||||
int updated = mapper.update(
|
||||
null,
|
||||
new LambdaUpdateWrapper<Project>()
|
||||
.eq(Project::getId, project.getId())
|
||||
.eq(Project::getDeleted, false)
|
||||
.set(Project::getAssemblyAnimationStatus, status)
|
||||
.set(Project::getUpdatedAt, ProjectSupport.now()));
|
||||
if (updated != 1) throw BusinessException.conflict("项目已变化,请刷新重试");
|
||||
log.info(
|
||||
"拼装动画制作状态修改 operatorUserCode={} projectCode={} previousStatus={} status={}",
|
||||
ProjectActors.admin().userCode(), code, project.getAssemblyAnimationStatus(), status);
|
||||
return projectView(projects.owner(0, code));
|
||||
});
|
||||
}
|
||||
|
||||
public void moderate(String code, boolean blocked, String reason) {
|
||||
requireAdmin();
|
||||
locks.serial(
|
||||
|
||||
File diff suppressed because one or more lines are too long
+1
-1
@@ -302,7 +302,7 @@ class ArkCadAiClientTest {
|
||||
}
|
||||
assertThat(received.get().path("tools")).anySatisfy(tool -> {
|
||||
assertThat(tool.path("name").asText()).isEqualTo("skill_reference");
|
||||
assertThat(tool.path("parameters").path("properties").path("skill").path("enum")).hasSize(17);
|
||||
assertThat(tool.path("parameters").path("properties").path("skill").path("enum")).hasSize(19);
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
+3
-3
@@ -13,13 +13,13 @@ import org.junit.jupiter.api.Test;
|
||||
class CadAiKnowledgeUtilityTest {
|
||||
private final ObjectMapper json = new ObjectMapper();
|
||||
|
||||
@Test void allSeventeenGenericSkillsRemainByteForByteOriginal() throws Exception {
|
||||
@Test void allNineteenGenericSkillsMatchTheCurrentSourceBundle() throws Exception {
|
||||
byte[] bytes;
|
||||
try (InputStream stream = getClass().getResourceAsStream("/cad/ai/skills.json")) { bytes = stream.readAllBytes(); }
|
||||
assertThat(HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(bytes)))
|
||||
.isEqualTo("026284eff26c8b4be1f7864219921a54828338973317c291f7e862b1cc452ef7");
|
||||
.isEqualTo("9d71ac78011b890c182e4ef28da15a52cc9714cc777f7fef2c806e63489a90a6");
|
||||
JsonNode bundle = json.readTree(bytes);
|
||||
assertThat(bundle.path("skills")).hasSize(17);
|
||||
assertThat(bundle.path("skills")).hasSize(19);
|
||||
String instructions = new CadAiTools(json).instructions();
|
||||
assertThat(instructions).startsWith(bundle.path("workflow").asText());
|
||||
for (JsonNode skill : bundle.path("skills"))
|
||||
|
||||
+2
-2
@@ -286,9 +286,9 @@ class CadAiProtocolTest {
|
||||
try (InputStream input = new ClassPathResource("cad/ai/skills.json").getInputStream()) {
|
||||
bundle = json.readTree(input);
|
||||
}
|
||||
assertThat(bundle.path("skills")).hasSize(17);
|
||||
assertThat(bundle.path("skills")).hasSize(19);
|
||||
CadAiTool definition = tools.definitions().stream().filter(tool -> "skill_reference".equals(tool.name())).findFirst().orElseThrow();
|
||||
assertThat(definition.parameters().path("properties").path("skill").path("enum")).hasSize(17);
|
||||
assertThat(definition.parameters().path("properties").path("skill").path("enum")).hasSize(19);
|
||||
assertThat(definition.parameters().path("properties").path("file").path("default").asText()).isEqualTo("SKILL.md");
|
||||
assertThat(tools.instructions()).contains(bundle.path("workflow").asText()).doesNotContain("SolidCraft");
|
||||
for (JsonNode skill : bundle.path("skills")) {
|
||||
|
||||
Reference in New Issue
Block a user