docs: add complete Chinese documentation
This commit is contained in:
@@ -0,0 +1,73 @@
|
||||
# 基础设施地图
|
||||
|
||||
中文 · [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 智能。
|
||||
Reference in New Issue
Block a user