Skip to content

Releases

1.3.0

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 19 Nov 03:17
4018eae
  • The built-in agent is a trimmed version of Pi. It keeps Pi's sessions, models, logins, skills, context files, its read, edit, write and shell tools, and MCP, without the terminal parts. main.js is about 9 MB instead of 12.7 MB.

  • Use your own installed Pi. In Pi to run → Your own install, each task runs your Pi (pi --mode rpc, 1.5.0 or later) with all your extensions, skills and MCP servers. The plugin only looks for Pi and never installs it.

  • Tool scope and confirmation are two settings. Isolated gives the agent ICAP's tools and file tools inside the vault. Full adds the shell, your connectors and files outside the vault. The confirmation mode (Ask for each, Accept edits in the vault, Skip all confirmations) decides when the agent stops to ask. The agent's edits come to you as a change to review. The original of each changed file is kept for a month. A write to Obsidian's or Pi's own folders always asks.

  • Connectors. The settings show your MCP servers from ~/.pi/agent/mcp.json. You can turn them on or off, add or remove them. They are available in the full scope.

  • Request blocks take messages while the agent works. What you write waits in the block and is sent when the round ends, or reaches the agent at once with deliver now. You can paste, drop or choose images. You can regenerate or edit the last request, copy a reply, and see how full the model's context is.

  • Session notes. New session note makes a note where each finished round is added to a [!request] record (FORMAT.md 7).

  • Activity shows where a task's time went. A strip shows the wait for the model, its thinking, your turns and the tool calls. Each tool call shows its time and what it returned. A failed task says why. Copy the task's details puts all of it on the clipboard as text for a bug report.

  • Math renders. \( \) and \[ \] in questions, feedback and replies render as math. A writing line's hint with math renders too.

  • Fixed: lines after a kept callout were out of line. After keep in note, line numbers drifted and a click could select the line above. This is fixed.

  • Windows build fixes (#5, thanks @wzizary).

  • 内置 Agent 是精简版的 Pi。 保留了 Pi 的会话、模型、登录、技能、上下文文件,读取、编辑、写入和 shell 工具,以及 MCP,去掉了终端相关的部分。main.js 从 12.7 MB 减到约 9 MB。

  • 可以使用你自己安装的 Pi。 在 运行哪个 Pi → 你自己安装的 中,每个任务都会运行你的 Pi(pi --mode rpc,1.5.0 或更高版本),带上你所有的扩展、技能和 MCP 服务器。插件只会查找 Pi,从不安装。

  • 工具范围和确认方式是两个设置。 隔离 只给 Agent ICAP 的工具和库内的文件工具;完整 还会加上 shell、你的连接器和库外的文件。确认方式(逐项确认、自动接受编辑、跳过全部确认)决定 Agent 什么时候停下来问你。Agent 的修改会作为一处改动交给你审阅,每个被改文件的原件会保留一个月。写入 Obsidian 或 Pi 自己的文件夹时总会询问。

  • 连接器。 设置里会列出 ~/.pi/agent/mcp.json 中的 MCP 服务器,可以开关、添加或移除。它们在完整范围下可用。

  • Agent 工作时,请求块也能接收消息。 你写的内容会在块中等待,本轮结束时发出;也可以用 立即送达 马上交给 Agent。可以粘贴、拖入或选择图片;可以重新生成或修改最后一个请求、复制回复,并查看模型上下文的占用情况。

  • 会话笔记。 新建会话笔记 会创建一篇笔记,每一轮结束后都会追加到上方的 [!request] 记录中(FORMAT.md 7)。

  • 活动视图会显示任务的时间花在哪里。 一条时间条显示等待模型、模型思考、你的回合和工具调用;每个工具调用都会显示用时和返回内容。失败的任务会说明原因。复制任务的详情 会把这些内容以纯文本放到剪贴板,方便提交 bug 报告。

  • 数学公式可以正常渲染了。 提问、反馈和回复中的 \( \) 和 \[ \] 会渲染成公式;回复栏提示里的公式也会渲染。

  • 修复:保留的 callout 之后的行会错位。 点击 留在笔记里 后,行号会错位,点击时可能选中上一行。现在已修复。

  • Windows 构建修复(#5,感谢 @wzizary)。

1.2.2

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 11 Nov 21:46
354aad5
  • Where a run waits. Between loading Pi and the first words of a reply, ICAP now says "waiting for a reply…" after the request goes out and "the reply is starting…" when the response begins, on desktop and mobile.

  • Errors from your Pi extensions are shown. With Agent setup: mine, an error thrown by one of your Pi extensions shows under the status line as extension: message, while the run continues (#3).

  • Your Pi extensions get Node's globals, as under the Pi CLI. Extensions and the CommonJS packages they require now get Node's fetch, timers, web streams, Blob/File and performance instead of Obsidian's browser versions. This fixes "Illegal invocation" errors and runs that stalled at "reading the passage…" with extensions such as pi-subagents or an extension's own undici (#3). Through globalThis. or in native ES modules, an extension still gets the browser's.

  • Plugin review fixes. Static styles are CSS classes; the build scripts moved to scripts/build/.

  • 显示运行停在哪里。 从加载 Pi 到回复的第一个字之间,ICAP 现在会在请求发出后显示"等待回复…",在响应开始时显示"回复开始了…"。桌面端和移动端都有。

  • 显示 Pi 扩展的报错。 在 Agent setup: mine 下,你的 Pi 扩展抛出的错误以"扩展名: 消息"的形式显示在状态行下面,运行照常继续(#3)。

  • Pi 扩展拿到 Node 的全局,和在 Pi 命令行里一样。 扩展和它们 require 的 CommonJS 包现在拿到的是 Node 的 fetch、定时器、web streams、Blob/File 和 performance,而不是 Obsidian 的浏览器版本。这修复了使用 pi-subagents 等扩展、或扩展自带 undici 时出现的 "Illegal invocation" 错误,以及卡在"reading the passage…"的问题(#3)。通过 globalThis. 访问或在原生 ES 模块里,扩展拿到的仍是浏览器的版本。

  • 插件审核修复。 静态样式改为 CSS 类;构建脚本移到 scripts/build/。

1.2.1

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 11 Nov 19:39
54a334d

1.2.0

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 11 Nov 05:25
ca267a2
  • Mobile support. ICAP now runs on Obsidian for iPhone, iPad and Android (Obsidian 1.11.4 or later). Phones use an API key or a custom endpoint, kept in Obsidian's secret storage. The selection mark sits above the mobile toolbar, and the activity opens from the ribbon.

  • Activity as a Base. Turn on Record tasks as notes (off by default) to record note tasks and substantial requests as notes in ICAP/Tasks/. ICAP/Activity.base lists them in the new activity view: state, model, files, time, cost, and a strip of steps. Each task shows what it cost under its reply.

  • Diagrams, canvases and bases. The agent can draw Mermaid diagrams and create .canvas and .base files. A canvas or base that would not open is refused, with the reason.

  • New notes: the agent chooses the folder from your vault's AGENTS.md and where related notes are. The folder setting is now an optional default.

  • Nothing in the vault unasked. The document cache moves to the plugin's own folder. Existing .icap/docs/ and icap/docs/ caches are adopted.

  • Settings follow the layout of Obsidian's own tabs. One ICAP style toggle decides how the output looks.

  • On Obsidian installers 1.8.9 and earlier (Node earlier than 22.18), the settings say to reinstall Obsidian, instead of failing with a TypeError (#1).

  • The first-run guide is shorter. The documentation site is at https://icap.edwinzhan.space.

  • Fixes: titles never cut a [[link]]; a focused question no longer looks chosen after Mod+Enter.

  • 支持移动端。 ICAP 现在可以在 iPhone、iPad 和 Android 版 Obsidian(1.11.4 及以上)上运行。手机使用 API Key 或自定义端点,保存在 Obsidian 的密钥存储中。选区标记位于移动工具栏上方,活动从侧边栏按钮打开。

  • 活动成为 Base。 打开把任务记录成笔记(默认关闭)后,笔记任务和较完整的请求会记录为 ICAP/Tasks/ 中的笔记。ICAP/Activity.base 在新的活动视图中列出它们:状态、模型、文件、时间、费用,以及步骤条。每个任务的回复下方显示其费用。

  • 图表、白板和 Base。 智能体可以绘制 Mermaid 图,并创建 .canvas 和 .base 文件。无法打开的白板或 Base 会被拒绝,并说明原因。

  • 新笔记: 智能体根据仓库的 AGENTS.md 和相关笔记的位置选择文件夹。文件夹设置现在是可选的默认值。

  • 不经允许不写入仓库。 文档缓存移到插件自己的文件夹。已有的 .icap/docs/ 和 icap/docs/ 缓存会被沿用。

  • 设置采用 Obsidian 自带设置页的布局。一个 ICAP 样式开关决定输出的外观。

  • 在 1.8.9 及更早的 Obsidian 安装包上(Node 低于 22.18),设置会提示重新安装 Obsidian,而不是报 TypeError (#1)。

  • 首次使用指南更短。文档站点:https://icap.edwinzhan.space。

  • 修复:标题不再截断 [[链接]];按 Mod+Enter 后,获得焦点的问题不再看起来像已选中。

1.1.4

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 10 Nov 04:09
92ba05e
  • Custom model endpoints in the settings. Settings → ICAP Learning Agent → Model providers → Custom endpoint… adds Ollama, LM Studio, vLLM, a proxy or any OpenAI-compatible service (name, base URL, key, model ids). It is saved in Pi's ~/.pi/agent/models.json, shared with the Pi CLI; the rest of that file is left as it was.

  • README: install from the Obsidian community directory.

  • 设置里可以添加自定义模型端点。 设置 → ICAP Learning Agent → 模型服务商 → 自定义端点…:添加 Ollama、LM Studio、vLLM、中转站或任何兼容 OpenAI 的服务(名称、Base URL、Key、模型 ID)。保存在 Pi 的 ~/.pi/agent/models.json,与 Pi 命令行共用,文件里的其他内容不受影响。

  • README:改为从社区插件市场安装。

1.1.3

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 07 Nov 07:24
ac8b53d

1.1.3: blocks fold what is finished; provider retries are shown

  • Earlier rounds of a block fold to one line each; the round before the
    one being answered stays open. A decided change folds to its outcome
    (accepted · +7 −0). More than three touched files fold to their counts.
  • A proposed change is a real line diff: changed lines with two lines of
    context, longer unchanged stretches folded.
  • A whole block folds to its header line, kept across reloads; it opens
    itself when it needs the learner.
  • When the provider returns an error and Pi retries, the block says so
    instead of looking stuck.

1.1.2

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 07 Nov 06:04
785095e

1.1.2: record comments hidden in Live Preview

The line above a kept record is for tools. Reading view
already hides it; Live Preview now hides it too, except while the cursor
or a selection touches the line. The file is unchanged.

1.1.1

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 07 Nov 05:59
8122aec

1.1.1: builds on Node 22; shorter README with screenshots

  • The build marks every node: specifier external, so prefix-only modules
    (node:sqlite) that Node 22's builtinModules omits no longer break it.
  • Styles are set through setCssStyles / setCssProps instead of direct
    assignment; notices use messageEl instead of the deprecated noticeEl.
  • fflate 0.8.3 (advisory GHSA-px8p-9vwx-vf98).
  • README (en, zh): features in one line each, two screenshots, and the
    network, accounts and outside-the-vault disclosure.

1.1.0

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 07 Nov 05:19
f058869

1.1.0: documents as trees; every record names its topic; FORMAT v2

Documents (PDF, EPUB, Word), read like a person reads them:

  • read_document gives a document's structure as a tree of numbered parts
    with page or section ranges (after PageIndex), then one part or a page
    range; documents lists every readable document with its chapters and
    searches across their text. The prompts teach structure first, and
    citations as [[book.pdf#page=12]], never invented pages.
  • Structure comes from PDF bookmarks, the EPUB table of contents (split
    where it points inside a file) or Word heading styles. Without them it
    is detected from the layout, no model: size, weight, capitals and
    numbering, two columns read in order, running headers and TOC entries
    skipped. On PageIndex's sample PDFs it matches their LLM-built trees.
  • The vault's icap/docs/ caches structure and text by content hash, so a
    document is parsed once across renames, tasks and devices; documents are
    prepared in the background (setting, on). FORMAT.md documents the cache.
  • Summaries per part are a setting, off by default: the learner's model
    writes one sentence per node and a few for the document, once.

Records:

  • The comment of a kept recall, check and quiz carries
    topic="…": the selection, else the section heading, else the note name,
    chosen by the plugin, never by an LLM. Quoted values escape \ " and >,
    so a topic can never end the comment.
  • A multi-paragraph recall answer records paragraphs=N, so readers pair
    the whole answer, not just its last paragraph.
  • A kept gloss gets a comment: when
    it was kept, the full term, and whether the learner asked for Plainly or
    Deeper.
  • src/dsl/records.ts is the reference reader of FORMAT.md; test/fixtures/
    format/ pairs sample notes (v2, v1, pre-v1, agent notes, edited titles)
    with the JSON a reader must produce, for other implementations to reuse.

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

1.0.2

Choose a tag to compare

@EdwinZhanCN EdwinZhanCN released this 07 Nov 01:06
362f1df

New

  • A kept recall, check or quiz now says when it was kept and how it went: the callout title ends with the date and the verdict mark (✓ held, ≈ partly, ? reconsider), and a one-line <!-- icap … --> comment above it records the same for other tools. The agent uses these dates to weigh recent evidence above old evidence.
  • FORMAT.md (version 1) documents everything ICAP writes into notes, for anyone building tools that read an ICAP vault.

Fixed

  • The agent can no longer propose an edit that adds an interactive visual to one of your existing notes, or that changes one of ICAP's blocks. Such an edit is refused before you see it.
  • Pasting something that isn't an API key (with spaces, or non-ASCII text) into the login dialog is rejected right away, instead of being saved and failing on the first request with "Failed to execute 'append' on 'Headers'".
  • The "from [[…]]" line under an explanation now has working links: click to open, hover to preview.
  • In Live Preview, the veil toggle no longer sits under Obsidian's </> button.
  • The last few English-only labels (veiled, accepted, declined, …) are translated in the Chinese interface.

Install or update

Download main.js, manifest.json and styles.css below into <your vault>/.obsidian/plugins/icap-agent/, replacing the old files, then restart Obsidian or turn ICAP Learning Agent off and on in Settings → Community plugins. See the README for a first install.