Typecho 网站结构说明

这是基于 HarmonyHues 主题的 Typecho 博客站点，目录结构如下：

根目录（/www/wwwroot/www.beihong.wang）

• index.php、index.html：前端入口文件。
• config.inc.php：Typecho 配置（数据库、站点信息等）。
• install.php、install/：安装程序及脚本。
• 静态资源：404.html、LICENSE.txt、img/ 等。

管理后台（/admin）

包含所有后台页面和资源，用于登录、发布文章、安装插件、修改主题等。

• 各种 PHP 页面 (manage-posts.php、options-theme.php 等)。
• css/、js/、img/ 子目录存放后台所需的样式、脚本与图片。

用户资源（/usr）

• themes/：主题目录，当前使用 HarmonyHues。
  • core/：主题基础功能、配置。
  • components/：各类组件与小部件。
  • assets/：前端静态资源（CSS、JS、图片、一言文本等）。
  • install/、functions.php 等辅助文件。
• plugins/：已安装的插件，例如 AISummary、MarkdownParse 等。
• uploads/：用户上传内容，按照年份/月划分（如 2026/）。

核心代码（/var）

Typecho 系统运行时代码库：

• Typecho/、Utils/、Widget/ 等子目录，包含框架核心、数据库接口、帮助函数等。
• IXR/：XML‑RPC 实现，用于远程发布。

说明

• 遇到功能问题时可根据上述结构定位相关文件。例如，

  • 一言组件在 usr/themes/HarmonyHues/components/widgets/widget-yiyan.php。
  • 本地资源应使用文件路径，而非通过 URL 访问。

• /usr/themes/HarmonyHues 主题目录包含所有与页面显示相关内容，便于定制。

• /admin 提供完整的后台管理界面。

如需进一步分析插件、数据库结构或调试， 可在这些目录中查找对应文件或脚本。

更新日志

• 2026-03-03：新增天气小部件功能。

  1. 主题 components/widgets/widget-weather.php 添加天气查询代码，支持缓存、城市和 API Key 配置。
  2. 在 components/sidebar.php 中包含天气组件。
  3. core/theme-config.php 增加 ShowSidebarWeather 选项以及 weatherCity、weatherApiKey 配置项。
  4. 风格与一言组件一致；请输入有效 API Key 并在后台启用侧边栏“天气”模块。
  5. 修改前已通过 tar 备份主题文件，备份包位于 usr/themes/HarmonyHues-backup-2026-03-03.tar.gz。

• 更详细的实现步骤及说明可参考在其它聊天记录的说明。

• 2026-03-03（续）：天气模块进一步增强。

  • 缓存结构升级，城市改变后立即生效并在后台保存查询城市。
  • 城市名称支持中英文互译，常见城市输入英文也能显示中文名。
  • 显示中文描述保持不变，增加体感温度、湿度、气压、风速/风向等信息。
  • 加入 OpenWeatherMap 图标，优化字体、行高、布局与对齐，使输出居中且更协调。
  • 注释和调试输出更详细，方便开发者阅读与排查。

• 2026-03-21：切换默认天气接口为和风天气（QWeather）。

  • 为提高国内访问稳定性，主题已将默认天气请求改为使用和风天气（QWeather）API（v7 now）。
  • 请到 https://dev.qweather.com/ 注册并获取 API Key，然后在后台主题设置的“天气 API Key”项中填写。
  • 如果暂时不希望调用网络天气接口，可在后台关闭侧边栏“天气”模块以加速页面加载。

  注意：和风天气已启用 API Host 功能，公共域名（如 devapi.qweather.com）将逐步停止服务。如果你在控制台配置了 API Host，请在主题设置的“天气 API Host”中填写你的 Host（例如：p66mtfux4j.re.qweatherapi.com）。

注意事项

• 请使用 有效的天气 API Key。推荐使用和风天气（QWeather）；获取与使用请参考：https://dev.qweather.com/ 。
• 如果你更倾向于无需注册的快速方案，可使用 tianqiapi.com 作为备用接口，但稳定性与功能可能有限。
• 错误信息会在侧边栏以注释或文本形式显示，便于调试。