xinb
/
X-OpenWrt
mirror of https://github.com/xopenwrt/X-OpenWrt-New.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs update codex handoff

This commit is contained in:
xopenwrt 2026-06-29 22:31:12 +08:00
parent 5f3650c671
commit 1629605bbf
1 changed files with 51 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

77
CODEX_HANDOFF.md
View File

@ -1,6 +1,6 @@
# Codex Handoff # Codex Handoff
Last updated: 2026-06-28 Last updated: 2026-06-29
## Purpose ## Purpose
@ -10,40 +10,64 @@ This file is the stable restart point for future Codex sessions in this reposito
- Repository: `X-OpenWrt-New` - Repository: `X-OpenWrt-New`
- Branch: `master` - Branch: `master`
- Latest completed task: fixed the Z workflow UEFI VMDK S3 upload path typo. - Latest completed task batch: continued the GitHub Actions X/Y/Z optimization backlog through multiple high-priority and low-risk maintainability/script items.
- Latest task commit: `175b268 fix z s3 upload path` - Latest task commit at handoff update time: `5f3650c validate workflow dispatch inputs`
- AI log for that fix: `AI_CHANGELOG_Z_S3_UPLOAD_PATH.md`
- Backlog file: `NOTES_GHA_XYZ_OPTIMIZATION.md` - Backlog file: `NOTES_GHA_XYZ_OPTIMIZATION.md`
## Completed Backlog Items
Completed in this task series:
- #1: Fixed Z workflow S3 upload path typo.
- #2: Added S3 upload `if` conditions.
- #3: Fixed `make | tee` build result detection.
- #4: Moved Z mosdns `sed` fix before build.
- #5: Stopped CI from mutating tracked `Configs/*` for ccache/devel options.
- #6: Fixed autoupdate config append target in `Firmware_Diy_Main`.
- #7: Fixed OpenWrt clone path/workdir usage.
- #8: Made `Check Build Update` conditional.
- #9: Removed hard-coded release repository from update checker.
- #10: Replaced deprecated `::set-output`.
- #11: Added explicit workflow permissions.
- #12: Added workflow concurrency.
- #14: Pinned moving-branch workflow actions to commit SHAs.
- #15: Added typed boolean workflow inputs and defaults for repository dispatch.
- #16: Added validation for config, IP, and flag dispatch inputs.
- #20: Removed Z-only debug/noise commands.
- #21: Normalized workflow download/build parallelism variables.
- #22: Trimmed duplicate/unneeded apt packages.
- #27: Fixed `Get_Release_Info` command substitution bug.
- #28: Made diagnostic external IP lookup non-blocking.
- #30: Improved release tag comparison.
Each code fix has a corresponding `AI_CHANGELOG_*.md` file.
## Remaining Work
The next unresolved backlog items need broader design or more careful behavior decisions:
- #13: Consolidate X/Y/Z workflows. This is a large refactor; prefer a reusable workflow or matrix workflow with a separate review pass.
- #17: Replace repeated S3 upload steps with a loop or matrix.
- #18: Make firmware glob handling robust with `nullglob`/arrays and missing-file skips.
- #23: Move package replacement before defconfig/download where possible.
- #24: Pin or document external package repositories such as golang/passwall/xopenwrt package sources.
- #25/#26/#29: Larger shell robustness cleanup in `Scripts/AutoBuild_*.sh`.
- #31/#32: Rework x86_64 config maintenance and shrink configs with OpenWrt diffconfig; needs a successful build environment.
- #33: Decide whether Z Image Builder artifacts should be uploaded, ignored, or disabled.
- #34: Clean stale kernel comments in config files.
## Continuation Rule ## Continuation Rule
When continuing this work, start with: When continuing this work, start with:
```bash ```bash
git status --short git status --short
git log --oneline -5 git log --oneline -10
sed -n '1,140p' CODEX_HANDOFF.md sed -n '1,220p' CODEX_HANDOFF.md
sed -n '1,180p' NOTES_GHA_XYZ_OPTIMIZATION.md sed -n '1,260p' NOTES_GHA_XYZ_OPTIMIZATION.md
``` ```
Then continue from the next unresolved high-priority backlog item. Then choose the next remaining item based on risk. For a small next step, #18 is a good candidate because it is scoped to firmware file detection/upload preparation. For a structural next step, start with #13 but plan it as a larger workflow refactor.
## Next Work
The first backlog item is already fixed in commit `175b268`.
Next unresolved high-priority item:
1. Add `if` conditions to all S3/SharePoint upload steps in:
- `.github/workflows/X-x86_64_X.yml`
- `.github/workflows/X-x86_64_Y.yml`
- `.github/workflows/X-x86_64_Z.yml`
Expected condition:
```yaml
if: env.SharePoint == 'true' && env.Result == 'true' && !cancelled()
```
## Commit Discipline ## Commit Discipline
@ -52,9 +76,10 @@ if: env.SharePoint == 'true' && env.Result == 'true' && !cancelled()
- Add a separate `AI_CHANGELOG_*.md` file for each AI-made fix. - Add a separate `AI_CHANGELOG_*.md` file for each AI-made fix.
- Do not revert unrelated user changes. - Do not revert unrelated user changes.
- Before committing, check `git status --short` and staged diff. - Before committing, check `git status --short` and staged diff.
- For workflow edits, run YAML parsing and whitespace checks. Remember that Y/Z currently use CRLF line endings.
## Suggested Prompt For Next Session ## Suggested Prompt For Next Session
```text ```text
继续之前的任务。请先读取 CODEX_HANDOFF.md 和 NOTES_GHA_XYZ_OPTIMIZATION.md，从下一个未解决的 High Priority 问题开始修复，并为本次修复创建单独的 AI 修改日志和合适的 commit。 继续之前的任务。请先读取 CODEX_HANDOFF.md 和 NOTES_GHA_XYZ_OPTIMIZATION.md，从 Remaining Work 中选择下一个合适的问题修复，并为本次修复创建单独的 AI 修改日志和合适的 commit。
``` ```