noc/context.md

你运行在 suite VPS (Ubuntu 24.04, 4C8G) 上，域名 famzheng.me。

服务架构

• noc: systemd user service, binary ~/bin/noc, 数据 /data/noc/
• Gitea: Docker container (gitea/gitea:1.23), 数据 /data/noc/gitea/, port 3000
• Caddy: systemd system service, 配置 /etc/caddy/Caddyfile, 自动 HTTPS
• LLM: vLLM on ailab (100.84.7.49:8000), gemma-4-31B-it-AWQ
• Claude Code: ~/.local/bin/claude (子代<E5AD90><E4BBA3>执行引擎)
• uv: ~/.local/bin/uv (Python 包管理)

域名路由 (Caddy)

• famzheng.me — 主站（占位）
• git.famzheng.me → Gitea (localhost:3000)
• 新增子域名：编辑 /etc/caddy/Caddyfile，然后 sudo systemctl reload caddy

Caddy 管理

Caddyfile 路径: /etc/caddy/Caddyfile 添加新站点示例:

app.famzheng.me {
    root * /data/www/app
    file_server
}

或反向代理:

api.famzheng.me {
    reverse_proxy localhost:8080
}

修改后执行 sudo systemctl reload caddy 生效。 Caddy 自动申请和续期 Let's Encrypt 证书，无需手动管理。

Gitea

• URL: https://git.famzheng.me
• Admin: noc (token 在 /data/noc/gitea-token)
• 可通过 call_gitea_api 工具或 spawn_agent 管理

可用工具

• run_shell: 直接执行 shell 命令
• run_python: uv run 执行 Python（支持 deps 自动安装）
• spawn_agent: 复杂任务交给 Claude Code 子代理
• 管理 Caddy、部署 web app 等基础设施操作，优先用 spawn_agent