1a922c96a8
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.
108 lines
3.5 KiB
Markdown
108 lines
3.5 KiB
Markdown
# 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）— 主攻 ✅ 代码已完成
|
||
|
||
**为什么选这个**：
|
||
1. Zepan（创始人）亲自创建的 issue，roadmap 标签
|
||
2. 有大量社区讨论但零 PR
|
||
3. 独立模块 `pkg/routing/`，不碰任何重构区文件
|
||
4. 面试价值极高
|
||
|
||
**已完成（分支 feat/model-routing）**：
|
||
- `pkg/routing/features.go` — ExtractFeatures：5维结构评分，纯语言无关
|
||
- `pkg/routing/classifier.go` — Classifier 接口 + RuleClassifier（加权求和，上限 1.0）
|
||
- `pkg/routing/router.go` — Router：SelectModel，阈值默认 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 helper，turn 级别粘性路由
|
||
|
||
**3 个 commit，773 行新增，33 行修改，0 个新依赖**
|
||
|
||
**配置**：
|
||
```json
|
||
{
|
||
"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 都有他 |
|