夜雨聆风学习资料网

ARTICLE · 1129039

Sharp AI 时间线过滤器上手教程

发布时间：2026-10-06 00:09:11 最近访问：2026-10-06 00:09:11
Sharp AI 时间线过滤器上手教程

极客深潜录 · HANDS-ON TUTORIAL

Sharp AI 时间线过滤器上手教程

从零跑通 Sharp：环境准备 → 安装 → 跑通核心流程 → 进阶实战 → 调试与常见问题 → 最佳实践，全流程动手实战。

CHAPTER 01

环境准备与安装

最省事的路是直接从 Chrome Web Store 或 Firefox Add-ons 安装；想改源码、加功能或参与开发，则走 Bun 构建路线。两条路本章都讲清楚。

1.1 商店安装（推荐）

浏览器安装源版本要求
Chrome / Chromium
Chrome Web Store
无特殊要求
Firefox
Firefox Add-ons
Firefox 140 或更新
开发版
源码 + Bun 构建
Bun ≥ 1.3.10

1.2 源码构建环境要求

项目要求说明
Bun
≥ 1.3.10
包管理 + 构建，package.json 指定 packageManager
Git
任意
拉取源码
浏览器
Chrome / Firefox
用于加载 unpacked / 临时插件

1.3 克隆并构建

terminal — install
$ git clone https://github.com/tshmieldev/sharp$ cd sharp && bun installbun install v1.3.10# Chrome 版构建$ bun run buildBuilt for Chrome ✓# Firefox 版构建$ bun run build:firefoxBuilt for Firefox → firefox/

1.4 加载到浏览器

浏览器操作路径选择目标
Chrome
chrome://extensions → 开发者模式 → Load unpacked
仓库根目录
Firefox
about:debugging → This Firefox → Load Temporary Add-on
firefox/manifest.json

[WARNING] Firefox 开发提醒

临时加载的 add-on 重启浏览器后即失效，仅用于开发调试；日常使用请装 Firefox Add-ons 正式版。Firefox 按域名逐个授权站点，若提示无权限，用 Sharp 设置里的 Grant access 授权并刷新已开标签页。

CHAPTER 02

跑通核心流程

装好后三步配置即可生效：贴 key → 写过滤规则 → 开 X 看效果。全程 3 分钟。

2.1 配置 API key（General › AI）

OpenRouter 是最快的起点：一个 key 同时覆盖分类器打分与图片描述，按量小额充值即可。Vercel AI Gateway 或 TypeSafe AI 的 key 也可以。

配置步骤（图形界面）
1. 打开 Sharp 设置 → General → AI2. Provider 选 OpenRouter（或其他）3. 粘贴 API key → Save4. 分类器默认选中；Browse 可浏览模型目录

2.2 写过滤规则（X › Filtering）

用自然语言描述「想过滤什么」或「只想看什么」，Apply 后立即生效。

示例规则效果
Hide engagement bait
隐藏求赞、求关注、钩子式互动贴
Only keep software engineering
只保留软件工程相关内容
Hide crypto shilling
过滤加密圈喊单贴

2.3 打开 X 验证

x.com — scrolling
1. 打开 x.com 首页2. 滚动 feed，帖子先占位后出结论3. 被过滤的帖子折叠进 Hidden 行4. ⌥⇧F 开关过滤 · ⌥⇧T 免过滤看全楼

[TIP] 实践建议

第一轮先把阈值滑块放「激进」，观察哪些帖子被折叠、哪些被误判，再慢慢放窄——用 Teach it 把误判纠正给模型。

CHAPTER 03

进阶配置

跑通核心过滤后，把模型、阈值、作者规则、图像策略调到你的口味。

3.1 X › Advanced 参数

参数默认说明
Hide from
0.7
打分低于此阈值的帖子开始隐藏
Sure from
0.9
高于此阈值直接判定，跳过横幅
Close-call margin
0.1
阈值附近的帖子显示半透明横幅，可手动放行
Image description
auto
仅在文本存疑时调用图片描述

3.2 聊天模型切换

默认分类器只给分数；想要「为什么隐藏」的书面理由，切到聊天模型：OpenRouter / OpenAI / Anthropic / 任意 OpenAI 兼容端点。模型库在 General › AI › Browse 里按人气、价格、上下文、延迟排序。

设置路径
General → AI → 选择「聊天模型」Provider：OpenRouter / OpenAI / Anthropic / OpenAI-compatibleBrowse 浏览模型：人气 / 价格 / 上下文 / 实测延迟X → Advanced → 指定哪些帖子用聊天模型

3.3 Per-author 与 Blocked words

功能用法
Per-author 规则
帖子 ⋯ 菜单里「Never filter this author」/「Always hide」
Blocked words
设置里维护黑名单词，命中直接过滤，不经过模型，零成本

[INFO] 配置说明

Blocked words 与 per-author 规则在模型前执行，不花一分钱、不占上下文；自然语言指令才走模型。两者叠加使用，成本与准确率兼得。

CHAPTER 04

进阶实战

把 Teach it、YouTube 静音、灰度模式组合起来，搭一个「低干扰信息流」工作区。

4.1 Teach it：把误判教给模型

1

标记误判

被误过滤的帖子点「Wrong call」；想批量隐藏同类的用「Hide posts like this」。

2

样本进上下文

最近纠正的样本会被带进模型上下文，作为 few-shot 示例，越用越贴你的口味。

3

Teach X too（可选）

开启后，对隐藏的帖子主动告诉 X「Not interested」，让平台算法跟着学。这是唯一代表你行动的功能，隐私政策有说明。

4.2 YouTube 静音模式

不需要模型也能大幅降低干扰：隐藏 Shorts、隐藏评论、缩略图选择显示/模糊/移除，时长信息保留。移动站同样生效。

场景一：专注阅读 X

分类器 + 灰度 + Thread 逃生口：信息流干净但想深读随时进。

场景二：低干扰看 YouTube

隐藏 Shorts + 模糊缩略图 + 隐藏评论区，只留时长与标题。

CHAPTER 05

调试与常见问题

跑通基础流程后，本节给出常见问题排查表与调试技巧。

5.1 常见问题排查

问题原因与解决方案
Firefox 提示无站点权限
Firefox 按域名授权。打开 Sharp 设置用 Grant access，或重新加载插件后刷新 x.com / youtube.com / 供应商页面。
帖子一直占位不显示
供应商请求失败。重试 3 次后帖子会直接放行，不会永久空白；检查 key 是否有效、额度是否用尽。
临时 add-on 重启消失
Firefox 临时加载只存在当前会话；改用 Firefox Add-ons 正式版。
过滤过猛 / 过松
调 Hide from / Sure from 滑块；close-call 横幅里的帖子可手动放行。
模型无响应
打开 Debug mode 看请求/响应体与耗时，确认 provider 配置与 key 权限。

5.2 调试技巧

1

用 Debug mode 看全链路

任意已判帖子打开详情：发给模型什么、返回什么、每步耗时。

2

开发者工具查扩展

chrome://extensions 的 service worker 面板看 console；bun run dev 支持 watch 热重建。

[WARNING] 隐私提醒

Sharp 无账号无服务器，key 只在本机；唯一代表你行动的是 Teach X too。敏感 X 账号（如工作号）建议谨慎开启该开关，并了解隐私政策中的具体行为。

CHAPTER 06

最佳实践

把 Sharp 用出效果的最后一步——核心实践建议。

1

用分类器当默认

快、便宜、带置信度；只有需要书面理由的帖子再切聊天模型，别把所有请求都走贵模型。

2

规则优先于模型

能写进 Blocked words / Per-author 的，不要浪费模型调用；模型只处理语义模糊的部分。

3

持续 Teach it

每周花几分钟纠错，模型越来越贴你的口味——这是扩展最被低估的机制。

➤ 实践总结

从商店安装或 Bun 构建，到贴 key、写规则、滑阈值，再到 Teach it 与 YouTube 静音——Sharp 的完整闭环是：装好 → 一句话规则 → 阈值微调 → 纠错喂养 → 沉浸使用。时间线是你的，标准也是你的。

极客深潜录 · HANDS-ON TUTORIAL

sharp 项目实践教程 · 2026

相关学习资料