Skip to content

zth9/wudao

Repository files navigation

悟道(Wudao)

个人 AI 工作站,用来把多种 AI 工具串成可执行、可追踪、可沉淀的任务闭环。

当前主线已经收敛为任务中心:

  • 自然语言建任务
  • Agentic Chat 澄清与规划
  • 生成 AGENTS.md
  • 在任务 workspace 内启动和恢复本地 CLI 终端
  • 回看产物、会话与状态

当前能力

  • 任务闭环:从任务解析、规划对话到 AGENTS.md 产物生成与终端执行都落在同一个任务里
  • 任务工作台:任务详情页为统一工作台,左侧是 Agentic Chat,右侧是多终端与产物抽屉
  • 产物单一事实源AGENTS.md 是主产物,workspace 内同时维护 CLAUDE.mdGEMINI.md 两个兼容软链
  • 多 Provider 统一接入:统一管理 Claude、Kimi、GLM、MiniMax、Qwen、OpenAI、Gemini 等模型配置
  • 记忆系统:支持用户记忆与 Wudao Agent 全局记忆的本地维护、编辑与任务注入
  • 运行态可观测:Dashboard 聚合任务统计与 Provider 用量,任务聊天已支持结构化 Agent timeline

系统架构

flowchart TD
    A[Browser / React 19 / Vite] -->|HTTP + SSE + WebSocket| B[FastAPI Backend / Python]
    B --> C[SQLite\n~/.wudao/wudao.db]
    B --> D[Task Workspace\n~/.wudao/workspace/<taskId>]
    B --> E[Python PTY Terminal Runtime]
    E --> G[Claude / Codex / Gemini / 其他 CLI]
Loading

技术栈

  • Monorepo:pnpm workspace
  • 前端:Vite + React 19 + TypeScript + Tailwind CSS + zustand + xterm.js
  • 后端:FastAPI + sqlite3 + Python PTY + httpx
  • 测试:前端 Vitest;后端 pytest + FastAPI TestClient
  • 运行时:Node.js 22+、Python 3.12+,Python 依赖与命令默认通过 uv 驱动

快速开始

pnpm install
pnpm dev
  • pnpm install 现在会在缺少系统 uv 时,自动把项目本地 uv 安装到 workspace/tools/uv
  • 安装流程随后会自动同步 packages/server 的 Python 虚拟环境
  • uv 缓存会默认写到仓库内的 workspace/uv-cache,避免把临时文件散落到全局目录

常用验证命令:

pnpm test
pnpm --filter web build
  • 前端:http://localhost:5173
  • 后端:http://localhost:3000

目录结构

wudao/
├── AGENTS.md
├── README.md
├── docs/
│   ├── design/
│   └── changelog.md
├── packages/
│   ├── web/          # React 前端
│   └── server/       # FastAPI 后端
├── scripts/
│   ├── dev.sh                 # 前后端联合开发入口
│   ├── ensure-uv.sh           # 安装前确保 uv 可用,必要时 bootstrap 本地 uv
│   ├── uv.sh                  # 统一解析系统 uv / 项目本地 uv
│   └── sync-server-python.sh  # install 后同步 server Python 环境
├── status.md
└── workspace/        # 仓库内临时文件目录

关键文档

About

个人 AI 工作站,用来把多种 AI 工具串成可执行、可追踪、可沉淀的任务闭环。wudao 调用 claude code、codex 这些强大的 code agent,并且有自己的 task 管理工具,一个记忆系统,还有一个在 AI 时代持续进化的强大愿景。

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors