jeffnewberry/cite-viewer

引註檢視器

引註檢視器是一個本機網頁，顯示使用者的草稿（或其一個章節）。每個引註都是一個連結，以不同顏色的底線標示其狀態。點擊引註會顯示來源中的引用頁面，其中引述或依賴的文字會加上陰影，並附註該段落是否支持該句子、一個可開啟完整來源至該頁面的連結，以及一個使用者可輸入修正內容的註記方塊。

檢視器並不取代閱讀判決書，也不取代 citator（KeyCite 或 Shepard's）。它讓閱讀變得更快速，並記錄每個段落是否支持引用它的句子。

永不改變的兩條規則

• **切勿發布檢視器或將其託管在任何地方。**它包含使用者的草稿，並透過記錄連結指向卷宗材料。它應保留在使用者的電腦上，作為一個可透過雙擊開啟的檔案。切勿主動提議將其轉換為可分享的連結。如果使用者無論如何要求發布，請先警告客戶保密義務。
• **切勿修改草稿。**檢視器報告問題，但不解決它們。僅在使用者另行要求時才修改草稿。

適用時機

它最適合用於文字已定稿、引註已通過引用檢查和 citator 檢查，且即將進行最終校對之前的草稿。如果使用者較早要求，請用一句話說明，然後在使用者仍希望建立的情況下進行建置。

開始之前

以一個簡短的區塊詢問使用者尚未提供的資訊：

1. 哪一份草稿。要求他們附上檔案，或指定檔案名稱。
2. 範圍：整份文件，或指定的章節。即使草稿很短也應詢問；切勿自行決定範圍。
3. 來源：「我應該從 Westlaw 為您提取判決書嗎，還是您自己把 PDF 放到一個資料夾中？」（Westlaw 使用者：請看步驟 3。Lexis 或其他使用者：請看步驟 3a。）
4. 卷宗引用：「您是否也希望將卷宗引用連結起來？如果是，您電腦上的哪個資料夾存放卷宗記錄，以及您如何引用它？請從您的草稿中給我一個範例引用（例如，12 R.R. 41，ROA.1234，Dkt. 52 at 3，或 JA 123）。」任何資料夾都可以（Dropbox、OneDrive 或一般資料夾），因為檢視器會連結檔案所在的位置，而不會複製任何內容。如果使用者說不，卷宗引用會顯示為「來源未載入」。

要求建立檢視器即表示同意儲存檢視器資料夾，並在步驟 3 中的費用警告之後，提取來源。

步驟

1. 建立引註表

將草稿轉換為純文字。依序遍歷範圍，並列出每個引註：完整引用、簡式引用、id.、supra、法規、二次資料和卷宗引用。對於每個引註，記錄：

• 一個識別碼（c1、c2 等），以及引註的原文；
• 它解析出的權威（將 id. 和簡式引用解析為完整的權威）；
• 引註頁碼或引註頁碼組合；
• 命題，以及任何引述的語言，來自它所支持的句子；
• 該引註是否依賴來源中的特定材料（判決要旨、測試標準、引文）或僅整體引用案件（請參閱步驟 6）。

標記範圍中任何沒有引註的法律陳述。頁面也會標記這些陳述。

如果草稿使用了簡式引用或 supra，但全文未出現完整引用，請勿無聲地猜測。提供引用並標示「一般知識，未經驗證」，或將其省略並標記出來。

2. 建立來源清單

每個權威一個條目：判決書的引用（「466 U.S. 668」）、未公開意見的 WL 引用、法規的章節編號、文章則為「卷號 縮寫 起始頁」。條目以分號分隔，最多 100 個。省略卷宗引用和 Westlaw 不提供的任何內容；將它們列出在報告中。

3. 從 Westlaw 提取來源（Find & Print）

• 提取任何內容之前，請向使用者說明一次 Find & Print 請求可能會根據其 Westlaw 方案收費，並在他們確認後才繼續。
• 在瀏覽器中開啟 Westlaw，並要求使用者以其慣用的方式登入：公司單一登入、法學院入口網站或 Thomson Reuters ID。告訴他們，如果開啟的頁面不是他們常用的頁面，他們可以在同一個瀏覽器視窗中前往他們常用的登入頁面。切勿輸入密碼；一旦他們登入完成，其餘部分由你處理。
• 前往 Find & Print 並貼上清單。
• 設定：Cases → opinion only（無 headnotes）；Statutes → statutory text only；取消勾選「Substitute with reporter images」，因為星號頁碼必須是文字；Delivery → Download；Format → PDF；As → Multiple files (ZIP)；關閉雙欄版面。
• 提交。如果 Westlaw 拒絕某些引用，將它們移除，繼續進行，並報告它們。
• 當下載準備就緒時，點擊 Westlaw 的下載按鈕。瀏覽器隨後會顯示其自己的儲存視窗，你無法點擊。告訴使用者即將出現視窗，並要求他們在該視窗中點擊「儲存」（或「下載」）。ZIP 檔案會存放在他們的下載資料夾中。

3a. 使用者提供的來源

要求使用者將每個權威的一個 PDF 放入一個資料夾中，並告知你是哪個資料夾。僅限文字型 PDF；如果 PDF 是沒有文字的掃描檔，請要求提供文字版本。

4. 取得 PDF

要求存取下載檔案所在的資料夾（或步驟 3a 中的資料夾）。將其解壓縮到下載資料夾之外的工作資料夾中。將每個 PDF 與其權威進行配對，並標記任何未回傳的檔案。

5. 提取引用段落

Westlaw PDF 在文字中標記星號頁碼：主要判決書為 *688，平行判決書為 **2055 和 ***，WL 引用為 *1、*2。移除平行標記，根據單星號標記分割文字，並取得每個引註頁碼的頁面文字，以及前一頁的最後幾百個字元，以便從前一頁開始的句子能夠完整閱讀。找出每個標記出現的 PDF 頁面，作為「開啟完整來源 ↗」連結（#page=N）使用。移除頁面頁首和頁尾。使用此檔案末尾的腳本。當引註頁碼不是星號頁碼（法律評論文章頁面、法規小節或來自其他服務的 PDF）時，透過搜尋引述或依賴的語言來尋找段落。

5a. 卷宗引用（僅在使用者選擇時）

• 從使用者的範例引用中，推斷出引用的哪一部分命名了檔案（卷號、文件或卷宗編號、附錄）以及哪個數字命名了頁面（列印的庭訊記錄頁面、蓋章的卷宗頁面（例如 ROA.1234）、法院的標題頁面或附錄頁面）。卷宗可能是一個或多個檔案。
• 列出使用者資料夾中的卷宗檔案，並將每個引用與其檔案進行配對（例如，「Vol. 39」或「RR39」對應 39 R.R.；「ECF 52」對應 Dkt. 52；一個連續蓋章的卷宗記錄對應 ROA 引用）。如果配對不明確，請向使用者展示你的對應關係，並在繼續之前詢問。
• 僅讀取被引用的頁面。透過引用中使用的頁碼來尋找每個被引用的頁面，該頁碼應與頁面本身顯示的頁碼一致，切勿使用 PDF 頁面計數；兩者很少相符。當一個頁面有兩個數字時（例如，法院的標題頁面和文件本身的頁碼），且使用者的範例無法確定引用指的是哪一個時，請詢問。如果找不到該數字，請將該引用標記為「check」並說明。
• 對於每個卷宗引用，記錄兩個數字：引用使用的頁碼以及它所在的 PDF 頁面。
• 將每個卷宗引用連結到其所在的檔案，使用從檢視器 HTML 檔案到使用者電腦上卷宗檔案的相對連結，並指向 PDF 頁面。例如，當檢視器資料夾和卷宗記錄都位於下載資料夾中時：../volume.pdf#page=N。根據使用者電腦上的真實路徑（如資料夾列表所示）建立連結，切勿使用你自己工作區中的路徑。不要使用完整的 file:/// 位址；瀏覽器通常會拒絕它們。不要將任何內容複製到檢視器資料夾中。
• 卷宗記錄必須是使用者電腦上可搜尋文字的 PDF。僅儲存在線上的檔案（未下載的雲端檔案，或透過網站存取的檔案庫）無法連結；請告知使用者哪些檔案無法連結。

6. 檢查每個引註

針對每個段落，比對它所支持的句子。指定一個狀態：

• **ok — 支持。**段落的內容與句子一致。任何引文都完全相符，或者括號說明了所有變更。僅在引用全文案件且屬於敘述性句子本身的一部分，而不依賴任何特定段落時（藍皮書規則 3.2(a)），才使用 ok，不附摘錄。一個支持命題的引用句子或從句總是依賴特定材料並需要引註頁碼，即使它同時引用了幾個案件。一個全文案件引用的註記為「整體引用案件；無需引註頁碼（藍皮書規則 3.2(a)）。」
• **check — 需檢查。**引文不符，段落僅支持句子的一部分，引註頁碼錯誤，或句子對來源的描述不準確。確切說明哪些地方有問題，並給出修正方法（正確的引註頁碼，或以括號表示的更正）。
• **pin — 無引註頁碼。**引用特定材料但沒有引註頁碼。顯示附近文字所依賴的頁面。當不確定句子是否依賴特定材料時，使用 check 並說明，以供使用者決定。
• **none — 來源未載入。**任何不在 PDF 或卷宗資料夾中的內容。說明使用者需要添加什麼。

註記僅說明來源的內容。在超出此範圍的任何內容前加上「推論：」。僅標記實質問題：錯誤引文、錯誤的引註頁碼、誇大或錯誤描述的判決要旨、卷宗頁面不支持的事實。忽略純粹的拼字錯誤。在每個摘錄中為確切依賴的文字加上陰影。

7. 建立頁面

在使用者的下載資料夾（或他們要求的任何位置）中儲存一個資料夾，命名為草稿名稱加上「cite-viewer」和日期。它包含：

• HTML 檔案；
• 一個 sources/ 資料夾，包含案件 PDF。（卷宗檔案保留在原地。）

頁面規則：

• 左側為草稿，右側為段落面板；在窄螢幕上則上下堆疊。
• 頂部有一個圖例，顯示每個狀態的計數，加上「紅色虛線文字 = 無引註的法律陳述。」
• 完全按原樣顯示草稿文字。
• 段落以淺藍色標示。文字靠左對齊，使用襯線字體。
• 支援亮色和暗色模式。
• 點擊引註會顯示狀態徽章、引註原文、註記、每個摘錄（附頁面頁首和「開啟完整來源 ↗」連結），然後是註記方塊。
• 每個摘錄標題以兩種頁碼標示頁面，以便使用者無需開啟檔案即可確認頁面：對於判決書，「466 U.S. at 694 · PDF page 7」；對於卷宗，「12 R.R. 45 · PDF page 10。」
• 無引註的法律陳述也可以點擊。點擊會顯示「無引註」徽章、陳述原文、一行註記（例如，「陳述法律規則；添加引註或刪除」），以及註記方塊。

**註記方塊。**在每個標記面板（引註和無引註陳述）下方都有一個標示為「您的註記（例如，您想要的修正）」的文字方塊。註記會自動儲存在此檔案的瀏覽器中。將每次儲存和載入包裝在 try/catch 中，以便頁面在瀏覽器封鎖儲存時仍能運作。有註記的標記會在草稿中顯示一個小圓點。頂部的「複製所有註記」按鈕會以草稿順序將每個註記複製為編號清單，每行以引註原文（或「無引註：」和陳述的前幾個字）開頭，以便使用者可以將清單貼到 Claude 中或放在 Word 旁邊。告訴使用者一次，註記僅存在於該瀏覽器的那台電腦上；複製的清單才是安全的備份。

8. 檢查頁面

開啟頁面，並至少點擊每個狀態的一個引註，以及一個無引註陳述。確認摘錄顯示了加陰影的語言和兩個頁碼，註記位於面板頂部，每個標記都有一個註記方塊，並且「複製所有註記」功能正常。

記錄連結需要單獨檢查，因為你無法在使用者的電腦上點擊連結。對於每個記錄連結，從使用者電腦上的檢視器 HTML 檔案推斷其指向的位置，並透過列出該資料夾來確認該檔案存在。然後要求使用者點擊一個記錄連結，並告知你是否開啟了正確的頁面。在使用者確認之前，請勿將記錄連結報告為正常運作；將其報告為「已連結，尚未確認。」

9. 報告

簡短，從最重要的點開始：

• 資料夾的位置，以及如何開啟檢視器：「在 Google Chrome 中開啟檢視器（右鍵點擊 HTML 檔案，選擇『開啟方式』，然後選擇『Google Chrome』）。作者已在 Mac 的 Chrome 上測試過，它可以正常運作。Safari 會封鎖記錄連結。作者已使用德州風格的卷宗引用（12 R.R. 41）測試過記錄連結，但尚未測試其他格式。作者尚未在 Windows PC 上測試過。Chrome 應該也可以在那裡運作，Microsoft Edge 可能也可以，但作者均未嘗試。」
• 按狀態分類的計數。
• 每個「check」項目一行或兩行，附帶修正方法。
• 「無引註頁碼」的引註、無引註的陳述、未載入或被拒絕的來源，以及任何無法連結的卷宗檔案。
• 記錄連結是否已確認（請參閱步驟 8）。
• 兩種處理方式：與 Claude 逐一討論每個標記，Claude 會維持清單並在使用者批准後進行修改；或者在 Word 中工作，同時在旁邊開啟檢視器，在註記方塊中輸入修正。說明「複製所有註記」是檢視器中僅使用者可以按下的按鈕，並且他們可以將複製的清單貼回此對話中。

腳本

star_extract.py：給定一個 PDF 和一個星號頁碼清單，它會回傳每個頁面的文字、前一頁的結尾，以及每個標記出現的 PDF 頁面。

import re, subprocess, sys, json

def pdf_pages(pdf):
    info = subprocess.run(['pdfinfo', pdf], capture_output=True, text=True).stdout
    n = int(re.search(r'Pages:\s+(\d+)', info).group(1))
    return [subprocess.run(['pdftotext', '-f', str(i), '-l', str(i), pdf, '-'],
                           capture_output=True, text=True).stdout for i in range(1, n + 1)]

def clean(t):
    t = re.sub(r'WESTLAW\s*©.*?For Educational Use Only[^\n]*\n', '', t, flags=re.S)
    t = re.sub(r'\*\*\*?\d+\s?', '', t)          # 移除平行判決書標記
    t = re.sub(r'-\n(?=[a-z])', '', t)
    return re.sub(r'\s+', ' ', t)

def segments(pages):
    parts 

…

[為便於翻譯而截斷]