4.6 KiB
4.6 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, 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-维护手册 | 6c2974c0-4721-48b6-9655-745316b7472c | project | 6553b53c-bf14-49e3-a3de-1ee2f3533d51 | development | null | development | maintenance | 1 | null | Sub2API | git-restore | 13 |
|
207 | 5a2bf7e4aa8a90513e133f70e1737cdaf99fddd9888166c7645ba4700934109c | 2026-08-12.3 | 3 | null | 2026-08-31T03:10:15.092752+00:00 | 2026-09-23T14:56:45.715505+00:00 |
|
6a6a895eaf |
HanteleWorkTime 维护手册
本手册针对 HanteleWorkTime 工作区（development）提供日常运维、记忆更新以及凭证管理的最佳实践。
1. 记忆（Project Context）管理
- 所有开发、运维、故障排查笔记统一写入
aidocs/project_context.md。 - 文件结构：固定标题行后，以 最新优先、秒级时间戳(
YYYY-MM-DD HH:MM:SS) 追加条目，记录 做了什么、为何、如何验证、遇到的问题、后续计划 [来源:global_guidance_memory:5ed86f53-b53e-4534-8e51-d3a010069d5e] aidocs/已加入.gitignore，永不提交至代码库；完成任务后执行 清理临时文件、调试日志、无用代码，再提交有意义的代码改动。提交信息格式为type: 中文一句话描述（如feat: 修复登录超时） [来源:global_guidance_memory:5ed86f53-b53e-4534-8e51-d3a010069d5e]
2. Git 工作流
- 默认 仅 commit；除非明确要求
push，系统不会自动推送。 [来源:global_guidance_document:d3a20d44-6001-4c88-8772-65dbfac75e6e] - 提交类型约定：
feat,fix,refactor,style,docs,chore,revert，后接中文简要描述。 [同上] - 非当前会话的合理修改（不含敏感信息）在确认不破坏代码后一起提交。 [来源:
global_guidance_memory:5ed86f53-b53e-4534-8e51-d3a010069d5e]
3. 凭证检索与更新工作流
- 登录/SSH/数据库/API 前统一走 Vaultwarden 检索流程。唯一匹配自动使用，多条或无匹配时提示人工选择。 [来源:
global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316] - 新增或修改的 密码、Token、API‑Key、TOTP 种子 必须立即写入密码库；记忆中仅记录名称、用途、使用方式，绝不保存明文。 [同上]
- 目前受管基础设施列表：BDYG18Pro、OpenWrt、MySQL、MemRelay、Gitea OAuth、FRP Token、公网 FRPS 服务器。 [同上]
4. 常规维护任务
| 任务 | 频率 | 关键步骤 |
|---|---|---|
| 检查 Docker 代理 | 每次 Docker 重启后 | 确认 http://127.0.0.1:7897 已在 Docker Desktop 手动代理中配置并生效 [来源: global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56] |
| 更新项目记忆 | 每次功能迭代或故障排查后 | 在 aidocs/project_context.md 追加最新条目，确保时间戳精确到秒 |
| 验证凭证可用性 | 每周一次 | 使用检索到的凭证尝试登录对应服务，确认无失效或权限变化 |
| 清理临时文件 | 每日 | 删除容器内部的 /tmp、日志文件以及本地调试产生的 .log |
| 代码审查 | 每次合并前 | 确认不引入不必要依赖，遵守 KISS 与 YAGNI 规范 [来源: global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5] |
5. 故障排查要点
- Docker Exec 超时：默认 3 秒超时会导致长连接中断。获取裸 socket 后调用
settimeout(None)以保持无限阻塞 [来源:global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56] - FastAPI async 坑：在
async def中调用阻塞 I/O（如 pymysql、requests）会冻结事件循环。改为普通def，FastAPI 会自动转入线程池 [来源:global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0] - 凭证未自动使用：确保 Vaultwarden 条目唯一，若出现多条需手动确认；若无匹配则需手动输入或创建新条目 [来源:
global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316]
标签: ["maintenance","development"]