# me.api — 产品与体验 Spec

> source: 文章/me-api-spec/index.md

# me.api — 产品与体验 Spec

> 版本：v0.4 · 需求对齐草案  
> 日期：2026-09-21  
> 状态：连接性与个人独特性是核心；可操作的思考方向已认可，具体交互机制未定。Agent 加工、本人决定发布及管理后台已确认。当前不进入实现。  
> 一句话：让人探索我的思考，让机器准确读取我选择公开的部分。

## 0. 如何阅读这份 Spec

本文区分三种信息：

- **明确诉求**：你在历史对话或本次请求中直接表达过。
- **建议方案**：历史 GPT 建议或本轮整理提出的方案，需要你确认，不能自动视为需求。
- **待决策**：会改变范围、成本或体验方向的问题。

本文的 P0/P1/P2、验收数字、接口路径均为实现建议；标明已确认的产品能力不再是可选项。具体交互提案尚未批准，不代表整份 Spec 已冻结。

### 参考来源

- **S1：[自我蒸馏与 Skill 讨论](https://chatgpt.com/share/6ab0ae06-2930-83e8-9a0d-f0eff9176dca)**。你明确提出了解相关项目；具体项目机制与组合架构是当时 GPT 的回答，不能据此推定你已选定技术方案。
- **S2：[个人展示、问题探索、语言交互、Gravity 与 me.api 讨论](https://chatgpt.com/share/6ab0ae38-8ecc-83ee-a1ae-739d921d7172)**。
- **S3：本轮需求确认**。你明确选择 A > B > C；以同好发现你并获得启发为首要目标，同时帮助陌生人和潜在合伙人了解你；Gravity 是独立的采集与加工应用，处理结果进入 me.api 作为部分展示内容。
- **S4：第二轮需求确认**。展示以想法和做成的作品为主，失败可成为重要内容，不展示生活片段等隐私内容；希望深邃、代码驱动、交互上有 Geek 气质，而不是视觉上的 Geek 包装；Agent 智能加工，本人决定发布，并要求易维护的后端管理页面。
- **S5：连接性与个人独特性确认**。你认可可操作的思考，但更重视连接性，以及保留属于你的、不是任何人询问 AI 都能轻易得到的内容。
- **R1：当前仓库 `README.md`**。现有内容包括博客、学习笔记、语言资料、日记、随笔和归档；目前不能据此假定它们全部可公开。

已阅读两份分享页可见对话正文。S2 中提到的 `gravity-spec.zip` 及其内部文档未取得，本文不声称读取或继承其完整规范。历史回答中的产品现状、协议版本和 SDK 状态未在本轮独立核验，不作为选型依据。

## 1. 产品定位

### 1.1 要解决的问题

传统个人网站主要展示“已经写好的文章”和“已经完成的项目”，难以呈现：

- 我为什么会问这个问题。
- 我怎样从一个问题走到另一个领域。
- 某个词在我心里究竟意味着什么。
- 我的判断如何随经历而改变。
- 哪些方法是我真正实践过的，而不是 AI 替我编出来的。

me.api 不是把博客换一套皮肤，也不是把个人材料交给模型生成一个人格简介。

**定位表述：一个以个人独特想法及其联系为核心、由本人决定公开范围的认知空间。人类通过探索联系理解我，机器读取同一批有来源和时间的公开内容。**

“me.api”在本 Spec 中暂指整个产品；底层接口称为 Public API，避免把项目误解成只有后端。

### 1.2 明确诉求与来源

| ID | 诉求 | 依据 |
| --- | --- | --- |
| U01 | 不想再做同质化的个人博客；希望真人访问时感到别出心裁 | S2 开场 |
| U02 | 对 Agent 友好，机器能够获取结构明确的信息 | S2 开场及最后一问 |
| U03 | 以问题为入口，支持追背景、加深、发散、抽象与跨领域应用 | S2「我对提问非常感兴趣」 |
| U04 | 不想仅把 AI 生成的内容放进个人展示；信息不应一开始全部铺开 | S2 同上 |
| U05 | 利用已有的单词与语言用法积累，以有趣的交互呈现，同时允许接口获取完整信息 | S2 语言内容讨论 |
| U06 | 对经验蒸馏和 Skill 机制感兴趣，但其优先级低于人类体验和 Agent 读取 | S1、S3 |
| U07 | 先制定 Spec、对齐需求，再开展开发 | 本次请求 |
| U08 | 目标优先级：人类体验 A > Agent 读取 B > Skill 调用 C | S3 |
| U09 | 首要帮助同好发现你，从你的独特想法中学习并获得启发；同时让陌生人和潜在合伙人了解你 | S3 |
| U10 | Gravity 是另一个计划开发的应用：经常性采集生活、学习碎片，处理出联结、深入与发散内容，再进入 me.api 作为展示的一部分 | S3 |
| U11 | 展示想法与做成的作品，失败可成为重要组成部分；生活片段等隐私内容不是公开展示方向 | S4 |
| U12 | 深邃、代码驱动、交互上 Geek 且有新意，不靠传统网页交互或 Geek 视觉装饰定义产品 | S4 |
| U13 | Agent 必须智能加工内容，包括联结、深入、发散；发布哪些内容由本人决定 | S4 |
| U14 | 必须有易维护的后端管理页面，不要求日常维护依赖修改代码 | S4 |
| U15 | 认可可操作的思考，更重视连接性与个人独特性；不以通用 AI 可轻易生成的结果作为展示核心 | S5 |

另外，你对纸张、揉纸、黑洞、吸积盘，以及 Web + iOS 的偏好，是在 **Gravity 采集产品**的讨论中表达的。它们是真实偏好，但是否延伸为 me.api 的视觉主题与平台范围，需要单独确认。

### 1.3 已确认的目标优先级与建议北极星

**A 人类体验 > B Agent 准确读取 > C Skill 调用。** 当范围或设计发生冲突时，优先保护人的理解与探索体验；机器读取应提供清楚结构，但不把人类界面做成 API 文档或数据库浏览器。

基于已确认目标，建议以此衡量产品：

> 同好从一个具体入口发现你，沿真实内容获得一个新的理解、连接或问题；陌生人和潜在合伙人也能知道你关注什么、怎样思考、正在实践什么。Agent 可以准确引用同一批公开材料，而不误认作者归属或时间。

不以文章数量、图谱节点数量、停留时长或 AI 生成量作为主要成功指标。

### 1.4 核心价值约束：个人独特性与连接性

**已确认：你认可操作性，但更重视内容之间的联系，以及不能由任何人随手问 AI 就替代的个人内容。** 这是内容价值优先级，不改变 A > B > C 的受众/能力排序。

建议把它落实为以下规则：

- **个人内容是主体**：具体观察、独特解释、自己选择的问题、实践中的判断与取舍、失败和理解变化。作品的实现约束和真实决策本身也属于这种内容。
- **连接是一等内容**：不只展示 A 和 B，还保留“为什么在我这里，A 会走向 B”。关系可以是启发、应用、反驳、修正、反复出现的问题，不必都是相似或互相支持。
- **先保真，再抽象**：原始表述、细微区别、犹豫和未解之处不应被润色成任何人都能认同的通用结论。摘要用于导航，不能替代原文。
- **通用知识退居背景**：允许提供理解所需的定义、来源与解释，但按需展开、标注来源，不把百科扩写当作个人成果，也不必删除有价值的已有文章。
- **孤立但重要的想法可以保留**：不为了连接性制造假边、堆积节点，或者因为尚未找到联系就淘汰个人内容。

“属于我”不要求证明全世界无人想过，也不靠公开隐私制造独特性。核心是能说明我实际观察、表达、选择或实践了什么；选取与编排可以体现个人性，但我的认可不会将 AI/他人创作变成我的原创。

**建议编辑检验**：如果移除个人材料，仅保留一个主题提问，普通 AI 答复已能替代这一条内容，它更适合作为背景。这个检验是人工取舍提示，不是可计算的原创度证明，也不要求为了检验而额外调用外部模型。

据此，第一份原型应是一小组有真实联系的个人材料，而不是一个独立的通用知识互动演示。

## 2. 使用者与核心任务

**已确认：同好是首要受众；不熟悉你的人及潜在合伙人也是重要受众。** 招聘转化不是当前已确认目标。

| 使用者 | 访问动机 | 产品应帮助其完成的事 |
| --- | --- | --- |
| 同好（首要） | 因共同兴趣发现你，寻找不同的理解或思考方式 | 从你的独特观察、问题和联系中学习，带走一个启发，并理解它为何与你有关 |
| 陌生人 / 潜在合伙人 | 想快速了解你是谁、在关注什么、如何思考和实践 | 获得简明介绍和有内容支撑的认识，不必先探索大量节点才能了解你 |
| 别人的 Agent / 程序 | 受委托了解你或查询你的公开积累 | 检索、枚举、追溯、引用；明确时间与作者边界 |
| 你自己 | 持续积累、筛选和表达 | 低成本把已有内容及 Gravity 产出变成展示内容，修订或撤回 |

**体验建议，待确认：提供两种相容的访问路径，而非两套网站。**

- “从一个有趣的想法开始”：服务同好的自由探索。
- “先认识我”：服务陌生人和潜在合伙人的快速理解，可查看简介、当前关注与代表性实践。

联系方式、订阅和合作邀请是否需要、以什么形式出现，尚未确认。让同好获得启发不等于建立标准教程站；让合伙人了解你也不等于把首页做成简历。

## 3. 核心体验：遇见 → 探索 → 读全 → 带走

### 3.1 遇见

第一次进入，看到一个值得追问的问题、一段独特的语言直觉，或你正在做的事，而不是先面对全部分类和信息图。

要求：

- 明确这是谁的空间，能找到简短自我介绍与可选联系方式。
- 有可以理解的探索入口，不要求访客猜测隐藏热点。
- 同时保留搜索、完整索引与机器入口，不以神秘感牺牲可访问性。
- 首页内容由你选择；首版不依赖实时 AI 来决定“你是谁”。

具体首页构图、主题、字体、配色、动效尚未确定。

### 3.2 探索问题

进入一个问题后，先看到问题本身、简短的个人缘起，以及少量下一步方向。

方向的语义应可区分：

- **缘起**：我为什么问；与“这个概念的学术历史”分开。
- **背景**：理解它需要什么知识，或它的历史背景是什么。
- **深入**：放松某个假设后还会发生什么。
- **抽象**：它属于哪一类更一般的问题。
- **应用**：可以用在哪里。
- **类比**：另一个领域有哪些相似结构，类比在哪里失效。

每次只展开局部；重点不是列出知识上还能联想到什么，而是呈现这些内容在你的思考或实践中为何相连。每条主线连接可查看两端材料、关系理由、谁提出及何时确认；无对应内容时不凑数、不即时编造。

访客可以后退、换分支、回到起点；浏览器返回键应正常工作。作者策展的路径与访客本次走过的路径必须区分。

**演示情境，不是已验证的个人经历**：红绿灯等待人数 → 观测与隐藏状态 → 另一个领域的推断问题。历史对话的举例不能直接作为你真实经历或成立的数学结论发布。

### 3.3 体验语言差异

以少量真实语料做深，不先建设庞大的词典。

一个完整体验可以是：

1. 遇见一个词、句子或两个容易混淆的表达。
2. 选择替换词，或切换一个经过编写的语境。
3. 看到含义、语气或适用边界发生了什么变化。
4. 查看你的解释、例句、反例与参考来源。
5. 打开全文、关联问题或结构化数据。

要求：

- 区分个人直觉、语料观察、词典支持和 AI 补充。
- 语用差异不强行做成唯一正确答案的考试；存在多种解读时明确说明。
- 不靠实时模型随意评价访客的选择；首版优先人工编写情境和反馈。
- 拖拽如被采用，必须有点击和键盘等价操作。

### 3.4 读全与带走

渐进呈现是体验选择，不是信息封锁。

- 每个对象都有直接链接和“阅读完整内容”入口。
- 人类不需要完成交互游戏才能看全文。
- Agent 不需要执行动画或模拟点击才能获取内容。
- 可取得完整的**已批准公开版本**及其公开关系；“全部信息”不意味着私人草稿、内部来源路径或未审核内容也公开。
- 支持分享当前对象；持久化的访客 Trail、跨设备同步放到后续阶段。

### 3.5 作品与失败：展示做成了什么，也展示改变了什么

**已确认：想法与做成的作品是主体，失败可以成为重要组成部分；生活隐私不是展示内容。**

建议每个代表作品展示真实产物、要解决的问题、关键选择，以及与相关想法的联系。失败记录说明尝试、预期、实际结果、可证实的原因与后来改变；未解决的失败可以保持未解决，不编造励志结尾。

失败可独立存在，也可与成功作品相连。涉及第三方、账号、位置、商业机密或私人生活时，先删节再进入公开候选，不能因为归类为失败复盘就绕过隐私边界。作品中的演示、代码链接及公开身份信息同样由本人选择。

## 4. 系统边界

已确认的数据流方向，与建议的发布流程分开表达：

```text
Gravity（独立应用）
生活 / 学习零散想法与日常碎片
        ↓ 采集与处理
联结 / 深入 / 发散产生的内容 ──┐
                             ↓
文章 / 语言 / 作品 / 失败 ─→ me.api 内容接入
                             ↓
              Agent 加工 → 后台预览 → 本人发布
                             ↓
                      同一份公开数据
                       ↙          ↘
               Human Web         Public API
              体验、全文、路径    完整结构与引用
```

### 4.1 Gravity 与 me.api

**已确认：**

- Gravity 是另一个计划开发的应用，不是 me.api 的内部采集页面。
- Gravity 经常性接收生活、学习中的零散想法和日常碎片，处理后得到联结、深入与发散的新内容。
- 这些处理结果进入 me.api，成为展示内容的一部分；Gravity 不等于 me.api 的全部内容来源。

**由此提出的工程建议，待确认：**

- me.api 不重复建设 Gravity 的日常采集应用，但需要自己的 Agent 加工流程：接入已有成果后，进行去重、跨来源联结、深入与发散建议及展示编排。保留 Gravity 已有的加工记录，避免重复改写。
- me.api 首版不以 Gravity 已完成为前提，可先从现有 Markdown 导入，并预留标准化接入合同。
- 接入包保留稳定来源 ID、来源版本、原始片段与派生内容的区别、AI 参与记录和关系理由；重复接入可识别，不重复建对象。
- **已确认：进入 me.api 不等于自动公开，发布由本人决定。** 候选先进入管理后台；可以批量选择，但必须由本人确认具体内容和版本，不按规则自动发布。
- 不要求传输全部私人原文；只传展示所需且获准的内容。原始碎片仅在确有展示需要且经授权时接入。
- 两个应用不自动共享账户、数据库、视觉主题或客户端范围；黑洞、纸团、吸积盘不能直接视为 me.api 的已定设计。

首版 API 对接方式、同步频率、修改/撤回传播规则，在 Gravity 接口设计时另行确认。

### 4.2 自我蒸馏与 Skill

两份对话可在此连接，但必须区分：

- **Memory**：我经历过什么、记录过什么。
- **Position**：我在某时刻如何看待某问题。
- **Lesson**：从经验中提炼的原则、教训或注意事项。
- **Skill**：有适用条件、操作步骤、边界和验证方式的可复用方法。

建议后续提供：

```text
经历 / 原始记录 → Lesson 候选 → 本人审核
              → Skill 候选 → 验证 → 发布版本
```

一个公开 Skill 至少说明：适用场景、输入、步骤、产出、禁用条件、失败案例、证据来源、版本与验证状态。

不能把一次成功总结成普遍规律；语言直觉也不应一律被包装成可执行 Skill。Skill 的作者认可与“经过验证”是两个独立状态。

**已确认目标排序：A > B > C。建议实现优先级仍为 P1**：先展示一两个经过审核的方法，再建设自动蒸馏管线。S1 中的模型训练、自动进化和持续评估系统不默认纳入首版。目标排序并不等于具体版本范围已获批准。

## 5. 建议范围与优先级

### P0：形成一条真正可用的双入口闭环

| ID | 功能 | 最小交付 |
| --- | --- | --- |
| F01 | 首页与 Now | 自我介绍、本人选择的当前关注点、精选入口、索引与搜索 |
| F02 | 个人连接探索 | 在问题、观点、语言、作品与失败之间沿有依据的个人联系探索；可追溯连接理由、来源和归属，支持局部展开、回退与全文 |
| F03 | 语言交互 | 至少一种可复用交互模式，呈现个人解释与依据 |
| F04 | 内容保真 | 原文保留、稳定 ID、日期、作者/AI 标识、修订记录 |
| F05 | 管理后台与本人发布（已确认必需） | 来源接入、候选审核、编辑与双端预览、显式发布、撤回、版本与任务状态 |
| F06 | 机器读取 | 公开对象枚举、详情、关系、搜索、Markdown 和接口说明 |
| F07 | 基础可用性 | 移动端、键盘、减弱动效、错误/空状态、无动画阅读 |
| F08 | Agent 智能加工（已确认必需） | 从材料提取、联结、深入、发散并生成带依据的候选；支持修改要求、重试、拒绝和版本保护 |
| F09 | 作品与失败（已确认内容方向） | 作品实物或链接、关键选择、失败过程及与其他想法的联系；具体展示模式待原型验证 |

P0 要建立一套可维护模板，不为每一条内容定制一个小网站。

### P1：加深理解与可调用能力

- Lesson / Skill 展示与结构化导出。
- 观点时间线：支持当前、历史、已替代、不确定的区分。
- MCP 只读适配器，复用同一权限与数据模型。
- 围绕主题返回上下文，以及公开变更流 / RSS。
- 更进阶的 Lesson / Skill 蒸馏与评估；基础 Agent 加工、候选关系及差异审核已纳入 P0。
- Gravity 导入适配；作者策展 Trail 与访客保存 Trail。

### P2：体验实验

- 吸积盘或空间化全局视图。
- 多语言界面、语义搜索、情境化内容浮现。
- 有明确证据和不确定性标识的 AI 综合回答。
- 更完整的私人 Agent 权限与自动化评估。

### 首版明确不做（建议）

- 模仿你口吻、代表你回答一切的数字分身。
- 通用 AI 问答站、社交平台或多人 SaaS。
- 全量私人日记上网、自动发布、无审核的人格推断。
- 全库一次性迁移、图数据库先行、微服务先行。
- 将三维宇宙、黑洞或全屏节点网络作为唯一导航。
- SFT/RL、无人监督的 Skill 自我改写。

## 6. 内容模型：少量对象，清楚关系

### 6.1 对象

不必给所有概念各建一张数据库表；先确定语义。

| 对象 | 含义 | 阶段 |
| --- | --- | --- |
| SourceRecord | 私人原文或导入记录及其版本；不自动公开 | P0 |
| Artifact | 经批准展示的文章、笔记、代码或作品，可链接来源 | P0 |
| Question | 本人提出或明确认领的问题，包含个人缘起与开放状态 | P0 |
| Concept | 多个问题共同指向的概念；不是自动生成的百科文章 | P0 |
| Lexeme / UsageObservation | 词或表达及具体的个人理解、语境观察 | P0 |
| Relation | 两个对象之间带方向、类型、理由和来源的连接 | P0 |
| Profile / Now | 本人维护的简介与阶段性关注点 | P0 |
| Project / FailureCase | 项目与其产物、失败尝试与复盘，可连接想法、Artifact 和彼此 | P0 |
| ProcessingJob / Candidate | 加工任务与待审核候选，记录输入版本、加工依据与状态；仅管理侧 | P0 |
| Publication | 本人批准的精确内容版本、关系及发布记录；审计信息不默认公开 | P0 |
| Position | 某一时期明确认可的观点，不等于所有说过的话 | P1 |
| Lesson / Skill | 经验结论与可复用方法 | P1 |
| Trail | 有序路径，区分作者策展与访客探索 | P1 |

Project 表达项目与关键决策，Artifact 表达具体产物，FailureCase 表达失败尝试；不因此建设任务看板等项目管理功能。完整文章仍是对象的一种，不需要为反对传统博客而删除文章。管理对象与公开对象分开，不直接把数据库行序列化为 Public API。

### 6.2 公共字段

- `id`：稳定标识；改名、移动源文件不应换 ID。
- `type`、`title`、`body`、`language`：对象内容。
- `createdAt`、`updatedAt`、`publishedAt`：记录、修订和公开时间，含义不可混用。
- `occurredAt`：如涉及经历，允许未知或仅知道大致日期；不能补造时间。
- `version`、`supersedes`：修订与替代关系。
- `provenance`：谁写的、引用什么、AI 做过什么、谁何时审核。
- `reviewStatus`：未审核 / 已接受 / 已拒绝。
- `publicationStatus`：私有 / 已公开 / 已撤回。
- `canonicalUrl`：稳定公开地址；私有对象不输出此字段到公开渠道。

`provenance` 不是单一的“human=true”：AI 草拟后由本人认可，仍应保留 AI 参与记录；本人认可不等于独立事实核验。

混合来源内容尽量按段落或观察条目标注。外部引文的原作者必须保留，不能因为进了我的库就变成我的原创。

### 6.3 关系

首版建议使用少量明确关系：`background`、`deepens`、`abstracts`、`appliesTo`、`analogousTo`、`contrastsWith`、`derivedFrom`。

每条关系包括：ID、起点、终点、类型、理由、来源、审核状态、公开状态。对关系进一步记录 `connectionOrigin`（本人明确表达 / 从个人材料推断 / 外部背景）、`evidenceRefs`（支持这条边而不只是节点的依据）、`personalSignificance`（它为何对我的思考或实践重要，允许尚未明确）、提出者与确认记录。模型推断即使被认可也保留其起源，不能伪装成历史上本人曾表达的联系。定义起终点方向及反向显示文字，不能仅靠画面上的上下左右表达关系。

模型给出的 confidence 如被保存，只能作为候选排序参考，不能显示为已校准的真实性概率。

### 6.4 来源与版本

- 保留原始导入版本；后续修订追加记录，不让 AI 覆盖原文。
- 公开版本可以与原始材料不同；删节和改写应可追踪。
- 源文件路径和私人出处只在作者侧可见；公开侧引用经过批准的来源地址或说明。
- 保留历史不等于永不允许删除：隐私删除、撤回和存储清理必须有明确操作。

## 7. Agent 加工与管理后台

### 7.1 已确认的责任分工

- **Agent 负责加工**：理解授权材料，发现联结、追溯背景、深入追问、发散与跨领域应用，不只是润色或生成文章。
- **本人决定发布**：选择哪些内容、哪些关系、哪个版本对外可见。
- **后端管理页面是必需能力**：日常维护不能依赖改代码、手写 JSON 或手工操作数据库。Markdown 保留为导入/导出格式，不再是唯一操作入口。

管理后台强调直观、效率、可靠反馈；不照搬公开站的实验性交互。以下是建议实现合同，待最终确认。

### 7.2 Agent 加工合同

每次任务明确输入对象及版本、可用资料范围、加工目标与预算。建议支持：

1. **整理与去重**：识别问题、观点、语言观察、作品与失败；保留原文及来源。
2. **联结（加工重点）**：优先在授权个人材料内部找跨时间、跨作品、跨领域的联系、复现的问题、分歧和相互修正；说明依据及对作者的意义。共有标签、向量相似或教科书关系不能单独证明个人联系。
3. **背景与深入**：围绕个人材料的实际疑问提出前提、反例、未解决的问题；通用知识作为按需背景，事实性补充附可核查出处，不抢占个人内容主线。
4. **发散与应用**：寻找跨领域类比，标明成立条件与失效边界，区分有依据的联系和探索性假设。
5. **展示编排**：建议短入口、探索分支、语言对比、作品/失败叙事，使用已实现的模板与结构化参数。
6. **质量自检**：来源完整性、个人/AI 归属、隐私风险、重复内容和悬空引用；模型自检不代替人工决定或确定性校验。

输出是一组可分别接受、修改、退回或拒绝的候选，不是一篇覆盖原文的总结。每条候选附输入版本、来源片段、生成理由、未确定项与模型/任务记录；不要求记录模型内部思维过程。

用户可以给出具体修改要求，让 Agent 针对候选修订。被拒绝或人工修订的内容要在再次加工时提供给 Agent，避免反复产生相同建议。原文不足时允许不产出，不设置必须凑满的连接数量。

Agent 可建议互动模板及参数，但不能自动把生成的 JavaScript/HTML 作为可执行程序发布。新增交互组件走独立代码审查；正文渲染需转义/清理危险内容。首版不建设在线任意代码执行器。

### 7.2.1 个人联系的筛选与保真

建议将加工输出标为不同用途，在后台分别呈现：

| 用途 | 依据与处理 |
| --- | --- |
| 个人主线候选 | 有原始材料支持的观察、解释、作品决策与联系；保留原话及出处供本人确认 |
| 有依据的新联系 | Agent 从个人材料发现、但本人未曾明确表达的连接；展示两端证据、推断理由和反例，待本人判断 |
| 背景参考 | 通用定义、领域知识、外部例子；必要时附在个人主线旁，不冒充独特贡献 |
| 待验证假设 | 暂无充分材料支撑的新颖类比或发散；保留在非公开候选中，不伪装成作者事实或立场 |

每条拟进入主线的候选要回答：**依赖了哪些属于作者的具体材料？新增的是对已有内容的发现，还是泛泛知识？是否改变了作者原意？** Agent 可给理由和风险提示，但不能替作者判定“这就是我的独特思想”。

区分三种不同历史：本人当时明确建立的联系、Agent 今天才推断的联系、本人今天认可的新联系。后两者不能回写成作者过去就想过。没有原文依据但本人新写下的判断，可作为新的个人表达记录，而非伪造旧来源。

重要联系即使来自私人材料，公开时也不得泄露私有片段、ID 或上下文。可以由本人另写可公开的解释；不满足公开许可则不输出该边。认可联系与授权公开仍是两件事。

### 7.3 后台最小功能区

| 功能区 | 日常操作 |
| --- | --- |
| 来源与接入 | 手动录入、选定 Markdown 导入、查看来源版本；未来接 Gravity；指定加工许可与排除范围 |
| 加工任务 | 选择材料和目标、启动加工、查看状态和错误、取消、受限重试、费用/用量记录 |
| 候选收件箱 | 按主题和来源分组；对照个人原文、连接依据及新增解释，区分个人主线/背景参考/待验证假设，修改、退回 Agent、拒绝、批量选择 |
| 内容与作品 | 编辑对象和关系、维护项目与失败、选择展示模板、调整首页/精选入口；不需要手写数据结构 |
| 预览与发布 | 同时预览人类交互与机器公开内容，列出关联对象和隐私风险，确认精确发布版本 |
| 维护与恢复 | 查阅发布历史、撤回、以历史版本创建恢复草稿、导出和备份；恢复也需本人确认发布 |

建议先做单人管理，不做多组织权限或多人协作系统。后台必须认证，不能以隐藏 URL 代替访问控制。

### 7.4 状态与发布语义

三套状态分开，不以“AI 完成”代表“已公开”：

- 任务：排队 → 运行 → 成功 / 失败 / 取消。
- 候选：待审核 → 接受 / 需修改 / 拒绝；输入变化后标记过期。
- 发布：草稿 → 本人确认的发布版本 → 撤回。

已发布对象的再次加工或人工编辑只产生新草稿，旧公开版本继续服务，直到本人批准替换。发布动作绑定具体版本与所选关系；确认后若内容发生变化，必须重新预览确认。

批量发布必须展示清单和依赖，不能偷偷连带发布私有来源。本人可选择不发布某个关系；Agent 凭据无发布能力，公开服务也无草稿写入能力。服务端验证权限及确认版本，不能仅靠按钮禁用或提示词限制。

### 7.5 易维护与故障恢复

- 建议接入后自动排队加工，并保留手动启动/重做；自动触发时机仍待确认，绝不自动发布。
- 草稿自动保存，后台页面关闭不丢任务；重试有上限且幂等，取消不删除原材料。
- 超预算、模型故障和部分加工失败只影响候选生产，不影响公开站；发布失败保留上一份完整快照。
- 支持结构化导出和恢复演练；后台存储是编辑主记录时，不与 Git 形成未经定义的双向覆盖。
- 加工前需明确模型访问许可和费用上限；外部网页如用于补充资料，要限制抓取范围并防止访问内网等非授权资源。

建议首批试装包含问题路径、语言观察、至少一个作品及一条经本人选定的失败，不以凑数代替内容质量。当前仓库尚未逐篇获得公开许可，尤其不得默认扫描日记、归档或附件。

## 8. Public API 合同草案

机器界面与网页读取同一个已发布数据集，而不是维护两份内容。

### 8.1 P0 能力与建议路径

| 路径 | 作用 |
| --- | --- |
| `GET /api/v1/profile` | 本人批准的简介 |
| `GET /api/v1/now` | 当前关注点与更新时间 |
| `GET /api/v1/entities?type=&cursor=&limit=` | 分页枚举公开对象 |
| `GET /api/v1/entities/{id}` | 完整公开对象、版本与出处 |
| `GET /api/v1/entities/{id}/relations` | 当前对象的公开关系 |
| `GET /api/v1/entities/{id}/content.md` | 干净的完整公开文本 |
| `GET /api/v1/search?q=&type=&cursor=` | 公开内容搜索 |
| `/openapi.json` | 实际端点、参数、返回及错误约定 |
| `/llms.txt` | 网站说明、引用原则与入口索引 |

建议先用显式路径区分 HTML、JSON 和 Markdown，暂不强制内容协商。JSON-LD 与 MCP 可以后加，不是“Agent 能读取”的必要前提。

### 8.2 行为要求

- 清楚返回原文、作者解释、AI 补充、审核状态与时间，不用模型总结替代原始内容。
- 可通过分页取得全部公开对象，不以首页精选范围限制 API。
- 可通过对象及其关系恢复公开图；返回资源 ID、稳定 URL 与版本。
- 查询参数有长度、分页大小和执行时间上限；未来图遍历必须限制深度和节点数。
- 错误包括无效参数、不可用资源、限流与服务故障；采用统一错误结构。
- 未公开对象对匿名访问返回与不存在一致的结果，不泄露标题或存在性。
- 搜索命中、计数、关系和导出均只基于公开数据。
- 文档中要求引用来源、区分历史观点与 AI 推断；但不能假定外部 Agent 会遵守文字说明。
- 公共接口默认只读；访客不能通过 API 改写资料或触发未经授权的执行。

“API 可读”不等于对任意再利用授权。公开内容的引用、转载、批量下载和 Skill 使用许可需单独确认。

## 9. 隐私、真实性与 AI 边界

### 9.1 建议发布规则

- 新导入、AI 提取、候选关系一律默认私有。
- 只有已审核且显式发布的版本才能出现在公共系统。
- 关系公开必须同时满足：关系本身及两端对象均已公开。
- 私有材料衍生出的摘要或解释，不因“没有逐字引用”就自动安全；必须单独审核脱敏与公开许可。
- HTML、JSON、Markdown、搜索索引、站点地图、订阅、缓存和未来 MCP 共用相同过滤规则。
- 公共部署尽量不携带私人源库，而仅接收发布产物。
- 撤回后清理本系统的公开索引与缓存；明确无法收回外部已经下载或缓存的副本。

### 9.2 AI 可以做什么

**Agent 加工是已确认的核心能力，不是未来选配。** 必须能够根据原材料提取、联结、深入与发散，产出带来源和理由的候选，详见第 7 节。候选工作区允许 Agent 写入，但公开内容和发布权限不向 Agent 开放。

不能擅自：

- 编造你的经历、情绪、身份与立场。
- 将一次表达升级为长期信念。
- 把历史观点标记为当前观点。
- 把 AI 关系伪装成你亲自发现的联系。
- 自动发布、修改原文或授予外部 Agent 写权限。
- 因源文内出现指令而执行工具；导入文档应作为数据，而非系统命令。

首版需要作者侧 Agent 加工，但不要求访客侧实时生成。内容允许参与私有加工与允许公开是两种授权；模型供应商、私有内容外发许可、预算和重试上限仍待确认。该产品需求不授权本轮实际将现有私有库发送给第三方模型。

## 10. 体验方向：Geek 在行为，不在皮肤

### 10.1 已确认设计语境

- **气质**：深邃、代码驱动、交互具有 Geek 式的新意。
- **核心受众**：希望得到启发的同好；兼顾快速认识你的陌生人与潜在合伙人。
- **公开主体**：想法、做成的作品和有价值的失败，不是私人生活展览。
- **非目标**：通过终端配色、满屏代码、强制输入命令或大量炫技动画冒充 Geek 体验。

设计上下文另存于根目录 `.impeccable.md`。浅/深色、字体、空间构图和是否使用 3D 尚未确定；“深邃”不自动等于深色。Gravity 的视觉隐喻不自动继承。

### 10.2 已认可方向：通过操作探索个人联系

“可操作的思考”已获认可，但连接性和个人独特性比单个交互玩具更重要。具体操作尚需原型验证，不能将页面做成彼此孤立的科普小实验合集。

建议主线调整为：**从一个属于你的想法进入 → 发现它与另一段思考、作品或失败的联系 → 查看为什么相连 → 对照差异与变化 → 沿新的联系继续探索。**

待验证的连接操作可以是：并置两个对象观察共同点与冲突、沿一条联系回溯其依据、切换时间观察同一问题如何改变。改变前提、语境替换、决策回放仍可使用，但服务于这条连接主线，而非成为独立目的。

三个用于原型比较的例子，非已定全量功能：

| 体验 | 访客操作 | 有意义的反馈 |
| --- | --- | --- |
| 改变前提 | 切换问题中的一项假设，或选择一个反例 | 原有推理哪些仍成立、哪里需要改写，以及你实际记录过的下一步问题 |
| 切换语境 | 保持词语不变而改变语境，或保持句子不变替换表达 | 语义、语气和适用边界的变化，以及你的解释与依据 |
| 回放一次失败 | 沿作品的决策节点查看当时的假设、尝试与实际结果 | 看见失败如何改变了后续设计，而不是只有“最终成功”的展示 |

作品页必须能快速到达真实作品、演示或代码，实验式探索不替代成果本身。失败回放中，真实历史与“如果换一个选择”的模拟必须严格分开；没有依据时不编造分支。

建议先用一种公共交互机制贯穿少量内容，再决定扩展方向。交互可使用确定性规则、已有数据或经过确认的演示模型，不要求每次访问都调用 LLM。关系图可以辅助定位，但“节点 + 连线 + 点击跳转”本身不足以兑现非传统交互要求。

### 10.3 体验边界

- 新意来自操作与内容的对应关系，不来自隐藏入口或增加操作门槛。
- 每个操作有清楚的可用提示和反馈；允许撤销、回到起点和读全文。
- 保留“先认识我”、完整索引与直达链接，避免探索变成陌生人的必修课。
- 若做拖拽、快捷键或命令入口，均提供点按与键盘等价路径，不要求访客懂代码。
- 手机保留核心能力，不是桌面空间的裁剪版。
- 文本使用语义化 HTML，建议达到 WCAG 2.2 AA；支持读屏、焦点、减弱动效。
- 无 WebGL 或关闭非必要动画时仍能理解内容和完成主要操作。
- 不自动播放声音，不强制等待片头，不劫持滚动。
- **公开站可以探索性强，管理后台必须直接好用。**

交互主概念通过真实材料原型验证后，再定视觉和动效；本轮不编写页面代码。

## 11. 必须设计的状态

| 状态 | 用户应得到的反馈 |
| --- | --- |
| 首次到访 | 知道是谁、可以做什么，并有清楚的第一步 |
| 加载 | 保留已读内容和当前位置，不让整个页面消失 |
| 关系为空 | 明确“尚未整理出公开连接”，可回到其他入口 |
| 问题未解决 | 正常显示开放状态，不强行补一个答案 |
| 无搜索结果 | 提示调整关键词，允许浏览公开索引 |
| 内容修订 | 展示更新时间与当前版本；历史仅在允许公开时提供 |
| 内容不可用 | 不暴露私人详情，给出返回或搜索入口 |
| 弱网或 API 失败 | 展示可读回退或可重试错误，不空白、不生成替代事实 |
| 动效关闭 / 无 WebGL | 同一内容与操作能力的静态或轻交互版本 |
| 发布失败 | 保持上一份完整可用版本，不留半发布状态 |
| Agent 排队 / 处理中 | 后台显示阶段和输入范围；可以离开页面，任务状态持久化 |
| 加工失败 / 被取消 / 超预算 | 保留原文、已有候选和已发布版本；解释原因并提供受限重试 |
| 候选过期 / 版本冲突 | 明确哪些输入或编辑已改变，要求重新预览确认，不能静默覆盖 |
| 未登录 / 会话过期 | 不泄露后台内容；恢复认证后再执行敏感操作 |

## 12. 技术方向：后台持久化，公开展示解耦

框架、数据库、模型供应商和部署平台仍未选定。但原先“只维护 Markdown，后台和 Agent 以后再加”的路线已不符合确认需求。

建议最小架构为：

```text
认证管理后台 → 私有内容/版本存储 → 后台加工任务 → Agent
                         ↑                  ↓
                         └──── 候选与来源 ──┘
                                 ↓ 本人确认发布
                           版本化公开快照
                            ↙          ↘
                      Human Web      Public API
```

- 后台是常用编辑与发布入口；Markdown/JSON 用于接入、导出与迁移。
- 加工任务需持久化和受限执行，不依赖一个浏览器请求始终在线；首版可用同一应用加 worker，不预设微服务或独立队列产品。
- Agent 使用最小权限工具操作候选；发布认证与凭据不进入模型上下文或工具能力。
- 公开站可静态构建或服务端渲染，只读取已发布版本；其可用性不依赖模型服务。
- 公共 API、索引和 HTML 来自同一发布版本，避免缓存里混合新旧或私有内容。
- 需要备份的是内容、关系、原始来源、候选、任务和发布记录，不只是网站静态文件。
- 首版可先用关键词检索；向量库和专用图数据库仍按需求评估，不因使用 Agent 就强制引入。

建议性能目标：代表性移动设备和约定网络条件下，核心页面 LCP ≤ 2.5 秒、CLS ≤ 0.1；有真实访问量后以第 75 百分位观察 INP ≤ 200ms。原型阶段采用实验数据，不冒充线上指标。后台加工耗时单独测量，并提供阶段反馈，不阻塞公开页面。

## 13. 验收清单

以下是确认 Spec 后的实现验收，不是本轮已完成事项。

| ID | 检查 | 通过条件 |
| --- | --- | --- |
| A01 | 身份与入口 | 首次访问不经教程即可找到主人介绍、一个探索入口及完整索引 |
| A02 | 问题路径 | 真实内容支持至少 3 步探索与一次分叉；后退、直达、刷新不丢当前位置 |
| A03 | 有个人依据的关系 | 主线关系可追溯到作者材料或明确认领记录，区分历史联系与新推断；只有标签相同或普通知识相关的边不能冒充个人联系 |
| A04 | 语言交互 | 至少一种模式用于多个真实条目；点按、键盘可操作，反馈对应具体语境 |
| A05 | 完整阅读 | 不完成交互也能读全文；分享链接可直接到达对象 |
| A06 | 双端一致 | 同一 ID 在网页、JSON 和 Markdown 中的内容、版本、归属一致 |
| A07 | 可枚举 | API 分页遍历后集合与发布清单一致，无遗漏和私人对象 |
| A08 | 真实归属 | 人工原文、AI 候选、已认可 AI 内容、外部引用的样本均显示正确归属 |
| A09 | 隐私对抗检查 | 植入私有测试标题与独特字符串，所有公开渠道、关系和计数均不泄露 |
| A10 | 发布与撤回 | 重复导入不重复建对象；发布失败不破坏旧版；撤回清理本系统公开结果 |
| A11 | 无障碍与降级 | 键盘、移动端、减弱动效与无 WebGL 场景均能完成核心任务 |
| A12 | 人类体验验证 | 邀请 3–5 位目标访客，不提示操作；多数能完成一条路径，复述一条联系及其对作者的具体意义，而不只是记住通用知识或动效 |
| A13 | 机器理解验证 | 用固定查询集测试：当前关注、语言区别、问题来源、无证据的问题；返回来源，不补造立场 |
| A14 | Agent 加工 | 用授权样本验证联结、深入、发散；输出对应来源与理由，缺乏依据时保持假设或拒绝输出；原文不被覆盖 |
| A15 | 发布权限隔离 | 匿名、Agent、伪造或重放发布请求不能越权；候选即使被接受也不自动公开，发布绑定本人确认的版本 |
| A16 | 后台可维护性 | 无需修改代码或手写 JSON 即可完成导入、加工、修订、预览、发布、更新及撤回；断线后状态可恢复 |
| A17 | 再加工与冲突 | Agent 重试不重复造内容；已发布对象再加工只产生草稿；过期预览和并发编辑不能导致未批准版本上线 |
| A18 | 作品与失败 | 至少试装一项真实作品和一条本人选定的失败，能追溯其想法与变化，公开渠道不含私人生活细节 |
| A19 | 交互服务连接 | 原型至少一种操作帮助对照、回溯或理解个人材料之间的联系；不是装饰动画，也不能只是互不相关的通用知识小游戏 |
| A20 | 数据恢复 | 从备份恢复来源、候选、关系、任务和发布版本，核对公开集合及稳定 ID，不能只备份网页产物 |
| A21 | 个人内容保真 | 对照加工前后材料，具体措辞、关键区别、失败条件及保留意见未被抹平；原文和 AI 解释可独立查看 |
| A22 | 防止通用内容占据主线 | 用个人记录、有据推断、通用解释、无据新奇类比做测试样本；后台正确区分用途，不把后两者自动升级为个人内容，最后由本人选择 |

A12 的访客人数与通过阈值应在原型测试前最终约定。自动化测试不能替代“是否真的有趣、是否像你”的真人判断。

## 14. 交付顺序与决策闸门

1. **需求对齐**：回答第 15 节，确认定位、首版范围、隐私与维护方式。
2. **内容试装**：选择允许使用的想法、语言、作品和失败材料，人工标注一小份参考结果，再验证 Agent 的加工质量；人工样本不替代正式加工功能。
3. **交互原型**：先验证一组个人材料之间的真实连接；访客能否理解为什么相连、哪里体现作者的选择，再判断操作是否有趣；不从通用知识小实验开始。
4. **纵向闭环**：后台导入 → Agent 加工 → 修改/审核 → 预览 → 本人发布 → 网页/API → 更新/撤回，全部走通，并验证权限和失败恢复。
5. **首版扩展**：复用模板增加精选内容，完成上述验收。
6. **后续能力**：根据你的优先级加入 Skill、MCP、Gravity 连接或空间视图。

每一阶段通过后再扩大范围。尤其不在原型未验证前全库迁移或制作完整 3D 资产。

## 15. 决策记录与剩余确认

### D01 · 优先级 — 已确认

**A 人类体验 > B Agent 读取 > C Skill 调用。** 加工内容的 Agent 属于基础生产能力，不应与低优先级的“对外 Skill 调用”混为一谈。

### D02 · 目标读者 — 已确认

同好发现你、学习独特想法并获得启发是首要目标；同时帮助陌生人和潜在合伙人了解你。联系、订阅等后续动作未确定。

### D03 · Gravity — 已确认独立应用

采集生活/学习碎片并加工出联结、深入和发散内容，再进入 me.api 作为部分内容来源。me.api 不重做采集 App，但需要面向展示和跨来源联结的 Agent 加工。接口、同步频率和上游撤回传播仍待设计。

### D04 · 内容边界 — 已确认

主要展示想法与做成的作品，失败可成为重要组成部分；不以生活片段等隐私内容作公开展示。具体首批来源文件、引用许可和批量下载授权未定。

### D05 · 交互气质 — 已确认；机制待验证

深邃、代码驱动、交互上有 Geek 气质和新意。可操作的思考方向已获认可，但连接性与个人独特性更重要；第 10 节具体操作例子仍是待验证提案。

### D06 · 生产与维护 — 已确认

Agent 智能加工，本人决定发布哪些内容，必须有好维护的后端管理页面。不得继续按纯手工 Markdown 工作流实现。任务自动触发时机、模型和费用/数据外发许可尚未定。

### D07 · 连接性与个人独特性 — 已确认

不以 AI 可轻易生成的普通知识作为核心展示；重点保留属于作者的观察、表达、判断、取舍及它们的联系。Agent 可以发现本人尚未意识到的联系，但需有个人材料依据并保留推断身份。连接筛选、分层与验收方法是本文的实现建议。

### 下一步：用真实材料校验，而非继续抽象提问

选择 2–3 份你认为彼此有关、能体现独特理解的想法、作品或失败材料，先示范“保留什么、连接什么、补充什么、不展示什么”。也可以在得到你的选材授权后，从非私人内容中推荐候选。无需再次确认已认可的主方向。

语言、旧站保留方式、部署和预算，在核心体验确认后集中决定。发布许可和第三方模型数据使用授权，在实际导入、模型调用前确认；本 Spec 不代替授权。

---

**核心原则：保留属于你的东西，显露它们之间的联系。Agent 协助发现和表达，你决定公开；交互服务于理解，而不是用通用 AI 内容填满一个漂亮的图。**
