first build nexus

openclaw/xingjiang/oh-my-openagent.md

@@ -0,0 +1,74 @@
+# oh-my-openagent (omo) 研究笔记
+
+> 来源: https://github.com/code-yeongyu/oh-my-openagent
+> 记录时间: 2026-03-20
+
+## 核心理念
+
+- **不绑定单一模型**: Claude / Kimi / GLM 用于编排，GPT 用于推理，Minimax 用于速度，Gemini 用于创意
+- **模型只会越来越便宜越来越聪明**: 为开放的模型市场而构建
+
+## 核心特性
+
+| 特性 | 功能 |
+|------|------|
+| 🤖 Discipline Agents | Sisyphus 指挥 Hephaestus, Oracle, Librarian, Explore 并行工作 |
+| ⚡ ultrawork / ulw | 一句话激活所有 agent，持续执行直到完成 |
+| 🚪 IntentGate | 分析真实用户意图再分类/行动 |
+| 🔗 Hash-Anchored Edit | LINE#ID + 内容哈希，零 stale-line 错误 |
+| 🛠️ **LSP + AST-Grep** | 工作区重命名、预构建诊断、AST 感知重写 |
+| 🧠 Background Agents | 并行运行 5+ 专家 |
+| 📚 Built-in MCPs | Exa (web search), Context7 (docs), Grep.app |
+| 🔁 Ralph Loop | 自循环直到 100% 完成 |
+| ✅ Todo Enforcer | 强制任务完成 |
+| 💬 Comment Checker | 检查注释质量 |
+
+## LSP 集成详情
+
+- **lsp_rename**: 工作区重命名
+- **lsp_goto_definition**: 跳转到定义
+- **lsp_find_references**: 查找引用
+- **lsp_diagnostics**: 诊断
+- **AST-Grep**: 25 种语言的模式感知代码搜索和重写
+
+## Agents 架构
+
+| Agent | 模型 | 职责 |
+|-------|------|------|
+| **Sisyphus** | opus-4-6 / kimi-k2.5 / glm-5 | 主 orchestrator，规划、委托、驱动任务完成 |
+| **Hephaestus** | gpt-5.3-codex | 自主深度工作者，探索代码库、研究模式、端到端执行 |
+| **Prometheus** | opus-4-6 / kimi-k2.5 / glm-5 | 战略规划者，面试模式提问、识别范围、构建计划 |
+| **Oracle** | - | 架构/调试专家 |
+| **Librarian** | - | 文档/代码搜索 |
+| **Explore** | - | 快速代码库 grep |
+
+## Agent 类别路由
+
+- `visual-engineering` → 前端/UI/UX
+- `deep` → 自主研究+执行
+- `quick` → 单文件修改
+- `ultrabrain` → 困难逻辑/架构决策
+
+## ultrawork 命令
+
+```bash
+opencode run --agent sisyphus "ulw 实现 JWT 认证并添加测试"
+```
+
+或交互模式:
+```bash
+opencode --agent sisyphus
+# 里面用 @plan 规划，/start-work 执行
+```
+
+## 安装验证
+
+```bash
+cat ~/.config/opencode/opencode.json | grep "oh-my-opencode"
+```
+
+## 相关链接
+
+- GitHub: https://github.com/code-yeongyu/oh-my-openagent
+- Discord: https://discord.gg/PUwSMR9XNk
+- Sisyphus Labs: https://sisyphuslabs.ai

openclaw/xingjiang/projects/smart-trip-quote/docs/TEST_PLAN.md

@@ -0,0 +1,140 @@
+# Smart Trip Quote Web 端测试计划
+
+## 测试目标
+验证 Web 端功能，包括用户登录、需求创建、行程管理等核心流程。
+
+---
+
+## 一、测试环境
+
+| 项目 | 值 |
+|------|-----|
+| Web 地址 | http://192.168.3.189:8000 |
+| Nginx 地址 | http://192.168.3.189:7777 |
+| Admin 用户 | admin / admin123 |
+| 数据库 | MariaDB (stq_db) |
+
+---
+
+## 二、测试用例
+
+### 2.1 用户登录测试
+
+| 用例ID | 测试项 | 预期结果 |
+|--------|--------|----------|
+| TC001 | 访问 Admin 登录页 | 页面正常显示样式 |
+| TC002 | 使用正确凭据登录 | 登录成功，进入管理后台 |
+| TC003 | 使用错误密码登录 | 提示用户名或密码错误 |
+| TC004 | CSRF 防护验证 | 登录表单包含 csrf token |
+
+### 2.2 旅行需求 (Requirement) 测试
+
+| 用例ID | 测试项 | 预期结果 |
+|--------|--------|----------|
+| TC010 | 创建新需求 | 需求成功创建，返回需求ID |
+| TC011 | 查看需求列表 | 显示所有需求记录 |
+| TC012 | 查看需求详情 | 显示需求的完整信息 |
+| TC013 | 更新需求状态 | 状态成功更新 |
+
+### 2.3 行程 (Itinerary) 测试
+
+| 用例ID | 测试项 | 预期结果 |
+|--------|--------|----------|
+| TC020 | 创建行程 | 行程成功创建 |
+| TC021 | 行程关联目的地 | 目的地正确关联 |
+| TC022 | 查看行程列表 | 显示所有行程 |
+
+### 2.4 API 接口测试
+
+| 用例ID | 接口 | 方法 | 预期结果 |
+|--------|------|------|----------|
+| TC030 | /api/requirements/ | GET | 返回需求列表 |
+| TC031 | /api/requirements/ | POST | 创建新需求 |
+| TC032 | /api/itineraries/ | GET | 返回行程列表 |
+| TC033 | /api/webhook/requirement/ | POST | 处理 webhook 请求 |
+
+### 2.5 Webhook 端点测试
+
+| 用例ID | 测试项 | 预期结果 |
+|--------|--------|----------|
+| TC040 | n8n 触发需求创建 | 需求成功创建 |
+| TC041 | n8n 触发行程优化 | 行程优化完成 |
+
+---
+
+## 三、测试数据准备
+
+### 3.1 现有测试数据
+- 需求: 3 条 (REQ_2026_001/002/003)
+- 行程: 3 条 (ITN_2026_001/002/003)
+- 目的地: 9 条
+
+### 3.2 创建测试数据 (Django Shell)
+```python
+# 创建测试用户
+python manage.py shell -c "
+from django.contrib.auth.models import User
+User.objects.create_user('test', 'test@test.com', 'test123')
+"
+
+# 创建测试需求
+python manage.py shell -c "
+from apps.models import Requirement
+from django.contrib.auth.models import User
+user = User.objects.first()
+Requirement.objects.create(
+    requirement_id='TEST_001',
+    origin_input='测试需求',
+    group_total=2,
+    destination_cities='上海;杭州',
+    travel_start_date='2026-04-01',
+    travel_end_date='2026-04-05',
+    created_by=user
+)
+"
+```
+
+---
+
+## 四、测试执行方式
+
+### 4.1 手动测试
+1. 打开浏览器访问 http://192.168.3.189:7777/admin/
+2. 使用 admin/admin123 登录
+3. 按测试用例逐项验证
+
+### 4.2 自动化测试 (Django Test)
+```bash
+# 运行所有测试
+docker compose exec web python manage.py test
+
+# 运行特定测试
+docker compose exec web python manage.py test tests.test_webhook_refactor -v 2
+```
+
+### 4.3 API 测试 (curl)
+```bash
+# 登录获取 CSRF token
+curl -c cookies.txt http://192.168.3.189:8000/admin/login/
+curl -b cookies.txt -X POST http://192.168.3.189:8000/admin/login/ \
+  -d "username=admin&password=admin123&csrfmiddlewaretoken=xxx"
+
+# 测试 API
+curl http://192.168.3.189:8000/api/requirements/
+```
+
+---
+
+## 五、缺陷跟踪
+
+| 缺陷ID | 描述 | 状态 |
+|--------|------|------|
+| - | - | - |
+
+---
+
+## 六、注意事项
+
+1. **CSRF 问题**: 通过 Nginx 访问时需配置 CSRF_TRUSTED_ORIGINS
+2. **静态文件**: 确保 collectstatic 已执行
+3. **数据库**: 测试数据可在测试环境预先准备