bookmark-intelligence-free

核心功能: 本技能提供、本地等能力。

书签智析基础版

把你 X(Twitter)上的书签手动转化为本地知识卡片。免费版每月可处理 10 条书签,使用关键词启发式分析(无 AI),结果落盘为本地 JSON 供后续检索.

输入定义

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

本Skill无需额外API Key（LLM能力由Agent平台内置提供）

可用性分类

• 分类: MD+EXEC（）

功能能力

1. 手动运行抓取书签

手动触发一次抓取,处理最近的 X 书签(受每月 10 条限额约束),处理后退出.

npm start

2. 关键词启发式分析

免费版不接入 AI 后端,使用关键词匹配提取摘要与基础标签。分析深度有限,适合快速浏览书签主题.

3. 本地 JSON 沉淀

每条分析结果以 JSON 落盘到 life/resources/bookmarks/bookmark-.json,包含原推文(作者、正文、互动数据)与基础分析,可被后续检索.

升级提示: 无限制书签处理、AI 深度分析(关键概念+行动项+项目关联)、后台守护进程自动监控与 Telegram 高价值洞察推送仅在 bookmark-intelligence 付费版 中提供。- 验证返回数据的完整性和格式正确性

快速熟悉

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

场景介绍

不适用于: 需要 AI 深度分析(关键概念、行动项、项目关联)的场景(需付费版),需要后台自动监控与推送的场景(需付费版守护进程),月处理量超过 10 条的场景(需付费版无限制).

使用说明

领先步:运行安装向导

cd skills/bookmark-intelligence
npm run setup

向导依次完成:检测 Node/bird、引导从浏览器提取 auth_token 与 ct0、测试凭证有效性.

第二步:手动运行处理书签

npm start

处理最近的书签(受每月 10 条限额约束),结果落盘到 life/resources/bookmarks/.

第三步:查看结果

直接打开 life/resources/bookmarks/bookmark-*.json 查看分析结果,或在终端用 jq 检索:

jq '.analysis.summary' life/resources/bookmarks/bookmark-*.json

案例展示

案例1:手动归档一批书签

场景: 你刚收藏了几条推文,想快速归档到本地. 处理过程:

1. 运行 npm start
2. 脚本抓取最近书签(本月额度内)
3. 关键词匹配生成基础分析

输出 (life/resources/bookmarks/bookmark-123.json 节选):

{
  "bookmarkId": 123,
  "tweet": { "author": "@ai_engineer", "text": "Vector embeddings for AI memory...", "likes": 342 },
  "analysis": {
    "summary": "关于 vector embeddings 与 AI memory 的推文",
    "tags": ["AI", "embedding", "memory"],
    "priority": "low"
  },
  "timestamp": "2026-07-20T10:30:00Z"
}

注意:免费版为关键词匹配,无行动项与项目关联,洞察深度有限.

异常响应

常见疑问

Q1: 免费版每月 10 条够用吗?

A: 适合先体验产品能力。如果你每周书签超过 2-3 条、希望持续自动归档,建议升级付费版解锁无限制处理与后台守护进程.

Q2: 为什么分析结果比较浅?

A: 免费版使用关键词启发式分析(无 AI),仅做主题标签与摘要匹配。AI 深度分析(关键概念、行动项、项目关联)在付费版中提供.

Q3: 能不能后台自动运行?

A: 免费版仅支持手动运行 npm start,不支持 PM2 守护进程自动监控。后台自动轮询在付费版中提供.

Q4: Cookie 安全吗?

A: 凭证仅存储在本地 .env(权限 600,已加入 .gitignore),不会离开你的机器。数据仅在调用 X 抓取书签时发送给 X,无任何第三方遥测.

使用约束

• 每月 10 条限额: 超出后停止处理,需等下月重置或升级付费版
• 无 AI 分析: 仅关键词启发式匹配,无关键概念提取与行动项生成
• 无项目关联: 不支持 contextProjects 多项目上下文匹配
• 无自动监控: 不支持 PM2 后台守护进程,需手动运行
• 无推送通知: 不支持 Telegram 高价值洞察推送
• 限频: 每小时限运行 1 次,避免触发 X 风控

---

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

想要无限制书签处理、AI 深度分析、后台守护进程自动监控与 Telegram 推送?升级至 bookmark-intelligence 付费版,把收藏夹变成行动清单.

---

创新性增强

为了提升“书签智析基础版”的创新性，我们可以引入以下改进：

• 智能推荐功能：分析用户历史书签，基于用户兴趣和趋势，提供个性化推荐。
• 集成AI生成摘要：利用AI技术，提供更准确和全面的摘要，增加深度分析能力。
• 多语言支持：支持多种语言的书签分析，扩大用户群体和适用范围。

功能完整性增强

为了完善“书签智析基础版”的功能完整性，以下内容需要补充：

• 详细输入输出格式：提供详细的输入数据格式规范和输出JSON文件字段说明。
• 具体使用场景：针对不同用户群体，详细描述具体的书签管理和知识萃取场景。
• 功能列表细化：详细列出每个功能的具体操作步骤和预期效果，包括异常处理。
• 边界条件说明：明确功能的使用限制和边界条件，如月度限额、频率限制等。

易用性增强

为了提高“书签智析基础版”的易用性，以下方面可以改进：

• FAQ/故障排除指南：提供常见问题解答和故障排除指南，帮助用户快速解决问题。
• 可视化界面：开发一个简单直观的图形界面，让用户无需命令行即可操作。
• 教程视频：制作操作教程视频，方便用户快速上手。
• 社区支持：建立用户社区，方便用户交流和分享使用经验。

用户体验增强

为了提升用户体验，以下方面可以优化：

• 交互式引导：在用户首次使用时提供交互式引导，帮助用户了解功能。
• 实时反馈：在操作过程中提供实时反馈，如进度条、成功提示等。
• 个性化设置：允许用户自定义关键词和标签，以满足个性化需求。
• 数据可视化：将分析结果以图表或图形形式展示，增强数据的可读性。

差异化优势

与同类方案对比

1. 手动操作：手动操作书签分析耗时且效率低下，需要逐个检查和整理书签信息。而“书签智析基础版”通过自动化处理，每月可处理10条书签，节省大量时间。
2. 其他工具：虽然市面上存在一些书签管理工具，但它们通常功能单一，缺乏深度分析能力。本技能结合关键词启发式分析和本地JSON沉淀，提供更全面的书签管理解决方案。
3. 通用方法：通用方法如使用文本编辑器整理书签，缺乏结构化和自动化分析，难以实现高效的知识萃取。

独特功能

1. 关键词启发式分析：通过关键词匹配提取摘要和基础标签，帮助用户快速了解书签主题。
2. 本地JSON沉淀：将分析结果以JSON格式存储，方便用户后续检索和二次利用。
3. 手动运行：用户可根据需求手动触发书签分析，灵活控制分析频率。
4. 无AI分析：避免AI分析带来的隐私担忧，同时降低分析成本。
5. 免费使用：提供免费版本，让更多用户体验和受益。

效率提升

使用“书签智析基础版”可节省大量时间，尤其在处理大量书签时。例如，每月处理10条书签，相较于手动操作，可节省至少10倍的时间。

应用场景创新

1. 知识萃取：将个人书签转化为知识卡片，方便整理和回顾。
2. 信息追踪：关注特定领域或话题，通过书签分析了解最新动态。
3. 个人学习：将学习过程中的书签进行整理和分析，提高学习效率。

功能详解与边界条件

核心功能详解

1. 手动运行抓取书签

   • 输入参数：无特定输入参数，仅需运行命令 npm start。
   • 处理逻辑：启动后，Skill会自动抓取最近的X书签，并在本地进行处理。
   • 输出结果：处理后的书签信息以JSON格式存储在本地文件夹中。

2. 关键词启发式分析

   • 输入参数：输入参数为书签内容，Skill会自动从抓取的书签中提取内容进行分析。
   • 处理逻辑：使用关键词匹配的方式提取摘要和基础标签，分析书签的主题。
   • 输出结果：分析结果包含摘要、标签和优先级等信息，并以JSON格式存储。

3. 本地 JSON 沉淀

   • 输入参数：输入参数为处理后的书签信息，Skill会自动生成JSON文件。
   • 处理逻辑：将分析结果转换为JSON格式，并存储在本地文件夹中。
   • 输出结果：生成包含书签信息、分析结果和时间的JSON文件。

边界条件

1. 输入大小限制：单个书签内容不超过5000字符。
2. 字符编码要求：输入内容必须为UTF-8编码。
3. 并发限制：同一时间只能处理一个书签分析任务。
4. 网络限制：在处理过程中，若网络连接中断，Skill将暂停操作，直到网络恢复。
5. 处理速度限制：Skill每分钟最多处理1条书签。
6. 存储空间限制：本地存储空间限制为1GB。
7. API调用限制：每月API调用次数限制为1000次。
8. 书签数量限制：免费版每月处理书签数量限制为10条。

错误处理

1. 输入内容格式错误：若输入内容格式不正确，Skill将返回错误信息，提示用户检查输入格式。
2. 网络连接中断：若网络连接中断，Skill将暂停操作，并提示用户检查网络连接。
3. 存储空间不足：若本地存储空间不足，Skill将返回错误信息，提示用户清理存储空间。
4. API调用次数超出限制：若API调用次数超出限制，Skill将暂停操作，并提示用户等待或升级至付费版。
5. 书签数量超出限制：若免费版每月处理书签数量超出限制，Skill将暂停操作，并提示用户等待下月重置或升级付费版。

性能指标

1. 处理速度：Skill每分钟最多处理1条书签。
2. 内存消耗：Skill运行时内存消耗不超过100MB。
3. CPU占用：Skill运行时CPU占用不超过20%。
4. 存储空间：本地存储空间限制为1GB。
5. API调用次数：每月API调用次数限制为1000次。

创新特色

效率提升量化分析

差异化对比

核心痛点解决

问题排查手册

安全说明

1. 确保运行环境安全，避免恶意软件感染。
2. 保护认证信息，避免泄露。
3. 定期备份本地数据，防止数据丢失。
4. 限制Skill的访问权限，防止未授权访问。
5. 避免将敏感信息存储在本地，使用加密存储方式。

安全风险防范

核心功能特性

• 自动化执行: X书签基础监控版,每月10条限额,手动运行,基于关键词启发式分析,无AI与推送。X(Twitter)书签分析与知识萃取基
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

书签智析基础版通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

问答合集

故障恢复流程

针对书签智析基础版使用中可能遇到的常见问题,提供以下排查方案:

主要特点

X(Twitter)书签分析与知识萃取基

• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果