---
title: HanteleWorkTime 部署指南
type: curated
permalink: main/projects/6553b53c-bf14-49e3-a3de-1ee2f3533d51/curated/development/hantele-work-time-部署指南
stable_id: 5d0e9587-c39b-4f66-b84a-9259d3a22a05
scope: project
project_id: 6553b53c-bf14-49e3-a3de-1ee2f3533d51
workspace_type: development
usage_profile_id: null
preference_context: development
document_type: deployment
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: 207
source_hash: 5a2bf7e4aa8a90513e133f70e1737cdaf99fddd9888166c7645ba4700934109c
prompt_version: 2026-08-12.3
schema_version: '3'
curation_job_id: null
created_at: '2026-08-31T03:10:12.978059+00:00'
updated_at: '2026-09-23T14:56:48.160923+00:00'
tags:
- deployment
- development
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
---

# HanteleWorkTime 部署指南

本文档面向 **HanteleWorkTime** 项目（工作区类型：development），提供当前可执行的部署步骤与注意事项。

## 1. 环境要求
- 操作系统：Windows（使用 **WSL2 + Docker Desktop**）  [来源: `global_guidance_document:d3a20d44-6001-4c88-8772-65dbfac75e6e`]
- Docker 代理：手动模式，HTTP 与 HTTPS 均指向 `http://127.0.0.1:7897`，重启 Docker 后验证 `docker pull` 正常工作  [来源: `global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56`]
- 网络访问：容器内部访问宿主代理使用 `host.docker.internal:7897`，如需直接访问宿主 IP 采用 `172.17.0.1`（桥接网络）  [来源: `global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56`]

## 2. 基本部署原则
- **KISS 与 YAGNI**：只实现最简且正确的功能，不为猜测的未来需求添加依赖或抽象层  [来源: `global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5`]
- **复用已有框架**：优先使用项目已有的服务、约定和工具，避免重复实现  [同上]

## 3. AI 与 Git 同步（可选）
- 默认 **关闭** AI 驱动的记忆同步与 Git 集成；系统在未显式开启时不会尝试加载模型、创建 `.git` 目录或进行自动 push  [来源: `global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d`]
- 如需启用，请在部署脚本中显式配置相应的 MemRelay 插件并确认 `.git` 目录已创建  [来源: `global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d`]

## 4. 凭证与安全
- 所有登录、SSH、数据库或 API 调用 **前** 必须在 Vaultwarden 中搜索对应条目；若唯一匹配则自动使用，否则提示人工选择  [来源: `global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316`]
- 新增或修改的密码、Token、API‑Key、TOTP 种子 **立即** 写入密码库；记忆中仅记录条目名称、用途与使用方式，绝不保存密文  [同上]
- 项目当前使用的基础设施条目包括 BDYG18Pro、OpenWrt、MySQL、MemRelay、Gitea OAuth、FRP Token 与公网 FRPS 服务器  [同上]

## 5. 部署步骤概览
1. **准备环境**：确认 Windows + WSL2 + Docker Desktop 已安装并符合上文的代理与网络设置。
2. **拉取代码**：在本地工作区执行 `git clone <repo>`（仅克隆代码，不会自动创建 `.git` 除非显式请求）。
3. **配置凭证**：运行部署脚本前，确保所有必需的凭证已在 Vaultwarden 中存在且唯一。
4. **构建容器**：使用 `docker compose build`，期间 Docker 将通过 `host.docker.internal:7897` 访问外部代理。
5. **启动服务**：`docker compose up -d`，检查容器日志确保无凭证加载错误。
6. **验证**：访问服务的 UI（如有），确认页面顶部标题在滚动时保持可见，表单布局符合 **“标题在左、控件在右”** 的紧凑横向规范  [来源: `global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5`]
7. **记录部署**：在 `aidocs/project_context.md` 追加部署记录（时间戳、操作、验证结果），该文件不被提交至 Git  [来源: `global_guidance_memory:5ed86f53-b53e-4534-8e51-d3a010069d5e`]

## 6. 常见问题
- **Docker 拉取超时**：确认代理已正确配置并在系统代理中开启。若仍失败，检查 `settings-store.json` 中 `ProxyHTTPMode=manual` 是否生效。  [来源: `global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56`]
- **AI 模型意外加载**：检查环境变量 `MEMRELAY_AI_ENABLED` 是否被误设为 `true`，否则系统会尝试加载默认模型并报错。  [来源: `global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d`]
- **凭证未自动使用**：确保 Vaultwarden 中的条目名称唯一；多个匹配会导致系统提示手动选择。  [来源: `global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316`]

---

**标签**: ["deployment","development"]