PostHog Surveys 本地仓库注册表Local Repo Registry实战指南跨 SDK 代码定位与复用方案【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthogPostHog Surveys 是一个典型的跨仓库功能产品后端与 UI 位于当前 monorepo而调研问卷的实际渲染与资格判定分散在posthog-jsWeb 与 React Native、posthog-ios、posthog-android、posthog-flutter五个 SDK 仓库中。本文基于 .agents/skills/survey-sdk-audit/references/local-repos.md 讲解其维护者采用的**本地仓库注册表Local Repo Registry**方案通过~/.config/posthog-surveys/repos.json记录每个仓库在本机克隆到了哪里并用scripts/repos.py实现一次发现、跨会话复用。读完本文你将掌握注册表的设计动机、JSON 格式约定、init / ensure / get / set / list五个命令的完整用法以及底层repos.py的扫描与匹配实现原理。为什么需要本地仓库注册表Surveys 功能跨越多个仓库除了当前 monorepo 之外还涉及posthog-js同时承载 Web 与 React Native 两个 SDK、posthog-ios、posthog-android、posthog-flutter以及文档仓库posthog.com。各仓库的维护者把克隆放在哪里并没有统一约定——有人放在~/src有人放在~/projects还有人习惯用 worktree 或按 topic 命名克隆。于是出现了一个实际问题每个新的开发/调试会话都要重新找一遍这些仓库在哪里否则要么重复克隆、浪费时间要么凭目录名猜测导致拿到错误的 checkout。注册表方案的核心分工是GitHub 是代码在哪里的事实来源仓库列表见 .agents/skills/survey-sdk-audit/references/contributing-surveys.md 中的仓库表注册表只是这个维护者把代码克隆到了哪里的本地缓存记录一次、反复复用不再每个会话重新克隆。这种远端事实源 本地缓存的分层设计与 git 本身的语义一致远端不关心你的本地布局本地缓存则帮你免去重复搜索。注册表文件位置、格式与 repo key 约定注册表是一个 JSON 映射repo key → 本地绝对路径存放在~/.config/posthog-surveys/repos.json示例内容{ posthog: /Users/me/src/posthog, posthog-js: /Users/me/src/posthog-js, posthog-ios: /Users/me/src/posthog-ios, posthog-android: /Users/me/src/posthog-android, posthog-flutter: /Users/me/src/posthog-flutter, posthog.com: /Users/me/src/posthog.com }关键约定repo key 与 GitHub 仓库名一一对应posthog、posthog-js、posthog-ios、posthog-android、posthog-flutter、posthog.com这样脚本可以直接根据 key 拼出远端 URL。Web 与 React Native 两个 SDK 都住在posthog-js一个仓库里分别在packages/browser/与packages/react-native/因此注册表中只需要一条posthog-js记录。值必须是绝对路径且应指向真实存在的 checkout。在 scripts/repos.py 中注册表路径与合法 key 集被定义为模块级常量对应 repos.pyREGISTRY Path.home() / .config / posthog-surveys / repos.json KNOWN_REPOS { posthog, posthog-js, posthog-ios, posthog-android, posthog-flutter, posthog.com, }读写逻辑由load_registry()/save_registry()承担对应 repos.py读取时对 JSON 解析失败做了容错返回空注册表而非崩溃写入时会自动mkdir父目录并保持 key 排序、缩进 2 格的稳定格式。首次初始化init一键自动发现在只配置过一次的机器上运行一次即可自动发现并记录本机所有已有的 PostHog checkout无需为已克隆的仓库手动输入路径python3 scripts/repos.py init这里的scripts/repos.py位于 .agents/skills/survey-sdk-audit/scripts/repos.py从技能目录执行即可。init的发现逻辑在源码中分为三部分1. 扫描根目录_scan_roots()对应 repos.py。按优先级依次检查当前工作目录的父目录、父父目录以及~/src、~/code、~/dev、~/projects、~/repos、~/work、~/git这些常规代码根目录。刻意不扫描整个$HOME避免遍历Library、Application等无关目录拖慢速度。2. 深度剪枝与噪音排除对应 repos.py。node_modules、.venv、venv、vendor、Pods、build、dist、.next、target、.cache等目录绝不包含需要的兄弟 checkout直接跳过最大遍历深度限制为 4 层。此外一旦发现某个目录是 checkout存在.git就不再向深处下钻——一个 checkout 内部不会包含另一个值得关心的兄弟 checkout。3. 按originremote 匹配is_repo_checkout()/repo_key_for_origin()对应 repos.py。每个候选目录读取其.git/config中的origin远程 URL直接读文件而非 spawn git 子进程更快且覆盖最常见场景归一化后以github.com/PostHog/repo后缀精确匹配到已知 key。匹配依据是 git remote而不是目录名——这是本方案最关键的可靠性设计一个名字恰好叫posthog-js的文件夹不会被误认为是真实 checkout。init是幂等的重复运行会保留你先前显式指定的路径只填补空缺同一仓库被检出多份时保留第一个找到的并打印出set命令供你手动改选其他副本对应 repos.py。之所以必须以文件系统 originremote作为信号是因为git 并不存在一个全局配置能列出所有克隆位置——这是发现逻辑存在的根本原因。按需解析ensure/get/set/list日常使用中最常用的四个命令python3 scripts/repos.py ensure posthog-js # registry - scan - path (add --clone to clone) python3 scripts/repos.py get posthog-ios # print path, or exit non-zero if unknown python3 scripts/repos.py set posthog-android /path # override the recorded path python3 scripts/repos.py list # show the whole registry各命令语义与源码实现ensure repo是完整解析链先查注册表路径存在即返回→ 再对代码根做定向文件系统扫描discover(wanted{repo})找到目标即提前返回→ 记录扫描结果并打印 → 若仍未找到且带--clone则执行克隆对应 repos.py。get repo只读地打印已记录路径未知或路径已不存在时向 stderr 打印提示并以退出码 1 结束便于在脚本中做条件判断对应 repos.py。set repo path显式覆盖记录路径用于维护者手动指定会先校验目标确实是目录对应 repos.py。list把整个注册表以排序后的 JSON 打印出来适合快速核对本机已登记的仓库对应 repos.py。--clone路径对应 repos.py默认克隆到~/src/repo且采用浅克隆git clone --depth 1以节省时间如果目标路径已存在会先用origin校验它确实是正确的仓库避免把无关目录写进注册表污染缓存。手动解析流程不依赖脚本时按同一逻辑操作如果不想用脚本可以直接按脚本编码的同一套逻辑手动处理原文档的四步流程读注册表如果 repo 已登记且路径存在直接使用。扫描代码根在上述代码根目录中查找git remote get-url origin指向PostHog/repo的 checkout目录名匹配仅作兜底。询问或克隆仍未找到时询问维护者位置或提议git clone https://github.com/PostHog/repo到默认位置~/src/repo。写回注册表把解析到的路径写回~/.config/posthog-surveys/repos.json让后续会话跳过搜索/克隆。手动操作时注意保持与脚本一致的口径永远以originremote 为准不要凭目录名下结论——worktree 和按 topic 命名的克隆如posthog-topic在 PostHog 生态中非常常见。引用代码前的最佳实践注册表帮你找到 checkout但找到不等于可以放心引用。原文档与配套的 debugging-mcp-analytics 技能文档 共同强调以下纪律确认分支。topic 分支或过期的 worktree 并不代表读者理解的当前状态几个 SDK 仓库都有长期存在的未合并分支。需要引用已发布状态时显式从远端 ref 读取git show origin/main:path或git show origin/master:path而不是信任工作树当前内容。trunk 分支约定posthog与posthog.com是master其余仓库是main。不要改动只读的 checkout也不要切换它的分支——这些是维护者日常使用的工作副本常常含有未提交的改动。用 grep 搜索符号而不是相信记忆中的行号——SDK 演进很快行号几乎必然漂移。注册表在 Surveys 开发与诊断流程中的位置与survey-sdk-audit技能功能审计的入口当需要为 Surveys 新增或审计某个 SDK 特性时contributing-surveys.md 明确要求在技能目录下先初始化注册表再解析仓库python3 scripts/repos.py init python3 scripts/repos.py ensure posthog-js之后按 SKILL.md 的审计流程在各自 checkout 中核对 changelog、getActiveMatchingSurveys()等过滤逻辑与渲染代码。整个技能还依赖$POSTHOG_JS_PATH、$POSTHOG_IOS_PATH等环境变量指向的 SDK 路径——注册表正是这类路径从哪里来问题的系统化答案。与debugging-surveys技能诊断场景无需 checkout值得注意的是客户支持侧的debugging-surveys技能并不需要任何仓库 checkout——它通过 PostHog MCP 工具和 Survey API 完成只读诊断。因此本地仓库注册表面向的是开发/审计场景需要读 SDK 源码时而不是线上诊断场景。这也解释了为什么文档反复强调GitHub 是事实来源注册表只是本地缓存注册表的存在与否不应影响任何结论的正确性。与其他技能的同构对照debugging-mcp-analytics/references/local-repos.md 展示了同一模式在其他领域技能中的变体MCP analytics 技能使用独立的~/.config/posthog-mcp-analytics/repos.json注册表且覆盖posthog-python、context-mill、wizard、wizard-workbench等不同仓库集合。该文档还特别提醒不要直接复用 Surveys 的repos.py——它的KNOWN_REPOS与注册表路径都是 Surveys 专属的init/ensure无法发现 MCP analytics 所需的仓库。这说明注册表 扫描脚本是一套可复制的模式但每个技能需要自己的 repo 清单与注册表路径。小结本地仓库注册表是 PostHog 内部解决跨仓库开发时如何稳定、高效地定位代码的方案核心设计可概括为三点一份 JSON 注册表~/.config/posthog-surveys/repos.json记录 repo key → 绝对路径repo key 与 GitHub 仓库名一致一个幂等的发现脚本scripts/repos.py以originremote 为唯一可信信号扫描常规代码根目录支持init / ensure / get / set / list五个子命令一套引用纪律确认分支、grep 符号、只读访问确保找到的 checkout 真的可以被引用。这套模式的价值不在于复杂而在于把每次会话都要重新寻找克隆位置的隐性成本沉淀为一个可复用、可审计、可手动兜底的标准流程。【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
PostHog Surveys 本地仓库注册表（Local Repo Registry）实战指南：跨 SDK 代码定位与复用方案
PostHog Surveys 本地仓库注册表Local Repo Registry实战指南跨 SDK 代码定位与复用方案【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthogPostHog Surveys 是一个典型的跨仓库功能产品后端与 UI 位于当前 monorepo而调研问卷的实际渲染与资格判定分散在posthog-jsWeb 与 React Native、posthog-ios、posthog-android、posthog-flutter五个 SDK 仓库中。本文基于 .agents/skills/survey-sdk-audit/references/local-repos.md 讲解其维护者采用的**本地仓库注册表Local Repo Registry**方案通过~/.config/posthog-surveys/repos.json记录每个仓库在本机克隆到了哪里并用scripts/repos.py实现一次发现、跨会话复用。读完本文你将掌握注册表的设计动机、JSON 格式约定、init / ensure / get / set / list五个命令的完整用法以及底层repos.py的扫描与匹配实现原理。为什么需要本地仓库注册表Surveys 功能跨越多个仓库除了当前 monorepo 之外还涉及posthog-js同时承载 Web 与 React Native 两个 SDK、posthog-ios、posthog-android、posthog-flutter以及文档仓库posthog.com。各仓库的维护者把克隆放在哪里并没有统一约定——有人放在~/src有人放在~/projects还有人习惯用 worktree 或按 topic 命名克隆。于是出现了一个实际问题每个新的开发/调试会话都要重新找一遍这些仓库在哪里否则要么重复克隆、浪费时间要么凭目录名猜测导致拿到错误的 checkout。注册表方案的核心分工是GitHub 是代码在哪里的事实来源仓库列表见 .agents/skills/survey-sdk-audit/references/contributing-surveys.md 中的仓库表注册表只是这个维护者把代码克隆到了哪里的本地缓存记录一次、反复复用不再每个会话重新克隆。这种远端事实源 本地缓存的分层设计与 git 本身的语义一致远端不关心你的本地布局本地缓存则帮你免去重复搜索。注册表文件位置、格式与 repo key 约定注册表是一个 JSON 映射repo key → 本地绝对路径存放在~/.config/posthog-surveys/repos.json示例内容{ posthog: /Users/me/src/posthog, posthog-js: /Users/me/src/posthog-js, posthog-ios: /Users/me/src/posthog-ios, posthog-android: /Users/me/src/posthog-android, posthog-flutter: /Users/me/src/posthog-flutter, posthog.com: /Users/me/src/posthog.com }关键约定repo key 与 GitHub 仓库名一一对应posthog、posthog-js、posthog-ios、posthog-android、posthog-flutter、posthog.com这样脚本可以直接根据 key 拼出远端 URL。Web 与 React Native 两个 SDK 都住在posthog-js一个仓库里分别在packages/browser/与packages/react-native/因此注册表中只需要一条posthog-js记录。值必须是绝对路径且应指向真实存在的 checkout。在 scripts/repos.py 中注册表路径与合法 key 集被定义为模块级常量对应 repos.pyREGISTRY Path.home() / .config / posthog-surveys / repos.json KNOWN_REPOS { posthog, posthog-js, posthog-ios, posthog-android, posthog-flutter, posthog.com, }读写逻辑由load_registry()/save_registry()承担对应 repos.py读取时对 JSON 解析失败做了容错返回空注册表而非崩溃写入时会自动mkdir父目录并保持 key 排序、缩进 2 格的稳定格式。首次初始化init一键自动发现在只配置过一次的机器上运行一次即可自动发现并记录本机所有已有的 PostHog checkout无需为已克隆的仓库手动输入路径python3 scripts/repos.py init这里的scripts/repos.py位于 .agents/skills/survey-sdk-audit/scripts/repos.py从技能目录执行即可。init的发现逻辑在源码中分为三部分1. 扫描根目录_scan_roots()对应 repos.py。按优先级依次检查当前工作目录的父目录、父父目录以及~/src、~/code、~/dev、~/projects、~/repos、~/work、~/git这些常规代码根目录。刻意不扫描整个$HOME避免遍历Library、Application等无关目录拖慢速度。2. 深度剪枝与噪音排除对应 repos.py。node_modules、.venv、venv、vendor、Pods、build、dist、.next、target、.cache等目录绝不包含需要的兄弟 checkout直接跳过最大遍历深度限制为 4 层。此外一旦发现某个目录是 checkout存在.git就不再向深处下钻——一个 checkout 内部不会包含另一个值得关心的兄弟 checkout。3. 按originremote 匹配is_repo_checkout()/repo_key_for_origin()对应 repos.py。每个候选目录读取其.git/config中的origin远程 URL直接读文件而非 spawn git 子进程更快且覆盖最常见场景归一化后以github.com/PostHog/repo后缀精确匹配到已知 key。匹配依据是 git remote而不是目录名——这是本方案最关键的可靠性设计一个名字恰好叫posthog-js的文件夹不会被误认为是真实 checkout。init是幂等的重复运行会保留你先前显式指定的路径只填补空缺同一仓库被检出多份时保留第一个找到的并打印出set命令供你手动改选其他副本对应 repos.py。之所以必须以文件系统 originremote作为信号是因为git 并不存在一个全局配置能列出所有克隆位置——这是发现逻辑存在的根本原因。按需解析ensure/get/set/list日常使用中最常用的四个命令python3 scripts/repos.py ensure posthog-js # registry - scan - path (add --clone to clone) python3 scripts/repos.py get posthog-ios # print path, or exit non-zero if unknown python3 scripts/repos.py set posthog-android /path # override the recorded path python3 scripts/repos.py list # show the whole registry各命令语义与源码实现ensure repo是完整解析链先查注册表路径存在即返回→ 再对代码根做定向文件系统扫描discover(wanted{repo})找到目标即提前返回→ 记录扫描结果并打印 → 若仍未找到且带--clone则执行克隆对应 repos.py。get repo只读地打印已记录路径未知或路径已不存在时向 stderr 打印提示并以退出码 1 结束便于在脚本中做条件判断对应 repos.py。set repo path显式覆盖记录路径用于维护者手动指定会先校验目标确实是目录对应 repos.py。list把整个注册表以排序后的 JSON 打印出来适合快速核对本机已登记的仓库对应 repos.py。--clone路径对应 repos.py默认克隆到~/src/repo且采用浅克隆git clone --depth 1以节省时间如果目标路径已存在会先用origin校验它确实是正确的仓库避免把无关目录写进注册表污染缓存。手动解析流程不依赖脚本时按同一逻辑操作如果不想用脚本可以直接按脚本编码的同一套逻辑手动处理原文档的四步流程读注册表如果 repo 已登记且路径存在直接使用。扫描代码根在上述代码根目录中查找git remote get-url origin指向PostHog/repo的 checkout目录名匹配仅作兜底。询问或克隆仍未找到时询问维护者位置或提议git clone https://github.com/PostHog/repo到默认位置~/src/repo。写回注册表把解析到的路径写回~/.config/posthog-surveys/repos.json让后续会话跳过搜索/克隆。手动操作时注意保持与脚本一致的口径永远以originremote 为准不要凭目录名下结论——worktree 和按 topic 命名的克隆如posthog-topic在 PostHog 生态中非常常见。引用代码前的最佳实践注册表帮你找到 checkout但找到不等于可以放心引用。原文档与配套的 debugging-mcp-analytics 技能文档 共同强调以下纪律确认分支。topic 分支或过期的 worktree 并不代表读者理解的当前状态几个 SDK 仓库都有长期存在的未合并分支。需要引用已发布状态时显式从远端 ref 读取git show origin/main:path或git show origin/master:path而不是信任工作树当前内容。trunk 分支约定posthog与posthog.com是master其余仓库是main。不要改动只读的 checkout也不要切换它的分支——这些是维护者日常使用的工作副本常常含有未提交的改动。用 grep 搜索符号而不是相信记忆中的行号——SDK 演进很快行号几乎必然漂移。注册表在 Surveys 开发与诊断流程中的位置与survey-sdk-audit技能功能审计的入口当需要为 Surveys 新增或审计某个 SDK 特性时contributing-surveys.md 明确要求在技能目录下先初始化注册表再解析仓库python3 scripts/repos.py init python3 scripts/repos.py ensure posthog-js之后按 SKILL.md 的审计流程在各自 checkout 中核对 changelog、getActiveMatchingSurveys()等过滤逻辑与渲染代码。整个技能还依赖$POSTHOG_JS_PATH、$POSTHOG_IOS_PATH等环境变量指向的 SDK 路径——注册表正是这类路径从哪里来问题的系统化答案。与debugging-surveys技能诊断场景无需 checkout值得注意的是客户支持侧的debugging-surveys技能并不需要任何仓库 checkout——它通过 PostHog MCP 工具和 Survey API 完成只读诊断。因此本地仓库注册表面向的是开发/审计场景需要读 SDK 源码时而不是线上诊断场景。这也解释了为什么文档反复强调GitHub 是事实来源注册表只是本地缓存注册表的存在与否不应影响任何结论的正确性。与其他技能的同构对照debugging-mcp-analytics/references/local-repos.md 展示了同一模式在其他领域技能中的变体MCP analytics 技能使用独立的~/.config/posthog-mcp-analytics/repos.json注册表且覆盖posthog-python、context-mill、wizard、wizard-workbench等不同仓库集合。该文档还特别提醒不要直接复用 Surveys 的repos.py——它的KNOWN_REPOS与注册表路径都是 Surveys 专属的init/ensure无法发现 MCP analytics 所需的仓库。这说明注册表 扫描脚本是一套可复制的模式但每个技能需要自己的 repo 清单与注册表路径。小结本地仓库注册表是 PostHog 内部解决跨仓库开发时如何稳定、高效地定位代码的方案核心设计可概括为三点一份 JSON 注册表~/.config/posthog-surveys/repos.json记录 repo key → 绝对路径repo key 与 GitHub 仓库名一致一个幂等的发现脚本scripts/repos.py以originremote 为唯一可信信号扫描常规代码根目录支持init / ensure / get / set / list五个子命令一套引用纪律确认分支、grep 符号、只读访问确保找到的 checkout 真的可以被引用。这套模式的价值不在于复杂而在于把每次会话都要重新寻找克隆位置的隐性成本沉淀为一个可复用、可审计、可手动兜底的标准流程。【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考