Introduction

Orisumi 保存一个人经历了什么。经历会过去，软件会更替，但留下的记录仍应清晰可读。

人会换设备、换应用、换 AI 助手，留在这些软件里的信息也随之散落。Orisumi 把它们收拢成一份属于用户的记录：用过的应用、键鼠活动、浏览历史、健康数据，以及模型的推断和用户的确认、否定。这样定位的理由见 ADR · 定位与边界。

核心想法复制章节链接

• 每一份观测说明四件事：谁负责、说了什么、依据什么、事实在什么时间成立。
• 数据改动时形成新版本，旧版本保留。引用指向确定的版本，所以追溯时看到的是当时的内容。
• 每种数据的字段和含义由 EntitySchema 声明，和数据保存在一起，换了软件也能读懂。
• 后端只检查结构。一件事实怎样判断，由各来源的业务规则决定。

名称复制章节链接

Orisumi（オリスミ）由「織り」和「澄み」两个词组成：把不同来源的经历织在一起，让它们一直看得清楚。汉字写作「織澄」，正式名称用 Orisumi。

从哪里开始复制章节链接

第一次读，按这个顺序：

1. Walkthrough：用一天的数据走一遍主要概念。
2. Core · Overview：Core 的全貌，以及各类型之间的关系。
3. Core 的类型页：Entity、Version、EntitySchema、Observation、InputSet、Observer。

遇到不熟的词，查 Glossary。想知道某个决定的理由，读 ADR。

Graph 展示 Core、ADR 和 Observers 页面之间的引用关系，可以沿节点打开相关文档。

有具体任务时，从这里进入：

文档地图复制章节链接

重写状态复制章节链接

给 Agent复制章节链接

每个页面都有 Markdown 版本，地址是页面路径加 .md，例如 /core/model/version.md，其中的链接也指向 Markdown 版本；全站内容在 /llms-full.txt。在仓库中，直接读 src/Docs/Orisumi.Docs/content/docs/。工作规则见根目录的 AGENTS.md。