Cortx

安全可控的 AI Agent 运行时 — Harness Agent 架构 + Agentic Loop 引擎

Python TypeScript Node PyPI npm License

Cortex = 大脑皮层。如同大脑皮层负责感知推理、血脑屏障严格过滤、海马体持久记忆 — Cortex Agent 将 Agentic Loop（推理）、PolicyEngine（安全）、Memory（记忆）融为一体。

---

双语言实现

	Python	TypeScript
位置	python/cortex_agent/	src/
工具数	43	43
安装	pip install cortx	npm install -g @chnaicorp/cortx
CLI 命令	ctx	ctx

💡 PyPI: pip install cortx，npm: npm install -g @chnaicorp/cortx。运行只需 ctx

---

快速开始

# Python (3 字母包名)
pip install cortx
ctx

# TypeScript
npm install -g @chnaicorp/cortx
ctx
ctx                         # 交互 REPL
ctx -q "hello"              # 单次查询
ctx --model pro             # 指定模型

# 单次查询
ctx -q "用 Python 写斐波那契函数"

---

🎯 Agent 自主开发 Demo

给 Agent 一句话指令，它自主完成项目规划、架构设计、前后端编码、依赖安装、编译验证、运行调试全流程，0 人工干预。

🛒 企业级购物网站 — cortx-demo-shop-app

指标	数据
源文件数	33 个
总代码行数	2,612 行
技术栈	React + Vite + Express + TypeScript + SQLite + JWT
Agent 续行轮次	3 轮，182 步
人工干预	0 次

# 复现 Agent 自主开发过程
ctx --mode yolo --long --max-rounds 0 -q "请开发设计一个企业级购物网站，完整项目包含：
1.后端(Node.js+Express+TypeScript) RESTful API(商品列表、商品详情、购物车、订单、用户认证JWT)，
SQLite数据库含products/users/carts/orders表，密码bcrypt加密，中间件CORS/错误处理/JWT验证。
2.前端(React+Vite+TypeScript) 首页商品展示、商品详情页、购物车管理、用户登录注册、订单提交。
3.数据库：SQLite自动建表+种子数据至少10个商品。"

👉 查看完整项目代码: github.com/CHNAICORP/cortx-demo-shop-app

🧱 打砖块游戏 — cortx-demo-breakout

指标	数据
源文件数	1 个 (单文件 HTML5)
总代码行数	574 行
技术栈	HTML5 Canvas + 原生 JavaScript + CSS3
依赖	0 (零依赖、零构建)
人工干预	0 次

# 复现 Agent 自主开发过程
ctx -q "用 HTML5 Canvas 做一个打砖块 Breakout 游戏，单文件 index.html，包含：
多关卡、计分、生命系统、粒子特效、鼠标+键盘+触摸控制、霓虹风格UI"

👉 查看游戏源码: github.com/CHNAICORP/cortx-demo-breakout · 🎮 直接打开即玩

🎮 AI 游戏开发 SaaS 平台 — gamespark

使用 Cortx Agent + LingClaw ADE 协同开发完成的完整 SaaS 平台。

指标	数据
源文件数	36 个
技术栈	React 18 + TypeScript + Vite 5 + Tailwind CSS 3 + Express.js + JWT
核心功能	用户认证、三级订阅、AI 工具集 API、在线游戏体验馆
开发方式	Cortx Agent (代码生成) + LingClaw ADE (IDE 可视化) 协同开发
人工干预	仅需求描述，编码全自动化

👉 查看完整项目代码: github.com/CHNAICORP/gamespark

---

设计哲学

┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
│  Think   │ →  │  Guard   │ →  │   Act    │ →  │ Reflect  │
│ (LLM流式)│    │(Policy)  │    │(Executor)│    │(步数收敛)│
└──────────┘    └──────────┘    └──────────┘    └──────────┘

原则	说明
Agent 自主决策	不注入行为指令，Agent 从工具结果中自行推理
完整中介	所有工具调用必经 PolicyEngine 4 级审计
Share-nothing 隔离	每实例独立 work_dir / executor / observer

---

项目结构

ctx/
├── python/cortex_agent/        # Python 包
│   ├── cortex_agent.py          # Agentic Loop 核心引擎
│   ├── policy.py                # PolicyEngine 安全策略
│   ├── llm.py                   # LLM Provider (DeepSeek/OpenAI)
│   ├── tools.py                 # 核心工具 (25)
│   ├── tools_mcp.py             # MCP 客户端 + 注册表
│   ├── tools_browser.py         # CDP WebSocket 浏览器
│   ├── tools_computer.py        # 桌面控制
│   ├── tools_network.py         # 代理/镜像
│   ├── tools_rag.py             # RAG 知识检索
│   ├── main.py                  # CLI 入口
│   ├── terminal.py              # 流式终端
│   ├── memory.py                # 记忆/会话
│   ├── config.py                # 配置加载
│   └── skills.py                # 技能系统
│
├── src/                         # TypeScript 包
│   ├── core/                    # 核心引擎
│   ├── tools/                   # 工具模块 (7 文件)
│   └── cli/                     # CLI 入口
│
├── cortex_workspace/            # 运行时工作区
├── CORTEX.md                    # 项目知识库
├── pyproject.toml               # Python 包配置
├── package.json                 # npm 包配置
├── tsconfig.json                # TypeScript 配置
└── PUBLISH.md                   # 发布指南

💡 想看 Agent 能做什么？ 查看 Demo 项目展示 或直接访问 cortx-demo-shop-app

---

43 个工具

分类	工具
文件	list_directory read_file write_file edit_file glob grep diff_files file_ops read_json csv_query
执行	run_shell_command run_python execute_sql_query python_lint
网络	web_search web_fetch http_request set_proxy unset_proxy show_proxy
记忆	remember_fact recall_fact forget_fact ask_user
任务	task_create task_list task_update
MCP	mcp_list_servers mcp_list_tools mcp_call_tool mcp_registry mcp_install mcp_quick
浏览器	browser_navigate browser_snapshot browser_screenshot
桌面	computer_screenshot computer_click
镜像	pip_mirror npm_mirror
RAG	search_knowledge rebuild_knowledge_index
时间	get_current_time

---

REPL 命令

命令	功能
/help	显示帮助
/context	上下文容量 + 缓存命中率
/kb	查看知识库 CORTEX.md
/goal [目标]	设置/查看持久化目标
/plan [描述]	进入规划模式
/skills	列出所有技能
/skill <name>	调用技能
/mode [s|a|y]	切换权限模式 (Shift+Tab)
/model [pro]	切换模型
/tools	列出工具
/trace /audit	审计追踪
/memory	查看记忆
/sessions	列出会话
@filename	文件引用
/init	初始化项目

---

权限模式

模式	行为
standard 🛡️	SAFE 自动 / WRITE 区内 / SYSTEM 需确认
auto ✏️	自动批准编辑 + SYSTEM 放行
yolo ⚠️	全部放行 (CI/CD)

---

License

MIT