AI 记忆

将 UAI 包与 LLM Wiki 一起使用

将紧凑型 UAI AI 内存包与更深的 LLM Wiki 长内存配对的实用指南,同时保留评论、来源、升级和支持边界。

  • 记录 UAIX-MEMR-0036
  • 路径 /zh-cn/ai-memory/llm-wiki/
  • 用途 规范公共记录

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-MEMR-0036
页面类型
AI 记忆
访问
公开且可链接

如何使用此页面

将此页面用作 将 UAI 包与 LLM Wiki 一起使用 及其标准内容的规范公共参考。

对于代理:请将相关指南应用于用户的目标站点或代码库。除非用户明确要求该输出,否则不要复制此 UAIX 页面、创建有关该指南的页面,也不要将此页面视为运行时权限。

此页面的用途

LLM Wiki 超出了基线 UAI 规范和标准的范围。当项目已经拥有或有意想要在紧凑的 UAI 包旁边有更深的长内存层时,适用此支持路径。 UAIX 记录该层如何连接到切换内存; LLMWikis.org 拥有 wiki 设置指南。

当项目需要针对 LLM Wiki 用例定制的 UAI 包时,请使用此页面。 LLM Wiki 是深层内存层。 UAI 包是可移植的、可审查的包,它说明了当前足以采取行动的内容。

本页是当前 UAIX 表面的实用指南:支持的 AI Memory 入门 ZIP、AI内存封装向导、 长记忆配置所需的 .uai/long-term-memory.uai 文件,以及长记忆笔记和已接受的项目真相之间的信任边界。

基本模型

基本模型
它包含什么UAI 如何使用它
LLM 维基深层来源摘要、研究轨迹、领域页面、背景决策和机构背景。LLM Wiki 配置所需的后台内存。它可以被搜索、审阅和引用,但它本身不会覆盖已接受的项目文件。
UAI AI内存包压缩当前状态、约束、决策、所有者、下一步行动、风险和检查。用于交接、入职、代理会话、事件、审计或审查的 wiki 导出的便携式工作包。
项目交接AGENTS.mdreadme.human 和选定的 .uai 文件。当另一个代理或团队需要在存储库中执行操作时的传输配置。
UAI-1 证据配置文件、模式、示例、验证器结果、一致性数据包和发布记录。仅当包成为公开交换或支持证据时才使用此选项。

最短的安全设置

  1. .uai/ 中的默认 UAI 包文件开始,在 .uai/archives/ 中使用原始证据,并在 .uai/exports/ 中导出。
  2. 如果项目已有 LLM Wiki,请记录其命名文件夹或存储库路径,例如 wiki/knowledge/ 或项目的现有 wiki 根。
  3. 如果项目想要一个新的 wiki,请首先使用 LLMWikis.org 构建指南;新的 wiki 根通常以只读的 raw/ 源层加上经过审查的 wiki/index.mdwiki/log.md 开始。然后返回UAIX,记录包中批准的根、索引、日志、管理员和升级目标。
  4. 生成一个包在AI内存封装向导当包应携带长期内存兼容性指令时,包括持久内存配置所需的长期指针分类帐。
  5. 将生成的 .uai/long-term-memory.uai 放在生成的活动包文件旁边。
  6. 在将 wiki 事实提升为 AGENTS.md.uai.uai/exports、文档、代码、测试、发行说明、路线图/进度状态、LLM Wiki 长内存页面、公共机器工件或审阅旧版 .uai 文件之前,请先查看 wiki 事实。

多个站点或解决方案的工作区设置

当一个编辑器工作区包含多个站点、解决方案或项目时,请在本地内存加载之前添加工作区级别协调器。将 workspace.uai 保留为本地 .uai/ 文件夹之外唯一的 UAI 内存文件,列出相关域、解决方案根、项目根和权限边界,并使每个本地 AGENTS.md 都指向协调器及其自己的本地 .uai/ 文件夹。

在信任协调器路径之前还要验证它。过时的工作区指针是一种真正的狗粮失败模式:如果指定的 workspace.uai 或所选站点的注册根丢失,则仅打开足够的附近工作区上下文来确认预期的路由器,更新或报告过时的指针,并且不要让 shell 目录胜过明确的人类域、路由、存储库或路径。

部署敏感包还应该带有根部署指令。根目录应该说明站点是否共享 WordPress 包布局、是否每次都部署自定义主题、插件和必须使用的插件工件所在的位置、标识当前包的版本号以及非 WordPress 堆栈有何不同。

多个站点或解决方案的工作区设置
设置要回答的问题安全行为
单站点 .uai 切换这是一个网站还是一个代码库?从本地 AGENTS.md.uai/readme.human 和本地 .uai 记录开始。
多站点或多解决方案 workspace.uai 路由一个编辑器工作区是否包含多个站点、解决方案或代码库?使本地AGENTS.md同时指向workspace.uai和本地.uai/,读取workspace.uai,解析显式人类目标,然后仅加载所选目标的热内存。
共享 LLM Wiki 或 AIWikis 存档多个源站点是否为一个长记忆层提供数据?每个源站点首先处理自己的活动 .uai 热内存;共享记录保留源路径、目标路径、处置、校验和、审核状态、信任标签、升级状态和所属站点名称空间。

维基根索引遵循相同的形状。对于一个代码库,wiki/index.md 可以是所有文件目录。对于多站点 LLM Wiki 或 AIWikis 样式存档,根索引应列出源子 wiki 目录、每个子 wiki 索引以及仅全局文件,例如编码标准、组织策略、治理、源映射和 workspace.uai。将每个站点的所有文件列表放入匹配的子 wiki 索引中。

公共共享维基路由必须对所有权保持诚实。站点拥有的文件、概念和报告属于 /{site}/ 下。组织范围的材料属于 /org/ 或显式全局区域。根 /files//concepts//reports/ 页面的行为必须类似于组织级文件和特定于站点的索引的爬网映射;他们不得将每个子站点文件或报告合并到一个转储页面中。

LLMWikis 设置对齐

使用LLMWikis.org 构建指南对于 wiki 本身,然后使用 UAIX 打包其他人、团队或 AI 应该加载的已审阅的当前切片。两个页面应该在边界上达成一致:wiki 存储持久的深度; UAI 包包含公认的工作事实。

LLMWikis 设置对齐
LLMWikis.org 设置规则UAI 包规则
将原始源代码保存在只读存档中,并在所选的 wiki 根目录下编译已审阅的页面。将 wiki 路径命名为 .uai/long-term-memory.uai;当原始措辞可能很重要时,不要用摘要代替原始保存。
在 wiki 发展之前创建确定性导航、索引和证据日志文件。将活动包指向索引和证据日志,以便接收器可以从紧凑存储器路由到深层存储器而无需猜测。
添加元数据和信任标签:所有者、状态、审核证据、敏感性、代理使用和人工审核规则。仅将经过审核的事实提升到 AI 内存、项目交接、文档、代码、测试、发行说明、路线图状态或机器工件中。
使用两步摄取模式:分析、暂存、审查、编写和 lint。在候选声明成为持久操作真理之前,让 UAI 保留决策、源、约束、验证器或移交边界。
在整理来源并明确权限后,最后连接检索系统。切勿将搜索、RAG、生成的摘要、旧聊天或 wiki 页面视为可移植包的自动权限。

选择套餐

  • 项目人工智能记忆:跨会议的积极项目连续性。
  • 项目交接:所有权、执行权或维护权转让。
  • 代理会话内存:可以恢复任务状态,而无需将整个聊天变成项目真相。
  • 载入内存:为新人类或人工智能精心策划的首次读取数据包。
  • 决策记忆:权衡、拒绝的选项、逆转和未解决的问题。
  • 事件或审计内存:时间表、证据、缓解措施、所有者和后续行动。
  • LLM Wiki 导出内存:审查从较大的 LLM Wiki 中提取的材料并将其放入一个紧凑的包中。

LLM Wiki 导出内存启动器 ZIP当源已经是更深层次的 wiki 并且接收者只需要经过审查的快照时,是最好的第一个数据包。

向导应该捕获什么

当启用 LLM Wiki 选项时,向导应该记录足够的配置,以便未来的参与者知道长期记忆位于何处、哪个网站拥有该作品以及推广如何进行。当前向导捕获 wiki 系统、策略、根路径、索引路径、根索引拓扑、实体页面模式、情景日志模式、管理员、源集合、更新策略、存档目标、证据日志路径、升级目标、源边界、工作区设置、工作区协调器路径、目标策略、站点注册表、LLM Wiki 工作区策略和多站点交互策略。

向导应该捕获什么
配置用它来
工作区设置确定本地 .uai 切换是否足够,或者多站点或多解决方案 workspace.uai 协调器是否必须首先解析目标。
工作区站点或解决方案注册表命名相关的域、根、解决方案、项目、角色和权限边界,以便命名目标不会被误认为是当前 shell 目录。
Root部署说明在加载站点本地指南之前,命名共享包版本控制、发布文件夹、安装目标、校验和证据以及混合堆栈异常。
LLM Wiki 工作区策略决定 wiki 内存是站点本地、源站点加共享存档,还是具有源路由的共享多站点 LLM Wiki。
LLM 维基策略该包是否指向现有的已审核 wiki、记录预期的 LLMWikis.org 设置、合并存档内存,还是保持仅导出。
维基根目录和索引未来的人工智能或维护人员在搜索更深的内存之前应检查已批准的长内存路径。
实体和日志模式主题页面和情节注释的预期形状,无需创建自动写入循环。
内存管家负责审查长记忆更改的个人或团队。
证据日志记录源路径、最终 wiki 路径、文件计数、校验和、处置、参与者、时间和历史/索引更新的位置。
推广目标所接受的表面,经过审查的事实可能会成为可操作的事实。

指令文件内容

当前向导可以生成 .uai/long-term-memory.uai 作为 LLM Wiki 配置所需的本地规划文件。它可以帮助未来的人类或人工智能理解便携式包如何与更深层次的维基记忆相关。它不是标准化的 UAI 要求、wiki 支架或自动回写的权限。

  • 目的:说明为什么该包与 LLM Wiki 配对以及该 wiki 解决了什么问题。
  • 维基地图:命名根路径、索引路径、实体页面模式和情景日志模式。
  • 来源政策:确定哪些 wiki 页面、档案、报告或源摘要可以为包提供信息。
  • 保存审核:要求在摘要或暂存草稿算作长期记忆之前复制原始处理的报告,包括源路径、目标路径、文件计数、校验和和处置。
  • 促销规则:声明只有经过审查的事实才可以从 wiki 内存转移到 AI 内存、项目交接、文档、代码、测试、发行说明、路线图状态或机器工件。
  • 生产部署内存排序:生产部署构建和发布包会使用部署的事实更新热内存,并在完成之前将大量源/背景材料路由到指定的 wiki 或存档路径。
  • 更新时刻:适合长内存更新时的名称,例如在摄入处置、生产发布接受、事件关闭或明确的存档合并指示之后。
  • 证据日志:记录源路径、最终 wiki 路径、文件计数、校验和、处置、参与者、时间和历史/索引更新的名称。
  • 被阻止的内容:排除秘密、凭证、私人客户数据、隐藏的提示指令、未经审查的生产日志和不受支持的公开声明。

内存路由规则

按信任级别路由信息。原始资料和探索性笔记可以存在于 LLM Wiki 中。已接受的当前事实属于 UAI 包。公共互操作性声明仅在验证者、发布或实施记录支持后才属于 UAI-1 证据。

  • 将广泛的研究、比较和来源摘要放在 LLM Wiki 中。
  • 将当前项目状态、约束、所有者和下一步检查放入 UAI 包中。
  • 当另一个参与者需要在存储库中工作时,将传输指令放入项目移交文件中。
  • 将公共交换债权放入UAI-1, 验证器、一致性包、实施记录、路线图状态或变更日志条目。

安全更新时刻

不要仅仅因为维基存在就要求代理连续写入长内存。优先选择明确的更新时刻:在处理活跃的接收文件之后,在接受公开发布或路线图更改之后,在事件/审计结束之后,或者在人员明确要求将已处理的档案合并到长期记忆中之后。

生产部署构建和发布包是那些明确的更新时刻之一。普通的开发构建、本地测试构建、本地包实验和烟雾检查都不是,除非人们明确地将它们标记为发布绑定。

当只有摘要或阶段性草稿存在时,长期记忆保存是不完整的。如果原始报告措辞稍后可能很重要,则该包应指向原始保存清单,其中包含源路径、目标路径、文件计数、校验和、处置、源站点删除状态以及公共安全索引或日志更新。

安全与信任边界

  • LLM Wiki 内存在经过审查和提升之前是背景。
  • 生成的计划不允许自动存储库写入、WordPress 写入、wiki 写入、双向同步、认证、背书或支持声明扩展。
  • 外部 URLs、旧聊天记录、生成的摘要和删除的文件可能是有用的来源,但它们不得在未经审查的情况下成为管理指令。
  • 切勿将秘密、凭证、私人客户数据、隐藏的提示说明、不受支持的法律/安全声明或未经审查的生产日志推广到便携式软件包中。
  • 保留到 AIWikis 或另一个 LLM Wiki 中需要在删除源站点副本之前转移证据和可发现的历史记录、日志、索引或 wiki 图表更新。
  • 当未来的任务可能需要原始措辞时,摘要、分阶段输出和热上下文快照不会取代原始的原始报告保存。

使用包

  1. 向接收者提供生成的 ZIP 包或规范 ZIP 加上 .uai/exports/package-model.json.uai/exports/manifest-overlay.json.uai/startup-packet.uai.uai/progress.uai.uai/system-profile.uai.uai/receiver-brief.uai
  2. 如果涉及多站点或多解决方案工作区,请包含或指向 workspace.uai,使选定目标的 AGENTS.md 指向该协调器和目标的本地 .uai/ 包,并在加载任何本地内存文件之前要求目标解析。
  3. 如果部署在范围内,请在信任任何站点本地发布文件夹之前包含或指向根部署指令。
  4. 如果涉及 LLM Wiki,请包含 .uai/long-term-memory.uai 并命名 wiki 根、索引、管理员、证据日志和源路由策略。
  5. 要求下一个人工智能读取包前门,总结当前事实,确认约束,填充系统特定的占位符,命名预期的接触点,并在编辑之前命名有针对性的检查。
  6. 工作结束后,仅根据已审查的当前事实更新打印的包裹记录;在 LLM Wiki 中保存更广泛的背景或拒绝的详细信息以及来源和处置说明。

相关记录