Project Handoff 是图形就绪的便携式存储器。知识图可以使移交内存更容易查询、验证、精简、存档和推广，但当前项目移交的事实来源仍然是经过审查的存储库本地文件包：AGENTS.md、readme.human、键入的 .uai 记录、证据分类帐和已接受的项目工件。
当团队希望 AI 内存能够回答关系问题时，例如哪些约束适用于路线、哪些决策影响测试计划、哪些声明缺乏证据、哪些旧报告移至冷内存以及哪些事实可以安全地与接收代理共享，请使用本指南。
项目切换知识图谱边界
- 当前 UAIX 支持：图形内存配置所需的图形就绪项目切换设计、稳定标识符、源/出处字段、验证问题、向导规划字段和 LLM Wiki 知识图规划的公共指南。
- 目前的事实来源：已审查的文件包和公共 UAIX 页面，而不是推断的图形缓存或检索答案。
- 目前出口态势：任何图形投影均应导出且在审查之前为只读；这是证据导航，而不是自动存储库写入。
- 当前不支持：托管图形数据库、公共图形 API、公共 SPARQL 端点、自动 LLM Wiki 同步、自动导入、SDK、CLI、认证、认可、一致性配置文件或官方适配器。
这不是托管图形数据库；它是从审查的项目移交文件中导出图形就绪投影的指南，同时保持源文件的权威性。
图形就绪内存模型
| 图节点 | 项目交接源 | 为什么这很重要 |
|---|---|---|
| 项目 | AGENTS.md, .uai/context.uai | 命名系统、范围、受众、所有者和公共权力边界。 |
| 交接捆绑 | AGENTS.md、readme.human、已加载 .uai 列表 | 显示接收代理在工作前必须加载的内容。 |
| 文档神器 | 文档、公共页面、代码路径、包文件、发现资产 | 将内存连接到已更改的文件或路径。 |
| 上下文记录 | 输入 .uai 文件 | 分离堆栈、架构、约束、操作、进度、决策、风格、公共表面和测试。 |
| 约束 | .uai/constraints.uai，代理硬规则 | 防止代理绕过秘密、支持声明、破坏性操作和公共路由限制。 |
| 决定 | .uai/decisions.uai，变更日志，发行说明 | 解释当前行为为何存在以及何时可以改变。 |
| 工作项目 | .uai/progress.uai，路线图，摄入配置 | 连接当前工作、阻碍因素、检查、下一步行动和接受的结果。 |
| 查看 | .uai/test-plan.uai，脚本，包测试，验证器结果 | 显示索赔推进之前需要哪些证据。 |
| 宣称 | 公共页面副本、路线图文本、机器工件、生成的计划 | 让 UAIX 跟踪声明是否是当前的、计划中的、不受支持的、过时的或源需要的。 |
| 风险 | 约束、隐私/安全文档、File Handoff处置 | 路由私人数据、破坏性行为、不受支持的声明和不安全文件进行审查。 |
| 代理运行 | 接受的摘要、更改的文件、检查运行、阻止程序 | 保留有用的运行输出，而不将原始私有跟踪存储为操作事实。 |
| 冷记忆记录 | LLM Wiki、AIWikis 存档、传输清单、源摘要 | 保持庞大的研究可恢复，同时热切换保持紧凑。 |
有用的边缘词汇
| 边缘 | 意义 | 示例 |
|---|---|---|
references | 记录指向路由、文件、模式、源或公共工件。 | .uai/public-surface.uai 引用 /en-us/tools/validator/。 |
containsRecord | 一个包包含一个类型化的内存记录。 | AGENTS.md 包含所需的 @uai[] 加载列表。 |
appliesTo | 约束、检查或决策适用于文件、路径、包或声明。 | 支持声明边界适用于 AI 内存包向导。 |
requiresCheck | 更改的表面需要在完成前进行有针对性的检查。 | 向导更改需要集中的向导检查。 |
blockedBy | 在指定事实或所有者决定存在之前，工作项无法继续进行。 | 发布完成因缺少生产上传而受阻。 |
approvedBy | 一个人、审阅笔记、版本或公共工件接受了更改。 | 变更日志条目批准当前的公共支持措辞。 |
mayReverseWhen | 当特定证据出现时，决定可能会改变。 | 只有在固定装置和所有者存在之后，计划的适配器才能成为当前的。 |
hasTrustBoundary | 记录带有隐私、秘密、支持、区域设置或破坏性操作边界。 | File Handoff禁止执行删除的文件。 |
archivesToColdMemory | 庞大的历史记录通过转移证据摆脱了热切换。 | 旧的摄入报告与校验和和摘要一起存档。 |
wasDerivedFrom | 公共或生成的记录来自指定的源材料。 | 路线图项目源自经过审查的摄入报告和当前的公开证据。 |
标识符策略
使用稳定的标识符来表示持久的事实，使用快照标识符来表示过时的状态。图形节点不应依赖于可能被重写的标题、可能移动的文件路径或可能本地化的页面slug。将人类可读的标签放在靠近节点的位置，但将稳定 ID 视为引用句柄。
uaix:project/uaix
uaix:handoff-bundle/uaix-local
uaix:record/.uai/constraints.uai
uaix:constraint/no-automatic-repository-writes
uaix:claim/ai-memory-wizard-current-output
uaix:check/scripts-test-uaix-ai-memory-bundle
uaix:snapshot/2026-05-06-project-handoff-kg-guide标准预测
项目移交不需要 RDF 或 JSON-LD。当项目确实需要图形交换时，请使用标准作为对已审查内存的投影，而不是作为文件束的替代品。
| 标准 | UAIX 使用 | 边界 |
|---|---|---|
| RDF | 将经过审查的移交语句表示为三元组和命名图表。 | 仅在审核源文件后导出。 |
| JSON-LD | 使用显式上下文共享 JSON 中的图形元数据。 | 适用于派生覆盖和面向网络的结构化记录。 |
| 普罗沃-O | 模型推导、来源、参与者和评论事件谱系。 | 保留原始证据；出处标记是一个指针，而不是证据本身。 |
| SHACL | 描述所需 ID、源跟踪、所有者和声明状态的图形形状检查。 | 失败的图表 lint 会阻止导出准备；它不应该自动重写源。 |
| SPARQL | 对经过审查的图形投影运行黄金查询。 | 公共查询端点仍然不受当前支持。 |
| SKOS | 管理标签、别名、广义/狭义概念和受控术语。 | 在较重的本体承诺之前有用。 |
| 猫头鹰 | 仅当领域语义稳定时才添加形式本体规则。 | 不要引入隐藏来源不确定性的推理。 |
RDF、属性图和 Markdown 角色
最安全的 UAIX 模式是源文件规范、RDF/JSON-LD 功能且属性图友好。文件保留写入路径。标准和图形数据库是为工作选择的预测。
| 层 | 用它来 | 请勿将其用于 |
|---|---|---|
| 项目移交文件 | 权威的当前记忆、约束、决策、摄入结果、检查和人类可读的审查。 | 大量的图遍历或外部链接数据交换本身。 |
| JSON-LD/RDF/Turtle 投影 | 稳定的语义交换、命名图快照、出处、SHACL 验证和符合标准的图发布规划。 | 替换已审查的文件包或隐藏推理背后的不确定性。 |
| 属性图投影 | 影响分析、图形探索、关系仪表板、Cypher 式工作流程和操作导航。 | 成为可能偏离 AGENTS.md、.uai/readme.human 和 .uai 的第二个事实来源。 |
| 矢量或图形辅助检索 | 查找可能的相关记录、扩大社区并收集证据包。 | 将检索到的文本、生成的答案或最近邻置信度提升为可接受的项目真相，无需审核。 |
派生图管道
- 解析切换包：读取
AGENTS.md、.uai/readme.human，加载.uai记录、选定文档、公共路由和证据账本。 - 规范化身份：为项目、记录、部分、声明、约束、决策、检查、文件、路线和快照创建稳定的 ID；将标题和别名保留为标签。
- 先摘录回顾事实：在 LLM 提取之前使用前言、标题、显式
@uai[]链接、路线注册表、路线图 ID、测试计划规则和摄入分类帐。 - 附上出处：每个声明、约束、决策、检查和归档指针都应该说明哪个源文件、部分、路径、校验和、审查事件或版本产生了它。
- 证实：在导出或检索使用之前运行架构检查、图形 lint、SHACL 样式形状检查、黄金切换查询和支持声明检查。
- 向外投影：仅在审查的文件状态一致后才发出 JSON-LD/RDF/Turtle 或属性图加载。
- 刻意回信：接受的发现返回到当前的移交文件、文档、代码、测试、路线图、变更日志或机器工件；图缓存本身不是写回目标。
主张和证据陈述
| 状态 | 意义 | 允许的切换行为 |
|---|---|---|
proposed | 摘自报告、LLM 草稿、旧注释或未经审阅的页面。 | 仅用作背景；不作为当前支持出现。 |
reviewed | 检查来源、所有者、矛盾、敏感性和目标表面。 | 当工作与当前任务和限制相匹配时，可以指导工作。 |
current | 提升为活动文件、公共页面、机器工件、测试、发行说明或路线图状态。 | 可以作为操作事实加载，直到被取代。 |
stale | 已知已过时、不确定、已被取代或位于当前路线/支持面之外。 | 保持可见的历史；未经新审查，请勿使用。 |
blocked | 私人的、不安全的、不受支持的、矛盾的或缺乏权威的。 | 在晋升之前停下来询问人员或询问业主的路线。 |
黄金移交查询
- 哪些限制适用于该路线、包装、测试或公开声明？
- 哪些决定改变了这个文件，哪些证据可以让我们逆转它们？
- 目前哪些说法缺乏公开证据、测试或匹配的机器工件？
- 哪些活跃的导入文件与当前提示相关并且仍然需要实际的项目工作？
- 哪些庞大的报告被移至冷内存，哈希值在哪里，以及哪些内容被提升回热内存？
- 在该更改可以称为完成之前需要进行哪些检查？
- 哪些事实可以安全地与外部共享，哪些事实是私有的、不受支持的、过时的或仅作为背景的？
图辅助检索边界
图形辅助检索可以帮助接收代理更快地找到正确的记录和关系路径。它仍然必须引用源文件，揭露矛盾，保留支持边界标签，并将答案视为候选，直到满足正常的项目移交升级规则。检索是协助；回顾记忆仍然是权威。
向导支持
AI 内存包向导可以为有意使用更深 wiki 层的项目规划图内存配置所需的 LLM Wiki 知识图字段。这些字段应命名图策略、稳定 ID 策略、验证策略、导出策略和查询策略。生成的计划仍然是本地计划文件，不会创建自动同步或公共图形服务。
促销规则
仅当底层事实被审查并提升到当前表面时，图事实才变得可操作：AGENTS.md、readme.human、类型化 .uai 记录、规范文档、公共页面、代码、测试、发行说明、路线图状态、变更日志、验证器证据或机器工件。图形缓存、嵌入结果或 LLM 答案是不够的。
相关记录
- 项目交接规范的存储库本地内存包。
- 人工智能记忆便携式内存框架和支持的入门包。
- AI内存封装向导生成的本地文件和长期指针账本配置。
- 背景预算保持热切换内存紧凑，同时将大量图形证据移至冷内存。
- Agent File Handoff在图表或记忆力提升之前配置主动摄入。
- LLMWikis.org 知识图谱LLM Wiki 图形设计的更深入的手册指南。
- 路线图当前与计划的图表、适配器、同步、SDK、CLI 和一致性边界。
- 变更日志注明日期的公共变更轨迹。
分层目标记忆
将图形就绪的切换记录与分层目标记忆通过将图视为派生内存层次结构，而不是事实的来源。