# co rem 初始化：先展示已有资料，再调查补充

2026-09-20 用户确认的建图阶段交互要求。2026-10-04 更新：首跑在建图之后立即使用模型，完整调查近期重要人物、项目和相关组织，让用户在第一次打开 REM 时就看到有来源支撑的有用记忆。配置的调查预算（默认约 35% 的周额度）是目标，不是硬上限；所选调查完成前可以继续使用额度，仍遵守配置的周额度保护线。

## 用户首先得到什么

执行 `co rem init` 后，用户首先能浏览 People、Organizations、Projects、Skills 四类目录和页面。
每一页由对应的规范模板和当前已经取得的来源信息组成。已有字段直接展示；
尚无证据的内容明确标记“未知／尚未调查”。初始化完成不代表调查完成。
用户不需要等待模型写完人物分析、项目介绍或 Skill 质量评价才能看到这些页面。

| 页面类型 | 首次可展示的已有信息 | 不能据此推断的内容 |
| --- | --- | --- |
| People | 已观察姓名、地址、别名、邮件来源及窗口内数量和日期 | 对方一定是真人、关系、重要性、职责 |
| Organizations | 通信域名、对应 People 页面、来源和观察范围 | 法定名称、联系人雇佣关系、跨域名归属或母子公司关系 |
| Projects | 已观察项目名、仓库/工作目录、来源会话及日期范围 | 已发布、业务目的、真实负责人、完成进度 |
| Skills | 原文件名称、描述、路径、安装副本、完整原文快照和可取得的使用证据 | 全历史使用次数、成功率、质量、某次运行一定属于哪个安装版本 |

这里的来源信息包括原始记录中可直接读取的内容与元数据。页面展示适合阅读的
字段和来源入口；不要求把全部邮件正文或会话全文复制到每一页。完整资料与页面
保持可追溯关系，来源不可用、未授权、未扫描和确实没有结果应分别说明。

## 第一阶段的数据与处理边界

- 页面身份：类型、稳定标识和页面路径，重复运行不能无故产生重复实体。
- 来源：记录或原文件的位置、来源类型、观察时间和扫描范围。
- 初始字段：来源直接给出的名称、路径、地址等；统计标明窗口，不能冒充全历史。
- 页面结构：使用对应的规范模板；未知字段保留，不能用模板示例补成事实。
- 状态：区分已建图、部分来源失败、尚未调查；记录缺失来源和下一步入口。

这些是产品层面的数据要求，不要求新增一套与现有记录重复的存储格式。
现有映射入口是 `rem/map.py` 和 `rem/skill_map.py`，模板由规范页面结构提供，
映射覆盖记录保存在 `.state/map.json`。People 来源可能需要已授权的网络读取；
“无需模型调查”不等于“所有资料都已在本地”。

## 顺序及验收

1. 发现可用且已授权的来源，建立实体目录。
2. 用各类模板呈现直接取得的字段、来源和未知项，供用户浏览。
3. 初始化返回覆盖情况，并在终端打印“我”的页面里已经确定的事实（邮件量、联系最多的人、
   编码项目），到此结束脚本部分。
4. 建图后默认用配置的 runner 调查“我”的页面：先给出快速可读的一版，再补完整调查。
   同时调查近期重要人物、近期项目和与这些人物相关的组织。终端、脚本和 `--json`
   都执行首跑调查。先说明估计的页面数、时间和模型用量；配置的调查预算（默认约 35% 周额度）是目标，
   调查队列完成前不按此比例停机。runner 不可用或无证据时说明原因；`--no-investigate`
   是明确选择只建图。Ctrl-C 保留地图和已完成页面。

验收看用户实际能看到什么：四类目录可访问、已知字段有出处、未知不伪装成事实、
来源失败不会隐藏其他成功结果，重复初始化保留用户已整理的页面。
首跑模型阶段只从已展示的项目映射中选页面；后续会话扫描发现的未映射文件夹留在
私有候选清单，不在建图摘要之后暗中增加项目页面。项目目录数与首跑摘要必须一致。
当前代码已有确定性三类建图流程；完整的用户可见性和字段覆盖仍须逐项验证，
不能仅凭命令成功就认定交互完成。

## Organization 初始化补充

People 建页后，脚本按通信邮箱的精确域名建立组织候选页和 `notes/orgs-map.md`。
单联系人和仅通知地址的域名同样保留，不能把调查优先级筛选当成初始化覆盖。
复用已知公共邮箱域名排除表；该表并不穷尽所有服务商，因此其余域名仍只是候选。
不会根据域名猜公司名，也不合并子域名或不同域名。

`People here` 列出来源联系人页面，注明域名关联并不是雇佣证明。组织页面保持
“尚未调查”，注明来源与扫描窗口。已有 Domains 字段匹配的组织页面直接复用，
保留整理后的正文和状态；本次观察到的联系人关系记录在映射报告，不强行覆盖旧页。

## Skill 原文概览

初始化页在名称和简介之后展示原 `SKILL.md` 的完整原文快照（包含 frontmatter），
用代码块保留格式，不把原文当作 co rem 的执行指令。标注原文件路径、快照记录时间
和内容 SHA-256；它描述的是该版本的指令，不代表能力或效果已经验证。
重复建图刷新生成区，保留人工笔记；原文不变时页面不变，原文件消失时保留旧快照。
原文件仍留在原处，不修改或执行。超过页面容量或触发现有写入保护时明确报告
快照不可用，不截断成貌似完整的原文。