homelab-wiki/documentation-backlog.md

文档完善清单

本轮待核实事项已于 2026-09-16 收尾。以下是后续写作工作，不是未解决的状态核实任务， 也不代表所有相关项目都已部署或经过现场验收。需要补充事实时仍先向维护者对齐范围。

已补充使用指南

• Gitea / Actions：登录、建仓库、最小 CI、runner 选择和常见问题。
• Grafana：内存看板、指标查询、日志搜索和数据源用途。
• zot：拉取、发布授权、workflow 身份职责与后端数据恢复边界。
• SeaweedFS：S3 入口、专用凭据、列举与上传下载示例。
• OpenBao：人的登录、按权限取密及机器身份边界。
• NetBox：浏览设备与 IPAM，明确 Git 来源与评估用途。
• 共享 PostgreSQL：应用接入、连接检查与共享实例维护边界。
• LiteLLM：模型请求、认证边界与独立数据库依赖。
• Tailscale：客户端接入、子网路由和 operator Service 的区别。
• ps3netsrv、vlmcsd：客户端使用与配置入口。
• External Secrets、OpenEBS：应用秘密与 PVC 消费示例。
• k3s DNS：Pod 解析路径、配置意图与排障入口。
• Marker、OpenViking：转换与导入、等待、检索、读取示例。
• SMTP relay：应用配置、测试邮件与投递边界。
• 发布新服务：LAN DNS、证书、Envoy 路由、认证与 GitOps 的完整路径。
• Samba AD、OCI、Proxmox：已有资料中的日常管理路径，动态状态未重查。

以上依据源码文档和上游说明整理，示例未在本轮执行，不作为现场验收记录。

后续使用说明

本轮列出的使用指南已补齐。后续以实际接入任务补充细节，不自动启动全量现场检查。 Samba AD、OCI、Proxmox 已按维护者指定采用 IaC 优先、以代码为准，并核对关键配置入口；未查询现场。

codex-proxy 已按维护者“应该是退役的”的说明移至归档范围，不再补新接入指南。 LiteLLM、Tailscale、ps3netsrv、vlmcsd 与 k3s 的 wiki 指南已补；源码目录仍缺根 README，配置入口已在各页列出。

来源与导航

• 已新增按任务查找，首页改为任务入口与服务总览。
• 已核对 62 个主要来源文件，提供固定版本与工作区差异。
• 仍有差异或未收录的来源，等内容合并后再补对应版本；不自动提交原仓库工作区。

持续维护

• 已提供离线文档检查器、Gitea Actions 工作流与检查器测试。
• 已补 PR 模板及服务变更到文档的对应规则，见 CONTRIBUTING。
• Backstage 展示与 OpenViking 自动索引仍是独立后续工作，本轮未接入。

原仓库文档同步（按维护者要求暂缓）

• 源码仓库中 Authelia OIDC、LAN DNS、SPIRE 的旧说明后续与知识库结论同步。
• cert-manager / Envoy Gateway README 的 DNS 修改入口仍写旧变量，待同步为受管 records.yml 流程。
• Proxmox README 的早期身份方案与 runner bootstrap 描述待与当前 SPIFFE 原则对齐；Samba README 的通用示例域名/地址待清理。 上述项目仅保留记录，本轮不修改原仓库文档。