本地原始记录Liyuan1992/rawmem

rawmem

现在留下，以后再用。

rawmem 是一个本地优先的原始记录工具。它把支持的 AI 对话文字、手动保存的网页和工作记录留在你的电脑里，供以后查看或交给 AI 使用。

你不需要先弄懂 agent、提示词或 AI 记忆系统。使用 Windows 图形记录器时，选择保存位置、决定是否开机自启，然后开始记录即可。网页需要你主动点击浏览器插件才会保存。

只做记录。 rawmem 不会自动把对话总结成个人记忆，不会替你判断偏好，也不会把记录上传到云端。未来的 AI 能从这些资料中获得多少帮助，取决于资料本身和使用它的工具；rawmem 先把可保存的上下文留下来。

怎么开始

不懂编程、只想保存记录？选择 Windows 软件（EXE）方式。 EXE 就是 Windows 上可以双击打开的程序文件；使用它不需要安装 Python，也不需要输入命令。

| 你的情况 | 选择哪种方式 | 需要准备什么 |
| --- | --- | --- |
| 普通 Windows 用户，希望打开软件就能用 | Windows 软件（EXE，预览版） | 一份构建好的 rawmem.exe；不需要 Python |
| 开发者，熟悉终端，希望使用命令或接入其他工具 | Python 命令行方式 | Python 3.10 或更高版本；按下文从源码安装还需要 Git |

两种方式选一种即可，不需要都安装。Python 是运行源码所需的软件环境，普通用户使用 EXE 时无需了解它。

目前还没有可直接下载的新版 EXE 发布包。 当前仓库提供源码，EXE 需要由开发者构建后提供。如果你不熟悉编程，可以等 EXE 发布后再使用，不必为了 rawmem 先学习下面的 Python 安装命令。

方式一：Windows 软件（EXE，适合普通用户）

拿到构建好的 rawmem.exe 后：

1. 像打开其他 Windows 软件一样，双击 rawmem.exe。
2. 选择记录保存的文件夹，并决定是否勾选「开机后自动开始记录」。
3. 点击「开始记录」，允许采集界面列出的本地软件新增会话。
4. 如需保存网页，点击「安装 / 连接浏览器插件」，按页面提示安装并连接插件。

首次启动会跳过已有历史，从此后新增的记录开始。关闭主窗口后后台仍会运行；点击「停止记录」可以停止采集。

当前 EXE 需要从源码构建，尚未作为签名安装包发布。 浏览器插件尚未上架商店，需要在 Chrome 或 Edge 的扩展管理页开启开发者模式，加载提供的 browser-extension 文件夹。这一步仍然需要手动完成。

构建方法见 Windows 记录器说明，已完成的测试及待验证项目见 测试报告。旧版 v0.7.1 发布包不包含本次 Windows 记录器预览版更新。

方式二：Python 命令行（适合开发者）

这一部分需要在终端输入命令。使用 EXE 的用户可以跳过。

先安装 Python 3.10 或更高版本和 Git，再打开 PowerShell 执行：

git clone https://github.com/Liyuan1992/rawmem.git
cd rawmem
python -m pip install --user -e .

核心库没有第三方运行依赖。读取 DeepSeek Harness 压缩会话、使用只读 MCP 服务时，可以安装对应的可选依赖：

python -m pip install --user -e ".[deepseek-harness,mcp]"

请确保 Python 的用户 Scripts 目录在 PATH 中。如果暂时找不到 rawmem 命令，可以用 python -m rawmem 执行下文命令。

命令行集成适合开发者，配置范围与图形记录器不同。先查看将进行的操作：

rawmem setup --global --install-startup --dry-run

确认后，按需启用全局配置、Git hooks 和登录自启：

rawmem setup --global --yes
rawmem setup --install-startup --yes
rawmem setup --start-daemon
rawmem doctor

全局 CLI 配置还包含 PowerShell 历史等来源；剪贴板默认关闭，目录监听需要配置。具体范围和移除方法见 安装说明。

目前能记录什么

| 来源 | 当前采集内容与边界 |
| --- | --- |
| Codex、Claude Code、Cursor | 支持的本地会话中的用户与助手文字，以及项目、会话等来源信息 |
| DeepSeek Harness | 直接用户与模型对话；工具仅保留名称、标识、状态等元数据 |
| WorkBuddy | 5.1 格式的本地 JSONL 消息文字与来源标识；存储格式已检查，真实登录流程尚未验收 |
| OpenClaw | 本地 JSONL 与 SQLite 对话消息；同一消息的两种存储表示可按可靠标识去重 |
| Kimi Code | 新版 Kimi Code 的完整 wire 日志记录，包括子 agent；不覆盖旧 Python kimi-cli |
| OpenCode | 已验证 1.18.30 的 SQLite 消息及片段记录，变化后的内容追加保存 |
| Cline | 已验证 CLI 3.0.61 的完整会话文件快照；旧 IDE 格式有模拟数据测试 |
| 浏览器网页 | 主动点击后，保存当前页面已加载的文字、标题与 URL；也可以明确保存选中文字 |
| 命令行与自定义工具 | 手动文字、命令结果、Git 快照，或通过 JSON / 本地 HTTP 接口写入的事件 |

图形记录器开始记录时会启用界面列出的九种本地 AI 软件来源，未安装的软件会跳过。它默认不启用剪贴板、PowerShell 历史或目录监听。

更多格式与版本边界：Kimi Code、OpenCode 与 Cline、DeepSeek Harness。

rawmem 与 DeepSeek Harness 演示

完整保存与去重

- 支持的文字内容不再按字符数截断；旧配置中的 max_chars 不会继续截短采集文字。
- 同一网页、同一 URL、相同文字重复保存时，返回已有记录；文字发生变化时保存新记录。
- 本地消息使用可靠的来源标识去重。不同消息里相同的一句话仍然保留。
- 网页文字与本地对话没有经过验证的共同消息标识时，会分别保留，不猜测它们是否相同。

「不截断」不代表可以读取软件没有提供的内容。尚未加载或已被页面移除的历史、无法访问的嵌入页面、链接指向的附件不会自动补齐。采集仍受系统资源和源软件格式影响；轮询之间已被覆盖或删除的内容无法重建。Cline 的完整快照可能包含重叠历史，会占用更多空间。

数据存在哪里

图形记录器把 events.jsonl 保存在你选择的目录，应用设置单独保存在本机用户目录。命令行工具默认使用：

~/.rawmem/events.jsonl

使用 --local 可写入当前项目的 .rawmem/events.jsonl；使用 --ledger  可指定账本。

账本每行是一条 JSON 事件，包含来源、时间、原始文字及来源元数据。历史采用追加写入，哈希链用于发现意外改写；它不等同于加密或安全防篡改保证。相邻的去重索引是可重建的辅助文件，账本才是原始记录来源。

记录可能包含私人内容，请将保存目录作为私人资料管理，不要提交到公开仓库。配置的隐私策略可能在写入前脱敏常见密钥形式；「不截断」不会关闭这些策略。详情见 隐私说明 和 安全说明。

常用命令

手动保存一条记录
rawmem capture --source manual --type note --text "今天的第一条记录"

检查运行状态与最近记录
rawmem doctor
rawmem daemon --status
rawmem tail --limit 10
rawmem verify --json

手动同步；首次同步时可选择导入旧历史
rawmem sync
rawmem sync --backfill

分批导出
rawmem export --cursor-file .rawmem/consumer-cursor.json --limit 100

预览移除操作；实际移除默认保留 CLI 账本
rawmem uninstall --dry-run
rawmem uninstall

以上命令默认操作 CLI 配置。查看图形记录器的账本时，请通过 --ledger 指定其实际文件位置。

导出、封存与游标协议见 账本协议。可选的 rawmem-mcp 提供只读访问，默认返回摘要；读取原文需要明确的 read:full 权限。记录不会因此自动变成经过确认的个人记忆。

开发与验证

$env:PYTHONPATH = "src"
python -m unittest discover -s tests
node --test tests/browser_capture.test.cjs
python scripts/open_source_audit.py

项目以 Windows 为当前验证平台。图形预览版已在干净的 Windows Sandbox 中完成 Edge 插件安装、连接、保存、去重及停止恢复验证；实际 Windows 登录自启和部分第三方真实账号流程仍需单独验收。完整范围见 测试报告。

许可证

MIT。