MyClaw 开发日报 - Day 2 (基础架构)

MyClaw 开发日报 - Day 2 (基础架构)

日期： 2026-03-08
阶段： Phase 1 - 基础架构
工作时段： 19:00 - 05:00

📊 今日概况

暂无 Git 提交

✅ 今日完成任务

暂无任务记录

🎯 技术亮点

待补充

🐛 遇到的问题

暂无

📈 代码统计

  • 暂无代码变更

📝 学习笔记

待补充

🚀 明日计划

待补充

📚 参考资料

暂无

工作时间： 待统计
心情指数： ⭐⭐⭐⭐⭐
进度评价： 🟢 正常

本报告由 MyClaw 自动生成系统生成

展开全文 >>

MyClaw 开发日记 Day 2 完成 - 129个测试全部通过

MyClaw 开发日记 Day 2 完成 - 129个测试全部通过 🎉

工作时间： 2026-03-07 09:54 - 16:15 (约 6.5 小时)

阶段： Phase 1 Day 2 (基础架构) + Day 3 部分

🎉 重大里程碑

总计完成：129 个测试全部通过！

这标志着 MyClaw 核心基础设施已经完全搭建完成，为后续功能开发奠定了坚实基础。

✅ 完成的包

1. @myclaw/core (27 个测试) ✅

核心类型定义和工具：

  • Rule Schema - 规则数据模型
  • Channel Config - 渠道配置模型
  • Model Config - 模型配置模型
  • Permission Config - 权限配置模型
  • Gateway State - Gateway 状态模型
  • Result Type - 函数返回类型

技术栈：

  • Zod 运行时验证
  • TypeScript 类型推断
  • 模式匹配

2. @myclaw/logger (25 个测试) ✅

结构化日志系统：

  • 多级别日志 - trace/debug/info/warn/error/fatal
  • 子 logger - 支持模块化日志
  • 敏感数据掩码 - 自动掩码敏感信息
  • 预设实例 - gateway/rules/storage/channel/provider

技术栈：

  • tslog 结构化日志
  • 敏感字段检测
  • 颜色编码输出

3. @myclaw/gateway (17 个测试) ✅

Gateway 生命周期管理：

  • 启动/停止/重启 - 完整生命周期
  • 健康检查 - 自动监控 Gateway 状态
  • 自动重启 - 故障自动恢复
  • 状态管理 - 实时状态跟踪

技术栈：

  • Child Process 管理
  • HTTP 健康检查
  • 状态机模式

4. @myclaw/storage (17 个测试) ✅

SQLite 数据存储：

  • CRUD 操作 - 完整的增删改查
  • Rules 存储 - 规则持久化
  • Channels 存储 - 渠道配置持久化
  • Models 存储 - 模型配置持久化
  • Permissions 存储 - 权限配置持久化

技术栈：

  • better-sqlite3 同步 API
  • Prepared Statements
  • 数据序列化

5. @myclaw/config-generator (7 个测试) ✅

配置文件生成器：

  • generateConfig() - 生成 openclaw.json
  • generateEnvFile() - 生成 .env 文件
  • 敏感信息掩码 - 保护配置安全

技术栈：

  • 文件系统操作
  • JSON 序列化
  • 环境变量生成

6. @myclaw/keychain (13 个测试) ✅

macOS Keychain 集成：

  • set(key, value) - 安全存储密钥
  • get(key) - 读取密钥
  • delete(key) - 删除密钥
  • exists(key) - 检查存在性
  • list() - 列出所有密钥

技术栈：

  • macOS security 命令
  • 系统级加密
  • 访问控制

7. @myclaw/rule-engine (23 个测试) ✅ 🆕

规则引擎核心 - 今日新增！

功能特性

自然语言规则解析：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// 每天提醒
"每天早上 9 点提醒我开会"
→ cron: "0 9 * * *", action: "notify"

// 每周提醒
"每周一 9 点提醒我开会"
→ cron: "0 9 * * 1", action: "notify"

// 每小时提醒
"每小时提醒我喝水"
→ cron: "0 * * * *", action: "notify"

// 事件触发
"当收到邮件时提醒我"
→ trigger: "event", conditions: { event: "收到邮件" }

规则管理 API：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// 创建规则
const rule = await engine.createRule('每天 9 点提醒我开会');

// 获取规则
const existing = engine.getRule(rule.id);

// 更新规则
const updated = engine.updateRule(rule.id, {
  natural: '每天 10 点提醒我开会'
});

// 启用/禁用
engine.enableRule(rule.id);
engine.disableRule(rule.id);

// 删除规则
engine.deleteRule(rule.id);

技术实现

模式匹配系统：

  • 时间表达式解析（早上/下午/具体时间）
  • 频率识别（每天/每周/每小时）
  • 动作提取（提醒/通知/发送/执行）
  • 消息内容提取（引号/说/内容是）

Cron 表达式生成：

  • 每天定时 → 0 H * * *
  • 每周定时 → 0 H * * D
  • 每小时 → 0 * * * *
  • 事件触发 → event trigger

测试覆盖：

  • 规则解析测试 (8个)
  • 规则创建测试 (2个)
  • 规则管理测试 (8个)
  • 启用/禁用测试 (2个)
  • 单例测试 (1个)

📊 测试统计

包名 测试数量 状态 功能
@myclaw/core 27 ✅ 类型系统
@myclaw/logger 25 ✅ 日志系统
@myclaw/gateway 17 ✅ Gateway管理
@myclaw/storage 17 ✅ 数据存储
@myclaw/config-generator 7 ✅ 配置生成
@myclaw/keychain 13 ✅ 密钥管理
@myclaw/rule-engine 23 ✅ 规则引擎
总计 129 ✅ 核心基础设施

🎯 技术亮点

1. 自然语言规则解析

支持的句式：

  • ✅ “每天 [时间] [动作]”
  • ✅ “每周 [星期] [时间] [动作]”
  • ✅ “每小时 [动作]”
  • ✅ “当 [事件] 时 [动作]”

时间解析：

  • ✅ “早上 9 点” → 09:00
  • ✅ “下午 3 点” → 15:00
  • ✅ “9 点” → 09:00

动作识别：

  • ✅ “提醒” → notify
  • ✅ “通知” → notify
  • ✅ “发送” → send
  • ✅ “执行” → execute

2. 规则持久化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// 规则存储在 SQLite 数据库
const rule = await engine.createRule('每天 9 点提醒我开会');

// 规则结构
{
  id: 'uuid',
  natural: '每天 9 点提醒我开会',
  compiled: {
    trigger: 'cron',
    schedule: '0 9 * * *',
    action: 'notify',
    message: '每天 9 点提醒我开会',
    enabled: true
  },
  createdAt: Date,
  updatedAt: Date
}

3. 安全密钥管理

1
2
3
4
5
6
7
// API 密钥存储在 macOS Keychain
await keychain.set('OPENAI_API_KEY', 'sk-xxx');

// 自动加密，系统级保护
const key = await keychain.get('OPENAI_API_KEY');

// 无需明文存储

🔧 工具链改进

1. 构建工具迁移

从 tsdown → tsup

  • ✅ 更稳定的构建
  • ✅ 更好的类型生成
  • ✅ 更快的编译速度

2. Turbo 配置更新

Pipeline → Tasks

1
2
3
4
5
6
7
8
{
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    }
  }
}

3. TypeScript 配置优化

Workspace 支持

1
2
3
4
5
6
7
8
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@myclaw/*": ["./packages/*/src"]
    }
  }
}

📝 学习笔记

自然语言处理模式

正则表达式匹配：

1
2
3
4
5
// 匹配 "每天 [时间] [动作]"
const dailyMatch = lower.match(/每天(.{1,10})(提醒|通知|发送|执行)/);

// 匹配 "早上 9 点"
const morningMatch = timeStr.match(/早上\s*(\d{1,2})\s*点/);

Cron 表达式生成：

1
2
3
每天 9 点    → 0 9 * * *
每周一 9 点  → 0 9 * * 1
每小时       → 0 * * * *

Zod Schema 验证

运行时验证：

1
2
3
4
5
6
7
8
9
10
11
12
const RuleSchema = z.object({
  id: z.string().uuid(),
  natural: z.string().min(1),
  compiled: z.object({
    trigger: z.enum(['cron', 'event', 'webhook', 'manual']),
    action: z.string(),
    enabled: z.boolean().default(true)
  })
});

// 自动类型推断
type Rule = z.infer<typeof RuleSchema>;

🚀 明日计划 (Day 3)

任务清单

1. CLI 工具开发

  • 命令行参数解析
  • 交互式配置向导
  • 规则管理命令
  • Gateway 控制命令

2. 规则执行器

  • Cron 调度器集成
  • 事件监听器
  • 动作执行器
  • 错误处理

3. 集成测试

  • 多包协作测试
  • 端到端测试
  • 性能测试

4. 文档完善

  • API 文档
  • 使用示例
  • 架构图

📚 参考资料

  1. Cron 表达式
  2. Natural Language Processing
  3. Zod Schema Validation
  4. macOS Keychain Services
  5. Vitest Testing Framework

🎉 成就解锁

  • ✅ 7 个核心包完成
  • ✅ 129 个测试全部通过
  • ✅ 自然语言规则解析实现
  • ✅ macOS Keychain 集成完成
  • ✅ 配置文件生成器完成
  • ✅ 超前完成 Day 2 和部分 Day 3

💪 下一步

Day 3 重点：

  1. CLI 工具 - 让用户能通过命令行管理规则
  2. 规则执行器 - 让规则真正运行起来
  3. 集成测试 - 确保各组件协作正常

预期目标：

  • 完成基础 CLI 工具
  • 规则可以自动执行
  • 完整的端到端测试

进度评价： 🟢 超前完成

心情指数： ⭐⭐⭐⭐⭐

代码统计：

  • 新增源代码：~1500 行
  • 新增测试代码：~1000 行
  • 测试用例：129 个
  • 包数量：7 个

Day 2 完美收官！明天继续 Day 3，让规则跑起来！ 🚀

展开全文 >>

MyClaw 开发日记 Day 2 - 核心包与配置系统完成

MyClaw 开发日记 Day 2 - 核心包与配置系统完成 ✅

工作时间： 2026-03-07 09:54 - 16:10 (约 6 小时)

阶段： Phase 1 Day 2 (基础架构)

✅ 今日完成任务

1. 核心包单元测试完善

为所有核心包编写了完整的测试套件：

@myclaw/core (27 个测试) ✅

  • Rule Schema 验证测试
  • Channel Config Schema 测试
  • Model Config Schema 测试
  • Permission Config Schema 测试
  • Gateway State Schema 测试
  • Result 类型测试
  • 边界情况和错误处理测试

@myclaw/logger (25 个测试) ✅

  • Logger 构造函数测试
  • 所有日志级别测试 (trace/debug/info/warn/error/fatal)
  • 子 logger 创建测试
  • 敏感数据掩码测试
  • 默认 logger 实例测试
  • 错误处理测试

@myclaw/gateway (17 个测试) ✅

  • GatewayLauncher 构造函数测试
  • 生命周期管理测试 (start/stop/restart)
  • 状态管理测试
  • 健康检查配置测试
  • 错误处理测试

@myclaw/storage (17 个测试) ✅

  • Storage 构造函数测试
  • Rules CRUD 操作测试
  • Channels CRUD 操作测试
  • Models CRUD 操作测试
  • Permissions CRUD 操作测试
  • 单例模式测试
  • 数据库关闭测试

总计：86 个核心包测试全部通过！ 🎉

2. 配置生成器 (@myclaw/config-generator)

创建配置文件生成器包，用于自动生成 OpenClaw Gateway 配置：

功能特性 (7 个测试) ✅

  • generateConfig() - 生成 OpenClaw 配置文件

    • 从 SQLite 数据库读取配置
    • 生成 openclaw.json 配置文件
    • 支持敏感信息掩码

  • generateEnvFile() - 生成环境变量文件

    • 自动提取 API 密钥
    • 生成 .env 文件
    • 支持多个 LLM 提供商

  • maskSensitiveConfig() - 敏感信息掩码

    • 自动掩码 token、apiKey、password、secret
    • 保护配置文件中的敏感数据

技术实现

1
2
3
4
5
6
7
8
9
10
11
12
13
// 示例用法
const generator = new ConfigGenerator({
  configDir: '~/.myclaw',
  dbPath: '~/.myclaw/myclaw.db'
});

// 生成配置文件
await generator.generateConfig();
// 输出: ~/.myclaw/openclaw.json

// 生成环境变量
await generator.generateEnvFile();
// 输出: ~/.myclaw/.env

3. 密钥注入系统 (@myclaw/keychain)

创建密钥管理系统，使用 macOS Keychain 安全存储敏感数据：

功能特性 (13 个测试) ✅

  • set(key, value) - 存储密钥到 Keychain
  • get(key) - 从 Keychain 读取密钥
  • delete(key) - 删除密钥
  • exists(key) - 检查密钥是否存在
  • list() - 列出所有密钥

技术实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { KeychainManager } from '@myclaw/keychain';

const keychain = new KeychainManager({ 
  service: 'com.myclaw.keys' 
});

// 存储密钥
await keychain.set('OPENAI_API_KEY', 'sk-xxx');

// 读取密钥
const apiKey = await keychain.get('OPENAI_API_KEY');

// 删除密钥
await keychain.delete('OPENAI_API_KEY');

安全特性

  • 使用 macOS 原生 Keychain 存储
  • 自动加密和解密
  • 系统级安全保护
  • 无需明文存储密钥

🔧 技术改进

1. 构建工具链优化

问题： tsdown 在构建时出现 “Maximum call stack size exceeded” 错误

解决方案：

  • 从 tsdown 迁移到 tsup
  • tsup 更稳定，社区支持更好

改进效果：

  • ✅ 构建速度提升
  • ✅ 类型声明文件生成正常
  • ✅ ESM 输出格式正确

2. Turbo 配置更新

问题： Turbo 2.0+ 不再支持 pipeline 字段

解决方案：

1
2
3
4
5
6
7
8
9
// turbo.json
{
  "tasks": {  // 从 "pipeline" 改为 "tasks"
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    }
  }
}

3. TypeScript 配置修复

问题： paths 配置导致类型解析失败

解决方案：

1
2
3
4
5
6
7
8
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@myclaw/*": ["./packages/*/src"]
    }
  }
}

4. Package.json Exports 修复

问题： vitest 无法解析 workspace 包入口

解决方案：

1
2
3
4
5
6
7
8
9
10
{
  "main": "./dist/index.mjs",
  "types": "./dist/index.d.mts",
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "types": "./dist/index.d.mts"
    }
  }
}

5. better-sqlite3 原生模块编译

问题： better-sqlite3 需要编译原生模块

解决方案：

1
2
cd node_modules/.pnpm/better-sqlite3@11.10.0/node_modules/better-sqlite3
npm run build-release

结果： ✅ Storage 包所有测试通过

📊 测试覆盖统计

包名 测试文件数 测试用例数 状态
@myclaw/core 1 27 ✅
@myclaw/logger 1 25 ✅
@myclaw/gateway 1 17 ✅
@myclaw/storage 1 17 ✅
@myclaw/config-generator 1 7 ✅
@myclaw/keychain 1 13 ✅
总计 6 106 ✅

🎯 测试亮点

1. Zod Schema 验证

所有数据模型都使用 Zod 进行运行时验证：

1
2
3
4
5
6
7
8
export const RuleSchema = z.object({
  id: z.string().uuid(),
  natural: z.string().min(1),
  compiled: z.object({
    trigger: z.enum(['cron', 'event', 'webhook', 'manual']),
    // ...
  }),
});

测试覆盖：

  • 有效数据验证
  • 无效数据拒绝
  • 边界情况处理
  • 默认值设置

2. 敏感信息掩码

Logger 自动掩码敏感字段：

1
2
3
new Logger({
  maskValuesOfKeys: ['apiKey', 'password', 'token', 'secret']
});

测试验证：

  • apiKey 被掩码
  • password 被掩码
  • token 被掩码
  • secret 被掩码

3. SQLite CRUD 操作

完整的数据库操作测试：

1
2
3
4
5
6
7
8
9
10
11
// 创建
storage.saveRule(rule);

// 读取
const retrieved = storage.getRule(rule.id);

// 更新
storage.saveRule(updatedRule);

// 删除
storage.deleteRule(rule.id);

测试覆盖：

  • 所有 CRUD 操作
  • 数据序列化/反序列化
  • 空值处理
  • 单例模式

4. macOS Keychain 集成

密钥管理测试：

1
2
3
4
5
6
7
8
9
// Mock child_process
vi.mock('child_process', () => ({
  exec: vi.fn(),
}));

// 测试 Keychain 操作
await keychain.set('test-key', 'test-value');
const value = await keychain.get('test-key');
expect(value).toBe('test-value');

测试覆盖：

  • 存储密钥
  • 读取密钥
  • 删除密钥
  • 错误处理

📝 学习笔记

Vitest 测试框架

优势：

  • 快速启动（基于 Vite）
  • 兼容 Jest API
  • 原生 TypeScript 支持
  • 内置覆盖率报告

最佳实践：

  • 使用 vi.fn() 进行 mock
  • 使用 beforeEach/afterEach 管理测试状态
  • 使用 describe/it 组织测试结构

Zod 验证库

核心优势：

  • 运行时类型检查
  • 自动类型推断
  • 详细的错误信息
  • 可组合性

测试策略：

  • 测试所有有效输入
  • 测试所有无效输入
  • 测试边界情况
  • 测试默认值

better-sqlite3

性能优势：

  • 同步 API
  • 高性能
  • 低内存占用

注意事项：

  • 需要编译原生模块
  • 使用 prepared statements
  • 正确关闭连接

macOS Keychain

安全优势：

  • 系统级加密
  • 自动访问控制
  • 用户授权机制
  • 跨应用隔离

最佳实践：

  • 使用服务名称隔离
  • 处理访问拒绝
  • 实现优雅降级

🚀 明日计划 (Day 3)

任务清单

1. 实现规则引擎核心

  • 自然语言规则解析
  • Cron 表达式生成
  • 规则验证和测试

2. 实现 CLI 工具

  • 命令行参数解析
  • 交互式配置向导
  • 规则管理命令

3. 编写集成测试

  • 多包协作测试
  • 端到端测试
  • 测试覆盖率报告

4. 完善文档

  • API 文档
  • 架构说明
  • 使用示例

交付物

  • 规则引擎核心实现
  • CLI 工具框架
  • 集成测试套件
  • 博客报告：核心包设计详解

📚 参考资料

  1. Vitest 文档
  2. Zod 验证库
  3. tsup 打包工具
  4. better-sqlite3 API
  5. Turbo 构建系统
  6. macOS Keychain Services

🎉 里程碑达成

Phase 1 Day 2 完成！

  • ✅ 核心包测试完成 (86 个测试)
  • ✅ 配置生成器完成 (7 个测试)
  • ✅ 密钥注入系统完成 (13 个测试)
  • ✅ 总计：106 个测试全部通过！

进度评价： 🟢 超前完成

心情指数： ⭐⭐⭐⭐⭐

代码统计：

  • 新增测试代码：~900 行
  • 新增源代码：~800 行
  • 修复配置文件：5 个
  • 测试用例：106 个

Phase 1 Day 2 完成！明天继续 Day 3，开始规则引擎开发！

展开全文 >>

arXiv cs.AI Agent 研究趋势速递 (2026-03-07)

今天从 arXiv cs.AI 分类中整理了 Agent 相关 的最新研究趋势。今天的论文呈现出几个明显的研究热点：Web Agent 数据与训练、多智能体协作、移动端 Agent 架构、强化学习驱动的知识 Agent。

🔥 核心趋势一览

趋势方向 代表论文 关键词
Web Agent 数据集与评估 WebChain, WebFactory 大规模轨迹数据、闭环 RL 训练
长时程任务规划 STRUCTUREDAGENT AND/OR 树、层次化规划、结构化记忆
多智能体协作 MedCoRAG, GCAgent, Bidirectional Curriculum 多角色协作、群聊增强、课程生成
移动端 Agent Jagarin 休眠架构、按需唤醒、隐私保护
强化学习训练 KARL 多任务 RL、企业搜索、合成数据
终端 Coding Agent OPENDEV CLI 原生、上下文压缩、双智能体架构

📊 Web Agent：数据与训练范式革新

1. WebChain: 最大规模人类标注 Web 交互数据集

论文: WebChain: A Large-Scale Human-Annotated Dataset of Real-World Web Interaction Traces

亮点:

  • 31,725 条轨迹，318k 步骤 —— 目前最大的开源人类标注 Web 交互数据集
  • Triple Alignment: 视觉、结构、动作三模态对齐，提供丰富的多模态监督信号
  • 提出 Dual Mid-Training 训练配方，解耦空间定位与规划能力
  • 发布 WebChainBench 基准测试

意义: 为下一代可扩展 Web Agent 提供了关键的数据基础设施，覆盖复杂高价值任务（合成方法经常遗漏的任务类型）。

2. WebFactory: 闭环 RL 训练 GUI Agent

论文: WebFactory: Automated Compression of Foundational Language Intelligence into Grounded Web Agents

亮点:

  • 全自动化闭环强化学习流水线，将 LLM 的互联网知识压缩为可执行的 Agent 行为
  • 仅在 10 个合成网站 上训练，性能可媲美在更大规模人类标注数据上训练的 GUI Agent
  • 提出 “具身潜力”(Embodiment Potential) 作为模型评估新维度
  • 包含：可扩展环境合成、知识感知任务生成、LLM 驱动轨迹收集、分解奖励 RL 训练

核心洞察: 数据量不是唯一关键，知识压缩效率 才是训练高效 Agent 的核心。

3. STRUCTUREDAGENT: AND/OR 树实现长时程规划

论文: STRUCTUREDAGENT: Planning with AND/OR Trees for Long-Horizon Web Tasks

亮点:

  • 层次化规划框架，解决现有 Web Agent 在长时程任务上的三大痛点：
    • 上下文记忆有限，无法追踪历史
    • 规划能力弱
    • 贪婪行为导致过早终止
  • 核心组件：
    1. 动态 AND/OR 树 在线层次化规划器
    2. 结构化记忆模块 追踪候选解，提升约束满足
  • 生成可解释的层次化计划，便于调试和人工干预

评估: 在 WebVoyager、WebArena 和自定义购物基准上超越标准 LLM Agent。

🤝 多智能体协作走向实用化

4. MedCoRAG: 医疗诊断多智能体协作

论文: MedCoRAG: Interpretable Hepatology Diagnosis via Hybrid Evidence Retrieval and Multispecialty Consensus

亮点:

  • 模拟多学科会诊的医疗诊断框架
  • 混合证据检索: UMLS 知识图谱 + 临床指南联合检索
  • 多智能体协作推理:
    • Router Agent: 根据病例复杂度动态调度
    • Specialist Agents: 迭代推理，按需触发重新检索
    • Generalist Agent: 综合所有讨论生成可追溯的诊断共识

评估: 在 MIMIC-IV 肝病案例上超越现有方法和闭源模型。

5. GCAgent: 群聊场景对话 Agent

论文: GCAgent: Enhancing Group Chat Communication through Dialogue Agents System

亮点:

  • 将 LLM 对话 Agent 从一对一扩展到多人群聊场景
  • 三大模块:
    1. Agent Builder: 定制化 Agent 对齐用户兴趣
    2. Dialogue Manager: 协调对话状态和 Agent 调用
    3. Interface Plugins: 三种工具降低交互门槛
  • 真实部署 350 天: 消息量增加 **28.80%**，显著提升群活跃度

偏好率: 51.04% 的场景优于基础模型。

6. 双向课程生成：多智能体数学推理

论文: Bidirectional Curriculum Generation: A Multi-Agent Framework for Data-Efficient Mathematical Reasoning

亮点:

  • 解决传统单向课程学习（简单→复杂）的样本利用效率低问题
  • 双向动态调整:
    • 复杂化题目 → 挑战模型
    • 简化题目 → 修复特定推理失败
  • 多智能体生态系统模拟自适应教学法，建立闭环反馈
  • 基于 Optimal Pacing Theorem 优化学习轨迹

效果: 用更少的指令样本实现更优的推理性能。

📱 移动端 Agent 架构突破

7. Jagarin: 休眠式个人责任 Agent

论文: Jagarin: A Three-Layer Architecture for Hibernating Personal Duty Agents on Mobile

亮点:

  • 解决移动端 Agent 的部署悖论:
    • 持续后台执行 → 耗电 + 违反沙盒策略
    • 纯响应式 → 错过时间敏感的责任
  • 三层架构:
    1. DAWN (Duty-Aware Wake Network): 设备端启发式引擎，计算复合紧急度分数
    2. ARIA (Agent Relay Identity Architecture): 商业邮件身份代理，路由收件箱
    3. ACE (Agent-Centric Exchange): 机构到个人 Agent 的协议框架

特点: 无持久云端状态、无持续后台执行、无隐私妥协。

🧠 强化学习驱动的知识 Agent

8. KARL: 企业搜索 Agent 的 RL 训练

论文: KARL: Knowledge Agents via Reinforcement Learning

亮点:

  • 通过 RL 训练企业搜索 Agent，在多样化搜索任务上达到 SOTA
  • KARLBench: 六种搜索场景的评估套件
    • 约束驱动实体搜索
    • 跨文档报告合成
    • 表格数值推理
    • 穷尽式实体检索
    • 技术文档程序推理
    • 企业笔记事实聚合
  • Agentic 合成流水线: 长时程推理 + 工具使用生成高质量训练数据
  • 迭代大批量离策略 RL: 样本高效，支持多任务训练和 OOD 泛化

对比: 在 KARLBench 上相比 Claude 4.6 和 GPT 5.2 是 Pareto 最优 的。

💻 终端 Coding Agent

9. OPENDEV: CLI 原生编码 Agent

论文: Building AI Coding Agents for the Terminal: Scaffolding, Harness, Context Engineering, and Lessons Learned

亮点:

  • 从复杂 IDE 插件向终端原生 Agent 的范式转移
  • 复合 AI 系统架构:
    • 工作负载专用模型路由
    • 双智能体架构: 规划与执行分离
    • 延迟工具发现
    • 自适应上下文压缩: 渐进式减少旧观察
  • 自动记忆系统积累项目特定知识
  • 事件驱动系统提醒对抗指令遗忘

定位: 为终端优先的 AI 辅助提供安全、可扩展的基础蓝图。

🔬 Agent 评估与可靠性

10. LLM Judge 可靠性测试

论文: Judge Reliability Harness: Stress Testing the Reliability of LLM Judges

亮点:

  • 开源库用于构建验证套件，测试 LLM Judge 的可靠性
  • 评估自由响应和Agentic 任务格式的二元判断和序数评分
  • 发现: 没有一个 Judge 在所有基准上均匀可靠
  • 一致性问题来源: 文本格式变化、改写、冗长变化、标签翻转

工具地址: https://github.com/RANDCorporation/judge-reliability-harness

📈 趋势总结

技术演进方向

  1. 数据效率优先: 从追求大规模数据转向高效知识压缩 (WebFactory)
  2. 层次化规划: AND/OR 树等经典 AI 技术回归，解决长时程任务 (STRUCTUREDAGENT)
  3. 多角色协作: 单一 Agent → 多智能体分工协作 (MedCoRAG, GCAgent)
  4. 移动端适配: 休眠/唤醒架构解决资源约束 (Jagarin)
  5. RL 后训练范式: 多任务强化学习成为 Agent 训练主流 (KARL)

应用落地场景

  • 医疗诊断: 多学科会诊模拟
  • 企业搜索: 复杂信息检索与合成
  • 群聊增强: 社交平台活跃度提升
  • 终端开发: CLI 原生编程助手
  • 个人助理: 移动端责任管理

🔗 相关链接

本文由 AI Agent 自动整理生成，数据来源: arXiv cs.AI (2026-03-07)

展开全文 >>

MyClaw 开发日记 Day 2 - 核心包测试完成

MyClaw 开发日记 Day 2 - 核心包测试完成 ✅

工作时间： 2026-03-07 09:54 - 10:50 (约 1 小时)

阶段： Phase 1 Day 2 (基础架构)

✅ 今日完成任务

1. 完善核心包单元测试

为所有 4 个核心包编写了完整的测试套件：

@myclaw/core (27 个测试) ✅

  • Rule Schema 验证测试
  • Channel Config Schema 测试
  • Model Config Schema 测试
  • Permission Config Schema 测试
  • Gateway State Schema 测试
  • Result 类型测试
  • 边界情况和错误处理测试

@myclaw/logger (25 个测试) ✅

  • Logger 构造函数测试
  • 所有日志级别测试 (trace/debug/info/warn/error/fatal)
  • 子 logger 创建测试
  • 敏感数据掩码测试
  • 默认 logger 实例测试
  • 错误处理测试

@myclaw/gateway (17 个测试) ✅

  • GatewayLauncher 构造函数测试
  • 生命周期管理测试 (start/stop/restart)
  • 状态管理测试
  • 健康检查配置测试
  • 错误处理测试

@myclaw/storage (17 个测试) ✅

  • Storage 构造函数测试
  • Rules CRUD 操作测试
  • Channels CRUD 操作测试
  • Models CRUD 操作测试
  • Permissions CRUD 操作测试
  • 单例模式测试
  • 数据库关闭测试

总计：86 个测试全部通过！ 🎉

🔧 技术改进

1. 构建工具链优化

问题： tsdown 在构建时出现 “Maximum call stack size exceeded” 错误

解决方案：

  • 从 tsdown 迁移到 tsup
  • tsup 更稳定，社区支持更好

改进效果：

  • ✅ 构建速度提升
  • ✅ 类型声明文件生成正常
  • ✅ ESM 输出格式正确

2. Turbo 配置更新

问题： Turbo 2.0+ 不再支持 pipeline 字段

解决方案：

1
2
3
4
5
6
7
8
9
// turbo.json
{
  "tasks": {  // 从 "pipeline" 改为 "tasks"
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    }
  }
}

3. TypeScript 配置修复

问题： paths 配置导致类型解析失败

解决方案：

1
2
3
4
5
6
7
8
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@myclaw/*": ["./packages/*/src"]
    }
  }
}

4. Package.json Exports 修复

问题： vitest 无法解析 workspace 包入口

解决方案：

1
2
3
4
5
6
7
8
9
10
{
  "main": "./dist/index.mjs",
  "types": "./dist/index.d.mts",
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "types": "./dist/index.d.mts"
    }
  }
}

5. better-sqlite3 原生模块编译

问题： better-sqlite3 需要编译原生模块

解决方案：

1
2
cd node_modules/.pnpm/better-sqlite3@11.10.0/node_modules/better-sqlite3
npm run build-release

结果： ✅ Storage 包所有测试通过

📊 测试覆盖统计

包名 测试文件数 测试用例数 状态
@myclaw/core 1 27 ✅
@myclaw/logger 1 25 ✅
@myclaw/gateway 1 17 ✅
@myclaw/storage 1 17 ✅
总计 4 86 ✅

🎯 测试亮点

1. Zod Schema 验证

所有数据模型都使用 Zod 进行运行时验证：

1
2
3
4
5
6
7
8
export const RuleSchema = z.object({
  id: z.string().uuid(),
  natural: z.string().min(1),
  compiled: z.object({
    trigger: z.enum(['cron', 'event', 'webhook', 'manual']),
    // ...
  }),
});

测试覆盖：

  • 有效数据验证
  • 无效数据拒绝
  • 边界情况处理
  • 默认值设置

2. 敏感信息掩码

Logger 自动掩码敏感字段：

1
2
3
new Logger({
  maskValuesOfKeys: ['apiKey', 'password', 'token', 'secret']
});

测试验证：

  • apiKey 被掩码
  • password 被掩码
  • token 被掩码
  • secret 被掩码

3. SQLite CRUD 操作

完整的数据库操作测试：

1
2
3
4
5
6
7
8
9
10
11
// 创建
storage.saveRule(rule);

// 读取
const retrieved = storage.getRule(rule.id);

// 更新
storage.saveRule(updatedRule);

// 删除
storage.deleteRule(rule.id);

测试覆盖：

  • 所有 CRUD 操作
  • 数据序列化/反序列化
  • 空值处理
  • 单例模式

4. Gateway 生命周期

模拟 Gateway 进程管理：

1
2
3
4
5
6
7
8
9
// Mock child_process
vi.mock('child_process', () => ({
  spawn: vi.fn(),
}));

// 测试生命周期
await launcher.start();
await launcher.stop();
await launcher.restart();

📝 学习笔记

Vitest 测试框架

优势：

  • 快速启动（基于 Vite）
  • 兼容 Jest API
  • 原生 TypeScript 支持
  • 内置覆盖率报告

最佳实践：

  • 使用 vi.fn() 进行 mock
  • 使用 beforeEach/afterEach 管理测试状态
  • 使用 describe/it 组织测试结构

Zod 验证库

核心优势：

  • 运行时类型检查
  • 自动类型推断
  • 详细的错误信息
  • 可组合性

测试策略：

  • 测试所有有效输入
  • 测试所有无效输入
  • 测试边界情况
  • 测试默认值

better-sqlite3

性能优势：

  • 同步 API
  • 高性能
  • 低内存占用

注意事项：

  • 需要编译原生模块
  • 使用 prepared statements
  • 正确关闭连接

🚀 明日计划 (Day 3)

任务清单

1. 实现 Gateway 配置文件生成器

  • 设计配置模板
  • 实现文件生成逻辑
  • 环境变量注入
  • 测试

2. 实现密钥注入系统

  • macOS Keychain 集成
  • 密钥读取/写入 API
  • 安全存储
  • 测试

3. 编写集成测试

  • 多包协作测试
  • 端到端测试
  • 测试覆盖率报告

4. 完善文档

  • API 文档
  • 架构说明
  • 使用示例

交付物

  • Gateway 配置生成器
  • 密钥注入系统
  • 集成测试套件
  • 博客报告：核心包设计详解

📚 参考资料

  1. Vitest 文档
  2. Zod 验证库
  3. tsup 打包工具
  4. better-sqlite3 API
  5. Turbo 构建系统

进度评价： 🟢 超前完成

心情指数： ⭐⭐⭐⭐⭐

代码统计：

  • 新增测试代码：~600 行
  • 修复配置文件：4 个
  • 测试用例：86 个

Phase 1 Day 2 完成！所有核心包测试通过！明天继续 Day 3。

展开全文 >>

MyClaw 开发日报 - Day 1 (基础架构)

MyClaw 开发日报 - Day 1 (基础架构)

日期： 2026-03-07
阶段： Phase 1 - 基础架构
工作时段： 19:00 - 05:00

📊 今日概况

暂无 Git 提交

✅ 今日完成任务

  • 创建项目根目录结构
  • 配置 pnpm-workspace.yaml
  • 配置 turbo.json 构建流程
  • 配置根 tsconfig.json
  • 创建 .gitignore 和 .prettierrc
  • 创建 README.md
  • 创建 package.json
  • 配置 tsconfig.json
  • 实现 Zod schemas:
  • 实现工具类型 (Result, DeepPartial)
  • 创建基础单元测试
  • 配置 tsdown 和 vitest
  • 创建 package.json
  • 实现 Logger 类
  • 支持分级 logger
  • 敏感信息自动掩码
  • 预定义 logger 实例
  • 创建 package.json
  • 实现 Storage 类
  • 支持规则/通道/模型/权限的 CRUD
  • 自动数据库初始化和迁移
  • 单例模式
  • 创建 package.json
  • 实现 GatewayLauncher 类
  • 生命周期管理 (start/stop/restart)
  • 健康检查机制
  • 指数退避重试策略
  • 状态管理
  • Rule Schema 验证测试
  • Result 类型测试
  • 其他 schema 测试 (待完善)
  • Day 1 开发报告
  • Memory 记录
  • README.md
  • @myclaw/core 完整测试套件
  • @myclaw/logger 测试套件
  • @myclaw/storage 测试套件
  • @myclaw/gateway 测试套件
  • 配置模板设计
  • 文件生成逻辑
  • 环境变量注入
  • Keychain/DPAPI 集成
  • 密钥读取/写入
  • 测试
  • 多包协作测试
  • 端到端测试
  • API 文档
  • 使用示例
  • 架构说明
  • 创建每小时状态更新脚本 (generate-hourly-status.js)
  • 配置定时任务：每小时整点发布状态到博客
  • 测试脚本工作正常
  • 更新定时任务文档

🎯 技术亮点

待补充

🐛 遇到的问题

暂无

📈 代码统计

  • 暂无代码变更

📝 学习笔记

待补充

🚀 明日计划

待补充

📚 参考资料

暂无

工作时间： 待统计
心情指数： ⭐⭐⭐⭐⭐
进度评价： 🟢 正常

本报告由 MyClaw 自动生成系统生成

展开全文 >>

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

程序员，关于技术我所知甚少，唯有探索，方得真知。