配置字典:About

$ 发布 2026-11-13 | | 更新 2026-11-13
语境: 以实际代码查阅 About 的内容、文案、工具与效果配置,标明默认值、限制和当前未使用的旧字段。

个人介绍、联系方式、工具面板与 Hacker 终端。


输出
词 3.8k 令牌 5.0k

想先替换自己的介绍,读页面与功能定制教程;配置文件位置与安装见第一篇教程。其他模块从配置字典总入口进入。

About 不从某篇 Markdown 文章读取正文。内容写在 src/site.config.ts 的 i18n.locales.<语言>.about 中;页面和章节标题则在同一语言的 messages.about 中。以下列出主题包默认值,不能把 demo 的个人介绍当成默认值。

theme.enableAboutPage:页面开关

  • 类型 / 默认值: boolean / true。
  • 状态与作用: 生效。开启时为启用语言生成 /<语言>/about/;关闭时不生成标准 About 页面,相应公共导航和 Contact 入口也不再提供 About 目标。
  • 限制: 不是隐藏某一段正文的开关,不删除内容配置。直接访问已关闭页面不会自动跳转到首页。修改后需重新构建部署;关闭也不能作为删除旧部署文件或已公开数据的保证。
  • 示例: theme: { enableAboutPage: false }。

About 内容与工具字段

以下表格的完整前缀均为 i18n.locales.<语言>.about.。例如 sections.who 的完整路径是 i18n.locales.zh.about.sections.who。类型是合并前允许覆盖的字段类型,均可省略;省略后通过语言回退和主题默认配置补齐。当前 zh / en 的 about 默认内容均来自同一套英文占位配置,所以下表对两者使用同一个默认值。其他语言可能有独立翻译,不应照搬这些英文默认值推断。

字符串字段没有通用长度或 URL 格式校验;应按用途填写短文案、有效邮箱或链接。数组必须填写 string[],覆盖时整组替换,不逐项合并。空字符串不是通用的“关闭”方式,具体行为见每行。表中示例是该字段的值,需要放入对应对象层级。

正文

字段 类型 zh / en 默认值 状态、作用与限制 示例值
metaLine string "$ profile booted | mode: builder" 生效;标题上方状态行,空字符串隐藏这一行 "profile ready"
sections.who string "Write a short introduction about yourself, your background, and your primary focus areas." 生效;Who 段落正文,不修改章节标题 "我是一名前端开发者。"
sections.what string "Describe what you build, your core skills, and the kinds of projects you want to be known for." 生效;What 段落正文 "我在构建个人博客与开源工具。"
sections.ethos string[] 见数组默认值中的 sections.ethos 生效;每个数组元素是一项原则;空数组清空条目,不隐藏章节标题 ["先保证清晰。","持续小步交付。"]
sections.now string "Share what you are currently building, shipping, or learning." 生效;Now 段落正文 "最近在学习 Astro。"
sections.contactLead string "Add a short collaboration note (for example: open to freelance, consulting, or full-time roles)." 生效;联系段落开头,与后面的引导文字及链接拼接 "欢迎交流。"
sections.signature string "> Replace with your own signature." 生效;底部引用块,同时进入虚拟 about.md "保持好奇。"

联系

字段 类型 zh / en 默认值 状态、作用与限制 示例值
contact.email string "you@example.com" 条件生效;trim 后为空则不渲染邮件链接及 contactEmailLead;链接实际使用原字符串,填写时勿加首尾空格 "hello@example.com"
contact.githubUrl string "https://github.com/yourname" 生效;联系链接地址,不受 social.links 控制;空值不会自动隐藏整个链接,建议使用完整 HTTPS 地址 "https://github.com/yourname"
contact.githubLabel string "GitHub" 生效;上述链接的可见文字,名称不限定为 GitHub "我的 GitHub"

工具入口

字段 类型 zh / en 默认值 状态、作用与限制 示例值
sidebar.dlData string "DL Data" 生效;侧栏 DL Data 按钮及无障碍名称;改名不改变功能 "数据面板"
sidebar.ai string "AI" 生效;侧栏 AI 按钮及无障碍名称 "我的工具栈"
sidebar.decryptor string "Decryptor" 生效;侧栏解码器入口;不是工具内部按钮文案 "解码工具"
sidebar.help string "Help" 生效;侧栏键盘面板入口 "键盘"
sidebar.allScripts string "All Scripts" 生效;侧栏当前语言文章目录入口 "全部文章"
scriptsPath string "/root/bash/scripts" 生效;文章目录显示路径、虚拟文件前缀及终端初始目录;不是服务器或本机磁盘路径 "/home/me/notes"

通用文案

字段 类型 zh / en 默认值 状态、作用与限制 示例值
labels.modalOutput string "Output" 当前未用于打开后的工具标题;仅提供弹窗 HTML 的初始占位,打开时被 modals 中对应 title 覆盖 "输出"
labels.modalClose string "Close" 生效;工具弹窗和正文窗口关闭控件的无障碍文案;不会关闭功能本身 "关闭"
labels.responseOutput string "Output" 生效;正文面板上方 OUTPUT 标签 "OUTPUT"
labels.contactEmailLead string "Reach me via" 条件生效;邮箱非空时显示在邮件链接前 "邮箱:"
labels.contactConnectLead string "or connect on" 生效;始终显示在联系链接前;邮箱为空也不隐藏,注意句子衔接 "也可以访问"
labels.backToTop string "Back to top" 条件生效;返回顶部按钮的提示和无障碍名称,不改变出现阈值 "回到顶部"
labels.quickAccess string "Quick access" 生效;工具侧栏导航的无障碍名称 "快捷工具"
labels.contactEmailLabel string "email" 条件生效;邮件链接的可见文字,不是邮箱地址;邮箱非空才显示 "发邮件"

工具弹窗

字段 类型 zh / en 默认值 状态、作用与限制 示例值
modals.dlData.title string "Downloading..." 条件生效;数据动画弹窗标题 "数据传输"
modals.dlData.subtitle string "Critical Data" 条件生效;数据动画弹窗内副标题;只展示动画,不下载文件 "演示数据"
modals.ai.title string "AI" 条件生效;AI 文本面板标题 "工具与工作流"
modals.ai.lines string[] 见数组默认值中的 modals.ai.lines 条件生效;按换行拼接的静态纯文字,不调用 AI;空数组产生空 pre,仍可打开面板 ["~ $ tools --list","Astro / TypeScript"]
modals.decryptor.title string "Hacker Decryptor" 条件生效;当前解码器弹窗标题,仍在使用 "本地解码工具"
modals.decryptor.header string "Calculating Hashes" 当前未使用;旧计算器正文文案,当前 DecoderForm 不读取 "计算中"
modals.decryptor.keysLabel string "keys tested" 当前未使用;不会改变当前解码器 "已尝试密钥"
modals.decryptor.currentPassphraseLabel string "Current passphrase:" 当前未使用;不会改变当前解码器 "当前口令"
modals.decryptor.masterKeyLabel string "Master key" 当前未使用;不会改变当前解码器 "主密钥"
modals.decryptor.transientKeyLabel string "Transient key" 当前未使用;不会改变当前解码器 "临时密钥"
modals.help.title string "Help" 条件生效;键盘面板标题 "键盘面板"
modals.help.statsLabel string "Stats & Achievements" 条件生效;键盘统计区标题;空字符串回退英文内置值 "输入统计"
modals.help.typedPrefix string "You typed:" 条件生效;输入计数前缀;空字符串回退英文内置值 "已输入:"
modals.help.typedSuffix string "characters" 条件生效;输入计数后缀;空字符串回退英文内置值 "个字符"
modals.allScripts.title string "/root/bash/scripts" 条件生效;文章目录弹窗标题,独立于 scriptsPath,不自动联动 "文章目录"

效果

字段 类型 zh / en 默认值 状态、作用与限制 示例值
effects.backgroundLines string[] 见数组默认值中的 effects.backgroundLines 当前标准 About 页面不展示;仅在缺少交互终端 session 的降级代码分支使用,不是背景开关 ["~ $ hello","ready"]
effects.scrollToasts.p30 string "context parsed" 条件生效;滚动进度达到 30% 时的提示;空字符串回退 context parsed "读到这里了"
effects.scrollToasts.p60 string "inference stable" 条件生效;滚动进度达到 60% 时的提示;空字符串回退 inference stable "继续探索"
effects.scrollToasts.p90 string "output finalized" 条件生效;滚动进度达到 90% 时的提示;空字符串回退 output finalized "感谢阅读"

正文字符串通过普通文本渲染,不解析 Markdown 或 HTML。段落的换行由样式保留;写 粗体、链接语法或 HTML 标签不会得到对应富文本。清空正文不自动删除章节标题和目录项;章节顺序与 who / what / ethos / now / contact 这五个锚点是固定的。

scriptsPath 建议使用以 / 开头的简短绝对虚拟目录,例如 /home/me/notes,避免换行、空字符及与文件冲突的路径。终端路径会规范化 .、.. 和重复斜杠;超过 1024 字符或含非法控制字符的路径可能使虚拟文件系统初始化失败。它既不执行系统 shell,也不读取服务器任意目录。文件来自主题生成的当前语言文章和 about.md;All Scripts 不是一个可以自定义脚本执行列表的配置。

DL Data 只是进度动画,不代表真实下载。AI 面板中的 model、latency 等默认文字也是静态展示,不是实时模型状态;请替换为真实的个人信息,或明确说明为演示。

Help 的三段统计文字由脚本拼入面板 HTML,建议只填可信的短纯文本,不把外部输入拼入配置;这三个字段的空字符串会回退到英文,而不是清空标签。其他 About 正文和 AI 行文本的渲染方式不同,不能一概认为所有配置都支持 HTML。

滚动提示按整个文档的滚动进度计算;用户开始滚动后,每个阈值在一次初始化中最多触发一次。它不是已读字数统计,也不是 AI 处理进度;没有公开的阈值或时长配置。填空字符串不会关闭提示。

三个数组的默认值

以下是 zh / en 实际使用的完整默认数组,顺序和空行均有含义;示例中替换数组会替换全部元素。

sections.ethos

[
  "Prioritize clarity before complexity.",
  "Favor maintainable systems over one-off solutions.",
  "Ship in small iterations and learn from feedback.",
  "Communicate directly and document decisions."
]

modals.ai.lines

[
  "~ $ ai --status --verbose",
  "",
  "model: anglefeint-core",
  "mode: reasoning + builder",
  "context window: 128k",
  "tools: codex / cursor / claude-code",
  "latency: 120-220ms",
  "safety: guardrails enabled",
  "",
  ">> system online",
  ">> ready for execution"
]

effects.backgroundLines

[
  "~ $ ls -la",
  "total 42",
  "drwxr-xr-x  12 user  staff   384  Jan 12  about  blog  projects",
  "drwxr-xr-x   8 user  staff   256  Jan 11  .config  .ssh  keys",
  "-rw-r--r--   1 user  staff  2048  Jan 10  README.md  .env.gpg",
  "-rwxr-xr-x   1 user  staff   512  Jan  9  deploy.sh  script",
  "~ $ cat .motd",
  ">> welcome | access granted"
]

页面标题及共用控件文案

这些字段写在 i18n.locales.<语言>.messages 下,不在 about 内容对象内。均为 string,可省略,默认使用内置当前语言文案及回退链;下表只列中文 / 英文默认值。例值按对应字段填写;改文案不会切换功能,也不会更改章节 ID。

messages.about

字段 中文 / 英文默认值 作用与限制 示例值
about.title About — Hacker Ethos / About — Hacker Ethos 条件生效:页面标题、正文 h1、正文窗口标题和虚拟 about.md 标题 "关于我"
about.description 我是谁、我在做什么,以及背后的黑客精神。 / Who I am, what I build, and the hacker ethos behind my work. 条件生效:页面元描述;不在正文标题下自动新增一段介绍 "我的经历、工作与兴趣。"
about.who 我是谁 / Who I Am 条件生效:Who 章节标题和目录项;不改正文或锚点 "我是谁"
about.what 我在构建什么 / What I Build 条件生效:What 章节标题和目录项 "我在做什么"
about.ethos 黑客精神 / Hacker Ethos 条件生效:Ethos 章节标题和目录项 "我的原则"
about.now 现在 / Now 条件生效:Now 章节标题和目录项 "最近在忙"
about.contact 联系 / Contact 条件生效:Contact 章节标题和目录项;锚点仍是 contact "联系我"
about.regenerate 重播扫描 / Replay scan 条件生效:底部重新扫描按钮的文字、提示和无障碍名称;只触发视觉扫描,不请求 AI 或重新生成正文 "重新扫描"

messages.windowControls

字段 中文 / 英文默认值 作用与限制 示例值
windowControls.collapse 折叠内容 / Collapse content 条件生效:正文窗口最小化、工具弹窗折叠的文案 "最小化"
windowControls.expand 放大窗口 / Expand window 条件生效:工具弹窗放大文案;正文窗口全屏使用 fullscreen "放大"
windowControls.restore 还原窗口 / Restore window 条件生效:窗口还原及恢复入口文案 "还原"
windowControls.fullscreen 全屏阅读 / Full screen 条件生效:正文窗口请求浏览器全屏的文案;不修改浏览器权限 "全屏"

messages.scriptFolders

字段 中文 / 英文默认值 作用与限制 示例值
scriptFolders.copyTitle 复制文章标题 / Copy article title 条件生效:All Scripts 复制文章标题按钮的提示及无障碍名称;不是复制文章全文 "复制标题"
scriptFolders.copied 标题已复制。 / Title copied. 条件生效:复制成功状态 "标题已复制"
scriptFolders.failed 无法自动复制,已选中完整标题,请手动复制。 / Copy unavailable. The full title is selected; copy it manually. 条件生效:复制失败状态;空字符串在脚本中可能回退英文提示 "复制失败,请手动复制"

一个可合并的配置示例

合并到 src/site.config.ts 现有的 defineThemeConfig({...}) 中,保留 import、export 和其他个人配置。不要在同一对象重复创建 theme 或 i18n。

theme: { enableAboutPage: true },
i18n: {
  locales: {
    zh: {
      about: {
        metaLine: '$ profile ready',
        sections: {
          who: '我是一名前端开发者。',
          what: '我在构建个人博客与开源工具。',
          ethos: ['先保证清晰。', '持续小步交付。'],
          now: '最近在学习 Astro。',
          contactLead: '欢迎交流。',
          signature: '保持好奇。',
        },
        contact: {
          email: 'hello@example.com',
          githubUrl: 'https://github.com/yourname',
          githubLabel: 'GitHub',
        },
        scriptsPath: '/home/me/notes',
        modals: {
          allScripts: { title: '文章目录' },
          ai: { lines: ['~ $ tools --list', 'Astro / TypeScript'] },
        },
      },
      messages: {
        about: { title: '关于我', description: '我的经历、工作与兴趣。' },
      },
    },
  },
},

配置以语言回退链从低优先级到高优先级递归合并,当前语言覆盖回退语言,最终有基础 About 配置补齐。数组整体替换,undefined 不覆盖已有值。只写 zh 不等于更改所有语言;启用语言与回退链见多语言教程。

关联配置与未提供的设置

  • 导航与目录: i18n.locales.<语言>.messages.nav.about 控制公共 About 入口及关闭窗口后的重新打开入口,string,默认中文“关于” / 英文“About”;例值“关于我”。messages.blog.toc 控制 About 目录的标题与无障碍名称,string,默认中文“文章目录” / 英文“On this page”;例值“本页目录”,也影响文章目录,见文章文案字典。
  • 完整解码页面: theme.enableDecoderPage 是 boolean,默认 true;如 theme: { enableDecoderPage: false } 会关闭独立 Decoder 页面及弹窗的完整工具跳转入口,不会关闭 About 内嵌解码器。内部工具字段使用 messages.decoder 和 messages.decoderPage,具体字段见Decoder 字典,不使用上面五个旧 decryptor 正文字段。
  • 终端: messages.terminal 是共用终端交互文案,不属于 about.effects.backgroundLines。终端是有界的网页虚拟文件系统;配置不能授权执行本机程序。十六项字段、占位符和未使用状态见终端字典。
  • 窗口和动画: 没有公开的 About 专属面板尺寸、默认关闭状态、正文淡入、工具隐藏、目录排序、Oracle 改名或独立关停配置。窗口状态由运行时及本地存储管理;无 JavaScript 时正文仍可阅读,工具不保证可用。正文默认直接可见,不依赖滚动观察器才显示。系统减少动态效果偏好由运行时处理,不是本文新增开关。
  • 联系方式: About 的 contact 对象与 social.links 独立。改页脚社交链接不会自动改 About 联系段落。

上表五个旧 decryptor 正文字段仍被类型接受,但当前不消费;backgroundLines 仅有降级分支,modalOutput 是初始占位,均已明确标记。不要通过修改这些字段来配置当前工具,更不需要为了匹配旧文案去改变页面实现。