Where Them Logs

wherethemlogs.app

可搜索的应用程序日志文件位置索引，涵盖 Windows、macOS 和 Linux—— 每条路径都按安装程序类型和体系结构标注，并完全按照机器写入的形式呈现。

本项目面向那些在故障处理中途需要查找路径的人：IT 和终端管理员、 应用程序打包人员，以及所有曾在年代不明的论坛帖子里浪费二十分钟的人。

目录结构

app/                  pages, route handlers, proxy - Next.js 16
components/  lib/     UI, shared model, server-only data access
infra/                Azure resources - Bicep
scripts/              seed data and the seeder
docs/                 architecture, API reference, deployment, MCP, answer engines

一个应用程序，一个镜像。页面由服务器从 Cosmos 渲染；app/api/ 下的路由 处理程序在同一进程中为浏览器和管理门户提供服务。

运行

npm install
LOCAL_ADMIN_BYPASS=true \
COSMOS_ENDPOINT=https://<account>.documents.azure.com:443/ \
COSMOS_DATABASE=wtla \
npm run dev            # http://localhost:3777

需要使用具备 Cosmos 数据平面角色的帐户运行 az login。完整设置说明见 docs/DEPLOYMENT.md。

内容一览

路由	功能
/	标题页、支持实时联想的搜索框、近期新增、近期搜索、平台筛选器
/search	完整结果，可按平台、安装程序、体系结构和范围筛选
/privacy	隐私和 Cookie 声明
/admin	管理门户——供应商、应用和日志路径，并支持通过 /admin/import 导入和导出 JSON。Entra 登录，admin 角色。API 见 docs/API.md。

键盘操作：按 / 可在任何位置聚焦搜索框，使用方向键浏览联想结果，按 Enter 显示完整结果，按 Shift+Enter 复制高亮结果中的第一条路径。

目录

Vendor > App > LogPath。一个供应商可包含多个应用；一个应用可包含多个日志路径， 这些路径嵌入应用文档中。每个供应商都有一个图标，每个应用也可以覆盖该图标—— App.iconUrl: null 表示继承供应商的图标，并在读取时解析。

目前使用的是种子数据：scripts/seed-data.json 中有 24 个供应商、33 个应用和 86 条日志路径， 均为真实且可验证的数据，并在页脚和隐私页面上标注为演示数据集。

npm run seed -- --endpoint https://<account>.documents.azure.com:443/

路径按字节原样存储——绝不会展开 %LOCALAPPDATA%、~/Library/Logs、 $XDG_STATE_HOME，因为要修复的机器不是这台机器。

提交条目

请提交一个 issue。每个应用提交一个 issue，标题中注明平台和安装程序类型，并说明如何验证路径。

Issue 是公开的：请勿在其中粘贴真实主机名、用户名、租户标识符或客户名称。

上线前待办

• 注册 Entra ID 应用，添加 admin 应用角色，并设置 AUTH_CLIENT_ID / AUTH_TENANT_ID 仓库变量。在此之前，/admin 无法将你引导至任何地方。docs/DEPLOYMENT.md § 7。
• 选择分析服务提供商——Google Analytics 4，仅在接受后加载（components/Consent.tsx）。
• 用真实索引替换种子目录——/admin/import 可导入研究用 JSON。
• 在 CRUD API 基础上构建管理界面。
• 将仓库设为公开——此处通过 .github/ISSUE_TEMPLATE/ 中的表单提交请求和更正。

基础设施

Azure Container Apps 运行镜像；Cosmos DB（无服务器）和 Blob Storage 位于其后， 两者均通过托管标识访问——任何地方都不使用密钥。每次部署都会生成一个新修订版本， 因此回滚只需切换流量，无需重新构建。

每月约 $20。各组件的用途及成本说明见 docs/ARCHITECTURE.md。

设计

DESIGN.md 记录已实现的视觉系统。PRODUCT.md 记录产品事实。网站各界面的设计方向规范位于 .impeccable/surfaces/。

修改 CSS 前，有两条规则需要了解：

• 扁平印刷风格，不容例外。 不使用渐变、阴影或悬浮卡片。结构由模板线条和警示胶带构成。近黑色背景上的信号青色不能偏向霓虹光效。
• 两种声音。 人性化内容使用 Archivo，机器信息——路径、代码、计数和筛选值——使用 Spline Sans Mono。不得使用其他字体。