64 lines
3.8 KiB
Markdown
64 lines
3.8 KiB
Markdown
---
|
||
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** 常用概念，保持与全局共享指导一致。* |