首页 理论 架构 工程 规划 文档 白皮书 著作 研究 案例 下载 博客 关于 联系 开始使用 →

第三章 WSaiOS工程项目的开发环境与基础工程

第三章 WSaiOS工程项目的开发环境与基础工程

WSaiOS工程项目从总体架构进入实际建设阶段,需要首先建立能够承载智能控制后台、知识能力构建、个体赋值和自主运行的基础工程环境。基础工程并不是简单地创建一个网站目录、配置数据库或编写几个程序入口,而是要把前两章确定的工程架构转化为实际的软件工程组织,使后续结构智能逻辑、需求驱动、知识构建、个体智能赋值和自主运行程序能够在统一的开发环境中持续建设。

本章的工程建设重点,是确定后台开发环境与个体运行环境之间的技术边界,建立统一的项目目录和程序文件组织方式,规划结构数据、知识数据、能力数据、个体数据及运行数据的存储关系,并建立程序启动、依赖加载、运行初始化和工程验证机制。

需要明确的是,WSaiOS的智能逻辑并不由开发语言或数据库决定。开发语言负责表达程序逻辑,数据库负责保存工程数据,运行环境负责提供程序执行条件。结构智能逻辑、需求驱动智能和知识能力构建,则由后台内部的程序及数据结构共同实现。技术环境必须服务于这一工程目标,不能反过来让技术框架限制知识结构和智能能力的动态构建。

3.1 项目开发环境与技术基础

WSaiOS工程项目的开发环境,需要同时考虑中央智能控制后台的建设条件和个体运行端的实际运行条件。中央后台需要承担复杂的结构处理、知识构建、能力组织、个体赋值和整体任务管理,个体端则需要根据实际应用对象的计算能力、存储条件、通信条件和设备接口,运行已经部署的知识能力及自主运行程序。

两者在工程上具有不同的运行要求,但不能因此形成两套互不兼容的技术体系。后台构建的结构定义、知识数据、能力定义和执行规则,必须能够被个体运行环境正确识别和加载。开发阶段就需要确定统一的数据表达方式、能力定义方式和运行接口,使后台与个体端之间不存在因程序语言或运行环境不同而产生的数据理解差异。

中央智能控制后台可以按照Web应用方式建设,以便在统一的运行环境中完成项目管理、需求处理、知识构建、能力管理、个体部署和运行监控。Web应用形式只是后台的访问和管理方式,并不意味着WSaiOS只是一个网站。后台真正的智能处理程序运行在服务器端,其内部结构智能逻辑不依赖浏览器页面完成。

从工程技术组成看,后台开发环境至少涉及服务器运行环境、程序语言、数据库、文件存储、程序依赖管理和运行日志。个体运行环境则需要考虑本地程序运行条件、结构与知识数据存储、方法调用接口、设备连接接口和运行状态管理。

在技术选型上,WSaiOS不宜在尚未完成具体应用场景分析之前,将所有个体都限定为同一种硬件或软件环境。中央后台可以采用统一的服务器端技术体系,个体运行端则通过标准化的能力数据和运行接口适配不同环境。对于部署在普通计算机上的软件个体,可以采用通用操作系统和应用运行环境;对于工业控制设备、机器人和无人机,则需要结合实际控制器、操作系统和设备接口确定运行技术。

因此,工程开发应当把技术体系分成两个相互衔接的部分。

中央后台的技术体系,重点解决结构智能程序的组织与运行、知识能力数据管理、个体赋值、项目组织和运行反馈处理问题。其程序需要具备持续扩展能力,能够随着知识结构和能力类型的变化增加相应的处理逻辑,而不必每增加一种知识类型就重建整个后台。

个体端的技术体系,重点解决能力数据加载、结构解析、本地知识调用、运行判断、方法执行和反馈记录问题。个体端不需要部署后台全部智能构建程序,但必须具备与自身任务相适应的基础运行能力。对于需要离线工作的个体,还必须保证本地部署数据具有完整性,能够在没有中央后台实时参与的情况下继续完成已经赋予的任务。

在开发初期,可以将中央后台作为主要建设对象,先建立统一的程序入口、数据库连接、结构数据管理和运行初始化机制。个体端的基础运行程序则根据后台数据定义同步设计,先确定数据接口和加载规范,再逐步实现不同运行环境下的适配程序。

如果采用PHP和MySQL建设Web形式的中央后台,可以使用PHP承担服务器端程序逻辑,通过PDO统一管理数据库访问,以MySQL保存结构定义、知识能力、个体配置和运行记录。后台管理页面可以采用模板引擎组织,但页面模板不应承担智能判断和知识构建逻辑。

这一技术组合可以作为中央后台第一阶段的候选实现路线。PHP版本、数据库版本和模板引擎版本,应在实际开发前根据服务器环境、运行维护周期和安全要求确定,不能把某个历史项目使用过的版本直接视为WSaiOS的永久技术标准。尤其是个体端,不能因为后台采用PHP,就要求工业控制器、机器人或无人机也必须采用PHP运行。

从程序接口角度看,后台与个体端之间需要建立独立于具体开发语言的数据协议。结构定义、知识内容、能力配置和任务数据,应采用双方都能够解析的明确格式。对于不同运行语言,可以分别实现相应的数据加载程序,但不能改变同一能力定义所表达的结构含义。

例如,后台构建形成的一个能力定义,可以采用如下统一数据格式:

{
    "capability_code": "CAP-0001",
    "capability_version": "1.0.0",
    "capability_name": "设备状态判断能力",
    "structure_ref": [
        "STR-0001"
    ],
    "knowledge_ref": [
        "KNW-0001"
    ],
    "methods": [
        {
            "method_code": "METHOD-0001",
            "method_name": "状态判断",
            "entry": "judgeStatus"
        }
    ],
    "execution_rules": {
        "local_data_required": true,
        "allow_execution": true
    }
}

这里的JSON只是数据传输和保存的表达形式。能力本身不是这段JSON文本,而是由结构定义、知识内容、方法及其适用条件共同形成的可运行能力。个体端加载时,需要根据数据中的引用关系取得完整的结构和知识内容,并将方法标识映射到本地已经部署的程序实现。

由此,WSaiOS的技术基础需要遵循一个重要原则:开发语言可以不同,运行环境可以不同,设备接口可以不同,但后台构建与个体运行之间的数据定义、能力含义和执行边界必须保持一致。

3.2 工程目录结构与程序文件组织

项目目录结构是工程程序组织的基础。WSaiOS不能按照普通网站的页面目录组织全部程序,也不能将所有智能处理逻辑集中写入一个入口文件。由于系统同时包含智能构建、知识能力管理、个体赋值、运行控制和持续演化等处理过程,因此必须在目录层次上明确程序职责及其调用边界。

目录划分的目的不是人为增加程序数量,而是使不同工程对象拥有明确的程序归属。需求分析程序应当能够调用结构处理和知识构建程序,但不应直接承担数据库连接管理;个体赋值程序应当调用能力管理和部署程序,但不应自行重新定义知识结构;个体运行程序应当加载后台发布的能力数据,但不应直接修改后台保存的原始知识定义。

根据第二章确定的总体架构,中央智能控制后台可以先建立如下基础目录:

WSaiOS/
│
├── app/
│   │
│   ├── Core/
│   │   ├── Application.php
│   │   ├── SystemInitializer.php
│   │   ├── ServiceContainer.php
│   │   └── RuntimeManager.php
│   │
│   ├── Intelligence/
│   │   │
│   │   ├── Requirement/
│   │   │   ├── RequirementProcessor.php
│   │   │   └── RequirementAnalyzer.php
│   │   │
│   │   ├── Structure/
│   │   │   ├── StructureProcessor.php
│   │   │   ├── StructureParser.php
│   │   │   └── StructureMatcher.php
│   │   │
│   │   ├── Knowledge/
│   │   │   ├── KnowledgeBuilder.php
│   │   │   └── KnowledgeOrganizer.php
│   │   │
│   │   ├── Capability/
│   │   │   ├── CapabilityBuilder.php
│   │   │   └── CapabilityValidator.php
│   │   │
│   │   ├── Cognition/
│   │   │   └── CognitionProcessor.php
│   │   │
│   │   ├── Decision/
│   │   │   └── DecisionProcessor.php
│   │   │
│   │   └── Evolution/
│   │       ├── FeedbackAnalyzer.php
│   │       └── EvolutionProcessor.php
│   │
│   ├── Individual/
│   │   ├── IndividualManager.php
│   │   ├── CapabilityAssigner.php
│   │   ├── IndividualBuilder.php
│   │   └── DeploymentService.php
│   │
│   ├── Organization/
│   │   ├── ProjectManager.php
│   │   ├── TaskManager.php
│   │   └── OrganizationManager.php
│   │
│   ├── Control/
│   │   ├── CentralController.php
│   │   ├── CommunicationManager.php
│   │   └── StateManager.php
│   │
│   ├── Runtime/
│   │   ├── IndividualRuntime.php
│   │   ├── StructureLoader.php
│   │   ├── KnowledgeLoader.php
│   │   ├── CapabilityLoader.php
│   │   ├── DecisionEngine.php
│   │   └── MethodDispatcher.php
│   │
│   ├── Interfaces/
│   │   ├── DeviceInterface.php
│   │   ├── SoftwareInterface.php
│   │   └── CommunicationInterface.php
│   │
│   └── Repositories/
│       ├── RequirementRepository.php
│       ├── StructureRepository.php
│       ├── KnowledgeRepository.php
│       ├── CapabilityRepository.php
│       ├── IndividualRepository.php
│       ├── TaskRepository.php
│       └── RuntimeRepository.php
│
├── config/
│   ├── app.php
│   ├── database.php
│   └── runtime.php
│
├── database/
│   ├── schema/
│   ├── migrations/
│   └── seeds/
│
├── public/
│   └── index.php
│
├── templates/
│
├── storage/
│   ├── structures/
│   ├── knowledge/
│   ├── capabilities/
│   ├── deployments/
│   ├── runtime/
│   ├── feedback/
│   ├── logs/
│   └── backups/
│
├── individual/
│   └── runtime/
│
├── tests/
│   ├── Unit/
│   ├── Integration/
│   └── Acceptance/
│
├── vendor/
│
├── bootstrap.php
└── composer.json

这一目录结构首先区分了智能处理程序、基础运行程序、数据访问程序、个体管理程序和工程配置文件。

app/Core用于建立应用程序的基本运行环境,包括程序初始化、服务实例管理和运行环境加载。这里的程序不负责完成具体的知识构建,而是为后台内部的智能处理程序提供统一的运行入口和依赖条件。

app/Intelligence是智能控制后台内部的核心程序目录。其下的需求、结构、知识、能力、认知、决策和进化程序不是独立于WSaiOS的外接系统,而是共同完成后台结构智能处理的程序组织。它们之间通过明确的数据对象和方法调用建立联系。

app/Individual负责个体工程对象的建立、能力赋值和部署。它需要调用能力管理程序,确认能力的版本和依赖关系,再形成个体对应的部署数据。这里管理的是知识能力与个体之间的工程关系,不是传统意义上的用户会员注册。

app/Organization负责项目和个体之间的组织关系。后台根据总体需求建立项目任务,确定不同个体的职责、任务依赖和协同关系。它与app/Intelligence之间存在调用关系:组织管理需要使用后台已经形成的知识能力,而智能构建过程也可以依据项目反馈调整能力配置。

app/Control负责中央控制、通信和状态管理。它不代替个体内部的判断决策程序,而是处理中央后台与个体之间的任务交互、状态更新和运行协调。

app/Runtime包含运行时所需的加载和调用程序。个体端需要使用的部分程序可以从这一目录中组织成独立运行包,但不能将整个后台程序直接复制到每一个个体上。个体运行包应当只包含其实际需要的基础运行程序及已经赋予的知识能力数据。

app/Repositories负责数据库访问。智能处理程序通过Repository取得和保存数据,避免在需求分析、知识构建、个体赋值等程序中重复编写数据库操作。这样,后续调整数据库结构时,可以尽可能将影响限制在数据访问层和相关数据映射程序中。

storage用于保存运行过程中产生的结构文件、知识文件、能力部署包、反馈数据和日志。数据库适合保存需要查询、关联和事务管理的记录,文件存储适合保存较大的结构定义、知识内容或部署数据包。二者应通过明确的记录关系关联,不能让数据库记录与文件内容失去对应关系。

目录结构建立以后,还需要明确程序文件的基本职责。例如,CapabilityBuilder.php负责根据需求和知识结构形成能力定义,CapabilityRepository.php负责能力数据的保存与读取,CapabilityLoader.php负责将已经部署的能力加载到运行环境。三个程序虽然都涉及能力,但其工程职责完全不同,不能将构建、存储和加载混合在同一个程序文件中。

程序文件之间应当通过明确的方法调用进行衔接,而不是互相读取对方的内部变量或直接修改对方的运行状态。对于跨目录调用,需要通过自动加载机制或统一的类加载方式实现,避免在每个程序文件中反复使用相对路径包含其他文件。

例如,PHP项目可以采用命名空间和自动加载方式组织程序。具体的命名空间映射关系由项目的自动加载配置确定。这样,后续新增知识构建程序、能力验证程序或个体运行程序时,不需要修改所有调用文件中的路径。

目录结构不是一次性固定不变的。随着WSaiOS工程从后台基础建设进入知识能力构建、个体运行和多智能个体协同阶段,可能会增加新的程序目录和数据存储目录。但新增程序必须归属于已有的工程职责体系,不能因为某一项应用需求就随意建立一个与后台智能逻辑重复的独立系统。

3.3 数据库结构与数据存储规划

WSaiOS的数据库设计必须围绕智能构建过程和个体运行过程建立,而不能只按照普通后台管理系统的用户、菜单、权限和内容表进行设计。

普通管理系统的数据库通常以固定业务对象为中心,字段和表结构在开发阶段基本确定。WSaiOS则需要管理动态形成的结构定义、知识内容、能力定义和个体赋值关系。不同需求可能产生不同的结构元素、属性、方法和关系,因此数据库既要具备稳定的基础管理结构,又必须支持动态知识结构的保存和扩展。

数据库规划需要解决两个方面的问题。一方面,需求、结构、知识、能力、个体、任务和运行状态之间必须建立明确的关联,使后台能够追溯某项能力从何种需求产生、依据哪些知识构建、经过什么验证以及最终赋予了哪个个体。另一方面,结构内部的属性、方法和关系不能全部提前写死在数据库字段中,否则每增加一种新的知识结构,都可能需要修改数据库表。

因此,WSaiOS可以采用关系型数据库与动态结构数据相结合的存储方式。

关系型数据库负责保存工程对象的标识、状态、版本、时间和关联关系。动态结构内容则可以采用JSON或独立结构文件保存。数据库通过结构编号、版本编号和文件路径等信息定位相应内容。对于需要频繁查询的结构属性,可以在后续工程阶段根据实际查询需求建立索引或拆分为专门的数据表,而不是在项目初期将所有可能的属性都设计成固定字段。

首先,需要建立需求数据。需求是后台智能构建过程的起点。后台必须保存需求来源、需求目标、涉及对象、条件限制、需求状态和处理结果,以便后续追踪能力构建的依据。

其次,需要建立结构数据。结构数据保存对象定义、元素组成、属性、方法和关系。结构编号必须保持稳定,结构版本用于区分结构发生变化后的不同定义。不能因为结构内容更新,就覆盖掉所有历史版本,否则个体运行反馈将无法准确对应当时使用的结构。

再次,需要建立知识数据。知识数据需要与结构定义建立关联,保存具体知识内容及其适用条件。知识并不是简单的文本记录,必须能够被结构解析程序识别,并且能够在后续能力构建过程中参与匹配和处理。

能力数据是后台构建结果的重要记录。能力定义需要关联其使用的知识、方法、适用条件和执行规则。一个能力可以依赖多个知识结构,一个个体也可以获得多个能力,因此数据库必须支持多对多关联,而不能将能力与个体设计成一对一关系。

个体数据则用于保存个体的工程标识、运行环境、部署模式和运行状态。个体赋值记录应当独立保存,不能直接把所有能力信息写入个体主表。这样,一个个体的能力发生变化时,只需要调整对应的赋值关系,不必修改个体的基础记录。

基于上述关系,第一阶段可以建立以下核心数据表:

CREATE TABLE ws_requirements (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    requirement_code VARCHAR(64) NOT NULL,
    requirement_source VARCHAR(64) NOT NULL,
    requirement_definition LONGTEXT NOT NULL,
    requirement_status VARCHAR(32) NOT NULL,
    created_at DATETIME NOT NULL,
    updated_at DATETIME DEFAULT NULL,
    UNIQUE KEY uk_requirement_code (requirement_code)
);

CREATE TABLE ws_structures (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    structure_code VARCHAR(64) NOT NULL,
    structure_name VARCHAR(255) NOT NULL,
    structure_version VARCHAR(32) NOT NULL,
    structure_definition LONGTEXT NOT NULL,
    structure_status VARCHAR(32) NOT NULL,
    created_at DATETIME NOT NULL,
    UNIQUE KEY uk_structure_version (
        structure_code,
        structure_version
    )
);

CREATE TABLE ws_knowledge (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    knowledge_code VARCHAR(64) NOT NULL,
    structure_code VARCHAR(64) NOT NULL,
    knowledge_version VARCHAR(32) NOT NULL,
    knowledge_definition LONGTEXT NOT NULL,
    knowledge_status VARCHAR(32) NOT NULL,
    created_at DATETIME NOT NULL,
    UNIQUE KEY uk_knowledge_version (
        knowledge_code,
        knowledge_version
    )
);

CREATE TABLE ws_capabilities (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    capability_code VARCHAR(64) NOT NULL,
    capability_name VARCHAR(255) NOT NULL,
    capability_version VARCHAR(32) NOT NULL,
    capability_definition LONGTEXT NOT NULL,
    validation_status VARCHAR(32) NOT NULL,
    capability_status VARCHAR(32) NOT NULL,
    created_at DATETIME NOT NULL,
    UNIQUE KEY uk_capability_version (
        capability_code,
        capability_version
    )
);

CREATE TABLE ws_capability_knowledge (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    capability_id BIGINT UNSIGNED NOT NULL,
    knowledge_id BIGINT UNSIGNED NOT NULL,
    relation_type VARCHAR(32) NOT NULL,
    KEY idx_capability_knowledge (
        capability_id,
        knowledge_id
    )
);

CREATE TABLE ws_individuals (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    individual_code VARCHAR(64) NOT NULL,
    individual_type VARCHAR(64) NOT NULL,
    runtime_environment LONGTEXT,
    runtime_mode VARCHAR(32) NOT NULL,
    individual_status VARCHAR(32) NOT NULL,
    created_at DATETIME NOT NULL,
    UNIQUE KEY uk_individual_code (individual_code)
);

CREATE TABLE ws_individual_capabilities (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    individual_id BIGINT UNSIGNED NOT NULL,
    capability_id BIGINT UNSIGNED NOT NULL,
    assigned_version VARCHAR(32) NOT NULL,
    assignment_status VARCHAR(32) NOT NULL,
    assigned_at DATETIME NOT NULL,
    KEY idx_individual_capability (
        individual_id,
        capability_id
    )
);

这组数据表建立了需求、结构、知识、能力和个体之间的基础关联。其中,ws_capability_knowledge用于保存能力与知识之间的多对多关系;ws_individual_capabilities用于保存个体与能力之间的赋值关系。两者不能合并为一个表,因为知识与能力之间的关系属于能力构建过程,而个体与能力之间的关系属于能力部署过程。

在正式工程中,还需要增加需求与结构、需求与能力之间的关联记录。这样才能准确追踪某个能力是为了解决哪项需求而构建的,以及同一项能力是否被多个不同需求共同使用。

结构版本和能力版本也不能简单理解为数据库中的普通更新时间。版本必须能够标识某一份明确的定义内容。个体在运行时需要知道自己加载的是哪个版本,后台在发布新版本时也必须能够判断哪些个体需要更新、哪些个体仍然允许继续运行旧版本。

因此,数据库还需要保存能力验证记录、部署记录、任务记录和运行反馈记录。其基本关系如下:

ws_requirements
       │
       ├────────────── ws_requirement_structures
       │                         │
       │                         ▼
       │                    ws_structures
       │                         │
       │                         ▼
       │                    ws_knowledge
       │                         │
       │                         ▼
       │                 ws_capability_knowledge
       │                         │
       ▼                         ▼
ws_requirement_capabilities ─ ws_capabilities
                                  │
                                  ▼
                       ws_capability_validations
                                  │
                                  ▼
                       ws_individual_capabilities
                                  │
                                  ▼
                           ws_individuals
                                  │
                                  ▼
                         ws_deployments
                                  │
                                  ▼
                           ws_runtime_logs
                                  │
                                  ▼
                          ws_feedback

对于文件存储,后台可以按照对象编号和版本号组织文件,而不是直接使用用户输入的名称作为文件路径。这样能够避免名称冲突,也便于程序按编号取得数据。

storage/
│
├── structures/
│   └── STR-0001/
│       ├── 1.0.0.json
│       └── 1.1.0.json
│
├── knowledge/
│   └── KNW-0001/
│       ├── 1.0.0.json
│       └── 1.1.0.json
│
├── capabilities/
│   └── CAP-0001/
│       ├── 1.0.0.json
│       └── 1.1.0.json
│
├── deployments/
│   └── IND-0001/
│       └── DEP-0001/
│
├── runtime/
│   └── IND-0001/
│
├── feedback/
│   └── IND-0001/
│
└── logs/

例如,后台构建一个新的结构定义时,可以先将结构内容保存到临时区域,完成格式检查和结构验证以后,再形成正式版本。数据库记录正式版本的编号、状态和存储位置。个体部署时,根据能力定义中的结构引用取得对应版本,不能只按照结构编号加载最新文件。否则,后台更新结构以后,已经部署的个体可能在没有重新赋值的情况下加载到不一致的数据。

数据更新还需要考虑事务和一致性。能力赋值不是单独插入一条数据库记录就算完成。它可能涉及能力状态检查、个体状态检查、赋值记录创建、部署数据生成和部署状态更新。如果其中某一步失败,后台必须能够识别当前部署处于哪个阶段,并提供继续处理或回滚的依据。

对于结构定义、知识内容和能力定义,建议采用版本不可随意覆盖的管理方式。新内容通过新版本发布,旧版本保留供历史运行记录追溯。对于个体运行数据,则按照任务、时间和个体标识保存,并建立必要的归档机制,避免运行日志无限增长影响数据库性能。

这样,数据库就不再只是保存后台页面所展示的数据,而是成为整个WSaiOS智能构建、个体赋值和自主运行体系的工程数据基础。

3.4 程序入口、调用关系与运行初始化

基础工程建立以后,需要解决整个程序如何启动、如何加载依赖、如何连接数据库,以及智能控制后台从什么位置进入实际运行的问题。

WSaiOS不能让每一个业务程序都成为独立入口。否则,随着需求处理、知识构建、能力管理和个体控制程序不断增加,程序之间容易出现重复初始化、重复连接数据库和调用顺序不一致的问题。

因此,中央智能控制后台应当建立统一的程序入口。Web访问、后台管理操作、定时任务和内部运行任务,可以采用不同的请求入口,但最终都应进入统一的应用初始化环境,再由相应的控制程序组织具体业务处理。

在Web部署环境中,public/index.php可以作为外部HTTP请求的唯一公开入口。数据库配置、自动加载、基础服务初始化和应用程序启动由bootstrap.php及Application.php组织完成。其他程序文件不应直接暴露在Web根目录中。

程序启动关系可以表示为:

HTTP请求
   │
   ▼
public/index.php
   │
   ▼
bootstrap.php
   │
   ├──加载程序自动加载机制
   │
   ├──读取系统配置
   │
   ├──初始化数据库连接
   │
   └──初始化基础服务
          │
          ▼
    Application.php
          │
          ▼
    路由与控制程序
          │
          ▼
    业务服务程序
          │
          ▼
    智能处理程序
          │
          ▼
    Repository数据访问层
          │
          ▼
       数据存储

这里的程序入口负责建立运行条件,不直接完成需求理解和知识构建。真正的智能处理仍由后台内部的智能程序完成。

首先建立配置文件。数据库连接信息不能散落在多个Repository程序中,而应统一从配置文件读取。

例如,config/database.php可以采用如下结构:

<?php

return array(
    'driver' => 'mysql',
    'host' => '127.0.0.1',
    'port' => 3306,
    'database' => 'wsaios',
    'username' => 'root',
    'password' => '',
    'charset' => 'utf8mb4'
);

实际部署时,数据库用户名和密码应通过服务器环境配置或安全配置文件提供,不应将生产环境密码提交到公开版本库。上面的空密码只是本地开发配置示例,不能直接用于正式服务器。

随后建立数据库连接程序。以PDO为例:

<?php

class Database
{
    private static $connection = null;

    public static function connection()
    {
        if (self::$connection !== null) {
            return self::$connection;
        }

        $config = require __DIR__ . '/../../config/database.php';

        $dsn = 'mysql:host=' . $config['host']
            . ';port=' . $config['port']
            . ';dbname=' . $config['database']
            . ';charset=' . $config['charset'];

        self::$connection = new PDO(
            $dsn,
            $config['username'],
            $config['password'],
            array(
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::ATTR_EMULATE_PREPARES => false
            )
        );

        return self::$connection;
    }
}

这一程序只负责创建和复用数据库连接,不承担具体数据查询。后续StructureRepository、KnowledgeRepository和CapabilityRepository等程序通过统一连接入口取得PDO实例,完成各自负责的数据访问。

系统初始化程序则负责检查基础运行条件。它需要确认配置文件可以读取、数据库可以连接、必要的数据表已经建立、运行目录具有适当的读写权限,并且系统当前版本与数据库版本相容。

<?php

class SystemInitializer
{
    private $pdo;

    public function __construct(PDO $pdo)
    {
        $this->pdo = $pdo;
    }

    public function initialize()
    {
        $this->checkDatabase();
        $this->checkStorage();
        $this->checkSystemTables();

        return true;
    }

    private function checkDatabase()
    {
        $this->pdo->query('SELECT 1');
    }

    private function checkStorage()
    {
        $paths = array(
            __DIR__ . '/../../storage',
            __DIR__ . '/../../storage/logs',
            __DIR__ . '/../../storage/runtime'
        );

        foreach ($paths as $path) {
            if (!is_dir($path)) {
                throw new RuntimeException(
                    '运行目录不存在:' . $path
                );
            }

            if (!is_writable($path)) {
                throw new RuntimeException(
                    '运行目录不可写:' . $path
                );
            }
        }
    }

    private function checkSystemTables()
    {
        $this->pdo->query(
            'SELECT 1 FROM ws_requirements LIMIT 1'
        );
    }
}

这里的初始化检查只展示基础工程需要具备的检查逻辑。正式实现时,数据表检查不能只检测一张表,还需要通过数据库版本记录检查所有必要的数据结构是否已经安装。对于首次部署,还需要提供数据库迁移程序,按照确定的顺序建立基础表、索引和必要的初始数据。

程序初始化完成以后,应用程序才能进入正常运行状态。其基本组织方式可以如下:

<?php

class Application
{
    private $pdo;

    public function __construct(PDO $pdo)
    {
        $this->pdo = $pdo;
    }

    public function run()
    {
        $initializer = new SystemInitializer($this->pdo);

        $initializer->initialize();

        // 后续在这里进入路由与控制程序
        return true;
    }
}

统一入口则负责组织初始化:

<?php

require_once __DIR__ . '/app/Core/Database.php';
require_once __DIR__ . '/app/Core/SystemInitializer.php';
require_once __DIR__ . '/app/Core/Application.php';

$pdo = Database::connection();

$application = new Application($pdo);

$application->run();

以上代码用于说明基础启动关系,正式工程需要进一步建立自动加载、异常处理、配置管理、路由和服务实例管理,避免入口文件随着程序增加而不断堆积require_once语句。

完成启动过程以后,还需要建立智能处理程序之间的调用关系。后台的统一入口接收需求对象,交给需求处理程序;需求处理程序将分析结果传递给结构处理程序;结构处理程序根据现有结构和知识数据完成匹配,必要时进入知识构建过程;能力构建程序依据需求和知识形成能力;能力验证程序检查能力是否满足要求;个体赋值程序再根据任务职责选择适当个体。

这一过程可以进一步表示为:

Application
    │
    ▼
IntelligenceController
    │
    ▼
RequirementProcessor
    │
    ▼
StructureProcessor
    │
    ├──已有结构满足要求
    │          │
    │          ▼
    │      KnowledgeMatcher
    │
    └──现有结构不足
               │
               ▼
         KnowledgeBuilder
               │
               ▼
         CapabilityBuilder
               │
               ▼
        CapabilityValidator
               │
               ▼
        IndividualManager
               │
               ▼
        CapabilityAssigner
               │
               ▼
        DeploymentService

程序调用必须具有明确的返回结果。例如,知识构建程序不能只返回一个true,而应当返回知识编号、版本、结构引用和构建状态;能力构建程序也不能只返回一个成功标志,而应当返回能力标识、版本、知识依赖和验证状态。这样,上层程序才能根据处理结果决定是否继续执行。

对于个体运行端,则需要建立独立的运行初始化过程。个体启动时,应当读取本地个体标识和部署配置,检查当前部署版本,加载结构与知识数据,加载能力定义和执行规则,最后建立本地运行环境。

个体运行程序不能在每次启动时都无条件从中央后台获取全部数据。对于无通信运行环境,个体必须能够直接读取已经部署到本地的数据。对于通信运行环境,个体可以在启动时与后台核对版本和部署状态,但是否需要更新应当由版本和部署规则决定,而不是每次启动都重新下载全部能力数据。

后台和个体端的初始化过程由此形成两个不同的程序入口,但它们使用统一的能力定义和结构数据规范。后台初始化是为了建立智能构建和组织控制环境,个体初始化是为了建立本地自主运行环境。两者不能混淆,也不能用后台的初始化程序代替个体运行初始化程序。

3.5 开发规范、版本管理与工程验证机制

WSaiOS工程项目的开发不能采用只要程序能够运行就认为开发完成的方式。由于整个系统涉及智能构建、知识能力形成、个体赋值和实际对象控制,程序语法正确并不代表结构数据正确,数据库连接成功也不代表知识能力能够正常形成,个体接收到部署数据也不代表已经具备自主运行条件。

因此,项目需要从一开始建立统一的开发规范、版本管理和工程验证机制。每一个工程阶段都必须能够说明建设对象、实际修改内容、检查结果和遗留问题,使项目能够在持续扩展的过程中保持程序和数据的一致性。

首先,需要明确程序开发规范。所有程序文件应当具有清晰的职责,程序输入和输出应当明确,跨程序调用应当通过公开方法或约定接口进行。数据库访问应当使用统一的数据访问层,不能在多个智能处理程序中重复建立连接。涉及外部输入的数据必须经过校验,数据库操作必须使用参数化查询,不能直接拼接用户输入形成SQL语句。

对于动态结构数据,程序不能假定所有对象具有固定字段。结构解析程序应当依据实际结构定义读取元素、属性和方法,不能将某一种应用场景的业务字段写死在通用结构处理程序中。新增知识结构时,应当优先通过结构定义和数据配置表达差异,而不是随意修改底层通用程序。

对于能力定义,必须明确能力的适用范围、输入条件、知识依赖、方法引用、输出结果和执行约束。能力验证程序应当能够检查这些定义是否完整,不能因为能力数据已经成功保存,就直接将其标记为可以部署。

对于个体赋值,必须保留赋值对象、能力编号、能力版本、赋值时间和部署状态。个体运行过程中产生的数据应当记录实际使用的能力版本。否则,当后台更新知识或能力以后,就无法准确判断历史运行结果究竟依据哪个版本形成。

其次,需要建立版本管理机制。WSaiOS工程至少涉及三个不同层次的版本。

程序版本用于管理代码变化,记录后台程序、个体运行程序和接口程序的修改历史。数据结构版本用于管理数据库表、字段、索引和数据迁移过程。知识能力版本则用于管理结构定义、知识内容、能力方法和执行规则的变化。

三种版本不能混为一谈。例如,后台程序升级并不意味着所有个体的能力数据都必须更新;数据库结构发生变化也不意味着某个知识能力的定义一定发生变化;知识能力更新则必须经过验证和部署,不能仅因为程序版本升级就自动改变个体正在使用的能力。

程序版本可以通过Git进行管理。项目需要建立统一的代码仓库,并将开发环境、测试环境和正式部署环境的代码版本对应起来。配置文件中的生产环境密码、个人密钥和其他敏感信息不能提交到公共代码仓库。数据库迁移文件、结构定义样例和必要的工程配置则应当按照项目规则进行版本管理。

数据库变更需要采用迁移文件保存。例如,首次建立基础数据表时形成一个初始迁移版本,后续增加部署记录或运行反馈表时,建立新的迁移文件。每次部署前,系统应当检查数据库当前迁移版本,避免程序代码已经更新而数据库仍然停留在旧结构。

知识能力版本则应当独立于代码版本管理。假设某个个体当前运行的是能力CAP-0001的1.0.0版本,后台构建并验证了1.1.0版本,不能直接覆盖个体本地的旧版本。后台应当先完成新版本的适用性检查,再根据个体运行条件确定更新策略。对于正在执行重要任务的个体,可以在任务结束后更新;对于需要立即停止旧能力的情况,则必须执行明确的控制流程。

工程验证必须覆盖从基础程序到实际运行的完整过程。开发阶段首先进行语法和静态检查,确认程序能够被解释器正确解析,必要的类和方法能够被加载。随后进行基础功能检查,确认数据库连接、数据读取、数据保存、文件读写和程序调用正常。

在此基础上,还需要开展模块集成验证。例如,结构解析程序能够读取结构定义,并不代表知识构建程序能够正确使用该结构;知识构建程序能够保存知识数据,也不代表能力构建程序能够正确建立知识与方法之间的关系。因此,必须检查相邻程序之间的数据传递和调用结果。

能力验证则需要进入实际处理过程。对一个已经形成的知识能力,应当提供符合适用条件的输入数据,检查能力能否产生预期结果;再提供边界条件和不符合条件的数据,检查能力是否能够正确识别限制,而不是产生无依据的判断或执行结果。

个体运行验证必须检查能力部署、数据加载、任务执行和结果反馈的完整过程。对于通信模式,需要检查后台任务下发、个体接收、状态反馈和任务结果回传;对于无通信模式,则需要断开通信环境,验证个体是否能够依靠本地部署的数据继续完成允许的任务,并检查异常情况是否能够正确记录。

多智能个体验证则需要检查任务分配、任务依赖、个体状态和异常处理。例如,一个个体未完成前置任务时,后续个体是否会错误地开始执行;某个个体失去通信以后,后台是否能够识别其状态变化;个体恢复通信以后,历史运行记录是否能够正确同步。这些验证不能只在后台模拟数据中完成,还需要逐步进入实际个体运行环境。

结合WSaiOS项目的开发过程,可以建立统一的工程实施与验收流程:

工程需求确认
      │
      ▼
检查实际项目文件与现有工程状态
      │
      ▼
确定本阶段建设对象
      │
      ▼
程序与数据结构设计
      │
      ▼
编码实施
      │
      ▼
本地语法与静态检查
      │
      ▼
本地功能验证
      │
      ▼
同步服务器或目标运行环境
      │
      ▼
真实环境运行验证
      │
      ▼
问题记录与修复
      │
      ▼
重新测试与结果核对
      │
      ▼
阶段验收
      │
      ▼
进入下一工程阶段

这里需要特别区分本地开发检查与真实运行验证。对于采用PHP开发的后台程序,本地可以先完成PHP语法检查、类加载检查和基础程序调用检查。如果本地环境没有真实数据库或完整运行服务,就不能将语法检查结果表述为功能测试成功。服务器同步以后,还需要在真实数据库和请求环境中检查程序逻辑、数据写入和实际运行结果。

每个工程阶段都应当形成对应的验证记录。记录内容至少应当能够说明本阶段使用的代码版本、数据库迁移版本、测试数据、执行步骤、预期结果、实际结果和未解决问题。对于没有执行的测试,应当明确标记为未测试;对于执行失败的项目,应当保留失败信息,不能为了阶段验收而将其改写为成功状态。

在WSaiOS工程中,验证还必须区分工程程序验证和智能能力验证。工程程序验证关注程序是否按照设计完成数据读取、处理、调用和保存;智能能力验证关注形成的知识能力是否能够在规定条件下支持正确的判断和方法执行。二者相互关联,但不能互相替代。

例如,后台能够成功保存一项设备状态判断能力,只能说明能力数据已经进入存储系统,并不能说明这项能力真的能够正确判断设备状态。只有在实际输入条件下运行该能力,检查判断依据、判断结果和执行边界,才能形成能力层面的验证结论。

同样,个体能够成功加载能力数据,也不能直接证明个体已经具备完整自主运行能力。还需要检查个体能否根据本地获取的信息调用知识能力、完成必要的判断、选择允许的方法,并在执行结束后形成可追溯的运行记录。

通过上述规范,WSaiOS工程的开发过程就能够形成从需求、设计、编码、数据建立、程序运行到智能能力验证的完整工程闭环。每一项新增功能、每一种知识结构、每一项能力定义和每一个个体运行程序,都必须能够进入这一闭环接受检查。

本章完成的是WSaiOS工程开发环境与基础工程的总体设计。其核心成果是明确技术环境的选择原则,建立后台与个体端的程序组织边界,确定数据库和文件存储的基本关系,建立统一程序入口及初始化方式,并形成能够持续执行的开发、版本管理和工程验证机制。

在此基础上,后续工程建设将正式进入智能控制后台本身的实现。第四章需要围绕后台智能控制体系展开,建立后台核心程序的实际组织关系,使结构智能逻辑、需求驱动、知识结构化、知识能力构建、个体智能赋值和自主进化学习真正进入统一的程序运行过程,而不是停留在总体架构和数据模型的设计层面。

Leave a Reply

Your email address will not be published. Required fields are marked *

客服咨询
● 欢迎咨询与合作
您好!欢迎咨询。 我可以帮助您了解人工智能技术研发、智能软件系统开发、网站建设、搜索优化及项目定制等相关信息。 请问有什么可以帮您?
免费申请
请填写以下信息,方便我们进一步沟通。
欢迎咨询 AI 系统开发、网站建设、搜索优化、项目定制合作
电话:15089196448
邮箱:1602401899@qq.com
地址:陕西省渭南市
服务时间:周一至周五 09:00 - 18:00 | 7×24小时技术值守