Repository navigation
Releases
v1.4.40 · 三端受治记忆与可视化 / Governed memory across three hosts
agents-learning v1.4.40
项目经验留得住、查得到、改得动。Project memory that stays traceable and open to correction.
本次正式版将 Codex、Antigravity 和 DSH 的项目记忆、可视化管理与知识治理放在同一发行版本中。三个宿主分别安装入口,同机、同数据目录、同项目共用知识。
This stable release brings Codex, Antigravity and DSH project memory, visual controls and knowledge governance into one distribution. Install each host entry separately and share the same project's memory on one machine.
安装 / Install
需要 Git、Python 3.10+ 和支持插件的宿主。获取固定正式版:
Requires Git, Python 3.10+ and a supported plugin host. Get the pinned release:
git clone --branch v1.4.40 --depth 1 https://github.com/swenbo1-web/agents-learning.git
cd agents-learning| 宿主 / Host | 安装指南 / Instructions | 可视化入口 / Visual entry |
|---|---|---|
| Codex | 中文 · English | 支持的桌面端右侧新建标签页 → 更多工具 → Agent Learning / Supported desktop side-panel new tab → More tools → Agent Learning |
| Antigravity | 中文 · English | 项目核心安装后,另登记并启用 App UI 桥 / Register and enable the App UI bridge after the project core |
| DSH | 中文 · English | 安装到实际 profile,目标项目聊天框「📖 知识库」/ Install into your active profile; use its project-scoped 📖 Memory button |
也可下载下方源码 ZIP/tar.gz,或安装 wheel 后通过 python -m agent_learning.cli 导出插件。源码和 wheel 都需在目标机器本地导出,再按宿主接线;已导出的插件包含本机绝对路径,不是可跨机器直接复制的安装包。
Alternatively, download source ZIP/tar.gz below, or install the wheel and export with python -m agent_learning.cli. Export locally before host installation: an exported plugin binds machine-specific interpreter and runtime paths.
核心变化 / Highlights since v1.0.0
- 三宿主接入与可视化控制 / Three hosts and visual controls: DSH 原生事件桥与聊天框按键,Codex 项目侧栏/本地控制台,Antigravity App Sidecar,以及中英双语本机知识库。
- 跨对话工作历史 / Cross-session work history: 公开需求、工作说明、工具结果与文件关联可先检索,无需等待正式知识发布;区分完整、部分和截断输出。
- 结论优先、渐进读取 / Conclusion-first progressive reads: 有界自动上下文、必要条件保留、展示去重、来源风险索引和压缩恢复;需要时再读取正文与证据。
- 按阶段整理与分级发布 / Stage review and tiered publication: 可选管理员按完成阶段及项目 token 预算装批,保存逐项覆盖与审核回执,按所选证据和范围发布。
- 已有项目历史吸收 / Explicit historical ingestion: 用户选择资料并授权独立批次,支持增量来源、覆盖进度与中断续做。
- 可纠错的项目记忆 / Correctable memory: 反例、争议、修订、撤销与后续事件中的来源重查和变化提醒。
- 共库升级体检 / Shared upgrade health checks: 当前项目有效正式知识分批体检,三端共用进度和报告;不调用模型、不自动改写知识。
默认采集和全文检索由本地程序执行,不额外调用生成模型;被注入的资料仍占宿主输入 token。管理员、AI 摘要、语义模型、后台调度、远端服务和更新检查默认关闭,开启需用户选择。
Default capture and full-text retrieval run locally without another generation-model call. Injected material still uses host input tokens. Administrators, AI summaries, semantic models, background scheduling, remote services and update checks start disabled.
升级与兼容 / Upgrade and compatibility
- 版本 1.4.40;数据库 schema/内部发布协议 25;正式知识/工作历史/可选语义索引 6/2/1。
- 使用原宿主、项目、
ALP_HOME与配置执行install --upgrade,随后刷新对应宿主接线与 UI 桥。共库三宿主应一起升级、重载;不要跨宿主覆盖同一导出目录。 - 安装备份不替代外部知识数据库备份;升级前按文档备份知识。已有管理员模型、预算、发布选择和历史权限保留,不自动重跑旧失败。
- Codex 新定义的 Hook 需由用户按宿主提示审阅、信任;插件不能代为信任。Antigravity App UI 需要独立登记并启用,DSH 需要安装到实际使用的 profile。
Version 1.4.40, schema/publication protocol 25, formal/work/optional semantic indexes 6/2/1. Upgrade each existing host export with its original project, data home and configuration, then refresh host wiring/UI registration and reload. Back up the external knowledge database separately. Existing policies and failed-call protections remain intact. Review changed Codex Hooks through the host; register/enable the AG UI bridge separately and use the correct DSH profile.
验证 / Validation
- 发布包从同一固定 Git 提交构建;源码、wheel、sdist 及三宿主资源在隔离目录检查,不使用真实知识数据库或启用真实 Hooks。
- 六个 CI 作业全部通过:Windows/Linux、Python 3.10/3.12,包括离线回归与 wheel 构建;平台条件跳过见日志。
- 真实任务聚合数据及样本范围见中文 README/English README;不将历史单样本比较当作普遍提速或固定 token 节省的证明。
Release packages are built from one pinned Git commit and checked in isolation, without live knowledge databases or live Hooks. All six CI jobs passed across Windows/Linux and Python 3.10/3.12, including regressions and wheel builds; platform-condition skips are reported in the logs. README benchmark observations retain their historical-sample and accounting limits.
下载与校验 / Downloads and checksums
agents-learning-1.4.40-source.zip: 固定提交源码 / Pinned-commit source.agent_learning_plugin-1.4.40.tar.gz: Python 源码分发 / Python source distribution.agent_learning_plugin-1.4.40-py3-none-any.whl: 含三宿主资源的 Python 包 / Python package with all three host resources.SHA256SUMS: 上述附件的 SHA-256 清单 / SHA-256 hashes for the release assets.
1.0.0 · 第一正式版 / First stable release
agents-learning 1.0.0 · 第一版正式版
为 Codex 和 Antigravity 保存有来源的项目经验。两个平台共用一个代码仓库,分别安装和更新。
本版功能
- 自动工作观察:将已有工具事件、公开任务说明与用户纠正投影成可检索工作历史,不要求任务 Agent 另外写复盘。
- 文件历史关联:通过受支持的明确工具字段关联文件;同一 Git checkout 的子目录统一,不同 worktree 分别核对。文件状态变化会提醒,stat 信息不是内容哈希。
- 渐进读取:先返回有限索引,再按需读摘要与分页证据。自动工作索引默认最多 600 字符,与正式知识共享 2400 字符总预算;正式知识和失效通知优先。
- 可选管理员摘要:复用已支持的管理员执行器、平台/模型选择和调用预算,增量去重。摘要标记 model_reported,不晋升或发布正式知识。
- 已有项目历史吸收:用户主动启动文档和受支持对话历史导入,先预览、再确认;取消和来源变化保持独立边界。
- 双平台管理员审核:支持宿主执行器和项目配置,按受支持的当前模型观察或显式模型设置选择执行方案。
自动触发与默认状态
Codex 的受支持前置事件可补充文件历史;Antigravity 将已观察的文件关系用于下一次 PreInvocation。缺前置记录的事件不会补认成当前任务的执行证据。
默认本地 SQLite;管理员模型调用、AI 工作摘要、后台调度、自动发布及远端服务保持关闭。使用这些可选能力需由项目用户分别开启。插件记录可观察事件,不读取模型内部思考。
安装与升级
首次安装:中文安装说明 · English installation。无需模型 API Key 即可使用本地检索和工作索引。
已有安装从本版入口使用 install ... --host codex|antigravity --upgrade,保留原导出备份和外部配置。数据库 schema 升至 15,升级前备份外部数据库,并更新、重载所有访问同一数据库的宿主安装。正式知识 FTS 4、可选语义索引 1 保持不变;工作索引 1,内部发布协议 15。
本页附件提供源码 ZIP、wheel、源码分发包和 SHA256SUMS。导出插件含本机绝对路径,请在目标设备自行导出对应 profile。
验收
- 本机完整隔离回归 1194 项:1191 通过、3 项平台相关跳过,无失败;109 个 Python 文件通过 Python 3.10 语法解析。
- GitHub 四组 CI 全部通过:Windows/Linux × Python 3.10/3.12,每组完整运行 1194 项检查并构建 wheel。Windows 每组跳过 1 项,Linux 每组跳过 2 项。
- 双平台资源、升级、MCP/Hook、预算、分页、文件变化、管理员隔离及迁移保护通过。发布 wheel 的资源与独立包入口烟测通过,源码分发包包含必需资源。
- 发布提交:
26f25ca85383d1cb9e04b99a1c292716e421b910。
离线测试使用临时数据和模拟执行器。本次未启用真实 Hooks、调用真实平台模型或连接真实 Hindsight;真实宿主/模型验收需在用户启用后执行。没有据此宣称已测得 token、时延或任务质量的提升比例。
English
First stable release of shared, local project memory for Codex and Antigravity, with separate installation profiles.
Automatic observable work history, file associations and progressive index/summary/evidence reading extend the existing eight-module architecture. Optional administrator summaries reuse executor selection and shared call budgets; they remain model-reported working records rather than published solutions. Explicit historical ingestion and host-model knowledge review are also included.
Codex can supply file history at supported pre-tool events; Antigravity uses observed file targets at the next PreInvocation. Missing execution attribution remains unknown. SQLite is authoritative; indexes are derived and rebuildable. AI summaries, administrator calls, scheduling, automatic publication and remote services are disabled by default.
Back up the external database and update every installation sharing it before upgrading to schema 15. Download the portable source/wheel and export the chosen profile on the target machine. Offline acceptance does not establish live host/model acceptance or measured token/latency savings.
0.13.0 · 混合检索、知识浏览与安全升级 / Hybrid retrieval, knowledge browsing & safe upgrades
agents-learning 0.13.0
中文介绍与完整架构 · English introduction and architecture · 反馈 / Feedback
中文
让 Codex 在长期项目中复用有依据的经验:普通 Agent 专注任务,插件负责有界检索和事件采集,可选管理员整理候选,受信操作者验证并发布知识。
本公开测试版同时包含此前未单独发布的 0.12.0 能力:
- 语义混合检索:默认使用本地全文检索;可选本地 embedding 与词法召回合并,按修订维护派生索引,语义服务不可用时回退。
- 只读知识浏览器:查看知识、适用条件、来源、修订和管理员状态;仅监听本机,使用访问密钥及 Host/Origin 校验。
- 任务对照评估:冻结任务、模型、环境和知识快照,成对比较无记忆/有记忆运行的验收、耗时和全流程用量。真实执行器需显式配置。
- 覆盖升级安装:校验旧安装清单,保留完整旧目录备份与独立数据,生成新的固定运行副本;切换失败尝试恢复。
- GitHub 版本检查:可手动检查,或显式启用后台检查;读取公开 Release 元数据,使用缓存、ETag、租约和限流退避。检查结果不会自动下载或安装代码。
- Python 3.10 兼容修复:无参数知识浏览接口正常响应,非法非空查询仍严格拒绝。
- 项目入口:更新中英文介绍、完整架构、下载安装链接、CI 徽章和双语反馈模板。
安装与升级
需要 Python 3.10+。下载源码 ZIP 后解压;wheel 可用 pip 安装。请校验 SHA256SUMS。
从源码导出本机插件:
python -B scripts/learning.py install /path/to/agent-learning更新已有导出:
python -B scripts/learning.py install /path/to/agent-learning --upgrade按 README 接入 Codex。升级后重启宿主并重新查看 Hook 信任;已运行的 MCP 进程不会因文件替换自动切换。知识数据库和配置应保存在导出目录之外。
English
Project memory with traceable evidence for Codex. Workers focus on tasks; the plugin retrieves bounded context and records observable events. An optional administrator organizes candidates, and a trusted operator validates and publishes knowledge.
This public prerelease also includes the unreleased 0.12.0 features:
- Hybrid retrieval: default local full-text search plus optional local embeddings, revision-aware derived indexes, and lexical fallback.
- Read-only knowledge browser: inspect knowledge, applicability, sources, revisions and review status through a loopback page protected by an access key and Host/Origin checks.
- Paired task evaluation: freeze tasks, model, environment and knowledge snapshot; compare no-memory/with-memory acceptance, elapsed time and full-workflow usage using an explicitly configured adapter.
- Validated installation upgrades: check the previous manifest, retain a complete backup and separate data, create a new fixed runtime, and attempt restoration if switching fails.
- GitHub release checks: manual or opt-in background checks with caching, ETag, leases and rate-limit backoff. Checks read public metadata; they do not download or install code.
- Python 3.10 compatibility: valid empty-query browser requests work while malformed nonempty queries remain rejected.
- Project entry points: bilingual introduction and architecture, downloads, CI badge and feedback templates.
Requires Python 3.10+. Use the source ZIP or install the portable wheel, verify SHA256SUMS, and follow the README. Export using the current machine's interpreter and paths. Add --upgrade to update an existing export. Restart the host and review Hook trust after an upgrade; keep knowledge and configuration outside the export.
验证 / Validation
最终提交 / Release commit: d8a5d32778bd46fb8d2b1958329a2e819db75ea3。
四组 GitHub Actions 验收 / Four-job CI 全部通过;每组发现 815 项检查,零失败、零错误,wheel 构建通过。
| Platform | Python | Passed | Skipped | Failures |
|---|---|---|---|---|
| Windows | 3.10 | 814 | 1 | 0 |
| Windows | 3.12 | 814 | 1 | 0 |
| Linux | 3.10 | 813 | 2 | 0 |
| Linux | 3.12 | 813 | 2 | 0 |
CI 没有安装可选 Codex CLI,相关原生加载检查跳过;Linux 另外跳过 Windows Hook 命令检查。Each CI job skips optional native Codex loading; Linux also skips the Windows Hook command check.
从该精确提交重新构建的源码 ZIP 和 wheel 完成 10 组实际资产烟测,零失败、零跳过:离线 wheel 安装、导出、覆盖升级与备份、实际 MCP 7 工具、隔离 Windows Hook 的 BOM/中文输入,以及版本/协议一致性。校验文件已独立复核。The exact-commit source ZIP and wheel passed 10 package smoke groups, including actual offline installation, export/upgrade, MCP and isolated Windows Hook entry points. SHA256SUMS was independently verified.
- Version 0.13.0 · SQLite schema 11 · full-text index 4 · optional semantic index 1 · internal release protocol 10.
- 管理员、语义服务、自动版本检查和后台调度默认关闭。Defaults keep administrator execution, semantic retrieval, automatic version checks and scheduling disabled.
- 离线检查与资产烟测不代表真实桌面 Hook 或模型任务验收。Offline and package checks do not establish live desktop Hook or model-task acceptance.
- 目前没有足够的真实任务对照数据证明 token、耗时或质量改善比例。Measured token, latency and quality gains have not yet been established; reproducible task feedback is welcome.
感谢试用与反馈。If this is useful, Star the repository or share the introduction and release.
84 秒演示 / 84-second demo
中文视频 / Chinese MP4 · English MP4 · 中文 SRT · English SRT · DEMO-SHA256SUMS
两版各 84 秒、1080p,附合成旁白与字幕。中文版使用微软“晓晓”在线神经网络女声,英文版使用本机合成语音。演示回放实际本机导出、工具失败与恢复、新会话检索及知识浏览页面;Hook 事件经过隔离运行副本模拟,管理员使用确定性候选样例,知识通过显式受信入口发布。Codex 接入按当前安装指南展示。
Both versions are 84 seconds in 1080p with synthesized narration and captions. Chinese narration uses Microsoft Xiaoxiao online neural speech; English uses local speech synthesis. They replay actual export, tool results, fresh-session retrieval and browser captures. Hook events are simulated in an isolated runtime; administrator review uses a deterministic candidate fixture followed by explicit trusted publication. Codex setup follows the current installation guide.
0.11.1 · 首次公开测试版
agents-learning 0.11.1 · 首次公开测试版
本地优先的 Agent 持续学习插件,整合任务边界、执行守卫、知识存储、检索与上下文、事件采集、管理员治理、知识发布及后台调度八个模块。
本版修复与验收
- 收紧工具名称、重放冲突、路径范围、账户切换、发布及调度的证据与身份边界。
- 改善检索与条件分页、失败恢复关联、业务摘要脱敏和保守用量统计。
- 本机 Windows / Python 3.12.14:649 项离线回归通过,零失败、零错误、零跳过;MIT 打包与入口相关检查另有 35 项通过。
- GitHub Actions:Windows/Linux × Python 3.10/3.12 四组合实际回归及 wheel 构建通过。查看本版 CI。每组发现 649 项:Windows 各跳过 1 项缺少 Codex CLI 的原生加载检查,Linux 各跳过该项和 Windows 专用 Hook 检查(共 2 项)。原生加载检查已在本机隔离 CODEX_HOME 验证。
- 最终源码、wheel 和固定运行副本一致;离线 wheel 安装、CLI、Windows Hook UTF-8/BOM 及 MCP 入口烟测通过。
安装与兼容
- MIT 开源;附件提供源码 ZIP、通用 wheel 和 SHA256SUMS。
- Python 3.10+;保持 schema 11、全文索引 4、内部发布协议 8。
- 下载后按 README 在目标机器重新导出插件;本机导出目录包含绝对路径,不能直接跨机器复用。旧版本不能直接打开 schema 11 数据库,升级前应备份。
- 管理员、后台调度、自动发布及远端服务默认关闭;Hindsight 召回尚未接入 Runtime。
测试版边界
真实桌面 Hook 信任、账户通知自动接线及父子 MCP 连接生命周期仍待宿主验收。离线通过不代表真实模型或 Hindsight 服务已验收;执行守卫只覆盖已接线入口,不提供操作系统沙箱。