jiantw83
2c085d68ef
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與 「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上 看起來像普通文字或死連結，巡不到也修不了。 連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API， 不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把 好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁 整批判死。
33 lines
1.8 KiB
Markdown
33 lines
1.8 KiB
Markdown
# 工作日誌頁 — 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}) |
|
||
|
||
### 執行細節與產出
|
||
|
||
- {做了什麼、產出哪些檔案或頁面}
|
||
|
||
### 遇到的困難與解決方式
|
||
|
||
- {困難} → {解決方式}
|