MemRelay/projects/6553b53c-bf14-49e3-a3de-1ee2f3533d51/curated/development/HanteleWorkTime 系统架构概览.md

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, restored_from_commit

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	restored_from_commit
HanteleWorkTime 系统架构概览	curated	main/projects/6553b53c-bf14-49e3-a3de-1ee2f3533d51/curated/development/hantele-work-time-系统架构概览	fb9a56e2-56ce-4d5a-9334-79c18192d663	project	6553b53c-bf14-49e3-a3de-1ee2f3533d51	development	null	development	architecture	1				null			Sub2API	git-restore	13		processed unchanged unsupported skipped 13 0 0 0	global_guidance_document:d3a20d44-6001-4c88-8772-65dbfac75e6e global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0 global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5 global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316 global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823 global_guidance_memory:1194be51-ee29-47e1-8957-ec2888007db6	global_guidance_document:d3a20d44-6001-4c88-8772-65dbfac75e6e global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0 global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5 global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316 global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823 global_guidance_memory:1194be51-ee29-47e1-8957-ec2888007db6				207	5a2bf7e4aa8a90513e133f70e1737cdaf99fddd9888166c7645ba4700934109c	2026-08-12.3	3	null	2026-08-31T03:10:05.582276+00:00	2026-09-23T14:56:43.902520+00:00	development architecture	6a6a895eaf

总体架构

1. 硬件/宿主平台

   • 主机操作系统：Windows 10/11。
   • 虚拟化层：WSL2（Linux 子系统）+ Docker Desktop。
   • 网络：容器通过 host.docker.internal 访问宿主服务；必要时使用网关 172.17.0.1。

2. 容器化服务

   • 业务服务（如 FastAPI、数据库等）运行在 Docker 容器内，端口统一映射到 0.0.0.0 以供宿主和外部访问。
   • 代理层：Docker Desktop 代理手动配置为 http://127.0.0.1:7897（支持 HTTP 与 HTTPS），确保所有容器的外网请求走本地代理。

3. 记忆与版本管理

   • MemRelay：统一的记忆持久化后端，负责 aidocs/project_context.md 中的笔记存取。
   • Git：本地 Git 仓库仅用于提交代码；aidocs/ 目录已加入 .gitignore，记忆文件不随代码推送。
   • 提交信息格式：type: 中文一句话描述（type 为 feat/fix/refactor/style/docs/chore/revert）。

4. 安全与凭证

   • 所有登录、SSH、数据库、API 调用前先查询 Vaultwarden；唯一匹配时自动使用。
   • 新增或修改的密码、Token、API‑Key、TOTP 种子立即写入密码库，记忆中仅记录名称、用途、使用方式。

5. 开发原则

   • KISS 与 YAGNI：实现最简且正确，复用已有框架与工具，避免投机性依赖。
   • AI 与 Git 自动化：默认关闭，除非显式启用。

6. 常见技术约束

   • FastAPI：避免在 async 接口中使用阻塞 I/O。
   • PowerShell：发送 JSON 时使用临时文件并 --data-binary @file。
   • Docker Exec：长连接需取消默认 3 秒超时。

标签: ["development", "architecture"]