思考:

Laying out the plan

I'm mapping out a detailed remote control system for PDMS 12.1 SP4, covering architecture, technology options, component details, and operational steps.

Pinpointing project specifics

I'm detailing the technology stack, threading model, communication protocols, API design, data models, error handling, build/instructions, security, workflow, monitoring, and the timeline for development.Laying out the plan

I'm mapping out a detailed remote control system for PDMS 12.1 SP4, covering architecture, technology options, component details, and operational steps.

Pinpointing project specifics

I'm detailing the technology stack, threading model, communication protocols, API design, data models, error handling, build/instructions, security, workflow, monitoring, and the timeline for development.Laying out the plan

I'm mapping out a detailed remote control system for PDMS 12.1 SP4, covering architecture, technology options, component details, and operational steps.

Pinpointing project specifics

I'm detailing the technology stack, threading model, communication protocols, API design, data models, error handling, build/instructions, security, workflow, monitoring, and the timeline for development.

Reasoned for 4m 31s

回答

下面是一份可直接交给 PDMS 技术团队实施的 “单前端 → 单 PDMS 12.1 SP4 会话远程操控” 完整方案。内容包括总体目标、技术选型、详细架构、接口规范、关键代码骨架、开发与部署步骤、性能与运维要点，以及里程碑计划。

---

1. 项目目标与边界

项目维度	约束 / 目标
软件版本	AVEVA PDMS 12.1 SP4（32‑bit）
并发模型	仅一个前端客户端控制一个 PDMS 会话，无多用户并发
模型规模	可能包含千万级元件，单次统计／导出任务可持续数十分钟
技术栈硬性限制	PDMS 仅支持 .NET 3.5 x86，高版本框架或 64‑bit DLL 将被拒载 CSDN Blog
性能目标	- 交互命令（< 1 s） - 中型任务（1‑30 s）有进度回报 - 大任务可后台执行，前端可轮询进度
安全范围	初期仅限局域网；外网访问通过反向代理 + VPN 后续加固

---

2. 技术选型概览

层次	选型	说明
通讯协议	HTTP/1.1 + JSON/MessagePack（默认） 可选 gRPC‑C 核心库（二期）	HttpListener 属于 BCL，.NET 2.0 起即内置，完全兼容 .NET 3.5 Microsoft Learn
自托管服务器	System.Net.HttpListener（端口 9001，仅监听 localhost）
PDMS 插件框架	IAddin 接口（须编译为 .NET 3.5 / x86 DLL） CSDN Blog
线程隔离	HttpThread → 安全队列 → PDMS 主线程 （队列用 Queue<T> + lock 自行封装，.NET 3.5 无 ConcurrentQueue）
序列化	- 轻量：System.Web.Script.Serialization（内置） - 高性能：MsgPack‑CLI 0.5.x（支持 .NET 3.5）
日志	log4net 1.2.17（支持 .NET 2.0+）
大任务调度	简易 TaskTable 持久化为 SQLite 文件，支持重启后恢复进度
前端	任意：Web/Qt/WPF。只需按 REST 协议调用即可。

---

3. 系统架构与流程

graph LR
A[前端 UI (浏览器/桌面)] -- HTTP --> B(HttpListener <br>PDMS Agent DLL)
B -- 入队 --> C[安全队列]
C -- 脱队 --> D{PDMS 主线程<br>Idle/CAF Command}
D --> E[PDMS API 调用]
D -- 进度/结果 --> B
B -- HTTP Response --> A

3.1 关键流程

1. 监听：Agent 在 Start() 中启动 HttpListener，仅允许 http://localhost:9001/。
2. 入队：收到请求后解析为 ICommand 对象写入 SafeQueue，立即返回 202 Accepted + taskId，前端开始轮询 /task/{id}。
3. 执行：主线程在 Application.Idle（或 CAF Command) 下轮询 SafeQueue，顺序执行命令并周期性写入进度。
4. 结果流式返回：长列表接口（如统计）使用 分页或流式分块，每<EFBFBD> GZip 后 Base64 传输，减少内存峰值。

---

4. API 设计（首批 6 个端点）

方法	路径	说明	返回
GET	/health	进程存活检测 + 空闲内存	{status:"OK", memMB:1234}
POST	/command	下达即刻命令（<1 s）	{code:0,data:"OK"}
POST	/task	启动长任务，返回 taskId	{taskId:"abc123"}
GET	/task/{id}	查询任务进度	{percent:42,state:"RUNNING"}
GET	/stats	流式统计接口，支持 queryExpr, props[]	application/octet-stream(分块)
POST	/export/ifc	导出 IFC/RVM/CSV	{downloadUrl:".../ifc.zip"}

统一响应封装：

{ "code": 0, "msg": "成功", "data": {...} }

错误码表放在 ErrorCodes.cs，与 CLAUDE.md 中的 ApiResponse<T> 结构保持一致。

---

5. 代码骨架（精简示例）

// AgentAddin.cs  (.NET 3.5, x86)
[Addin("HttpAgent", Description="PDMS REST Control")]
public class HttpAgentAddin : IAddin
{
    private HttpServer _server;
    public string Description => "PDMS REST Agent";
    public string Name => "HttpAgent";
    public void Start(ServiceManager sm)
    {
        SafeQueue.Init();                   // 全局单例
        _server = new HttpServer(9001);     // 见下
        _server.Start();
        Application.Idle += OnIdle;         // CAF 中同理
    }
    public void Stop() { _server.Dispose(); }

    void OnIdle(object sender, EventArgs e)
    {
        while (SafeQueue.TryDequeue(out ICommand cmd))
        {
            cmd.Execute();                  // 必须保证只在主线程调用 PDMS API
        }
    }
}

// HttpServer.cs
class HttpServer : IDisposable
{
    readonly HttpListener _l = new HttpListener();
    public HttpServer(int port)
    {
        _l.Prefixes.Add($"http://localhost:{port}/");
    }
    public void Start()
    {
        _l.Start();
        _l.BeginGetContext(BeginContext, null);
    }
    void BeginContext(IAsyncResult ar)
    {
        var ctx = _l.EndGetContext(ar);
        _l.BeginGetContext(BeginContext, null); // 继续监听

        ICommand cmd = CmdFactory.Parse(ctx);   // JSON => ICommand
        SafeQueue.Enqueue(cmd);

        ctx.Response.StatusCode = 202;
        ctx.Response.Close();
    }
    public void Dispose() => _l.Close();
}

// SafeQueue.cs (简易线程安全队列 .NET 3.5)
static class SafeQueue
{
    static readonly Queue<ICommand> _q = new Queue<ICommand>();
    static readonly object _sync = new object();
    public static void Enqueue(ICommand c) { lock(_sync) _q.Enqueue(c); }
    public static bool TryDequeue(out ICommand c)
    { lock(_sync){ if(_q.Count>0){ c=_q.Dequeue(); return true; } } c=null; return false; }
}

重点注意

• 严禁在 HttpListener 线程直接操作 PDMS API；否则 UI 会冻结甚至崩溃。
• 如需长任务取消，可在 ICommand 中实现 CancellationToken 并于主线程检查。

---

6. 大模型性能优化清单

类别	操作	说明
内存	链接 /LARGEADDRESSAWARE；Win 64‑bit 系统上可让进程地址空间上限从 2 GB 提升到 3 GB (/3GB) Microsoft Learn
分区遍历	让前端传 ZONE / GROUP，内部执行 QUERY /*；尽量避免 .NET 侧逐件遍历。
流式返回	统计接口按 1 000 条一批序列化 → GZip → Base64；前端 ReadableStream 逐块解析并渲染。
后台导出	pdms.exe /BATCH macro.pml 子进程执行 IFC/ISO 批导出，主会话实时返回进度。
资源释放	每批次后执行 GC.Collect() + Utilities.Application.DoEvents()；如内存 > 1.6 GB 发出重启警告。

---

7. 开发与部署步骤

阶段	任务	负责人	预计耗<EFBFBD>
环境准备	安装 VS2013 + .NET 3.5 SP1、PDMS 12.1 SP4 开发版	运维	1 d
Skeleton	创建 AgentAddin、SafeQueue、ICommand 抽象、HttpServer	开发	3 d
核心命令	HealthCmd / ExecCmd / StatsCmd / ExportCmd	开发	5 d
前端 Demo	简易 Web 页面（Vue/React 任选）+ 轮询 Task API	前端	3 d
任务管理	TaskTable + 进度轮询接口	开发	2 d
日志/异常	log4net 文件分卷、全局异常捕获	开发	1 d
单元测试	NUnit + MockPDMS（可选）	QA	3 d
性能测试	典型大模型脚本（≥500 MB MDB）	QA	2 d
文档交付	API Swagger JSON + 部署手册	技术写作	2 d
上线	复制 DLL → PDMS 根目录，修改 DesignAddin.xml；放行 9001 端口（仅 127.0.0.1）	运维	0.5 d

总工期预估：约 3 周（15 人/日）。

---

8. 交付物清单

1. HttpAgent.dll （PDMS 插件，x86, .NET 3.5）
2. AgentConfig.xml（端口、日志路径、最大批大小等可配置）
3. 前端示例项目源码 + 打包脚本
4. REST API 文档（Swagger 2.0 / OpenAPI 3.0）
5. 《部署运维手册》：包含 LAA 打开方法、Windows 防火墙配置、日志轮转
6. 《性能基准报告》：不同模型规模下的 CPU/内存曲线与耗时

---

9. 后续演进路线（可选）

版本	规划	价值
v1.1	接入 MessagePack + Protobuf Binary Streaming	带宽降低 50‑80 %
v1.2	WebSocket 通道（长连，实时回推进度）	减少前端轮询
v2.0	升级到 AVEVA E3D（64‑bit & .NET 4.8），换用 ASP.NET Core / Kestrel	扩展能力 + 长期官方支持

---

结语

该方案沿用 “命令队列 + 主线程执行” 的线程安全模型，摒弃 OWIN/Katana 等高版本依赖，完全兼容 PDMS 12.1 SP4 的 .NET 3.5/x86 运行环境。通过 分页/流式传输、后台子进程导出、LAA 内存扩展 等手段，可以在单客户端场景下稳定处理超大模型，同时保留后续迁移到 E3D 的升级路径。

请技术团队严格按上述步骤实施，并在性能测试阶段使用真实项目数据库进行基准，以确保上线后的体验满足设计人员日常使用需求。若在实现过程中遇到 API 调用或资源释放细节问题，建议优先参考 AVEVA 官方 SDK 文档及本文引用资源。祝项目顺利！