Skip to content

docs: add audited Memmy changelog data - #150

Open
MLittleprince wants to merge 1 commit into
mainfrom
agent/memmy-changelog-data
Open

docs: add audited Memmy changelog data#150
MLittleprince wants to merge 1 commit into
mainfrom
agent/memmy-changelog-data

Conversation

@MLittleprince

@MLittleprince MLittleprince commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

目标

新增 Memmy 官网 Changelog 的结构化双语历史数据。本 PR 只包含 docs/changelog.json,不启用 Webhook、106 Doc Agent 或自动发布。

内容范围

  • v1.0.1–v1.0.4 共 4 个 Published Release
  • 20 条官网摘要:7 条「新功能」、13 条「改进与问题修复」
  • 单一 Release 对象供全部更新、通用、桌面端、Agent、Memory、CLI 六个筛选复用
  • 中英文标题、导语与摘要

Evidence 审计

20 条摘要均已关联正式 GitHub Release、PR/commit、版本文件和关键代码 diff,未发现无事实来源的页面文案。

历史例外(需评审知悉):

因此结论是“20 条均有 Release 事实依据”,而不是“历史版本证据完全一致”。

验证

  • JSON schemaVersion 2
  • 六类摘要计数:20 / 3 / 8 / 11 / 10 / 2
  • Agent 与 Memory 仅共享 5 条,分别有 6 条和 5 条独有内容,保留两个 Tab

合并顺序

这是阶段 A。请先评审/合并本数据 PR,再合并 memmy-web 页面 MR;memmy-agent 页面入口 PR 最后合并。

  • 不自动合并
  • 不触发 production
  • 不启用 Release Webhook 自动链路

@MLittleprince

Copy link
Copy Markdown
Collaborator Author

Memmy Changelog v1.0.1~v1.0.4 历史证据审计

审计时间:2026-08-04
审计对象:memmy-agent/docs/changelog.json 的 20 条官网摘要
结论范围:只判断历史内容能否进入官网;不代表自动化链路、PR/MR 或部署已经完成。

1. 审计口径

每条官网摘要依次核对:

  1. GitHub Release 必须为 Published、非 Draft、非 Prerelease。
  2. Release 的 tag、发布日期、target commit 和安装包资产必须可复核。
  3. 用户事实必须出现在 Release Body,或能由该 tag 区间的代码与测试直接证明。
  4. 记录承载改动的 PR、commit 和具体 diff 文件;不存在 PR 时明确写 N/A,不能编造。
  5. 对根、Desktop、Agent、Memory、Memory CLI 五个版本文件做同 tag 核对。
  6. Release、版本文件、安装包证据冲突时保留事实,但标记历史例外,不能写成“完全一致”。

状态定义:

  • 绿:Published Release、代码/PR/commit、版本文件与资产证据一致。
  • :摘要事实可公开,但存在历史版本或安装包元数据例外。
  • :摘要事实缺乏 Published Release 或代码证据;必须从官网候选中移除。

2. Release 级结论

Release Published / target PR 与 commit 版本文件 安装包证据 结论
v1.0.4 2026-07-30 07:09:50Z;d93ecac #112d93ecac tag 内五处仍为 1.0.3#115 只修正后续 main,不移动 tag、不替换二进制 4 个 1.0.4 签名资产和 SHA256SUMS 均存在 :功能事实可公开;版本一致性不能标绿
v1.0.3 2026-07-24 10:03:11Z;8798c49 #56#593563a0e8798c49 tag 内五处均为 1.0.3 4 个 1.0.3 签名资产和 SHA256SUMS 存在;#59 披露冻结安装包内嵌 Agent/Memory manifest 仍为 1.0.2 :源码一致;安装包内嵌版本有已披露例外
v1.0.2 2026-07-21 17:49:38Z;8a2acdb #24 汇总发布;功能 PR #11/#12/#16/#17/#18/#19 tag 内五处均为 1.0.2 4 个 1.0.2 签名资产和 SHA256SUMS 均存在 绿
v1.0.1 2026-07-17 06:32:42Z;e1b5717 首次根提交,无 PR tag 内分别为 0.1.0、0.0.2、0.0.1-beta.1、0.1.0、0.0.1-beta.1 macOS arm64 和 Windows x64 两个 1.0.1 资产存在;无 checksum 资产 :首次 Release 事实可公开;无 PR 且源码版本未对齐

五个版本文件固定指:

  • package.json
  • App/shell/desktop/package.json
  • App/memmy-agent/package.json
  • Memory/package.json
  • Memory/src/cli/npm/package.json

3. 20 条逐项 source_refs

所有行的 Release 链接均为对应 Published Release;“Diff 文件”是该事实在 tag 区间内的代表性实现或测试,
不是仅凭目录名推断 Surface。

v1.0.4(7 条,Release 级状态:黄)

共同证据:

Item ID Release Body 对应事实 代表性 Diff 文件 结论
v1.0.4-project-workspaces project-scoped desktop workspaces;项目绑定工作目录与文件访问 App/frontend/desktop/src/pages/app-frame.tsxApp/memmy-agent/src/entrypoints/frontend-bridge/projects.tsApp/memmy-agent/tests/core/agent-runtime/loop-session-workspace.test.ts 摘要可公开;黄继承自版本文件
v1.0.4-browser-automation built-in browser automation;expanded ui-craft Skill App/memmy-agent/src/core/agent-runtime/tools/browser.tsbrowser-preview.tsbrowser-setup.tssrc/skills/ui-craft/SKILL.md;对应测试 摘要可公开;黄继承自版本文件
v1.0.4-agent-memory-onboarding on-demand Agent Memory onboarding、initial import、incremental sync App/memmy-agent/src/skills/agent-memory-onboarding/SKILL.mdsrc/core/agent-runtime/tools/agent-source.tsApp/backend/src/services/agent-source-service.ts 摘要可公开;黄继承自版本文件
v1.0.4-runtime-cleanup cancel/timeout 清理 descendant process tree App/memmy-agent/src/core/agent-runtime/tools/exec-session.tstests/core/agent-runtime/task-cancel.test.tsexec-session-tools.test.ts 摘要收窄为命令清理,Surface 为 Agent + CLI;浏览器空闲清理保留在完整 Release,避免 CLI Tab 出现浏览器内容
v1.0.4-memory-reliability reusable subgoals、failure-avoidance、Span memories、completed turns searchable sooner、diagnostics Memory/src/service/evolution/big-turn-span-pipeline.tsnegative-experience-pipeline.tssession/session-turn-service.ts;对应测试 摘要可公开;黄继承自版本文件
v1.0.4-workspace-migration first-start one-time workspace migration;保留 messages、titles、pins、archives Migrations/src/migrations/v1.0.4/0001-add-webui-session-binding.tsMigrations/tests/0001-add-webui-session-binding.test.ts 摘要可公开;升级说明已留在第二类
v1.0.4-consistent-memory-export consistent SQLite snapshot includes committed WAL data App/frontend/desktop/src/pages/memory-sources-page.tsxApp/shell/desktop/src/main/sqlite-backup.tsApp/shell/desktop/tests/sqlite-backup.test.ts 摘要可公开;真实入口为 Desktop 的 Memory 数据页,Surface 修正为 Desktop + Memory,不标 CLI

v1.0.3(6 条,Release 级状态:黄)

共同证据:

Item ID Release Body 对应事实 代表性 Diff 文件 结论
v1.0.3-file-memory-control fileMemory.enabled 独立控制 file memory、Recent History、Dream App/memmy-agent/src/config/schema.tsconfig/loader.tstemplates/agent/file-memory.md;配置与 Dream 测试 摘要可公开
v1.0.3-output-validation Agent 写入后做 targeted format/syntax validation App/memmy-agent/src/core/agent-runtime/tools/file-lint.tstools/apply-patch.tstemplates/agent/verification-contract.md;对应测试 摘要可公开
v1.0.3-desktop-reliability 保留登录/BYOK;配额状态、任务切换、Markdown 展示改进 App/backend/src/infrastructure/app-state-store/legacy-state-migration.tstoken-quota-service.tsApp/frontend/desktop/src/pages/home-page.tsxmemory/memory-markdown.tsxpet-page.tsx 摘要是同一 Release 的桌面结果压缩,不新增事实
v1.0.3-agent-recovery Gateway recovery/longer replies;malformed JSONL skip App/frontend/desktop/src/app/agent-runtime-bridge.tsxapi/memmy-agent-client.tsApp/backend/src/adapters/outbound/agent-source/jsonl-lines.ts;对应测试 摘要可公开
v1.0.3-memory-pipeline import、embedding、retrieval、summary、evolution 的 retry/fallback/routing/diagnostics Memory/src/service/import/memory-import-pipeline.tsembedding/embedding-pipeline.tsretrieval/retrieval-service.tsevolution/*worker/*Memory/src/model/* 摘要可公开
v1.0.3-compatibility file memory 默认关闭;legacy built-in my tool 与配置移除 App/memmy-agent/src/config/schema.ts;删除 src/skills/my/**tools/self.tstools/runtime-state.ts;相关测试 摘要可公开;不兼容信息已并入第二类

v1.0.2(5 条,Release 级状态:绿)

共同证据:

  • Release:v1.0.2
  • Release 汇总 PR:#24;tag commit 8a2acdb
  • Release Note:.github/release-notes/v1.0.2.md
  • 版本文件:tag 内五处均为 1.0.2。
Item ID PR / commit 代表性 Diff 文件 结论
v1.0.2-jump-to-latest #119374901 App/frontend/desktop/src/pages/home-page.tsxtests/home-page-scroll.interaction.test.tsxstyles.css 绿
v1.0.2-resumable-sync #16dd23e0fe2adf5c App/backend/src/services/agent-source-service.tsagent-source-scan-journal/**0004-agent-source-conversation-checkpoints.sql;对应测试 绿
v1.0.2-memory-diagnostics #18 的累计分支;5b0de4856b6fec Memory/src/service/memory-service.tsMemory/src/model/http.tsApp/frontend/desktop/src/pages/memory/memories-sub-page.tsx;对应测试 绿;PR 标题不能单独代表内容,commit 与 diff 才是事实
v1.0.2-desktop-update-reliability #12#17#192e4d279a8d287a19d7087 App/frontend/desktop/src/app/update-coordinator.tsxApp/shell/desktop/src/main/main.tsruntime-services.ts;对应测试 绿
v1.0.2-compatibility #24dd23e0f70ff548 Memory/src/storage/db.tsMemory/src/storage/schema.tsMemory/src/cli/commands.tsscripts/sync-project-version.mjs;迁移与版本测试 绿

v1.0.1(2 条,Release 级状态:黄)

共同证据:

  • Release:v1.0.1
  • commit:e1b5717
  • PR:N/A,这是仓库首次根提交;不得伪造 PR。
  • 版本文件:没有任何一处为 1.0.1;Release 资产名称和 Published Release 是对外版本证据。
Item ID Release Body / 资产证据 代表性 Diff 文件 结论
v1.0.1-desktop-installers Release 提供 macOS Apple Silicon 与 Windows x64 资产;API 实际文件为 Memmy-1.0.1-darwin-arm64.dmgMemmy-1.0.1-win32-x64.exe 根提交中的 App/shell/desktop/electron-builder*.ymlscripts/internal/package-mac-arm64-*.shpackage-win-x64.sh 摘要可公开;版本文件例外必须保留
v1.0.1-installation-guidance Release Installation 明确说明 macOS “Open Anyway” 与 Windows SmartScreen “Run anyway” 这是 Release 文档事实,不存在独立代码 PR;根提交仅证明安装器工程存在 摘要改为“补充/Added”,不再声称相对旧版本“改进”;黄

4. 安装包 checksum 证据

v1.0.2v1.0.3v1.0.4 的 GitHub Release 均附带 SHA256SUMS.txt,且分别列出四个
CN/Intl、macOS arm64/Windows x64 签名安装包。审计只读取 checksum 文本和 GitHub API 资产元数据,
未下载数百 MB 的二进制,也没有据此声称已完成二进制内部验签。

v1.0.1 只有两个安装包,没有 checksum 资产;不能补写不存在的 checksum。

5. 产品验收结论

  • 20 条摘要均有 Published Release 事实来源,0 条红色内容
  • v1.0.2 的 5 条为完整绿色证据。
  • v1.0.3 的 6 条内容可公开,但必须保留冻结安装包内嵌版本例外。
  • v1.0.4 的 7 条内容可公开,但 tag 内版本文件仍为 1.0.3;chore(release): add v1.0.4 notes and align versions #115 不能倒推成 tag 已修复。
  • v1.0.1 的 2 条内容可公开,但无 PR、源码版本未对齐且无 checksum。
  • 页面可以继续进入 Draft PR/MR 评审;PR/MR 描述必须链接本审计并披露三组历史例外,不能写“20 条全部
    满足 Release、PR、commit、版本文件和安装包完全一致”。

6. 后续自动化门禁

未来新版本不允许复制历史例外。进入 Draft Release 前必须同时满足:

  1. 所有 release-relevant version files 与候选 tag 一致。
  2. 每个公开 Item 至少有 Published Release 候选正文、PR/commit 和具体 diff path。
  3. 安装包资产名称、内部版本、MD5/SHA256 与候选版本一致。
  4. 无 PR 的紧急变更必须记录批准人和原因;LLM 不得补造 PR。
  5. 任一证据冲突时只生成 inspection artifact,不创建可 Publish 的 Draft Release。

@MLittleprince
MLittleprince marked this pull request as ready for review August 5, 2026 08:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant