Files
log/templates/log-entry.md
T
jiantw83 2c085d68ef feat(link): 連結一律寫成 [文字](絕對網址),寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法,不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析,寫錯不報錯,畫面上
看起來像普通文字或死連結,巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh,結束碼 0 才寫。驗證一律走 API,
不看網頁狀態碼:私有存取庫的網頁網址對未登入請求一律回 404,拿狀態碼判會把
好連結判成壞的。認證失敗回 7,與死連結的 1 分開,免得金鑰一過期就把還在的頁
整批判死。
2026-09-02 14:27:18 +08:00

1.8 KiB
Raw Blame History

工作日誌頁 — 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})

執行細節與產出

  • {做了什麼、產出哪些檔案或頁面}

遇到的困難與解決方式

  • {困難} → {解決方式}