Skip to content

docs: capture the v0.5.32 gallery again with an embedding service - #429

Merged
Grivn merged 4 commits into
mainfrom
claude/webui-gallery-embedding
Oct 17, 2026
Merged

Grivn merged 4 commits into
mainfrom
claude/webui-gallery-embedding

Conversation

@Grivn

@Grivn Grivn commented Oct 17, 2026

Copy link
Copy Markdown
Collaborator

摘要 / Summary

#424 合并的 v0.5.32 图集是在本机没有嵌入服务时截取的,存入记忆的回执末尾都带着一行"未生成向量",维护者认为这会让读者误以为出错。本次在本机运行嵌入服务后重新截取:官方 Ollama 命令行 0.40.6 在 Mnemon 默认地址提供 nomic-embed-text(Mnemon 的默认嵌入模型),DSH 的嵌入设置保持默认,与装了本地 Ollama 的默认安装一致。每次保存都生成了向量,回执中不再有这一行;文件名不变,文档中的说明与配图文字随之更新。计划第 12–18 项的证据改为指向截图或录像本身,不再引用第一次截取的时间与数字。

The v0.5.32 gallery merged in #424 was captured with no embedding service running, so every save receipt ended with "Saved without a vector", which the maintainer judged misleading. This captures it again with an embedding service: the official Ollama CLI 0.40.6 serving nomic-embed-text, Mnemon's default model, at Mnemon's default endpoint, with the DSH embedding settings at their default, as on a default install with a local Ollama. Every save got a vector and no receipt shows the line; files keep their names and the documentation's sentences and alt texts follow the new shots. Plan items 12-18 now point at the screens and recordings instead of quoting the first capture's times and counts.

关联 Issue 或背景 / Related Issue or Context

Follows #424 (the v0.5.32 gallery) and #427 (the neutral note for a save without a vector, plan item 12), at the maintainer's request after reviewing #424's save receipt.

涉及区域 / Affected Areas

  • Host 激活、Headless 或 bundle / Host activation, Headless, or bundle
  • 运行时记忆 / Runtime Memory
  • 项目档案 / Project Documents
  • 记忆空间或 Provider / Memory Spaces or Providers
  • 子 Agent 或 Agent 工作流 / Subagent or Agent workflow
  • Web UI 或对话交互 / Web UI or conversation interaction
  • 设置、存储或安全 / Settings, storage, or security
  • CLI、RPC、命令或工具 / CLI, RPC, commands, or tools
  • 安装、更新或发布 / Installation, update, or release
  • 测试、构建或文档 / Tests, build, or documentation
  • 其他(请说明)/ Other (explain below)

PR 类型 / PR Type

  • 面向用户的功能或行为变更 / User-facing feature or behavior change
  • Bug 修复 / Bug fix
  • 增强或优化 / Enhancement or optimization
  • 兼容性适配 / Compatibility change
  • 维护或重构 / Maintenance or refactor
  • 测试或构建 / Tests or build

变更内容 / Changes

最新代码确认 / Latest Codebase Confirmation

  • 我已基于最新 main 分支开发,或在提交前已 rebase 或合并最新 main。 / I developed from the latest main, or rebased or merged the latest main before submitting.

同步命令 / Sync command:

git fetch origin main
git merge origin/main

Captured on bd70979f; the branch started from 6724ccde (#427) and merged 44a3cfc8 (#428) in 6331c13a.

AI 编码披露 / AI Coding Disclosure

  • 完全 AI 编码:全部编程改动由 AI 产出,并由贡献者接受和审查。 / Fully AI-coded: AI produced all programming changes, which the contributor accepted and reviewed.
  • 部分 AI 辅助:AI 帮助编写或修改了部分内容。 / Partially AI-assisted: AI helped write or modify part of the change.
  • 未使用 AI 编码辅助。 / No AI coding assistance was used.

使用的 AI 模型 / AI model used: Claude Opus 5.5 (claude-opus-5-5)

使用的编码 Agent 工具 / Coding Agent tool used: Claude Code

仓库规范检查 / Repository Rules

  • 未修改 DSH 官方源码,未让 tsconfig 指向 DSH 源码 checkout,仅使用正式的 @deepseek-ai/* NPM 契约。 / I did not modify DSH source or point tsconfig at a DSH source checkout, and used only published @deepseek-ai/* NPM contracts.
  • Client 与 Host 边界仍以浏览器安全的 src/host/protocol.ts 为准,没有在两侧重复定义 wire DTO。 / The Client and Host boundary still uses browser-safe src/host/protocol.ts as the source for wire DTOs.
  • 持久化格式、RPC 权限、路径或凭据处理的变更包含兼容或拒绝路径、安全分析和相应测试。 / Changes to persistence formats, RPC authority, paths, or credentials include compatibility or rejection paths, security analysis, and tests.
  • 没有提交 token、密钥、私有记忆、未脱敏日志或生成的 lib/ 文件。 / I did not commit tokens, credentials, private memory, unredacted logs, or generated lib/ files.
  • 用户可见文案和长期文档已同步维护中文与英文版本,命令、配置键和路径保持一致。 / User-facing copy and long-lived documentation are synchronized in Chinese and English, with matching commands, configuration keys, and paths.
  • 会改变发布制品或其元数据的 PR 已添加 changeset;仅测试、CI 或站点文档变更可不添加。 / A PR that changes a published artifact or its metadata includes a changeset; test-only, CI-only, and site-documentation-only changes may omit one.
  • 新增和修改的代码、注释、文档、提交信息不含 emoji。 / New and modified code, comments, documentation, and commits contain no emoji.

兼容性与数据安全 / Compatibility and Data Safety

Documentation and media only; no code. The DeepSeek key reached the fixture process only through its environment and appears in no file, log or image; the embedding service ran locally on 127.0.0.1 from the official release tarball (checksum matched the release digest) and was stopped after the capture. A secrets scan of the diff and strings on all 74 media files find no key, token, home path or email; the only path on screen is the fixture's temporary directory.

本地验证 / Local Validation

执行的命令 / Commands run:

ollama serve                                               # official CLI 0.40.6, nomic-embed-text at 127.0.0.1:11434
node scripts/serve-e2e.mjs --docs-demo --live-model         # Chinese, DEEPSEEK_API_KEY from the environment
node scripts/serve-e2e.mjs --docs-demo=en --live-model      # English
mnemon embed --status                                       # per fixture store, after each pass
pnpm run verify:docs
pnpm exec vitest run tests/docs.spec.mjs tests/package-locales.spec.mjs tests/changesets.spec.mjs

结果摘要 / Result summary:

  • After each pass, mnemon embed --status showed 100% coverage on all three fixture stores, the saved memory included; the receipts end with "View in Memory Spaces" / 在记忆空间中查看 and no vector line. The first pass in each language was kept; both Agent answers cite the September 12 incident (five memories in English, four in Chinese); no console errors.
  • verify:docs passes (4,899 links, 368 anchors); docs, locale and changeset specs pass (39 tests); release:intent passes.
  • An independent review viewed every changed screen and storyboards of all recordings in both languages, checked the alt texts, the manifest's 74 entries and that fix: word a save without a vector as information when DSH sets up no embedding service #427's text is intact, and found nothing must-fix; its should-fix (plan items 12-18 quoting the first capture's figures) is fixed in af75b4f3.

用户可见变更证据 / Local Feature Evidence

证据 / Evidence: the gallery itself; the record lists the embedding setup, the takes and the checks.

🤖 Generated with Claude Code

Grivn and others added 4 commits October 18, 2026 02:02
The first capture ran without an embedding service, so every save to a
Memory Space ended with "Saved without a vector", a line a default
install with a local Ollama never shows. Capture it again with Ollama
0.40.6 serving nomic-embed-text at Mnemon's default endpoint and the
Mnemon Native embedding settings at their default, so every memory,
seeded or saved, has a vector and no receipt carries the line.

- Replace the media under the same names, from one live pass per
  language on bd70979; the first take of each is kept. The limits
  screen comes from a fresh fixture again, and the Chinese graph screen
  was taken again on its pass's fixture, framed so the graph's header
  row is not cut off. 74 files, 23.1 MB.
- Regenerate the manifest (date, revision, an embedding field, the
  retaken screen) and the gallery README (embedding row and paragraph,
  no notes about missing vectors).
- Remove the READMEs' sentence on the vector line and the UI guide's
  note that no embedding service ran.
- Update the alt texts the new takes change: the English answer read
  working memory and Project Documents, the Chinese one also Memory
  Spaces; the English correction also updated a document; no receipt
  has a vector line.
- Name the embedding service in the gallery's changeset.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A short bilingual record of why the v0.5.32 gallery was captured again,
the embedding setup (Ollama 0.40.6 with nomic-embed-text at Mnemon's
default endpoint, the DSH embedding settings at their default, 100%
vector coverage after each pass), the revision the capture ran on
(bd70979, then main 6724ccd merged, which changes only the no-vector
line), the takes kept, what the documentation changed, and the checks.
It joins the top of the records index.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Brings in #428. The records index conflicted on its top row: both rows
are kept, this branch's gallery record first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The recapture made the evidence in items 12 to 18 of the October review
plan stale: they quoted clock times, recording seconds and counts from
the first capture (9:49 PM, 9.9 s, 10.0 s / 13.5 s, "26 active
entities", "11 m... 138... 17...") that the new gallery no longer shows.

- Name the screen or recording that shows each behavior instead, and
  say so where an item still quotes the first capture (item 12's
  receipts, item 14's cut-off summary), linking its record.
- Point the file references at main 44a3cfc, after the client and
  Host module splits: memory-graph.tsx, overview-page.tsx,
  use-source-catalog.ts and the moved MnemonWorkbench.tsx and
  service.ts lines; item 12, done before the splits, keeps 03dd40a.
- Drop the same figures from the roadmap entries in both languages.
- Update the gallery record to say so, with the new link count.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Grivn
Grivn merged commit 21c36d8 into main Oct 17, 2026
7 checks passed
@Grivn
Grivn deleted the claude/webui-gallery-embedding branch October 18, 2026 16:28
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