chore: 更新项目文档和工具状态
- 更新 AGENTS.md 项目知识库文档（多目录） - 添加 docs/analyst.md 产品分析文档 - 添加 .omc/ 工具状态和会话记录 - 添加 .sisyphus/ 计划文档 - 添加 project-structure.txt 项目结构 - 删除 timeline 测试截图
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
# docs/ - Project Documentation
|
||||
|
||||
<!-- Parent: ../AGENTS.md -->
|
||||
|
||||
## OVERVIEW
|
||||
|
||||
Technical documentation, design plans, and implementation guides for the agent_park project.
|
||||
|
||||
## STRUCTURE
|
||||
|
||||
```
|
||||
docs/
|
||||
├── api-reference.md # API endpoint documentation
|
||||
├── api-testing-guide.md # API testing instructions
|
||||
├── discovery-workflow.md # Project discovery system docs
|
||||
├── e2e-testing-guide.md # Playwright E2E guide
|
||||
├── verification-report.md # Feature verification reports
|
||||
├── analyst.md # Product analysis notes
|
||||
├── n8n/ # n8n workflow documentation
|
||||
│ ├── historical-workflow-design.md
|
||||
│ ├── incremental-workflow-design.md
|
||||
│ └── tag-janitor-workflow.md
|
||||
└── plans/ # Design & implementation plans
|
||||
├── 2026-01-25-ai-search-system-design.md
|
||||
├── 2026-01-25-ai-search-implementation.md
|
||||
├── 2025-01-25-ai-timeline-feature-design.md
|
||||
├── 2025-01-25-ai-timeline-implementation.md
|
||||
├── 2026-01-25-keyword-cloud-system-design.md
|
||||
└── 2026-01-25-keyword-cloud-implementation.md
|
||||
```
|
||||
|
||||
## KEY DOCUMENTS
|
||||
|
||||
| Document | Purpose |
|
||||
|----------|---------|
|
||||
| `api-reference.md` | Complete API documentation |
|
||||
| `discovery-workflow.md` | Project discovery architecture |
|
||||
| `plans/*.md` | Feature design & implementation specs |
|
||||
| `n8n/*.md` | n8n workflow design docs |
|
||||
|
||||
## FOR AI AGENTS
|
||||
|
||||
### When Adding Documentation
|
||||
|
||||
1. Place design docs in `plans/` with date prefix
|
||||
2. Update this AGENTS.md with new file entries
|
||||
3. Follow existing markdown formatting
|
||||
|
||||
### Related Files
|
||||
|
||||
- `CLAUDE.md` - Main project context (root)
|
||||
- `AGENTS.md` - Project knowledge base (root)
|
||||
- `.claude/` - Custom agents & commands
|
||||
|
||||
<!-- MANUAL: Additional notes can be added below -->
|
||||
+158
@@ -0,0 +1,158 @@
|
||||
---
|
||||
|
||||
## 🎯 现状问题诊断
|
||||
|
||||
### 1. 信息架构问题
|
||||
- **标签体系混乱**：有的项目标了"本地部署/macOS/iOS/Android"（4个标签），有的只有"✨"，标准不统一
|
||||
- **缺乏分类维度**：用户无法快速筛选"开源/闭源"、"可商用/个人项目"、"多智能体/单智能体"
|
||||
- **没有时间维度**：看不出项目是新发布还是经典项目，对 Agent 这个快速迭代的领域很关键
|
||||
|
||||
### 2. 用户体验断层
|
||||
- **卡片信息过载/不足并存**：描述长短不一，但缺少关键决策信息（GitHub stars？是否开源？演示链接？）
|
||||
- **无快速筛选**：当项目超过20个时，浏览成本会指数级上升
|
||||
- **缺乏"为什么值得关注"**：单纯罗列不如策展（Curation），需要策展人视角的推荐理由
|
||||
|
||||
### 3. 技术呈现问题
|
||||
- **移动端适配**：从代码结构看是响应式，但卡片在手机上可能过于拥挤
|
||||
- **无暗色模式**：开发者群体对暗色模式有强需求，实现成本低（CSS media query）
|
||||
- **加载性能**：如果 n8n 工作流生成的是静态 Markdown，建议预渲染为 HTML 提升首屏速度
|
||||
|
||||
---
|
||||
|
||||
## 💡 轻量级但高价值的功能设计
|
||||
|
||||
基于"不做重，但要做巧"的原则，推荐以下功能：
|
||||
|
||||
### 阶段一：核心体验完善（2周内）
|
||||
|
||||
**1. 极简标签系统（三层维度）**
|
||||
```
|
||||
类型标签：🤖 Chatbot | 🔄 Multi-Agent | 🧠 Memory | 👁️ Vision | 🛠️ Tool Use
|
||||
形态标签：📦 开源 | ☁️ SaaS | 💻 本地部署 | 📱 App
|
||||
热度标签：🔥 Trending | ⭐ Classic | 🆕 New
|
||||
```
|
||||
*实现：纯 CSS 过滤，无需后端，前端 JS 筛选即可*
|
||||
|
||||
**2. "30秒决策"信息卡片**
|
||||
每个项目卡片补充3个关键字段（n8n工作流抓取时补充）：
|
||||
- **GitHub Stars**（如果是开源）
|
||||
- **体验方式**：Live Demo / 下载 / 仅代码
|
||||
- **适用场景**：一句话场景（如"适合搭建个人知识库"）
|
||||
|
||||
**3. 每日/每周精选（Newsletter 化）**
|
||||
不增加功能，而是**内容运营策略**：
|
||||
- 首页顶部固定"本周编辑推荐"（3个项目+一句话推荐理由）
|
||||
- 底部增加邮件订阅框（用 Buttondown 或 Revue，零成本）
|
||||
- 归档页面按周聚合（`/week-04-2025`）
|
||||
|
||||
### 阶段二：社区感与互动（1个月内）
|
||||
|
||||
**4. "使用报告"轻互动**
|
||||
不同于评论系统（太重），采用**投票+标签**：
|
||||
- "你在用吗？" 👍 / 👎（匿名）
|
||||
- "适用场景"多选标签（用户可添加，类似 StackOverflow 的标签系统）
|
||||
- 数据存储：Airtable 或 Notion API（轻量级数据库）
|
||||
|
||||
**5. Agent 项目 Twitter 趋势墙**
|
||||
无需自己生成内容，聚合展示：
|
||||
- 嵌入 Twitter List（创建一个"Agent Builders"列表）
|
||||
- 或展示特定 hashtag（如 `#AIAgent`）的最新热门推文
|
||||
- 实现：Twitter 嵌入式时间线，零维护成本
|
||||
|
||||
**6. 极简提交表单优化**
|
||||
当前"立即提交"大概率跳转到表单，优化为：
|
||||
- 预填项目模板（GitHub URL 自动抓取信息）
|
||||
- 支持提交者写"推荐语"（策展人视角）
|
||||
- 审核流：GitHub Issues 或 Airtable 表单（不用开发后台）
|
||||
|
||||
### 阶段三：开发者工具化（2个月内）
|
||||
|
||||
**7. Agent 项目 RSS 聚合**
|
||||
开发者刚需：一站式追踪所有 Agent 项目更新
|
||||
- 为每个项目生成 RSS 源监控（GitHub releases）
|
||||
- 提供聚合 RSS（用户订阅一个即可看全站更新）
|
||||
- 技术：RSSHub 或 n8n 自动生成
|
||||
|
||||
**8. "Agent 构建模式"分类**
|
||||
垂直领域细分（这是你的差异化）：
|
||||
- **ReAct 模式**项目集合
|
||||
- **Plan-and-Execute**项目
|
||||
- **Multi-Agent 协作框架**
|
||||
- **Function Calling 工具库**
|
||||
帮助开发者按技术方案选型，而非只看功能。
|
||||
|
||||
---
|
||||
|
||||
## 📋 分阶段实施计划（ Roadmap ）
|
||||
|
||||
### Week 1-2：基础优化
|
||||
- [ ] 统一标签体系（3层9个标签以内）
|
||||
- [ ] 修改项目卡片模板（增加 Stars/Demo 链接字段）
|
||||
- [ ] 增加暗色模式（`prefers-color-scheme` 媒体查询）
|
||||
- [ ] 优化移动端卡片布局（单列+横向滚动标签）
|
||||
|
||||
### Week 3-4：内容运营
|
||||
- [ ] 建立编辑推荐机制（每周手动精选3个）
|
||||
- [ ] 上线邮件订阅（嵌入 Buttondown）
|
||||
- [ ] 优化提交表单（GitHub URL 自动拉取）
|
||||
- [ ] 创建 Twitter/X 账号同步发布精选
|
||||
|
||||
### Month 2：互动功能
|
||||
- [ ] 增加轻量级投票系统（用 Upstash Redis 或 Airtable）
|
||||
- [ ] 上线 RSS 订阅功能
|
||||
- [ ] 增加"技术模式"分类维度
|
||||
- [ ] 发布首份《Agent Landscape 月报》（PDF 轻量报告）
|
||||
|
||||
### Month 3：生态扩展
|
||||
- [ ] 推出"Agent Builder 访谈"（轻量级文字访谈，每月2期）
|
||||
- [ ] 建立 Discord/Telegram 群组（社区沉淀）
|
||||
- [ ] 尝试"项目雷达"功能（预测下周可能火的项目）
|
||||
|
||||
---
|
||||
|
||||
## 💰 变现可能性分析（从轻到重）
|
||||
|
||||
基于"保持轻量"的前提，按可行性排序：
|
||||
|
||||
### 1. **策展付费（轻量，推荐优先尝试）**
|
||||
- **模式**：每周付费 Newsletter（$5/月或$50/年），提供更深度的项目分析、代码解读、创始人访谈
|
||||
- **可行性**：⭐⭐⭐⭐⭐ 你已经用 n8n 做内容聚合，增加深度分析即可，无需改技术架构
|
||||
- **受众**：Agent 开发者愿意为高质量信息付费，参考 Lenny's Newsletter（产品经理领域）
|
||||
|
||||
### 2. **精准职位板（轻量）**
|
||||
- **模式**："Agent 相关岗位"板块，公司付费发帖（$100/月）
|
||||
- **可行性**：⭐⭐⭐⭐ 当下 Agent 工程师需求旺盛，但供给分散，你的受众正是招聘方想要的
|
||||
- **优势**：比大型招聘站更精准，比 LinkedIn 更垂直
|
||||
|
||||
### 3. **开源项目赞助分成（超轻量）**
|
||||
- **模式**：项目卡片增加"赞助该项目"按钮，跳转 GitHub Sponsors，你收取 5-10% 导流费或获得 affiliate 返点
|
||||
- **可行性**：⭐⭐⭐ 需要与项目方谈合作，但初期可以作为增值服务免费提供，建立信任后变现
|
||||
|
||||
### 4. **轻量级广告/赞助（需谨慎）**
|
||||
- **模式**：接受 Agent 框架、云服务（如 LangSmith、Langfuse）的广告位
|
||||
- **可行性**：⭐⭐⭐ 需要流量基础（月UV 1万+），且要保持克制避免破坏体验
|
||||
- **建议**：以"赞助商推荐"形式融入内容，而非 banner 广告
|
||||
|
||||
### 5. **数据/洞察服务（未来方向）**
|
||||
- **模式**：出售 Agent 趋势数据报告（GitHub 增长趋势、技术栈迁移方向）
|
||||
- **可行性**：⭐⭐ 需要积累 6-12 个月数据，且需要品牌背书
|
||||
- **风险**：会变重，建议保持轻量，只出季度免费报告建立权威性
|
||||
|
||||
### ❌ 不建议的变现方式
|
||||
- **付费墙阻断访问**：违背导航站开放属性
|
||||
- **复杂的会员系统**：开发与维护成本高
|
||||
- **交易佣金**：涉及支付、合规，太重
|
||||
|
||||
---
|
||||
|
||||
## 🚀 立即可做的3个改动（本周）
|
||||
|
||||
如果你只想快速优化，先做这三件：
|
||||
|
||||
1. **标签标准化**：删除所有重复/冗长标签，只用 类型+形态 二维（如 `🤖Chatbot` `📦开源`）
|
||||
2. **增加"一键体验"按钮**：在卡片上直接放 🔗Demo 或 💻GitHub 图标，减少用户点击成本
|
||||
3. **顶部增加时间线**：小字标注"本周新增 X 个项目，共收录 Y 个"，营造更新感
|
||||
|
||||
**核心建议**：Agent Park 现在的定位应该是 **"Agent 爱好者的 Hacker News + Product Hunt 混合体"**，保持策展人（Curator）视角比做全量数据库更有价值。你的 n8n 工作流是护城河，但**人工精选的品味**才是核心竞争力。
|
||||
|
||||
需要我针对某个具体功能（比如 n8n 工作流优化方案、暗色模式 CSS、或者邮件订阅文案）展开详细方案吗？
|
||||
Reference in New Issue
Block a user