Repository navigation
Releases: APUS-AI-Lab/APUS-Reflex-Agent
Release list
APUS Reflex Agent v0.1.4
APUS Reflex Agent v0.1.4
Model-as-a-Harness · 瞬时执行,深度思考。
APUS Reflex Agent v0.1.4 新增 Apple Silicon Mac 本机 Reflex 推理,并重新组织了 Reflex 配置页面。本版首次同时提供 macOS、Windows 和 Linux 的 Full 与 Lite 安装包。
新功能
本机 Reflex 推理
在 Apple Silicon Mac 上,Reflex 判断可以完全在本机运行。判断内容不会离开设备,也无需 API Key。
- 模型选择:可选 APUS Reflex 4B 与 9B,35B 为实验性模型。系统根据本机内存推荐模型,所有模型均可选用;如果所选模型可能超出可用内存,会在下载前提示。
- 下载管理:支持暂停、断点续传和取消。下载完成后先校验文件完整性,再检测推理速度,两项均通过后才启用模型。
- 无缝切换:切换模型时,新模型在后台加载,当前模型继续提供服务。切换完成后可撤销,恢复之前的模型。
- 资源管理:停用本机推理后会立即释放内存。启用后推理服务预先加载,首次判断无需等待冷启动。
- 数据不外发:选择「本机」后,即使本机暂时无法完成判断(例如服务已停用或尚未下载模型),请求也不会转发到云端服务。
Reflex 配置页面
Reflex 配置页面由总开关「启用 Reflex 决策」统一控制,下设三个模块:
- 决策服务:选择接入方式(本机、APUS Reflex 限时免费端点或自定义参数),并管理本机模型。
- 决策前置:新增独立开关。开启后,Reflex 在主模型回答之前判断输入、选择 Skill 与工具,并预取工作区内容。
- 记忆:Continuum 跨会话记忆设置。
改进与问题修复
- 修复了从 v0.1.3 起应用自第二次启动后不再执行用户目录插件维护的问题。升级到本版后,缺失的决策组件将自动恢复。
- 「APUS Reflex 限时免费端点」缺少服务凭据时,连接状态会明确说明原因,不再显示「暂不可用 · 耗时 0 毫秒」。
- Reflex 总开关的状态在各界面之间实时同步。
- 删除本机模型后,接入方式保持为「本机」。
- 取消模型下载前会请求确认。
下载
Full 版内置 Office 文档转换引擎;Lite 版不含该引擎,体积更小,其余功能相同。
| 平台 | Full | Lite |
|---|---|---|
| macOS(Apple Silicon) | DMG · ZIP | DMG · ZIP |
| macOS(Intel) | DMG · ZIP | DMG · ZIP |
| Windows x64 | 安装程序 | 安装程序 |
| Linux x64 桌面版 | .deb | .deb |
| Linux x64 Web 版 | tar.gz | tar.gz |
文档:安装指南 · 模型配置 · Web 版部署 · 本机推理
系统要求
- macOS:15.0 或更高版本。本机 Reflex 推理仅支持 Apple Silicon,需要设备具备 Metal GPU。
- Windows:Windows x64。
- Linux:x64;桌面版以 .deb 包分发。
安装包不含任何共享 API Key。首次使用前,请在「设置 → 模型」中配置您自己的模型服务。
签名与安全
- macOS 安装包采用 ad-hoc 签名,尚未获得 Apple Developer ID 签名和公证。首次打开时,系统可能要求您在「系统设置 → 隐私与安全性」中确认。
- Windows 安装程序尚未进行 Authenticode 签名,运行时可能出现 SmartScreen 提示。
- 本机推理基于 llama.cpp
b11118。模型文件从 Hugging Face(apus-ailab)下载,版本固定,并在下载后校验 SHA-256。
已知问题
- 「APUS Reflex 限时免费端点」需要服务凭据,新安装默认无法使用。建议选择「本机」(Apple Silicon Mac)或「自定义参数」。
- 首次启动时不会引导配置主模型,请先在「设置 → 模型」中完成配置。
- 在没有 Metal GPU 的 Mac 虚拟机上,需要等模型下载完成后,才会提示本机推理不可用。
- 后台切换模型期间,新旧两个模型会同时占用内存。
- Windows 卸载耗时较长,可能超过 2 分钟,但会正常完成。该问题将在后续版本中改进。
质量验证
所有安装包均完成了安装、设置保存、重启后设置保留以及退出清理的自动化测试。Apple Silicon 安装包在 macOS 26.5 实体设备上测试;macOS Intel、Windows、Linux 桌面版与 Web 版在 GitHub Actions 托管环境中测试。Windows 安装包的各项功能测试均已通过,仅卸载耗时超出测试时限(见「已知问题」)。
文件校验
每个平台和版本均附有以下文件,请按版本(full / lite)和平台对应使用:
SHA256SUMS-*:安装包校验值。build-info-*.json:构建信息。runtime-dependencies-*.json:运行时依赖清单。LICENSES-*.zip:第三方许可证。qualification-*.json:测试结果摘要,并附有对应的校验文件。
macOS / Linux 校验示例:
shasum -a 256 -c SHA256SUMS-full-darwin-arm64 --ignore-missing桌面安装包构建自提交 b5b456d。Linux Web 版构建自 9b0e754,该提交仅更新了测试脚本,产品代码与桌面版一致。
English
APUS Reflex Agent v0.1.4 adds on-device Reflex inference for Apple Silicon Macs and reorganizes the Reflex configuration page. This is the first release to provide Full and Lite packages for macOS, Windows and Linux together.
What's new
- On-device Reflex inference (Apple Silicon). Reflex decisions can run entirely on the Mac, with no data leaving the device and no API key required. APUS Reflex 4B and 9B are available, and 35B is experimental. The app recommends a model based on installed memory; every model remains selectable, with a notice before download if it may exceed available memory. Downloads can be paused, resumed and cancelled. Each model is checked for integrity and inference speed before it is enabled. When you switch models, the new one loads in the background while the current one keeps serving, and you can undo the switch. Disabling local inference frees its memory immediately. When This Mac is selected, requests are never forwarded to a cloud service, even if local inference is temporarily unavailable.
- Reflex configuration. A master switch, Enable Reflex decisions, controls three sections. Decision service sets how Reflex connects and manages local models. Pre-step decisions has a new toggle: when it is on, Reflex judges the input, picks Skills and tools, and prefetches the workspace before the main model answers. Memory holds the Continuum settings.
Improvements and fixes
- Fixed an issue, present since v0.1.3, where plugin maintenance in the user directory stopped running after the first launch. Missing decision components are restored automatically after upgrading.
- When the APUS Reflex limited-time free endpoint has no service credential, the connection status now states the reason.
- The Reflex master switch now stays in sync across views. After a local model is deleted, the connection mode stays This Mac. Cancelling a download now asks for confirmation.
Requirements and signing
- macOS 15.0 or later is required. On-device inference requires Apple Silicon with a Metal GPU.
- No shared API key is included. Configure your own model service in Settings → Models before first use.
- macOS packages are ad-hoc signed and not yet signed with an Apple Developer ID or notarized. Windows installers are not Authenticode-signed.
- On-device inference uses llama.cpp
b11118. Model files are downloaded from Hugging Face (apus-ailab) at pinned versions and are verified by SHA-256.
Known issues
- The APUS Reflex limited-time free endpoint requires a service credential and does not work on a new installation. Choose This Mac (Apple Silicon) or Custom parameters instead.
- First launch does not prompt you to configure a main model.
- On Mac virtual machines without a Metal GPU, local inference reports that it is unavailable only after the model has downloaded.
- While a model switch is in progress, both models occupy memory.
- Uninstalling on Windows can take more than two minutes, but it completes. This will be improved in a future release.
Verification
Every package passed automated tests for installation, settings persistence across restarts and clean exit. Apple Silicon packages were tested on physical hardware running macOS 26.5. The other packages were tested on GitHub Actions hosted runners. On Windows, all functional tests passed; only the uninstall exceeded the test time limit.
Each edition and platform includes checksums, build information, a runtime dependency inventory, third-party licenses and a test summary. Desktop packages are built from b5b456d. The Linux Web packages are built from 9b0e754, which differs from it only in a test script.
APUS Reflex Agent v0.1.3 — Full & Lite Preview
APUS Reflex Harness · Model-as-a-Harness
- 启动页简化为「正在启动」与「瞬策 · 瞬时执行,深度思考」。
- 「Reflex 配置」提供「APUS Reflex 限时免费端点」和「自定义参数」,移除旧协议选项,并收拢 Continuum 记忆开关。
- 接入真实输入判断与 Skill 选择反馈,补齐 Web 执行模块。
- 修复 macOS 签名扫描与 Windows 卸载验收问题。
Full 内置 Office 转换引擎;Lite 更小,保留其余主要功能。
| 平台 | Full | Lite |
|---|---|---|
| macOS Apple Silicon | DMG · ZIP | DMG · ZIP |
| macOS Intel | 正在构建 | DMG · ZIP |
| Linux x64 Web | tar.gz | tar.gz |
Windows x64、Intel Mac Full、Linux 桌面正在完成验收,通过后补充至本页。
macOS 需 15.0 或更高版本。已发布 Mac 包通过严格签名完整性及安装、重启验收,采用 ad-hoc 签名,尚无 Apple Developer ID 签名或公证。
安装包不包含共享 API Key;主模型需自行配置,免费端点需已部署服务凭据。安装与功能配置验收不代表所有输入均在 1 秒内响应或端到端加速 3 倍。
版本 0.1.3 Preview,源码 811834ade1648a7231303ba6b7a968d410f61e7e。附件包含构建清单、SHA256 校验值和验收摘要;GitHub 的 Source code 压缩包是源码。
APUS Reflex Agent v0.1.2 — Full & Lite Preview
APUS Reflex Agent v0.1.2
Model-as-a-Harness · 瞬时执行,深度思考。
本版提供 Full 与 Lite 两种安装包。Full 内置 Office 转换引擎;Lite 移除该引擎,保留 Personal Agent、Reflex、Continuum 记忆、Loop Working、Codex、PPT 工作台与现有语音能力。通过切换安装包选择版型,不包含在线组件下载器。
This release introduces Full and Lite editions. Full bundles the Office conversion engine; Lite excludes that engine while retaining Personal Agent, Reflex, Continuum memory, Loop Working, Codex, the PPT workbench and existing speech capabilities. Change editions through their installation packages. No online component downloader is included.
Changes / 更新
-
修复 macOS 应用资源签名不完整;安装后的应用接受严格签名完整性校验。
-
修复 PPT 运行时打包遗漏,并验证实际安装包包含所需运行时。
-
补齐桌面与 Web 的可选 Continuum 记忆配置、CLI 解析依赖与持久化设置;记忆默认关闭,可在设置中手动开启。
-
接入最新 main 的 TaskMemory 改动;跨会话记忆使用显式任务标识,不能将它理解为任意会话自动共享全部历史。
-
两版保留原有应用身份和数据位置;安装文件统一使用
apus-reflex-agent前缀。 -
Repair incomplete macOS resource signatures and verify the copied application's signature integrity.
-
Restore the packaged PPT runtime.
-
Complete optional Continuum memory composition and resolver dependencies in Desktop and Web; memory remains disabled by default and can be enabled in Settings.
-
Include TaskMemory from the latest main. Cross-session task memory uses explicit task identifiers, rather than automatically sharing all unrelated sessions.
-
Preserve the existing application identity and data locations in both editions, with installer filenames prefixed
apus-reflex-agent.
Installation / 安装
macOS 最低版本为 15.0。Apple Silicon 下载 mac-arm64,Intel 下载 mac-x64;只下载本页已列出的目标文件。Linux Full/Lite Web 发行包已提供 web-linux-x64.tar.gz;Linux 桌面 DEB 和 Windows 安装包仍待验收,不将源码压缩包作为安装包。
macOS requires 15.0 or later. Choose mac-arm64 for Apple Silicon or mac-x64 for Intel. Download only the targets actually attached to this release. Linux Full/Lite Web distributions are available as web-linux-x64.tar.gz. Linux desktop DEB and Windows installers remain pending qualification. GitHub Source code archives are not installers.
此版本是预览版。macOS 包使用 ad-hoc 签名,未获得 Apple Developer ID 签名或公证;签名完整性通过不代表 Gatekeeper 信任。仓库仍为私有时,下载需要仓库访问权限。
This is a preview release. macOS packages are ad-hoc signed, without an Apple Developer ID signature or notarization. Signature integrity does not establish Gatekeeper trust. Downloads require repository access while the repository remains private.
中文安装与配置 · Installation and configuration · Full/Lite guide
首次使用需配置自己的模型服务与 API Key。Optional Reflex/Jev endpoints support OpenJev and Typesafe.
Build information / 构建信息
Source commit: 40cf72403ceaa70f3d95eac12bda71eca4b5c126. 前后端与每个平台包来自同一源码提交。每个 edition/target 提供独立构建信息、实际依赖清单、许可归档与 SHA256SUMS;校验文件与安装包版型和目标必须一致。v0.1.0 历史附件和说明保持原样。
Frontend, backend and platform packages use the same source commit. Each edition and target includes separate build information, an actual runtime dependency inventory, license notices and checksums. Match the edition and target when verifying. Historical v0.1.0 assets and notes are unchanged.
Package sizes / 包体积
| Apple Silicon | Full | Lite | Lite reduction / 瘦身 |
|---|---|---|---|
| DMG | 476.56 MiB | 363.49 MiB | 113.07 MiB (23.73%) |
| ZIP | 558.22 MiB | 432.82 MiB | 125.41 MiB (22.47%) |
这是最终安装文件的测量值;Lite 只移除 Office 转换引擎,其他改动带来的瘦身已同时用于两版。These are measured installer sizes. Lite removes the Office conversion engine; other package reductions apply to both editions.
Full Office 验收:安装后的原生引擎成功转换 DOCX/PPTX/XLSX,独立验证 PDF 文本和页数,并重算工作表公式为42;转换前后签名完整性均通过。系统缺少 Calibri 时会字体回退,不能保证任意文档排版与原应用完全一致。Installed Full Office qualification: native DOCX/PPTX/XLSX conversion, independent PDF text/page checks and formula recalculation to42 passed. Signature integrity passed before and after conversion. Missing Calibri triggers font fallback; arbitrary documents are not guaranteed to retain identical layout.
Qualification scope / 验收范围
Apple Silicon Full/Lite 的真实 DMG 安装、脱离镜像启动、版本显示、记忆开关设置写入及重启保存、退出进程清理、严格资源签名和 ZIP 完整性检查均通过。验收机为 macOS26.5 / Apple Silicon;未在 macOS15.0 实体硬件上测试。安装测试不调用真实模型 API,不作为模型召回效果证据。
Apple Silicon Full/Lite passed actual DMG installation, startup after detaching the image, product version display, memory-setting writes and restart persistence, quiescent exit, strict resource-signature verification and ZIP integrity. The runner was macOS26.5 on Apple Silicon. macOS15.0 hardware was not exercised. Installer checks do not call a real model API and are not recall-quality evidence.
Known installation-path limitation / 已知安装路径限制
Full/Lite 互换请覆盖同一安装位置(macOS 建议 /Applications/APUS Reflex Harness.app)。已启用的记忆配置目前含安装路径断言:从不同位置运行另一个副本,旧配置可能不被应用。跨路径自动迁移尚未通过,作为待修项保留;这与删除会话数据不同。
Switch Full/Lite at the same installation location (on macOS, /Applications/APUS Reflex Harness.app is recommended). Saved memory configuration currently includes an installation-path assertion. Running another copy from a different location may leave that configuration unapplied. Automatic cross-path migration is not qualified and remains a follow-up issue; this does not delete the Session data.
Full→Lite→Full 同安装位置切换的3阶段实测通过:保持记忆开启和重启状态、原会话字节、完整用户配置与旧Office开关,Lite确认引擎缺失,切回Full恢复引擎。会话种子来自真实Loader/JSONL执行,但模型为MockAdapter,不作真实模型效果证明。公开验收摘要见 qualification-darwin-arm64.json。
All three stages of same-location Full→Lite→Full switching passed: memory enablement and restart persistence, original Session bytes, the complete user patch and the previous Office setting were retained. Lite engine absence and restored Full engine presence were verified. The Session seed came from a real Loader/JSONL execution using MockAdapter; this is not real-model effectiveness evidence. See qualification-darwin-arm64.json for the public qualification summary.
Linux Web qualification / Linux Web 验收
Full/Lite 的 Linux Web 发行包均在 Ubuntu24.04、内核6.8.0-136 的原生 x64 宿主容器中,以普通用户通过9阶段验收:归档与源码校验、无外部 Node/Git、内置 Node 与受限 shell 的允许/拒绝写入、默认工作区与输入框、版本显示、HTTP 鉴权与模型/Reflex 设置保存、两次退出清理,以及重启后的工作区和设置保留。此验收独立于 GitHub Actions;Landlock 报告旧 ABI 的部分支持,实际文件写入限制已验证。
Both Linux Web editions passed nine qualification stages as a non-root user in a native x64 host container running Ubuntu24.04 with kernel6.8.0-136: archive/source verification, startup without external Node/Git, bundled Node and confined-shell allowed/denied writes, default workspace and editable composer, version display, HTTP authentication and model/Reflex settings, quiescent exits, and workspace/settings retained after restart. These tests did not run in GitHub Actions. Landlock reported partial support for an older ABI; filesystem restrictions were exercised.
| Linux Web x64 | Full | Lite | Lite reduction / 瘦身 |
|---|---|---|---|
| tar.gz | 301.64 MiB | 255.55 MiB | 46.09 MiB (15.28%) |
此处未调用真实模型 API,也未执行 Office 文档转换;不能作为 Linux 桌面 DEB 或模型记忆效果的验收。公开摘要见 qualification-web-linux-x64.json。No real model API or Office document conversion was exercised here. This is not qualification of the desktop DEB or model memory quality. See qualification-web-linux-x64.json for the public summary.
Intel Mac qualification / Intel Mac 验收
| Intel Mac x64 | Full | Lite | Lite reduction / 瘦身 |
|---|---|---|---|
| DMG | 500.62 MiB | 382.54 MiB | 118.08 MiB (23.59%) |
| ZIP | 585.28 MiB | 454.68 MiB | 130.60 MiB (22.31%) |
Intel Full/Lite 安装包与 ZIP 已发布,并在 Apple Silicon 上通过 Rosetta x86_64 验证;未在实体 Intel Mac 上测试。Full 完成单次真实 DMG 安装、签名、开关写入和重启验收。Lite 的首次真实 UI 写入成功,但该次自动化的重启导航超时;保留相同配置,随后两次新进程启动均在真实界面确认设置开启并静止退出。资格来自这些串联证据,不把首次自动化失败改记为通过。两版 ZIP 完整性均通过。
Intel Full/Lite installers and ZIP archives are published and tested through Rosetta x86_64 on Apple Silicon, without physical Intel hardware testing. Full passed a single actual-DMG installation/signature/settings/restart run. Lite accepted the initial actual UI setting write, but that automation run timed out during restart navigation. Two subsequent process starts with the unchanged profile confirmed the enabled setting in the actual UI and exited quiescently. Qualification uses these composed observations; the original automation failure is retained. Both ZIP integrity checks passed.
Intel Full→Lite→Full 的同位置分阶段切换资格3/3通过:真实界面与两次启动、用户设置及Session字节保留、Lite引擎缺失与旧Office配置覆盖、Full引擎恢复。原driver在Lite启动时有一次60秒自动化超时;失败报告保留,复用相同实际安装副本与未修改的配置完成后续阶段。公开摘要见 qualification-darwin-x64.json。
Intel same-location, phased Full→Lite→Full qualification passed all three stages: actual UI and two starts per stage, unchanged user settings and Session bytes, Lite engine absence with the previous Office patch overridden, and restored Full engine presence. The original driver had one60second automation launch timeout for Lite. Its failed report is preserved; continuation reused the same actual installed copy and unchanged profile. See qualification-darwin-x64.json for the public summary.
APUS Reflex Harness 0.1.0
APUS Reflex Harness 0.1.0
Model-as-a-Harness · 瞬时执行,深度思考。
前后端合并为一体化仓库,客户端内置后端,Web 包内置 Node 和浏览器资源;下载安装包后,无需另外 clone 或部署后端。
Frontend and backend now ship from one repository. Desktop and Web downloads include their runtime; no separate clone or backend setup is needed.
| 平台 / Platform | 下载 / Download |
|---|---|
| macOS Apple Silicon | DMG · ZIP |
| macOS Intel | DMG · ZIP |
| Windows x64 | 安装包 / Installer |
| Ubuntu 24.04 x64 | DEB |
| Linux x64 Web | TAR.GZ |
预览版,未签名;Windows/Linux 桌面安装验证尚未通过。Unsigned preview; Windows/Linux desktop installation validation has not passed.
首次使用请配置自己的模型服务和 API Key;可选 Reflex/Jev 接入支持 OpenJev、Typesafe。Configure your own model provider and API key; optional Reflex/Jev endpoints support OpenJev and Typesafe.
中文安装与配置教程 · Installation and configuration
校验文件与许可声明见附件;GitHub 的 Source code 压缩包不是安装包。Checksums and license notices are included; GitHub Source code archives are not installers.
仓库私有期间,下载需要访问权限。Downloads require repository access while the repository is private.