术语表 · 简体中文
理解术语。 核验行为。
先从通俗定义开始,再了解 Topoloom 如何使用该术语,以及在你的部署中需要验证什么。
定义说明当前的产品用语;评估说明展示如何在部署中检验每个概念。
产品定义
Topoloom 如何使用每个概念。
每个条目把通俗定义、在产品中的应用,以及需要在具体部署中验证的行为分开说明。
- Workspace
定义供人员与知识使用的独立区域,拥有自己的访问边界。每个文档、图表、对象和成员资格都属于一个 Workspace;每次请求都会核验其中的有效成员资格。
Topoloom 如何应用它Topoloom 把 Workspace 作为 Trust 页面所述租户隔离的单位。在检索、投影、导出、事件投递或提供方访问之前,范围都会先被强制执行。拒绝不会透露该条目是否存在。
在你的环境中验证验证哪些查找、搜索、自动补全和计数按成员资格限定范围,以及被拒绝的请求返回什么。然后检查在多个 Workspace 中拥有角色的人,是否可能看到另一个 Workspace 的标识符或标题。
- Library
定义一个人在 Workspace 中可以读取的文档和图表列表。它显示每个条目的类型和状态,并根据当前访问权限筛选结果。
Topoloom 如何应用它Topoloom 在平台页的截图 S1 中展示了 Library:文档和图表共用一个列表,旁边是 Collection 导航和私有草稿视图。
在你的环境中验证验证 Library 在每一页都重新校验权限,且过滤后或为空的结果不会透露你看不到的条目。然后检查文档与图表共处一个列表时,标题搜索、排序和分页的行为。
- Collection
定义Workspace 内对文档和图表的组织性分组。Collection 最多可嵌套五层;层级用于组织导航,父子之间不会继承任何访问权限。
Topoloom 如何应用它Topoloom 的产品截图中使用了 Engineering、Operations 和 Team Handbook 等 Collection。Trust 页面的权限规则把 Collection 视为一个授权目标,而不是权限边界。
在你的环境中验证验证当一个人能读取子 Collection 却读不到其父级时,会看到什么。再检查归档或删除是否级联,以及移动 Collection 是否会改变谁能读取其内容。
- Document Graph
定义由人在 Topoloom 中编写的内容构成的关联模型。它通过稳定身份连接文档、图表、块、声明、可复用对象、引用、关系和版本。
Topoloom 如何应用它Topoloom 用 Document Graph 指代文档和图表共同构成的已编写模型。它不同于下游的 Context Graph——后者可以解析实体并附加证据,但从不在没有授权人员命令的情况下写入已编写状态。
在你的环境中验证验证图通过公开契约暴露哪些节点和关系类型、如何从 PostgreSQL 重建,以及任何提供方或搜索投影是否能改变它。图形化的模型不等于图数据库,也不意味着权威的运行事实。
- 稳定身份
定义一个持久的身份,用于在各个编写界面和版本中指代同一个建模概念,而不是把每次提及都表示为无关的副本。
Topoloom 如何应用它Topoloom 在讨论跨文档、图表、Runbook、SLO、审查和导出的复用时使用这个术语。
在你的环境中验证验证标识符的范围、生命周期、合并行为和授权规则,再检查它在重命名、删除、恢复、导入和导出之后的表现。身份稳定本身并不能说明一条陈述正确或仍然当前。
- 声明
定义由人在一份文档中确认的类型化陈述,例如带有负责人的 Service。它锚定于其源块,并记录身份、作者、时间、生命周期以及任何已声明的关系。
Topoloom 如何应用它Topoloom 把声明作为渐进式形式化的第一步正式操作:可读的正文获得一个声明,而不必变成表单。在授权人员把它提升为可复用对象或链接到现有对象之前,声明始终属于其所在文档。
在你的环境中验证验证声明如何创建、编辑、解除链接,并在不丢失内容的情况下变回普通文本。检查协作、撤销、恢复和导出之后还保留什么。确认分析、导入或提供方都不会在无人接受的情况下创建声明。
- 可复用知识对象
定义一条供文档和图表指向的共享、版本化记录。经授权人员通过创建新的不可变对象版本来更改其属性,同时保留早期版本。
Topoloom 如何应用它Topoloom 的 Payment Service 例子是一个可复用对象。它的负责人、重要级别和版本都在截图 S7 的对象页面上,而文档和图表按身份引用它。
在你的环境中验证验证创建对象需要明确的授权命令,且两个同名对象绝不会被合并。检查 Used in 列表只显示你有权阅读的不可变制品版本。再询问限制或 tombstone 一个对象,会如何影响已有的引用。
- 引用
定义从文档块或图表节点指向一个可复用对象的指针,存储目标身份以及 follow-current 或 pinned 版本之一。它从不把对象的权威属性复制到文档内容中。
Topoloom 如何应用它Topoloom 的承诺“引用,而不是再复制”指的就是这一机制。在产品中引用标记为 ↗;对象的共享属性在对象页面上变化,而可见的措辞在文档中变化。
在你的环境中验证验证 follow-current 引用与 pinned 引用的区别,以及当目标不可用或无权访问时读者会看到什么。确认渲染、搜索、导出和发布每一次都会重新校验目标的权限。
- Knowledge Map
定义在明确范围内查看已声明或被引用知识的视图。Content和Map是文档模式。Map还可以探索你有权阅读的选定源。
Topoloom 如何应用它Topoloom始终显示每个Map的源范围。Map呈现其来源中的知识;它不是单独人工编写的Diagram。
在你的环境中验证验证每个源的范围和当前访问权限。检查文档Map编辑是否使用正常的保存和撤销路径。Map不能证明生产环境实际部署了什么。
- 语义图表
定义一个独立的图表成果物,其节点可以引用可复用对象,其已声明的边带有类型化的关系。自由形式的连接线仍标注为未声明;只有明确的语义边才进入关系投影。
Topoloom 如何应用它Topoloom 在截图 S6 中比较的 支付授权示例 使用的就是语义图表。显式触发的自动布局只整理几何位置:箭头、距离、颜色和布局从不意味着关系。
在你的环境中验证验证哪些类型的边算作已声明,以及仅供视觉的连接线如何在不只依赖颜色的情况下被标注。检查显式自动布局会写入什么,以及布局或渲染失败时已声明的关系保持不变。
- Structured fact
定义一种从文档中声明关系的方式,可使用表单、受控句式、表格或以制表符分隔的行。Topoloom 以固定规则解析输入,并将产生的变更作为一个整体写入,或完全不写入。
Topoloom 如何应用它Topoloom 在正文选择之外提供 Structured fact,作为进入同一模式的第二条路径。含糊的名称、过期的端点、重复项和自环会在写入任何内容之前失败;不涉及模糊匹配或模型。
在你的环境中验证演示三种输入:从表格批量录入、一个含义不明的端点,以及一条重复关系。验证文档视图会依据当前状态显示得到的事实分组,并且撤销会移除整批内容。
- Knowledge Review
定义对已保存文档显式启动的分析,将声明和关系作为候选项提出。当前分析在离线状态下应用固定、确定性的规则,不使用模型;候选项在由人逐项接受或经确认批量接受前均不具权威性。
Topoloom 如何应用它Topoloom 在 Trust 页面的截图 S3 中展示了带有 Ready、Decisions 和 Represented 标签页的 Knowledge Review。接受时会针对锁定的当前文档重新推导每个候选项,并在写入前披露其影响;不会隐式发布任何内容。
在你的环境中验证验证什么会触发分析,以及是否调用了任何模型或提供方。检查当候选项的源文本在其下方发生变化时如何处理,以及两次接受同样的建议不会产生重复。建议永远不会被呈现为已声明。
- 成果物版本
定义一份文档或图表的已保存快照,可在不改变它的情况下按地址读取。它包括内容、声明、来源、源位置和内容哈希。发布读取的是这份快照,而不是实时草稿。
Topoloom 如何应用它Topoloom 在截图 S6 中的 Version 1 Baseline 和 Version 2 Current 就是成果物版本。它们不同于对一个可复用对象做快照的对象版本,也不同于普通的修订历史。
在你的环境中验证验证已发布版本永远无法被编辑或清除,且恢复会创建新版本而不是改写历史。检查每一次读取都会重新校验当前用户的权限,并询问在你的部署中版本、对象版本与修订之间有何区别。
- 来源
定义关于一个条目来自哪里、如何到达当前状态的上下文,用于帮助读者判断其权威性和历史。
Topoloom 如何应用它Topoloom 把来源与人工声明、建议、外部观察、版本、关系、审查和导出关联起来。
在你的环境中验证验证实际记录的字段、其出处、可变性、可见性、保留和导出行为。存在来源标签并不能证明底层信息源是准确的。
- 语义审查
定义除已编辑的文本或图表几何之外,聚焦于建模含义变化(如身份、归属、生命周期或关系)的审查。
Topoloom 如何应用它Topoloom 会比较两个已保存版本,并以可读语言描述负责人、依赖、SLO 和 Decision 的变更;这些变化以稳定身份而非行位置为依据。截图 S6 报告了一张图表两个版本之间的五项语义变更。
在你的环境中验证演示可以检测哪些变更类型、影响如何计算、审查者可以检查什么,以及哪些内容仍在审查之外。范围可能取决于工作流和配置。
- Knowledge Contract
定义一套用于受治理发布的版本化规则。它结合模板、必需和可选结构、校验、归属和审查策略,同时允许普通草稿保存。
Topoloom 如何应用它Topoloom 内置了一个契约:Service Overview v1。它要求在受治理发布之前具备 Service 名称和 OWNED_BY Team,并在高重要级别的 Service 缺少 SLO 或 Runbook 链接时发出警告。未完成的草稿仍可保存;自行编写契约属于之后的治理阶段。
在你的环境中验证验证校验只会阻断受治理的发布,绝不会阻断普通保存。检查发布会连同已批准的审查,一起评估确切的制品版本与对象版本。确认豁免需要权限、理由、范围、有效期和审计记录。
- 访问授权
定义向个人或群组显式授予读取、编辑或管理 Collection、文档或对象的权限。每项授权都会记录理由和有效期,或明确选择为永久;PostgreSQL 始终是访问权威。
Topoloom 如何应用它Topoloom 的 Trust 控制项描述了遵循权限的界面,而访问授权正是其背后的机制。限时授权从五分钟到 365 天不等,有效期由授权所读取的数据库视图来强制执行。任何缓存、后台进程或浏览器状态,都无法把过期授权变成放行。
在你的环境中验证验证 Workspace 角色上限,以及当一个人被停用、重新启用或移除时,授权会发生什么。检查最后一位仍在活动的管理员无法被移除,以及过期授权在有权续期的管理者眼中如何呈现。
- Living Binding
定义一种把注明来源的外部上下文放在已编写声明旁边的连接,用于比较和人的明确操作。
Topoloom 如何应用它Topoloom 使用 Living Binding 将已编写状态与外部来源的观察清晰区分。提供方证据会保留提供方名称和检查时间。经测试的参考工作流使用模拟提供方;任何真实连接器都应单独确认。
在你的环境中验证验证支持的来源、刷新行为、来源标注、失败和过期状态的标签、权限检查,以及外部输入成为已编写知识之前所需的操作。
- Portable Knowledge Package
定义一个范围明确的导出,把可读的知识与有版本的结构化上下文一起打包,以便在 Topoloom 之外检查。
Topoloom 如何应用它Topoloom 用这个术语指可读内容、稳定身份、版本、关系、来源、审查、权限映射和明确的损失报告一起移动。源链接 Diagram 导出使用 topoloom.package/4;/1 至 /3 格式的包仍可读取。截图 S8 显示的是已完成的导出,而非归档内容。
在你的环境中验证索取包含格式和字段的精确清单,检查省略和转换,并在 Topoloom 之外打开该包。仅凭包的名称不能保证完整性。
