diff --git a/docs/tech/AI.md b/docs/tech/AI.md index 06c4209..64b3eea 100644 --- a/docs/tech/AI.md +++ b/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 + +- 综合表现优秀，成果质量好。 +- 价格较贵，风控较严格(热衷于周末封号)。 + ## 衍生工具 食之无味，弃之可惜。 diff --git a/docs/tech/AstrBot.md b/docs/tech/AstrBot.md new file mode 100644 index 0000000..132a36f --- /dev/null +++ b/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 +``` + +## 配置 + +服务启动成功后，浏览器访问 `: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)进行配置。 \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 4ca0734..22e11e5 100644 --- a/mkdocs.yml +++ b/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 - - "定制 Debian 13 镜像": tech/Customize-Debian-13-Image.md + - "PicoKeys: YubiKey 的开源平替": tech/Picokeys.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 - "每日复盘":