wuyang/zk-data-agent

Files

T

wuyang e2e7a7ba37 docs: add complete Chinese documentation

2026-07-26 21:32:12 +08:00

2.7 KiB

Raw Blame History

基础设施地图

中文 · English

本文档用于区分共享基础设施与真正决定 K1412 Agent 行为的组件。

请求路径

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 智能。