MuLi 是面向个人电脑的常驻助手：聊天、管理文件、搜索资料、记忆偏好、接收任务，以及让多个 agent 分工和复核。主要适配 Arch Linux 和其他 Linux；网页与核心服务支持 macOS / Windows，桌面操作和用户服务的能力按平台显示。
角色形象是十八岁的少女，定位为数字生命与本地助手，不设定恋爱关系。青瓷蓝工作台将对话放在中心，执行轨迹、审批和设置按需展开。
能力
| 领域 | 当前实现 |
|---|---|
| 模型 | OpenAI Chat Completions、Responses、Anthropic 原生协议；流式/非流式、推理参数、工具回放、重试预算 |
| 协作 | 持续主身份、动态 spawn/send/wait/resume/stop 团队、显式附件交接与补充、可跨重启的增量结果游标、依赖工作流；历史成员无固定上限，执行有资源预算 |
| 权限 | ask 每个工具调用询问；auto 独立审查 agent，风险操作交给用户；yolo 自动执行 |
| 文件 | 目录、读取、写入、精确编辑、搜索、复制、移动、可恢复回收站；附件元数据检索与有界分页 |
| 搜索 | SearXNG / Brave / Tavily 可配服务，有限大小网页读取与来源链接 |
| 记忆 | 分层原文与后台提炼、关键词/embedding/关系图混合检索、reranker、多来源别名与实际召回路径、相关资料与侧写共同注入、原文分页核查、冲突修订、来源级忘记 |
| 电脑 | Linux AT-SPI 应用/窗口定位与节点操作；实验性 macOS AX 前台应用及原生引用；Windows UIA 顶层窗口/选定树、普通按钮一次 Invoke（Windows CI 自有按钮验收已通过，真实用户桌面未验）；可选有界截图、录屏与统一附件引用 |
| 渠道 | 可选 OneBot/NapCat、Telegram、QQ 官方机器人和微信 iLink；同一主身份、Team / Workflow 后台报告保留原渠道、失效目的地持久阻塞与本地文件收发 |
| 语音 | 独立默认关闭的网页录音转写草稿、本地中文声学唤醒与声纹桥接、录音参考、OpenAI 兼容 ASR/TTS、完整转写留存与续读；不附带本地模型 |
| 主动事件 | chiliarch 原生配对与 SSE 任务、默认关闭的普通消息资料提醒；Linux 指定目录的内核资料到达事件；持久提醒、维护结果与新版通知进入主会话，独立事项可按默认或显式记忆绑定通知，可选 Linux 桌面通知，无 AI 轮询 |
| 扩展 | Agent Skills 渐进读取与文档热发布、运行期间换代的可选 MCP 工具、按需文本资源与搜索结果链接原文读取、显式资源及工具图片附件保存与文本模板、用户目录 Python 插件；工具、提示词、模型、路由和生命周期可扩展 |
| 长任务 | 完整标题目录与已保存正文分页续读、后台分层压缩、协议回放、持久收件队列、完整任务说明、明确暂停与补充要求后的重新规划 |
| 管理 | 模型、权限、工具、目录、记忆、工作流、通知、服务状态与日志统一入口；self_logs 读取自身日志，self_events 分页回查保留错误，self_failure 按运行定位故障；活动工作流独立分页与逐次停止 |
已发行的 v2.44 为自动记忆提示增加冲突证据组合：预算允许时一起提供有限双方，放不下则保留待核查提示，不只交付某一方正文。它复用已有来源、冲突和修订，不自动选择赢家；发行闭合、离线定向结果和未验边界见审查记录，不代表自然模型判断质量已验收。
启动
已发行的 v2.55 支持“让截图队友把 MCP 返回的图片交给沐璃看”：队友显式保存后用原附件交接，主助手再调用视觉工具；主模型可看图时使用主模型，否则使用已配置的外挂视觉模型。两种配置均已通过实际图像字节和摘要核对，远端发行和两包核对已闭合，见MCP图片用法及发行记录。
v2.56候选支持“把这次看图的解释存下来，以后直接查”：显式存档提问、完整说明、实际模型与原图版本；压缩或正常重开后沿附件检索和分页回查，无需再次看图。真实离线旅程已验证私聊7存档、压缩重开后由当前私聊8完整回查并只向8回复，Web同时可见；解释仍是历史模型判断，不成为主人事实或授权。314项本地验证、独立后审与离线包检查已通过，精确远端候选与发行仍待，见视觉存档与候选审查。
需要 Python 3.12+ 和 uv。前端无需安装 Node 依赖或构建。默认运行不依赖 Docker、向量数据库或本地模型。
uv tool install muli-agent
MuLi init
发行名称是 muli-agent，命令为 MuLi 或 muli。init 会询问称呼、主模型完整参数、视觉能力、监听地址和密码，然后安装当前用户的后台服务、启用登录启动并请求启动。可用 --no-service 跳过；--defaults 只创建默认配置。服务不可用时保留配置并给出 MuLi serve 前台启动方式。工作台默认 **http://127.0.0.1:8765**，沐璃会逐步协助配置其它能力。独立审查使用无工具上下文；工作、压缩和记忆提炼模型未单独配置时复用主模型。API key 可从环境变量读取。
默认所有内容集中在 ~/MuLi：config.json、data/、plugins/、prompts/、logs/ 和可选只读源码参考 source/。MULI_HOME 设置根目录，MULI_CONFIG / MULI_DATA_DIR 或 CLI --config / --data-dir 可单独覆盖。初始化不覆盖已有配置；旧路径不会被自动搬走。密钥不出现在配置读取 API；配置文件和数据库使用私人文件权限。
MuLi --config /path/config.json --data-dir /path/data serve --port 8766
MuLi doctor
模型连接尚未配置时，界面可用于管理，不会伪装产生模型回答。独立审查未配置或失败时，auto 转为人工审批。
QQ 官方机器人和微信 iLink 使用可选加密依赖：uv tool install 'muli-agent[channels]'；同时需要 MCP 时使用 uv tool install 'muli-agent[mcp,channels]'。默认安装不包含本地语音或 GPU 模型；平台接入方式见渠道说明。
没有发令会话的主动通知默认留 WebUI，可在“消息渠道 → 主动通知”一次设置外部默认。启动自主更新检查、扩展目录自主 watch 的新失败状态、MCP 当前 HTTP/SSE 连接首次接收失败可使用该默认；主会话当前请求失败和新任务提醒保存原请求来源，旧记录及其它日志留本地。MCP 故障不自动重连或重放；默认更改只影响新事项，撤销后的待发项 blocked，unknown 不自动重试。见默认通知的配置与边界。
目标复盘支持对已有目标说：“周末提醒我复盘这个错题目标，看看已有依据、未验事项和下一步。”启用 Attention 并订阅 reminder 后，到期只读最新任务要求与交付验收单，沿创建约定的原私聊回复，Web 同时可见；不自动执行任务或发送文件。对应 v2.49 已完成正式发行与两处资产元数据核对，未联调真实账号；使用方法见目标复盘，验证范围见审查记录。
v2.57 开发候选增加独立的定时委托：“明早开始搜索这个主题，以后每周整理，经队友执行和独立评审后把文字成果发回这里。”它保存原私聊/Web 来源和当前权限上限，与普通提醒的只读复盘分开；通过取消委托撤销，不借用选中任务的授权或暂停状态。ask/auto 审批、重开不重做及 unknown 不重发规则仍保留，进程停机不会被唤醒。正式离线私聊旅程已通过，真实平台与自然模型效果未验；见用法与边界及实施状态。
已发行的 v2.54 支持直接说“把这个提醒改到今晚，仍在原来的私聊提醒”：主助手读取准确提醒 ID 后，用 reminder_reschedule 原地改期并重新启用，保留原目标绑定、渠道和历史次数。普通提醒与目标复盘均可改期；任务复盘可撤销尚未最终接纳的旧通知，普通已产生通知或已开始的复盘不承诺追回。两条完整离线旅程、独立审查、249项本地验证及精确远端发行、两包核对已闭合，见改期用法及发行记录。
v2.50 可继续回答：“要求变了，这份成果还能用在哪、还需补什么？”沐璃按准确旧验收单对照登记时和当前的完整要求，保留限制的顺序和重复，将文字变化、登记时文件事实与历史模型判断分开，再给出明确标为模型判断的复用和补做建议。只读复核不验收新要求、不重派或外发；精确发行 CI 与 GitHub/PyPI 构件核对已闭合。见读取方法、发行审查。
v2.51 已发行，支持“搜索后读原文”：已配置 MCP 搜索若返回协议资源链接，队友可显式展示这次结果的链接，再沿原连接读取完整短文本，即使普通资源目录为空。正文仍是不可信外部资料，不自动保存或发送文件；本地旅程、484项回归、独立后审与离线发布验证通过，发行流水线和GitHub/PyPI构件核对已闭合。使用方法见MCP 用法，远端可选测试的覆盖边界见发行审查。
v2.52 已发行，可对队友说：“先核查资料，有阶段成果或需要澄清时先告诉我。”直接队友在执行中交给主助手协调，问题沿原任务私聊回复，另一私聊不会抢走这条来源。正常关闭重开后，主人明确回答可续作同一持久队友，原unknown投递不自动重发。两条正式离线旅程、五项边界负控、候选CI十项和发行十三项均通过，GitHub/PyPI两构件大小及SHA已核对；未联调真实账号或自然模型效果。见用法与发行证据。
已发行的 v2.53.0 支持在私聊明确说：“把刚才队友的草稿文件发到这里。”主助手选择已有附件，宿主沿本轮真实私聊来源发送，不让模型重填收件人；原审批、附件检查和未知结果不自动重发规则保持。Web、无来源和群聊不选择默认私聊。两条正式旅程与五项独立负控已本地通过，含 unknown 后正常重开及原信封重投不新增运行或出站；unknown 无法判断平台是否已收到文件。精确远端 CI、正式发行与两包元数据核对已闭合，真实账号和自然模型效果未验，见用法与边界及发行记录。
后台服务
MuLi service print
MuLi service install
MuLi service enable
MuLi service start
MuLi service status
journalctl --user -u muli.service -f
也可在工作台的系统设置中安装、启动、停止、重启和启用登录启动。服务属于当前用户，不需要 root；内存、CPU 和进程数有 systemd 上限。配置修改后重启服务才能应用监听端口变化。
Linux 本地候选托管切换提供 self_adopt、self_switch 和 self_recover，保留最新数据库与原汇报来源；使用条件、验收状态和边界见托管切换说明。
已托管的 Linux 安装可配置本地 wheelhouse，通过 self_update_preview 核验候选
来源，再经真实用户批准执行 self_update。准备进程有资源预算与持久恢复记录，
中断后由 self_recover 收尾；策略默认关闭，不自动下载依赖。另可启用独立在线策略，
预览精确版本并批准完整构件事实后，在预算内获取一枚 MuLi wheel，再走同一离线准备；
依赖仍需本地 wheelhouse，缺失时保留旧安装。配置、使用顺序及
尚未实测的真实系统恢复边界见候选更新说明。
Linux 使用 systemd 用户服务；macOS 使用 LaunchAgent；Windows 使用当前用户计划任务及 pythonw.exe，不弹出命令窗口。它们通常随用户登录启动。Linux 退出登录后仍需运行时，可按系统策略启用 user lingering；MuLi 不更改系统登录策略。桌面权限与实际平台验证范围见平台能力。
权限与资源
所有模型发起的工具调用经过同一个权限门，子 agent 继承模式，不得自行提升。工作目录列表是文件工具的访问范围；yolo 也不会取消配置的预算和工具禁用状态。shell 与桌面操作具有当前用户能力，auto 会交给用户确认；路径范围不是操作系统沙箱。
文件操作默认限于用户主目录，可在设置里修改。文件读取/写入、网页下载、命令输出、工作流节点与并行数均有上限。删除使用回收站，跨文件系统回收拒绝隐式复制大目录。重启后未完成任务标为中断，不盲目重复可能已有副作用的操作。
进一步阅读
- 架构与执行边界
- 模型协议与参数
- 多 agent 工作流
- 把文件、语音和图片交给队友
- 工作流结果回原渠道
- 任务暂停、补充要求与重新规划
- 核查长期任务、报告与记忆依据
- 按最新证据接办队友任务（开发中）
- 上下文与长任务
- 个人记忆设计
- MCP 扩展
- Agent Skills
- 用户插件与自身管理
- Linux 同版本恢复入口
- 新资料库格式准入
- 压缩后的证据续读
- 查找全部运行记录
- 查看已保存的正文
- PyPI 与发布流程
- 桌面通知
- 系统注意事项与主会话唤醒
- Linux 资料收件目录
- 系统日志事件与通知级别
- 按运行查询故障位置
- chiliarch 接入
- 可选通讯渠道与本地文件收发
- 微信语音文字与原始录音
- 跨平台服务、截图和录屏
- 应用、窗口与无障碍操作
- 中文唤醒与声纹桥接
- 完整语音转写与续读
- 附件检索与分页
- 工作台交互
- 事件订阅与恢复位置
- 会话恢复与当前执行
- 开发验证与资源保护
- 配置、迁移与运维
- 迭代记录
- 版本变更
开发与验证
git clone https://github.com/69gg/MuLi.git
cd MuLi
uv sync --locked
uv run MuLi init --no-source --no-service
uv run MuLi serve
# Linux 本地验证：先核验 cgroup 限制，再执行；复用已安装依赖，默认离线
python scripts/check_local.py backend .venv/bin/python
python scripts/check_local.py run -- .venv/bin/ruff check .
python scripts/check_local.py run -- .venv/bin/ruff format --check .
python scripts/check_local.py run -- .venv/bin/mypy
python scripts/check_local.py frontend
python scripts/check_local.py run -- uv build --offline
python scripts/check_local.py run -- .venv/bin/python scripts/check_wheel.py
本地检查入口覆盖子进程，并在执行前核验内核实际限额：单次 1 GiB、所有 worktree 合计 2 GiB、swap 0、共享一个逻辑 CPU 的等效时间预算、128 个任务、每次最长 180 秒。前端文件单并发，Node 堆另限 256 MiB；超时或局部 OOM 回收整组任务。没有 systemd 用户服务或 cgroup v2 时拒绝执行，不降级为无保护运行。使用方式和边界见开发验证。
测试使用临时目录、模拟 HTTP/SSE 与假模型，不使用真实模型额度、不点击真实桌面。托管 CI 在 Linux、macOS、Windows 与 Python 3.12/3.13 上验证核心；操作系统特有测试按能力跳过。开发入口的 Linux 要求不改变产品的跨平台支持。
协议测试通过不代表特定供应商已联调；AT-SPI 能否读取某个应用取决于桌面会话和应用的无障碍支持。参见各模块文档中的已验证边界。
旧版源代码保存在 Git 历史基线 6e22bf3。旧 config.json、历史数据及本地环境不会被启动程序自动覆盖。
1 maintainer
Metadata
1 maintainer
Release files for muli-agent 2.57.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| muli_agent-2.57.0.tar.gz | 4.5 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| muli_agent-2.57.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.4 MB
Release files / muli_agent-2.57.0.tar.gz
| Download URL | muli_agent-2.57.0.tar.gz |
|---|---|
| Size | 4.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
99c12e5668541b49d257f73cccd9415d2b9b6da93d8b718fd17eb25892f5e9de
|
|
BLAKE2b-256 checksum How to use checksums |
c59a2fbb192d35a6b3ac1ec14a065b55363a58a41bda308a76485c20dcff43d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / muli_agent-2.57.0-py3-none-any.whl
| Download URL | muli_agent-2.57.0-py3-none-any.whl |
|---|---|
| Size | 854.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ebca44c715e8b2ab59d11f2eeb46c4c095b720921c957abc976b30c878edbef3
|
|
BLAKE2b-256 checksum How to use checksums |
820d5e84a02da7b64816108e898eb13ce0ac5469f3a5d87e9dc0c07225acb6dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for muli-agent 2.57.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for muli_agent-2.57.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
