安装前准备

软件依赖

• VS Code (v1.110+)
• Node.js (v18x及以上版本)
• Gemini API Key

确保node.js和VS Code被正确安装 Gemini API Key有效

---

VS Code配置

打开vscode在拓展商店找到

• Chronos — The AI Historian

安装拓展，等待拓展安装完成

新建一个空白文件夹作为Chronos的工作区，并在vscode中打开并添加到信任区。

因为Chronos初始化指令在vscode默认的Powershell终端中不可用，因此需要将默认终端配置为cmd

在vscode中按下Ctrl+Shift+P显示并运行命令

在上方输入框输入并选择命令

Terminal: Select Default Profile

在弹出的终端配置列表中，选择：Command Prompt

关闭当前终端窗口（如果已经打开），然后重新打开一个新终端（快捷键：Ctrl + ` ），你就会看到默认终端已经切换为 CMD。

在vscode中按下Ctrl+Shift+P显示并运行命令

在上方输入框输入并选择命令

Chronos: Init Workspace

弹出安装依赖的对话框，点击确定。 此时会启动终端自动执行

npm install -g @mariozechner/pi-coding-agent && pi install https://github.com/ai-historian/history-agent && echo "" && echo "Chronos setup complete. Re-run the Chronos command from the Command Palette."如已安装node.js

如node.js正确安装，则改指令会被正确运行，但是由于国内网络环境问题，该指令执行后会报错无法访问github服务器，因此将指令中的github链接改为国内镜像站链接，以gitclone.com为例

在终端按键盘上键回到上一条命令，在github.com前加上gitclone.com/

修改后的完整指令为

 npm install -g @mariozechner/pi-coding-agent && pi install https://gitclone.com/github.com/ai-historian/history-agent && echo "" && echo "Chronos setup complete. Re-run the Chronos command from the Command Palette."

(如显示504错误请再次执行) 待指令执行完毕后再次执行Chronos: Init Workspace

Chronos会初始化并要求你输入gemini的api key

---

配置中转站

Chronos会在pi调用google的gemini-2.0-flash,gemini-2.5-flash,gemini-2.5-pro,gemini-3-flash-preiew,gemini-3.1-pro-preview等模型，由于部分特殊原因，我们需要配置中转站以保障Chronos的正常使用。

欲将Chronos调用的gemini服务中转，需修改pi的模型配置，pi支持通过model.json将自己的model配置覆盖到pi的默认配置上，因此配置中转站的方式为

在pi安装位置的agent目录下新建文件model.json (在 windows 系统中 pi 的默认安装位置为C:\User\你的用户名\.pi，Linux和Macos中为~/.pi——简而言之,对于大部分用户而言，请在C:\User\你的用户名\.pi\agent下新建model.json文件）

使用vscode打开model.json文件(使用记事本打开可能会导致一些无法预计的编码问题），在models.json中加入

  {
  "providers": {
    "google": {
      "name": "google",
      "baseUrl": "中转站提供的openai格式api/v1",
      "apiKey": "sk-中转站提供的密钥",
      "api": "openai-completions",
      "models": [
        {
          "id": "gemini-2.0-flash",
          "name": "gemini-2.0-flash",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "gemini-2.5-flash",
          "name": "gemini-2.5-flash",
          "input": ["text", "image"],
          "contextWindow": 400000,
          "maxTokens": 128000
        },
        {
          "id": "gemini-2.5-pro",
          "name": "gemini-2.5-pro",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "gemini-3-flash-preiew",
          "name": "gemini-3-flash-preiewo",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "gemini-3.1-pro-preview",
          "name": "gemini-3.1-pro-preview",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        }
      ]
    }
  }
}

编辑好后保存文件，重启vscode，打开chronos的文件夹，按下Ctrl+Shift+P显示并运行命令，输入并选择指令Chronos: Init Workspace，配置密钥。

配置完成密钥后执行Chronos: Init Workspace指令Chronos会将你使用的空白文件夹初始化为Chronos的工作区

Chronos工作区的结构如下

workspace/
├──sources/ 原始资料
├──data/ 提取结果和结构化数据
├──skills/ 自定义skill
├──memory/ 长期记忆
├──sessions/ 对话和运行记录
└──chronos/ API 密钥等配置

Chronos的使用

在vscode中打开Choronos的文件夹，按下Ctrl+Shift+P显示并运行命令，输入并选择指令Chronos: Import Sources导入资料。

在弹出的文件管理器界面选择你要分析的资料所在的文件夹，Chronos会检查该文件夹下的所有图片，文档，PDF等资料(pdf会被拆分成图片文件)并复制到Chronos工作区下的sources文件夹中

运行指令Chronos: Start Agent Session以正式启动Chronos。此时屏幕上会出现空白的阅读器和pi的终端，第一次启动时需要使用/login指令 再次 配置ai模型

输入/login指令会进入配置模型api程序所以键盘上下键切换选项。

选择 Use an API key

找到并选择Google Gemini配置api key此时Chronos配置完毕

可使用/select-source指令选择要分析的资料，被选择的资料会出现在阅读器中。

Chrono目前可用的几个核心工具有

• list_pages：列出当前史料的全部页面；
• ask_page / 论文中的 analyze_page：把某一页交给视觉模型分析；
• follow_up_question：围绕同一页继续追问，不必重复上传图像；
• show_page：只显示页面，不进行模型分析；
• show_text：显示文本文件并高亮指定段落；
• ask_pages_batch：批量处理多个页面；
• change_source：切换到另一部史料；