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.
3.5 KiB
3.5 KiB
PicoClaw 贡献方向规划(3月1日更新)
个人情况
- Go 开发者,会 Python,在学 AI Agent
- 已合并 PR:#173(多bug修复)、#186(安全加固)
- 已提交 PR:#732(JSONL session store,等待 review)
- 已关闭 PR:#719(SQLite 方案,被维护者建议改用 JSONL)
项目当前态势(3月1日)
已完成的重构
- Provider 重构:daming #492 — 完成
- Channel 重构 Phase 1:alexhoshina #662 — 完成
- Channel 重构 Phase 2:alexhoshina #877 (10,926行) — 2月27日合并
- Migrate 重构:lxowalle #910 — 2月28日合并
正在进行的重构
- Tools 系统重构:lxowalle PR #846(50个文件)— OPEN
- Plugin 系统:gh-xj PR #936-939(4个PR系列)— OPEN
- Agent 系统重构:alexhoshina Issue #772(roadmap)— 只有 issue,还没有 PR
我的行动记录
- 2月24日:在 #772 评论,将 PR #732 定位为 Agent 重构的 memory 子任务
- 3月1日:在 #295 评论,提出模型路由设计方案
战略方向
方向 1:智能模型路由(#295)— 主攻 ✅ 代码已完成
为什么选这个:
- Zepan(创始人)亲自创建的 issue,roadmap 标签
- 有大量社区讨论但零 PR
- 独立模块
pkg/routing/,不碰任何重构区文件 - 面试价值极高
已完成(分支 feat/model-routing):
pkg/routing/features.go— ExtractFeatures:5维结构评分,纯语言无关pkg/routing/classifier.go— Classifier 接口 + RuleClassifier(加权求和,上限 1.0)pkg/routing/router.go— Router:SelectModel,阈值默认 0.35pkg/routing/router_test.go— 34 个测试,全部通过pkg/config/config.go— RoutingConfig 添加到 AgentDefaultspkg/agent/instance.go— 预计算 Router + LightCandidatespkg/agent/loop.go— selectCandidates helper,turn 级别粘性路由
3 个 commit,773 行新增,33 行修改,0 个新依赖
配置:
{
"agents": {
"defaults": {
"model": "claude-sonnet-4-6",
"routing": {
"enabled": true,
"light_model": "gemini-flash",
"threshold": 0.35
}
}
}
}
下一步:向上游 push 并开 PR,PR body 引用 issue #295
方向 2:JSONL Store 集成 — 等待时机
PR #732 已提交。等 Tools 重构 (#846) 合并后再做集成 PR。 已在 #772 评论建立关联。
方向 3:sessions 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 都有他 |