？測試貢獻、PR流程與安全漏洞披露完整指南)
如何參與OrgKernel開源開發(fā)測試貢獻、PR流程與安全漏洞披露完整指南【免費下載鏈接】OrgKernelOpen-source trust layer for AI agents — cryptographic agent identity (Ed25519), instance-scoped execution tokens, SHA-256 hash-chained audit logging, and enterprise SSO/SCIM federation. The security foundation powering every agent in the Metaprise AURA platform.項目地址: https://gitcode.com/gh_mirrors/or/OrgKernelOrgKernel 是一個面向 AI Agent 的開源信任層項目——它為每個智能體提供 Ed25519 加密身份、實例級執(zhí)行令牌和 SHA-256 哈希鏈審計日志是企業(yè)級 AI Agent 平臺的安全基石。本文為新手提供一份完整指南從零搭建 OrgKernel 開發(fā)環(huán)境、完成第一次測試貢獻、走通標準 PR 流程并正確地進行安全漏洞披露 一、為什么新手適合從 OrgKernel 開始開源之旅OrgKernel 采用 Apache 2.0 協(xié)議開源代碼完全透明可逐行審查其密碼學實現(xiàn)。項目結(jié)構(gòu)清晰、模塊邊界明確非常適合第一次提交 PR 的開發(fā)者特點說明 范圍聚焦第一階段僅 3 個核心模塊改動目標明確不會迷路 高測試覆蓋v1.0.0 已內(nèi)置 61 個測試用例100% 通過見 CHANGELOG.md 規(guī)范清晰編碼規(guī)范、分支命名、PR 要求均有成文標準 門檻適中Python 3.10 即可參與無需部署 AI 模型??貢獻范圍須知OrgKernel 目前僅接受三大核心模塊相關(guān)的貢獻超出范圍的改動需先與維護者討論否則可能無法被接收。完整規(guī)則見 CONTRIBUTING.md。二、OrgKernel 開發(fā)環(huán)境搭建克隆倉庫與安裝依賴參與 OrgKernel 開源開發(fā)前先確認本地滿足 3 個前提條件Python 3.10推薦 3.12數(shù)據(jù)庫PostgreSQL 18.1 / MySQL / SQLite本地開發(fā)用 SQLite 即可Git接下來 5 行命令完成環(huán)境搭建git clone https://gitcode.com/gh_mirrors/or/OrgKernel cd OrgKernel python -m venv .venv source .venv/bin/activate # Windows 系統(tǒng)請改用.venv\Scripts\activate pip install -e .[dev]?.[dev]會一次性裝齊開發(fā)依賴pytest、pytest-asyncio、httpx、ruff、mypy定義見 pyproject.toml開箱即可寫代碼、跑測試、做靜態(tài)檢查。三、認識三大核心模塊先選對貢獻方向在動手前花 5 分鐘了解 OrgKernel 的三個核心原語能幫你判斷哪個 issue 最適合自己模塊職責主要源碼AgentIdentity加密身份Ed25519 密鑰對生成、組織 CA 證書簽發(fā)、質(zhì)詢-響應認證、吊銷/暫停/恢復生命周期agent_identity_service.pyExecutionToken執(zhí)行令牌工具白名單、數(shù)值參數(shù)邊界、Ed25519 簽名防令牌嫁接攻擊、一次性消費execution_token_service.pyAuditChain審計鏈三層L1 業(yè)務 / L2 執(zhí)行 / L3 合規(guī)SHA-256 哈希鏈審計日志與完整性校驗audit_chain_service.py配套代碼位置速查數(shù)據(jù)模型Pydanticsrc/orgkernel/schemas/密碼學工具函數(shù)crypto_utils.pyREST 接口27 個端點router.py關(guān)鍵約定Schema 文件是數(shù)據(jù)結(jié)構(gòu)的唯一事實來源Python 模型只是參考實現(xiàn)——任何影響 Schema 的改動必須兩處同步更新。四、測試貢獻入門運行 OrgKernel 測試套件讓所有測試通過是項目對每次貢獻的硬性要求也是新手驗證自己環(huán)境是否搭好的最快方式# 運行全部測試 python -m pytest tests/ # 或按模塊單獨運行 python -m pytest tests/test_agent_identity.py python -m pytest tests/test_execution_token.py python -m pytest tests/test_audit_chain.py對新手友好的一步步上手路徑修文檔docs/分支錯別字、表述不清的地方零風險首秀補測試test/分支為某個函數(shù)補邊界用例例如令牌過期、參數(shù)越界等場景修 Bugfix/分支挑一個帶[Bug]標記的 issue附最小復現(xiàn)用例五、OrgKernel 標準 PR 流程從分支命名到合并官方貢獻流程固定 5 步照做即可步驟操作說明1??Fork 倉庫復制到你自己的賬號下2??從main創(chuàng)建分支命名有講究見下方規(guī)范3??修改代碼必須同步新增或更新測試4??跑通全部測試python -m pytest tests/5??提交 Pull Request描述中說明改動動機分支命名規(guī)范按用途前綴feat/— 新功能fix/— Bug 修復docs/— 僅文檔改動test/— 僅測試改動PR 審核的硬性要求所有 PR 必須指向main分支至少獲得 1 位維護者的 Review新代碼必須附帶測試項目保持高測試覆蓋率影響公共 API 或 Schema 的改動需同步更新文檔PR 描述中引用相關(guān) issue如Fixes #42六、編碼規(guī)范速查表讓 PR 一次通過審查維護者 Review 時重點看這些提交前自查一遍可大幅減少往返? 遵循PEP 8本地 ruff 已按項目規(guī)則配置好直接ruff check即可? 所有公共函數(shù)和類屬性寫類型提示type hints? 公共類和方法必須有docstring并注明對應的 Schema 章節(jié)? 數(shù)據(jù)模型統(tǒng)一使用Pydantic v2禁止 v1 寫法? 函數(shù)保持小而聚焦——每個模塊只做一件事絕不提交密鑰、API Key 或憑據(jù)——一律走環(huán)境變量 ID 字段使用固定前綴aid_身份、tok_令牌、ac_審計鏈、aue_審計條目不要自創(chuàng)前綴七、如何向 OrgKernel 報告 Bug 與功能建議報告 Bug[Bug] 前綴提交 issue 時請包含 5 要素信息越全修復越快清晰標題以[Bug]開頭復現(xiàn)步驟期望行為 vs 實際行為環(huán)境信息操作系統(tǒng)、Python 版本、數(shù)據(jù)庫類型與版本相關(guān)日志/報錯能附最小復現(xiàn)測試用例會大大加分提交功能建議enhancement 標簽說明四點關(guān)聯(lián)三大原語中的哪一個、要解決的問題、你提出的方案、考慮過的替代方案。?? 超出三大核心原語范圍的請求若沒有充分論證會被直接關(guān)閉。八、OrgKernel 安全漏洞披露負責任披露渠道與響應時間線由于 OrgKernel 處理的是企業(yè)級加密身份與審計基礎(chǔ)設施安全漏洞有專門的披露通道規(guī)則與一般項目完全不同?切勿通過公開 issue 報告安全漏洞請通過郵件進行負責任披露developermetaprise.ai完整政策見 SECURITY.md。報告應包含 4 項內(nèi)容漏洞描述及其潛在影響復現(xiàn)步驟概念驗證PoC代碼或截圖你建議的修復方案如有官方響應時間線階段時限確認收到報告48 小時內(nèi)初步評估5 個工作日內(nèi)修復時間表初步評估后告知公開披露修復發(fā)布后與報告人協(xié)同進行受理范圍Ed25519 身份生成/證書簽發(fā)/質(zhì)詢-響應、執(zhí)行令牌簽名與驗證、令牌嫁接攻擊向量、審計鏈完整性與哈希鏈邏輯、SSO/SAML 集成、SCIM 配置邏輯。不在受理范圍第三方依賴漏洞請向?qū)S護者報告、需要物理接觸基礎(chǔ)設施的問題、社會工程學攻擊。 經(jīng)確認的漏洞報告人在獲得本人同意后將在版本發(fā)布說明中獲得致謝。九、新手貢獻路線圖按順序完成的 6 步清單最后用一張清單收尾跟著走就能完成第一次貢獻 Fork 并克隆倉庫進入OrgKernel目錄創(chuàng)建虛擬環(huán)境并pip install -e .[dev]python -m pytest tests/全部測試通過瀏覽三大模塊源碼認領(lǐng)一個 issue或提一個功能建議按feat/、fix/、docs/、test/規(guī)范建分支改動測試一起提交 PR響應維護者 Review 意見合并進mainOrgKernel 是一個靠透明贏得信任的項目——你的每一行貢獻都在讓 AI Agent 的信任層更堅固。歡迎從今天的第一次測試運行開始 【免費下載鏈接】OrgKernelOpen-source trust layer for AI agents — cryptographic agent identity (Ed25519), instance-scoped execution tokens, SHA-256 hash-chained audit logging, and enterprise SSO/SCIM federation. The security foundation powering every agent in the Metaprise AURA platform.項目地址: https://gitcode.com/gh_mirrors/or/OrgKernel創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 如何參與OrgKernel開源開發(fā)？測試貢獻、PR流程與安全漏洞披露完整指南
如何參與OrgKernel開源開發(fā)測試貢獻、PR流程與安全漏洞披露完整指南【免費下載鏈接】OrgKernelOpen-source trust layer for AI agents — cryptographic agent identity (Ed25519), instance-scoped execution tokens, SHA-256 hash-chained audit logging, and enterprise SSO/SCIM federation. The security foundation powering every agent in the Metaprise AURA platform.項目地址: https://gitcode.com/gh_mirrors/or/OrgKernelOrgKernel 是一個面向 AI Agent 的開源信任層項目——它為每個智能體提供 Ed25519 加密身份、實例級執(zhí)行令牌和 SHA-256 哈希鏈審計日志是企業(yè)級 AI Agent 平臺的安全基石。本文為新手提供一份完整指南從零搭建 OrgKernel 開發(fā)環(huán)境、完成第一次測試貢獻、走通標準 PR 流程并正確地進行安全漏洞披露 一、為什么新手適合從 OrgKernel 開始開源之旅OrgKernel 采用 Apache 2.0 協(xié)議開源代碼完全透明可逐行審查其密碼學實現(xiàn)。項目結(jié)構(gòu)清晰、模塊邊界明確非常適合第一次提交 PR 的開發(fā)者特點說明 范圍聚焦第一階段僅 3 個核心模塊改動目標明確不會迷路 高測試覆蓋v1.0.0 已內(nèi)置 61 個測試用例100% 通過見 CHANGELOG.md 規(guī)范清晰編碼規(guī)范、分支命名、PR 要求均有成文標準 門檻適中Python 3.10 即可參與無需部署 AI 模型??貢獻范圍須知OrgKernel 目前僅接受三大核心模塊相關(guān)的貢獻超出范圍的改動需先與維護者討論否則可能無法被接收。完整規(guī)則見 CONTRIBUTING.md。二、OrgKernel 開發(fā)環(huán)境搭建克隆倉庫與安裝依賴參與 OrgKernel 開源開發(fā)前先確認本地滿足 3 個前提條件Python 3.10推薦 3.12數(shù)據(jù)庫PostgreSQL 18.1 / MySQL / SQLite本地開發(fā)用 SQLite 即可Git接下來 5 行命令完成環(huán)境搭建git clone https://gitcode.com/gh_mirrors/or/OrgKernel cd OrgKernel python -m venv .venv source .venv/bin/activate # Windows 系統(tǒng)請改用.venv\Scripts\activate pip install -e .[dev]?.[dev]會一次性裝齊開發(fā)依賴pytest、pytest-asyncio、httpx、ruff、mypy定義見 pyproject.toml開箱即可寫代碼、跑測試、做靜態(tài)檢查。三、認識三大核心模塊先選對貢獻方向在動手前花 5 分鐘了解 OrgKernel 的三個核心原語能幫你判斷哪個 issue 最適合自己模塊職責主要源碼AgentIdentity加密身份Ed25519 密鑰對生成、組織 CA 證書簽發(fā)、質(zhì)詢-響應認證、吊銷/暫停/恢復生命周期agent_identity_service.pyExecutionToken執(zhí)行令牌工具白名單、數(shù)值參數(shù)邊界、Ed25519 簽名防令牌嫁接攻擊、一次性消費execution_token_service.pyAuditChain審計鏈三層L1 業(yè)務 / L2 執(zhí)行 / L3 合規(guī)SHA-256 哈希鏈審計日志與完整性校驗audit_chain_service.py配套代碼位置速查數(shù)據(jù)模型Pydanticsrc/orgkernel/schemas/密碼學工具函數(shù)crypto_utils.pyREST 接口27 個端點router.py關(guān)鍵約定Schema 文件是數(shù)據(jù)結(jié)構(gòu)的唯一事實來源Python 模型只是參考實現(xiàn)——任何影響 Schema 的改動必須兩處同步更新。四、測試貢獻入門運行 OrgKernel 測試套件讓所有測試通過是項目對每次貢獻的硬性要求也是新手驗證自己環(huán)境是否搭好的最快方式# 運行全部測試 python -m pytest tests/ # 或按模塊單獨運行 python -m pytest tests/test_agent_identity.py python -m pytest tests/test_execution_token.py python -m pytest tests/test_audit_chain.py對新手友好的一步步上手路徑修文檔docs/分支錯別字、表述不清的地方零風險首秀補測試test/分支為某個函數(shù)補邊界用例例如令牌過期、參數(shù)越界等場景修 Bugfix/分支挑一個帶[Bug]標記的 issue附最小復現(xiàn)用例五、OrgKernel 標準 PR 流程從分支命名到合并官方貢獻流程固定 5 步照做即可步驟操作說明1??Fork 倉庫復制到你自己的賬號下2??從main創(chuàng)建分支命名有講究見下方規(guī)范3??修改代碼必須同步新增或更新測試4??跑通全部測試python -m pytest tests/5??提交 Pull Request描述中說明改動動機分支命名規(guī)范按用途前綴feat/— 新功能fix/— Bug 修復docs/— 僅文檔改動test/— 僅測試改動PR 審核的硬性要求所有 PR 必須指向main分支至少獲得 1 位維護者的 Review新代碼必須附帶測試項目保持高測試覆蓋率影響公共 API 或 Schema 的改動需同步更新文檔PR 描述中引用相關(guān) issue如Fixes #42六、編碼規(guī)范速查表讓 PR 一次通過審查維護者 Review 時重點看這些提交前自查一遍可大幅減少往返? 遵循PEP 8本地 ruff 已按項目規(guī)則配置好直接ruff check即可? 所有公共函數(shù)和類屬性寫類型提示type hints? 公共類和方法必須有docstring并注明對應的 Schema 章節(jié)? 數(shù)據(jù)模型統(tǒng)一使用Pydantic v2禁止 v1 寫法? 函數(shù)保持小而聚焦——每個模塊只做一件事絕不提交密鑰、API Key 或憑據(jù)——一律走環(huán)境變量 ID 字段使用固定前綴aid_身份、tok_令牌、ac_審計鏈、aue_審計條目不要自創(chuàng)前綴七、如何向 OrgKernel 報告 Bug 與功能建議報告 Bug[Bug] 前綴提交 issue 時請包含 5 要素信息越全修復越快清晰標題以[Bug]開頭復現(xiàn)步驟期望行為 vs 實際行為環(huán)境信息操作系統(tǒng)、Python 版本、數(shù)據(jù)庫類型與版本相關(guān)日志/報錯能附最小復現(xiàn)測試用例會大大加分提交功能建議enhancement 標簽說明四點關(guān)聯(lián)三大原語中的哪一個、要解決的問題、你提出的方案、考慮過的替代方案。?? 超出三大核心原語范圍的請求若沒有充分論證會被直接關(guān)閉。八、OrgKernel 安全漏洞披露負責任披露渠道與響應時間線由于 OrgKernel 處理的是企業(yè)級加密身份與審計基礎(chǔ)設施安全漏洞有專門的披露通道規(guī)則與一般項目完全不同?切勿通過公開 issue 報告安全漏洞請通過郵件進行負責任披露developermetaprise.ai完整政策見 SECURITY.md。報告應包含 4 項內(nèi)容漏洞描述及其潛在影響復現(xiàn)步驟概念驗證PoC代碼或截圖你建議的修復方案如有官方響應時間線階段時限確認收到報告48 小時內(nèi)初步評估5 個工作日內(nèi)修復時間表初步評估后告知公開披露修復發(fā)布后與報告人協(xié)同進行受理范圍Ed25519 身份生成/證書簽發(fā)/質(zhì)詢-響應、執(zhí)行令牌簽名與驗證、令牌嫁接攻擊向量、審計鏈完整性與哈希鏈邏輯、SSO/SAML 集成、SCIM 配置邏輯。不在受理范圍第三方依賴漏洞請向?qū)S護者報告、需要物理接觸基礎(chǔ)設施的問題、社會工程學攻擊。 經(jīng)確認的漏洞報告人在獲得本人同意后將在版本發(fā)布說明中獲得致謝。九、新手貢獻路線圖按順序完成的 6 步清單最后用一張清單收尾跟著走就能完成第一次貢獻 Fork 并克隆倉庫進入OrgKernel目錄創(chuàng)建虛擬環(huán)境并pip install -e .[dev]python -m pytest tests/全部測試通過瀏覽三大模塊源碼認領(lǐng)一個 issue或提一個功能建議按feat/、fix/、docs/、test/規(guī)范建分支改動測試一起提交 PR響應維護者 Review 意見合并進mainOrgKernel 是一個靠透明贏得信任的項目——你的每一行貢獻都在讓 AI Agent 的信任層更堅固。歡迎從今天的第一次測試運行開始 【免費下載鏈接】OrgKernelOpen-source trust layer for AI agents — cryptographic agent identity (Ed25519), instance-scoped execution tokens, SHA-256 hash-chained audit logging, and enterprise SSO/SCIM federation. The security foundation powering every agent in the Metaprise AURA platform.項目地址: https://gitcode.com/gh_mirrors/or/OrgKernel創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考