使用说明
快速内存服务器
Quick Memory Server是MCP工具和代理的轻量级自托管内存服务。使用它在会话和交接中保持持久、可搜索的上下文：决策、程序、调查和操作运行手册，这些不应该只存在于聊天回溯中。
此存储库包含一个Windows服务托管的ASP。NET Core worker，它公开：
- 用于项目/用户/条目/配置/健康的嵌入式管理Web UI。
- 用于代理/工具集成的流式HTTP MCP端点。
- 具有混合搜索和图形关系的每个项目内存存储（加上可选的共享内存）。
你为什么用这个
- 特工们忘记了；团队变动。 坚持“我们学到了什么”，这样下一次会话/代理就不会重新进行调查。
- 让运维知识贴近系统。 运行状况、日志、指标和备份与内存存储一起存在。
- 项目隔离。 按项目/分支分离内存存储，同时仍允许共享、跨项目引用条目。
文档（从这里开始）
docs/spec.md–架构和指挥界面docs/plan.md–实施计划/阶段/史诗docs/end-user-help.md–最终用户指南+Codex设置docs/agent-usage.md–MCP第一配方和有效载荷形状docs/codex-workspace-guide.md–Codex配置模式(mcp-proxy/mcp-remote)docs/admin-ui-help.md–管理员Web UI演练（刀片，代码所在的位置）
入门指南
前提条件
- 安装 .NET 9 SDK预览版（或更新版本）.
在本地运行（dev）
- 复制
QuickMemoryServer.sample.toml到QuickMemoryServer.toml并根据您的环境调整端点/用户。 - 从存储库根目录构建：WSL注释：如果你在
dotnet build QuickMemoryServer.sln/mnt/*，请参阅AGENTS.md对于推荐的Windowsdotnet.exe+Git设置以避免缓慢的I/O。 - 可选：运行测试：
dotnet test - 将worker作为控制台应用程序运行：
dotnet run --project src/QuickMemoryServer.Worker - 确认已启动：
GET /health用于服务器状态和存储库存GET /metrics普罗米修斯指标GET /docs/schema用于运行时JSON模式（用ETag缓存）
- 打开管理Web UI
/致：- 创建/编辑项目（端点）
- 创建/编辑用户+项目权限（API密钥）
- 浏览/搜索/编辑内存条目
- 查看运行状况和日志并下载日志包
连接代理（Codex）
规范的、可复制/粘贴的Codex设置存在于：
docs/end-user-help.md（快速启动）docs/codex-workspace-guide.md（多种模式，env-var选项）
至少，您需要：
- MCP基本URL：
http://localhost:5080/mcp - 身份验证标头：
X-Api-Key: <your key>（通过管理Web UI创建密钥）
Windows安装程序/更新程序
对于Windows部署，请使用PowerShell帮助程序 tools/install-service.ps1 （在高位提示符下运行）：
powershell -ExecutionPolicy Bypass -File tools/install-service.ps1
- 发布worker+MemoryCtl，重写
QuickMemoryServer.toml，将有效载荷复制到C:\Program Files\q-memory-mcp默认情况下，并（重新）创建QuickMemoryServerWindows服务（显示名称：快速内存MCP）。 - 提示机器/本地安装、安装/数据目录、端口、服务帐户和API密钥；您可以预先提供args(
-InstallDirectory,-DataDirectory,-Port,-ServiceAccount,-SkipStart,-SkipFirewall,-NoRollback). - 如果
QuickMemoryServer.toml已存在，它在覆盖之前会询问；数据文件永远不会被覆盖。 - 在复制之前停止服务，以避免文件锁定；重新启动它，除非
-SkipStart使用。副本docs/因此admin/agent帮助渲染。
该服务已预先配置为作为Windows服务运行(AddWindowsService)当与WiX一起发布和安装时（请参阅 docs/plan.md).
关键URL
/–管理Web UI/healthJSON健康报告/metrics–普罗米修斯指标/mcp–MCP基本路由（可流式传输HTTP）/docs/schema–运行时JSON模式（缓存+ETag）/admin/help/end-user–终端用户帮助/admin/help/agent–代理帮助（现场指南+食谱）/admin/help/codex-workspace–Codex工作区指南
仓库的规划
docs/–架构规范和实施计划。src/QuickMemoryServer.Worker/–工人服务项目。layout.json–WiX打包过程使用的安装程序布局清单。QuickMemoryServer.sample.toml–示例配置文件。AGENTS.md–关于日常开发细节的贡献者指南。tools/MemoryCtl–用于调用MCP维护命令（例如备份）的轻量级CLI。src/QuickMemoryServer.Worker/logs/–滚动结构化日志（在运行时创建，仅限开发人员）。
后续步骤
看 docs/plan.md 以及GitHub Issues的活动路线图。此仓库的Epics被跟踪为GitHub问题；使用GitHub CLI(gh issue view, gh issue edit)在开发过程中，保持范围和验收标准的最新状态。
