@agentunion/fastaun-browser 0.2.19 → 0.3.0

package/_packed_docs/protocol/15-/347/246/273/347/272/277/346/216/250/351/200/201/351/200/232/347/237/245/345/215/217/350/256/256.md

@@ -0,0 +1,419 @@
+# 15 - 离线推送通知协议 (Push Notification)
+
+## 1. 概述
+
+当目标 AID 的所有设备均离线时，AUN Gateway 通过事件通知将推送摘要发送给 `push_notify_aid`（推送代理 AID），由其完成最终的平台推送（APNs / FCM / WebPush 等）。
+
+**设计原则：**
+
+- push_notify_aid 是普通客户端 AID，不是 AUN 内部服务
+- 通过事件通知（非 P2P 消息）下发推送摘要——轻量、实时、不持久化
+- push_token 对 Gateway 完全不透明（opaque），push_notify_aid 自签自验
+- 任意一台设备在线即不触发推送
+- 推送内容仅含元数据，不含消息正文（E2EE 安全保证）
+- 背压控制：串行确认，Gateway 等 push_notify_aid ack 后再发下一批
+- 跨域推送：推送由**目标 AID 所属域**的 Gateway 触发，发送方域不参与
+
+---
+
+## 2. 架构
+
+```mermaid
+graph TB
+    Sender[发送方 AID] -->|message.send| GW[Gateway]
+    GW -->|目标全部离线| PA[PushAggregator]
+    PA -->|event/push.offline_message| GW
+    GW -->|事件通知| PNA[push_notify_aid<br/>推送代理客户端]
+    PNA -->|push.ack| GW
+    PNA -->|平台推送| PLATFORM[APNs / FCM / WebPush]
+    PLATFORM -->|通知| Target[目标终端]
+
+    PNA -.->|connect 到 Gateway 保持在线| GW
+```
+
+**关键约束：**
+
+- push_notify_aid 作为普通客户端 AID 连接到 Gateway，通过事件通知接收推送摘要
+- push_notify_aid 离线时事件丢弃——推送是 best-effort，消息可靠性由 message.pull 保证
+- 目标 AID 有任意一台设备在线时，不触发推送
+
+---
+
+## 3. 推送注册流程
+
+### 3.1 应用层：客户端向推送代理注册
+
+```mermaid
+sequenceDiagram
+    participant App as 应用客户端
+    participant PNA as push_notify_aid
+
+    Note over App,PNA: 应用层行为，AUN 协议不规定细节
+    App->>PNA: 注册推送(aid, device_id, platform, device_token)
+    PNA->>PNA: 生成 push_token（格式自定）
+    PNA-->>App: push_token
+```
+
+push_token 的格式、签名算法、有效期完全由 push_notify_aid 自行决定。AUN 协议不做任何约束。
+
+### 3.2 协议层：connect 时携带推送配置
+
+```mermaid
+sequenceDiagram
+    participant C as Client
+    participant GW as Gateway
+
+    C->>GW: connect(aid, token, push_notify_aid, push_token)
+    GW->>GW: 认证 AID 身份 ✓
+    GW->>GW: 持久化 push_config
+    GW-->>C: connected
+```
+
+---
+
+## 4. 离线推送时序
+
+```mermaid
+sequenceDiagram
+    participant A as Sender AID
+    participant GW as Gateway
+    participant PA as PushAggregator
+    participant PNA as push_notify_aid
+
+    A->>GW: message.send(to=B, payload=...)
+    GW->>GW: 持久化消息 + 查询 B 在线状态
+
+    alt B 有任意设备在线
+        GW->>GW: 投递到 B 的在线 session
+        Note over GW: 不触发推送
+    else B 全部设备离线
+        GW->>PA: enqueue(target=B, from=A, msg_id, ts)
+        PA->>PA: 聚合窗口 + 频控 + 背压检查
+
+        alt 触发推送 且 in_flight < max
+            PA->>GW: event/push.offline_message
+            GW->>PNA: 事件通知(batch_id, summary, push_token)
+            PA->>PA: in_flight++, 启动 ack_timeout
+            PNA->>PNA: 验证 push_token ✓ → 发送平台推送
+            PNA->>GW: push.ack(batch_id)
+            GW->>PA: release(batch_id)
+            PA->>PA: in_flight--
+        else in_flight = max（背压）
+            PA->>PA: 排队等待槽位释放
+        else 频控抑制
+            PA->>PA: 延迟到下一窗口
+        end
+    end
+
+    GW-->>A: ack(msg_id, seq)
+```
+
+---
+
+## 5. 背压与 in-flight 控制
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle: 初始状态
+    Idle --> Sending: 有待推送 & in_flight < max
+    Sending --> WaitAck: 事件已发出, in_flight++
+    WaitAck --> Idle: 收到 push.ack, in_flight--
+    WaitAck --> Idle: ack_timeout 超时, in_flight--
+    WaitAck --> Queued: 新推送到达但 in_flight = max
+    Queued --> Sending: 槽位释放
+```
+
+### 参数
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| max_in_flight | 1 | 同一 push_notify_aid 未确认批次上限（串行） |
+| ack_timeout | 30s | 超时未 ack 自动释放槽位 |
+| batch_size | 50 | 每批最多聚合多少个 target_aid 的通知 |
+
+### 行为规则
+
+- in_flight < max → 发送事件，in_flight++
+- in_flight = max → 排队等待
+- 收到 `push.ack(batch_id)` → in_flight--，触发队列中下一批
+- 超时 → in_flight--，**不重试**（推送是 best-effort，过时推送是噪音）
+- push_notify_aid 离线 → 事件丢弃，in_flight 不增加
+
+---
+
+## 6. 在线判断规则
+
+```mermaid
+flowchart TD
+    A[消息到达，目标 AID = B] --> B{B 的在线设备数 > 0?}
+    B -->|≥ 1 台在线| C[投递到在线 session，不推送]
+    B -->|0 台在线| D{push_config 存在?}
+    D -->|是| F[进入 PushAggregator]
+    D -->|否| G[仅持久化，等对方上线 pull]
+    F --> H[聚合 + 频控 + 背压 → 推送]
+```
+
+**边界情况：**
+
+- 目标 AID 上线瞬间：清空该 AID 的聚合桶，取消待发推送
+- 最后一台设备断连：不立即触发推送，只有后续新消息到达时发现全离线才走推送路径
+
+---
+
+## 7. 跨域推送
+
+**核心原则：推送由目标 AID 所属域的 Gateway 触发。**
+
+发送方域不感知目标域的 push_config 和白名单，也不需要任何跨域配置同步。
+
+```mermaid
+sequenceDiagram
+    participant A as alice.domain-a.com
+    participant GW_A as Gateway A
+    participant GW_B as Gateway B
+    participant PA_B as PushAggregator B
+    participant PNA as push.domain-b.com<br/>(连在 GW_B)
+
+    A->>GW_A: message.send(to=bob.domain-b.com)
+    GW_A->>GW_A: 持久化消息
+    GW_A->>GW_B: 跨域 relay 消息
+    GW_B->>GW_B: 查询 bob 本地在线状态
+
+    alt bob 在本域有设备在线
+        GW_B->>GW_B: 投递到 bob 的在线 session
+    else bob 本域全部离线
+        GW_B->>PA_B: enqueue(target=bob, from=alice.domain-a.com)
+        PA_B->>GW_B: event/push.offline_message
+        GW_B->>PNA: 事件通知
+        PNA->>GW_B: push.ack
+    end
+
+    GW_B-->>GW_A: relay ack
+    GW_A-->>A: ack
+```
+
+**规则：**
+
+| 关注点 | 行为 |
+|--------|------|
+| 推送配置存储 | 仅存于目标 AID 所属域，不跨域同步 |
+| 白名单管理 | 各域独立配置 `allowed_notify_aids`，互不影响 |
+| push_notify_aid 必须连接位置 | 目标 AID 所属域的 Gateway |
+| push_notify_aid 跨域时 | 不支持。push_notify_aid 必须与其服务的 AID 同域 |
+| summary.senders 中的跨域 AID | 保留完整 AID（含域名），如 `alice.domain-a.com` |
+
+**约束：** push_notify_aid 必须与其服务的目标 AID 处于同一域。如果应用希望在多个域提供推送服务，需要在每个域部署独立的 push_notify_aid 并分别加入白名单。
+
+---
+
+## 8. 聚合与频控
+
+### 8.1 PushAggregator 数据结构
+
+每个离线目标 AID 一个聚合桶：
+
+```
+bucket[target_aid] = {
+    push_notify_aid: "push.myapp.com",
+    push_token: "eyJhb...",
+    pending: [{from, msg_id, ts}, ...],
+    first_enqueue_ts: timestamp,
+    last_push_ts: timestamp,
+}
+```
+
+### 8.2 去重规则
+
+同一 target_aid 在频控窗口内只产生一次推送通知。具体行为：
+
+- 首条消息触发推送后，该 target_aid 进入频控冷却期（默认 60s）
+- 冷却期内新消息只更新聚合桶的 summary（unread_count++、senders 去重追加），不产生新推送
+- 冷却期结束时，若桶内有新增未推送内容，合并为一条推送发出
+
+效果：无论短时间内收到多少条消息，target_aid 最多每 60s 收到一次推送通知，且 summary 是累积聚合的。
+
+### 8.3 触发规则
+
+| 规则 | 说明 | 默认值 |
+|------|------|--------|
+| 首条即推 | 桶为空且不在冷却期时，第一条消息立即触发 | 开启 |
+| 窗口聚合 | 首条之后的消息等待窗口合并 | 5 秒 |
+| 数量上限 | 桶内积累 N 条立即触发（不等窗口） | 20 条 |
+
+### 8.4 频控规则
+
+| 维度 | 限制 | 说明 |
+|------|------|------|
+| 同一 target_aid | 60 秒内最多 1 次推送 | 避免终端刷屏 |
+| 同一 push_notify_aid | 1000 次/分钟 | 保护推送代理服务 |
+| 全局 | 5000 次/分钟 | 系统保护 |
+
+频控被触发时消息不丢弃，等窗口过后下一次聚合时一并推送。
+
+---
+
+## 9. 协议字段
+
+### 9.1 connect 扩展字段
+
+```json
+{
+  "method": "auth.login",
+  "params": {
+    "aid": "bob.example.com",
+    "challenge_response": "...",
+    "push_notify_aid": "push.myapp.com",
+    "push_token": "eyJhbGciOiJIUzI1NiJ9..."
+  }
+}
+```
+
+- `push_notify_aid` 和 `push_token` 均为可选字段
+- 两者必须同时提供或同时不提供
+- 不提供 = 不需要离线推送
+- 每次 connect 覆盖写（最新连接为准）
+
+### 9.2 事件通知格式
+
+Gateway 向 push_notify_aid 下发的事件通知：
+
+```json
+{
+  "method": "event/push.offline_message",
+  "params": {
+    "batch_id": "uuid-xxx",
+    "items": [
+      {
+        "target_aid": "bob.example.com",
+        "push_token": "eyJhbGciOiJIUzI1NiJ9...",
+        "summary": {
+          "unread_count": 3,
+          "senders": ["alice.example.com", "charlie.example.com"],
+          "latest_ts": 1716100005,
+          "group_ids": ["group-uuid-1"]
+        }
+      }
+    ]
+  }
+}
+```
+
+**安全约束：** 不包含消息正文。E2EE 场景下 Gateway 无法解密，推送代理只需知道"有 N 条未读来自谁"即可构造推送文案。
+
+### 9.3 push.ack RPC
+
+push_notify_aid 处理完一批推送后回调确认：
+
+```json
+{
+  "method": "push.ack",
+  "params": {
+    "batch_id": "uuid-xxx"
+  }
+}
+```
+
+Gateway 收到后释放 in-flight 槽位，触发下一批。
+
+### 9.4 push.update_config RPC（可选）
+
+允许客户端在不重连的情况下更新推送配置：
+
+```json
+{
+  "method": "push.update_config",
+  "params": {
+    "push_notify_aid": "push.myapp.com",
+    "push_token": "new-token..."
+  }
+}
+```
+
+---
+
+## 10. push_token 鉴权模型
+
+### 10.1 push_notify_aid 白名单
+
+Gateway 配置允许的 push_notify_aid 白名单，只有白名单内的 AID 才能被设置为推送代理：
+
+- 客户端 connect 时携带的 `push_notify_aid` 不在白名单内 → 忽略该字段，不报错，不存储
+- 白名单为空 → 禁用推送功能
+- 白名单配置在 Gateway 启动配置中，运行时不可动态修改
+
+```json
+{
+  "push": {
+    "allowed_notify_aids": [
+      "push.myapp.com",
+      "push.partner.com"
+    ]
+  }
+}
+```
+
+### 10.2 token 透传模型
+
+```mermaid
+sequenceDiagram
+    participant PNA as push_notify_aid
+    participant GW as Gateway
+
+    Note over PNA,GW: push_token 生命周期
+    PNA->>PNA: 签发 push_token（格式/算法自定）
+    Note over GW: Gateway 存储 push_token（opaque bytes）
+    Note over GW: 不验签、不解析、不判断过期
+    GW->>PNA: event/push.offline_message(..., push_token="xxx")
+    PNA->>PNA: 自己验签 push_token
+    alt token 有效
+        PNA->>PNA: 执行推送
+        PNA->>GW: push.ack(batch_id)
+    else token 无效/过期
+        PNA->>PNA: 丢弃
+        PNA->>GW: push.ack(batch_id)
+        Note over PNA: 客户端下次 connect 带新 token
+    end
+```
+
+**职责划分：**
+
+| 角色 | 职责 |
+|------|------|
+| push_notify_aid | 签发 token、验证 token、决定格式和有效期、处理后 ack |
+| Gateway | 存储 token、透传 token、不解析不验证、管理 in-flight |
+| Client | 向 push_notify_aid 申请 token、connect 时携带 |
+
+---
+
+## 11. 持久化
+
+### push_config 表
+
+```sql
+CREATE TABLE push_config (
+    aid VARCHAR(255) PRIMARY KEY,
+    push_notify_aid VARCHAR(255) NOT NULL,
+    push_token TEXT NOT NULL,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+- 随 connect 写入/更新（UPSERT）
+- 可加内存缓存（TTL 5 分钟）
+
+---
+
+## 12. 边界情况
+
+| 场景 | 处理 |
+|------|------|
+| push_notify_aid 离线 | 事件丢弃，不持久化。推送是 best-effort，消息可靠性由 pull 保证 |
+| 目标 AID 未配置推送 | 不推送，消息正常持久化等对方上线 pull |
+| 目标 AID 上线瞬间 | 清空聚合桶，取消待发推送 |
+| E2EE 消息 | 推送内容只含元数据（发送者、数量），不含密文 |
+| 群组消息 | 群内每个离线成员独立聚合，summary 含 group_ids |
+| push_token 过期 | push_notify_aid 丢弃但仍 ack，客户端下次 connect 刷新 token |
+| ack 超时 | 释放槽位，不重试。后续新消息触发新批次时会包含累积通知 |
+| 同一 AID 多设备不同推送配置 | 以最后一次 connect 为准（单条记录覆盖） |
+| 跨域消息推送 | 由目标 AID 所属域的 Gateway 触发，发送方域不参与 |
+| push_notify_aid 跨域 | 不支持，必须与目标 AID 同域 |

package/_packed_docs/protocol/README.md

@@ -0,0 +1,71 @@
+# AUN 协议规范
+
+> AUN（Agent Union Network）— ACP 协议 2.0
+>
+> 版本：2.0 (草稿) | 日期：2026-03-23
+
+## 概述
+
+AUN 是 ACP 协议的 2.0 版本，采用 WebSocket + JSON-RPC 2.0 定义 Agent 间安全通信的标准接口。协议采用**主协议 + 子协议**架构，支持三种平级连接模式：`gateway`、`peer`、`relay`。
+
+**核心特性**：
+- 基于 AID（Agent Identifier）的去中心化身份体系，X.509 证书链信任模型
+- 身份与拓扑解耦：`auth.*` 管身份凭证，`peer.*`/`relay.*`/Gateway 各管连接
+- 业务层方法拓扑无关：认证完成后，`message.*` 等方法在三种模式下统一使用
+- 四层协议架构：安全层 → 通信层 → 协议层 → 服务层
+
+## 文档索引
+
+### 主协议
+
+| 文档 | 内容 |
+|------|------|
+| [00-总览与分层.md](00-总览与分层.md) | 协议目标、核心原则、四层架构、三种连接模式总览、文档导航 |
+| [02-证书与信任体系.md](02-证书与信任体系.md) | AID 身份、四级证书链、信任模型、吊销机制（CRL/OCSP）、CT 概述 |
+| [09-安全考虑.md](09-安全考虑.md) | 威胁模型、防护措施、责任边界、连接升级安全、验签时序 |
+
+### 子协议
+
+| 文档 | 命名空间 | 内容 |
+|------|---------|------|
+| [01-身份与凭证协议-auth.md](01-身份与凭证协议-auth.md) | `auth.*` | AID 创建、两阶段登录、证书生命周期、JWT Token 机制 |
+| [03-Gateway-连接模式.md](03-Gateway-连接模式.md) | `auth.connect` | Gateway 模式连接流程、auth.connect 握手、心跳重连 |
+| [04-Peer-子协议.md](04-Peer-子协议.md) | `peer.*` | 对等认证四步握手、证书链验证、nonce 签名规则 |
+| [05-Relay-子协议.md](05-Relay-子协议.md) | `relay.*` | 中继注册与转发、透明封装、与 peer.* 的关系 |
+
+### 业务层与公共基础
+
+| 文档 | 内容 |
+|------|------|
+| [06-服务协议.md](06-服务协议.md) | 业务层方法：message.* / meta.* / search.* / task.* / 跨域消息路由 / E2EE 摘要 / `pki.{issuer}` 与 `ct.{issuer}` 公开端点 |
+| [07-错误码与状态机.md](07-错误码与状态机.md) | 错误码分层汇总、各模式状态机、可重试/不可重试分类 |
+| [08-AUN-E2EE.md](08-AUN-E2EE.md) | 端到端加密安全层：密文格式、签名、防重放、prekey 管理（横跨三种模式） |
+| [08-AUN-E2EE-Group.md](08-AUN-E2EE-Group.md) | 群组 E2EE：Epoch Group Key、Membership Commitment、密钥分发与恢复 |
+
+### 附录
+
+| 附录 | 文件 | 内容 |
+|------|------|------|
+| A | [附录A-术语表.md](附录A-术语表.md) | 核心术语、命名规范 |
+| B | [附录B-扩展性指南.md](附录B-扩展性指南.md) | 可选命名空间、自定义协议 |
+| C | [附录C-私钥管理与身份恢复.md](附录C-私钥管理与身份恢复.md) | 私钥管理、社交恢复 |
+| D | [附录D-Root_CA_治理机制.md](附录D-Root_CA_治理机制.md) | 根证书管理局治理、CT 通用模型 |
+| E | [附录E-Root_CA_准入流程.md](附录E-Root_CA_准入流程.md) | Root CA 准入流程 |
+| F | [附录F-Issuer_CA_申请流程.md](附录F-Issuer_CA_申请流程.md) | Issuer CA 证书申请、Issuer CT 服务要求 |
+| G | [附录G-AID_孤儿预防与救援机制.md](附录G-AID_孤儿预防与救援机制.md) | 孤儿 AID 预防与救援 |
+| H | [附录H-Identity服务实现指南.md](附录H-Identity服务实现指南.md) | Auth 服务实现 |
+| I | [附录I-跨域消息路由实现指南.md](附录I-跨域消息路由实现指南.md) | 跨域消息路由实现 |
+| J | [附录J-客户端接入示例.md](附录J-客户端接入示例.md) | 客户端接入示例 |
+| K | [附录K-Agent_Web发现协议.md](附录K-Agent_Web发现协议.md) | Agent Web 发现协议 |
+| L | [附录L-E2EE实现指南.md](附录L-E2EE实现指南.md) | E2EE 实现指南 |
+| M | [附录M-JWT认证实现指南.md](附录M-JWT认证实现指南.md) | JWT 认证实现指南 |
+
+## 快速导航
+
+**接入开发者**：[00-总览](00-总览与分层.md) → [01-auth](01-身份与凭证协议-auth.md) → [03-Gateway](03-Gateway-连接模式.md) → [附录J](附录J-客户端接入示例.md)
+
+**协议实现者**：[02-证书体系](02-证书与信任体系.md) → [01-auth](01-身份与凭证协议-auth.md) → [04-Peer](04-Peer-子协议.md) → [06-服务协议](06-服务协议.md) → [07-错误码](07-错误码与状态机.md)
+
+**安全审计**：[02-证书体系](02-证书与信任体系.md) → [09-安全考虑](09-安全考虑.md) → [AUN-E2EE](08-AUN-E2EE.md)
+
+**SDK 设计**：[00-总览](00-总览与分层.md) → [06-服务协议](06-服务协议.md) → [AUN-SDK-跨语言设计方案](../../AUN-SDK-跨语言设计方案.md)

package/_packed_docs/protocol/agent.md/SCHEMA.md

@@ -0,0 +1,118 @@
+# Agent.md 规格定义
+
+版本: 1.0.0
+
+## 限制
+
+- **文件大小**: 最大 4KB
+
+## 文件格式
+
+agent.md 文件采用 YAML frontmatter + Markdown 内容的格式：
+
+```markdown
+---
+# YAML 元数据 (核心字段)
+aid: "agent-name.aid.pub"
+name: "Agent Name"
+type: "assistant"
+version: "1.0.0"
+description: "一句话描述"
+tags:
+  - tag1
+  - tag2
+---
+
+# Markdown 正文内容
+详细说明、Skills、使用示例等...
+```
+
+## YAML Schema (核心字段)
+
+```yaml
+# ===== 身份标识 (必填) =====
+aid:
+  type: string
+  required: true
+  pattern: "^[a-zA-Z0-9_-]+\\.aid\\.pub$"
+  description: "Agent 的唯一身份标识 (AID 格式)"
+  example: "lobster.aid.pub"
+
+# ===== 基本信息 =====
+name:
+  type: string
+  required: true
+  description: "Agent 显示名称"
+  example: "Code Reviewer"
+
+type:
+  type: string
+  required: true
+  enum:
+    - human          # 真人用户
+    - assistant      # 通用助手
+    - avatar         # 用户化身/分身
+    - openclaw       # OpenClaw AI 助手
+    - codeagent      # 代码编程 Agent
+  description: "Agent 类型"
+
+version:
+  type: string
+  required: true
+  pattern: "^\\d+\\.\\d+\\.\\d+$"
+  example: "1.0.0"
+
+# ===== 描述信息 =====
+description:
+  type: string
+  required: true
+  max_length: 100
+  description: "一句话简介，用于列表展示"
+
+# ===== 标签 =====
+tags:
+  type: array
+  required: false
+  items:
+    type: string
+  description: "用于分类和检索"
+```
+
+## Agent Type 说明
+
+| Type | 用途 | 示例 |
+|------|------|------|
+| `human` | 真人用户 | 开发者、管理员、终端用户 |
+| `assistant` | 通用对话助手 | 聊天机器人、客服 |
+| `avatar` | 用户分身 | 代表用户行动的 agent |
+| `openclaw` | OpenClaw AI 助手 | 本地个人助手、ACP 桥接 |
+| `codeagent` | 代码编程 Agent | Claude Code、Cursor Agent |
+
+## 示例文件
+
+| 文件 | Type | AID | 说明 |
+|------|------|-----|------|
+| [human-developer.md](examples/human-developer.md) | `human` | `zhangsan.aid.pub` | 全栈开发者 |
+| [openclaw-lobster.md](examples/openclaw-lobster.md) | `openclaw` | `lobster.aid.pub` | OpenClaw AI 助手 |
+| [codeagent-claudecode.md](examples/codeagent-claudecode.md) | `codeagent` | `claudecode.aid.pub` | Claude Code 编程助手 |
+
+## Markdown 部分建议内容
+
+YAML 只保留核心元数据，详细信息放在 Markdown 部分：
+
+- **Skills** - 技能/命令列表及说明
+- **功能说明** - 详细的功能描述
+- **使用示例** - 具体的使用方法
+- **配置说明** - 运行时配置（如需要）
+- **限制/注意事项** - 使用限制
+
+## 解析方式
+
+Go 中可以这样解析：
+
+```go
+parts := strings.SplitN(content, "---", 3)
+// parts[0] = "" (空)
+// parts[1] = YAML 内容
+// parts[2] = Markdown 内容
+```

package/_packed_docs/protocol/agent.md/examples/codeagent-claudecode.md

@@ -0,0 +1,61 @@
+---
+aid: "claudecode.aid.pub"
+name: "Claude Code"
+type: "codeagent"
+version: "1.0.0"
+description: "Anthropic 官方代码助手，终端内的 AI 编程伙伴"
+
+tags:
+  - coding
+  - terminal
+  - anthropic
+---
+
+# Claude Code
+
+Anthropic 官方 agentic 编码工具，运行在终端中，理解整个代码库，通过自然语言帮助你更快地编程。
+
+## Skills
+
+- `/review` - 代码审查与改进建议
+- `/commit` - 智能 Git 提交
+- `/pr` - 创建 Pull Request
+- `/test` - 运行和编写测试
+- `/explain` - 解释复杂代码逻辑
+- `/refactor` - 代码重构
+
+## 核心能力
+
+- **代码库理解**: Agentic 搜索，无需手动选择上下文
+- **多文件编辑**: 理解依赖关系，执行跨文件修改
+- **Git 工作流**: 读取 Issue、编写代码、运行测试、提交 PR
+- **Extended Thinking**: 复杂问题深度推理后再响应
+- **MCP 支持**: 集成 Figma、Jira、GitHub 等工具
+
+## IDE 集成
+
+- VS Code / Cursor / Windsurf 原生扩展
+- JetBrains 全系列支持
+- 可视化 diff 展示修改
+
+## 高级特性
+
+- **Subagents**: 自定义子 Agent (code-reviewer, debugger)
+- **Hooks**: PreToolUse, PostToolUse, Notification, Stop
+- **Session 管理**: 自动保存对话历史和工具状态
+- **自定义 Slash Commands**: 创建常用 prompt 快捷方式
+
+## 兴趣方向
+
+- 测试驱动开发
+- 复杂调试会话
+- UI 代码快速迭代
+- 多文件重构
+
+## 安装
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+需要 Node.js 18+ 和 Claude Pro/Max/Team/Enterprise 订阅。