OmicsClaw v0.1.7

OmicsClaw v0.1.7

本版本以多模型共识运行时为主线：新增 /interpret 解释层和路由检测器，以及 typed-then-narrative 的共识引擎（ADR 0010/0011/0012），让多个 LLM/解析方案的结果可以被聚合、评估并给出可解读的最终答案。桌面端同步打磨：Windows NSIS 安装器可展开详情面板并把安装日志持久化到 userData，Help 菜单里随时调出；聊天里的图片有了键盘导航的灯箱与防回退保护；本地 Ollama 支持终于能看到真实安装的模型并按工具能力标注（解决 #208）。

新增功能

• 共识运行时 + /interpret 解释层 — 新增 run_typed_consensus 驱动、MemberArtifactReader + TypedConsensusSource 注册表，按 ADR 0010/0011/0012 把多个候选输出汇总为 typed → narrative 两段式结论；CLI 加入 /interpret 快捷命令与路由检测器，可在任意 skill 完成后直接进入解释模式。
• 共识 skill 套件 — 新增 consensus-domains 与 sc-consensus-clustering 两个轻量 skill，把 spatial domains 与单细胞聚类的共识流程封装为可直接调用的入口；附带 DLPFC 151673 hero benchmark 与 self-consistency 回归测试。
• 任务化 metric 面板 — 共识结果展示按当前任务自动选择评估指标，移植 MLAMI / CHAOS / PAS 为空间感知度量，对 spatial domains 之类的任务给出更贴近真实质量的评分。
• Help → "Show installation log" — Windows NSIS 安装器把每次安装的日志快照写到 userData，并在 Help 菜单中提供 "Show installation log" 入口；定位安装异常时无需再手翻 %TEMP%。
• 图片灯箱键盘导航 + SafeImage — 聊天里的图片支持 ← / → 切换、Esc 关闭，并新增 SafeImage 组件替代 Streamdown 默认的破图占位，遇到加载失败时静默隐藏而不是显示"图片加载失败"。
• /api/files/serve 支持 ETag 与 HTTP Range — 静态文件服务返回 ETag 并响应 If-None-Match，同时支持 Range 请求；大文件预览、断点续传与浏览器缓存命中率都更友好。

修复问题

• Ollama 本地模型现在能在 UI 里看到了 (#208) — /providers 端点会真正调用 /api/tags 拉取用户本地 ollama pull 的所有模型，按 30s TTL 缓存；同时剥离 OpenAI-compat 的 /v1 后缀，避免拼出 /v1/api/tags 而 404。每个模型还附带 supports_tools 能力位（gemma4:e4b / qwen3:8b / llama3.1:8b 为 True，deepseek-r1:* / gemma3:* 为 False），前端可据此置灰不可用模型。Gemma 4 现已被识别为支持 function-calling。
• 工具调用失败给出可执行引导 — 选用不支持工具的 Ollama 模型时不再丢出原始 400，而是返回带模型名的友好提示，并列出推荐的可用模型（qwen2.5:7b / qwen3:8b / llama3.1:8b / gemma4:e4b / mistral 等）。
• 聊天里只渲染工具真正产生的图片 — MediaPreview 不再把会话里随便引用到的图片当成产物展示，重复图片自动去重，破图静默隐藏；同时 injectInlineImages 跳过 code block，避免代码示例里的 markdown 图片被误转成实际渲染。
• glob_files 末尾的 ** 现在能正确枚举文件 — pathlib 在结尾的 ** 时不会下钻到文件级，加规则化处理让 trailing ** 行为符合用户直觉。
• L4 取消通过 envelope.cancel_event 正确串联 — CLI 的 ESC / Ctrl+C 处理按 ADR 0009 注入 envelope.cancel_event，长任务能立刻终止而不是等到下一个工具步。
• 共识 SpatialDomainsArtifactReader 读取真实 schema — 不再依赖临时构造的字段，直接读取 spatial-domains skill 落盘的产物 schema，避免共识聚合时遗漏 cluster_id / cell_type 等键。

优化改进

• App 后端入口统一到 omicsclaw.surfaces.desktop.server — Electron 主进程不再分散调用各种历史入口，所有 desktop 流量经由 ADR 0005 定义的 surfaces umbrella 进入，远程执行与本地一致。
• Provider 调用栈瘦身 — 抽出 call_chat_completion 与 resolve_chat_endpoint，去掉 consensus-runtime PR 任务残留，consensus / autoagent / routing 三条 LLM 调用路径共享同一份解析逻辑。
• NSIS 安装器 Details 面板默认展开 — Windows 安装时直接看到每一步进度与日志输出，不用再手动点 "Show details"。
• Console-script 入口防陈旧封装 — oc / omicsclaw 命令行入口加上回归测试，防止历史 wrapper 残留导致 import 错误。
• CI / 发布流程清理 — 桌面安装包发布固定到 TianGzlab/OmicsClaw，dropping softprops 改用原生 gh CLI 跨仓库上传；中间构建产物保留期降到 1 天；pr-ci.yml 内联 bot/requirements.txt（已按 ADR 0004 退役）。
• 文档与架构记录 — 新增 ADR 0010/0011/0012（共识运行时层、评估协议、interpret 层），刷新 2026-05-18 架构快照与 innovation 章节。

下载地址

macOS

• Apple Silicon (M1/M2/M3/M4)
• Intel

Windows

• Windows x64 安装包
• Windows ARM64 安装包

Linux

• x64 AppImage
• x64 .deb
• x64 .rpm
• arm64 AppImage

安装说明

macOS：下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在"系统设置 → 隐私与安全性"里点击"仍要打开"。

Windows：下载 .exe 安装包 → 双击安装。安装器现在默认展开 Details 面板可看到全过程日志；遇到问题装完之后可在 Help → "Show installation log" 找到完整记录。Windows Defender SmartScreen 可能提示"未知发布者"，点"更多信息"→"仍要运行"即可。

Linux：

• AppImage：chmod +x OmicsClaw-0.1.7-x86_64.AppImage && ./OmicsClaw-0.1.7-x86_64.AppImage
• deb：sudo dpkg -i OmicsClaw-0.1.7-amd64.deb
• rpm：sudo rpm -i OmicsClaw-0.1.7-x86_64.rpm

系统要求

• macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
• macOS Intel 和 Windows ARM64 用户额外需要：系统 PATH 里有可用的 Python 3.11+（BYO-Python fallback）
• 需要配置至少一个 LLM API 服务商（DeepSeek / OpenAI / Anthropic / Gemini / OpenRouter / Ollama 等）
• 远程运行时需要可访问的 OmicsClaw app-server 或 SSH 连接配置

v0.1.6 → v0.1.7 升级

无迁移步骤，覆盖安装即可。已有工作区、聊天记录、运行时配置、Provider 设置与本地 memory 数据库均保留。

Ollama 用户值得注意：本版本起 /providers 会在打开 Provider Settings 时自动探测本地已安装的模型，你 ollama pull 过的任何模型（包括 2026-04 发布的 Gemma 4）都会直接出现在下拉里；如果之前因为找不到 gemma3 / gemma4 / 自定义 tag 而手动配过 OMICSCLAW_MODEL，可以选用 UI 下拉里的新条目代替。

---

完整的 commit 列表见 v0.1.6...v0.1.7。

OmicsClaw v0.1.6

OmicsClaw v0.1.6

本版本以 Memory 模块的可观察性与可控性为主线：右侧面板更易读，节点历史可回滚，所有规范域始终可见，写入后界面自动刷新；同时新增对 sc-* skill preflight 警告的结构化展示，让"需要用户确认"的失败不再静默。设置与引导沿着 taste-skill 风格继续抛光，文件树也接入了 git 状态。

新增功能

• Skill preflight 警告卡片 — sc-preprocessing 等单细胞 skill 在 preflight 失败时返回的 USER_GUIDANCE_JSON payload 会被解析为结构化卡片，列出 confirmations / guidance / missing requirements / pending fields，并在 status: needs_user_input 时使用 warning 配色。卡片在工具运行中可实时出现，工具完成后通过 tool_use_id 持久化在快照中。
• Memory 命名空间选择器（admin/debug 视图） — Memory 页面左侧新增 Namespace 下拉，可在桌面默认 scope、admin 全分区视图、或具体 partition 之间切换；用于查看遗留的 launch-id 命名空间或多用户场景下的孤立数据。
• 节点版本链与 rollback 模态框 — 每个记忆节点的右侧面板带历史按钮，可查看版本链并 rollback 到指定旧版本，配合简化后的 payload 更易读。
• 文件树 git 状态装饰 — 项目文件树以颜色与图标实时标注未跟踪 / 修改 / 暂存等 git 状态，无需切到终端就能看到当前工作树情况。
• SVG OmicsClaw logo 资源 — App 与 README 全面切换为高分辨率 SVG logo，跨设备分辨率下保持清晰。

修复问题

• Memory 域选择器始终展示规范域 — 即使当前 namespace 没有任何节点，core / project / dataset / analysis / preference / insight / notes / session 全部规范域仍会显示并提示 0 计数，避免新用户或新 namespace 启动后看到空选择器无从下手。
• 聊天工具变更后 Memory 页面自动刷新 — chat 流中的 remember / forget 等记忆相关工具落库后会触发前端事件，Memory 页面的域计数和节点列表无需手动刷新就保持同步。
• NamespaceSelector 不再抛 Radix invariant — 修复 <Select.Item value="" /> 与 admin 视图哨兵碰撞导致的 React 抛错，使用 UI-only __admin__ 哨兵字符串隔离外部契约。
• Provider 凭证不再被设置页清空 — 重新打开 Provider Settings 后已保存的 API key / 端点等敏感字段会保留，编辑时也不会被新组件状态意外覆盖。
• 自定义 endpoint 诊断更稳健 — 处理超时、TLS、DNS、HTTP 4xx/5xx 等各类失败时给出明确分类信息，便于定位是凭证、端点还是网络问题。
• Electron 启动时 PYTHONPATH 不再被 site-packages 覆盖 — OMICSCLAW_DIR 指向的源码 checkout 会被前置到 PYTHONPATH，本地 Python 后端启动时优先加载开发版本。
• 测试不再读用户主目录 DB — optimize-start-route 单测使用隔离环境，避免污染或读到 ~/.config/omicsclaw/memory.db。

优化改进

• Memory 右侧面板更易读 — analysis 节点上的 UUID 字段（source_dataset_id、parent_analysis_id 等）会显示人性化标签，重复的 memory_id 字段从所有类型节点的右侧面板移除。
• Rollback API payload 简化 + namespace override — /memory/review/rollback 的请求体仅保留必要字段并支持显式 namespace，便于跨 partition 操作。
• Settings General 三卡片布局复位 + 整体抛光 — General 区域恢复到三卡片版式（baseline f85836c），并应用 taste-skill 视觉规范统一字号、间距与分组节奏。
• /jobs 与 /datasets 页面打磨 — 两个工作区页面的列表布局、操作按钮、空状态文案与 General Settings 对齐。
• 首次设置引导 a11y 与节奏抛光 — Setup Wizard 沿用 taste-skill 风格统一组件，键盘焦点顺序、aria 标签、错误反馈更稳定；setup state flow 的过渡逻辑更可预测。
• README 与发布徽章升级 — 切换到高分辨率 SVG 资源，私有发布徽章修复，文档与首屏更清爽。

下载地址

macOS

• Apple Silicon (M1/M2/M3/M4)
• Intel

Windows

• Windows x64 安装包
• Windows ARM64 安装包

Linux

• x64 AppImage
• x64 .deb
• x64 .rpm
• arm64 AppImage

安装说明

macOS：下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在"系统设置 → 隐私与安全性"里点击"仍要打开"。

Windows：下载 .exe 安装包 → 双击安装。Windows Defender SmartScreen 可能提示"未知发布者"，点"更多信息"→"仍要运行"即可。

Linux：

• AppImage：chmod +x OmicsClaw-0.1.6-x86_64.AppImage && ./OmicsClaw-0.1.6-x86_64.AppImage
• deb：sudo dpkg -i OmicsClaw-0.1.6-amd64.deb
• rpm：sudo rpm -i OmicsClaw-0.1.6-x86_64.rpm

系统要求

• macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
• macOS Intel 和 Windows ARM64 用户额外需要：系统 PATH 里有可用的 Python 3.11+（BYO-Python fallback）
• 需要配置至少一个 LLM API 服务商（DeepSeek / OpenAI / Anthropic / Gemini / OpenRouter 等）
• 远程运行时需要可访问的 OmicsClaw app-server 或 SSH 连接配置

v0.1.5 → v0.1.6 升级

无迁移步骤，覆盖安装即可。已有工作区、聊天记录、运行时配置、Provider 设置与本地 memory 数据库均保留。如果之前的 .env 把 OMICSCLAW_MEMORY_DB_URL 设成 sqlite+aiosqlite:///~/.config/omicsclaw/memory.db，请配合最新版 OmicsClaw 后端使用——后端已内置对 ~ 的展开，无需手动修改。

---

完整的 commit 列表见 v0.1.5...v0.1.6。