← 知識庫 / Knowledge base

EDITORIAL WORKSPACE

文章管理 / Articles

保存草稿 → 檢查內容 → 發布 → 更新搜尋索引。編輯已發布文章時,公開版本維持到下次發布。

需要管理者登入 / Administrator access required · 登入 / Sign in

請載入文章或建立草稿。

撰稿規範(給人與 AI) / Writing guide for humans and AI

每篇文章的讀者是之後要維護或仿作的人和 AI:讀完就能少走彎路,直接動手。不是開發日記、週報或發布清單。

給下一個撰稿的 AI:發文前照這份規範自我檢查;文章管理頁的「存入並發布」會用同一套規則檢查(src/scripts/work/writingGuide.ts 的 auditArticle),不符合就不發布。範例:〈不加依賴的 OpenTimestamps〉、〈把季報疊到日 K 線上而不偷看未來〉。

必須 / Must

  1. 一篇只講一個技術問題,標題寫成具體的問題或機制(例:「不加依賴的 OpenTimestamps」),不要寫「近期開發紀錄」。
  2. 只能是兩類之一,標籤第一個寫類別:Software Engineering(演算法、資料結構、資料庫、並行、協定、建置、測試)或 Quant Finance(一個指標或方法)。
  3. Software Engineering 段落依序:問題(輸入、輸出、限制、一個真實失敗案例)→ 原理(附一手來源)→ 實作(至少兩段真實程式碼,標路徑與 commit,寫不變式或複雜度)→ 替代方案(表格,至少兩個)→ 驗證(測試名稱、red→green)→ 限制 → 參考資料。
  4. Quant Finance 段落依序:問題(常見做法為何失真)→ 定義與公式(單位、頻率、公布時差)→ 用公開資料的逐步算例 → 實作對應(缺值、修正、時區、前視偏誤)→ 敏感度與反例 → 限制(不是投資建議)→ 參考資料。
  5. 加一段「踩過的坑」或檢查清單:別人最可能卡住的地方,以及怎麼避開。
  6. 數字、測試數、上線狀態都要能核對;計畫、程式完成、測試通過、正式上線分開寫。

不要 / Never

  • 「決策一、決策二…」「最近幾天」「本週」「下一步」這類日記結構。
  • 一篇拼多個主題;沒有程式碼或公式;「更穩定」「提升體驗」這類無法驗證的形容。
  • 金鑰、帳戶資料、內網位址、私人報告。

上傳或貼上 Markdown / Import Markdown

Agent 可呼叫 Markdown 匯入 API;這裡可直接貼上包含 frontmatter 的完整文章。選取既有文章後會以版本檢查更新。

欄位編輯與生命週期管理 / Fields & lifecycle

TY的智慧庫

你有事?
問前想清楚,機會不是誰都有。

💡 建議主題:

放大圖片