ResearchOS

ResearchOS 是一个把“问题”研究成“观点”的个人深度研究工作台。

当前实现为 R1 持久化研究核心的首个可用迭代：

登录 → 工作台 → 选题池 → 创建研究项目 → 问题定义

本地运行

1. 复制 .env.example 为 .env，并修改本地密码。
2. 启动 PostgreSQL 并初始化数据库：

npm install
npm run db:up
npm run db:deploy
npm run db:seed
npm run dev

打开 http://localhost:3000。

本地容器运行依赖 Podman 与 Podman Compose。若本机没有 Podman，也可以使用 npx prisma dev --name researchos --detach。该命令返回代理连接串时，应用侧 DATABASE_URL 需要追加 &pgbouncer=true，迁移使用的 DIRECT_DATABASE_URL 保持原连接串。

校验命令

npm run typecheck
npm test
npm run test:e2e
npm run build

当前工程结构

• src/app/：Next.js 页面和 API Route Handlers。
• src/app/(app)/：受会话保护的工作台、选题池和研究项目真实路由。
• src/server/modules/：按工作空间过滤的 Prisma 仓储。
• src/lib/domain.ts：研究领域类型和状态。
• src/server/auth/：数据库会话和当前工作空间边界。
• prisma/schema.prisma：PostgreSQL 核心对象模型。
• docs/20260812-researchos-prd.md：产品需求文档。
• docs/20260812-researchos-tech-design.md：技术方案文档。

下一阶段

按照技术方案继续实现：

1. 完整选题编辑、归档和恢复。
2. 假设与研究地图编辑能力。
3. 资料、证据与安全 URL 抓取。
4. AI Provider、研究助手和 Red Team。
5. 结论版本和 Markdown 文章生成。