stock-tool/PERDAS-GUIDE.md

🎯 PERDAS 增强版快速开始指南

欢迎使用 PERDAS 增强版开发模式！本指南帮助你快速上手。

📋 5 分钟快速启动

第一步：确认目录

cd /root/.openclaw/workspace/stock-tool
pwd
# 输出: /root/.openclaw/workspace/stock-tool

第二步：启动服务器

# 编译（首次或更新代码后）
go build -o stock-tool-simple main_simple.go

# 启动服务器
./stock-tool-simple &

预期输出：

🚀 服务器启动成功!
🌐 地址: http://localhost:8080

第三步：查看功能清单

cat feature_list.json

你会看到 6 个功能，5 个已完成：

{
  "summary": {
    "total": 6,
    "completed": 5,
    "in_progress": 1,
    "pending": 0
  }
}

第四步：查看进度

cat PROGRESS.md

第五步：开发新功能

当前进行中的功能：

• feat-006: 数据刷新功能

开发步骤：

1. 查看 feature_list.json 中 feat-006 的 steps
2. 访问 http://localhost:8080 测试
3. 手动测试功能
4. 更新 feature_list.json（修改 passes: true）
5. 提交代码

---

🔄 标准工作流程

每次会话开始时

# 1. 确认目录
pwd

# 2. 启动服务器（如果未运行）
./stock-tool-simple &

# 3. 查看进度
cat PROGRESS.md

# 4. 查看功能清单
cat feature_list.json

开发功能时

1. 阅读步骤

   jq '.features[] | select(.id=="feat-006")' feature_list.json
   

2. 实现功能

   • 修改代码
   • 测试功能
   • 验证效果

3. 更新状态

   # 修改 feature_list.json
   jq '.features[] | select(.id=="feat-006") | .passes = true' feature_list.json > tmp.json && mv tmp.json feature_list.json
   

4. 更新进度文件

   vim PROGRESS.md
   

5. 提交代码

   git add .
   git commit -m "feat: 完成 feat-006 数据刷新功能"
   git push
   

---

📚 重要文件说明

文件	用途	修改规则
feature_list.json	功能清单	仅修改 passes 字段
PROGRESS.md	进度跟踪	每会话更新
.gitignore	忽略规则	必要时更新
README.md	项目文档	必要时更新

---

⚠️ 强约束指令（必须遵守）

绝对禁止删除或修改测试用例

绝对禁止的行为：

• ❌ 删除或修改测试用例
• ❌ 删除或修改其他功能的代码
• ❌ 修改 feature_list.json 中除 passes 字段外的内容
• ❌ 未通过测试就标记完成
• ❌ 未保存截图就标记完成

正确的行为：

• ✅ 只修改当前要开发的功能
• ✅ 功能完成后测试验证
• ✅ 测试通过后更新状态
• ✅ 保存截图证据
• ✅ 更新 feature_list.json 的 passes 字段
• ✅ 更新 PROGRESS.md 记录本次工作
• ✅ 提交 Git commit

---

🐛 错误处理

服务器未运行

./stock-tool-simple &

查看服务器日志

# 服务器日志保存在 logs/server.log
cat logs/server.log

检查端口是否监听

netstat -tuln | grep 8080
# 或
ss -tuln | grep 8080

Git 冲突

git fetch origin
git rebase origin/main
git push

---

📖 相关文档

• 完整文档: README.md
• 进度跟踪: PROGRESS.md
• 功能清单: feature_list.json
• 开发指南: PERDAS-GUIDE.md

---

💡 常用命令速查

# 启动服务器
./stock-tool-simple &

# 查看功能
jq '.features[] | select(.status=="in_progress")' feature_list.json

# 更新功能状态
jq '.features[] | select(.id=="feat-006") | .passes = true' feature_list.json > tmp.json && mv tmp.json feature_list.json

# 查看提交历史
git log --oneline -10

# 提交更改
git add .
git commit -m "feat: 描述"
git push

---

🎉 开始你的第一个功能

当前进行中的功能：feat-006 - 数据刷新功能

按照以下步骤开始：

1. 查看功能详情：

   jq '.features[] | select(.id=="feat-006")' feature_list.json
   

2. 启动服务器并测试：

   ./stock-tool-simple &
   http://localhost:8080
   

3. 完成功能开发并更新状态

祝你开发顺利！🚀