# contocore **Repository Path**: meflying/contocore ## Basic Information - **Project Name**: contocore - **Description**: ontology core for TS platform - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 18 - **Created**: 2026-08-24 - **Last Updated**: 2026-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # contocore 基于 ReAct / ExecutionStateMachine + OAG 本体驱动的企业级智能体平台(AI Harness)。 ## 技术基线 | 层 | 约定 | |----|------| | 应用框架 | NestJS + Fastify(`@nestjs/platform-fastify`,禁止 Express) | | AI 引擎 | ExecutionStateMachine(`@contocore/harness-sdk`) | | 前端 | React 19 + Vite + Tailwind CSS(极简)+ Mermaid;不以 Ant Design 为基线 | | 持久化 | `@contocore/dbcore` + sql.js(开发默认);`DB_DRIVER=mysql` 见 v0.2.0 | | 服务发现 | 开发默认 memory;`SERVICE_DISCOVERY=etcd` 见 v0.2.0 | | 包管理 | pnpm workspace | ## 契约入口 | 版本 | 说明 | |------|------| | [v0.0.1](documents/changes/v0.0.1/README.md) | 架构基准契约 | | [v0.1.0](documents/changes/v0.1.0/README.md) | 状态机引擎与业务骨架(已结项) | | [v0.1.1](documents/changes/v0.1.1/README.md) | 架构合规与债务治理(**已通过结项**,patch) | | [v0.2.0](documents/changes/v0.2.0/README.md) | 生产化加固 + 能力深化(**有条件通过**) | | [v0.3.0](documents/changes/v0.3.0/README.md) | 辅助评标工作流(**有条件通过 · 领域轨**;遗留移交 v0.5.0) | | [v0.4.0](documents/changes/v0.4.0/README.md) | Agent 运行时 LoopEngine + 触发器(**有条件通过 · 平台轨**;遗留移交 v0.5.0) | | [v0.5.0](documents/changes/v0.5.0/README.md) | 生产化收口与双轨遗留消化(**有条件通过** / tag `v0.5.0`) | | [v0.6.0](documents/changes/v0.6.0/README.md) | 预发就绪与 P1 环境硬化(**有条件通过** / 已合 master + tag;切分支用 `refs/heads/v0.6.0`;正式预发证据待运维) | | v0.6.1 | 轻量 patch(见 [changes/README](documents/changes/README.md)):Nest11/Fastify5 audit critical/high 消化 | | [v0.6.2](documents/changes/v0.6.2/README.md) | T-PROD-5 相似度死循环(**已合 master + tag `v0.6.2`**) | | [v0.6.3](documents/changes/v0.6.3/README.md) | trae-cleanup:react-router@8.3.0 / audit 清零 / lint error 清零(**工程侧收口**;预发取证仍开放;tag `v0.6.3`) | | [v0.6.4](documents/changes/v0.6.4/README.md) | eslint warnings → 0(**已合 master + tag `v0.6.4`**;预发取证仍开放) | | [v0.6.5](documents/changes/v0.6.5/README.md) | 工程深度优化 + [可视化界面目标态](documents/changes/v0.6.5/ui-target.md)(**0.6.4 之后**;非已发布的 v0.6.1) | | [v0.7.0](documents/changes/v0.7.0/README.md) | 策略升级初步文档(七支柱 SoT;文档先行;[能力映射](documents/changes/v0.7.0/capability-mapping.md)) | | [v0.7.1](documents/changes/v0.7.1/README.md) | 工程能力全景分析与每日验证机制(修订治理;P0 五大能力已落地;[能力全景](documents/changes/v0.7.1/capability-analysis.md)) | | [v0.7.5](documents/changes/v0.7.5/README.md) | PR #10 5 项特性合入(**已发版 tag v0.7.5**;M2-M3 门禁全绿) | | [v0.7.6](documents/changes/v0.7.6/README.md) | dev 分支滚动迭代(M4 发版准备中;**当前 active**;31 文件 +786/-127;TD6 长期重构 4/4 闭环) | | [v0.7.7](documents/changes/v0.7.7/README.md) | capability closure 承接容器(**planning**;T-CAP-01~06 6 项) | 规范见 [documents/format.md](documents/format.md)。无对应版本文档的变更禁止合入主干。 ## 开发分支(双主干模型) | 分支 | 角色 | 用途 | |------|------|------| | `main` | 生产基线 | tag vX.Y.Z 落点;M2/M3 门禁全绿后才合入 | | `dev` | 集成基线 | 日常开发与 PR 目标分支(v0.7.6 正在此分支) | | `feature/*` / `bugfix/*` | 临时分支 | 单功能/单 bug;合回 dev 后删除 | | `release/v0.X.Y` | 封版分支 | M4 发版时切出;PR 合回 main + dev | | `hotfix/*` | 紧急修复 | 从 main 切出;fix 后合回 main + dev | 详见 [version-control-policy.md](documents/changes/version-control-policy.md)(v2.0 双主干模型)。 ## 文档双重性体系(机器可读入口) 项目采用 **README.md(人类可读)+ AGENTS.md(机器可读)** 双重性文档体系。详见 [documents/format.md §1](documents/format.md)。 | 层 | 入口 | 说明 | |----|------|------| | 项目根级 | [/AGENTS.md](./AGENTS.md) | 顶层机器可读入口(项目根级 /AGENTS.md,与 README.md 同目录) | | 文档根级 | [documents/AGENTS.md](documents/AGENTS.md) | 工程文档根级机器可读入口(含 active_version / current_state / commands) | | 变更目录 | [documents/changes/AGENTS.md](documents/changes/AGENTS.md) | 25 个版本目录索引 + AGENTS.md 覆盖摘要 | | 版本目录 | `documents/changes/vX.Y.Z/AGENTS.md` | 每版本机器可读入口(共 25 个有效版本目录) | | 总索引 | [documents/changes/VERSION-DOCS-INDEX.md](documents/changes/VERSION-DOCS-INDEX.md) | 跨版本文档总索引(六类文档覆盖矩阵) | **同步原则**:当 README.md 更新时,AGENTS.md 须同 PR 同步;任何漂移由 `pnpm docs:check` 自动拦截。 ## 开发者命令 ```bash # 文档双重性校验(CI 三层防护之一) pnpm docs:check # 详细模式(5 项 79 子项) pnpm docs:check:json # JSON 输出(CI 消费) # 新版本双层文档创建(AGENTS.md 模板化生成器) pnpm docs:new v0.7.8 fix --base v0.7.6 # 版本一致性校验(T-NOW-05 配套) pnpm version:check # 33 包版本统一校验 pnpm version:check:json # JSON 输出 # M4 发版就绪度聚合检查(G1-G5 门禁) pnpm m4:readiness # 4/5 pass + 1/5 warn + 0/5 fail(当前 T-NOW-05 待 bump) pnpm m4:readiness:json # JSON 输出 # 业务构建与测试 pnpm build # 全栈 32/32 包构建 pnpm test # 单元测试 pnpm audit # 漏洞审计(6 high 间接依赖待上游) ``` ## 应用端口 | 服务 | 端口 | 启动 | |------|------|------| | gateway | 3000 | `pnpm --filter @contocore/gateway dev` | | scheduler | 3001 | `pnpm --filter @contocore/scheduler dev` | | server | 3002 | `pnpm --filter @contocore/server dev` | | webui | 5173 | `pnpm --filter @contocore/webui dev` | webui 开发代理与生产流量均经 **gateway:3000**。对外健康总览由 gateway 提供;下游仅 `/health/probe`。 ## 可选基础设施(compose profiles) 开发无需 Docker。联调 MySQL / Redis / MQ / etcd: ```bash docker compose --profile mysql up -d docker compose --profile redis up -d docker compose --profile mq up -d docker compose --profile etcd up -d # 预发串联: docker compose --profile mysql --profile redis --profile mq up -d ``` NFR 可选:`pnpm nfr:perf-smoke`(需 `BASE_URL`)、`pnpm nfr:audit`(不阻断默认 test)。 说明:[documents/changes/v0.6.0/live/README.md](documents/changes/v0.6.0/live/README.md)、[documents/changes/v0.6.0/nfr/README.md](documents/changes/v0.6.0/nfr/README.md)、[documents/changes/v0.2.0/infra-profiles.md](documents/changes/v0.2.0/infra-profiles.md)、[apps/server/migrations/mysql/README.md](apps/server/migrations/mysql/README.md)。