文档索引
总设计与实施方案位于上层 design/ 目录；本目录维护专题、工程参考、决策与文档规范，experiments/ 保存公开整理报告。文档构建配置、脚本和主题分别位于 design/book.toml、design/scripts/ 和 design/theme/。
用途：阅读与术语索引。
默认阅读当前正文；历史材料只用于查证来源，不是另一套设计。所有状态与配置边界统一见设计台账。
阅读路线
| 阅读目的 | 路线 |
|---|---|
| 建立整体认识 | 总设计 → 目标／逻辑总图 → 核心概念 → 完整场景 → 机制与取舍 |
| 理解主体自主运行 | 持续主体 → 认知循环 → 直接认知归属 → 主体评价 |
| 核对跨专题一致性 | 统一决策 → 步骤与操作／公共决策／配置与当前约束 |
| 选择、组合和管理检索 | 总体分工 → 公共契约 → 向量服务与 Attemory → 管理 → 评价 |
| 理解领域对象与投影 | 总体分工 → 对象与所有权 → 领域操作 → 管理详情 |
| 理解机密使用与防泄漏 | 对象与权限 → 授权分配 → 调用契约 → 审计与撤销 → RPC 接入 |
| 理解任务解耦与外部中止 | 总体架构 → 控制契约 → 控制台 → mini-go 依据 |
| 使用客户端预制能力 | 总体选择 → 维护与调用契约 → 工程接入 |
| 创建与更新人物 | 总体流程 → 引导契约 → 管理入口 → 工程接入 |
| 创建试验主体与比较行为 | 总体沙箱 → 初态与导入 → 环境覆盖 → 工作台 → 评价 |
| 理解计算节约与复用 | 总体选择 → 输入与结果 → 执行与结算 → 接入依据 → 评价 |
| 深入某项机制 | 从总设计或下表进入对应专题；专题维护详细规则，其他文档只保留必要概览和链接 |
| 理解具体承载 | 工程参考 → 技术栈／存储／能力接入 → 库事实 |
| 更新执行库与核对接入 | 当前库基线 → 库回归报告 → 后续更新流程 |
| 核对选择与状态 | 设计台账 → 采用理由／备选／用途配置 → 证据索引 |
六份逻辑设计专题
| 专题 | 唯一维护的详细机制 |
|---|---|
| 主体运行、认知协作与学习 | 持续主体、内生关注、按需活动、正常经历、多人格组织与公共整合、经验形成、主动学习议程及策略迭代 |
| 交流、人物与情境 | 意愿与投入、信任／污染、规范／格式、身份／隐私、情感／角色及主动联系 |
| 资料、领域视图与认知输入 | 领域对象及关系、资料内容与表示、受限视图、来源、选读及执行使用；外部事件源、有限思考、稳定输入装配、结果复用及增量准备 |
| 逻辑模块、能力契约与运行协议 | 主体直接认知归属、统一事件、能力构建与运行对象、学习强度及关闭、模型端口、步骤／操作接纳与生命周期、配置解析、个体状态与实现信任 |
| 沙箱、能力评估与回归 | 局部／组合／主体级试验、构建环境、试验主体生命周期、隔离、复盘、测试材料、基线、评价及采用 |
| 管理工作台与人工干预 | 管理入口及身份、模型／服务及能力构建维护、独立机密的对象／权限／授权分配／审计与可信提交、动态表单／蓝图、提交与观察 |
跨专题边界：资料专题维护对象关系、资料内容和面向接收者的视图；主体专题维护记忆与判断；运行专题维护程序、配置、模型及能力的操作接纳；管理专题维护页面交互和独立机密机制。各领域保留状态所有权，查询和页面不形成通用资源管理层；沙箱按领域装配，工程参考集中维护承载。
工程参考
| 参考 | 唯一维护范围 |
|---|---|
| 实施方案与阶段验收 | 阶段顺序、交付内容、首批完整链路、实现契约及验收安排；规划不代表已实现 |
| 工程选型与部署 | 物理部署、软件组合、技术栈、能力工具链／子进程、存储／文件、向量服务与 Attemory 接入及选型依据 |
| go-mini 库行为与接入 | 固定提交的源码核对与库回归、MRPC 多语言／资源／替换、实例／scope／补丁及宿主接入限制 |
决策与证据
| 查什么 | 位置 |
|---|---|
| 设计约束、已定设计与用途配置 | 设计状态、基础设计、管理设计状态 |
| 已有实验、失败和原始数据 | 实验索引；各报告保持原条件 |
| 论文、标准和来源命题 | 按问题查依据、设计机制资料、论文与标准记录 |
| 文档怎样保持一致 | 维护规范 |
| 构建网站、Mermaid、GitHub Pages 与公开范围 | 文档发布说明 |
设计按主题维护。论文、协议和依赖版本用于定位来源，实验修订标识用于区分固定条件。
术语定位
先区分几个容易混用的词：
| 用语 | 本项目中的含义 |
|---|---|
| 接纳 | 确认承担请求或操作责任；不代表已经执行成功 |
| 采用 | 将候选方法、配置或程序用于明确的任务或范围；不自动扩大权限 |
| 交付 | 结果到达允许的接收点；保存文件或发出请求不等于交付成功 |
| 结束 | 当前活动不再推进；应分别说明完成、退出、取消或受阻等原因 |
| 已定设计 | 当前选择的方案；不等于已经实现或通过完整验证 |
| 实测结果 | 在已记录条件下实际运行得到的证据；适用范围以报告为准 |
主体、人物与交流
| 概念组 | 当前定义位置 |
|---|---|
| Self、Mind、Persona、Role、Person | 总概念、协作、人物 |
| 私有 Mind 状态、活动委托、Self 公共整合 | 公共决定、总体关系 |
| 完整初始化提示词、个体差异、Self 自迁移与引导修复 | 人物形成、运行契约、检查场景、状态 |
| API 弃用、兼容窗口、提示词差异与客户端更新 | 工程映射、库事实、管理入口 |
| 意愿、可答性、快慢投入、承担范围 | 回应、承诺 |
| 观测、命题、来源权威、污染 | 观测与信任 |
| 规范、适用性、输出契约 | 规范、格式 |
| 跨平台关联、参与者、受众、情境保密 | 关联、隐私 |
| 情感评价、剧情、虚拟伴侣、主动联系 | 情感与角色、问候与提醒 |
活动、执行与控制
| 概念组 | 当前定义位置 |
|---|---|
| Goal、Episode、关注表、工作区、计划 | 运行循环、工作区 |
| 接纳前请求、澄清／拒绝、处理归属与用量承接 | 请求处理、运行归属 |
| 发起者、执行者、系统授权与用户委托 | 授权上下文 |
| Episode、Task、Operation、尝试与控制传播 | 身份和生命周期、控制语义 |
| Step、执行上下文、模型会话、Continuation | 连续性边界、运行步骤 |
| 任务契约、有效结果集合、责任收尾 | 主体任务、评价环境、状态定义 |
| 证据未知、主体退出、原目标达成与活动结束 | 结果与责任的分工、接纳与退出 |
| 步骤内独立接纳、请求键、最终提案与已接纳操作 | 接纳时序、工程提交 |
| 核心／任务解耦、认知中断、任务阻断／中止、外部审计控制 | 主体场景、生命周期、控制、工程、评价、状态 |
| 统一事件、来源、订阅、请求／结果、内部接续 | 总事件主线、协议、外部通知源示例 |
| Operation、Effect、Outcome、unknown | 操作与效果、用途评价 |
| 依赖、执行条件、结果复核 | 复核 |
| 基础受限执行、额外隔离与环境缺失 | 执行分类、工程装配 |
| 记忆形成、保留、遗忘与学习关闭 | 记忆生命周期 |
| 已读内容失效、受众变化与外部会话停用 | 上下文有效性 |
| 已交付结论、更正与有限通知 | 纠正处置 |
资料、领域对象与能力
| 概念组 | 当前定义位置 |
|---|---|
| 资料、记忆、程序、配置、模型与运行对象 | 所有权与关系、设计范围 |
| 资料内容、表示、来源定位、快照与修订 | 资料契约、领域接口与共用承载 |
| 情境投影、选择性发现、读取／处理／使用／交付 | 投影、操作、使用记录 |
| 内容派生、运行使用、来源和信息范围 | 派生规则、资料 |
| 检索领域、提供者、用途策略与来源映射 | 逻辑分工、同级接入、设计决定 |
| 前缀复用、稳定输入与有效结果 | 装配、复用条件、提供者接入 |
| 相同只读工作合并、增量准备与有界保留 | 逻辑分工、控制与结算、工程映射 |
| 节约效果、缓存管理与有限思考 | 管理、评价、投入、状态 |
| 逻辑模块、状态所有者、ModelRequest／Result | 职责、模型端口 |
| 公共 API、事件接入／观察、领域查询与检索提供者 | 公共契约、检索分工 |
| 能力构建、接口、产物、采用与运行对象 | 整体闭环、逻辑契约、管理入口、设计范围 |
| 功能采用、实现信任、固定产物与环境准入 | 逻辑边界、工程承载 |
| 隔离执行、高风险调用与环境缺失 | 整体职责、准入契约、管理、评价、状态 |
| 可选容器、Rootless Docker 与 gVisor | 工程承载及取舍、官方资料与适用边界；依赖可选，必要执行限制不可自动降级 |
| 客户端预制能力库、只读维护、可选使用与个体包装 | 逻辑契约、管理、评价、库事实、状态 |
| 热加载、编写契约、结构化注释与受管理函数 | 总设计、逻辑契约、表单与蓝图、函数测试、工程生成工具 |
| 普通配置、作用域覆盖、当前权限与控制 | 解析与生效、管理视图 |
| 个体自定义状态、结构修订与迁移 | 逻辑契约、存储映射 |
| 模型资产与推理服务维护 | 管理范围、工程映射 |
| 独立 Secret、SecretRef、SecretGrant 与原值交付 | 对象定义、领域边界、授权分配、运行契约、RPC 接入 |
| 用户机密归属、专用指令、一次性提交及过滤转换 | 归属与授权、可信提交、处理流程、用户场景 |
| 机密审计、撤销与试验授权 | 审计事实、撤销边界、评价规格、来源与边界 |
学习、沙箱与评价
| 概念组 | 当前定义位置 |
|---|---|
| 正常认知与专门学习的边界 | 主体循环、投入与关闭、主体评价 |
| 主动学习、兴趣探索、学习议程与自我迭代 | 总设计、主体策略、评价、状态 |
| 学习强度、关闭主动学习、明确学习任务与恢复 | 运行契约、管理控件、工程接入、库装配 |
| 经验、Reference、认知程序修订与候选采用 | 学习、候选 |
| Sandbox、重放、重新评估、反事实 | 沙箱职责、模式 |
| 试验主体、主体级测试、初态与完整状态导入 | 装配及生命周期、初态、取舍与依据 |
| 能力画像、用例／套件、开发／回归／保留任务 | 评估层次与覆盖、测试材料 |
| 基线、评价器、退化与采用门槛 | 可比条件、评价器、判定与报告 |
工程与来源
| 概念组 | 当前定义位置 |
|---|---|
| Attemory、HTTP API、材料准备与检索 | 接入参考、固定接口依据 |
| 向量数据库、Go SDK、本地／远程与产品选型 | 接入参考、官方依据 |
| MRPC、Go／Rust／Node.js（npm）、工具链、子 VM 与子进程 | 工程工具链、库事实与接入、JavaScript RPC、Node 工程接入、试验分层 |
| RunID、InstanceID、Generation、DeploymentSeq | 库身份映射、逻辑身份 |
| 技术栈、软件依赖、SQLite、文件发布、锁与备份 | 工程参考、存储机制 |
| 固定源码提交与证据范围 | 读取方式、基础库事实 |