Add AstrBot.md

docs/tech/AI.md

@@ -18,12 +18,13 @@ AI 工具可选种类多，迭代速度快，使用最新的工具不一定是
 
 - Open Code / Codex / Claude Code ==我目前尚未尝试这三尊大佛，相关内容后补==
 - Visual Studio Code Insiders (with GitHub Copilot Chat)
-    - [**Unify Chat Provider**](https://github.com/smallmain/vscode-unify-chat-provider.git): 为 `GitHub Copilot Chat` 添加自定义 API 供应商。
+    - [**Unify Chat Provider**](https://github.com/smallmain/vscode-unify-chat-provider): 为 `GitHub Copilot Chat` 添加自定义 API 供应商。
 
 ### 对接即时聊天工具
 
 - OpenClaw
-- **AstrBot**: 对国内即时聊天工具兼容性好。 ==教程已在路上==
+- Hermes Agent
+- [**AstrBot**](https://blog.cattom.site/tech/AstrBot): 对国内即时聊天工具兼容性好。
 
 ## 积极采用新要素为 AI 赋能
 
@@ -49,48 +50,49 @@ AI 工具可选种类多，迭代速度快，使用最新的工具不一定是
 
 - [anthropics/skills](https://github.com/anthropics/skills)
 - [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/index): 获取即时财经数据与资讯。
-    - [东方财富妙想 Skills (AstrBot 版)](https://github.com/cattomgithub/eastmoney-mx-skills-for-astrbot)
+    - [东方财富妙想 Skills (参考 Anthropic Agent Skills 修改)](https://github.com/cattomgithub/eastmoney-mx-skills-for-astrbot)
 
 ## 选择最符合任务需求的模型
 
 最昂贵的模型不一定能得出最佳的结果，按照实际任务需求选择合适的模型才是兼顾成本与表现的最佳实践。
 
-### DeepSeek V3
-
-- 适合轻量工作，价格低廉。
-- 上下文太小，不会调用 MCP 和 Skills，无法负担复杂工作。
-
 ### MiniMax M2.7
 
-- 垃圾。价格比 Qwen 贵，表现却差之甚远。
+- 价格比 Qwen 贵，表现十分一般。
 
 > 这公司还好意思在香港上市呢...
 
-### Qwen 3.5 / 3.6
+### Qwen 3.6
 
 - 表现处于平均水平。
 - 适合稍困难的工作，价格较便宜。
 
-### Kimi K2.5
+### DeepSeek V4
 
-- 上下文较大，反应速度较快，成果质量较好。
+- 表现接近国模优秀水平。
-- 价格较贵，且有较严格的[速率限制](https://platform.kimi.com/docs/pricing/limits)。
+- 用国产芯片达成如此效果，确实不容易。
+- 仍需要进一步测试。
 
-### GLM 5 / 5.1
+### GLM 5.1
 
 - 反应速度快，成果质量好。
 - 价格贵。
 
-### GPT 5.3 / 5.4
+### Kimi K2.6
 
-- 综合表现优秀，成果质量好。
+- 上下文较大，反应速度快，成果质量好。
-- 价格较贵，风控较严格(热衷于周末封号)。
+- 价格贵，且有较严格的[速率限制](https://platform.kimi.com/docs/pricing/limits)。
 
 ### Claude Opus/Sonnet 4.6
 
-- 可能是目前能力最强的大语言模型。
+- 可能是目前综合能力最强的大语言模型。
 - 价格昂贵，风控严格，不时降智，算力资源捉襟见肘。
 
+### GPT 5.4
+
+- 综合表现优秀，成果质量好。
+- 价格较贵，风控较严格(热衷于周末封号)。
+
 ## 衍生工具
 
 食之无味，弃之可惜。

docs/tech/AstrBot.md

@@ -0,0 +1,317 @@
+# AstrBot 部署与配置
+
+## 部署环境
+
+- AstrBot v4.23.5
+- Mac mini 2024 M4 (macOS Tahoe 26.4.1)
+- OrbStack (Docker & Docker Compose)
+
+## 部署
+
+``` bash
+mkdir ~/astrbot && cd ~/astrbot
+
+touch docker-compose.yml && nano docker-compose.yml
+```
+
+请按照实际情况修改 `docker-compose.yml` 中的相关部分。
+
+``` yaml title="docker-compose.yml"
+name: AstrBot
+services:
+  # shipyard-neo 沙盒环境
+  bay:
+    image: ghcr.io/astrbotdevs/shipyard-neo-bay:latest
+    container_name: bay
+    ports:
+      - "8114:8114"
+    networks:
+      - astrbot-network
+    volumes:
+      # Docker socket — Bay creates sandbox containers dynamically
+      - /var/run/docker.sock:/var/run/docker.sock
+      # Config file
+      - ~/astrbot/bay-config.yml:/app/config.yml:ro
+      # SQLite database persistence
+      - bay-data:/app/data
+      # Cargo storage persistence
+      - bay-cargos:/var/lib/bay/cargos
+    environment:
+      - BAY_CONFIG_FILE=/app/config.yml
+      - BAY_DATA_DIR=/app/data
+    healthcheck:
+      test: [ "CMD", "curl", "-f", "http://localhost:8114/health" ]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 15s
+    logging:
+      driver: json-file
+      options:
+        max-size: "50m"
+        max-file: "5"
+    restart: unless-stopped
+  astrbot:
+    image: soulter/astrbot:latest
+    container_name: astrbot
+    volumes:
+      - ~/astrbot/data:/AstrBot/data
+      - /etc/localtime:/etc/localtime:ro
+    ports:
+      - "6185:6185"
+    networks:
+      - astrbot-network
+    environment:
+      TZ: Asia/Shanghai
+    depends_on:
+      bay:
+        condition: service_healthy
+    logging:
+      driver: json-file
+      options:
+        max-size: "50m"
+        max-file: "3"
+    restart: unless-stopped
+  # 本地语音转文字服务(可选)
+  whisper-local:
+    image: onerahmet/openai-whisper-asr-webservice:latest
+    container_name: whisper-local
+    networks:
+      - astrbot-network
+    environment:
+      ASR_MODEL: base
+    restart: unless-stopped
+
+networks:
+  astrbot-network:
+    name: astrbot-network
+    driver: bridge
+
+volumes:
+  bay-data:
+    name: bay-data
+  bay-cargos:
+    name: bay-cargos
+```
+
+以下是 `shipyard-neo` 的配置文件，请按照实际情况修改，详细内容请参考[官方文档](https://docs.astrbot.app/use/astrbot-agent-sandbox.html)。
+
+``` yaml title="bay-config.yml"
+server:
+  host: "0.0.0.0"
+  port: 8114
+
+database:
+  # SQLite for single-instance deployment.
+  # For HA / multi-instance, switch to PostgreSQL:
+  #   url: "postgresql+asyncpg://user:pass@db-host:5432/bay"
+  url: "sqlite+aiosqlite:///./data/bay.db"
+  echo: false
+
+driver:
+  type: docker
+
+  # Pull latest images when creating new sandboxes.
+  # Production recommendation: "always" ensures you always get the latest image.
+  image_pull_policy: always
+
+  docker:
+    socket: "unix:///var/run/docker.sock"
+
+    # Bay in container, Ship/Gull in container — use container network direct connect
+    connect_mode: container_network
+
+    # Shared network name (must match docker-compose.yaml network)
+    network: "astrbot-network"
+
+    # Disable host port mapping — sandbox containers don't need to be reachable
+    # from outside the Docker network, reducing attack surface.
+    publish_ports: false
+    host_port: null
+
+cargo:
+  root_path: "/var/lib/bay/cargos"
+  default_size_limit_mb: 1024
+  mount_path: "/workspace"
+
+security:
+  # CHANGE-ME: 设置一个强随机密钥 (e.g. `openssl rand -hex 32`)
+  api_key: "CHANGE ME"
+  allow_anonymous: false
+
+# Container proxy environment injection.
+# When enabled, Bay injects HTTP(S)_PROXY and NO_PROXY into sandbox containers.
+proxy:
+  enabled: false
+  # http_proxy: "http://proxy.example.com:7890"
+  # https_proxy: "http://proxy.example.com:7890"
+  # Optional extra entries to append to default NO_PROXY list
+  # no_proxy: "my-internal.service"
+
+# Warm Pool — pre-start standby sandbox instances to reduce cold-start latency.
+# When a user creates a sandbox, Bay will first try to claim an available warm instance,
+# delivering near-instant startup instead of waiting for container boot.
+warm_pool:
+  enabled: true
+  warmup_queue_workers: 2          # Concurrent warmup workers
+  warmup_queue_max_size: 256       # Maximum queue depth
+  warmup_queue_drop_policy: "drop_newest"
+  warmup_queue_drop_alert_threshold: 50
+  interval_seconds: 30             # Pool maintenance scan interval
+  run_on_startup: true
+
+profiles:
+  # ── Standard Python sandbox ────────────────────────
+  - id: python-default
+    description: "Standard Python sandbox with filesystem and shell access"
+    image: "ghcr.io/astrbotdevs/shipyard-neo-ship:latest"
+    runtime_type: ship
+    runtime_port: 8123
+    resources:
+      cpus: 1.0
+      memory: "1g"
+    capabilities:
+      - filesystem  # includes upload/download
+      - shell
+      - python
+    idle_timeout: 1800  # 30 minutes
+    warm_pool_size: 1   # Keep 1 pre-warmed instance ready
+    # Environment variables injected into the runtime container (available in Python and Shell)
+    # Example: env: { TZ: "Asia/Shanghai", LANG: "en_US.UTF-8", CUSTOM_VAR: "value" }
+    env: {}
+    # Optional profile-level proxy override
+    # proxy:
+    #   enabled: false
+
+  # ── Data Science sandbox (more resources) ──────────
+  - id: python-data
+    description: "Data science sandbox with extra CPU and memory"
+    image: "ghcr.io/astrbotdevs/shipyard-neo-ship:latest"
+    runtime_type: ship
+    runtime_port: 8123
+    resources:
+      cpus: 2.0
+      memory: "4g"
+    capabilities:
+      - filesystem  # includes upload/download
+      - shell
+      - python
+    idle_timeout: 1800
+    warm_pool_size: 1
+    env: {}
+
+  # ── Browser + Python multi-container sandbox ───────
+  - id: browser-python
+    description: "Browser automation with Python backend"
+    containers:
+      - name: ship
+        image: "ghcr.io/astrbotdevs/shipyard-neo-ship:latest"
+        runtime_type: ship
+        runtime_port: 8123
+        resources:
+          cpus: 1.0
+          memory: "1g"
+        capabilities:
+          - python
+          - shell
+          - filesystem  # includes upload/download
+        primary_for:
+          - filesystem
+          - python
+          - shell
+        env: {}
+      - name: browser
+        image: "ghcr.io/astrbotdevs/shipyard-neo-gull:latest"
+        runtime_type: gull
+        runtime_port: 8115
+        resources:
+          cpus: 1.0
+          memory: "2g"
+        capabilities:
+          - browser
+        env: {}
+    idle_timeout: 1800
+    warm_pool_size: 1
+
+gc:
+  # Enable automatic GC for production
+  enabled: true
+  run_on_startup: true
+  interval_seconds: 300  # 5 minutes
+
+  # Instance identifier — MUST be unique in multi-instance deployments
+  instance_id: "bay-prod"
+
+  idle_session:
+    enabled: true
+  expired_sandbox:
+    enabled: true
+  orphan_cargo:
+    enabled: true
+  orphan_container:
+    # Enable in production to clean up leaked containers.
+    # Safe as long as instance_id is unique per Bay instance.
+    enabled: true
+```
+
+最后，拉取镜像，启动服务。
+
+``` bash
+sudo docker compose pull
+sudo docker compose up -d
+```
+
+## 配置
+
+服务启动成功后，浏览器访问 `<ip>:6185` 进入 AstrBot 仪表盘。
+
+### 添加模型提供商
+
+点击“新增”，找到希望添加的模型提供商，然后按照模型提供商的 API 文档填写 `API Key` 和 `API Base URL`。
+
+阿里云百炼可选择 `OpenAI Compatible`。
+
+语音转文字模型提供商选择 `Whisper(API)`，API Base URL 填写 `http://whisper-local:9000/v1`，模型 ID 填写 `base`。
+
+### 修改默认配置文件
+
+**模型**
+
+- **启用语音转文本(可选)**: True
+- **默认语音转文本模型**: (选择刚刚添加的语音转文字模型)
+
+**网页搜索**
+
+使用网页搜索功能需要注册 [Tavily](https://app.tavily.com/home)。
+
+- **启用网页搜索**: True
+- **网页搜索提供商**: Tavily
+- **Tavily API Key**: (填写你的 Tavily API Key)
+
+**使用电脑能力**
+
+- **运行环境**: sandbox
+- **需要 AstrBot 管理员权限**: (按实际情况)
+- **沙箱环境驱动器**: shipyard_neo
+- **Shipyard Neo API Endpoint**: http://bay:8114
+- **Shipyard Neo 访问令牌**: (bay-config.yml - security - api_key)
+- **Shipyard Neo Profile**: python-default / python-data / browser-python
+- **Shipyard Neo Sandbox 存活时间(秒)**: 3600
+
+**其他配置**
+
+- **流式输出**: True
+- **不支持流式回复的平台**: 实时分段回复
+- **现实世界时间感知**: True
+- **工具调用轮数上限**: 50
+- **工具调用超时时间(秒)**: 600
+- **工具调用模式**: full
+
+### 人格设定(可选)
+
+- 填写完备的系统提示词
+- 选择可用的函数工具和 Skills
+
+### 接入即时聊天软件
+
+推荐接入个人微信，参考[官方文档](https://docs.astrbot.app/platform/weixin_oc.html)进行配置。

mkdocs.yml

@@ -91,25 +91,26 @@ nav:
       - "原发免疫性血小板减少症 (ITP)": life/ITP.md
   - "技术": 
       - tech/index.md
-      - "AI 折腾心得": tech/AI.md
       - "专治各类疑难杂症": tech/Snippets.md
+      - "AI 折腾心得": tech/AI.md
       - "Mi 6 (sagit)": tech/Mi6(sagit).md
       - "极1S (HC5661)": tech/HC5661.md
       - "小米 CR6608": tech/CR6608.md
       - "Mi 8 UD (equuleus)": tech/Mi8UD(equuleus).md
       - "Redmi 4X (santoni)": tech/Redmi4X(santoni).md
-      - "2026年3月18日事故": tech/2026-3-18.md
+      - "PicoKeys: YubiKey 的开源平替": tech/Picokeys.md
-      - "定制 Debian 13 镜像": tech/Customize-Debian-13-Image.md
+      - "AstrBot 部署与配置": tech/AstrBot.md
       - "Backrest: 备份新选择": tech/Backrest.md
       - "安装和配置 Proxmox 9": tech/Proxmox-9.md
-      - "PicoKeys: YubiKey 的开源平替": tech/Picokeys.md
-      - "手把手教你备份和还原 Docker 卷": tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md
-      - "在 Ubuntu 24.04 上添加交换空间": tech/How-to-Add-Swap-Space-on-Ubuntu-2404.md
       - "安装和配置 Material for MkDocs": tech/Install-Material-for-MkDocs.md
       - "安装与配置 Proxmox Backup Server 4": tech/Proxmox-Backup-Server-4-1.md
       - "Authentik: 搭建属于自己的单点登录服务": tech/Authentik.md
+      - "定制 Debian 13 镜像": tech/Customize-Debian-13-Image.md
+      - "手把手教你备份和还原 Docker 卷": tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md
+      - "在 Ubuntu 24.04 上添加交换空间": tech/How-to-Add-Swap-Space-on-Ubuntu-2404.md
       - "创建和管理 Linux 服务器用于身份验证的 SSH 密钥": tech/Creating-and-Managing-SSH-Keys-for-Authentication-on-Linux-Servers.md
       - "服务器运行与维护常用命令": tech/Commands-for-Server-Operation-and-Maintenance.md
+      - "2026年3月18日事故": tech/2026-3-18.md
   - "财经": 
       - finance/index.md
       - "每日复盘":