蛤布斯堡

森林与教室

Mon, 06 Apr 2026 00:00:00 +0000

森林与教室 🔗

一 🔗

中国的科幻读者近年长进了不少，竟参透了宇宙的终极奥义。这奥义据说是从两条公理推导出来的，凝练，庄严，有着数学般的冰冷美感。曰：生存是文明的第一需要。又曰：文明不断增长和扩张，但宇宙中的物质总量保持不变。由此推演，便得出了一片黑暗森林，宇宙中每一个文明都是带枪的猎人，在林间潜行，看见活物便开枪，因为不开枪的下场是自己先被打死。

好一个宇宙的终极奥义。

这套东西在社交媒体上大获成功，引用者众，信奉者更众。有人拿它解释国际关系，有人拿它解释职场竞争，有人拿它解释为何不能对邻居太好。总之，从银河系到隔壁老王，无一不可纳入法则管辖范围之内。它给了一代人一种廉价的清醒感：你看，我可不是什么天真的小布尔乔亚，我懂得宇宙的残酷真相。我读过《三体》。这最后一句，说出时往往微仰着头，面有得色，仿佛经此一悟，便与那些谈什么友谊和爱的幼稚之辈划清了界限似的。

森林与教室：危机叙事中的政治伦理想象

Mon, 06 Apr 2026 00:00:00 +0000

森林与教室：危机叙事中的政治伦理想象 🔗

ZeroClaw-01-系统整体架构深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-01-系统整体架构深度解析 🔗

本文档深度剖析 ZeroClaw 的核心业务流转机制，从产品经理视角到代码实现细节，帮助全面理解系统架构。

适合阅读人群：产品经理、业务分析师、技术负责人、架构师、核心开发者

ZeroClaw-02-安全模型与权限控制深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-02-安全模型与权限控制深度解析 🔗

深入解析 ZeroClaw 的五层安全防护体系，从设计原理到代码实现，理解每一个安全决策的取舍。

适合阅读人群：安全负责人、架构师、运维工程师、合规人员

引言：为什么安全对 AI Agent 至关重要？ 🔗

AI Agent 的特殊安全风险 🔗

传统应用是"被动"的——等待用户输入后响应。但 AI Agent 是"主动"的：

ZeroClaw-03-记忆系统深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-03-记忆系统深度解析 🔗

深入解析 ZeroClaw 的混合搜索记忆系统，从设计原理到代码实现，理解 AI 如何实现"长期记忆"。

适合阅读人群：AI 应用设计师、架构师、算法工程师、核心开发者

ZeroClaw-04-多渠道消息处理深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-04-多渠道消息处理深度解析 🔗

深入解析 ZeroClaw 如何统一处理来自 15+ 消息平台的消息，实现真正的"全渠道 AI 助手"。

适合阅读人群：产品经理、渠道对接开发者、架构师

引言：为什么需要多渠道？ 🔗

用户分散在各种平台 🔗

开发者在 Discord 上活跃
商务人员在 Slack 上工作
国内用户使用 Telegram 或微信
海外用户习惯 WhatsApp

传统方案的问题：

ZeroClaw-05-工具执行生命周期深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-05-工具执行生命周期深度解析 🔗

深入解析 ZeroClaw 的工具系统，理解 AI 如何从"聊天"升级为"行动"。

适合阅读人群：技术负责人、工具开发者、架构师

ZeroClaw-06-配置与部署深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-06-配置与部署深度解析 🔗

深入解析用户从0到1上手 ZeroClaw 的完整路径，理解配置系统的设计和部署最佳实践。

适合阅读人群：产品经理、运维工程师、技术支持、DevOps

引言：新用户的第一次体验 🔗

用户的心理历程 🔗

阶段	心态	ZeroClaw 的设计目标
好奇	“听说这个 AI 助手很强大，想试试”	吸引注意，降低门槛
困惑	“怎么安装？需要什么条件？”	清晰的文档，一键安装
尝试	“按照文档一步步操作”	引导配置，即时反馈
惊喜	“哇，真的能帮我写代码！”	快速验证价值
依赖	“每天都离不开它了”	稳定可靠，持续优化

一、用户上手旅程地图 🔗

1.1 完整用户旅程 🔗

journey
    title ZeroClaw 用户上手旅程
    section 发现阶段
      了解 ZeroClaw: 5: 用户
      阅读文档: 4: 用户
      决定尝试: 5: 用户
    section 准备阶段
      检查系统要求: 3: 用户
      安装依赖: 2: 用户, System
      克隆仓库: 4: 用户
    section 安装阶段
      运行引导脚本: 5: 用户
      配置 API Key: 3: 用户, Provider
      选择渠道: 4: 用户
    section 验证阶段
      首次对话: 5: 用户, Agent
      测试工具: 4: 用户, Agent
      配置 Gateway: 3: 用户
    section 生产阶段
      启动 Daemon: 4: 用户, System
      日常使用: 5: 用户, Agent
      分享推荐: 5: 用户

1.2 决策分支图 🔗

flowchart TD
    START["开始"] --> CHOICE1{"部署环境?"}
    
    CHOICE1 -->|"本地开发"| LOCAL["本地开发路径"]
    CHOICE1 -->|"服务器部署"| SERVER["服务器部署路径"]
    CHOICE1 -->|"边缘设备"| EDGE["边缘设备路径"]
    
    LOCAL --> L1["快速安装"]
    L1 --> L2["Shell/CLI 模式"]
    L2 --> L3["可选：配置 Gateway"]
    
    SERVER --> S1["安全安装"]
    S1 --> S2["Docker 沙箱"]
    S2 --> S3["配置隧道"]
    S3 --> S4["启动 Daemon"]
    
    EDGE --> E1["交叉编译"]
    E1 --> E2["轻量配置"]
    E2 --> E3["启动 Daemon"]
    
    L3 & S4 & E3 --> END["生产使用"]
    
    style LOCAL fill:#afa,stroke:#333
    style SERVER fill:#bbf,stroke:#333
    style EDGE fill:#ffa,stroke:#333

二、配置系统架构 🔗

2.1 配置加载层次 🔗

flowchart TB
    subgraph 配置来源["配置来源（优先级从高到低）"]
        CLI["命令行参数
--config /path"]
        ENV["环境变量
ZEROCLAW_API_KEY"]
        FILE["配置文件
~/.zeroclaw/config.toml"]
        DEFAULT["默认值"]
    end

    subgraph 合并逻辑["合并逻辑"]
        MERGE["后加载覆盖先加载"]
    end

    subgraph 最终配置["最终配置"]
        CONFIG["Config 结构体"]
    end

    DEFAULT --> MERGE
    FILE --> MERGE
    ENV --> MERGE
    CLI --> MERGE
    MERGE --> CONFIG

2.2 配置结构代码 🔗

// src/config/mod.rs
use serde::Deserialize;

#[derive(Debug, Deserialize, Clone)]
pub struct Config {
    /// API Key（可从环境变量读取）
    #[serde(default)]
    pub api_key: Option<String>,
    
    /// 默认 Provider
    #[serde(default = "default_provider")]
    pub default_provider: String,
    
    /// 默认模型
    pub default_model: Option<String>,
    
    /// 记忆配置
    #[serde(default)]
    pub memory: MemoryConfig,
    
    /// 网关配置
    #[serde(default)]
    pub gateway: GatewayConfig,
    
    /// 权限配置
    #[serde(default)]
    pub autonomy: AutonomyConfig,
    
    /// 运行时配置
    #[serde(default)]
    pub runtime: RuntimeConfig,
    
    /// 渠道配置
    #[serde(default)]
    pub channels_config: HashMap<String, ChannelConfig>,
}

fn default_provider() -> String {
    "openrouter".to_string()
}

#[derive(Debug, Deserialize, Clone)]
pub struct MemoryConfig {
    #[serde(default = "default_memory_backend")]
    pub backend: String,
    
    #[serde(default = "true")]
    pub auto_save: bool,
    
    pub embedding_provider: Option<String>,
}

fn default_memory_backend() -> String {
    "sqlite".to_string()
}

#[derive(Debug, Deserialize, Clone)]
pub struct GatewayConfig {
    #[serde(default = "default_host")]
    pub host: String,
    
    #[serde(default = "default_port")]
    pub port: u16,
    
    #[serde(default)]
    pub require_pairing: bool,
    
    #[serde(default)]
    pub allow_public_bind: bool,
}

fn default_host() -> String {
    "127.0.0.1".to_string()
}

fn default_port() -> u16 {
    3000
}

2.3 配置加载实现 🔗

// src/config/loader.rs
use config::{Config, ConfigError, Environment, File};

pub fn load_config(cli_path: Option<&Path>) -> Result<AppConfig, ConfigError> {
    let mut builder = Config::builder();
    
    // 1. 加载默认配置
    builder = builder.set_default("default_provider", "openrouter")?;
    
    // 2. 加载配置文件（优先级：命令行指定 > 默认路径）
    let config_path = cli_path
        .map(|p| p.to_path_buf())
        .or_else(|| dirs::config_dir().map(|d| d.join("zeroclaw/config.toml")));
        
    if let Some(path) = config_path {
        if path.exists() {
            builder = builder.add_source(File::from(path));
        }
    }
    
    // 3. 加载环境变量（ZEROCLAW_ 前缀）
    builder = builder.add_source(
        Environment::with_prefix("ZEROCLAW")
            .separator("_")
            .try_parsing(true)
    );
    
    // 4. 构建配置
    let config = builder.build()?;
    
    // 5. 反序列化为结构体
    config.try_deserialize::<AppConfig>()
}

2.4 环境变量覆盖 🔗

// 环境变量命名规则
// ZEROCLAW_<SECTION>_<KEY>

// 示例：
ZEROCLAW_API_KEY=sk-xxx
ZEROCLAW_DEFAULT_PROVIDER=openai
ZEROCLAW_MEMORY_BACKEND=postgres
ZEROCLAW_GATEWAY_HOST=0.0.0.0
ZEROCLAW_GATEWAY_PORT=8080

// 数组使用逗号分隔
ZEROCLAW_AUTONOMY_ALLOWED_COMMANDS=git,ls,cat,grep

为什么支持环境变量？

ZeroClaw-07-Provider生态与选型深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-07-Provider生态与选型深度解析 🔗

深入解析 ZeroClaw 支持的 AI 模型提供商生态，从设计原理到代码实现，理解如何在成本、质量、速度之间做出最优选择。

适合阅读人群：技术决策者、架构师、成本控制人员

ZeroClaw-08-项目代码组织结构深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-08-项目代码组织结构深度解析 🔗

本文档深入剖析 ZeroClaw 的代码库组织方式，解释每一个设计决策背后的思考，帮助开发者理解"为什么这样组织"而不仅是"怎样组织"。

ZeroClaw-09-Rust模块与Trait架构深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-09-Rust模块与Trait架构深度解析 🔗

深入解析 ZeroClaw 如何使用 Rust 的类型系统和 Trait 构建可扩展架构，理解每一个设计决策背后的权衡。

适合阅读人群：Rust 开发者、架构师、想深入理解 ZeroClaw 核心设计的工程师

ZeroClaw-10-构建系统深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-10-构建系统深度解析 🔗

深入解析 ZeroClaw 的 Cargo 配置、优化策略、交叉编译和 CI/CD，理解每一个编译参数背后的取舍。

适合阅读人群：Rust 开发者、DevOps 工程师、需要优化构建流程的工程师

ZeroClaw-11-开发工作流与测试深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-11-开发工作流与测试深度解析 🔗

深入解析 ZeroClaw 的 Git 工作流、代码标准、测试策略，理解每一个流程设计的背后考量。

适合阅读人群：ZeroClaw 贡献者、DevOps 工程师、关注代码质量的工程师

ZeroClaw-12-源码级依赖分析深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-12-源码级依赖分析深度解析 🔗

深入解析 Cargo.toml 中的每一个依赖，理解为什么选它、替代方案是什么、取舍分析。

适合阅读人群：想了解 ZeroClaw 技术选型的工程师、需要优化依赖的开发者

引言：依赖选择的重要性 🔗

依赖是技术债务的一种形式。

每一个依赖都意味着：

ZeroClaw-13-bootstrap与安装系统源码分析深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-13-bootstrap与安装系统源码分析深度解析 🔗

深入解析 bootstrap.sh 安装脚本的每一行代码，理解错误处理、安全考虑、跨平台兼容的设计决策。

适合阅读人群：想了解 ZeroClaw 安装流程的开发者、需要编写类似脚本的 DevOps 工程师

ZeroClaw-14-核心模块源码走读深度解析

Thu, 19 Feb 2026 12:00:00 +0800

ZeroClaw-14-核心模块源码走读深度解析 🔗

深入阅读 main.rs、lib.rs 和核心模块源码，理解入口点、模块结构和执行流程。

适合阅读人群：想深入了解 ZeroClaw 内部实现的开发者、需要调试或扩展代码的工程师

消失的入场券：在被透支的世界里，全球青年为何集体拒绝“接盘”？

Wed, 24 Dec 2025 00:00:00 +0000

从东京街头只身一人的“草食男”（Herbivore Men），到纽约外卖快餐中的“白人饭”（White People Meal），再到东亚社交媒体上广泛流传的“躺平”自嘲，一种无色无味的“低欲望”迷雾正在全球年轻一代中蔓延。这并非某个国家的特殊病灶，而是一场跨越国界的集体共振。我们曾以为这仅仅是意志的消沉或竞争的逃避，但当我们深入剖析当前资本体系的底层架构时，会发现这背后隐藏着一个令人心碎的真相：对于当下的年轻人来说，传统意义上的“努力”正逐渐沦为一场回报率为负的虚无游戏。

🌱 Spec Kit: A Specification-Driven Development Framework

Mon, 22 Sep 2025 00:00:00 +0000

🌱 Spec Kit

Build high-quality software faster.

借助 Spec-Driven Development，让组织能够专注于产品场景，而不是编写无差异化的代码。

🤔 什么是 Spec-Driven Development？ 🔗

Spec-Driven Development 颠覆了传统的软件开发方式。在过去的几十年里，代码一直是核心——规范只是辅助的脚手架，一旦“真正的工作”开始，规范便被丢弃。Spec-Driven Development 改变了这一点：规范变为可执行的，它们直接生成可工作的实现，而不仅仅是指导实现。

ClaudeCode Hook 中文文档

Mon, 22 Sep 2025 06:02:34 +0800

这份文档详细介绍了 Claude Code Hooks 的配置与使用方法。Hooks 提供了一种灵活的机制，让你能够在 Claude Code 的不同事件触发点（如工具调用前后、会话开始或结束、用户提交提示时等）自动执行自定义脚本或命令。通过合理配置钩子，你可以扩展 Claude Code 的能力，实现工作流自动化、代码质量检查、安全策略执行以及项目环境定制化等功能。文档同时涵盖了输入输出规范、安全注意事项、调试方法以及与 MCP 工具的集成方式，帮助你在保证安全和稳定的前提下，充分发挥 Claude Code 的可扩展性。

ClaudeCode Subagents 中文文档

Mon, 22 Sep 2025 06:02:34 +0800

mindmap
  root((Claude Code 子代理指南))
    什么是子代理
      子代理的定义
      特点
        特定用途和专业领域
        独立上下文窗口
        可配置工具
        自定义系统提示
      委派任务
    关键优势
    快速开始
    子代理配置
      文件位置
        项目子代理
        用户子代理
      文件格式
      配置字段
        name
        description
        tools
        model
      模型选择
      可用工具
    管理子代理
      使用 /agents 命令
      直接文件管理
    有效使用子代理
      自动委派
      显式调用
      示例子代理
        代码审查员
        调试器
        数据科学家
    最佳实践
      从 Claude 生成的子代理开始
      设计专注的子代理
      编写详细提示
      限制工具访问
      版本控制
    高级用法
      子代理链式调用
      动态子代理选择
    性能考量
      上下文效率
      延迟
    更多资源
      斜杠命令
      设置
      Hooks

Claude Code 中的自定义子代理（Custom subagents）是专门的 AI 助手，可以被调用来处理特定类型的任务。它们通过提供针对任务的定制化系统提示（system prompts）、工具以及独立的上下文窗口，从而实现更高效的问题解决。

规范驱动开发（SDD）全解：从理念到实践

Sun, 21 Sep 2025 00:00:00 +0000

mindmap
  root((规范驱动开发 SDD))
    ("权力的反转")
      ("代码曾为王，规范附庸")
      ("SDD 反转：代码服务于规范")
      ("消除规范与实现的鸿沟")
      ("AI 让规范可执行")
    ("SDD 工作流实践")
      ("从模糊想法到完整 PRD")
      ("AI 提问澄清 → 定义验收标准")
      ("研究代理收集上下文")
      ("生成实现计划：技术决策可追溯")
      ("规范驱动测试与代码生成")
      ("生产反馈 → 更新规范")
    ("为什么 SDD 恰逢其时")
      ("AI 已能可靠生成代码")
      ("软件复杂性指数级增长")
      ("需求变化更频繁")
      ("SDD 将变更转化为系统性再生成")
    ("核心原则")
      ("规范是通用语言")
      ("规范可执行")
      ("持续精炼")
      ("研究驱动上下文")
      ("双向反馈")
      ("分支探索优化目标")
    ("实施途径")
      ("AI 助手：迭代规范")
      ("研究代理：收集上下文")
      ("代码生成工具")
      ("版本控制：规范优先")
      ("AI 一致性检查")
    ("命令简化 SDD")
      ("/specify → 生成规范")
      ("/plan → 实现计划")
      ("/tasks → 可执行任务清单")
      ("示例：聊天功能开发")
    ("结构化自动化")
      ("模板保障完整性与一致性")
      ("避免过早实现细节")
      ("强制标记不确定性")
      ("清单驱动结构化思考")
      ("架构关卡：简洁/反抽象/集成优先")
      ("分层信息架构")
      ("测试优先顺序")
      ("避免推测性功能")
    ("复合效应")
      ("规范完整、无歧义、可测试、可维护、可实现")
      ("LLM 从写手 → 规范工程师")
    ("宪法基础")
      ("九条原则")
        ("库优先")
        ("CLI 强制")
        ("测试优先")
        ("简洁 & 反抽象")
        ("集成优先测试")
      ("模板执行：关卡检查")
      ("不可变原则：保持一致与质量保障")
      ("宪法演化：修订流程")
      ("开发哲学：可观测、简洁、集成、模块化")
    ("转变")
      ("不是取代开发者，而是增强能力")
      ("通过可执行规范保持意图与实现的对齐")

权力的反转 🔗

几十年来，代码一直是王者。规范服务于代码——它们是我们搭建的脚手架，而一旦“真正的工作”——写代码——开始了，规范就被丢弃。我们写 PRD（产品需求文档）来指导开发，写设计文档来辅助实现，画架构图来帮助可视化。但这些始终从属于代码本身。代码才是事实真相，其它最多只是“美好意图”。代码是唯一的真理来源，而当代码不断演进时，规范几乎从来跟不上。由于资产（代码）和实现是同一个东西，没有直接基于代码去构建，就很难做到并行实现。

Docker部署cloudflared并且用sing-box 添加前置代理

Wed, 01 May 2024 00:00:00 +0000

SingBox 安装使用 🔗

建议使用 docker-compose 部署，先看 Cloudflare Tunnel 速度慢？尝试给它加个前置代理提高速度 - Xiaomage’s Blog 和 https://sing-box.sagernet.org/zh/configuration/inbound/tun/ 来学习哪些需要走透明代理，怎么搞透明代理。

docker-compose 部署 singbox 🔗

给一个例子:

version: "3"

networks:
  proxy:
    external: true

services:
  sing-box:
    image: ghcr.io/sagernet/sing-box
    container_name: sing-box
    restart: always
    network_mode: host
    privileged: true
    cap_add:
      - NET_ADMIN
    volumes:
      - ./singbox:/etc/sing-box/
    command: -D /var/lib/sing-box -C /etc/sing-box/ run

配置文件例子，注意按需添加自己的服务器。

使用 Windows 自带 ssh 的 X11转发功能并配置 ssh 和 VSCode

Sun, 09 Jul 2023 00:00:00 +0000

注意本教程也适用于 MacOS 和 Linux 哦。

1. 确认自带的 ssh 支持 X11 forwarding 🔗

一般来说 Windows 10 version 1809 及之后的 Windows 版本都内置了 ssh 客户端，这个客户端是带有 X11 功能的。但是，直到 ssh 客户端到 version 8.1p1 时才完整的实现了对 X11 forwarding 的支持。

Eigen 库学习指南1-稠密矩阵和数组的运算(一)

Wed, 18 Jan 2023 00:00:00 +0000

翻译: Qi Deng

简介 🔗

Eigen 的介绍 🔗

Eigen 是一个高级 C++ 库，包含用于线性代数、矩阵和向量运算、几何变换、数值求解器和相关算法的模板头文件。 Eigen 是自 3.1.1 版起根据 Mozilla Public License 2.0 许可的开源软件。早期版本是根据 GNU 宽松通用公共许可证获得许可的。 [2] 1.0 版于 2006 年 12 月发布

Eigen 库学习指南2-稠密矩阵和数组的运算(二)

Wed, 18 Jan 2023 00:00:00 +0000

翻译: Qi Deng

切片和索引 🔗

高级初始化 🔗

逗号表达式 -> 之前已经提过了 🔗

特殊矩阵和数组 🔗

Matrix 和 Array 类有像 Zero() 这样的静态方法，可用于将所有系数初始化为零。共有三种变体。第一个变体不带参数，只能用于固定大小的对象。如果要将动态大小的对象初始化为零，则需要指定大小。因此，第二个变体需要一个参数，可用于一维动态大小的对象，而第三个变体需要两个参数，可用于二维对象。以下示例说明了所有三种变体：

Markdown Syntax Guide

Sun, 11 Mar 2018 00:00:00 +0000

This article offers a sample of basic Markdown syntax that can be used in Hugo content files, also it shows whether basic HTML elements are decorated with CSS in a Hugo theme.

Rich Content

Sat, 10 Mar 2018 00:00:00 +0000

Hugo ships with several Built-in Shortcodes for rich content, along with a Privacy Config and a set of Simple Shortcodes that enable static and no-JS versions of various social media embeds.