Compare commits
11 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 2b5d901cfe | |||
| a60990b652 | |||
| 040d43d7f9 | |||
| 55e66b2aab | |||
| 5fcac66800 | |||
| 9050d7dea4 | |||
| 0b03856ecd | |||
| 3205508684 | |||
| fe731ba12d | |||
| e65623e29d | |||
| bdef679c2b |
@@ -23,7 +23,7 @@ jobs:
|
||||
steps:
|
||||
- name: Checkout main branch
|
||||
run: |
|
||||
git clone --depth 1 http://localhost:3000/pzhang_zywl/document_analyzer.git .
|
||||
git clone --depth 1 https://git.zywl.me/zeekrAI/document_analyzer.git .
|
||||
git checkout main
|
||||
|
||||
- name: Install dependencies
|
||||
|
||||
@@ -23,5 +23,5 @@ jobs:
|
||||
-H "Content-Type: application/json" \
|
||||
-d "{\"title\":\"CI Failure: ${COMMIT_MSG}\",\"body\":\"## CI 测试失败\n\n- **Commit:** ${SHA_SHORT}\n- **Branch:** ${BRANCH}\n- **工作流:** ${RUN_URL}\n\n请检查上述链接查看失败详情。\n\n### 下一步\n- [ ] 分析失败原因\n- [ ] 修复代码\n- [ ] 提交 PR 触发 CI 重测\",\"labels\":[\"ci-failure\",\"agent-task\"]}"
|
||||
env:
|
||||
GITEA_URL: http://localhost:3000
|
||||
GITEA_REPO: pzhang_zywl/document_analyzer
|
||||
GITEA_URL: https://git.zywl.me
|
||||
GITEA_REPO: zeekrAI/document_analyzer
|
||||
|
||||
@@ -12,7 +12,7 @@ jobs:
|
||||
steps:
|
||||
- name: Checkout code from Gitea
|
||||
run: |
|
||||
git clone --depth 1 http://localhost:3000/pzhang_zywl/document_analyzer.git .
|
||||
git clone --depth 1 https://git.zywl.me/zeekrAI/document_analyzer.git .
|
||||
git fetch origin ${{ github.sha }}
|
||||
git checkout ${{ github.sha }}
|
||||
|
||||
|
||||
+11
-11
@@ -15,9 +15,9 @@ Gitea (localhost:3000) Dev Agent
|
||||
|
||||
| 组件 | 位置 | 说明 |
|
||||
|------|------|------|
|
||||
| Gitea 服务 | `http://localhost:3000` | SQLite 数据库,Actions 已启用 |
|
||||
| Gitea 服务 | `https://git.zywl.me` | SQLite 数据库,Actions 已启用 |
|
||||
| Actions Runner | `C:\Users\peterz\tools\act_runner\` | Shell 模式,v0.2.11 |
|
||||
| 仓库 | `pzhang_zywl/document_analyzer` | 22+ 文件,CI/CD 已配置 |
|
||||
| 仓库 | `zeekrAI/document_analyzer` | 22+ 文件,CI/CD 已配置 |
|
||||
| API Token | 用户自行生成 | Settings → Applications → Generate Token |
|
||||
|
||||
## 环境搭建
|
||||
@@ -36,12 +36,12 @@ nohup ./gitea.exe web --config /c/Users/peterz/tools/gitea/data/app.ini > data/g
|
||||
nohup /c/Users/peterz/tools/act_runner/act_runner.exe daemon > /c/Users/peterz/tools/act_runner/runner.log 2>&1 &
|
||||
```
|
||||
|
||||
访问 `http://localhost:3000` 即可使用。
|
||||
访问 `https://git.zywl.me` 即可使用。
|
||||
|
||||
### 2. 创建 Gitea API Token
|
||||
|
||||
1. 登录 Gitea → 右上角头像 → Settings → Applications
|
||||
2. 或在浏览器直接打开: `http://localhost:3000/user/settings/applications`
|
||||
2. 或在浏览器直接打开: `https://git.zywl.me/user/settings/applications`
|
||||
3. Manage Access Tokens → Generate Token
|
||||
4. 权限勾选: `write:issue` `write:repository` `write:user`
|
||||
5. 复制 token 备用
|
||||
@@ -56,8 +56,8 @@ nohup /c/Users/peterz/tools/act_runner/act_runner.exe daemon > /c/Users/peterz/t
|
||||
|
||||
```bash
|
||||
export GITEA_API_TOKEN="你的token"
|
||||
export GITEA_URL="http://localhost:3000"
|
||||
export GITEA_REPO="pzhang_zywl/document_analyzer"
|
||||
export GITEA_URL="https://git.zywl.me"
|
||||
export GITEA_REPO="zeekrAI/document_analyzer"
|
||||
```
|
||||
|
||||
## CI/CD 工作流
|
||||
@@ -101,8 +101,8 @@ git clone → pip install → pytest →
|
||||
**Bash/WSL/Git Bash:**
|
||||
```bash
|
||||
export GITEA_API_TOKEN="59117246ec418d5d87042de073b0d4197d8054bf"
|
||||
export GITEA_URL="http://localhost:3000"
|
||||
export GITEA_REPO="pzhang_zywl/document_analyzer"
|
||||
export GITEA_URL="https://git.zywl.me"
|
||||
export GITEA_REPO="zeekrAI/document_analyzer"
|
||||
```
|
||||
|
||||
### 方式 A: 单次任务模式
|
||||
@@ -142,7 +142,7 @@ claude --agent agents/DEV_AGENT.md
|
||||
|
||||
在 Claude Code 对话中直接说:
|
||||
|
||||
> 用 DEV_AGENT.md 检查 http://localhost:3000/pzhang_zywl/document_analyzer/issues 有没有待处理工单
|
||||
> 用 DEV_AGENT.md 检查 https://git.zywl.me/zeekrAI/document_analyzer/issues 有没有待处理工单
|
||||
|
||||
### 方式 D: 任何其他 Agent
|
||||
|
||||
@@ -182,7 +182,7 @@ python scripts/agent_poller.py --action create-pr --issue N --branch fix/issue-N
|
||||
|
||||
1. 在 `tests/test_sample.py` 中添加故意失败的测试
|
||||
2. Push → CI 变红 → 自动在 Gitea 创建 Issue(含失败详情)
|
||||
3. 查看: `http://localhost:3000/pzhang_zywl/document_analyzer/issues`
|
||||
3. 查看: `https://git.zywl.me/zeekrAI/document_analyzer/issues`
|
||||
|
||||
### 测试修复 → CI 通过 → Issue 关闭
|
||||
|
||||
@@ -203,5 +203,5 @@ python scripts/agent_poller.py --action create-pr --issue N --branch fix/issue-N
|
||||
|
||||
**Q: Agent 连不上 Gitea API?**
|
||||
- 确认 `GITEA_API_TOKEN` 环境变量已设置
|
||||
- 确认 Gitea 服务正在运行: `curl http://localhost:3000/api/v1/version`
|
||||
- 确认 Gitea 服务正在运行: `curl https://git.zywl.me/api/v1/version`
|
||||
- 确认 Token 权限包含 `write:issue` 和 `write:repository`
|
||||
|
||||
+8
-2
@@ -44,8 +44,8 @@ description: AI 开发专家,负责 document_analyzer 项目的功能开发、
|
||||
|
||||
代理需要以下环境变量与 Gitea 交互:
|
||||
|
||||
- `GITEA_URL` — `http://localhost:3000`
|
||||
- `GITEA_REPO` — `pzhang_zywl/document_analyzer`
|
||||
- `GITEA_URL` — `https://git.zywl.me`
|
||||
- `GITEA_REPO` — `zeekrAI/document_analyzer`
|
||||
- `GITEA_API_TOKEN` — Gitea 个人访问令牌
|
||||
- `DEV_AGENT_ID` — 代理标识(默认 `da-01`,启动脚本自动设为 `da-MMDD-HHmm`)
|
||||
|
||||
@@ -96,6 +96,12 @@ python scripts/agent_poller.py --action list
|
||||
- 如果仍有未解决的阻塞 → 跳过,等待阻塞解除
|
||||
- 关闭 Issue 时会自动检查并解除被其阻塞的 Issue(auto-unblock)
|
||||
|
||||
**设置阻塞(原子操作)**:
|
||||
- 创建研究 Issue 或委托 Issue(test-code 等)时,**必须立即**完成以下两步,不可分两次轮询:
|
||||
1. 在原 Issue 评论"阻塞: #新Issue号",说明阻塞原因
|
||||
2. 给原 Issue 加上 `blocked` 标签(通过 Gitea API PUT /issues/{num}/labels)
|
||||
- `blocked-check` 会自动检测阻塞解除,但**设置阻塞必须是手动的,且与创建 Issue 原子执行**
|
||||
|
||||
**处理范围**:Dev-Agent 负责处理**所有非纯测试开发**相关的 Issue。具体来说:
|
||||
|
||||
| 处理 | 跳过 |
|
||||
|
||||
+2
-2
@@ -34,8 +34,8 @@ description: QE Agent — 自动化验收测试开发与质量门禁。轮询 Gi
|
||||
开始工作前,确认以下环境变量已设置:
|
||||
|
||||
```bash
|
||||
export GITEA_URL="http://localhost:3000"
|
||||
export GITEA_REPO="pzhang_zywl/document_analyzer"
|
||||
export GITEA_URL="https://git.zywl.me"
|
||||
export GITEA_REPO="zeekrAI/document_analyzer"
|
||||
export GITEA_API_TOKEN="<your-token>"
|
||||
```
|
||||
|
||||
|
||||
+24
-12
@@ -1,4 +1,4 @@
|
||||
# 项目全局状态(截至 2026-06-02 20:00)
|
||||
# 项目全局状态(截至 2026-06-03 15:30)
|
||||
|
||||
## 参考章程
|
||||
详见 `PROJECT_CHARTER.md`。章程中定义的长期目标与原则是当前决策的最高依据。
|
||||
@@ -36,14 +36,17 @@ input/*.docx → doc_parser → _parsed.json
|
||||
| 方向 | 状态 | 结论摘要 | 关联 Issue |
|
||||
|------|------|----------|------------|
|
||||
| 零内容维度均分 bug | 已闭合 | _measure_coverage: 0/0 维度 rate 1.0 + 排除出 overall 均分 | #21 |
|
||||
| LLM 输出防御层 | 已闭合 | _normalize_rule 处理 6 种变异:null trigger/conditions, 缺失 section, 非法 type, 空 sources, section=list, null row | #53, #64, #69, #73 |
|
||||
| LLM 输出防御层 | 已闭合 | _normalize_rule 处理 7 种变异:+ precondition 字段缺失(screen_type/geo 默认值) | #53, #64, #69, #73, #86 |
|
||||
| 覆盖反馈重试优化 | 已闭合 | 重试 1→3 次 + 质量门控(仅采纳提升覆盖率的 retry)+ ensemble 3→4 temps | #54, #75 |
|
||||
| step2 prompt 完整性 | 已闭合 | 新增规则 #9:强制覆盖所有表格行和文字描述 | #75 |
|
||||
| Dev-Agent 流程规范 | 已闭合 | 修复类型区分、批处理策略、关闭规范、研究型修复、禁止模式 | #67, #79 |
|
||||
| QE Agent 基础设施 | 已闭合 | label 体系统一 (test-code/product-code), agent_poller 7 项增强 (create-issue/reopen/blocked-check/auto-unblock/_req_safe), bypass 全自动配置 | #40, #43, #47, #49, #51, #58, #61 |
|
||||
| Dev-Agent 流程规范 | 已闭合 | 修复类型区分、批处理策略、关闭规范、研究型修复、禁止模式、阻塞设置原子操作 | #67, #79, #91 |
|
||||
| QE Agent 基础设施 | 已闭合 | label 体系统一 (test-code/product-code), agent_poller 7 项增强 | #40, #43, #47, #49, #51, #58, #61 |
|
||||
| conftest 防御降级 | 已闭合 | ir_data fixture: list-section flatten + normalize 异常回退 raw rule | #70 |
|
||||
| QE 全天轮询实战 | 已闭合 | 7 轮 e2e, 15 Issue, A: 4 ERROR→PASS, B: 63%→98.1%, C: 持续 REJECT | #18, #66 |
|
||||
| 多 Agent 协作闭环 | 已闭合 | Dev+QE 通过 Gitea Issues 协同迭代 | #15 |
|
||||
| 图像模型切换 | 已闭合 | qwen3-vl-plus → qwen3.6-flash,恢复 pipeline 可用性 | #88 |
|
||||
| Windows GBK subprocess 编码 | 已闭合 | run_pipeline.py subprocess.run 添加 encoding='utf-8',修复 stdout=None 崩溃 | #84 |
|
||||
| _normalize_rule precondition 防御 | 已闭合 | screen_type 缺失→"any",geo 缺失→"global",precondition=None→{} | #86 |
|
||||
|
||||
## 已知问题清单
|
||||
- [x] ~~[P0] IR 结构化覆盖率不足(#21)~~ — 98.1%,Layer B PASS
|
||||
@@ -54,26 +57,35 @@ input/*.docx → doc_parser → _parsed.json
|
||||
- [x] ~~空 sources(#64)~~ — 补充 text source
|
||||
- [x] ~~section 为 list(#69)~~ — flatten to first
|
||||
- [x] ~~null row(#73)~~ — row=0
|
||||
- [ ] Layer C QE Audit 持续 REJECT(#75)— 多次代码改动已合入,待 pipeline 验证
|
||||
- [x] ~~Windows GBK subprocess 编码(#84)~~ — encoding='utf-8'
|
||||
- [x] ~~precondition 字段缺失(#86)~~ — _normalize_rule 防御层扩展
|
||||
- [x] ~~图像模型欠费(#88)~~ — qwen3-vl-plus → qwen3.6-flash
|
||||
- [ ] Layer C QE Audit 持续 REJECT(#75)— **blocked by #90**,Dev 侧工作完成,等 QE-Agent 升级审计模型
|
||||
- [ ] Layer C 审计模型升级(#90,test-code,QE 域)
|
||||
- [ ] 缺少完整 e2e 测试(#18,test-code,QE 域)
|
||||
|
||||
## 当前打开 Issue(非纯测试)
|
||||
| # | 标题 | 优先级 | 状态 |
|
||||
|---|------|--------|------|
|
||||
| #18 | [test] 再运行一次完整的e2e测试 | 中(A+B PASS) |
|
||||
| #75 | Layer C QE Audit REJECT | 质量级 | 多轮代码改动已合入,待 pipeline 验证 |
|
||||
| #67 | Dev-Agent PR 前必须跑完整 e2e | 中 |
|
||||
| #79 | [product] 系统性的分析和反思项目开发流程 | 高(Dev-Agent 自我反思) |
|
||||
| #75 | Layer C QE Audit REJECT | 质量级 | **blocked by #90**,Dev 侧已闭合,Layer B 94.4% PASS |
|
||||
| #90 | [test] 审计模型升级 | QE 域 | test-code,委托 QE-Agent |
|
||||
| #18 | [test] e2e 测试 | QE 域 | test-code |
|
||||
|
||||
## 下次启动推荐起点
|
||||
1. 读取 `docs/PROJECT_CHARTER.md` 和 `docs/GLOBAL_STATE.md`
|
||||
2. 运行 `python scripts/agent_poller.py --action list` 获取最新 Issue
|
||||
3. #75 如仍 open:跑 pipeline + e2e 验证 Layer C
|
||||
4. 严格遵守 Issue 关闭规范和禁止模式清单
|
||||
2. 运行 `python scripts/agent_poller.py --action list` + `--action blocked-check`
|
||||
3. #75 如 #90 已关闭:跑 pipeline + e2e 验证 Layer C(`--parsed-path output/车机娱乐系统禁止功能文档_脱敏 v1.0_parsed.json`)
|
||||
4. 注意:不要直接改 tests/acceptance/,测试变更委托 test-code Issue 给 QE-Agent
|
||||
5. 创建委托/研究 Issue 时必须立即设置 blocked 标签(原子操作)
|
||||
|
||||
## 最近变更日志
|
||||
| 日期 | 变更 | 原因 |
|
||||
|------|------|------|
|
||||
| 2026-06-03 | Dev session: 4 Issue 闭环 (#84 #86 #88 #91), Layer B 94.4% PASS | Dev-Agent da-0603-1426 轮询 |
|
||||
| 2026-06-03 | 图像模型 qwen3-vl-plus → qwen3.6-flash - Closes #88 | API 欠费,切换模型 |
|
||||
| 2026-06-03 | _normalize_rule precondition 防御层扩展 - Closes #86 | screen_type/geo 缺失兜底 |
|
||||
| 2026-06-03 | run_pipeline.py subprocess encoding='utf-8' - Closes #84 | Windows GBK stdout=None 崩溃 |
|
||||
| 2026-06-03 | DEV_AGENT.md 阻塞设置原子操作规则 - Closes #91 | #75→#90 阻塞关系事后补的教训 |
|
||||
| 2026-06-02 | QE session 收尾:15 Issue, 90% 闭环率, A 4 ERROR→PASS, B 63%→98.1% | QE-Agent 全天轮询 |
|
||||
| 2026-06-02 | DEV_AGENT.md v4:Issue 关闭规范 + 研究型修复 + 禁止模式 + 修复类型区分 - Closes #79 | #75 3 轮重开暴露流程缺陷 |
|
||||
| 2026-06-02 | agent_poller 大幅增强:create-issue/reopen/blocked-check/auto-unblock/_req_safe | QE session 累积 7 项改进 |
|
||||
|
||||
@@ -33,7 +33,7 @@
|
||||
|
||||
## 项目环境
|
||||
- 项目目录:`C:\Users\peterz\projects\document_analyzer`
|
||||
- Gitea 仓库:`http://localhost:3000/pzhang_zywl/document_analyzer`
|
||||
- Gitea 仓库:`https://git.zywl.me/zeekrAI/document_analyzer`
|
||||
- CI/CD:Gitea Actions,配置文件 `ci.yml`
|
||||
- LLM 配置:`~/.openclaw/config/secrets.yaml`
|
||||
- Agent 定义:`agents/DEV_AGENT.md`、`agents/QE_AGENT.md`
|
||||
|
||||
+2
-2
@@ -14,8 +14,8 @@ if [ -f "$_COMMON_DIR/.env" ]; then
|
||||
fi
|
||||
|
||||
# ── Default environment variables ──────────────────────────────────────────────
|
||||
export GITEA_URL="${GITEA_URL:-http://localhost:3000}"
|
||||
export GITEA_REPO="${GITEA_REPO:-pzhang_zywl/document_analyzer}"
|
||||
export GITEA_URL="${GITEA_URL:-https://git.zywl.me}"
|
||||
export GITEA_REPO="${GITEA_REPO:-zeekrAI/document_analyzer}"
|
||||
|
||||
# ── Validate required environment ──────────────────────────────────────────────
|
||||
require_token() {
|
||||
|
||||
@@ -21,8 +21,8 @@ import sys
|
||||
import urllib.request
|
||||
import urllib.error
|
||||
|
||||
GITEA_URL = os.environ.get("GITEA_URL", "http://localhost:3000")
|
||||
GITEA_REPO = os.environ.get("GITEA_REPO", "pzhang_zywl/document_analyzer")
|
||||
GITEA_URL = os.environ.get("GITEA_URL", "https://git.zywl.me")
|
||||
GITEA_REPO = os.environ.get("GITEA_REPO", "zeekrAI/document_analyzer")
|
||||
GITEA_TOKEN = os.environ.get("GITEA_API_TOKEN", "")
|
||||
DEV_AGENT_ID = os.environ.get("DEV_AGENT_ID", "da-01")
|
||||
QE_AGENT_ID = os.environ.get("QE_AGENT_ID", "")
|
||||
|
||||
@@ -6,8 +6,8 @@ import os
|
||||
import urllib.request
|
||||
import urllib.error
|
||||
|
||||
GITEA_URL = "http://localhost:3000"
|
||||
REPO = "pzhang_zywl/document_analyzer"
|
||||
GITEA_URL = "https://git.zywl.me"
|
||||
REPO = "zeekrAI/document_analyzer"
|
||||
|
||||
|
||||
def main():
|
||||
|
||||
@@ -11,8 +11,8 @@ if exist "scripts\.env" (
|
||||
)
|
||||
|
||||
:: ── Defaults ──────────────────────────────────────────────────────────────────
|
||||
if "%GITEA_URL%"=="" set GITEA_URL=http://localhost:3000
|
||||
if "%GITEA_REPO%"=="" set GITEA_REPO=pzhang_zywl/document_analyzer
|
||||
if "%GITEA_URL%"=="" set GITEA_URL=https://git.zywl.me
|
||||
if "%GITEA_REPO%"=="" set GITEA_REPO=zeekrAI/document_analyzer
|
||||
if "%DEV_AGENT_ID%"=="" set DEV_AGENT_ID=da-01
|
||||
|
||||
:: ── Validate token ────────────────────────────────────────────────────────────
|
||||
|
||||
@@ -63,7 +63,7 @@ class LLMClient:
|
||||
print(llm.usage)
|
||||
"""
|
||||
|
||||
IMAGE_MODEL = "qwen3-vl-plus"
|
||||
IMAGE_MODEL = "qwen3.6-flash"
|
||||
TEXT_MODEL = "deepseek-v4-flash"
|
||||
|
||||
DASHSCOPE_BASE = "https://dashscope.aliyuncs.com/compatible-mode/v1"
|
||||
@@ -72,7 +72,7 @@ class LLMClient:
|
||||
TIMEOUT = 120
|
||||
MAX_RETRIES = 3
|
||||
|
||||
_VISION_KEYWORDS = ("vl", "vision", "qwen-vl", "qwen3-vl")
|
||||
_VISION_KEYWORDS = ("vl", "vision", "qwen-vl", "qwen3-vl", "qwen3.6")
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
|
||||
@@ -63,7 +63,7 @@ class LLMClient:
|
||||
print(llm.usage)
|
||||
"""
|
||||
|
||||
IMAGE_MODEL = "qwen3-vl-plus"
|
||||
IMAGE_MODEL = "qwen3.6-flash"
|
||||
TEXT_MODEL = "deepseek-v4-flash"
|
||||
|
||||
DASHSCOPE_BASE = "https://dashscope.aliyuncs.com/compatible-mode/v1"
|
||||
@@ -72,7 +72,7 @@ class LLMClient:
|
||||
TIMEOUT = 120
|
||||
MAX_RETRIES = 3
|
||||
|
||||
_VISION_KEYWORDS = ("vl", "vision", "qwen-vl", "qwen3-vl")
|
||||
_VISION_KEYWORDS = ("vl", "vision", "qwen-vl", "qwen3-vl", "qwen3.6")
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
|
||||
Reference in New Issue
Block a user