如何5分钟上手EverRoom从安装到第一个Context Room的完整教程【免费下载链接】EverRoomEverRoom - A workspace that remembers your projects, decisions, and sources.项目地址: https://gitcode.com/gh_mirrors/ev/EverRoomEverRoom 是一个本地优先的个人上下文工作空间把文件、对话、记忆和 AI Agent 放回同一个工作现场。这篇 EverRoom 上手教程带你走完最短路径安装启动桌面应用 → 验证本地 Gateway → 创建你的第一个 Context Room全程不超过 5 分钟。什么是 EverRoom用一句话概括EverRoom 下一代 Notion / Obsidian 带上下文的 AI Agent 工作台。它位于你的个人数据和 AI 之间把信息变成可追溯证据沉淀为记忆再组织进Context Room你可以为项目、主题、人物或长期职责各建一个 Room把文档、决策、任务、Wiki 和记忆放在一起Agent 只会拿到当前 Room 的上下文来干活而不是一份失控的全量提示词核心理念见 README.zh-CN.md 中的「产品主张」上下文应当由证据组装、限定在工作空间内并清晰到足以由人来治理。准备工作环境要求清单打开终端前先核对这份 EverRoom 安装要求清单来源README.zh-CN.md 快速开始依赖项版本要求操作系统macOS当前主要开发目标Node.js22 或更高版本pnpm11.15.1 或兼容的 pnpm 11 版本 提示仓库通过 package.json 中的packageManager字段锁定了 pnpm 版本开启 corepack 后版本会自动对齐避免我这边能跑的玄学问题。一键安装从克隆到启动的 4 个命令核心安装步骤只有 4 行命令这是 EverRoom 最快的启动方式git clone https://gitcode.com/gh_mirrors/ev/EverRoom.git cd EverRoom pnpm install pnpm devpnpm dev会同时做两件事启动 Electron 桌面端和 React 渲染层以 watch 模式拉起独立的 NxCore GatewayFastify 本地服务修改 Gateway 代码后会自动重启项目采用 pnpm workspace 多包结构目录划分见 pnpm-workspace.yamlEverroom/ ├── apps/ │ ├── desktop/ # Electron 桌面端界面在这里 │ └── gateway/ # 独立本地后端服务数据与 Agent 在这里 ├── packages/ # Agent 契约、文档模型等共享包 └── docs/ # 产品与架构文档验证启动成功3 个检查点应用打开后按顺序确认以下 3 点说明 EverRoom 已正确运行侧栏状态侧栏左下角显示 Gateway 当前状态与进程 PID主界面能看到首页、Context Room、文档、记忆、数据源、文件、日记和 Agent Office 等入口无需 API Key默认使用隔离的fakeAgent runtime没有模型密钥也能完整浏览工作空间本地数据默认存放在 macOS 的~/Library/Application Support/NxCore/下Windows 为%APPDATA%\EverRoom\包含database/、logs/、objects/等目录所有数据都留在你自己的设备上。创建你的第一个 Context Room启动后EverRoom 会引导你创建第一个 Room这是整个工作空间的核心动作进入 Rooms 视图首次启动会直接触发 RoomOnboardingGate.tsx 引导页打开 RoomCreationStudio.tsx 对应的创建界面填写 Room 名称选择 Room 类型支持 6 种 项目、 主题、 人物、 长期目标、 议题、 事件创建完成后系统会自动生成一份「使用指南」文档这份自动生成的指南文档由 roomUsageGuide.ts 驱动会帮你梳理这个 Room 的定位、工作流和后续用法跟着它走即可。创建好之后你就可以把本地文件、会议纪要、代码仓库关联到 Room在 Context Doc 中写作修改会保留版本并可回溯来源在 Room 范围内启动 Agent 会话让它基于真实上下文推进工作可选进阶接入真实 AI 模型默认fakeruntime 适合先熟悉界面。想调用真实模型时在仓库根目录.env中添加NXCORE_AGENT_RUNTIMEpi NXCORE_AI_PROVIDERopenai NXCORE_AI_MODELgpt-5.2 NXCORE_AI_BASE_URLhttps://api.openai.com/v1 NXCORE_AI_API_KEY你的密钥 NXCORE_AI_APIopenai-responses密钥只保存在 Gateway 环境中不会暴露给渲染层也兼容任何 OpenAI 风格的第三方服务。常用命令速查pnpm dev # 启动桌面端与 Gateway日常使用 pnpm typecheck # 类型检查 pnpm test # 运行测试 pnpm build # 构建 Gateway 与 Electron pnpm package:mac # 打包 macOS DMG 与 ZIP常见问题 FAQQ1没有 API Key 能用吗能。默认fakeruntime 下应用可完整启动本地文档、Room、文件管理均可用。Q2Gateway 端口冲突怎么办端口默认动态分配以避免多实例冲突需要固定端口时设置NXCORE_GATEWAY_DEV_PORT4100。Q3可选服务Memory/Knowledge没启动会报错吗不会。EverRoom 遵循优雅降级原则可选服务不可用时界面会显示明确的降级状态其余功能照常使用。下一步恭喜你已经完成 EverRoom 安装并创建了第一个 Context Room建议按这个顺序继续探索把 2~3 个真实文件导入 Room观察证据与 Wiki 的沉淀配置真实模型在 Room 内发起一次 Agent 会话阅读 docs/ 目录下的架构设计文档深入了解 Agent 框架与连接器机制更多细节请查阅 README.zh-CN.md 与 apps/gateway/README.md。EverRoom 采用 Apache License 2.0 开源欢迎参与贡献。【免费下载链接】EverRoomEverRoom - A workspace that remembers your projects, decisions, and sources.项目地址: https://gitcode.com/gh_mirrors/ev/EverRoom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何5分钟上手EverRoom：从安装到第一个Context Room的完整教程
如何5分钟上手EverRoom从安装到第一个Context Room的完整教程【免费下载链接】EverRoomEverRoom - A workspace that remembers your projects, decisions, and sources.项目地址: https://gitcode.com/gh_mirrors/ev/EverRoomEverRoom 是一个本地优先的个人上下文工作空间把文件、对话、记忆和 AI Agent 放回同一个工作现场。这篇 EverRoom 上手教程带你走完最短路径安装启动桌面应用 → 验证本地 Gateway → 创建你的第一个 Context Room全程不超过 5 分钟。什么是 EverRoom用一句话概括EverRoom 下一代 Notion / Obsidian 带上下文的 AI Agent 工作台。它位于你的个人数据和 AI 之间把信息变成可追溯证据沉淀为记忆再组织进Context Room你可以为项目、主题、人物或长期职责各建一个 Room把文档、决策、任务、Wiki 和记忆放在一起Agent 只会拿到当前 Room 的上下文来干活而不是一份失控的全量提示词核心理念见 README.zh-CN.md 中的「产品主张」上下文应当由证据组装、限定在工作空间内并清晰到足以由人来治理。准备工作环境要求清单打开终端前先核对这份 EverRoom 安装要求清单来源README.zh-CN.md 快速开始依赖项版本要求操作系统macOS当前主要开发目标Node.js22 或更高版本pnpm11.15.1 或兼容的 pnpm 11 版本 提示仓库通过 package.json 中的packageManager字段锁定了 pnpm 版本开启 corepack 后版本会自动对齐避免我这边能跑的玄学问题。一键安装从克隆到启动的 4 个命令核心安装步骤只有 4 行命令这是 EverRoom 最快的启动方式git clone https://gitcode.com/gh_mirrors/ev/EverRoom.git cd EverRoom pnpm install pnpm devpnpm dev会同时做两件事启动 Electron 桌面端和 React 渲染层以 watch 模式拉起独立的 NxCore GatewayFastify 本地服务修改 Gateway 代码后会自动重启项目采用 pnpm workspace 多包结构目录划分见 pnpm-workspace.yamlEverroom/ ├── apps/ │ ├── desktop/ # Electron 桌面端界面在这里 │ └── gateway/ # 独立本地后端服务数据与 Agent 在这里 ├── packages/ # Agent 契约、文档模型等共享包 └── docs/ # 产品与架构文档验证启动成功3 个检查点应用打开后按顺序确认以下 3 点说明 EverRoom 已正确运行侧栏状态侧栏左下角显示 Gateway 当前状态与进程 PID主界面能看到首页、Context Room、文档、记忆、数据源、文件、日记和 Agent Office 等入口无需 API Key默认使用隔离的fakeAgent runtime没有模型密钥也能完整浏览工作空间本地数据默认存放在 macOS 的~/Library/Application Support/NxCore/下Windows 为%APPDATA%\EverRoom\包含database/、logs/、objects/等目录所有数据都留在你自己的设备上。创建你的第一个 Context Room启动后EverRoom 会引导你创建第一个 Room这是整个工作空间的核心动作进入 Rooms 视图首次启动会直接触发 RoomOnboardingGate.tsx 引导页打开 RoomCreationStudio.tsx 对应的创建界面填写 Room 名称选择 Room 类型支持 6 种 项目、 主题、 人物、 长期目标、 议题、 事件创建完成后系统会自动生成一份「使用指南」文档这份自动生成的指南文档由 roomUsageGuide.ts 驱动会帮你梳理这个 Room 的定位、工作流和后续用法跟着它走即可。创建好之后你就可以把本地文件、会议纪要、代码仓库关联到 Room在 Context Doc 中写作修改会保留版本并可回溯来源在 Room 范围内启动 Agent 会话让它基于真实上下文推进工作可选进阶接入真实 AI 模型默认fakeruntime 适合先熟悉界面。想调用真实模型时在仓库根目录.env中添加NXCORE_AGENT_RUNTIMEpi NXCORE_AI_PROVIDERopenai NXCORE_AI_MODELgpt-5.2 NXCORE_AI_BASE_URLhttps://api.openai.com/v1 NXCORE_AI_API_KEY你的密钥 NXCORE_AI_APIopenai-responses密钥只保存在 Gateway 环境中不会暴露给渲染层也兼容任何 OpenAI 风格的第三方服务。常用命令速查pnpm dev # 启动桌面端与 Gateway日常使用 pnpm typecheck # 类型检查 pnpm test # 运行测试 pnpm build # 构建 Gateway 与 Electron pnpm package:mac # 打包 macOS DMG 与 ZIP常见问题 FAQQ1没有 API Key 能用吗能。默认fakeruntime 下应用可完整启动本地文档、Room、文件管理均可用。Q2Gateway 端口冲突怎么办端口默认动态分配以避免多实例冲突需要固定端口时设置NXCORE_GATEWAY_DEV_PORT4100。Q3可选服务Memory/Knowledge没启动会报错吗不会。EverRoom 遵循优雅降级原则可选服务不可用时界面会显示明确的降级状态其余功能照常使用。下一步恭喜你已经完成 EverRoom 安装并创建了第一个 Context Room建议按这个顺序继续探索把 2~3 个真实文件导入 Room观察证据与 Wiki 的沉淀配置真实模型在 Room 内发起一次 Agent 会话阅读 docs/ 目录下的架构设计文档深入了解 Agent 框架与连接器机制更多细节请查阅 README.zh-CN.md 与 apps/gateway/README.md。EverRoom 采用 Apache License 2.0 开源欢迎参与贡献。【免费下载链接】EverRoomEverRoom - A workspace that remembers your projects, decisions, and sources.项目地址: https://gitcode.com/gh_mirrors/ev/EverRoom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考