From 04ddb6b472e991a25fc05b6d3fba100649025d33 Mon Sep 17 00:00:00 2001 From: xiaoen <2768753269@qq.com> Date: Fri, 6 Mar 2026 12:20:21 +0800 Subject: [PATCH] chore: remove accidentally committed local files --- .claude/settings.local.json | 42 -------- PicoClaw 26M2W3 社区开发者会议.md | 161 ------------------------------ PicoClaw贡献方向规划.md | 108 -------------------- 3 files changed, 311 deletions(-) delete mode 100644 .claude/settings.local.json delete mode 100644 PicoClaw 26M2W3 社区开发者会议.md delete mode 100644 PicoClaw贡献方向规划.md diff --git a/.claude/settings.local.json b/.claude/settings.local.json deleted file mode 100644 index aa8927667..000000000 --- a/.claude/settings.local.json +++ /dev/null @@ -1,42 +0,0 @@ -{ - "permissions": { - "allow": [ - "Bash(cd:*)", - "Bash(cd /e/Project/picoclaw && go test ./pkg/memory/... -v -count=1 2>&1)", - "Bash(cd /e/Project/picoclaw && golangci-lint run ./pkg/memory/... 2>&1)", - "Bash(cd /e/Project/picoclaw && golangci-lint run ./pkg/memory/... --fix 2>&1)", - "Bash(cd /e/Project/picoclaw && go test ./pkg/memory/... -count=1 2>&1)", - "Bash(cd /e/Project/picoclaw && go vet ./pkg/memory/... 2>&1)", - "Bash(cd /e/Project/picoclaw && go build ./... 2>&1)", - "Bash(cd /e/Project/picoclaw && go test ./pkg/memory/... -bench=. -benchmem -run=^$ 2>&1)", - "Bash(cd /e/Project/picoclaw && go test ./pkg/session/... -count=1 2>&1)", - "mcp__sequential-thinking__sequentialthinking", - "Bash(cd /e/Project/picoclaw && git push -u origin feat/jsonl-memory-store 2>&1)", - "Bash(head:*)", - "WebSearch", - "Bash(cd /e/Project/picoclaw && gh issue view 711 --comments 2>&1)", - "Bash(cd /e/Project/picoclaw && gh pr view 732 --comments 2>&1)", - "Bash(cd /e/Project/picoclaw && gh pr view 732 2>&1)", - "Bash(cd /e/Project/picoclaw && gh pr checks 732 2>&1)", - "Bash(echo no upstream remote:*)", - "Bash(cd /e/Project/picoclaw && git rebase upstream/main 2>&1)", - "Bash(cd /e/Project/picoclaw && go build ./pkg/memory/... 2>&1)", - "Bash(cd /e/Project/picoclaw && go test ./pkg/memory/... -count=1 -v 2>&1)", - "Bash(gh api:*)", - "Bash(git push:*)", - "Bash(go test:*)", - "Bash(find .:*)", - "Bash(golangci-lint run:*)", - "Bash(gh pr:*)", - "Bash(gh issue:*)", - "Bash(git fetch:*)", - "Bash(echo exit: $?:*)", - "WebFetch(domain:github.com)", - "Bash(git log:*)", - "Bash(grep:*)", - "Bash(ls:*)", - "Bash(go build:*)", - "Bash(go vet:*)" - ] - } -} diff --git a/PicoClaw 26M2W3 社区开发者会议.md b/PicoClaw 26M2W3 社区开发者会议.md deleted file mode 100644 index ab356424e..000000000 --- a/PicoClaw 26M2W3 社区开发者会议.md +++ /dev/null @@ -1,161 +0,0 @@ -# PicoClaw 26M2W3 社区开发者会议 - -> **PicoClaw的设计目标**：轻量高效，任意部署；简单易用，普惠大众； -> **致PicoClaw开发者**：让我们携手加速AI奇点的到来，共同创造并见证历史。 - ---- - -## 26M2W3 概况 - -### 成果 -* **Github 表现**：Star 17K+，Merge 100+ PR，Contributors 70+ -* **用户规模**：微信群 1600+，Discord 1300+ -* **开发者规模**：微信群 ~50，Discord ~40 -* **生态进展**：PicoClaw 进入 Homebrew -* **工程进展**：Provider 完成重构 -* **特别鸣谢**：daming, lxowalle 在假期的努力！ - -### 暴露的问题 -* 第一次开展大规模社区协同开发，又是在假期期间，响应速度、社区协调、工程架构方面都暴露出了很多不足。 -* PicoClaw 早期 vibe-coding 的快速实现架构在蜂拥而至的 PR 面前会迅速变成“屎山”和冲突地狱。 -* 为尽快合并 PR，未充分验证社区开发者的能力，也没有提供合并指导规范，过早给予 write 权限，在上面架构问题下更暴露出问题。 -* 忙于以上 PR 协调问题，拖后了文档和宣发进度。特别是宣发问题，被不放春节假的海外开发者项目 zeroclaw 趁虚而入。 -* ⚠️ **警惕币圈！** 尤其是 pump.fun 空气币，不要认领参与！ - -> **会议核心任务**：本次周会主要需要划分项目板块，认领板块负责人，制订下周计划。以下内容社区开发者可以继续添加遗漏的地方。 - ---- - -## 开发板块 - -### 仓库管理 -* 新建 `dev` 分支，`main` 分支推送严格化。 -* 完善 `CONTRIBUTING.md`。 -* **时区审核分工**： - * GMT+8 附近时区审核（中国） - * GMT+0 附近时区审核（欧洲）：**Huaaudio** - * GMT-8 附近时区审核（美洲） -* 仓库权限申请：联系 **zepan** 审核。 -* Readme 中公布本次会议的分工人员表格，方便开发者找寻对应人员审核。 - -### Provider（负责人：daming） -* **进度**：已重构完成。 -* **计划**： - * 梳理支持和计划支持的 provider 协议列表及进度计划。 - * **插件系统探索**：go 原生插件？(参考 [hashicorp/go-plugin](https://github.com/hashicorp/go-plugin)) - * **优化思路**：现在各种系统的 LLM provider 都在重复造轮子，而且每新增一个 provider 都得再改代码、重新发版才能支持。应该把专业的事交给专业的组件来负责。我开了个新的开源项目——`open-next-router`，采用 nginx 原子化配置的思想，新增 provider 无需改代码，新增配置文件即可支持，提供了 go 的 sdk 包，可快速接入项目。PicoClaw 接入后可更聚焦于 agent 的实现而不是各种上游 provider 的适配，就能快其它 claw 一步。 - -### Channels（负责人：daming） -* **进度**：正在重构。 -* **计划**： - * 梳理支持和计划支持的 channel 协议列表及进度计划。 - * **附件支持讨论**：音频、视频、文件。 - * 附件的生命周期应该由谁管理？channel 应该只负责下载文件，然后交由 Agent 消费完成后管理生命周期？ - * 音频转文字是否要迁移到 agent 层？或者说附件应该在哪一层被处理？ - * 发送附件的方法如何拓展？添加新的方法？拓展原有 Message？ - * 群友建议的 **skill加channel**？(参考 [nanoclaw skill](https://github.com/qwibitai/nanoclaw/blob/main/.claude/skills/add-telegram/SKILL.md)) - * **插件系统讨论**。 - * **架构优化**： - * 抽离公共的 HTTP 服务器，采用 WebHook 通信的 channel 通过复用公共的服务器来节省资源和端口。 - * Websocket 支持。 - * 将路由相关字段（`peer_kind`、`peer_id`）从 metadata 中提升为 `InboundMessage` 的结构体字段。 - * **状态管理**：聊天记录应该由 channel 管理还是 agent 管理？ - -### Agent（负责人：学欧） -* Agent Loop 机制优化。 -* **记忆系统**：引入 SQLite。 -* **Multi-Agent / Swarm** 支持。 -* **模型能力回退链**：在主模型不支持多模态时，使用多模态模型进行辅助。 - -### Tools（负责人：学欧） -* 整理规范。 -* 插件系统探索。 - -### Heartbeat / Status / Log 等（负责人：daming） -* 完善心跳、状态和日志监控。 - -### Skill -* 搜索 skill 的 skill，已合并 PR：[PR #332](https://github.com/sipeed/picoclaw/pull/332)。 -* **安全与维护**：探讨 skill 的维护和安全性问题，防范目前常见的投毒现象。 - -### MCP（负责人：evo） -* **功能实现**：已有 PR [#376](https://github.com/sipeed/picoclaw/pull/376)、[#282](https://github.com/sipeed/picoclaw/pull/282)。 -* 安卓手机操作支持。 -* 浏览器操作 (`webmcp?` `action book?`)：已有相关 PR ([agent-browser-tool](https://github.com/sipeed/picoclaw/tree/feat/agent-browser-tool))。 - -### 占用/效率优化（负责人：学欧） -* **目标**：优化内存占用与执行效率，希望控制在 **20M 以内**。 -* **分析**：分析各个版本之间的内存占用变化，分析各个模块的内存占用情况。 -* **裁剪**：裁剪出最小版本，用于宣发。 - -### Security -* 响应并修复安全机构发送的漏洞警示。 -* 参考 openclaw 等现有仓库的安全措施，加固 PicoClaw。 - -### AI CI（负责人：政宇） -* 完善仓库的 CI 流程。 -* 加入 AI review 等自动化流程。 -* 完善发布流程、测试项目、release note、breaking change 记录。 -* 根目录加上 `CLAUDE.md`？ -* 增加 `loongarch` & `deb/rpm` 支持。 - -### UX Testing -* 对 release 版进行一般性测试。 -* 站在小白用户角度对使用交互提出意见建议，比如完善 PicoClaw onboard 流程。 -* 展示性优化：比如启动时刷屏 ascii-art 的 PicoClaw 标识，增加用户拍摄视频时的辨识度。 - -### 文档工作 -* 仓库 Readme 美化，仓库文档整理、规范。 -* 整理所有 Channel、Provider 的实现支持列表。 -* 针对小白用户的各个 Provider、Channel 详细手把手教程文档。 -* 建设 Wiki 页面（deepwiki?）。 - ---- - -## Release 待办事项 (Checklist) -- [ ] Provider -- [ ] Channel -- [ ] Agent -- [ ] Swarm -- [ ] Security -- [ ] MCP：浏览器 -- [ ] 文档 -- [ ] Logo -- [ ] Metadata 问题解决 - ---- - -## 关于插件系统测试方案（补充记录） -测试了以下几种方案： -1. **内置的 plugin 模块**：不考虑。不支持 Windows 等平台 ([plugin](https://pkg.go.dev/plugin@go1.26.0))。 -2. **hashicorp/go-plugin**：不考虑。占用资源过大，固件都增加了 20～30M。 -3. **net/rpc**（client-server 模式）： - * **优点**：支持热加载，插件可以保存运行状态。 - * **缺点**：资源消耗较多（内存约增加 5M+，每个插件大小 10+M），每个插件占用一个端口，不太优雅。 -4. **encoding/gob**（编译为可执行程序，由主程序调用并获取返回值）： - * **优点**：支持热加载，消耗资源相对较少（测试固件大小增加了 376KB，内存消耗增加了 640KB）。 - * **缺点**：无法保存运行状态（应该可以用 socket 等方法来优化支持）。 - ---- - -## 宣发板块 - -### 社区运营 -* **宣发物料/策划**：负责人 **zepan**，再寻求 1~2 位有网感的社区成员。 - * 制作标准 Logo, Slogan。 - * 制作具有传播性的图文/视频等。 - * 策划互动性、传播性强的用户活动，产生用户内容。 - * KOL 建联等其它宣发手段。 -* **微信群运营**：负责人 **zepan**。 -* **推特运营**：负责人 **zepan**。 -* **Discord运营**：负责人 **OsmiumOP**；需要再找一个国内开发者盯一下，会给予 admin 权限。 -* **其他渠道开拓**：小红书、知乎、Reddit？ -* **Go社区联络大使**：负责人 **卓**。 - ---- - -## 中期 TODO - -* **桌面应用 / 安卓 APP** - * 架构讨论：C/S 还是单程序？接口文档规范？ -* **配套硬件** diff --git a/PicoClaw贡献方向规划.md b/PicoClaw贡献方向规划.md deleted file mode 100644 index 0b4ea40b8..000000000 --- a/PicoClaw贡献方向规划.md +++ /dev/null @@ -1,108 +0,0 @@ -# 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 都有他 |