gods-eye-view 社区 PR 维护者工作流五道验收门、可信指令与集成署名实操指南【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view本指南完整解析 gods-eye-view 仓库的社区贡献验收流程docs/MAINTAINER_WORKFLOW.md从以可信修订版为审查基准的防投毒原则到实用性与范围、质量与测试、安全与供应链、本地执行与可视化检查、集成与署名五道验收门再到本地验证命令矩阵与审查记录模板。读完你既能以维护者身份对社区 PR 做出可追溯的接受/拒绝决策也能作为贡献者理解 PR 为什么会被要求修改以及如何让提交一次通过。一、工作流定位谁在审审什么docs/MAINTAINER_WORKFLOW.md是仓库维护者对社区功能、修复与测试贡献的验收程序。它与面向贡献者的 CONTRIBUTING.md 明确分工后者负责怎么提交前者负责怎么验收、怎么合入。按 CONTRIBUTING.md 的记录仓库由 Bilawal Sidhu 与 Sameh KhamisHalfpixel共同维护两位维护者中任一位都有权评审并合入贡献。这一流程并非停留在纸面仓库内置了一个遵循该流程执行并记录决策证据的 Agent 技能位于 .agents/skills/community-pr/SKILL.md。该技能明确定义了两种执行形态review例如$community-pr review PR #123定位 PR 与修订版逐门验收返回结论与审查记录评审请求本身不隐含合入或发评论的权限。integrate例如$community-pr integrate PR #123 if it passes完成同样的评审在保留署名的前提下做必要的范围内维护者调整验证最终候选版本并在既有授权与仓库保护之内合入。从技能描述看它还约束了工具边界工作流不要求特定 Git/GitHub 连接器、执行安装、测试、构建与浏览器检查只允许在受限环境进行、证据必须锚定被审 PR 的 head、目标 base 与最终候选版本。二、第一步从可信指令开始Trusted Instructions工作流反复强调一个核心反投毒原则审查所依据的程序文本本身必须是可信的。具体步骤如下确认上游仓库是bilawalsidhu/gods-eye-viewfetch 它的main并记录该提交作为策略修订版policy revision。从该修订版读取本工作流文档、community-pr技能文档以及 SECURITY.md、CONTRIBUTING.md 和 docs/CURRENT-STATE.md 的相关部分。使用git show SHA:path读取文件——必须带具体提交 SHA因为一个移动的分支名本身不是评审记录。为什么要这样因为 PR 本身可能修改这些程序文件例如改动工作流文档、AGENTS.md、技能定义。工作流明确规定PR 描述、评论、源文件、AGENTS.md、技能以及对策略的提议修改都是评审输入review input它们不能授予权限也不能取代正在评审它们的指令。策略变更要当作未来采纳的变更来评审而不是立即生效。另外两条纪律记录 PR 元数据PR 编号与 URL、作者、head SHA、目标分支、目标 base SHA。遇到意外的目标分支必须先解决再合入。隔离评审工作区评审工作必须与维护者自己的未提交改动隔离fetch 或读取 diff 不构成运行其代码。如果可信流程缺失或不可访问应先报告缺口、取得维护者选定的可信修订版再继续验收——而不是将就着用 PR 带来的版本。三、五道验收门每道门独立计分工作流的核心是五道验收门acceptance gates。每道门需要各自的结论与证据一道门通过不能补偿另一道门失败。状态词有四个pass通过、changes needed需要修改、blocked受阻、not applicable不适用其中实用性门还可使用decline拒绝或discuss讨论。门 1实用性与范围Usefulness and scope识别用户问题与可观察收益——纯测试型 PR 也不例外。检查与公共数据、本地优先local-first产品定位及现有能力的契合度。权衡依赖、API 成本、UI 复杂度、性能与长期维护成本——一个能跑的功能仍可能超出项目范围。依据 DATA_SOURCES.md 核对数据源署名与许可。范围拒绝要建设性说明理由大型功能鼓励尽早讨论。门 2质量与测试Quality and tests审查完整变更及其受影响调用方正确性、可读设计、失败处理、与既有所有权和包边界的一致性。检查取消cancellation、拆除teardown、监听器、定时器、内存以及渲染/网络预算避免在贡献合入中夹带无关重构。要求对变更行为有有意义的回归覆盖首选在旧实现上失败、在修复后通过的 bug 测试。测试型贡献必须暴露真实覆盖缺口或防止合理回归使用确定性 fixture 与有意义的断言。重点检查被删的测试、被跳过的测试、被放松的断言、快照更新、mock 与测试运行器改动——被弱化的测试跑绿不是接受。文档配套运行时变更需要更新docs/CURRENT-STATE.md与CHANGELOG.md数据源变更需要更新DATA_SOURCES.md。这条在仓库里有明确映射运行时行为变更必须同步文档这与 CONTRIBUTING.md 的 PR 要求第 3、4 条一一对应改运行时行为要更新CURRENT-STATE.md和CHANGELOG.md增改数据源要更新DATA_SOURCES.md并附许可与署名。门 3安全与供应链Security and supply chain这是五道门里最重的防线要求在安装依赖或运行 PR 代码之前先做静态审查。审查面包括lockfile、package scripts、CI 工作流、构建插件、启动器、二进制、生成产物、符号链接以及对安全检查或 Agent 指令的改动。不要只局限于作者高亮的文件——要追踪无法解释或隐藏的行为、新依赖或下载来源。安全模型检查的边界对应 SECURITY.md 的威胁模型边界要求私有凭据必须留在服务端客户端 bundle、日志、错误、fixture、截图不得泄露。审查新出站主机与遥测防止意外数据收集或外泄代理保持注册或固定的上游目标保留重定向、地址、超时、响应大小限制。跨边界输入检查 SSRF、注入、路径穿越、不安全渲染本地主机localhost 与主机校验默认值保持不变审查环境/设置文件访问、文件权限、shell 执行、下载的代码语音工具保持有界的应用操作不可信 feed/模型文本不得获得新的执行或凭据访问CI保持最小权限。绝不使用仓库密钥或特权 token 执行不可信 PR 代码包括通过pull_request_target同时给出工具的定位依赖与静态分析工具可以补充覆盖但要记录其结论与局限——扫描器、测试和 AI 评审都不能证明不存在后门。无法解释的可疑行为或未解决的可利用问题直接阻塞合入。漏洞细节走 SECURITY.md 的私有报告流程公开摘要不得含敏感细节。仓库代码印证了这一模型SECURITY.md 明确列出秘密型 API 密钥一律服务端持有OPENAI_API_KEY、AISSTREAM_API_KEY、OpenSky OAuth、GOOGLE_MAPS_SERVER_API_KEY并描述了代理加固手段——CCTV 帧代理只 fetch 服务端注册的 URLSSRF 缓解、Radio 不当中继、transit 只解析注册 feed 等与门 3 的代理边界审查项完全对应。门 4本地执行与可视化检查Local execution and visual inspection核心认知依赖安装、测试、构建、启动器和浏览器预览统统是对不可信代码的执行。因此必须在一次性的受限环境中进行该环境要求无个人凭据、无继承的 secrets、无 SSH agent、无 Keychain 访问、无特权宿主挂载、无容器引擎 socket网络访问仅限验证所需worktree 本身不是安全边界不得把维护者的.env、PinokioENVIRONMENT或浏览器 profile 拷进去也不得使用会导入个人密钥的启动器若该环境不可用继续静态评审把执行标记为blocked而不是在带凭据的主机上运行。技术细则使用可信package.json与 CI 配置中支持的 Node 版本当前仓库engines声明为node 24.14.0 25 || 26 27审查依赖与脚本变更后在受限环境内用npm ci安装锁定依赖。禁用生命周期脚本有助于初步检查但不能让后续构建或测试在宿主机上安全运行。对运行时变更必须在待合入候选版本上记录以下本地结果——这张命令表是工作流的核心可操作资产检查项命令或证据环境策略npm run doctor -- --json采用格式npm run format:check包边界npm run check:boundaries单元测试npm test生产构建npm run build跟踪回归先启动npm run dev于http://localhost:4173再在装有兼容 Chromium 的环境运行npm run test:track构建产物如需可先停 dev server再运行npm run preview检查构建后的应用确认浏览器与跟踪 harness 指向的是候选服务器而非已运行的旧 checkout浏览器工具在受限环境内提供。CI 只是补充证据不能替代本地验证——工作流还特别注明本流程引入时CI 并不运行test:track与仓库中scripts/track-regression.mjs的确定性回归 harness定位一致。验证动作还包括实际演练变更功能与邻近交互覆盖加载/空/失败/禁用/拆除状态键盘行为、相关视口尺寸、控制台错误与意外网络流量视觉变更要截图或短片段并与基线对比。记录谁或什么检查了运行中的应用——贡献者的截图本身不构成完成此门。优先走 keyless 路径与 fixtures确需 keyed 路径时安排受限测试凭据并记录未测行为不得默认为已验证。文档-only 变更可把运行时/构建/跟踪/视觉检查标为not applicable需附理由改为校验链接与指令test-only 变更要运行测试并检查其行为若应用未变视觉检查可为not applicable。注意失败或不可用的必需检查不能当作not applicable疑似既有的失败要与基线对比并记录不得静默豁免。门 5集成与署名Integration and attribution区分请求评审与授权集成评审请求产出结论与建议显式授权gates 通过就合入才授权范围内的必要清理与集成不必再问一次同样的问题最终由维护者对接受负责。发布评审或评论需要在 PR 上沟通的授权。保留贡献者的提交与作者元数据维护者的针对性调整以独立提交添加且署名维护者优先merge commit以保留历史。贡献者分支不可编辑时使用集成分支并回链原 PR。若选择 squash 或 cherry-pick用真实贡献者身份校验作者元数据与所需Co-authored-by尾注不得用维护者署名替换贡献者作者身份。重大调整要说明并给 release-note 署名。合入前的四个必做步骤把全部维护者调整与冲突解决纳入对目标 base 的最终 diff 评审——验证组合后的候选版本而不只是贡献者的原始 head。记录候选 SHA 与目标 base SHA 及验证证据合入前刷新 PR head 与目标分支任一变化都要协调、重审新 diff、重跑受影响检查组合候选的运行时变更需要本地构建与运行时检查。核验必需 hosted checks、适用审批与可合入性。绝不绕过仓库保护不带着未完成的必需门合入授权缺失时先呈上具体候选与证据再请求。在支持条件下使用锚定被审 head SHA 的合入操作检测到 head/base 变化就回到验证而非重试过期 merge核验合入结果与已验证候选树一致记录结果 commit 与 PR URL任何不一致都要停下报告。工作流最后声明了边界仓库规则只强制其配置的要求本文档与技能并不配置分支保护或 CI维护者应在main上要求 CI 与评审并在 push 新变更后撤销过期审批。四、验证命令背后的仓库实现门 4 的命令表不是占位符——每条命令在仓库中都有对应实现评审时可以直接阅读它们来理解这条检查到底在验什么npm run doctor→ scripts/setup-doctor.mjs。它检查 Node 版本classifyNodeVersion24.14 为 ok、26 为 ok、25 为 warn 且跳过分配基准、过旧为 error、npm 可用性、依赖是否安装并按凭据清单CREDENTIALSGoogle Maps、Cesium ion、OpenAI、AISStream、FIRMS、TomTom、OpenSky、LL2解析环境变量 / dotenv 文件 / macOS Keychain最后输出能力摘要地图走 Google 直连、ion 还是 keyless Esri 等。--json分支输出结构化报告inspectSetup()正好对应工作流表格里的npm run doctor -- --json。npm run format:check/npm run format→ scripts/format.mjs。它通过git ls-files自动发现scripts/format-runtime.json声明的运行时根目录下的 JS 文件加上scripts/format-scope.json的显式采纳列表用 Prettier 校验--check或写回--write排除.prettierignore与测试文件。配合 scripts/check-import-directions.mjs 一起构成 CI 的格式/方向检查。npm run check:boundaries→ 组合 scripts/check-import-directions.mjs 与 scripts/check-package-boundaries.mjs。后者会逐一构建package.json里声明的每个浏览器/Node 导出组按scripts/package-boundaries.json的归属校验其导入是否越界并强制每个导出必须恰好属于一个边界组。这正是门 2与既有所有权和包边界的一致性的机械化版本。npm test→ scripts/run-unit-tests.mjs。它递归发现src/下全部*.test.mjs并把两个分配微基准src/data/focusAllocations.test.mjs、src/overlays/worldOverlayAllocation.test.mjs用--expose-gc串行隔离运行——分配预算只在 Node 24 校准运行时生效。npm run test:track→ scripts/track-regression.mjs。这是确定性回归 harness不依赖任何实时数据源而是在页面注入fetchshim向/api/opensky、/api/adsblol/mil、/api/ais-live返回合成数据然后在真实应用http://localhost:4173的 headless Chromium 中锁定若干不变量无抖动、无拉出、无跨层孤儿、初始化干净等。这解释了为什么工作流要求先起 dev server 再跑test:track以及为什么它必须指向候选服务器。npm run build/npm run preview→ Vite 构建与预览docs/CURRENT-STATE.md 的 Local build preview 一节说明 preview 复用开发期的数据提供者路由未匹配的/api请求返回 JSON 404凭据编辑/api/setup/*仅限开发模式。五、审查记录一份可追溯的决策档案工作流要求在获得发布授权时于 PR 上保留一条简洁记录否则交还维护者详细安全证据留在私有报告中。模板原文如下PR / author: Policy revision / PR head / target branch and base / final candidate: Usefulness: result and rationale Quality and tests: result, findings, regression evidence Security: areas reviewed, findings, limitations, private report reference if needed Local validation: environment, commands, results, evidence locations Visual inspection: inspector, scenarios, evidence, or justified not applicable Maintainer adjustments and preserved attribution: Required CI and approvals: Decision: ready | changes requested | declined | blocked Accepting maintainer / authorization / remaining blockers: Integration result: merged commit and PR URL, or not merged注意Policy revision字段——它再次呼应可信修订版原则审查结论必须锚定在被审的策略版本、PR head、目标 base 与最终候选上。六、决策语义ready ≠ 已合入工作流对结论词给出了精确语义值得一字不差地理解Ready意味着对记录的候选版本所有适用门都通过——它不代表 PR 已被合入。合入是单独授权的集成操作。要求修改或拒绝时要给出可执行的actionable理由即使贡献需要维护者打磨也应认可其有用部分。这与技能文档的收尾要求一致评审通过只是建议直到授权合入完成并核验其结果。整个流程刻意把评审结论与合入动作解耦从而保证任何一步的证据都能回溯到具体候选版本任何一扇门都不会被另一扇门的通过所掩盖。七、与仓库文档体系的关系维护者评审时通常需要交叉引用以下文档它们在仓库中的根相对路径为CONTRIBUTING.md——贡献者提交指引分支、格式、PR 要求、维护者名单、地面规则SECURITY.md——安全模型、密钥处理、代理加固、报告流程docs/CURRENT-STATE.md——权威运行时参考运行时变更必须同步更新DATA_SOURCES.md——数据源许可与署名数据源变更必须同步更新docs/CODE-BOUNDARIES.md——格式化与组件边界的所有权与采纳过程.agents/skills/community-pr/SKILL.md——自动化执行本流程的 Agent 技能CHANGELOG.md——运行时变更的发布记录。对维护者而言这套工作流的价值在于它把社区 PR 接受从一次性判断变成可复现、可审计、防投毒的流程——可信指令打底、五道门独立计分、命令矩阵统一验证、审查记录锚定版本、署名规则保护贡献者。对贡献者而言理解这五道门就是理解项目的验收文化功能要有明确收益、测试要有真实回归价值、变更要尊重边界与文档契约、一切都要经得起从可信版本重新验证。【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 gods-eye-view 社区 PR 维护者工作流：五道验收门、可信指令与集成署名实操指南
gods-eye-view 社区 PR 维护者工作流五道验收门、可信指令与集成署名实操指南【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view本指南完整解析 gods-eye-view 仓库的社区贡献验收流程docs/MAINTAINER_WORKFLOW.md从以可信修订版为审查基准的防投毒原则到实用性与范围、质量与测试、安全与供应链、本地执行与可视化检查、集成与署名五道验收门再到本地验证命令矩阵与审查记录模板。读完你既能以维护者身份对社区 PR 做出可追溯的接受/拒绝决策也能作为贡献者理解 PR 为什么会被要求修改以及如何让提交一次通过。一、工作流定位谁在审审什么docs/MAINTAINER_WORKFLOW.md是仓库维护者对社区功能、修复与测试贡献的验收程序。它与面向贡献者的 CONTRIBUTING.md 明确分工后者负责怎么提交前者负责怎么验收、怎么合入。按 CONTRIBUTING.md 的记录仓库由 Bilawal Sidhu 与 Sameh KhamisHalfpixel共同维护两位维护者中任一位都有权评审并合入贡献。这一流程并非停留在纸面仓库内置了一个遵循该流程执行并记录决策证据的 Agent 技能位于 .agents/skills/community-pr/SKILL.md。该技能明确定义了两种执行形态review例如$community-pr review PR #123定位 PR 与修订版逐门验收返回结论与审查记录评审请求本身不隐含合入或发评论的权限。integrate例如$community-pr integrate PR #123 if it passes完成同样的评审在保留署名的前提下做必要的范围内维护者调整验证最终候选版本并在既有授权与仓库保护之内合入。从技能描述看它还约束了工具边界工作流不要求特定 Git/GitHub 连接器、执行安装、测试、构建与浏览器检查只允许在受限环境进行、证据必须锚定被审 PR 的 head、目标 base 与最终候选版本。二、第一步从可信指令开始Trusted Instructions工作流反复强调一个核心反投毒原则审查所依据的程序文本本身必须是可信的。具体步骤如下确认上游仓库是bilawalsidhu/gods-eye-viewfetch 它的main并记录该提交作为策略修订版policy revision。从该修订版读取本工作流文档、community-pr技能文档以及 SECURITY.md、CONTRIBUTING.md 和 docs/CURRENT-STATE.md 的相关部分。使用git show SHA:path读取文件——必须带具体提交 SHA因为一个移动的分支名本身不是评审记录。为什么要这样因为 PR 本身可能修改这些程序文件例如改动工作流文档、AGENTS.md、技能定义。工作流明确规定PR 描述、评论、源文件、AGENTS.md、技能以及对策略的提议修改都是评审输入review input它们不能授予权限也不能取代正在评审它们的指令。策略变更要当作未来采纳的变更来评审而不是立即生效。另外两条纪律记录 PR 元数据PR 编号与 URL、作者、head SHA、目标分支、目标 base SHA。遇到意外的目标分支必须先解决再合入。隔离评审工作区评审工作必须与维护者自己的未提交改动隔离fetch 或读取 diff 不构成运行其代码。如果可信流程缺失或不可访问应先报告缺口、取得维护者选定的可信修订版再继续验收——而不是将就着用 PR 带来的版本。三、五道验收门每道门独立计分工作流的核心是五道验收门acceptance gates。每道门需要各自的结论与证据一道门通过不能补偿另一道门失败。状态词有四个pass通过、changes needed需要修改、blocked受阻、not applicable不适用其中实用性门还可使用decline拒绝或discuss讨论。门 1实用性与范围Usefulness and scope识别用户问题与可观察收益——纯测试型 PR 也不例外。检查与公共数据、本地优先local-first产品定位及现有能力的契合度。权衡依赖、API 成本、UI 复杂度、性能与长期维护成本——一个能跑的功能仍可能超出项目范围。依据 DATA_SOURCES.md 核对数据源署名与许可。范围拒绝要建设性说明理由大型功能鼓励尽早讨论。门 2质量与测试Quality and tests审查完整变更及其受影响调用方正确性、可读设计、失败处理、与既有所有权和包边界的一致性。检查取消cancellation、拆除teardown、监听器、定时器、内存以及渲染/网络预算避免在贡献合入中夹带无关重构。要求对变更行为有有意义的回归覆盖首选在旧实现上失败、在修复后通过的 bug 测试。测试型贡献必须暴露真实覆盖缺口或防止合理回归使用确定性 fixture 与有意义的断言。重点检查被删的测试、被跳过的测试、被放松的断言、快照更新、mock 与测试运行器改动——被弱化的测试跑绿不是接受。文档配套运行时变更需要更新docs/CURRENT-STATE.md与CHANGELOG.md数据源变更需要更新DATA_SOURCES.md。这条在仓库里有明确映射运行时行为变更必须同步文档这与 CONTRIBUTING.md 的 PR 要求第 3、4 条一一对应改运行时行为要更新CURRENT-STATE.md和CHANGELOG.md增改数据源要更新DATA_SOURCES.md并附许可与署名。门 3安全与供应链Security and supply chain这是五道门里最重的防线要求在安装依赖或运行 PR 代码之前先做静态审查。审查面包括lockfile、package scripts、CI 工作流、构建插件、启动器、二进制、生成产物、符号链接以及对安全检查或 Agent 指令的改动。不要只局限于作者高亮的文件——要追踪无法解释或隐藏的行为、新依赖或下载来源。安全模型检查的边界对应 SECURITY.md 的威胁模型边界要求私有凭据必须留在服务端客户端 bundle、日志、错误、fixture、截图不得泄露。审查新出站主机与遥测防止意外数据收集或外泄代理保持注册或固定的上游目标保留重定向、地址、超时、响应大小限制。跨边界输入检查 SSRF、注入、路径穿越、不安全渲染本地主机localhost 与主机校验默认值保持不变审查环境/设置文件访问、文件权限、shell 执行、下载的代码语音工具保持有界的应用操作不可信 feed/模型文本不得获得新的执行或凭据访问CI保持最小权限。绝不使用仓库密钥或特权 token 执行不可信 PR 代码包括通过pull_request_target同时给出工具的定位依赖与静态分析工具可以补充覆盖但要记录其结论与局限——扫描器、测试和 AI 评审都不能证明不存在后门。无法解释的可疑行为或未解决的可利用问题直接阻塞合入。漏洞细节走 SECURITY.md 的私有报告流程公开摘要不得含敏感细节。仓库代码印证了这一模型SECURITY.md 明确列出秘密型 API 密钥一律服务端持有OPENAI_API_KEY、AISSTREAM_API_KEY、OpenSky OAuth、GOOGLE_MAPS_SERVER_API_KEY并描述了代理加固手段——CCTV 帧代理只 fetch 服务端注册的 URLSSRF 缓解、Radio 不当中继、transit 只解析注册 feed 等与门 3 的代理边界审查项完全对应。门 4本地执行与可视化检查Local execution and visual inspection核心认知依赖安装、测试、构建、启动器和浏览器预览统统是对不可信代码的执行。因此必须在一次性的受限环境中进行该环境要求无个人凭据、无继承的 secrets、无 SSH agent、无 Keychain 访问、无特权宿主挂载、无容器引擎 socket网络访问仅限验证所需worktree 本身不是安全边界不得把维护者的.env、PinokioENVIRONMENT或浏览器 profile 拷进去也不得使用会导入个人密钥的启动器若该环境不可用继续静态评审把执行标记为blocked而不是在带凭据的主机上运行。技术细则使用可信package.json与 CI 配置中支持的 Node 版本当前仓库engines声明为node 24.14.0 25 || 26 27审查依赖与脚本变更后在受限环境内用npm ci安装锁定依赖。禁用生命周期脚本有助于初步检查但不能让后续构建或测试在宿主机上安全运行。对运行时变更必须在待合入候选版本上记录以下本地结果——这张命令表是工作流的核心可操作资产检查项命令或证据环境策略npm run doctor -- --json采用格式npm run format:check包边界npm run check:boundaries单元测试npm test生产构建npm run build跟踪回归先启动npm run dev于http://localhost:4173再在装有兼容 Chromium 的环境运行npm run test:track构建产物如需可先停 dev server再运行npm run preview检查构建后的应用确认浏览器与跟踪 harness 指向的是候选服务器而非已运行的旧 checkout浏览器工具在受限环境内提供。CI 只是补充证据不能替代本地验证——工作流还特别注明本流程引入时CI 并不运行test:track与仓库中scripts/track-regression.mjs的确定性回归 harness定位一致。验证动作还包括实际演练变更功能与邻近交互覆盖加载/空/失败/禁用/拆除状态键盘行为、相关视口尺寸、控制台错误与意外网络流量视觉变更要截图或短片段并与基线对比。记录谁或什么检查了运行中的应用——贡献者的截图本身不构成完成此门。优先走 keyless 路径与 fixtures确需 keyed 路径时安排受限测试凭据并记录未测行为不得默认为已验证。文档-only 变更可把运行时/构建/跟踪/视觉检查标为not applicable需附理由改为校验链接与指令test-only 变更要运行测试并检查其行为若应用未变视觉检查可为not applicable。注意失败或不可用的必需检查不能当作not applicable疑似既有的失败要与基线对比并记录不得静默豁免。门 5集成与署名Integration and attribution区分请求评审与授权集成评审请求产出结论与建议显式授权gates 通过就合入才授权范围内的必要清理与集成不必再问一次同样的问题最终由维护者对接受负责。发布评审或评论需要在 PR 上沟通的授权。保留贡献者的提交与作者元数据维护者的针对性调整以独立提交添加且署名维护者优先merge commit以保留历史。贡献者分支不可编辑时使用集成分支并回链原 PR。若选择 squash 或 cherry-pick用真实贡献者身份校验作者元数据与所需Co-authored-by尾注不得用维护者署名替换贡献者作者身份。重大调整要说明并给 release-note 署名。合入前的四个必做步骤把全部维护者调整与冲突解决纳入对目标 base 的最终 diff 评审——验证组合后的候选版本而不只是贡献者的原始 head。记录候选 SHA 与目标 base SHA 及验证证据合入前刷新 PR head 与目标分支任一变化都要协调、重审新 diff、重跑受影响检查组合候选的运行时变更需要本地构建与运行时检查。核验必需 hosted checks、适用审批与可合入性。绝不绕过仓库保护不带着未完成的必需门合入授权缺失时先呈上具体候选与证据再请求。在支持条件下使用锚定被审 head SHA 的合入操作检测到 head/base 变化就回到验证而非重试过期 merge核验合入结果与已验证候选树一致记录结果 commit 与 PR URL任何不一致都要停下报告。工作流最后声明了边界仓库规则只强制其配置的要求本文档与技能并不配置分支保护或 CI维护者应在main上要求 CI 与评审并在 push 新变更后撤销过期审批。四、验证命令背后的仓库实现门 4 的命令表不是占位符——每条命令在仓库中都有对应实现评审时可以直接阅读它们来理解这条检查到底在验什么npm run doctor→ scripts/setup-doctor.mjs。它检查 Node 版本classifyNodeVersion24.14 为 ok、26 为 ok、25 为 warn 且跳过分配基准、过旧为 error、npm 可用性、依赖是否安装并按凭据清单CREDENTIALSGoogle Maps、Cesium ion、OpenAI、AISStream、FIRMS、TomTom、OpenSky、LL2解析环境变量 / dotenv 文件 / macOS Keychain最后输出能力摘要地图走 Google 直连、ion 还是 keyless Esri 等。--json分支输出结构化报告inspectSetup()正好对应工作流表格里的npm run doctor -- --json。npm run format:check/npm run format→ scripts/format.mjs。它通过git ls-files自动发现scripts/format-runtime.json声明的运行时根目录下的 JS 文件加上scripts/format-scope.json的显式采纳列表用 Prettier 校验--check或写回--write排除.prettierignore与测试文件。配合 scripts/check-import-directions.mjs 一起构成 CI 的格式/方向检查。npm run check:boundaries→ 组合 scripts/check-import-directions.mjs 与 scripts/check-package-boundaries.mjs。后者会逐一构建package.json里声明的每个浏览器/Node 导出组按scripts/package-boundaries.json的归属校验其导入是否越界并强制每个导出必须恰好属于一个边界组。这正是门 2与既有所有权和包边界的一致性的机械化版本。npm test→ scripts/run-unit-tests.mjs。它递归发现src/下全部*.test.mjs并把两个分配微基准src/data/focusAllocations.test.mjs、src/overlays/worldOverlayAllocation.test.mjs用--expose-gc串行隔离运行——分配预算只在 Node 24 校准运行时生效。npm run test:track→ scripts/track-regression.mjs。这是确定性回归 harness不依赖任何实时数据源而是在页面注入fetchshim向/api/opensky、/api/adsblol/mil、/api/ais-live返回合成数据然后在真实应用http://localhost:4173的 headless Chromium 中锁定若干不变量无抖动、无拉出、无跨层孤儿、初始化干净等。这解释了为什么工作流要求先起 dev server 再跑test:track以及为什么它必须指向候选服务器。npm run build/npm run preview→ Vite 构建与预览docs/CURRENT-STATE.md 的 Local build preview 一节说明 preview 复用开发期的数据提供者路由未匹配的/api请求返回 JSON 404凭据编辑/api/setup/*仅限开发模式。五、审查记录一份可追溯的决策档案工作流要求在获得发布授权时于 PR 上保留一条简洁记录否则交还维护者详细安全证据留在私有报告中。模板原文如下PR / author: Policy revision / PR head / target branch and base / final candidate: Usefulness: result and rationale Quality and tests: result, findings, regression evidence Security: areas reviewed, findings, limitations, private report reference if needed Local validation: environment, commands, results, evidence locations Visual inspection: inspector, scenarios, evidence, or justified not applicable Maintainer adjustments and preserved attribution: Required CI and approvals: Decision: ready | changes requested | declined | blocked Accepting maintainer / authorization / remaining blockers: Integration result: merged commit and PR URL, or not merged注意Policy revision字段——它再次呼应可信修订版原则审查结论必须锚定在被审的策略版本、PR head、目标 base 与最终候选上。六、决策语义ready ≠ 已合入工作流对结论词给出了精确语义值得一字不差地理解Ready意味着对记录的候选版本所有适用门都通过——它不代表 PR 已被合入。合入是单独授权的集成操作。要求修改或拒绝时要给出可执行的actionable理由即使贡献需要维护者打磨也应认可其有用部分。这与技能文档的收尾要求一致评审通过只是建议直到授权合入完成并核验其结果。整个流程刻意把评审结论与合入动作解耦从而保证任何一步的证据都能回溯到具体候选版本任何一扇门都不会被另一扇门的通过所掩盖。七、与仓库文档体系的关系维护者评审时通常需要交叉引用以下文档它们在仓库中的根相对路径为CONTRIBUTING.md——贡献者提交指引分支、格式、PR 要求、维护者名单、地面规则SECURITY.md——安全模型、密钥处理、代理加固、报告流程docs/CURRENT-STATE.md——权威运行时参考运行时变更必须同步更新DATA_SOURCES.md——数据源许可与署名数据源变更必须同步更新docs/CODE-BOUNDARIES.md——格式化与组件边界的所有权与采纳过程.agents/skills/community-pr/SKILL.md——自动化执行本流程的 Agent 技能CHANGELOG.md——运行时变更的发布记录。对维护者而言这套工作流的价值在于它把社区 PR 接受从一次性判断变成可复现、可审计、防投毒的流程——可信指令打底、五道门独立计分、命令矩阵统一验证、审查记录锚定版本、署名规则保护贡献者。对贡献者而言理解这五道门就是理解项目的验收文化功能要有明确收益、测试要有真实回归价值、变更要尊重边界与文档契约、一切都要经得起从可信版本重新验证。【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考