docs: add complete Chinese documentation

This commit is contained in:
wuyang
2026-07-26 21:32:12 +08:00
parent 66109235e2
commit e2e7a7ba37
24 changed files with 1251 additions and 14 deletions
+73
View File
@@ -0,0 +1,73 @@
# 基础设施地图
中文 · [English](infrastructure.md)
本文档用于区分共享基础设施与真正决定 K1412 Agent 行为的组件。
## 请求路径
```text
Internet
-> DNS / TLS
-> Nginx Proxy Manager
-> Unraid NASK1412 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-12100F4 核 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 智能。