SlashDocs 協作教學：Razorpay 開源 HTML 文件平台，讓 AI 讀留言改同一份報告
SlashDocs 是 Razorpay 開源的文件協作平台。本文說明互動報告、定位評論與 AI 修改如何接在一起，並整理版本、分享權限與自架部署前的必要條件。
SlashDocs 最近在 X 受到關注，提出一個很具體的協作問題：AI 做出一份報告後，人類的修改意見該怎麼回到原本那份文件？
如果先把報告貼成截圖，再把留言複製到聊天，來回修改很容易失去位置與版本。讀者說「這張圖有問題」，代理也未必知道是哪一張。
Razorpay 的開源平台把互動文件、留言與代理修訂放在同一個協作位置。文件有固定連結，回饋可以貼近需要修改的內容。
這個設計的價值，在於減少交接時丟失的資訊。它能儲存討論，內容是否正確仍需要來源和審查。
對經常製作報告、規格或資料分析的團隊，值得測試的是一輪修訂能否完整留下依據，而不是只看報告第一次做得多漂亮。
要理解它的用途，可以從文件和回饋如何連在一起開始。
SlashDocs 如何讓回饋留在文件裡？
SlashDocs 讓代理分享可互動的 HTML 文件，讀者在瀏覽器裡評論，代理再讀取意見、修改內容與回覆討論。
HTML 是瀏覽器呈現網頁的格式，除了文字，還能包含圖表與互動。對 AI 產出的分析報告，它提供比純文字更豐富的展示方式。
公開倉庫把每份文件設計成一個能獨立儲存的 HTML 檔。圖片可以放進文件裡，圖表與圖示也能和正文一起留在相同版本。
這使文件較容易移動、封存與比較。團隊不需要只為了看懂一份報告，再尋找分散在其他位置的圖片與附檔。
評論可以定位到具體文字，官方頁面也展示對資料格與圖表留下回饋。這讓「改哪裡」更清楚，減少重新描述畫面的時間。
人類檢查與代理修改使用同一份內容
代理透過 MCP 讀取文件與評論。MCP 是連線 AI 工具與外部服務的方式，讓代理能依支援範圍取得資料與執行工作。
SlashDocs 不綁定單一模型供應商，官方列出多種支援這類連線的代理。實際可用性仍要依團隊的工具與連線設定確認。
讀者則不必操作程式。他們可以開啟文件、留下位置明確的意見，再檢視負責修改者如何回覆。
代理修訂同一份文件時，會產生新版本，而不是另外傳出一個新檔名。原本的連結因此可以繼續作為討論入口。
公開倉庫也有把評論標成已解決或重新開啟的工作流程。這能區分意見已處理、仍需討論與需要重新檢查的狀態。
工具把這些環節接起來，團隊仍要決定什麼叫「已解決」。修改者說完成以後，最好由提出意見的人對照新版本確認。
一份報告如何完成修訂？
假設 AI 做出一份產品比較報告，讀者發現其中一個價格過期。這是建議情境，用來說明回饋如何變成可檢查的修訂。
讀者可以在錯誤價格的位置留言，提供新的官方來源與查詢日期。這比只說「資料不對」更容易讓修改者知道要處理什麼。
價格修改後，還要看表格、圖表與結論是否一起更新。若其中一段仍使用舊價格，整份報告就可能前後矛盾。
評論要說明問題與預期結果
一則有效意見可以包含問題位置、判斷依據與希望修正的方向。例如指出價格屬於不同方案，要求把比較口徑改成一致。
這樣代理不只是替換數字，也知道為什麼要改。後續接手者看討論時，能理解新版本的差異。
若是風格問題，也可以描述目標讀者與用途。例如要求把專業術語改成新手能懂的說法，比只寫「太難讀」更容易執行。
評論不必變成完整新稿，卻要讓修改者知道結果如何驗收。條件越明確，就越容易分辨修訂是否對準原本問題。
修訂完成後檢查關聯內容
報告裡的數字往往影響其他地方。某個費用變動，可能改變排序、差異比例和推薦理由，需要一起檢查。
建議把這些關聯寫進回覆，例如本次更新了哪一列，以及哪些圖表或結論也受到影響。審查者就能沿著同一條線索回查。
若意見沒有照原句修改，也應說明原因。來源可能與目前比較條件不同，或建議會改變已確認的範圍，不能只留下無聲略過。
最後由人檢視實際文件。原始碼裡的數字正確，不代表圖表顯示、互動和手機排版都符合需求，成品仍要在瀏覽器檢查。
版本紀錄如何支援團隊交接？
SlashDocs 保留每次文件版本，讓團隊能回到修改前的內容，理解報告如何從初稿變成定稿。
這對多人與代理協作特別有用。若只有一份不斷覆蓋的最新檔，舊內容與修改原因可能很快就失去依據。
公開倉庫描述不可變的版本紀錄，也有處理同時修改的機制。用白話說，系統會辨認使用者修改的是哪個版本，避免忽略其他人的新變更。
這項能力不能代替團隊協調。同一段如果收到方向相反的意見，仍需有人做決定，再讓修改者依確認後的要求處理。
儲存內容版本也要儲存資料條件
例如報告引用某天查詢到的價格，新版本再查到不同結果。除了儲存內容，也應在文字裡交代日期與比較條件。
版本能告訴你文字變了，卻不會自動證明新資料是對的。外部來源與查詢口徑，仍需要隨修訂留下。
定稿後也可以保留誰確認過哪些部分，方便日後更新。這是建議的團隊安排，沒有假設平台替所有組織定義了相同流程。
權限為什麼不能等部署後才想？
檢視、評論與編輯是不同責任。分享報告給讀者，通常只需要讀取或評論能力，不必同時開放修改權。
公開倉庫把新文件的預設分享設為私人，也讓組織依需求調整。開始試行時，要確認本次部署實際採用哪一種設定。
如果團隊需要公開檢閱，應明確指定可看的人與範圍。固定連結方便協作，仍要和帳號及分享權限配合使用。
代理連線權限要符合工作
代理可能需要讀評論與發布新版本，但未必需要管理所有文件。應依任務決定能處理的範圍，減少不必要的權限。
官方服務提供人類登入與代理服務帳號兩種途徑。服務帳號是給自動工作使用的身分，不應和個人登入憑證混在一起。
倉庫也說明部分憑證建立工作不透過 MCP 提供。這反映平台有自己的管理界線，不能因為代理能讀文件，就推論它能做所有設定。
文件與評論內容同樣需要判斷。代理讀到一段要求時，仍要確認是否符合原本任務，避免把文件內任何文字都當成操作授權。
自架部署要先看什麼？
SlashDocs 是自架平台，資料放在自己的基礎設施。這讓團隊可以決定儲存位置，也代表執行、更新與備份需要自己安排。
2026 年 10 月 13 日查閱倉庫時，伺服器以 Go 程式整合前端與服務，並使用資料庫和相容的物件儲存評論、權限與文件版本。
「單一程式部署」描述的是應用形式，後面仍有資料儲存與身分登入的需求。團隊要把這些服務一起納入維護計畫。
開發快速啟動與正式環境不同
官方快速啟動提供開發用的登入與配套服務，適合確認流程。正式環境則需要接上組織採用的身分服務與部署設定。
因此，試行時可以先用非敏感報告跑一輪，確認分享、評論、修訂與版本回查，再討論正式資料與帳號管理。
不要只因首頁寫自架，就認定每一項外部工具都沒有資料傳出。連線的 AI 工具如何處理文件，仍要依自己的模型服務設定核對。
HTML 顯示需要和主應用隔離
HTML 可能包含互動程式，倉庫要求文件在隔離的框架裡顯示，並將主要應用與文件顯示放在不同主機名稱。
這個安排的用途，是讓文件內容和使用者登入狀態保持界線。官方特別說明，同一主機只換連線埠，不能達到相同的隔離效果。
對一般讀者，這是部署前需要交給維護者確認的條件。對自架團隊，則要照官方文件設定，避免只完成畫面而漏掉執行前提。
備份要能涵蓋一整份工作紀錄
報告、版本與評論彼此相關。備份若只儲存最新 HTML，可能無法還原原本的回饋與權限，團隊應先定義要恢復哪些內容。
可以用測試文件確認儲存與還原流程，再決定保留多久。這是部署建議，不代表本文已對平台完成實際備份測試。
MIT 授權提供使用與修改原始碼的空間，並不消除維護責任。團隊仍要安排更新、帳號管理與故障處理。
怎麼知道協作真的改善了？
第一次試用可以觀察回饋是否找到正確位置、修訂是否對準意見，以及確認新版本花了多少時間。這比只記錄建立文件的速度更有意義。
例如團隊原本需要把每則留言複製到聊天，現在能直接從文件讀取。節省的是交接步驟，最終資料查證仍需要另外完成。
用一則評論測完整流程
建議選一個容易核對的修改，例如把報告中的過期數字更新為同日官方資料，再檢查正文與圖表是否一致。這是試行方法，並非實測紀錄。
提出評論的人可以確認新版本，並檢視討論回覆是否說明修改原因。如果只有狀態變成已完成，卻找不到新文字，就還不足以驗收。
也可以重新開啟一則未處理完整的意見，確認後續修改仍接在原討論裡。這能測出團隊最常遇到的來回修訂是否有清楚入口。
固定連結要讓接手者容易辨認版本
分享給新成員時，可以請他只依文件和討論紀錄理解修訂。如果仍需要另外口頭解釋大量背景，就要補足來源或回覆內容。
這份觀察能幫團隊決定是否擴大。若已減少漏改和找錯版本，繼續試行有依據；若只是換了報告展示方式，就應先調整協作規則。
SlashDocs 常見問題
它是 AI 模型嗎？
它主要提供文件協作與代理連線方式。模型能力來自連線的 AI 工具，平台儲存文件和回饋，不保證每份報告都正確。
開源是否代表不用維護？
自架仍需要更新、備份與權限管理。原始碼可檢視與修改，執行責任仍由部署者承擔。
審稿者一定要會寫程式嗎？
官方把讀取與評論設計成瀏覽器操作。部署與代理連線需要技術設定，日常審查則可以從開啟連結與定位留言開始。
最適合先試什麼？
可以選一份非敏感的短報告，走完分享、評論、修訂與版本回查。先確認回饋能被正確處理，再引入團隊資料。
從一則能回查的修改意見開始
SlashDocs 把報告與回饋留在相同協作位置，讓代理修訂更容易保留依據。它適合評估經常產生互動文件、又需要多人審查的工作。
挑一份可分享的報告，留下有來源的具體意見，再檢查新版本與回覆。這一輪若能減少複製貼上與漏改，就有繼續試用的理由。
延伸閱讀：AI 創業機會在哪？Alexandr Wang 談小團隊如何把模型能力變成生意
延伸閱讀：Sakana AI MASS 是什麼？讓模型從代理團隊學習的自我改進研究
