5.0 KiB
5.0 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-部署指南 | 5d0e9587-c39b-4f66-b84a-9259d3a22a05 | project | 6553b53c-bf14-49e3-a3de-1ee2f3533d51 | development | null | development | deployment | 1 | null | Sub2API | git-restore | 13 |
|
207 | 5a2bf7e4aa8a90513e133f70e1737cdaf99fddd9888166c7645ba4700934109c | 2026-08-12.3 | 3 | null | 2026-08-31T03:10:12.978059+00:00 | 2026-09-23T14:56:48.160923+00:00 |
|
6a6a895eaf |
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. 部署步骤概览
- 准备环境：确认 Windows + WSL2 + Docker Desktop 已安装并符合上文的代理与网络设置。
- 拉取代码：在本地工作区执行
git clone <repo>（仅克隆代码，不会自动创建.git除非显式请求）。 - 配置凭证：运行部署脚本前，确保所有必需的凭证已在 Vaultwarden 中存在且唯一。
- 构建容器：使用
docker compose build，期间 Docker 将通过host.docker.internal:7897访问外部代理。 - 启动服务：
docker compose up -d，检查容器日志确保无凭证加载错误。 - 验证：访问服务的 UI（如有），确认页面顶部标题在滚动时保持可见，表单布局符合 “标题在左、控件在右” 的紧凑横向规范 [来源:
global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5] - 记录部署：在
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"]