// 1. 后台指定的自定义模板 ($this->themeFile)
// 2. 按 slug 精确匹配：page/{slug}.php   ← 关键！
if (!empty($this->archiveSlug)) {
    $themeFile = $this->archiveType . '/' . $this->archiveSlug . '.php';
    if (file_exists($this->themeDir . $themeFile)) {
        $this->themeFile = $themeFile;
        $valid = true;
    }
}
// 3. page.php
// 4. single.php（页面属于 single）
// 5. index.php

if ($this->request->is('mid')) { ... }    // 按 mid 查
if ($this->request->is('slug')) { ... }   // 按 slug 查

$tagPosts = $this->widget(
    'Widget_Archive@tag_diary',      // @别名：避免与当前页面 widget 冲突
    'type=tag&pageSize=30',          // 组件参数：type=tag 会分发到 tagHandle
    ['slug' => '日记']                // request 参数：tagHandle 从这里读 slug
);

$tagPosts = null;
try {
    $tagPosts = $this->widget('Widget_Archive@tag_diary', 'type=tag&pageSize=30', ['slug' => '日记']);
} catch (\Throwable $e) {
    $tagPosts = null;
}

<?php if (!defined('__TYPECHO_ROOT_DIR__')) exit;
$this->need('includes/header.php'); ?>
<div class="col-12" id="main" role="main">
    <article class="post post-atpage">
        <div class="post-header">
            <h1 class="post-title post-title-atpage page-title-atpage"><?php $this->title(); ?></h1>
        </div>
        <?php ob_start(); $this->content(); $pageContent = trim(ob_get_clean()); ?>
        <?php if ('' !== $pageContent): ?>
        <div class="post-content"><?php echo $pageContent; ?></div>
        <?php endif; ?>
    </article>
 
    <?php
    $tagPosts = null;
    try {
        $tagPosts = $this->widget('Widget_Archive@tag_diary', 'type=tag&pageSize=30', ['slug' => '日记']);
    } catch (\Throwable $e) { $tagPosts = null; }
    ?>
    <section class="latest-post archive-post">
    <?php if ($tagPosts && $tagPosts->have()): ?>
        <?php while ($tagPosts->next()): ?>
            <article class="post post-atmain">
                <h2 class="post-title">
                    <a href="<?php $tagPosts->permalink(); ?>"><?php $tagPosts->title(); ?></a>
                </h2>
                <ul class="post-meta">
                    <li><?php echo Matcha::date($tagPosts->created); ?></li>
                    <li><?php $tagPosts->category(','); ?></li>
                    <li><?php $tagPosts->commentsNum('0 评论', '1 评论', '%d 评论'); ?></li>
                </ul>
                <div class="post-content"><?php Matcha::excerpt($tagPosts); ?></div>
            </article>
        <?php endwhile; ?>
        <div class="page-navigator">
            <span id="previous"><?php $tagPosts->pageLink('<span class="iconfont">&#xe749;</span>'); ?></span>
            <span id="next"><?php $tagPosts->pageLink('<span class="iconfont">&#xe749;</span>', 'next'); ?></span>
        </div>
    <?php else: ?>
        <p>还没有标记为「日记」的文章。</p>
    <?php endif; ?>
    </section>
</div>
<?php $this->need('includes/footer.php'); ?>

$row = $widget->filter($row);
$arr = array(
    'title' => $row['title'],
    'permalink' => $row['permalink']   // ← 新版 Typecho 里这个键不存在了
);

protected function ___path(): string
{
    return Router::url($this->type, $this);      // $this 实现了 ParamsDelegateInterface
}
 
protected function ___permalink(): string
{
    return Common::url($this->path, $this->options->index);
}

// Matcha.php
'permalink' => $row['permalink'] ?? self::permalink($row)   // 新旧版本兼容

/**
 * 生成内容链接（兼容新版 Typecho：permalink 改为魔术属性）
 */
private static function permalink(array $row): string
{
    $delegate = new class($row) implements \Typecho\Router\ParamsDelegateInterface {
        private $row;
 
        public function __construct(array $row)
        {
            $this->row = $row;
        }
 
        public function getRouterParam(string $key): string
        {
            switch ($key) {
                case 'cid':   return (string) $this->row['cid'];
                case 'slug':  return urlencode($this->row['slug']);
                case 'year':  return date('Y', $this->row['created']);
                case 'month': return date('m', $this->row['created']);
                case 'day':   return date('j', $this->row['created']);
                default:      return '{' . $key . '}';
            }
        }
    };
 
    $path = \Typecho\Router::url($row['type'], $delegate);
 
    return \Typecho\Common::url($path, Helper::options()->index);
}