ContextFlow 1.1.1 — 阅读体验与可靠性更新

ContextFlow 1.1.1 improves the reading workflow across the Chrome extension, desktop app, website and documentation.

• Unified product theme, navigation and installation flow.
• More reliable inline annotations, images, Markdown formulas, reading library backups and article navigation.
• Improved Agent configuration testing, Codex profile selection, shared readiness state and error messages.
• Better desktop background behavior, menu bar access, service lifecycle and recovery diagnostics.

Install the extension from the Chrome Web Store. Chrome review and distribution are independent of this GitHub release; this release does not mean the extension update has been approved.

For AI and note sync, download the Mac Apple Silicon DMG and follow the desktop setup guide. Requires macOS 13.5+. This direct-distribution build accepts the store extension only. The app includes its runtime; end users do not need npm, Git or Node.js.

The Mac package has ad-hoc integrity sealing, but no Developer ID signature or Apple notarization. Other desktop architectures are not offered for download yet. SHA-256 sidecars verify the exact files; they are not publisher certification. Existing data and configuration should be retained during manual overwrite upgrades.

Validation: full local release regression, real Chromium extension workflows, Electron layout/lifecycle, installed Agent protocol checks, restricted Personal model connection, and packaged runtime startup. Windows clean-install testing and renewed manual OS browser authorization are outside this release's current local verification scope.

Assets:

• ContextFlow-1.1.1-mac-arm64.dmg: desktop installer.
• contextflow-chrome-1.1.1.zip: tested store upload package, not an alternative marketplace install flow.
• contextflow-companion-1.1.1.zip: advanced CLI companion.
• contextflow-store-site-1.1.1.zip: static website snapshot.

Each asset has a .sha256 sidecar. Previous release artifacts are preserved.

ContextFlow 1.1 — 阅读与自己的工具连接

ContextFlow 1.1.0

桌面客户端适用于 macOS 13.5+、Apple Silicon（M 系列），可从官网下载。Chrome 扩展 1.1.0 单独提交商店审核，以商店实际版本为准；不会替用户卸载或清空已有扩展。

使用流程

1. 先安装 Chrome 商店的 ContextFlow，再从官网下载 Mac ARM64 DMG。
2. 将 ContextFlow 放入「应用程序」并打开。应用内置运行环境、自动准备本地服务，不需要安装 Node.js 或运行 npm。
3. 在匹配扩展的「连接与设置」勾选数据说明并点击「连接桌面端」，回桌面弹窗核对后「允许连接」。不需要终端或手工复制配对码。
4. 按需选择模型或 Agent，先测试当前草稿、再保存；笔记位置独立选择并确认。回文章完成实际回答或点击「同步」验证写入。

桌面能力

• 状态首页、AI 助手、笔记与设置四个工作区。
• 支持的本地 Agent 与 Obsidian 已登记库的候选发现；发现不等于登录、授权或测试通过。
• 菜单栏状态与重新打开窗口；关闭窗口后仍运行，明确退出才结束服务。
• 模型 / Agent 草稿测试、共享配置与实际回答 / 同步状态反馈。
• 凭据加密保存、本机恢复点、浏览器授权管理及脱敏诊断。
• 官网手动覆盖更新；先让任务结束并退出旧版，保留已有数据，不为更新卸载扩展。
• 普通 HTTP 网页也能安全生成记录编号；修复点击批注无反应的兼容问题。
• 原生授权超时、取消、断开与并发申请有明确边界，迟到的批准不会留下假授权。
• 面板、记录列表与阅读库共用 Markdown / GFM 和公式渲染，保留导出的原始公式文本。

安装安全与范围

此包没有 Developer ID 签名，也未经过 Apple 公证。macOS 可能阻止首次打开；SHA-256 只验证文件完整性，不证明发布者身份或通过 Apple 安全审核。只从本仓库 Release 或官网链接下载，参阅 Apple 的安全打开说明。若系统提示应用损坏或恶意软件，停止安装并反馈，不关闭系统安全保护。

已在 Apple Silicon 本机进行打包、内置服务及隔离生命周期验证；不是所有 Mac 的干净安装证明。Intel Mac、Windows x64 / ARM64 尚未开放下载，不将交叉构建当作实机支持。

统一分发 tag 为 v1.1.0，包含 Mac 安装器与同版本 companion、Chrome、网站 ZIP；GitHub 此次标为 prerelease、非 latest。它不覆盖 v1.0.0，不表示 Chrome 商店 1.1 已审核或上线。维护者内部仍保留严格签名发行门禁，未签名分发不会伪造签名 / 公证验收；将来正式签名发新版本，不覆盖此 tag。

核对下载文件

将 DMG 与同名 .sha256 下载到同一目录，再在该目录执行：

shasum -a 256 -c ContextFlow-1.1.0-mac-arm64.dmg.sha256

仅出现 OK 表示两份下载文件的摘要一致。不要公开 API key、配对码、配置、阅读备份或私人笔记；反馈时提供版本、系统、复现步骤和脱敏截图即可。

ContextFlow 1.0 — 从阅读现场，到自己的理解

ContextFlow 1.0 — 从阅读现场，到自己的理解

1.0 已于 2026-10-20 提交 Chrome 商店审核，后台已确认待审核；通过后自动发布，目前尚未上线。此 GitHub Release 不表示已通过 Google 审核。商店当前版本仍可安装。不要卸载已有扩展来更新，以免清除其独立阅读数据。静态网站 ZIP 为冻结时的快照，最新审核进度以官网和本发行页说明为准；不覆盖已发布附件。

这一版带来什么

• 原位图文批注与侧栏共享记录；新的阅读工作台按原文分组、搜索与筛选，长答案收起、取消 / 重试、最近五个历史回答及页面内删除撤销。
• 「我的阅读库」跨文章搜索与预览；单篇含图 Markdown、完整阅读 JSON 备份与校验后补充恢复，不覆盖已有或已删除记录，不重启 AI。
• LLM / Agent 分别测试，模型列表有数量与失败反馈，欢迎页和阅读设置共享带时间的连接测试结果。测试草稿不保存配置，保存需明确点击。
• 仅主动生成才调用 AI；取消向上游传播；排队任务保持提交时的模型、凭据与权限，不因别的页面改配置而切换目标。
• 帮助与诊断、可预览的脱敏报告、键盘调宽 / 移动 / 缩放、焦点恢复、窄屏 / 深色 / 减少动态效果。
• 重写产品文档、升级说明并重拍真实截图。未新增浏览器权限、遥测或云账号。

选择正确的文件

• 商店安装用户： 等待同一条目更新；AI / 笔记同步需要与实际扩展版本匹配的 contextflow-companion-1.0.0.zip。不要在 0.3.2 连接页误选新版本服务包；优先使用页面生成的匹配链接。
• 手动测试： contextflow-chrome-1.0.0.zip 是解压加载的无凭据备用扩展包，不包含本地服务。不要与正式版同时启用；手动扩展 ID 与数据空间不同，按其选项页独立配对。
• contextflow-store-site-1.0.0.zip 为静态官网文件，不是服务。
• .sha256 是校验文件。不要将 Source code 当成预先配置好的服务。

安装与升级：完整指南。升级本地服务保留原配置与数据，先停止旧服务，不重复生成配对码。

已验证与边界

完整自动测试、全新 production 依赖 / 配对 / 撤销、macOS 隔离 Chromium 端到端、真实扩展截图与导出均通过。模型及 CLI 使用可控模拟服务，未调用私人付费账号。生产依赖安全检查未发现已知漏洞（检查时点）。

中文界面为主；完整 JSON 单份上限 32 MB、未加密；无云同步。翻译始终需要 LLM，Agent 仅用于解释与速览。Windows / Linux 独立实机、不同真实上游与新用户研究仍需持续验证。详细范围和限制 · 跨入口审查记录。

ContextFlow v0.3.2 — 完整安装与连接引导

安装与首次使用体验更新

ContextFlow 0.3.2 完善了从 Chrome 商店安装，到离线批注、连接本地服务、配置模型和同步笔记的完整流程。

• 首次使用先体验高亮、批注和 Markdown 导出，无需账号、Node.js 或 API key。
• 连接页提供完整启动命令，先校验 Node.js 版本和项目目录，避免在用户主目录误执行 npm ci。本地服务要求 Node.js 22.13+。
• 配对失败可保留输入重试；重新打开连接页时会实际检查服务状态。
• 配对后直接在同页配置模型和笔记，不必切回文章寻找设置。
• 新增用户主动触发的模型连接测试；仅发送固定短消息，可能产生少量模型费用，不发送文章或笔记。
• 补齐 Obsidian 手动目录输入，移除维护者专属的思源笔记本默认值，修复同步前未落盘记录的衔接问题。
• 改进服务未启动、配对无效、端口占用及模型地址错误时的反馈。

下载与使用

• contextflow-companion-0.3.2.zip：AI、笔记同步所需的本地配套服务。解压到固定目录，再按其中 README 或扩展连接页操作。
• contextflow-chrome-0.3.2.zip：开发者模式备用安装包；普通用户请优先使用现有 Chrome 商店条目。
• contextflow-store-site-0.3.2.zip：静态支持站点部署包。
• 每个 ZIP 均附 SHA-256 校验文件。

GitHub 发行不等于 Chrome 商店已上架。 本发行先提供新版本连接页依赖的服务下载；Chrome 商店更新需另行提交并等待 Google 审核。当前商店版本与审核状态以商店及 发布记录 为准。

验证范围

完整自动化测试、独立服务包安装/配对测试，以及正式商店 ID 下的隔离 Chromium 端到端测试已通过。覆盖离线批注、导出、首次配置、配对重试、模型错误反馈和笔记同步；模型请求使用隔离测试端点，未调用真实计费模型。Windows/Linux 尚未完成全新真实机器验收。

未增加扩展权限、遥测或开发者托管模型账号。

ContextFlow 0.3.1

ContextFlow 0.3.1 为 Chrome Web Store 首次发行准备了独立配对、扩展私有存储和安装引导，并包含最新的阅读体验修复。

• 已有解释时，顶部按钮可直接重新解释；更改问题后提交新提问，处理中防止重复请求。
• 正确显示本地 agent 的未登录及其他失败原因，避免原始错误 JSON 被当作答案。
• 保留 Markdown 表格预览、排队进度稳定显示、原位批注与图片补充。
• 商店安装包不含发布者凭证；每位用户与自己的本地服务独立配对，授权可撤销。
• 阅读记录和附件保存在扩展私有 IndexedDB，配对凭证限制为受信任扩展上下文访问。

安装：商店版本仍需通过 Google 审核。使用 AI 和笔记同步时，下载 contextflow-companion-0.3.1.zip，解压后按包内 README 操作（需要 Node.js 22.5+）。扩展连接页会给出对应扩展 ID 的配对命令。离线高亮、批注和 Markdown 导出不要求运行本地服务。

从旧开发版升级前，请先同步或导出未同步记录。旧版存放于网页所属存储的缓存不会自动导入新版扩展私有存储。

隐私政策：https://pengheliu.github.io/ContextFlow/privacy.html

验证：完整测试套件、商店构建/运行时/配对集成检查、服务发行包全新依赖安装，以及 Chromium 153 端到端配对、凭证隔离、离线保存、刷新恢复、撤销和 Markdown 导出均通过。未调用真实计费模型。