6.3 KiB
6.3 KiB
title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags
| title | type | permalink | stable_id | scope | project_id | workspace_type | usage_profile_id | preference_context | document_type | revision | source_memory_ids | source_checkpoint_ids | source_file_ids | source_git_commit | source_git_commits | source_agent_sync_ids | model_connection | model_name | source_count | source_revisions | source_dispositions | cited_source_ids | job_cited_source_ids | conflicts | supersedes | preferences | source_cursor | source_hash | prompt_version | schema_version | curation_job_id | created_at | updated_at | tags | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| MemRelay Project Overview | curated | main/projects/ebb54e31-5afe-4f9b-a291-4e3b03ca3b21/curated/mem-relay-project-overview | eebf38d3-36dc-4b57-b8d7-1f2c8be2f234 | project | ebb54e31-5afe-4f9b-a291-4e3b03ca3b21 | development | null | development | overview | 8 | null | Sub2API | openai/gpt-oss-120b | 20 |
|
|
|
|
0 | cd96d5b27b5d1ef34ff30350e40c12b9d9b7e389c5813755521578d1f2597d9c | 2026-08-12.3 | 3 | 4379a1f9-25d0-4c99-ae7e-6fd930239187 | 2026-08-08T09:52:17.157448+00:00 | 2026-08-16T18:34:02.725477+00:00 |
|
MemRelay 项目概览
目标
- 为多个设备、项目、AI 客户端和聊天窗口提供可继承的个人规则、项目记忆、开发历史、密码库和文件仓储。
技术栈
- 后端: Python 3.12, FastAPI, FastMCP, SQLAlchemy, SQLite
- 前端: Vue 3, TypeScript, Vite, Element Plus, Vue I18n
- 记忆引擎: Basic Memory v0.22.1（Markdown 存储），MiniLM 语义检索（必要时降级为全文搜索）
- 容器化: Docker Desktop (Windows) & Docker‑Compose (Linux)，支持 amd64 与 arm64 双平台
部署拓扑
- 公网入口:
https://mr.asio.asia（OpenResty 终止 TLS 并转发至 FRPS） - 应用主机: Armbian ARM64
192.168.32.100，监听端口3003 - 持久化目录:
/data/memrelay-stack（MemRelay 与 Basic Memory 共享挂载） - FRP 栈: OpenWrt FRPC
0.70.1使用 WebSocket 连接 FRPS，映射mr.asio.asia → 192.168.32.100:3003 - 会话 Cookie: 根据请求协议动态决定
Secure标记，局域网 HTTP 与公网 HTTPS 均可使用 - 缓存策略: OpenResty 对登录、API、MCP、密码库等端点不启用代理缓存；静态资源使用 ETag 与浏览器缓存
- 备份:
/data/memrelay-backups/memrelay-20260805T234836Z.tar.gz
开发实施原则 (KISS & YAGNI)
- 使用最简单且正确的实现
- 优先复用已有框架、服务、工具和约定，避免重复实现
- 不添加仅服务于假设未来需求的依赖、抽象或基础设施
- 修改范围与当前目标一致，测试覆盖随风险扩大；完成前清理临时内容和无用代码
- 前端以真实工作流、桌面可用性、信息层级和无重叠为验收标准
项目记忆与 Git 工作流
- 项目本地记忆位于
aidocs/project_context.md，文件顶部保留固定标题，随后按 最新优先、秒级时间戳倒序追加记录，描述 做了什么、为什么、验证、问题与下一步 aidocs/已加入.gitignore，记忆文件不提交至 Git- 完成任务后：清理临时文件 → 更新记忆 → 检查工作树 → 使用
type: 中文说明格式提交有意义的代码改动
凭证与记忆边界
- 登录、SSH、数据库和 API 操作前先查询 Vaultwarden；唯一匹配时直接使用，不重复询问
- 新获得、生成或修改的账号、密码、Token、API 密钥和 TOTP 种子立即写入密码库
- 普通记忆仅记录密码库条目 名称、用途、使用方式，不保存秘密值
可选功能（默认禁用）
- AI 驱动的记忆整理（AI Curation）和 Memory‑Git 为可选增强，默认关闭。未开启时系统完整工作，不会探测模型、不创建
.git目录或报错。
UI 交互指南
- 表单采用 “标题在左、控件在右” 紧凑横向布局；多行/大块内容使用 “标题在上、内容在下”
- 页面顶部标题区域在滚动时保持可见，操作按钮固定在标题右侧
- 滚动区域局限于控件内部（如 Markdown 预览），避免整页滚动
- 表单标签列、控件列和分组间距保持紧凑一致，避免大面积留白
语言与工作方式
- 默认使用中文沟通，除非明确要求使用其他语言
- 开发环境为 Windows，所有命令、路径和验证步骤需兼容 Windows
- 在充分理解现有项目后实施，持续告知关键进展，可独立完成的工作直接完成并验证
密码库索引
| 条目 | 用途 |
|---|---|
MemRelay Administrator |
Web 管理员 |
BDYG18Pro Armbian SSH |
部署主机 |
OpenWrt Router SSH |
FRPC 与局域网路由 |
Public FRPS Server SSH |
公网 FRPS 与 OpenResty |
FRP ali.asio.asia Token |
FRPC/FRPS 认证 |
Gitea git.asio.asia OAuth |
Git 访问与令牌刷新 |
Armbian MySQL Root |
Docker MySQL |
来源: curated_baseline:eebf38d3-36dc-4b57-b8d7-1f2c8be2f234, global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5, global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316, global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823, global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d