wuyang
74 lines
2.7 KiB
Markdown
74 lines
2.7 KiB
Markdown
# 基础设施地图
|
||
|
||
中文 · [English](infrastructure.md)
|
||
|
||
本文档用于区分共享基础设施与真正决定 K1412 Agent 行为的组件。
|
||
|
||
## 请求路径
|
||
|
||
```text
|
||
Internet
|
||
-> DNS / TLS
|
||
-> Nginx Proxy Manager
|
||
-> Unraid NAS：K1412 Web 服务栈
|
||
-> Tailscale + SSH
|
||
-> home-node-itx：每用户 Docker 工作区
|
||
```
|
||
|
||
## 共享基础设施
|
||
|
||
这些服务让应用可以被访问或部署，但修改它们不会改变 Agent Loop：
|
||
|
||
| 服务 | 职责 |
|
||
| --- | --- |
|
||
| `git.k1412.top` | 公开源码仓库 |
|
||
| `docker.k1412.top` | 私有不可变容器镜像 |
|
||
| Nginx Proxy Manager | HTTPS 入口和反向代理 |
|
||
| k1412 首页 | 服务发现入口 |
|
||
| Tailscale | NAS 到执行主机的私有网络 |
|
||
| Unraid Compose Manager | NAS 上的应用生命周期管理 |
|
||
| Ollama + 32 GB NVIDIA GPU | Luna、Terra、Sol 模型服务 |
|
||
|
||
NAS 上的其他应用是相互独立的租户。仅仅因为共享同一台主机，并不意味着它们是 K1412
|
||
Agent 的依赖。
|
||
|
||
## NAS 上的 K1412 平台服务
|
||
|
||
| 容器 | 职责 | 是否属于 Agent 核心 |
|
||
| --- | --- | --- |
|
||
| `k1412-agent-web` | Open WebUI 鉴权、RBAC、历史和界面 | 产品外壳 |
|
||
| `k1412-agent-runtime` | Agent Loop 和 Provider 网关 | 是 |
|
||
| `k1412-agent-gateway` | 身份、执行策略、工作区生命周期 | 是 |
|
||
| `k1412-agent-postgres` | Open WebUI 和 Runtime 持久状态 | 状态层 |
|
||
| `k1412-agent-redis` | Open WebUI 协调和缓存 | 状态层 |
|
||
| `k1412-agent-bootstrap` | 幂等的管理员/工具初始化任务 | 运维 |
|
||
|
||
只有 Web 会发布宿主机端口。Runtime、Gateway、PostgreSQL 和 Redis 均位于私有 Compose
|
||
网络。
|
||
|
||
## 物理执行主机
|
||
|
||
`home-node-itx` 是一台专用、可替换的 Docker 执行节点：
|
||
|
||
- Intel Core i3-12100F，4 核 8 线程；
|
||
- 约 14 GiB 可用内存；
|
||
- 120 GB NVMe 系统盘；
|
||
- 500 GB SSD，格式化为 ext4 并挂载到 `/srv/k1412-data`；
|
||
- Docker Root 位于 `/srv/k1412-data/docker`；
|
||
- 用户工作区卷保存在同一块数据盘。
|
||
|
||
NAS Gateway 使用专用 Ed25519 密钥和严格的主机密钥校验进行连接。执行主机不保存 Web
|
||
或数据库密钥。更换执行主机只需要迁移 Docker 卷并修改 SSH 配置，不需要修改 Agent Loop。
|
||
|
||
## Agent 核心
|
||
|
||
用于持续实验的代码包括：
|
||
|
||
- `agent_platform/runtime/loop.py`：Loop 和证据策略；
|
||
- `agent_platform/runtime/context.py`：上下文策略；
|
||
- `agent_platform/runtime/tools.py`：工具和调度元数据；
|
||
- `agent_platform/store.py`：事件、计划和记忆；
|
||
- `agent_platform/gateway/`：隔离执行 Provider。
|
||
|
||
前端品牌、反向代理配置和 Registry 自动化是重要的产品/运维工作，但不属于 Agent 智能。
|