族谱研究 是做什么的？
一个便携技能；所有研究说明、目录、模板和核心脚本均已捆绑。无需单独安装技能、连接器、账户或API密钥。实时研究仍需宿主的网络工具。以用户使用的语言回复。
加载与解析
将包含本文件的目录视为技能根目录。从包含它的文档中解析所有引用的文件；通过其绝对解析路径调用脚本，无论Shell当前目录如何。不要假设特定的主目录、操作系统、浏览器、模型、工具名称或技能注册表。
阅读政策，然后阅读捆绑的研究引擎。这些是普通的本地文件：即使宿主无法调用嵌套技能，也应直接读取。项目政策管辖访问权限和隐私；上游政策管辖证据推理。使用固定副本；仅在收到明确的维护请求时才检查或替换依赖项。
研究循环
- 理解问题和输入。 如果未提供资料，询问已有的材料。将提供的族谱、GEDCOM、文档和家族叙述作为线索读取；保留原始文件。提取人物、冲突身份、事件日期/地点、声称的关系、来源和未解决的链接。族谱中的断言并非证据。
- 启动或恢复一个私人案例。 阅读案例管理。在技能外部使用
scripts/init_case.py --case-dir <case> --research-question <question>初始化。恢复现有记录和搜索，而不是重置它们。旧的toolkit_path是位置提示；如果已移动，则使用当前加载的技能根目录。 - 选择有用的检查。 同时查阅区域档案和其他来源，按历史地点、事件日期和记录类型分类。对于已变更的边界或名称，使用乡政查找。目录覆盖范围仍不完整；关键词匹配并非保管决策。
- 阅读并保存证据。 使用可用的网络、图像和文档工具。将允许的本地证据与来源、日期、参考和校验和一起保存；记录空结果和受阻的搜索。保留原始拼写、不确定的解读和替代方案。区分同名者，直到有区分证据支持身份决策。
- 评估每个关系。 遵循捆绑的证据协议。将身份解析与亲缘关系区分开。检查每条边、来源依赖性和矛盾记录；保留生物学、法律、收养和家庭关系的区别。禁止自动合并或置信度百分比。
- 审计并解释。 运行
scripts/audit_evidence.py --case-dir <case>。完整性错误需要纠正；诚实的证据警告应保留。解释有出处的亲缘关系链、替代方案、已搜索覆盖范围、受阻的路径和下一步有用的检查。保存断点位置，避免在没有新理由的情况下重复搜索。 - 交付所需的视图。 阅读输出约定了解离线族谱/报告和GEDCOM导出器。默认输出排除在世人员和状态未知人员。私人输出需用户请求；不得发布结果。
在可选问题等待答案期间，继续有用且授权的研究。当问题在其记录的证据级别得到回答、有用的可及路径已穷尽或用户停止任务时停止。空白结果也是有效结果。
宿主能力
- 文件和Python 3.9+： 核心脚本仅使用标准库。可选的上游工具会记录其自身的依赖项。
- 无Shell/Python： 使用可用的文件工具维护捆绑的CSV模板；手动执行审计规则，并将自动审计标记为未运行。不要声称已生成的导出或已执行的检查。
- 无网络： 分析提供的材料和本地参考；确定建议的搜索路径，但不声称已检查过。
- 无可靠的图像/文档阅读器： 保留源文件并标记
needs-vision；不要捏造阅读结果。 - 无持久化文件： 提供有出处的临时分析，并说明未作为案例保存。不要暗示有持久的记录或可恢复性。
无需模型委派。如需安装或宿主集成，请参阅兼容性。