muli-agent 2.0.0__tar.gz

muli_agent-2.0.0/.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  workflow_call:
+permissions:
+  contents: read
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: '3.13'
+      - run: uv sync --locked
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run mypy
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - run: node --test tests/frontend/*.test.mjs
+      - run: uv build
+      - run: uv run python scripts/check_wheel.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-package
+          path: dist/*
+  tests:
+    timeout-minutes: 10
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ['3.12', '3.13']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked
+      - run: uv run pytest -q -o faulthandler_timeout=60
+  mcp:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: '3.13'
+      - run: uv sync --locked --extra mcp --extra channels
+      - run: uv run --extra mcp --extra channels pytest -q -o faulthandler_timeout=60 tests/test_mcp.py tests/test_channels.py

muli_agent-2.0.0/.github/workflows/release.yml

@@ -0,0 +1,70 @@
+name: Release
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+jobs:
+  verify:
+    if: startsWith(github.ref, 'refs/tags/v')
+    uses: ./.github/workflows/ci.yml
+  prepare:
+    needs: verify
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: '3.13'
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package
+          path: dist/
+      - name: Validate the tag and exact tested distributions
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: uv run --no-project python scripts/release.py --tag "$RELEASE_TAG"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: release-notes
+          path: release-notes.md
+  publish:
+    needs: prepare
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/muli-agent
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package
+          path: dist/
+      - name: Publish verified distributions with a short-lived OIDC credential
+        uses: pypa/gh-action-pypi-publish@release/v1
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package
+          path: dist/
+      - uses: actions/download-artifact@v4
+        with:
+          name: release-notes
+      - name: Publish the same tested package files
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: gh release create "$RELEASE_TAG" dist/*.whl dist/*.tar.gz --verify-tag --title "MuLi $RELEASE_TAG" --notes-file release-notes.md

muli_agent-2.0.0/.gitignore

@@ -0,0 +1,25 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+*.log
+config.json
+history/
+
+searxng/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+*.sqlite3
+*.sqlite3-shm
+*.sqlite3-wal
+.muli/

muli_agent-2.0.0/.python-version

@@ -0,0 +1 @@
+3.13

muli_agent-2.0.0/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+版本记录区分实际交付与历史回填；未完成验证的工作不作为发布完成的证据。
+
+## [2.0.0] — 2026-10-20
+
+- 修复子进程输出超限后管道背压可能阻塞回收的问题，清理时有界丢弃输出并关闭管道。
+- 可选渠道加密依赖未安装时，仍能完成基础发行包的严格类型检查。
+- 发行名改为 `muli-agent`，保留 `MuLi` / `muli` 命令；OIDC Trusted Publishing 复用完整 CI 的产物。
+- 配置数据统一到 `~/MuLi`，交互初始化主模型、视觉、称呼、服务密码和只读源码参考；首次配置由主沐璃继续引导。
+- 跨渠道稳定主会话、持久入站、消息安全边界投递、动态团队与后台分层压缩，实际参考 Codex 的生命周期实现。
+- 原文优先的非阻塞分层 GraphRAG，规范实体、证据关系、社区、冲突、向量与重排服务、缓存和来源级遗忘。
+- 无侧栏青瓷蓝界面、浅深主题、Q版SVG、登录门、附件上传与按需媒体读取、审批/队列恢复。
+- 独立未完成工作账本、可验证自身配置计划、用户目录插件、启动版本检查与强制人工批准的更新入口。
+- 可选 Telegram、OneBot/NapCat、QQ 官方机器人、微信 iLink 渠道，明确绑定主人与群、持久入站和出站账本、文件收发与不确定结果的人工重试。
+- systemd、LaunchAgent、Windows 无窗口用户服务；交互初始化可直接进入后台运行。默认关闭的有界截图、录屏、语音唤醒与声纹命令桥接，复用 ASR/TTS 配置和统一附件库。
+- chiliarch 0.5.0 自我介绍接入；每次连接首心跳发送用户配置的数字助手介绍。
+- 系统注意事项收件箱将有证据的提醒、维护终态与新版通知在活动主任务结束后交给主沐璃，支持原子去重、离线持久和背压；独立只读回合不打断原任务，不继承历史渠道路由。
+- 修复墙钟回拨的消息顺序、孙队友取消传播、等待审批时刷新丢显示、队内消息与配置重载竞态，以及热改监听地址后提前解除认证的问题。
+- 修复单并行槽下摘要阻塞、最终回复后的摘要滞留、超额工具批次执行、渠道重投信封冲突、授权撤销竞态、语音嵌套回调取消、macOS 录屏误选音频及 Windows 自身重启问题。
+- 修复异步 embedding/reranker 请求期间忘记或更正记忆后，旧证据重新进入结果和缓存的竞态；每次等待后核对记忆修订号，必要时返回当前本地投影。
+- 更新保留已安装 extras，版本约束冲突会明确失败；新装插件立即进入管理清单并提示重启。高级配置、渠道发送账本、设备能力和维护计划均可在简洁设置页管理。
+- 外部渠道、声学命令桥接与跨平台系统调用保留明确的可选依赖和验证边界；默认不启用录音、唤醒或屏幕采集，不自动下载本地模型。
+
+## [1.0.0] — 2026-10-19
+
+### 新增
+
+- 本地网页管理工作台、流式会话、审批、设置、工作流、记忆和通知。
+- Chat Completions、Responses、Anthropic 原生协议，流式与非流式、完整工具回放与有限重试。
+- ask / auto / yolo 统一权限入口；auto 使用独立审查上下文。
+- 有界多 agent DAG、角色模型、取消、失败传播与重启中断标记。
+- chiliarch 原生配对、定向 SSE、持久化回执和事件驱动任务入口。
+- SQLite 全历史记忆索引、来源、置信度、两跳关系检索、修订历史与级联忘记。
+- 有界文件读写搜索、可恢复回收站、网页检索读取、Linux AT-SPI 电脑操作。
+- systemd 用户服务生成与管理；可配置运行预算。
+- 持久一次/重复提醒、停机漏期合并，无 AI 轮询。
+- 可选 Linux 桌面通知，事件驱动、有界队列，复用已有 notify-send。
+- 可选 MCP stdio / HTTP / SSE 工具与完整管理配置。
+- 确定性上下文节选和原生协议回放保真，保留会话原始记录。
+- 本地 API 文档、个人数据导出、桌面与手机布局。
+
+### 可靠性
+
+- 主会话与工作流未完成任务限额、共享并行、父子结果等待与取消传播。
+- 配置变更与运行登记串行化；恢复时标记中断，不自动重做副作用。
+- 网页地址固定防止 DNS 重绑定，文件并发串行和原子不覆盖写入。
+- 有界子进程输出与进程组清理；AT-SPI 独立 stderr、快照时效与节点身份验证。
+- 三协议回归、故障注入、权限/恢复测试，Ruff、严格类型检查和跨平台 CI。
+
+### 重构
+
+- 用显式工具注册和 src/muli 分层替代导入时自动扫描/启动。
+- 默认依赖不再包含 Docker SDK、LangChain、OpenAI SDK、NumPy 或本地模型组件。
+- 提示词定位为数字生命与私人助手，移除恋爱关系假设。
+
+## [0.0.0] — 历史基线（回填）
+
+对应重构前 6e22bf3 及其历史，不创建虚构的旧发布时间或标签。旧 pyproject 曾标记 0.1.0，本节按本次需求统一记为 v0.0.0 基线。
+
+- Rich 终端聊天、OpenAI/DeepSeek 工具调用、JSON 会话历史及摘要压缩。
+- FastMCP 客户端、基于模块标记的 Python 工具发现。
+- SearXNG 搜索、Docker 命令与文件复制、天气与时间工具。
+- 单会话原型；没有网页工作台、统一权限门、测试矩阵或服务生命周期管理。

muli_agent-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [Null]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

muli_agent-2.0.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.5
+Name: muli-agent
+Version: 2.0.0
+Summary: 沐璃：事件驱动的本地数字生命与私人多 agent 助手
+Project-URL: Repository, https://github.com/69gg/MuLi
+Project-URL: Documentation, https://github.com/69gg/MuLi/blob/main/README.md
+Author-email: Null <pylindex@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: fastapi<1,>=0.119
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: jsonschema<5,>=4.23
+Requires-Dist: pydantic<3,>=2.12
+Requires-Dist: uvicorn<1,>=0.38
+Provides-Extra: channels
+Requires-Dist: cryptography<48,>=43; extra == 'channels'
+Provides-Extra: mcp
+Requires-Dist: fastmcp<3,>=2.13; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# 沐璃 · MuLi
+
+本地数字生命，与你一起把事情做好。
+
+[![CI](https://github.com/69gg/MuLi/actions/workflows/ci.yml/badge.svg)](https://github.com/69gg/MuLi/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/Python-3.12%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-MIT-blue)](LICENSE)
+
+</div>
+
+MuLi 是面向个人电脑的常驻助手：聊天、管理文件、搜索资料、记忆偏好、接收任务，以及让多个 agent 分工和复核。主要适配 Arch Linux 和其他 Linux；网页与核心服务支持 macOS / Windows，桌面操作和用户服务的能力按平台显示。
+
+角色形象是十八岁的少女，定位为数字生命与本地助手，不设定恋爱关系。青瓷蓝工作台将对话放在中心，执行轨迹、审批和设置按需展开。
+
+![青瓷蓝工作台](docs/screenshots/workbench-desktop.jpg)
+
+## 能力
+
+| 领域 | 当前实现 |
+| --- | --- |
+| 模型 | OpenAI Chat Completions、Responses、Anthropic 原生协议；流式/非流式、推理参数、工具回放、重试预算 |
+| 协作 | 持续主身份、动态 spawn/send/wait/resume/stop 团队、依赖工作流；历史成员无固定上限，执行有资源预算 |
+| 权限 | ask 每个工具调用询问；auto 独立审查 agent，风险操作交给用户；yolo 自动执行 |
+| 文件 | 目录、读取、写入、精确编辑、搜索、复制、移动、可恢复回收站 |
+| 搜索 | SearXNG / Brave / Tavily 可配服务，有限大小网页读取与来源链接 |
+| 记忆 | 分层原文与后台提炼、关键词/embedding/关系图混合检索、reranker、来源证据、冲突修订、来源级忘记 |
+| 电脑 | Linux AT-SPI 无障碍树、节点动作与文本编辑；可选有界截图、录屏与统一附件引用 |
+| 渠道 | 可选 OneBot/NapCat、Telegram、QQ 官方机器人和微信 iLink；同一主身份、明确回复路由与本地文件收发 |
+| 语音 | 默认关闭的中文声学唤醒与声纹桥接、录音参考、OpenAI 兼容 ASR/TTS；不附带本地模型 |
+| 主动事件 | chiliarch 原生配对与 SSE 任务；持久提醒、维护结果与新版通知进入主会话，可选 Linux 桌面通知，无 AI 轮询 |
+| 扩展 | 用户目录 Python 插件与可选 MCP；工具、提示词、模型、路由和生命周期可扩展 |
+| 长任务 | 原始归档、后台分层压缩、协议回放、持久收件队列及未完成工作账本 |
+| 管理 | 模型、权限、工具、目录、记忆、工作流、通知、服务状态与日志统一入口 |
+
+## 启动
+
+需要 Python 3.12+ 和 [uv](https://docs.astral.sh/uv/)。前端无需安装 Node 依赖或构建。默认运行不依赖 Docker、向量数据库或本地模型。
+
+```bash
+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；配置文件和数据库使用私人文件权限。
+
+```bash
+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 模型；平台接入方式见[渠道说明](docs/channels.md)。
+
+## 后台服务
+
+```bash
+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 使用 systemd 用户服务；macOS 使用 LaunchAgent；Windows 使用当前用户计划任务及 `pythonw.exe`，不弹出命令窗口。它们通常随用户登录启动。Linux 退出登录后仍需运行时，可按系统策略启用 user lingering；MuLi 不更改系统登录策略。桌面权限与实际平台验证范围见[平台能力](docs/platforms.md)。
+
+## 权限与资源
+
+所有模型发起的工具调用经过同一个权限门，子 agent 继承模式，不得自行提升。工作目录列表是文件工具的访问范围；yolo 也不会取消配置的预算和工具禁用状态。shell 与桌面操作具有当前用户能力，auto 会交给用户确认；路径范围不是操作系统沙箱。
+
+文件操作默认限于用户主目录，可在设置里修改。文件读取/写入、网页下载、命令输出、工作流节点与并行数均有上限。删除使用回收站，跨文件系统回收拒绝隐式复制大目录。重启后未完成任务标为中断，不盲目重复可能已有副作用的操作。
+
+## 进一步阅读
+
+- [架构与执行边界](docs/architecture.md)
+- [模型协议与参数](docs/providers.md)
+- [多 agent 工作流](docs/workflows.md)
+- [上下文与长任务](docs/context.md)
+- [个人记忆设计](docs/memory.md)
+- [MCP 扩展](docs/mcp.md)
+- [用户插件与自身管理](docs/self-management.md)
+- [PyPI 与发布流程](docs/publishing.md)
+- [桌面通知](docs/notifications.md)
+- [系统注意事项与主会话唤醒](docs/attention.md)
+- [chiliarch 接入](docs/chiliarch.md)
+- [可选通讯渠道与本地文件收发](docs/channels.md)
+- [跨平台服务、截图和录屏](docs/platforms.md)
+- [中文唤醒与声纹桥接](docs/voice.md)
+- [工作台交互](docs/frontend.md)
+- [配置、迁移与运维](docs/operations.md)
+- [迭代记录](docs/iterations.md)
+- [版本变更](CHANGELOG.md)
+
+## 开发与验证
+
+```bash
+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
+uv run pytest -q
+uv run ruff check .
+uv run ruff format --check .
+uv run mypy
+node --test tests/frontend/*.test.mjs
+uv build
+uv run python scripts/check_wheel.py
+```
+
+测试使用临时目录、模拟 HTTP/SSE 与假模型，不使用真实模型额度、不点击真实桌面。CI 在 Linux、macOS、Windows 与 Python 3.12/3.13 上验证核心；操作系统特有测试按能力跳过。
+
+协议测试通过不代表特定供应商已联调；AT-SPI 能否读取某个应用取决于桌面会话和应用的无障碍支持。参见各模块文档中的已验证边界。
+
+旧版源代码保存在 Git 历史基线 `6e22bf3`。旧 `config.json`、历史数据及本地环境不会被启动程序自动覆盖。

muli_agent-2.0.0/README.md

@@ -0,0 +1,122 @@
+<div align="center">
+
+# 沐璃 · MuLi
+
+本地数字生命，与你一起把事情做好。
+
+[![CI](https://github.com/69gg/MuLi/actions/workflows/ci.yml/badge.svg)](https://github.com/69gg/MuLi/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/Python-3.12%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-MIT-blue)](LICENSE)
+
+</div>
+
+MuLi 是面向个人电脑的常驻助手：聊天、管理文件、搜索资料、记忆偏好、接收任务，以及让多个 agent 分工和复核。主要适配 Arch Linux 和其他 Linux；网页与核心服务支持 macOS / Windows，桌面操作和用户服务的能力按平台显示。
+
+角色形象是十八岁的少女，定位为数字生命与本地助手，不设定恋爱关系。青瓷蓝工作台将对话放在中心，执行轨迹、审批和设置按需展开。
+
+![青瓷蓝工作台](docs/screenshots/workbench-desktop.jpg)
+
+## 能力
+
+| 领域 | 当前实现 |
+| --- | --- |
+| 模型 | OpenAI Chat Completions、Responses、Anthropic 原生协议；流式/非流式、推理参数、工具回放、重试预算 |
+| 协作 | 持续主身份、动态 spawn/send/wait/resume/stop 团队、依赖工作流；历史成员无固定上限，执行有资源预算 |
+| 权限 | ask 每个工具调用询问；auto 独立审查 agent，风险操作交给用户；yolo 自动执行 |
+| 文件 | 目录、读取、写入、精确编辑、搜索、复制、移动、可恢复回收站 |
+| 搜索 | SearXNG / Brave / Tavily 可配服务，有限大小网页读取与来源链接 |
+| 记忆 | 分层原文与后台提炼、关键词/embedding/关系图混合检索、reranker、来源证据、冲突修订、来源级忘记 |
+| 电脑 | Linux AT-SPI 无障碍树、节点动作与文本编辑；可选有界截图、录屏与统一附件引用 |
+| 渠道 | 可选 OneBot/NapCat、Telegram、QQ 官方机器人和微信 iLink；同一主身份、明确回复路由与本地文件收发 |
+| 语音 | 默认关闭的中文声学唤醒与声纹桥接、录音参考、OpenAI 兼容 ASR/TTS；不附带本地模型 |
+| 主动事件 | chiliarch 原生配对与 SSE 任务；持久提醒、维护结果与新版通知进入主会话，可选 Linux 桌面通知，无 AI 轮询 |
+| 扩展 | 用户目录 Python 插件与可选 MCP；工具、提示词、模型、路由和生命周期可扩展 |
+| 长任务 | 原始归档、后台分层压缩、协议回放、持久收件队列及未完成工作账本 |
+| 管理 | 模型、权限、工具、目录、记忆、工作流、通知、服务状态与日志统一入口 |
+
+## 启动
+
+需要 Python 3.12+ 和 [uv](https://docs.astral.sh/uv/)。前端无需安装 Node 依赖或构建。默认运行不依赖 Docker、向量数据库或本地模型。
+
+```bash
+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；配置文件和数据库使用私人文件权限。
+
+```bash
+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 模型；平台接入方式见[渠道说明](docs/channels.md)。
+
+## 后台服务
+
+```bash
+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 使用 systemd 用户服务；macOS 使用 LaunchAgent；Windows 使用当前用户计划任务及 `pythonw.exe`，不弹出命令窗口。它们通常随用户登录启动。Linux 退出登录后仍需运行时，可按系统策略启用 user lingering；MuLi 不更改系统登录策略。桌面权限与实际平台验证范围见[平台能力](docs/platforms.md)。
+
+## 权限与资源
+
+所有模型发起的工具调用经过同一个权限门，子 agent 继承模式，不得自行提升。工作目录列表是文件工具的访问范围；yolo 也不会取消配置的预算和工具禁用状态。shell 与桌面操作具有当前用户能力，auto 会交给用户确认；路径范围不是操作系统沙箱。
+
+文件操作默认限于用户主目录，可在设置里修改。文件读取/写入、网页下载、命令输出、工作流节点与并行数均有上限。删除使用回收站，跨文件系统回收拒绝隐式复制大目录。重启后未完成任务标为中断，不盲目重复可能已有副作用的操作。
+
+## 进一步阅读
+
+- [架构与执行边界](docs/architecture.md)
+- [模型协议与参数](docs/providers.md)
+- [多 agent 工作流](docs/workflows.md)
+- [上下文与长任务](docs/context.md)
+- [个人记忆设计](docs/memory.md)
+- [MCP 扩展](docs/mcp.md)
+- [用户插件与自身管理](docs/self-management.md)
+- [PyPI 与发布流程](docs/publishing.md)
+- [桌面通知](docs/notifications.md)
+- [系统注意事项与主会话唤醒](docs/attention.md)
+- [chiliarch 接入](docs/chiliarch.md)
+- [可选通讯渠道与本地文件收发](docs/channels.md)
+- [跨平台服务、截图和录屏](docs/platforms.md)
+- [中文唤醒与声纹桥接](docs/voice.md)
+- [工作台交互](docs/frontend.md)
+- [配置、迁移与运维](docs/operations.md)
+- [迭代记录](docs/iterations.md)
+- [版本变更](CHANGELOG.md)
+
+## 开发与验证
+
+```bash
+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
+uv run pytest -q
+uv run ruff check .
+uv run ruff format --check .
+uv run mypy
+node --test tests/frontend/*.test.mjs
+uv build
+uv run python scripts/check_wheel.py
+```
+
+测试使用临时目录、模拟 HTTP/SSE 与假模型，不使用真实模型额度、不点击真实桌面。CI 在 Linux、macOS、Windows 与 Python 3.12/3.13 上验证核心；操作系统特有测试按能力跳过。
+
+协议测试通过不代表特定供应商已联调；AT-SPI 能否读取某个应用取决于桌面会话和应用的无障碍支持。参见各模块文档中的已验证边界。
+
+旧版源代码保存在 Git 历史基线 `6e22bf3`。旧 `config.json`、历史数据及本地环境不会被启动程序自动覆盖。