Skip to content

Repository files navigation

AetheL

AetheL Product Logo      KezhongKe Brand IP Logo

面向产品构思的 AI 认知工作区
AI Cognitive Workspace for Product Thinking

KezhongKe(壳中客) 提供技术支持


语言版本

项目概述

AetheL 是一款面向产品构思的 AI 认知工作区。它以“气泡”为思维载体,帮助产品经理、创业者、设计师和构建者捕捉早期想法,通过 AI 追问澄清目标、用户、场景、约束与风险,将逐渐浮现的逻辑压缩为认知快照,并把选定的思考线索生成结构化 PRD 草稿。

AetheL 关注的是产品创造过程中最混乱也最关键的阶段:想法还不稳定,材料不断变化,团队需要保存推理过程,而不只是保存最后的文档。

核心能力

  • 灵感气泡画布:用轻量气泡记录假设、用户场景、限制条件、风险、证据和开放问题。
  • AI 归类与关系检测:自动分析气泡关联,推荐标签,并识别相关、重复或矛盾的内容。
  • 认知快照系统:生成带有语义摘要、认知锚点、逻辑层级、追问和下一步行动的快照。
  • 创意工坊:把一句话想法、粗糙笔记、PRD 草稿和上传资料转换为结构化候选气泡。
  • PRD 输出中心:基于选中气泡束生成可编辑 PRD 章节,并支持 Markdown / PDF 导出。
  • 本地长期知识存储:气泡和快照保存为 Markdown 文件,画布布局和运行态保存为 JSON。
  • 多 AI 服务商配置:支持 ModelScope、DeepSeek、Moonshot;未设置 AI_PROVIDER 时,会按已配置 key 自动选择服务商。

产品工作流

粗糙想法 / PRD 草稿 / 外部资料
  -> 创意工坊 AI skill
  -> 候选气泡
  -> 灵感气泡画布整理、追问、归类、快照
  -> PRD 输出中心按标签或分类分束
  -> 可编辑章节草稿
  -> Markdown / PDF 导出

关键页面

  • 灵感气泡(/:主认知画布,用于捕捉、选择、编辑、删除、归类和扩展产品思考气泡。
  • 创意工坊(/workshop:输入变换层,用于把想法、文件和草稿转换为结构化产品气泡。
  • PRD 输出(/prd:文档输出层,用于基于选中气泡生成可编辑 PRD 章节。
  • 快照库(/context:语义记忆层,用于回看和恢复已保存的思考现场。
  • 设置中心(/settings:配置 AI 服务商、查看活动记录、管理存储、外观和系统级选项。

技术栈

  • 前端:React 18、TypeScript、Vite、Tailwind CSS、Zustand、Framer Motion。
  • 可视化:HTML5 Canvas API,用于高性能气泡画布。
  • 后端:Express,作为安全 AI 代理层和本地工作区文件 API。
  • AI 服务商:通过 OpenAI-compatible chat completion API 接入 ModelScope、DeepSeek、Moonshot。
  • 持久化data/bubblesdata/snapshots 保存 Markdown 文件,data/workspace.json 保存运行态工作区。

Quick Start

安装依赖

npm install

配置环境变量

在项目根目录创建 .env 文件:

MODELSCOPE_API_KEY=your_modelscope_key
DEEPSEEK_API_KEY=your_deepseek_key
MOONSHOT_API_KEY=your_moonshot_key

# 可选。省略时,AetheL 会按以下顺序选择第一个已配置 key:
# modelscope -> deepseek -> moonshot
AI_PROVIDER=modelscope

PORT=3000

启动开发服务

npm run dev

Open:

http://localhost:5173/

The Express API runs on http://localhost:3000/, and Vite proxies /api/* requests to it.

常用脚本

npm run check             # TypeScript 类型检查
npm run lint              # ESLint
npm run build             # 生产构建
npm run test:integration  # API 与集成测试
npm run test:ui           # UI 流程测试

本地数据结构

data/
├─ bubbles/       # 每个气泡一个 Markdown 文件
├─ snapshots/     # 语义快照 Markdown 文件
├─ .trash/        # 软删除的气泡和快照文件
└─ workspace.json # 画布布局、视口、分类、关系和运行态

data/ 下的文件属于本地运行态工作区数据,不应当作为源码 fixture 处理。

License

MIT License

About

An AI-powered cognitive workspace for product thinking, designed to preserve reasoning through the messy middle of product creation.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages