AG064/argentum

# 银白

银白是一款本地优先的AI工作空间。它为您提供桌面聊天应用、TypeScript代理运行时、提供商路由、记忆、通道、日志和安全控制，所有功能集成在一个可自行运行和检查的项目中。 [](https://github.com/AG064/ag-claw/releases) [](https://nodejs.org) [](./LICENSE) [](https://github.com/AG064/ag-claw/actions) [](https://hub.docker.com/r/ag064/argentum) ## 安装说明 ### Windows 安装 对于大多数Windows用户，请使用桌面安装程序： [Argentum_0.0.6_x64-setup.exe](https://github.com/AG064/ag-claw/releases/latest) 安装向导的操作流程与普通Windows安装程序相同： - 显示许可协议 - 显示默认安装位置，通常为 `C:\Program Files\Argentum` - 允许在安装前更改安装文件夹 - 将银白添加到Windows开始菜单 - 创建桌面快捷方式 - 提供安装完成后启动银白桌面界面的选项 安装完成后，从开始菜单启动银白。首次启动会打开引导向导。之后，银白将直接进入桌面应用。 ### v0.0.6版本更新内容 v0.0.6是一个专注于桌面体验的版本。它清理了聊天界面，使引导向导更不易卡住，添加了Monaspace Krypton字体，将推理输出与正常回复分开显示，并改进了Telegram会话处理。同时，它也保留了来自`development`分支的近期安全清理成果。 ## 提供商状态 ### 稳定提供商 | 提供商 | 状态 | 认证模式 | 备注 | | --- | --- | --- | --- | | ChatGPT / OpenAI | 稳定 | API密钥, ChatGPT/Codex浏览器账户授权 | 已接入实时聊天、模型选择器、提供商测试、使用量/错误报告功能。 | | MiniMax | 稳定 | API密钥 | 已接入实时聊天、MiniMax Token Plan使用量检查、重置周期及M2.7最佳实践上下文功能。 | ### 测试中提供商 Anthropic Claude、Google Gemini、OpenRouter、NVIDIA、Groq、Ollama/本地以及自定义端点仍处于测试阶段。它们可用于配置和提供商测试，但尚未成为稳定的桌面路由。 ## 支持的操作系统 | 平台 | 当前支持状态 | 附件 | 运行时说明 | | --- | --- | --- | --- | | Windows | Windows 10/11 x64 | `Argentum_0.0.6_x64-setup.exe`, `Argentum_0.0.6_x64_en-US.msi` | 使用Microsoft Edge WebView2。Windows 11已内置；Windows 10 1803+通常已安装，如果缺失，安装程序可进行安装。 | | Linux | 源码支持的目标平台 | Linux桌面包计划纳入自动化发布流程 | 需要标准的Tauri/WebKitGTK桌面栈。目标平台为Ubuntu 22.04+及类似的Debian/Fedora/Arch/openSUSE桌面系统。 | | macOS | 源码支持的目标平台 | macOS DMG镜像计划纳入自动化发布流程 | 使用系统WKWebView。目标平台为Intel和Apple Silicon上的macOS 10.15+。 | ## 硬件要求 银白默认使用系统WebView和托管提供商，因此桌面应用不需要大型本地GPU。 | 等级 | 要求 | | --- | --- | | 最低配置 | 64位CPU, 4 GB内存, 500 MB可用磁盘空间, 可用的系统WebView, 访问托管提供商所需的互联网连接。 | | 推荐配置 | 4核CPU, 8 GB内存, 1 GB可用磁盘空间, 稳定的宽带连接，以及基于SSD的工作区。 | | 网关 | 默认情况下，本地端口`3000`可用，提供商/网络访问仅在您配置并批准后可用。 | | 提供商使用量 | ChatGPT/OpenAI的使用量遵循所选账户或API计划。MiniMax Token Plan的使用量显示在诊断信息中，重置信息会展示在模型上下文中。 | ### 便携式命令行工具 当您需要终端工作流程而非桌面应用时，可以使用命令行工具。Windows命令行工具二进制文件会在构建时作为发布附件；在启用CI打包之前，Linux和macOS的命令行工具二进制文件可以从源码构建。 ``` argentum onboard argentum doctor ``` ### Docker ``` docker run -it ag064/argentum ``` ### 从源码构建 ``` git clone https://github.com/AG064/ag-claw.git cd ag-claw npm install npm run onboard npm run dev ``` ## 银白包含内容 当前项目包括： - 本地配置和数据所有权 - 65+个可按需启用的模块化功能 - Telegram会话路由，以及Discord、Slack、WhatsApp、电子邮件、短信、网页聊天和移动通道模块 - SQLite、语义搜索、知识图谱、Markdown和分层记忆选项 - 加密密钥、白名单、策略控制、审计日志和速率限制 - 桌面Shell、命令行工具、Docker支持以及发布打包脚本 ## 日常命令 ``` argentum onboard # Run first-time setup argentum doctor # Check configuration and dependencies argentum gateway start # Start the API/web gateway argentum gateway stop # Stop the gateway argentum gateway status # Show gateway status argentum tools # List available features argentum feature enable # Enable a feature argentum feature disable # Disable a feature argentum config # Print current config argentum memory search # Search memory argentum help # Show all commands ``` 双击已安装的Windows快捷方式将打开银白桌面界面。命令行工具二进制文件是终端工具，有意与GUI安装程序分开。 ## 架构 ``` Argentum |-- Channels | |-- Telegram, Discord, Slack, WhatsApp, email, SMS, webchat, mobile |-- Agent Runtime | |-- LLM providers, model routing, tools, sessions |-- Features | |-- automation, media, integrations, skills, workflows |-- Memory | |-- SQLite, semantic search, graph, markdown, hierarchical memory |-- Security | |-- encrypted secrets, allowlists, rate limiting, policy engine, audit logs ``` ## 文档 | 指南 | 用途 | | --- | --- | | [快速入门](docs/QUICK_START.md) | 快速开始运行 | | [用户指南](docs/USER_GUIDE.md) | 日常操作 | | [开发者指南](docs/DEVELOPER_GUIDE.md) | 扩展银白 | | [API参考](docs/API.md) | HTTP API和配置详情 | | [发布打包](docs/RELEASE_PACKAGING.md) | 二进制文件和安装程序构建详情 | | [安全](SECURITY.md) | 安全模型和报告 | | [功能](docs/FEATURES.md) | 功能目录 | ## 开发 ``` npm install npm run typecheck npm run lint npm test npm run build ``` 在Windows上构建Windows发布附件： ``` npm run package:win ``` 此命令通过Tauri构建Windows桌面应用安装程序。如需可选的便携式命令行工具，请运行 `npm run package:win:cli`。 ## 许可协议 MIT。版权所有 2024-2026 AG064。基于nickarora的OpenClaw。

标签：AI代理框架, AI工作空间, Docker支持, Frida, MITM代理, Node.js环境, TypeScript开发, 代理运行时, 内存管理, 可插拔功能, 后端开发, 安全性控制, 安全控制, 工作空间, 提供者路由, 无订阅, 日志系统, 本地优先架构, 桌面应用, 桌面聊天应用, 模块化, 消息通道集成, 生产级安全, 自托管, 自托管部署, 请求拦截, 软件框架, 通信渠道