Skip to content

Latest commit

 

History

History
174 lines (142 loc) · 8.38 KB

File metadata and controls

174 lines (142 loc) · 8.38 KB

EvoMap Wiki 文档建设计划

生成日期:2026-03-05 状态跟踪:✅ 已完成 | 🔧 进行中 | ⬜ 待开始

背景

EvoMap 前端平台拥有 27+ 个页面,涵盖市场、悬赏、问答、生物学仪表盘、知识图谱、沙盒、漂流瓶等功能,每个页面都有大量数据展示。目前文档站仅有 2 篇完整文档(首页数据、市场数据)和 4 篇空白占位,缺乏对功能的系统性解释。

本计划将文档站从"概念说明"升级为通用 Wiki 站点,覆盖平台入门、功能指南、核心概念和参考资料。


站点结构规划

evomap.github.io/
├── index.md                    # 首页(已有,需更新导航)
├── guide/                      # 🆕 功能指南
│   ├── index.md                # 快速开始 / 平台概览
│   ├── market.md               # 市场(资产 / 配方 / 服务)
│   ├── bounties.md             # 悬赏与问题系统
│   ├── ask.md                  # AI 智能问答
│   ├── biology.md              # 生物学仪表盘
│   ├── agents.md               # 智能体管理
│   ├── kg.md                   # 知识图谱
│   ├── sandbox.md              # 沙盒实验
│   ├── drift-bottle.md         # 漂流瓶
│   ├── read.md                 # 阅读管道
│   ├── pricing.md              # 定价与经济体系
│   ├── leaderboard.md          # 排行榜
│   ├── council.md              # 议事会
│   ├── blog.md                 # 博客
│   └── ai-chat.md              # AI 对话助手
├── concepts/                   # 核心概念(已有,需补全)
│   ├── index.md                # 概念概览(需更新)
│   ├── homepage-data.md        # ✅ 首页数据详解
│   ├── market-data.md          # ✅ 市场数据详解
│   ├── ecosystem.md            # ⬜ 生态系统
│   ├── evolution-mechanism.md  # ⬜ 进化机制
│   ├── agent-model.md          # ⬜ 智能体模型
│   └── data-pipeline.md        # ⬜ 数据流与管道
└── reference/                  # 🆕 参考资料
    └── glossary.md             # 术语表

导航结构

顶栏 链接 说明
首页 / 着陆页
功能指南 /guide/ 每个功能的用途、操作和数据说明
概念说明 /concepts/ 深度理论解析
参考 /reference/glossary 术语表

任务清单

Phase 0:基础设施

# 任务 状态 说明
0.1 创建 guide/reference/ 目录 新建文件夹
0.2 更新 .vitepress/config.ts 导航 添加"功能指南"和"参考"导航项
0.3 更新 .vitepress/sidebar/index.ts 添加 guide 和 reference 的 sidebar
0.4 更新首页 index.md 添加功能指南入口

Phase 1:功能指南(按页面优先级排序)

每篇文档统一结构:概述 → 页面入口 → 核心功能 → 数据展示说明 → 操作指引 → 常见问题

# 文档 覆盖页面 状态 数据指标数
1.1 guide/index.md 平台概览、注册流程
1.2 guide/market.md /market, /asset/[id], /market/recipe/[id], /market/service/[id] 15+
1.3 guide/bounties.md /bounties, /bounty/[id], /question/[id] 8+
1.4 guide/ask.md /ask 3+
1.5 guide/biology.md /biology 15+
1.6 guide/agents.md /account/agents, /agent/[id], /claim/[code], /onboarding/agent 10+
1.7 guide/kg.md /kg 4+
1.8 guide/sandbox.md /sandbox 6+
1.9 guide/drift-bottle.md /drift-bottle 4+
1.10 guide/read.md /read 5+
1.11 guide/pricing.md /pricing, /economics 4+
1.12 guide/leaderboard.md /leaderboard 5+
1.13 guide/council.md /council 6+
1.14 guide/blog.md /blog, /blog/[slug] 2+
1.15 guide/ai-chat.md AI 对话面板 4+

Phase 2:概念补全

# 文档 状态 核心内容
2.1 concepts/ecosystem.md 生态全景、核心组件(Hub/Agent/Capsule/Recipe/Service)、组件协作关系
2.2 concepts/evolution-mechanism.md 自进化定义、GDI 评审、进化流程、选择压力
2.3 concepts/agent-model.md 智能体定义、节点生命周期(注册→认领→创作→进化)、行为模式
2.4 concepts/data-pipeline.md 数据流全景、事件处理管道、Redis/PostgreSQL 存储架构

Phase 3:参考资料

# 文档 状态 核心内容
3.1 reference/glossary.md 全平台术语表(60+ 术语)

Phase 4:收尾

# 任务 状态
4.1 更新 concepts/index.md 导航
4.2 更新 documate.json 包含新文档

写作规范

参照已完成的 homepage-data.mdmarket-data.md 的风格:

  1. Front Matter:包含 titleaudienceversionlast_updated
  2. 快速参考表:文章开头用表格列出核心指标一览
  3. 公式/SQL:关键计算用代码块展示
  4. 解读提示:用生动比喻帮助非技术人员理解
  5. 常见问题:用 <details> 折叠式 FAQ
  6. 使用建议:按角色(运营/产品/用户)分别给出建议
  7. 术语对照表:中英文字段映射
  8. 数据来源:标注 API 接口和缓存策略

前端页面与文档映射(完整清单)

路由 页面名称 对应文档 核心数据展示
/ 首页 concepts/homepage-data.md 10 项指标
/market 市场 guide/market.md 资产/配方/服务三大 Tab + 统计
/asset/[id] 资产详情 guide/market.md GDI、调用量、投票、表观遗传
/market/recipe/[id] 配方详情 guide/market.md 价格、表达次数、成功率
/market/service/[id] 服务详情 guide/market.md 任务价格、评分、完成率
/bounties 悬赏大厅 guide/bounties.md 开放悬赏数、总金额
/bounty/[id] 悬赏详情 guide/bounties.md 金额、状态、提交、Swarm
/question/[id] 问题详情 guide/bounties.md 意图、信号、不确定性
/ask AI 问答 guide/ask.md 管道、循环、可靠性
/biology 生物学仪表盘 guide/biology.md 15+ 生态指标
/account 账户概览 guide/agents.md 积分、收益、Agent 数
/account/agents Agent 管理 guide/agents.md 节点、用量、未绑定节点
/agent/[id] Agent 档案 guide/agents.md 声誉、发布/上架/拒绝数
/claim/[code] 认领 Agent guide/agents.md 认领流程
/onboarding/agent Agent 入门 guide/agents.md GEP-A2A 协议
/kg 知识图谱 guide/kg.md 余额、查询数、积分消耗
/sandbox 沙盒 guide/sandbox.md 节点数、资产数、平均 GDI
/drift-bottle 漂流瓶 guide/drift-bottle.md 瓶子、故事、Agent 统计
/read 阅读管道 guide/read.md 摘要、问题、趋势
/pricing 定价 guide/pricing.md 套餐、余额、订阅
/economics 经济学 guide/pricing.md 佣金率、积分流转
/leaderboard 排行榜 guide/leaderboard.md 节点/资产/贡献者排名
/council 议事会 guide/council.md 任期、效率、项目
/blog 博客 guide/blog.md 文章列表
/status 状态 服务状态(简单页面,无需文档)
/terms 条款 法律文本(无需文档)
/careers 招聘 职位列表(简单页面)
/login 登录 guide/index.md 认证流程
/register 注册 guide/index.md 注册流程

预估工作量

阶段 文档数 预估字数
Phase 0 基础设施 配置文件
Phase 1 功能指南 15 篇 ~30,000 字
Phase 2 概念补全 4 篇 ~12,000 字
Phase 3 参考资料 1 篇 ~3,000 字
合计 20 篇 ~45,000 字