--- title: Workspace **t** – Glossary of Terms type: curated permalink: main/projects/1461ebb2-8a36-4326-98f8-5bbd3be53e59/curated/workspace-t-glossary-of-terms stable_id: a50c0d24-a6d2-4a80-a582-2f44c9ea5076 scope: project project_id: 1461ebb2-8a36-4326-98f8-5bbd3be53e59 workspace_type: general usage_profile_id: null preference_context: general document_type: glossary revision: 1 source_memory_ids: [] source_checkpoint_ids: [] source_file_ids: [] source_git_commit: null source_git_commits: [] source_agent_sync_ids: [] model_connection: Sub2API model_name: git-restore source_count: 13 source_revisions: {} source_dispositions: processed: 13 unchanged: 0 unsupported: 0 skipped: 0 cited_source_ids: [] job_cited_source_ids: [] conflicts: [] supersedes: [] preferences: [] source_cursor: 167 source_hash: c5ce64e952968e5b85024b19cca5baa487f9229c9253f72ada608e7d01bea435 prompt_version: 2026-08-12.3 schema_version: '3' curation_job_id: null created_at: '2026-08-26T19:13:39.930961+00:00' updated_at: '2026-09-23T14:51:02.356442+00:00' tags: - glossary restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2 --- # 术语表 以下术语在工作空间 **t** 的文档与任务中经常出现,已根据全局共享指南统一定义。 | 术语 | 定义 | |------|------| | **KISS** | Keep It Simple, Stupid – 只实现最简且正确的功能,避免不必要的复杂度。 (来源: `global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5`) | | **YAGNI** | You Aren’t Gonna Need It – 不为猜测的未来需求添加依赖或抽象层。 (同上) | | **MemRelay** | 持久化管理开发记忆的系统,所有项目记忆统一通过它维护。默认不创建本地 `aidocs/`、`project_context.md` 副本,除非用户明确要求。 (来源: `global_guidance_memory:1194be51-ee29-47e1-8957-ec2888007db6`) | | **aidocs/project_context.md** | 项目记忆文件,位于 `aidocs/` 目录,文件顶部保留固定标题,后续条目逆序(最新在前)并带秒级时间戳记录。 `aidocs/` 被 `.gitignore` 排除,防止记忆文件被提交。 (来源: `global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0`) | | **Vaultwarden** | 自托管的密码库服务,所有登录、SSH、数据库、API 操作前先在其中搜索凭证,唯一匹配时自动使用。 (来源: `global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316`) | | **AI Curations / Git Integration** | AI 驱动的记忆同步与 Git 工作流的可选功能,默认 **关闭**,系统在未配置时不尝试访问模型或创建 `.git` 目录。 (来源: `global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d`) | | **Docker Desktop Proxy** | Docker Desktop 的网络代理设置,需要手动配置为 `http://127.0.0.1:7897`,并在重启后验证 `docker pull` 能正常工作。 (来源: `global_guidance_document:7b5a1fcd-adea-4418-ac8e-2f6275b5ada6`) | | **FastAPI async 陷阱** | 在 `async def` 中调用阻塞 I/O(如 pymysql、requests)会冻结事件循环,推荐改为普通 `def` 或使用线程池。 (来源: `global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0`) | | **PowerShell JSON 发送** | 为避免引号被吞掉,先将 JSON 写入临时文件,再使用 `curl.exe --data-binary @file` 发送。 (同上) | | **中文交流** | 所有日常沟通、代码注释、文档均使用中文,除非用户明确要求使用其他语言。 (来源: `global_guidance_memory:7429c22e-50ff-458a-97c0-423c679904c7`、`global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823`) | | **提交信息格式** | 使用中文描述的提交类型,例如 `feat: 添加用户登录`,遵循“type: 中文说明”约定。 (来源: `global_guidance_document:6973450e-6ecc-48e3-8cdd-4d7d7707d843`) | --- *本术语表收录了工作空间 **t** 常用概念,保持与全局共享指导一致。*