Ideon路线图与社区：如何参与这个开源无限画布项目的开发

Ideon 是一个开源无限画布工具，让笔记、文件、待办事项、看板与代码仓库都集中在同一张空间画布上协作。这篇路线图与社区参与指南，将带你看清 Ideon 的演进方向，并手把手教你以最低门槛参与这个自托管可视化工作区的开发。

一、Ideon 现状：1.0 已经交付了什么？

Ideon 的定位是"用空间组织代替抽象文件夹"——靠近的内容意味着相关，整张画布就是一张项目地图。它基于 Next.js + React 构建，实时协作由 Yjs（CRDT）驱动，数据存储在 PostgreSQL 中，默认以 Docker Compose 一键自托管。

想判断一个项目值不值得投入，先读它的版本史。Ideon 的 CHANGELOG.md 遵循 Keep a Changelog 规范，是目前最可靠的"路线图回顾"：

可以看出 Ideon 的路线非常清晰：空间画布 → 实时多人协作 → 自动化行为块 → AI 可编程（MCP）→ 可审计的正式记录。社区贡献者正是沿着这些方向提 issue、提 PR 长大的。

二、社区参与：5 种方式，按门槛从低到高

官方在 CONTRIBUTING.md 中明确写道："Bug 报告、功能想法、文档改进和代码贡献，都很重要。"你不必会写代码也能帮上大忙。

1️⃣ 报告 Bug（零代码）

仓库内置了规范的 issue 模板：bug_report.md 要求写清"现象 + 复现步骤 + 期望行为"。一份可复现的 bug 报告对维护者价值极高——CHANGELOG 里大量修复（如 #133 的UntrustedHost登录失败）都源于社区报告。

2️⃣ 提交功能想法（零代码）

对应 feature_request.md。建议先搜索已有 issue，再说明使用场景，而不是只说"我想要 X"。

3️⃣ 翻译与文档（会一点前端即可）

Ideon 支持动态语言加载，目前已有 en.json、fr.json、it.json 三份字典。添加新语言只需：

1. 在 src/app/i18n/ 下新建 JSON 文件（如zh.json）
2. 根对象加__label键作为语言选择器显示名
3. 补齐所有翻译键（可复制en.json的结构）

应用会自动识别新语言，无需改动任何代码。这是新手最友好的第一个 PR。

4️⃣ 安全报告（谨慎渠道）

根据 SECURITY.md，安全漏洞不要公开提 issue，需通过官方仓库的 security advisories 私密渠道报告。Ideon 已有多名社区安全贡献者（见 README 的 Contributors 列表），安全能力是这里被重视的贡献方向。

5️⃣ 提交代码 PR（正式贡献）

PR 需遵循 PULL_REQUEST_TEMPLATE.md：描述变更、关联 issue、说明测试方式。所有 PR 必须通过 pre-commit 检查与 CI 流水线。

三、本地开发环境：最快的启动方法

Ideon 用Docker 标准化的开发环境保证各机器表现一致，前置要求只有 Docker（含 Docker Compose v2）和 Node.js。

一键安装步骤：

git clone https://gitcode.com/gh_mirrors/id/ideon cd ideon cp env.example .env # 编辑 .env：至少设置 SECRET_KEY（可用 openssl rand -hex 32 生成） npm install pre-commit install npm run dev

npm run dev实际执行的是 compose.sh 中的build + restart，即构建本地容器镜像并拉起应用与 PostgreSQL，最终在http://localhost:3000打开。注意：每次改完代码都要重跑npm run dev触发重建，这是它的性能优先策略。

提交前必须跑通这三道关卡：

pre-commit run --all-files # 格式与卫生检查（配置见 .pre-commit-config.yaml） npm run test # vitest 单元测试与集成测试 npm run check # ESLint + TypeScript 类型检查

四、新手友好任务：给项目加一个新块类型

"块（Block）"是 Ideon 的核心抽象——画布上的每个元素都是块。CONTRIBUTING.md 专门给出了完整的开发清单，因为它跨越数据库、图谱持久化、UI 注册三层，漏掉任何一层都会出现"本地能渲染但快照保存失败"的 bug：

1. 数据库：在 src/app/db/migrations/ 新增迁移，允许新的blockType
2. 类型与校验：更新 src/app/lib/types/db.ts 的blockType联合类型，并修改 src/app/lib/graph.ts 的图谱校验
3. UI 注册：在 blockTypeMeta.tsx 添加条目，并在所有i18n 字典中补充标签
4. 画布渲染：在 src/app/components/project/ 创建组件，注册到 ProjectCanvas.tsx 的blockTypes映射
5. 默认值：更新 useProjectCanvasGraph.ts 中的尺寸与初始元数据
6. 全链路验证：创建 → 快照 → 刷新仍在；导出 → 重新导入往返一致；再跑npm run check、npm run test、npm run validate:i18n

现有块组件（KanbanBlock、CalendarBlock、MermaidBlock 等）都是极好的参照实现。

五、路线图观察渠道与社区约定

• 版本路线：关注 CHANGELOG.md 的语义化版本记录，以及 1.0 发布说明中"任何状态可被任何人独立验证"的设计目标
• 问题池：官方 issue 列表是需求优先级的事实路线图，修复记录会反向标注 issue 编号
• 行为准则：参与社区前请阅读 CODE_OF_CONDUCT.md，保持友好、对事不对人
• 许可条款：项目采用 AGPLv3。提交代码即表示同意你的贡献以 AGPLv3 许可发布；公开部署并修改 Ideon 时，需共享你的改动
• AI 工作流：Ideon 自带 MCP 技能文档 skills/ideon-canvas/SKILL.md，服务端实现位于 src/lib/mcp/server.ts，想参与 AI 集成方向的开发可直接从这里切入

六、总结：参与路线速查

从跑通npm run dev开始，按 CONTRIBUTING 清单走完整流程——这就是参与 Ideon 这个开源无限画布项目开发的完整路径。祝你在画布上画出的第一笔，成为社区的一部分。