feat: drawing_create_standard_views — стандартные виды чертежа (API7)

Веха 2 (2D-ЧЕРТЁЖ), инкремент 1. Новый DrawingService (API7, namespace Kompas.Mcp.Core.Drawings): doc2d.ViewsAndLayersManager.Views.AddStandartViews( path, "#Спереди", {1,3,5}=front/top/left, x, y, scale, 20, 20). Новый DrawingTools (инструмент drawing_create_standard_views), регистрация в DI. Подтверждено спайком: object[]→SAFEARRAY VT_I4 ОК, 3 вида создаются (Count 1→4). Ревью Codex спека учтено: File.Exists+Length>0; created==3 строго; гарантия непустоты (сумма ObjectCount>0); опц. x,y (повторный вызов не стопкой); record DrawingViewsResult{Created,Total}. Точечный release RCW отклонён (v2-2). Валидация — чистый DrawingValidation (расширение .m3d/.a3d, scale>0). Тесты: +16 unit (DrawingValidation), +3 integration (DrawingTests: создание 3 видов, отклонение не-чертежа, несуществующий файл). Итого 114 unit + 61 integration = 175. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 14:30:25 +03:00
parent 46648f7635
commit de063290f4
8 changed files with 318 additions and 1 deletions
@@ -0,0 +1,91 @@
+using System.Runtime.Versioning;
+using Kompas.Mcp.Core.Threading;
+using Kompas6Constants;
+using KompasAPI7;
+
+namespace Kompas.Mcp.Core.Drawings;
+
+/// <summary>
+/// Операции с 2D-чертежами через API7 (<c>IViews</c>). Все вызовы — на STA-потоке
+/// <see cref="KompasDispatcher"/>.
+/// </summary>
+[SupportedOSPlatform("windows")]
+public sealed class DrawingService
+{
+    private readonly KompasSession _session;
+    private readonly KompasDispatcher _dispatcher;
+
+    public DrawingService(KompasSession session, KompasDispatcher dispatcher)
+    {
+        _session = session ?? throw new ArgumentNullException(nameof(session));
+        _dispatcher = dispatcher ?? throw new ArgumentNullException(nameof(dispatcher));
+    }
+
+    /// <summary>
+    /// Создать на активном чертеже стандартные ассоциативные виды (спереди/сверху/слева) сохранённой
+    /// 3D-модели <paramref name="partFilePath"/> (.m3d/.a3d). Главный вид привязывается к точке
+    /// (<paramref name="x"/>,<paramref name="y"/>) листа, мм; масштаб — <paramref name="scale"/>.
+    /// </summary>
+    public Task<DrawingViewsResult> CreateStandardViewsAsync(string partFilePath, double scale,
+        double x, double y, CancellationToken ct = default)
+        => _dispatcher.InvokeAsync(() => CreateStandardViewsCore(partFilePath, scale, x, y), ct);
+
+    // Стандартная тройка проекций: ksPtFront=1, ksPtUp=3, ksPtLeft=5 (ksRelativeProjectionTypeEnum).
+    private static readonly object[] StandardProjections = { 1, 3, 5 };
+    private const int ExpectedCreated = 3;
+    private const double GapMm = 20; // зазоры между видами (DX=DY)
+
+    private DrawingViewsResult CreateStandardViewsCore(string partFilePath, double scale, double x, double y)
+    {
+        var path = DrawingValidation.NormalizeModelPath(partFilePath);
+        DrawingValidation.RequireScale(scale);
+        if (!double.IsFinite(x) || !double.IsFinite(y))
+            throw new ArgumentException("Координаты привязки вида должны быть конечными числами.");
+        if (!File.Exists(path))
+            throw new FileNotFoundException($"Файл модели не найден: {path}", path);
+        if (new FileInfo(path).Length == 0)
+            throw new InvalidOperationException($"Файл модели пуст (не сохранён?): {path}");
+
+        var views = RequireActiveDrawingViews();
+        var before = views.Count;
+
+        if (!views.AddStandartViews(path, "#Спереди", StandardProjections, x, y, scale, GapMm, GapMm))
+            throw new InvalidOperationException(
+                $"AddStandartViews вернул FALSE — виды не созданы (файл модели или проекция недоступны): {path}");
+
+        var created = views.Count - before;
+        if (created != ExpectedCreated)
+            throw new InvalidOperationException(
+                $"Ожидалось {ExpectedCreated} вида, создано {created} (было {before}, стало {views.Count}).");
+
+        // Гарантия непустоты: у спроецированных видов должна быть геометрия (иначе модель не
+        // спроецировалась — пустые виды). Системный вид #0 имеет ObjectCount 0, поэтому суммируем.
+        if (TotalObjectCount(views) <= 0)
+            throw new InvalidOperationException(
+                "Стандартные виды созданы, но пусты (модель не спроецировалась). Проверьте файл модели.");
+
+        return new DrawingViewsResult { Created = created, Total = views.Count };
+    }
+
+    private IViews RequireActiveDrawingViews()
+    {
+        var doc = _session.Application.ActiveDocument
+            ?? throw new InvalidOperationException("Нет активного документа. Создайте чертёж: document_create drawing.");
+        if (doc.DocumentType != DocumentTypeEnum.ksDocumentDrawing)
+            throw new InvalidOperationException(
+                $"Активный документ не является чертежом (тип: {doc.DocumentType}). Создайте чертёж: document_create drawing.");
+        if (doc is not IKompasDocument2D doc2d)
+            throw new InvalidOperationException("Активный документ не приводится к IKompasDocument2D.");
+        return doc2d.ViewsAndLayersManager?.Views
+            ?? throw new InvalidOperationException("Не удалось получить коллекцию видов чертежа.");
+    }
+
+    private static int TotalObjectCount(IViews views)
+    {
+        int sum = 0;
+        foreach (var o in views)
+            if (o is IView v)
+                sum += v.ObjectCount;
+        return sum;
+    }
+}
@@ -0,0 +1,35 @@
+namespace Kompas.Mcp.Core.Drawings;
+
+/// <summary>Чистые валидаторы операций чертежа (без COM) — выделены для unit-тестов.</summary>
+public static class DrawingValidation
+{
+    /// <summary>Допустимые расширения файла-источника модели: деталь (.m3d) и сборка (.a3d).</summary>
+    private static readonly HashSet<string> AllowedExtensions =
+        new(StringComparer.OrdinalIgnoreCase) { ".m3d", ".a3d" };
+
+    /// <summary>
+    /// Нормализовать путь к файлу 3D-модели: обрезать пробелы, проверить непустоту и расширение
+    /// (.m3d/.a3d), вернуть абсолютный путь. Существование файла НЕ проверяет (это делает сервис).
+    /// </summary>
+    public static string NormalizeModelPath(string? path)
+    {
+        if (string.IsNullOrWhiteSpace(path))
+            throw new ArgumentException("Путь к файлу модели не задан.", nameof(path));
+
+        var trimmed = path.Trim();
+        var ext = Path.GetExtension(trimmed);
+        if (!AllowedExtensions.Contains(ext))
+            throw new ArgumentException(
+                $"Недопустимое расширение файла модели '{ext}'. Ожидается .m3d (деталь) или .a3d (сборка).",
+                nameof(path));
+
+        return Path.GetFullPath(trimmed);
+    }
+
+    /// <summary>Проверить масштаб чертежа: конечный и строго положительный.</summary>
+    public static void RequireScale(double scale)
+    {
+        if (!double.IsFinite(scale) || scale <= 0)
+            throw new ArgumentOutOfRangeException(nameof(scale), "Масштаб должен быть конечным и > 0.");
+    }
+}
@@ -0,0 +1,11 @@
+namespace Kompas.Mcp.Core.Drawings;
+
+/// <summary>Результат создания стандартных видов на чертеже.</summary>
+public sealed record DrawingViewsResult
+{
+    /// <summary>Сколько видов создано этим вызовом.</summary>
+    public required int Created { get; init; }
+
+    /// <summary>Общее число видов на чертеже после операции (включая системный вид).</summary>
+    public required int Total { get; init; }
+}
@@ -2,6 +2,7 @@ using Kompas.Mcp.Core;
 using Kompas.Mcp.Core.Assemblies;
 using Kompas.Mcp.Core.Conversion;
 using Kompas.Mcp.Core.Documents;
+using Kompas.Mcp.Core.Drawings;
 using Kompas.Mcp.Core.Editing;
 using Kompas.Mcp.Core.Modeling;
 using Kompas.Mcp.Core.Query;
@@ -25,6 +26,7 @@ builder.Services.AddSingleton<DocumentService>();
 builder.Services.AddSingleton<PartModeler>();
 builder.Services.AddSingleton<HoleService>();
 builder.Services.AddSingleton<AssemblyService>();
+builder.Services.AddSingleton<DrawingService>();
 builder.Services.AddSingleton<VariableService>();
 builder.Services.AddSingleton<SnapshotService>();
 builder.Services.AddSingleton<QueryService>();
@@ -0,0 +1,28 @@
+using System.ComponentModel;
+using Kompas.Mcp.Core;
+using Kompas.Mcp.Core.Drawings;
+using ModelContextProtocol.Server;
+
+namespace Kompas.Mcp.Host.Tools;
+
+/// <summary>Инструменты 2D-чертежа (виды, оформление).</summary>
+[McpServerToolType]
+public sealed class DrawingTools(KompasSession session, DrawingService drawing)
+{
+    [McpServerTool(Name = "drawing_create_standard_views")]
+    [Description("На активном чертеже создать стандартные ассоциативные виды (спереди, сверху, слева) " +
+        "сохранённой 3D-модели (.m3d деталь / .a3d сборка). Активный документ должен быть чертежом " +
+        "(document_create drawing); модель должна быть сохранена в файл (document_save_as). " +
+        "scale — масштаб (1.0 = 1:1); x,y — точка привязки главного вида на листе (мм). " +
+        "Возвращает число созданных видов.")]
+    public async Task<string> CreateStandardViews(
+        [Description("Путь к файлу 3D-модели (.m3d/.a3d)")] string partFilePath,
+        [Description("Масштаб видов (1.0 = 1:1)")] double scale = 1.0,
+        [Description("X привязки главного вида на листе, мм")] double x = 100,
+        [Description("Y привязки главного вида на листе, мм")] double y = 150)
+    {
+        await session.ConnectAsync();
+        var r = await drawing.CreateStandardViewsAsync(partFilePath, scale, x, y);
+        return $"Создано {r.Created} стандартных вида на чертеже (всего видов: {r.Total}, масштаб {scale}).";
+    }
+}