v0.2.0 — Agent 记忆系统 + 上下文管理升级 + embedding providers

Highlights

• 🧠 Agent 记忆系统:scope 双层(project + user 独立 + 合并召回 + project 优先)
  • /memory 命令族(list / view / edit / delete / promote / promote-scope / trust / search / diff / diagnose)
  • /remember [--user|--project] <text> 用户显式入口(LLM 抽取结构化)
  • trust 三级(trusted / verified / auto)+ scope ×1.2 加权
  • MUSE.md / AGENTS.md 5 层 hierarchy + 子目录惰性加载
  • Compact-promote facts 自动写入 memory
• 📐 上下文管理升级
  • trim-history 用户消息保护(对齐业界共识:user message sacred)
  • 9 节结构化 compaction schema(intent / errors / files / pending / etc.)
  • tool result 自动折叠(同文件 Read 多次只留最新)
  • cache-friendly stage 顺序
• 🔍 向量召回(默认关闭,启用一行配置)
  • 6 个云端 OpenAI 兼容 preset:DashScope / 智谱 / OpenAI 3-small/large / Ollama nomic / Ollama bge-m3
  • 4 个 local-transformers preset(@huggingface/transformers 可选 peerDep):local-bge-zh / local-bge-en / local-minilm / local-bge-m3
  • hash-bag 兜底(零依赖)+ 启动 probe 校验 + /memory diagnose 排查入口
  • 三档降级永不阻塞(启动失败 → hash-bag;运行失败 → 全文模式)
• ✨ /help 升级:按分类分组(Chat / Memory / Configuration / Exit)+ 按键速查表(Esc Esc rewind / Shift+Tab 切模式 / Cmd+V 粘贴等)

Install

npm install -g @qxbyte/muse@0.2.0

Docs

• 完整配置 / 命令参考 / 三套 embedding 启用清单:docs/操作手册.md
• 长期记忆与向量召回简介:README.md § 长期记忆与向量召回

Stats

• 43 测试文件 / 406 测试 / typecheck 干净
• 14 commits since v0.1.3

v0.1.3

✨ New

• AskUserQuestion 工具 + QuestionPicker UI：LLM 可以发起链式选择题（1-4 题），UI 横向 tab bar 切换问题，单选自动跳下一题，多选 Space/Enter 切换勾选，Submit chip 提交全部，Esc 取消整批。仿 Claude Code 链式 tab 设计。

🐛 Bug fixes

• 用户消息走 markdown 渲染：bold / 列表 / 代码块等正常显示
• 用户消息灰底贯通：用 chalk.bgHex 包 ANSI bg 串，告别 ANSI 截断导致的"字体处没背景"
• 修复 marked-terminal 在 list item 里漏渲染 **bold** 的 bug（自己补一刀正则）
• 剥光 marked-terminal 注入的 \x1b[0m 全 reset，避免外层 bg 被踢掉
• 启动时强制 chalk.level >= 1，避免非 TTY 假阳性吞掉所有样式

🎨 UI polish

• 输入框光标：蓝色 + dimColor（替代之前 inverse 反色，柔和不抢戏）
• 输入框 prompt ❯ → ›，与用户消息条带前缀对齐
• 用户消息上下各加一行纯 bg padding，不再贴边

⚡ UX

• 提交后用户消息立即出现在历史里（之前等 onTurnEnd 才出，先 Working 半天才蹦出，体验奇怪）

安装

```bash
npm install -g @qxbyte/muse@0.1.3
```

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

v0.1.2

✨ New

• TodoWrite / WebFetch / MemoryRead / MemoryWrite 四件套：内置工具从 6 个扩到 10 个
• /mode 命令 + Shift+Tab 切换 default / acceptEdits / plan / bypass
• /compact 进度横幅：长任务有 cyan 标签 + 字符进度条 + 轮播 tip
• 流式 / 工具状态行（StatusLine）：spinner + 时长 + ↑token + thought for
• 底栏 FooterStatus：session id · model · ctx 进度条 · 累计 token
• 处理中保留输入框 + 队列模式：模型在跑时继续输入会排队，本轮结束后自动出队
• 终端 tab/window 标题动画（OSC 0/1/2 + braille 旋转）

🎨 UI polish

• 输入框整行背景色 + 闪烁光标（530ms 周期，编辑时常亮）
• 消息行首 ⏺ 圆点，按类型分色
• ctx 进度条按已填 / 未填分色
• 底栏分隔符与 mode 三角紧凑化

🔧 Reliability

• LLM 网络请求加指数退避重试
• 缺失 API key 时给出"缺哪个 env var + 3 种修复方式"的精确报错
• vitest 测试加到 8 文件 44 用例 + GitHub Actions CI
• Write/Edit diff 预览 + 敏感路径硬拦截（/.ssh、/.aws、.env 等）

🔄 Refactor

• models 配置：双文件改为单文件 ~/.muse/models.local.json

安装

npm install -g @qxbyte/muse@0.1.2

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

v0.1.1

改进

文档

• 重写 README，聚焦用户安装与使用：详细化 models.json 字段表、多 provider 完整示例（DeepSeek / Qwen / Moonshot / GLM / OpenAI / Ollama / 自建网关）、凭证安全 3 档建议、常见问题排错
• 清理对标其他 agent 的措辞，强调技术栈本身（TypeScript + Ink + OpenAI 兼容协议）

体验

• 修复 /resume 选中后 loaded 历史被覆盖的 bug（state.history 闭包陷阱 → 改读 messagesRef）
• 修复启动时 settings.json 校验失败 dump 完整 zod JSON 的问题
• 补全后光标跳到 input 末尾（TextInput key bump 触发 remount）
• 补全后 input 末尾不再添加空格，光标紧贴命令名
• SlashAutocomplete: 去掉反色背景条，focused 行整行紫色 + bold
• Banner v13：5 行字母 + Box marginLeft 替代文本空格

维护

• GitHub Actions: actions/checkout / setup-node 升 v5（Node 24 兼容）

安装

```bash
npm install -g @qxbyte/muse
muse --version # 0.1.1
```

完整文档见 README。

v0.1.0

首次公开发布 muse v0.1 MVP。

安装

```bash
npm install -g @qxbyte/muse
muse --version
```

功能

• Claude Code 风格的 agent CLI，Ink TUI
• LLM 后端走 OpenAI 兼容协议，DeepSeek / Qwen / Kimi / MiMo / Ollama 等
• 9 个内置 slash 命令：/help /clear /compact /models /config /mcp /cost /resume /quit
• Slash 自动补全（输入 / 触发，↑↓ 选择，Tab/Enter 接受）
• 内置工具：Read / Write / Edit / Bash / Grep / Glob
• 双文件配置：~/.muse/models.json（模型仓库）+ ~/.muse/settings.json（运行偏好）
• Session JSONL 持久化 + 上下键 selector 恢复历史会话
• 权限模型：三态 allow/ask/deny + 4 档 PermissionMode（Shift+Tab 循环）

详见 README。

已知限制

• MCP 协议接入未实现（v0.3 路线图）
• Skill / Subagent 未实现（v0.2 路线图）
• Anthropic provider 未实现（仅 OpenAI 兼容协议族）