picoclaw/PicoClaw贡献方向规划.md
xiaoen 0c6eeec230 merge: resolve conflict with main in loop.go
Main reformatted the fallback.Execute call to multi-line (golines);
our branch renamed agent.Candidates → activeCandidates for routing.
Kept both: multi-line formatting + routing variable.
2026-03-03 12:22:45 +08:00

3.5 KiB
Raw Blame History

PicoClaw 贡献方向规划3月1日更新

个人情况

  • Go 开发者,会 Python在学 AI Agent
  • 已合并 PR#173多bug修复、#186安全加固
  • 已提交 PR#732JSONL session store等待 review
  • 已关闭 PR#719SQLite 方案,被维护者建议改用 JSONL

项目当前态势3月1日

已完成的重构

  • Provider 重构daming #492 — 完成
  • Channel 重构 Phase 1alexhoshina #662 — 完成
  • Channel 重构 Phase 2alexhoshina #877 (10,926行) — 2月27日合并
  • Migrate 重构lxowalle #910 — 2月28日合并

正在进行的重构

  • Tools 系统重构lxowalle PR #84650个文件— OPEN
  • Plugin 系统gh-xj PR #936-9394个PR系列— OPEN
  • Agent 系统重构alexhoshina Issue #772roadmap— 只有 issue还没有 PR

我的行动记录

  • 2月24日在 #772 评论,将 PR #732 定位为 Agent 重构的 memory 子任务
  • 3月1日在 #295 评论,提出模型路由设计方案

战略方向

方向 1智能模型路由#295— 主攻 代码已完成

为什么选这个

  1. Zepan创始人亲自创建的 issueroadmap 标签
  2. 有大量社区讨论但零 PR
  3. 独立模块 pkg/routing/,不碰任何重构区文件
  4. 面试价值极高

已完成(分支 feat/model-routing

  • pkg/routing/features.go — ExtractFeatures5维结构评分纯语言无关
  • pkg/routing/classifier.go — Classifier 接口 + RuleClassifier加权求和上限 1.0
  • pkg/routing/router.go — RouterSelectModel阈值默认 0.35
  • pkg/routing/router_test.go — 34 个测试,全部通过
  • pkg/config/config.go — RoutingConfig 添加到 AgentDefaults
  • pkg/agent/instance.go — 预计算 Router + LightCandidates
  • pkg/agent/loop.go — selectCandidates helperturn 级别粘性路由

3 个 commit773 行新增33 行修改0 个新依赖

配置

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-6",
      "routing": {
        "enabled": true,
        "light_model": "gemini-flash",
        "threshold": 0.35
      }
    }
  }
}

下一步:向上游 push 并开 PRPR body 引用 issue #295

方向 2JSONL Store 集成 — 等待时机

PR #732 已提交。等 Tools 重构 (#846) 合并后再做集成 PR。 已在 #772 评论建立关联。

方向 3sessions CLI 子命令(#575— 备选快速 PR

如果需要一个快速能合并的 PR 来积累信任:

  • picoclaw sessions list/clear/export
  • 不碰任何重构区文件
  • 实用性强

需要避开的区域

区域 原因
Tools 系统 lxowalle PR #846 正在重构
Plugin 系统 gh-xj PR #936-939 正在做
Channel 任何东西 alexhoshina 刚完成大重构
Provider 配置 daming 已定型
MCP 两个竞争 PR (#282, #376)
Hooks 基础 gh-xj #936 包含 pkg/hooks/
AgentLoop 拆分 SaiBalusu-usf PR #699
Tool pair 修复 QuietyAwe PR #871

关键人物(更新)

GitHub 角色 最近活动
Zepan @Zepan 创始人 #806 WebUI issue
daming @yinwm Provider/审核 审核 PR #877
alexhoshina @alexhoshina Channel+Agent 重构 #877 合并,#772 发起
lxowalle @lxowalle Tools+审核 #846 Tools重构中
gh-xj @gh-xj Plugin 系统 #936-939 四个 PR
nikolasdehor @nikolasdehor 社区活跃评论者 每个 issue 都有他