安德里亞·格蘭迪Andrea Grandi——軟件開發(fā)工程師1. GitHub2. Mastodon3. 領英LinkedIn4. RSS1. 主頁2. 關于3. 履歷在ko-fi.com上請我喝杯咖啡開發(fā) 社區(qū) 個人觀點為何“圖書角Book Corners”不會將貢獻同步回開放街圖OpenStreetMap原本希望“圖書角”能將新提交的公共書架信息反饋給開放街圖但研究運營和社區(qū)要求后決定不實施該功能。2026年7月31日一個看似不錯的功能介紹 圖書角 時提到其初始數據大多來自 開放街圖開放街圖為項目提供了很好的起點全球已有數千個公共書架被標注在上面。“圖書角”接受用戶直接提交新的圖書館信息用戶提交位置和照片經審核后貢獻會公開。所以當開放街圖缺少這些提交信息時“圖書角”將其反饋回去看似理所應當。設想的工作流程很謹慎- 提交圖書館信息的用戶需明確同意進行反饋。- 管理員首先對圖書館信息進行審核。- “圖書角”會在開放街圖中搜索可能的重復信息。- 管理員會預覽要發(fā)送的確切數據。- 直到管理員確認后才會進行寫入操作。從軟件開發(fā)角度看這似乎是易于管理的集成添加用戶同意選項、跟蹤貢獻狀態(tài)、構建預覽、與開放街圖進行身份驗證并通過其API創(chuàng)建新的地理特征。其實編寫代碼并非最困難的部分。貢獻數據并非僅僅調用API那么簡單認真研究具體實現時發(fā)現調用API寫入數據只是工作的一小部分。由于信息來自“圖書角”數據庫開放街圖可能將其視為外部數據導入。而且盡管每個圖書館信息都要經過管理員審核但因是軟件準備和提交更改也可能符合腳本輔助或自動編輯的規(guī)則。嚴格遵循 開放街圖導入指南 和 自動編輯行為準則所需不止一個專用賬戶和OAuth令牌。首次正式貢獻前需要- 創(chuàng)建并維護一個專用的開放街圖導入賬戶。- 在開放街圖維基上發(fā)布詳細的導入計劃。- 記錄數據源、許可協議、字段映射、重復檢測、使用的軟件、質量檢查、變更集策略以及回滾程序。- 在開放街圖社區(qū)論壇上提出提案。- 聯系受這些貢獻影響的相關本地社區(qū)。- 等待審核期結束并解決所有問題。- 保留導入賬戶、計劃、討論和變更集之間的永久鏈接。- 為未來的問題或投訴提供聯系方式和退出途徑。此外還有重要的許可問題。用戶同意將圖書館信息發(fā)送到開放街圖不意味著就自動擁有以符合開放街圖要求的條款發(fā)布這些事實信息的明確權利。面向用戶的說明和同意書需要涵蓋這一區(qū)別包括確認信息并非來自不兼容的數據源。這些要求并非一次性表格填寫后就可置之不理意味著要對賬戶、記錄的流程、社區(qū)反饋、失敗情況以及可能的回滾操作承擔持續(xù)的責任。理解規(guī)則存在的原因開放街圖是共享的全球數據庫一次糟糕的導入可能造成數千個重復信息覆蓋更準確的本地知識或引入一旦被其他人編輯就難以消除的錯誤。從這個角度看要求提供文檔、明確許可協議、處理重復信息、明確責任人和進行社區(qū)討論是合理的。開放街圖社區(qū)必須保護地圖數據的質量良好的意愿并不能保證數據的質量。“圖書角”本身也受益于這種數據質量。如果期望開放街圖在沒有保障措施的情況下接受外部服務的更改那將是虛偽的。與此同時這個過程確實需要付出成本。它要求一個小項目不僅要成為API客戶端還要成為有文檔記錄的導入項目的運營者。這對于導入大型數據集的組織來說可能合適但對于僅旨在將少數經過仔細審核的公共書架信息反饋給公共數據庫的低流量功能來說是相當大的承諾。運營成本超過了功能價值“圖書角”的目標很簡單幫助人們發(fā)現小型免費圖書館并與他人分享新的圖書館信息。運營一個向開放街圖貢獻數據的流程并非其核心目標。這將需要添加憑證管理、生產保障措施、審計和對賬代碼、社區(qū)流程、許可工作以及長期支持義務。雖然每個部分單獨看都有合理性但綜合起來這個功能比最初設想的要復雜得多。此外還有機會成本。花在運營這個集成上的時間就不能用于改進圖書館發(fā)現功能、審核流程、照片展示、可訪問性、翻譯或移動應用體驗。這些改進能直接幫助“圖書角”的用戶而且對于一個小項目來說更容易維持。起初認為將數據反饋回去是既友好又公平的事情。但深入研究后意識到僅憑善意不足以承擔一個無期限的運營責任。最終決策決定無限期擱置向開放街圖寫回數據功能的開發(fā)。“圖書角”將繼續(xù)注明從開放街圖導入的記錄來源并且不會將從開放街圖導入的圖書館信息當作新信息再次提交。但用戶直接貢獻給“圖書角”的圖書館信息將保留在“圖書角”中該服務不會自動或手動在開放街圖中創(chuàng)建對應的地理特征。目前“圖書角”沒有向開放街圖正式環(huán)境寫入數據的功能因此暫停這項工作無需禁用或遷移現有的集成。如果未來有真正輕量級的工作流程出現或者“圖書角”的貢獻規(guī)模和價值最終能夠證明這個流程的合理性可能會重新考慮這個決定。另一種可能是采用用戶驅動的工作流程在現有的開放街圖編輯器中打開提議的地理特征但這仍需要與社區(qū)進行討論而不能將其視為繞過規(guī)則的方法。目前負責任的選擇是不開發(fā)和運營一個沒有信心能夠妥善支持的功能。有時不做功能才是正確的選擇人們往往容易將實現決策單純視為技術問題API能否實現、應用程序能否進行身份驗證、代碼能否避免重復等。這次經歷提醒外部集成還涉及組織和社會契約。有時候這些契約的成本比代碼本身還要高。在部署之前發(fā)現這一點是有價值的盡管結果可能令人失望。仍然認為將數據反饋給共享的開源項目是有價值的也理解開放街圖為何如此謹慎地保護其數據庫。但就目前的“圖書角”而言收益和責任之間的平衡并不理想。所以這是選擇不推出的一個功能。如果你喜歡這篇文章并想表達支持可以點擊下面的按鈕請我喝杯咖啡。你的支持哪怕只是一個小小的舉動都意義重大會激勵我繼續(xù)在博客上撰寫和分享更多文章 ??在ko-fi.com上請我喝杯咖啡 圖書角Book - Corners 開放街圖Openstreetmap 開放數據Open - Data 開源Open - Source 社區(qū)Community 產品決策Product - Decisions相關內容- 圖書角 - 發(fā)現并分享全球小型免費圖書館- 發(fā)布支持代理技能的Obsidian會議記錄同步工具- 宣布mcp - wire 0.3.0版本發(fā)布- 為何要為已有上下文命令的CLI添加代理技能- 發(fā)布mb - cli 0.3.0用于Metabase API的只讀CLI工具