路径：usr/themes/joe-master/public/common.php
目标：兼容 1.3 下不同伪静态/路径来源导致的路由判断问题，并补齐 ?user=login/register/retrieve 登录入口。
关键改动示例：

1:新增路径归一化，并从多来源获取 path（含剥离 /index.php 前缀）：

$normalize_path = function ($path) {
    if (!is_string($path) || $path === '') return '';
    $path = explode('?', $path, 2)[0];
    if ($path === '') $path = '/';
    if ($path[0] !== '/') $path = '/' . $path;
    if (str_starts_with($path, '/index.php')) $path = substr($path, strlen('/index.php'));
    if ($path === '') $path = '/';
    return $path;
};

$path_list = [];
$path_list[] = $normalize_path($self->request->getPathInfo());
$path_list[] = $normalize_path($self->request->getRequestUri());
foreach (['REQUEST_URI', 'PATH_INFO', 'ORIG_PATH_INFO', 'REDIRECT_URL', 'REDIRECT_URI'] as $k) {
    $path_list[] = $normalize_path($_SERVER[$k] ?? '');
}
$path_list = array_values(array_unique(array_filter($path_list, function ($v) {
    return $v !== '';
})));

2：新增 ?user=login 等 Query 入口（兼容 1.3）：

if (Helper::options()->JUser_Switch == 'on') {
    $user_action = $_GET['user'] ?? null;
    if (is_string($user_action)) {
        if ($user_action === 'login') {
            $self->response->setStatus(200);
            $self->setThemeFile('module/user/login.php');
        }
        // register / retrieve 同理
    }
}

{/collapse-item}

路径：usr/themes/joe-master/public/function.php
目标：放开 Typecho 1.3 版本限制；补齐 joe 主题所需路由；修复 1.3 下登录/注册链接生成。
关键改动示例：

1：放开版本限制（允许 >= 1.2）并在 install() 里触发路由自修复：

function install()
{
    if (PHP_VERSION < 8) throw new \Typecho\Exception('请使用 PHP 8 及以上版本！');
    if (version_compare(\Typecho\Common::VERSION, '1.2', '<')) throw new \Typecho\Exception('请使用 Typecho 1.2 及以上版本！');
    ensure_routing_table_for_joe();
    // ...
}

2：新增 ensure_routing_table_for_joe()（确保 joe/api、goto、user、sitemap 路由存在）：

$routes = [
    'joe_api' => [
        'url' => '/joe/api/[route:alphaslash]',
        'widget' => 'Widget_Archive',
        'action' => 'render'
    ],
    'joe_goto' => [
        'url' => '/goto',
        'widget' => 'Widget_Archive',
        'action' => 'render'
    ],
    'joe_user' => [
        'url' => '/user/[action:alpha]',
        'widget' => 'Widget_Archive',
        'action' => 'render'
    ],
    'joe_sitemap' => [
        'url' => '/sitemap.xml',
        'widget' => 'Widget_Archive',
        'action' => 'render'
    ]
];
// ... 如有缺失则写回，并用 Typecho\Router\Parser 重建 routingTable[0]

3：user_url() 在 1.3+ 下改为 ?user=xxx 形式：

if (version_compare(\Typecho\Common::VERSION, '1.3.0', '>=')) {
    if (str_starts_with($url, '?referer=')) $url = '&referer=' . substr($url, 9);
    $url = \Helper::options()->index . '?user=' . $action . $url;
}

{/collapse-item}

BASE_API: `<?= joe\root_relative_link(joe\index('joe/api')) ?>/`

{/collapse-item}

路径：usr/themes/joe-master/module/head.php
问题：非 single 页面里强制访问 $this->description/$this->keywords，在 Typecho 1.3 + PHP 8 下可能触发 text 字段强类型错误，导致搜索页直接 500。
关键改动：

} else {
    // 不再触碰 $this->description / $this->keywords
    $this->header('commentReply=&antiSpam=');
}

{/collapse-item}

<span class="muted ellipsis"><?php $this->keywords(); ?></span>

{/collapse-item}

<?php $permalink = $item['permalink'] ?? \Typecho\Router::url('page', ['slug' => $item['slug']], $this->options->index); ?>
<a href="<?= joe\root_relative_link($permalink) ?>">...</a>

{/collapse-item}

<?php $permalink = $item['permalink'] ?? \Typecho\Router::url('page', ['slug' => $item['slug']], $this->options->index); ?>
<a href="<?= joe\root_relative_link($permalink) ?>">...</a>

{/collapse-item}

关键改动示例：

joe\root_relative_link($value['permalink'] ?? $value['url'] ?? '')

{/collapse-item}

<?php $this->widget('Widget\Metas\Category\Rows')->to($item); ?>

{/collapse-item}