mirror of
https://github.com/getpaseo/paseo.git
synced 2026-11-11 19:05:16 +00:00
xxachangxx
a4878656e2
* 修复 Pi 恢复子任务的状态和对话跟踪
关联 #9200。
改动：
- 仅在 action:resume 确认成功启动新的 single async run 后登记独立子任务条目，按新 run ID 和 asyncDir 跟踪状态，拒绝失败及管理调用产生的假条目。
- 将对话去重从文件级调整为子任务条目与文件组合，支持恢复运行复用 session JSONL，避免旧通知结束新运行。
- 扩展原适配器回归测试，并附脱敏的命令输出、真实工具结果和 macOS Electron 截图，未改 UI、协议或共享生命周期。
实际验证：
- 原适配器下恢复条目回归为 RED；恢复旧文件级去重后共享对话回归为 RED。
- 基线 d46ee6558c 上 npm run build:server、npm run format、npm run typecheck、npm run lint、git diff --check 均成功。
- 在 packages/server 执行 npx vitest run src/server/agent/providers/pi/extensions/pi-subagents/index.test.ts --bail=1，21/21 通过。
- 已在此前 0.15.3 开发版中，通过真实 macOS Electron、Pi 1.5.0、pi-subagents 0.86.0 验证 A→B→C 恢复、运行条目和对话、完成状态、归档保留运行任务、失败恢复不产生假条目；普通启动走 CLI/API，恢复通过真实 composer。截图不是 0.15.4 发布包验收。
- 同步后适配器与测试文件字节和第三方锁定依赖均未变，复用独立代码评审与上述桌面证据。公开材料已做隐私扫描。
- 未执行全量测试（仓库禁止本地全量执行）、CI、其他平台或发布安装包验证；短暂重复 Shell 文案原因未定位，不宣称本次修复。
回滚：
- 本提交仍为 HEAD 时执行 git revert HEAD；否则先用 git log --oneline --grep='修复 Pi 恢复子任务的状态和对话跟踪' 确认本提交哈希，再 git revert <确认的哈希>，不要重置或覆盖其他修改。
- 回滚后重跑该适配器测试并执行 npm run build:server；若需要部署回滚产物，另行安排服务切换，禁止未经授权重启正在使用的 Paseo daemon。
- 本提交仅改源码、测试和 QA 证据，无数据迁移；回滚不应删除已有 Pi 会话或异步目录。独立 QA 服务不由本提交启停。
* 补强 Pi 恢复对话的新消息与实时回放断言
回应 PR #9261 的 Greptile P2 评论 discussion_r4521416122。
改动：
- 只修改 pi-subagents/index.test.ts，按子任务 ID 提取 assistant_message 文本，精确检查 C 的历史与本轮内容。
- 观察 C reader 初始读取后再追加消息，在写入终态前验证新消息实时到达且 C 仍运行，避免只靠完成时刷新通过。
- 回放精确校验三条预期消息、顺序与 resume-c 归属，保留旧通知隔离、完成状态和 bg_wait 断言。
- 不修改生产实现、历史 QA 证据或普通启动行为。
实际验证：
- 临时在测试观察回调中丢弃 C 本轮消息：定向测试 exit 1，只有 Attempt b 的历史不能通过初始断言。
- 临时只丢弃 C 后追加消息：定向测试 exit 1，缺少 Attempt c follow-up 的断言在写入完成状态前失败。
- 两次故障注入已移除；最终在 packages/server 执行 npx vitest run src/server/agent/providers/pi/extensions/pi-subagents/index.test.ts --bail=1，21/21 通过。
- npm run format、npm run typecheck、npm run lint 和 git diff --check 均通过；全仓 lint 为 0 warnings / 0 errors。
- LSP 推断项目模式仅报告未修改旧测试行的两处 results 类型警告；项目正式 typecheck 通过。
- 未运行全量测试、远端 CI 或重复桌面验收。本次只有测试变更，复用原产品评审和真实桌面验证，不将临时故障注入当作生产缺陷。
回滚：
- 本提交仍为 HEAD 时执行 git revert HEAD；否则用 git log --oneline --grep='补强 Pi 恢复对话的新消息与实时回放断言' 确认哈希后 git revert <该哈希>。
- 回滚后重跑上述适配器测试；这只撤销测试增强，不应回滚先前 #9200 产品修复，也无需重启 daemon 或删除任何会话数据。
Voice Assistant
A voice-controlled terminal assistant that runs as a single local service.
Quick Start
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env
# Edit .env and add your API keys (OpenAI, Deepgram)
# Run development servers
npm run dev
# Open browser to http://localhost:5173
Architecture
- Express Server (port 3000) - Serves API and built UI in production
- Vite Dev Server (port 5173) - Hot-reload React UI in development
- WebSocket (
/ws) - Real-time bidirectional communication - Agent - STT → LLM → TTS pipeline with terminal control
- Daemon - tmux-based terminal management (in-process)
Development
# Run both servers (recommended)
npm run dev
# Or run separately:
npm run dev:server # Express on port 3000
npm run dev:ui # Vite on port 5173
# Type checking
npm run typecheck
# Build for production
npm run build
# Start production server
npm start
Project Status
✅ Completed (Phases 1-2):
- Package setup and configuration
- Express server with WebSocket
- React UI with Vite
- WebSocket client with ping/pong testing
⏳ In Progress (Phase 3):
- Terminal control (tmux integration)
📋 Planned (Phases 4-9):
- LLM integration (OpenAI GPT-4)
- Agent orchestrator
- Speech-to-Text (Deepgram)
- Text-to-Speech (OpenAI)
- Audio streaming
- UI polish
See IMPLEMENTATION_PLAN.md for complete details.
Environment Variables
OPENAI_API_KEY=your-openai-key-here # GPT-4 and TTS
DEEPGRAM_API_KEY=your-deepgram-key-here # Streaming STT
STT_MODEL=whisper-1 # Optional: override to gpt-4o-transcribe, etc.
STT_CONFIDENCE_THRESHOLD=-3.0 # Optional: reject low-confidence clips
STT_DEBUG_AUDIO_DIR=.stt-debug # Optional: persist raw dictation audio for debugging
PASEO_HOME=~/.paseo # Runtime state directory (agents/, etc.)
PASEO_LISTEN=127.0.0.1:6767 # Listen address (host:port or /path/to/socket)
PASEO_HOME defaults to ~/.paseo and isolates runtime artifacts like agents/. PASEO_LISTEN controls the daemon listen address. For blue/green testing you can run a parallel server without touching production state:
PASEO_HOME=~/.paseo-blue PASEO_LISTEN=127.0.0.1:7777 npm run dev
Tech Stack
- Server: Express, TypeScript, ws (WebSocket)
- Client: React 18, Vite, TypeScript
- Terminal: tmux (via child_process)
- AI: OpenAI (LLM + TTS), Deepgram (STT)
Testing
Currently manual testing via:
- Start servers:
npm run dev - Open http://localhost:5173
- Test WebSocket connection (green status indicator)
- Click "Send Ping" button to test communication
More testing guidance as features are implemented.
License
MIT