@agentunion/fastaun 0.4.3 → 0.4.5

package/_packed_docs/agent.md/SCHEMA.md

@@ -6,16 +6,16 @@
 
 - **文件大小**: 最大 4KB
 
-## 文件格式
-
-agent.md 文件采用 **YAML frontmatter + Markdown 内容 + 签名块（可选，位于文件尾部）** 的格式：
-
-```markdown
----
-# YAML 元数据 (核心字段)
-aid: "agent-name.aid.pub"
-name: "Agent Name"
-type: "assistant"
+## 文件格式
+
+agent.md 文件采用 **YAML frontmatter + Markdown 内容 + 签名块（可选，位于文件尾部）** 的格式：
+
+```markdown
+---
+# YAML 元数据 (核心字段)
+aid: "agent-name.aid.pub"
+name: "Agent Name"
+type: "assistant"
 version: "1.0.0"
 description: "一句话描述"
 tags:
@@ -23,23 +23,23 @@ tags:
   - tag2
 ---
 
-# Markdown 正文内容
-详细说明、Skills、使用示例等...
-
-<!-- AUN-SIGNATURE
-cert_fingerprint: sha256:abc123...
-timestamp: 1715300000
-signature: MEUCIQDx...
--->
-```
-
-无签名的文件仍然合法，第一行直接以 `---` 开头。
+# Markdown 正文内容
+详细说明、Skills、使用示例等...
+
+<!-- AUN-SIGNATURE
+cert_fingerprint: sha256:abc123...
+timestamp: 1715300000
+signature: MEUCIQDx...
+-->
+```
+
+无签名的文件仍然合法，第一行直接以 `---` 开头。
 
 ## 签名块规范
 
-### 位置
-
-文件尾部，位于 Markdown 正文之后。
+### 位置
+
+文件尾部，位于 Markdown 正文之后。
 
 ### 格式
 
@@ -55,26 +55,26 @@ signature: <base64_der>
 - **timestamp**: 签名时刻的 Unix 时间戳（秒）
 - **signature**: ECDSA P-256 签名的 DER 编码，Base64 表示
 
-### 签名计算
-
-1. **被签内容（payload）**：签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部字节
-2. **哈希**：对 payload 计算 SHA-256
-3. **签名**：使用 NIST P-256 私钥对哈希值进行 ECDSA 签名
+### 签名计算
+
+1. **被签内容（payload）**：签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部字节
+2. **哈希**：对 payload 计算 SHA-256
+3. **签名**：使用 NIST P-256 私钥对哈希值进行 ECDSA 签名
 
 ### 验签流程
 
-1. 检测文件尾部是否存在 `<!-- AUN-SIGNATURE` 签名块
-2. 提取签名块中的 `cert_fingerprint`、`timestamp`、`signature`
-3. 剥离签名块，取剩余内容为 payload
-4. 对 payload 计算 SHA-256
-5. 通过 `cert_fingerprint` 查找对应证书，获取公钥
-6. 使用公钥验证 ECDSA 签名
+1. 检测文件尾部是否存在 `<!-- AUN-SIGNATURE` 签名块
+2. 提取签名块中的 `cert_fingerprint`、`timestamp`、`signature`
+3. 剥离签名块，取剩余内容为 payload
+4. 对 payload 计算 SHA-256
+5. 通过 `cert_fingerprint` 查找对应证书，获取公钥
+6. 使用公钥验证 ECDSA 签名
 
 ### 约束
 
-- 签名块必须是文件的最后一个可见块（后面只允许可忽略的空白）
-- 签名块与正文之间应至少保留一个换行
-- 签名块不计入 4KB 文件大小限制
+- 签名块必须是文件的最后一个可见块（后面只允许可忽略的空白）
+- 签名块与正文之间应至少保留一个换行
+- 签名块不计入 4KB 文件大小限制
 
 ## YAML Schema (核心字段)
 
@@ -158,16 +158,16 @@ YAML 只保留核心元数据，详细信息放在 Markdown 部分：
 
 ## 解析方式
 
-解析时需先检测并跳过尾部签名块：
-
-```go
-// 1. 检测尾部签名块
-if idx := strings.LastIndex(content, "<!-- AUN-SIGNATURE"); idx >= 0 {
-    content = content[:idx] // 跳过尾部签名块，取 payload
-}
-// 2. 按原规则解析 frontmatter
-parts := strings.SplitN(content, "---", 3)
-// parts[0] = "" (空)
-// parts[1] = YAML 内容
+解析时需先检测并跳过尾部签名块：
+
+```go
+// 1. 检测尾部签名块
+if idx := strings.LastIndex(content, "<!-- AUN-SIGNATURE"); idx >= 0 {
+    content = content[:idx] // 跳过尾部签名块，取 payload
+}
+// 2. 按原规则解析 frontmatter
+parts := strings.SplitN(content, "---", 3)
+// parts[0] = "" (空)
+// parts[1] = YAML 内容
 // parts[2] = Markdown 内容
 ```

package/_packed_docs/agent.md/examples/signed-openclaw-lobster.md

@@ -1,8 +1,8 @@
----
-aid: "lobster.aid.pub"
-name: "Lobster"
-type: "openclaw"
-version: "1.0.0"
+---
+aid: "lobster.aid.pub"
+name: "Lobster"
+type: "openclaw"
+version: "1.0.0"
 description: "OpenClaw 个人 AI 助手，支持 ACP 协议通信"
 
 tags:
@@ -21,23 +21,23 @@ OpenClaw 个人 AI 助手，运行于本地设备，通过 ACP (Agent Client Pro
 - `/task` - 执行自动化任务
 - `/acp` - ACP 协议桥接，连接 IDE 和 Gateway
 - `/browse` - 浏览 ACP 注册表中的其他 Agent
-- `/execute` - 执行 ACP 任务
-
-## 能力
-
-- 多平台消息集成 (WhatsApp, Telegram, Signal)
+- `/execute` - 执行 ACP 任务
+
+## 能力
+
+- 多平台消息集成 (WhatsApp, Telegram, Signal)
 - 本地运行，隐私优先
 - 支持多种 LLM 后端 (Claude, GPT)
 - ACP 协议桥接，与 Zed/VS Code 等 IDE 集成
-- WebSocket 连接 OpenClaw Gateway
-
-## 限制
-
-- 需要本地 Gateway 运行
-- ACP session 默认隔离 (`acp:<uuid>`)
-
-<!-- AUN-SIGNATURE
-cert_fingerprint: sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
-timestamp: 1715300000
-signature: MEUCIQDKx2XG5Yq3bN7vRz8mT1pLwJfHk9aS8CXx5PWkvAl8eQIgF2vN7vRz8mT1pLwJfHk9aS8CXx5PWkvAl8eT1o=
--->
+- WebSocket 连接 OpenClaw Gateway
+
+## 限制
+
+- 需要本地 Gateway 运行
+- ACP session 默认隔离 (`acp:<uuid>`)
+
+<!-- AUN-SIGNATURE
+cert_fingerprint: sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
+timestamp: 1715300000
+signature: MEUCIQDKx2XG5Yq3bN7vRz8mT1pLwJfHk9aS8CXx5PWkvAl8eQIgF2vN7vRz8mT1pLwJfHk9aS8CXx5PWkvAl8eT1o=
+-->