Skip to content

Commit 231d1f9

Browse files
committed
feat: 完成 Roadmap Issues #9, #10, #11
Issue #9: 安装成功率提升 - 新增 docs/troubleshooting.md 故障排查文档 - 增强 doctor 命令,添加详细解决方案和文档链接 - 添加 --verbose 选项和平台特定修复建议 - 改进错误诊断和自动修复功能 Issue #10: 记忆搜索增强 - 新增 omp search <query> 语义搜索命令 - 基于 BGE-M3 embedding 的向量搜索 - 支持 --limit 和 --json 选项 Issue #11: 批量记忆管理 - 新增 omp memory 命令组 (别名: omp mem) - omp memory list - 列出所有记忆 - omp memory delete --all 或 --ids - 批量删除 - omp memory export - 导出记忆到 JSON 文件
1 parent 31912f1 commit 231d1f9

9 files changed

Lines changed: 1913 additions & 41 deletions

File tree

_bmad-output/innovation-strategy-2026-02-05.md

Lines changed: 640 additions & 0 deletions
Large diffs are not rendered by default.
Lines changed: 215 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,215 @@
1+
# 开源项目 Roadmap 最佳实践研究报告
2+
3+
**研究日期**: 2026-02-05
4+
**研究类型**: Domain Research
5+
**目标项目**: OpenMemory Plus
6+
7+
---
8+
9+
## 📋 执行摘要
10+
11+
本研究分析了成功开源项目的 Roadmap 管理实践,包括 GitHub、Loom、Buffer 等项目的公开 Roadmap 案例,以及 CNCF 等组织的最佳实践指南。核心发现:**有效的开源 Roadmap 不仅是功能规划工具,更是社区建设和贡献者吸引的战略资产**
12+
13+
### 关键洞察
14+
15+
| 维度 | 最佳实践 | OpenMemory Plus 建议 |
16+
|------|----------|---------------------|
17+
| **展示形式** | GitHub Projects + README 双轨制 | 采用 GitHub Projects 可视化 + README 精简版 |
18+
| **更新频率** | 每 2-4 周同步更新 | 与版本发布节奏对齐 |
19+
| **社区互动** | 投票 + 评论 + 反馈闭环 | 先实现基础可见性,后续增加互动 |
20+
| **时间粒度** | 季度规划 + 月度迭代 | Now / Next / Later 模式更适合小团队 |
21+
22+
---
23+
24+
## 🔍 研究发现
25+
26+
### 1. Roadmap 类型分类
27+
28+
根据 CNCF 最佳实践,开源项目 Roadmap 分为四类:
29+
30+
| 类型 | 描述 | 适用场景 |
31+
|------|------|----------|
32+
| **Feature Roadmap** | 功能规划,列出即将开发的特性 | 产品导向项目 |
33+
| **Release Roadmap** | 版本发布计划,明确每个版本内容 | 有固定发布周期的项目 |
34+
| **Technology Roadmap** | 技术栈演进计划 | 基础设施/框架项目 |
35+
| **Non-Code Roadmap** | 社区、文档、活动等非代码目标 | 成熟的开源社区 |
36+
37+
**OpenMemory Plus 建议**: 采用 **Feature Roadmap + Release Roadmap 混合模式**
38+
39+
### 2. 成功案例分析
40+
41+
#### GitHub Public Roadmap
42+
- **形式**: 独立仓库 `github/roadmap` + GitHub Projects
43+
- **优点**: 按季度组织,状态清晰,与 GitHub 生态深度集成
44+
- **缺点**: 只读模式,缺乏双向互动
45+
- **学习点**: 使用 Projects 的 Roadmap 视图展示时间线
46+
47+
#### Loom Public Roadmap
48+
- **形式**: Productboard 托管
49+
- **优点**: 用户投票,按产品区域分类
50+
- **缺点**: 无法订阅,只能投票不能评论
51+
- **学习点**: 让用户参与优先级决策
52+
53+
#### Buffer Public Roadmap
54+
- **形式**: Kanban 视图 (Planned → In Progress → Complete)
55+
- **优点**: 状态变更通知,投票 + 评论系统
56+
- **缺点**: 列过多时导航困难
57+
- **学习点**: 简单的状态流转更易理解
58+
59+
### 3. Roadmap 核心要素
60+
61+
根据 Ducalis.io 和 CNCF 的综合建议:
62+
63+
```
64+
✅ 必备要素:
65+
├── 简洁设计 - 避免信息过载
66+
├── 清晰状态 - Now / Next / Later 或 Planned / In Progress / Done
67+
├── 易于导航 - 用户能快速找到关心的功能
68+
├── 定期更新 - 保持与实际开发同步
69+
└── 可访问性 - 嵌入网站或独立页面
70+
71+
⭐ 加分要素:
72+
├── 用户投票 - 让社区影响优先级
73+
├── 评论讨论 - 收集详细反馈
74+
├── 状态通知 - 进度变更时通知关注者
75+
└── 分类视图 - 按领域/模块筛选
76+
```
77+
78+
### 4. GitHub Projects vs Milestones
79+
80+
| 特性 | GitHub Projects | GitHub Milestones |
81+
|------|-----------------|-------------------|
82+
| **可视化** | 表格/看板/Roadmap 多视图 | 仅进度条 |
83+
| **跨仓库** | ✅ 支持 | ❌ 不支持 |
84+
| **自定义字段** | ✅ 丰富 | ❌ 有限 |
85+
| **时间线展示** | ✅ Roadmap 视图 | ❌ 无 |
86+
| **适用场景** | 长期规划展示 | 版本发布管理 |
87+
88+
**推荐**: 使用 **GitHub Projects** 作为公开 Roadmap,**Milestones** 作为内部版本管理
89+
90+
### 5. 小型开源项目的简化方案
91+
92+
对于个人/小团队项目(如 OpenMemory Plus),过度复杂的 Roadmap 系统会增加维护负担。
93+
94+
**推荐的 "Now / Next / Later" 模式**:
95+
96+
```markdown
97+
## 🗺️ Roadmap
98+
99+
### 🔥 Now (当前进行中)
100+
- [ ] 功能 A - 预计 2 周内完成
101+
- [ ] 功能 B - 开发中
102+
103+
### 📅 Next (下一阶段)
104+
- [ ] 功能 C
105+
- [ ] 功能 D
106+
107+
### 💡 Later (未来考虑)
108+
- [ ] 功能 E
109+
- [ ] 功能 F
110+
```
111+
112+
**优势**:
113+
- 无需精确日期承诺(避免估算压力)
114+
- 维护成本低
115+
- 用户易于理解
116+
- 灵活调整优先级
117+
118+
---
119+
120+
## 💡 OpenMemory Plus Roadmap 建议
121+
122+
### 推荐方案: README + GitHub Projects 双轨制
123+
124+
#### 1. README 精简版 Roadmap
125+
126+
在 README 中保留高层次的方向性 Roadmap:
127+
128+
```markdown
129+
## 🗺️ Roadmap
130+
131+
### 🔥 Now (v1.6)
132+
- [ ] 记忆搜索增强 - 支持语义搜索
133+
- [ ] 批量记忆管理命令
134+
135+
### 📅 Next (v2.0)
136+
- [ ] Web UI 管理界面
137+
- [ ] 团队记忆共享 (可选)
138+
139+
### 💡 Later
140+
- [ ] 云端同步选项
141+
- [ ] 记忆分析洞察
142+
143+
👉 [查看完整 Roadmap](链接到 GitHub Projects)
144+
```
145+
146+
#### 2. GitHub Projects 详细版
147+
148+
创建公开的 GitHub Project,使用 Roadmap 视图:
149+
150+
| 字段 | 用途 |
151+
|------|------|
152+
| **Status** | Inbox / Planned / In Progress / Done |
153+
| **Priority** | 🔴 High / 🟡 Medium / 🟢 Low |
154+
| **Target Version** | v1.6 / v2.0 / Future |
155+
| **Category** | Core / CLI / Integration / Docs |
156+
157+
#### 3. 更新节奏
158+
159+
| 事件 | 更新内容 |
160+
|------|----------|
161+
| 版本发布 | 移动已完成项到 Done,更新 README |
162+
| 每 2 周 | Review Project 状态,调整优先级 |
163+
| 社区反馈 | 添加到 Inbox,定期 triage |
164+
165+
---
166+
167+
## 🎯 立即行动计划
168+
169+
### Phase 1: 基础建设 (本周)
170+
171+
1. **创建 GitHub Project**
172+
- 名称: "OpenMemory Plus Roadmap"
173+
- 可见性: Public
174+
- 视图: Table + Roadmap
175+
176+
2. **迁移现有 README Roadmap**
177+
- 将当前 Roadmap 项目转为 Issues
178+
- 关联到 Project
179+
180+
3. **更新 README**
181+
- 采用 Now / Next / Later 格式
182+
- 添加 Project 链接
183+
184+
### Phase 2: 社区互动 (下月)
185+
186+
1. 启用 Discussions 收集反馈
187+
2. 定期发布 Roadmap 更新公告
188+
3. 在 Issue 模板中引导用户查看 Roadmap
189+
190+
---
191+
192+
## 📚 参考资源
193+
194+
| 资源 | 链接 |
195+
|------|------|
196+
| CNCF Roadmap Best Practices | https://contribute.cncf.io/projects/best-practices/community/contributor-growth/open-source-roadmaps/ |
197+
| GitHub Public Roadmap | https://github.com/github/roadmap |
198+
| GitHub Projects Docs | https://docs.github.com/en/issues/planning-and-tracking-with-projects |
199+
| Ducalis Public Roadmap Guide | https://hi.ducalis.io/glossary/public-roadmap-best-practices-examples-and-templates |
200+
201+
---
202+
203+
## ✅ 研究结论
204+
205+
1. **简单优于复杂** - 对于小型开源项目,Now/Next/Later 模式足够有效
206+
2. **双轨制最佳** - README 概览 + GitHub Projects 详情
207+
3. **维护是关键** - 不更新的 Roadmap 比没有 Roadmap 更糟糕
208+
4. **社区参与可选** - 先建立可见性,再逐步增加互动功能
209+
5. **与发布节奏对齐** - Roadmap 更新应与版本发布同步
210+
211+
---
212+
213+
*报告生成时间: 2026-02-05*
214+
*研究方法: Web Research + 案例分析*
215+

0 commit comments

Comments
 (0)