切换到 root 用户#

1
sudo -i

更新系统和依赖#

Debian / Ubuntu：

1
apt update -y
2
apt install -y curl socat wget
3
apt-get install sudo

CentOS：

1
yum update -y
2
yum install -y curl socat

防火墙相关#

1
firewall-cmd --state                   # 查看防火墙状态
2
systemctl stop firewalld.service       # 停止防火墙
3
systemctl disable firewalld.service    # 禁止防火墙开机自启

Debian 开启原生 BBR#

1
echo "net.core.default_qdisc=fq" >> /etc/sysctl.conf
2
echo "net.ipv4.tcp_congestion_control=bbr" >> /etc/sysctl.conf
3
sysctl -p
4
sysctl net.ipv4.tcp_available_congestion_control
5
lsmod | grep bbr

查看系统信息#

1
wget -qO- bench.sh | bash

修改密码#

1
passwd

常用脚本#

1
wget -qO- --no-check-certificate https://raw.githubusercontent.com/oooldking/script/master/superbench.sh | bash

1
curl https://raw.githubusercontent.com/zhucaidan/mtr_trace/main/mtr_trace.sh | bash

1
# 国外机
2
wget https://raw.githubusercontent.com/cokemine/ServerStatus-Hotaru/master/status.sh
3

4
# 国内机
5
wget https://cokemine.coding.net/p/hotarunet/d/ServerStatus-Hotaru/git/raw/master/status.sh

面板安装#

1
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

1
wget -O install.sh http://download.moetas.com/install/install-ubuntu_6.0.sh && sudo bash install.sh

1
bash <(curl -Ls https://raw.githubusercontent.com/vaxilu/x-ui/master/install.sh)

DD 系统重装#

1
curl -fLO https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh
2
chmod a+rx debi.sh
3
sudo ./debi.sh --architecture arm64 --user root --password password
4
sudo shutdown -r now
5
# 默认密码：password

1
bash <(wget --no-check-certificate -qO- 'https://moeclub.org/attachment/LinuxShell/InstallNET.sh') -d 10 -v 64 -a
2
# 默认密码：MoeClub.org

1
bash <(wget --no-check-certificate -qO- 'https://moeclub.org/attachment/LinuxShell/InstallNET.sh') -d 11 -v 64 -a --mirror 'https://mirrors.huaweicloud.com/debian/' -p password

Docker 应用#

1
docker run -dit \
2
  --name QL \
3
  --hostname QL \
4
  --restart always \
5
  -p 5777:5777 \
6
  -v $PWD/QL/config:/ql/config \
7
  -v $PWD/QL/log:/ql/log \
8
  -v $PWD/QL/db:/ql/db \
9
  -v $PWD/QL/scripts:/ql/scripts \
10
  -v $PWD/QL/jbot:/ql/jbot \
11
  whyour/qinglong:latest

其他#

1
sudo -i
2
systemctl stop tat_agent
3
systemctl disable tat_agent
4
/usr/local/qcloud/stargate/admin/uninstall.sh
5
/usr/local/qcloud/YunJing/uninst.sh
6
/usr/local/qcloud/monitor/barad/admin/uninstall.sh
7
rm -f /etc/systemd/system/tat_agent.service
8
rm -rf /usr/local/qcloud
9
rm -rf /usr/local/sa
10
rm -rf /usr/local/agenttools
11
process=(sap100 secu-tcs-agent sgagent64 barad_agent agent agentPlugInD pvdriver)
12
for i in ${process[@]}
13
do
14
  for A in $(ps aux | grep $i | grep -v grep | awk '{print $2}')
15
  do
16
    kill -9 $A
17
  done
18
done

它到底做了什么#

流程很简单：先把电视上每个应用的状态和默认桌面记下来，然后用 pm disable-user 停掉列表里的应用，最后编译安装它自己的桌面，设成默认主屏幕。

我觉得最关键的是第二步用”停用”而没用”卸载”。系统应用还在，只是不跑了，想要回来随时能启用。项目自带的 tools/restore.sh 会照着第一步的记录，把应用一个个恢复。

停用列表是按机型整理的纯文本。拿小米电视 4A 那份来看，一共 42 行，按用途分了组：

1
# Xiaomi telemetry
2
com.miui.tv.analytics
3
com.xiaomi.statistic
4

5
# PatchWall and Mi content rows / promos
6
com.mitv.tvhome.atv
7
com.mitv.tvhome.michannel
8
...
9
com.xiaomi.mitv.updateservice          # re-enable to check for firmware updates

开头两行是小米的数据统计，接着是 PatchWall 桌面的推荐内容。系统更新服务也在里面，注释写着想检查固件更新时再打开。哪一行不想停，前面加个 # 就行。

最特别的地方：让 AI 助手来操作#

这个项目推荐的用法，是把活交给 Claude Code、Codex、Gemini CLI 这类能跑终端命令的编程助手。

仓库里有一份 PROMPT.md，是写给 AI 助手的完整操作说明。你把它发给助手，填上电视型号，助手会先在局域网里找到电视、用 ADB 连上，动手前备份应用列表和系统设置。然后它会问你平时看哪些应用、要不要留着语音助手和投屏，再照你的回答去停用，每做一步都从电视上截一张图确认。最后编译桌面、装上、设成默认。

仓库根目录还放着 CLAUDE.md、AGENTS.md、GEMINI.md，分别写给不同的助手。可以看出作者一开始就打算让人只管回答问题，具体操作交给 AI。

我觉得这个思路挺对路。每台电视的预装应用都不一样，同一个牌子换个固件，包名也会变，很难写出一个通吃的脚本。让助手现场看、现场判断，反而更靠谱。说明里还专门交代助手优先用仓库里的 tools/disable.sh，别自己另写，因为备份和保护默认桌面的逻辑都在这个脚本里。

不过让 AI 在电视上执行命令，我还是会盯着它每一步在干什么，尤其是它要停用一个你没听说过的系统组件时。

支持哪些电视#

只支持 Android TV 和 Google TV。三星 Tizen、LG webOS、Roku 都不是安卓，用不了。Fire TV 只能参考它的清单自己手动弄。

examples/ 目录里有 443 个机型的停用列表，都是社区拿真机验证后提交的。我数了一下国内常见的牌子：

收录得多，不代表一定能用。README 特意提醒，部分国行电视会拒绝装第三方 APK，或者不让换默认桌面，TCL 就有这样的型号。这种电视还能停掉广告和预装应用，新桌面就未必装得上了。具体要看型号和固件，光看牌子判断不了。

另外，桌面要求 Android 8.0 以上。有些老电视在清单里，系统版本却不够，桌面一样装不了。

换上的桌面长什么样#

深色背景，底部一排常用应用，默认 4 个。焦点移到哪个应用上，就显示它的名字，背景颜色也跟着这个应用的横幅或图标变。往下按是更多应用，每行可以放 4 到 7 个。

用遥控器就能调整顺序：长按设置按钮进入排序模式，方向键挪位置。仓库里有 21 套主题，换颜色、壁纸、列数都不用重新编译。还有 30 多个扩展卡片，天气、世界时钟、睡眠定时、蓝牙开关都有，别的应用想往桌面上放卡片，得你点头才会出现。电视的屏保设置里也能选它自带的时钟屏保。

界面有简体中文，跟着系统语言走。

门槛在于仓库没有现成的 APK，桌面得在自己电脑上编译，要装 JDK 17 和 Android SDK。用 AI 助手的话，这一步也可以让它代劳。

动手前要注意什么#

用完一定要把调试关掉。这个项目走的是网络 ADB，默认 5555 端口，连接是明文的，有些电视固件甚至不检查授权。调试一直开着，同一个网络里的任何设备都可能控制你的电视。

停用也可能停出问题。东西虽然没删，停错了照样出故障。README 里记了一个例子：Google TV 停掉原桌面后，系统的设置向导可能会占掉主屏幕。稳妥的做法是分批停，每停一批就重启看看，遥控器、输入源切换、常用应用都正常再继续。

很多停用列表会关掉厂商的系统更新服务，所以之后想升级固件，得先把它重新打开。

还有个容易踩的坑：PROMPT.md 里提到，有些电视盒子开了 USB 调试会切断 USB 口供电，插在上面的 U 盘、音箱、USB 网卡都会失灵。如果你的电视靠 USB 网卡上网，最好一口气做完，别分两次。

上手步骤#

有两种用法，交给 AI 助手，或者自己敲命令。电视这边的准备工作是一样的。

1
git clone https://github.com/Gathin23/cleanyourtv
2
cd cleanyourtv
3
claude   # 或者 codex、gemini

1
python3 -m venv tools/venv
2
tools/venv/bin/pip install -r tools/requirements.txt
3
export TV_HOST=192.168.1.50
4

5
# 读取型号、Android 版本和固件
6
tools/venv/bin/python -I tools/tv.py --probe
7

8
# 列出已安装的应用
9
tools/venv/bin/python -I tools/tv.py 'pm list packages'

1
tools/disable.sh examples/你的机型/debloat.txt

1
brew install openjdk@17 android-commandlinetools
2
sdkmanager "platforms;android-34" "build-tools;34.0.0"

1
TV_HOST=192.168.1.50 launcher/build-and-install.sh

1
TV_HOST=192.168.1.50 STOCK_LAUNCHER=none launcher/build-and-install.sh

1
TV_HOST=192.168.1.50 tools/theme.sh themes/aurora    # 换主题
2
TV_HOST=192.168.1.50 tools/theme.sh --reset          # 恢复默认

1
TV_HOST=192.168.1.50 tools/restore.sh examples/你的机型/debloat.txt

最后#

如果你的电视是安卓系统，开机广告和推荐内容让你烦，又不想刷机，可以先去 examples/ 里搜一下自己的型号。有收录的话，读完那个目录里的说明和已知问题再动手。没收录也能用，助手会现场检查你的电视，只是要多花点时间确认哪些能停、哪些不能停。

一、环境准备#

Firefly 基于 Astro 7，对版本要求比较新：

• Node.js 22 或更高（准确地说是 22.23 以上）
• pnpm 11 或更高，项目里有脚本强制只能用 pnpm 装依赖
• Git

1
node -v      # 低于 v22 需要升级
2
pnpm -v      # 没装就 npm install -g pnpm
3
git --version

macOS 可以用 Homebrew 装 Node：

1
brew install node

编辑器推荐 VS Code，装上 Astro 官方扩展，.astro 文件才有高亮和提示。

二、创建项目#

Firefly 不走 pnpm create astro，直接克隆仓库。建议先在 GitHub 上 Fork 一份到自己账号下，再克隆自己的那份，以后部署和同步更新都方便：

1
git clone https://github.com/<你的用户名>/Firefly.git my-blog
2
cd my-blog
3
pnpm install
4
pnpm dev

打开 http://localhost:4321 就能看到演示站了。

三、项目结构#

只列出平时会动到的部分：

1
my-blog/
2
├── astro.config.mjs        # Astro 配置：插件、Markdown、sitemap 等
3
├── src/
4
│   ├── config/             # 站点配置，按功能拆成很多个文件
5
│   ├── content/
6
│   │   ├── posts/          # 文章
7
│   │   └── spec/           # 关于页、友链页、留言板的正文
8
│   ├── assets/images/      # 头像、壁纸等，构建时会自动压缩
9
│   └── layouts/            # 页面布局，加统计代码、站长验证在这里
10
└── public/                 # 原样复制的静态文件，favicon 放这里

Firefly 的配置没有塞进一个大文件，而是拆在 src/config/ 下，最常改的几个：

四、改成你自己的站#

1
export const siteConfig: SiteConfig = {
2
  title: "七号研习社",
3
  subtitle: "记录技术、生活与思考",
4
  site_url: "https://llxx.cc",
5
  description: "777 的个人博客，记录技术、生活与思考。",
6
  timezone: "Asia/Bangkok",
7
  // ...
8
};

1
const pages = resolvePageToggles({
2
  friends: true,
3
  guestbook: false,
4
  dynamic: false,
5
  projects: false,
6
  gallery: false,
7
  booknav: false,
8
  sponsor: false,
9
  // ...
10
});

五、写文章#

文章放在 src/content/posts/ 下，子目录会原样变成网址的一部分。我按年月放：

1
src/content/posts/
2
└── 2026/
3
    └── 11/
4
        ├── astro-blog-setup-guide.md
5
        └── img/
6
            └── screenshot.png

这篇文章的地址就是 /posts/2026/11/astro-blog-setup-guide/。图片放在旁边的 img/ 里，正文用相对路径 ![说明](./img/screenshot.png) 引用，构建时会自动转成 WebP。

frontmatter 长这样：

1
---
2
title: Hello World
3
published: 2026-11-04T12:00:00.000Z
4
description: 我的第一篇博客文章。
5
category: 技术
6
tags:
7
  - Astro
8
author: "777"
9
pinned: false
10
draft: false
11
---

几个字段说明：

• category 只能填一个，tags 可以填多个。首页顶部的分类栏就是按 category 统计的
• pinned: true 会把文章置顶
• draft: true 是草稿，本地 pnpm dev 能看到，正式构建时会被排除
• updated 填最后修改时间，超过一定天数文章底部会提示”上次编辑于……”

也可以用脚本建文章，它会帮你生成 frontmatter：

1
pnpm new-post 2026/11/hello-world

六、Markdown 扩展#

除了标准 Markdown，Firefly 还多了几样常用的。

提醒块，用的是 GitHub 的写法：

1
> [!NOTE]
2
> 普通提示。
3

4
> [!WARNING]
5
> 需要注意的地方。

可选的还有 TIP、IMPORTANT、CAUTION。上面那两个黄框就是这么写出来的。

GitHub 仓库卡片，一行就能插入一个带 Star 数的卡片：

1
::github{repo="CuteLeaf/Firefly"}

代码块用的是 Expressive Code，自带复制按钮和语言标识，超过 15 行的代码默认折叠。代码块里要再嵌一个代码块时，外层改用 ~~~ 包起来就行：

1
```bash
2
echo "Hello from my blog!"
3
```

七、搜索、RSS 和 sitemap#

这三样 Firefly 都配好了，不用另外装：

• 搜索：Pagefind。pnpm build 的最后一步会扫描生成好的 HTML，在 dist/pagefind/ 里生成索引，搜索完全在浏览器里完成，不需要服务器
• RSS / Atom：/rss.xml 和 /atom.xml
• sitemap：/sitemap-index.xml。在 pages 里关掉的页面会自动排除，其他想排除的页面可以在 astro.config.mjs 的 sitemap({ filter }) 里加规则

八、加统计和站长验证#

Google Analytics、Umami、Microsoft Clarity 在 src/config/analyticsConfig.ts 里填 ID 就行。

不在列表里的代码，比如 Google AdSense 的站点验证，直接加到 src/layouts/Layout.astro 的 <head> 里：

1
<head>
2
  <meta charset="UTF-8" />
3
  <meta name="google-adsense-account" content="ca-pub-xxxxxxxxxxxxxxxx" />
4
  ...
5
</head>

九、部署上线#

先在本地完整构建一次，确认没有报错：

1
pnpm build     # 输出到 dist/
2
pnpm preview   # 在 localhost:4321 预览构建结果

1
FROM node:lts AS base
2
WORKDIR /app
3
RUN corepack enable && corepack prepare pnpm@latest --activate
4

5
COPY package.json pnpm-lock.yaml ./
6
RUN pnpm install --frozen-lockfile
7

8
COPY . .
9
RUN pnpm run build
10

11
FROM nginx:mainline-alpine-slim
12
COPY --from=base /app/dist /usr/share/nginx/html
13
EXPOSE 80

1
docker build -t my-blog .
2
docker run -d -p 80:80 --restart unless-stopped my-blog

十、从 AstroPaper 迁移过来要注意什么#

如果你和我一样是从别的 Astro 主题换过来的，这几件事要留意：

1. frontmatter 字段名不一样。AstroPaper 的 pubDatetime、modDatetime、featured、ogImage，在 Firefly 里分别是 published、updated、pinned、image，另外多了一个 category。文章多的话写个小脚本批量替换，正文不要动
2. 文章目录换了。从 src/data/blog/ 挪到 src/content/posts/，子目录结构保持不变的话，文章网址也不会变，搜索引擎收录和别人引用的链接都不会失效
3. 演示内容很多。看板娘模型、音乐播放器、示例公告、作者自己的友链和打赏链接，都要手动关掉或删掉。光 public/pio/ 里的看板娘模型就有 15 MB，不用的话直接删
4. 评论数据和路径绑定。Twikoo 这类评论系统按页面路径存评论，路径一变，旧评论就对不上了

日常写作流程#

搭好以后，平时写文章就是：

1. pnpm new-post 2026/11/文章名 新建文件
2. 填好 frontmatter，写正文
3. pnpm dev 本地看效果
4. 提交、push，等自动部署

搭博客本身花不了多少时间，花时间的是把演示站的东西一点点换成自己的，还有之后能不能坚持写下去。