取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法,不再分「同存取庫」與 「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析,寫錯不報錯,畫面上 看起來像普通文字或死連結,巡不到也修不了。 連結寫進頁面前先過 jsc-gitea 的 link-check.sh,結束碼 0 才寫。驗證一律走 API, 不看網頁狀態碼:私有存取庫的網頁網址對未登入請求一律回 404,拿狀態碼判會把 好連結判成壞的。認證失敗回 7,與死連結的 1 分開,免得金鑰一過期就把還在的頁 整批判死。
1.8 KiB
1.8 KiB
工作日誌頁 — LOG_{HASH}
由
jsc-log:worklog維護。每完成一個任務就附加一個條目在文末,下一個任務開始前寫完。 任務有三種:一個工作包、一輪 PR 留言修正、一個獨立的修正提交。同一個工作包跑五輪留言修正就是五筆, 標題各自寫清楚是哪一輪,時間與 token 分開記。HASH依共享規則計算;頁名不再寫入年月週數,但頁內仍依本工作週的週五整理內容。 連結寫法:計畫名稱、工作包編號、PR 目標分支三欄一律寫成[{文字}]({絕對網址}),wiki 頁的網址由jsc-gitea/tools/gitea.sh wiki-url取得,不用[[...]]。LOG 與 PLAN/ANALYZE 可能分屬不同存取庫,[[...]]跨庫連不過去,畫面上還看不出壞掉。 連結驗證:條目裡的每個連結先交給jsc-gitea/tools/link-check.sh,退出碼 0 才寫入。出現 DEAD 就不寫,把連不到的那幾筆回報給呼叫端。 解不出 wiki 存取庫或頁面不存在時,該欄填「無」,其他欄照填。由maintain觸發的日誌本來就沒有計畫頁與分析頁。
{yyyy-MM-dd HH:mm} {工作摘要一句話}
| 欄位 | 內容 |
|---|---|
| 存取庫名稱 | {owner}/{repo} |
| 分支名稱 | {branch} |
| 計畫名稱 | [{計畫名稱}]({PLAN 頁絕對網址}) |
| 工作包編號 | [WP-{編號} {工作包標題}]({ANALYZE 頁絕對網址}#wp-{編號}) |
| 花費時間 | {h} 小時 {m} 分(session-timer report) |
| token 用量 | {CLI}: {input}/{output}(不可得填 N/A) |
| 任務狀態 | 完成、部分完成、阻塞({原因})三選一 |
| PR 目標分支 | [{base 分支}]({PR URL}) |
執行細節與產出
- {做了什麼、產出哪些檔案或頁面}
遇到的困難與解決方式
- {困難} → {解決方式}