SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场listful-personal-home

listful-personal-home

办公与效率

查看项目

更新于 10-17 01:09

技能介绍

Listful Personal Home 是一个开源的 Agent Skills 工作流，目标是从一个本地 Google Chrome 配置中，创建一个私有的、可导入的 Listful Home。它需要配合兼容的本地 Agent（例如 Codex 或 Claude Code）使用，整体流程为：确定性地提取浏览器数据、由 Agent 进行整理、校验结果，最后由 Listful 现有的导入流程完成写入。

用途 该技能用于把用户日常浏览器活动转化为一份个性化的主页内容包。它通过书签的存放位置推断用户意图，并结合最近访问频率作为辅助证据，识别反复出现的浏览器工作流，最终生成 listful.content-bundle.v1 格式的 bundle。

主要能力与工作流

  1. 前置检查与授权：确认任务在本地运行；若任务托管在云端或无法访问用户的 Chrome 配置，则停止。若用户明确要求分析书签和历史，则视为本次运行的授权；否则需先告知用户将处理所选书签标题、URL、文件夹路径及最近历史记录，并在读取前征求确认。
  2. 定位技能目录并运行：python3 scripts/extract_chrome_activity.py --list-profiles，列出可用配置。若存在多个配置，询问用户使用哪一个，不根据配置内容推断身份。
  3. 提取数据：创建专用系统临时目录，默认提取 90 天活动（用户可指定其他窗口），命令示例为 python3 scripts/extract_chrome_activity.py --profile "Default" --history-days 90 --output "/absolute/private/temp/listful-chrome-activity.json"。脚本只读取 Chrome 数据。除非用户明确要求，否则不加 --include-query 或 --include-local。
  4. 检查提取结果：不把完整数据集倾倒给用户；未经用户另行授权，不访问任何提取出的 URL 或获取外部元数据。
  5. 推断工作流：以书签位置作为强意图信号、最近访问频率作为辅助证据，优先保留持久工具、参考资料、库、生成器、检查器、转换器和素材来源；排除登录、认证、结算、账户管理、临时搜索结果和一次性文章页面。
  6. 生成 bundle：先阅读 references/listful-bundle.md，再生成一个增量式 bundle，顶层 lists 数组为空，个性化包装放在 collections 中。
  7. 写入与校验：将 bundle 写入一个新的 .json 文件（优先放在用户下载目录），绝不覆盖已有文件；随后运行 python3 scripts/validate_listful_bundle.py "/absolute/path/listful-personal-home-YYYY-MM-DD.json" 进行校验。
  8. 清理与交付：仅删除第 5 步创建的专用临时目录，并告知用户原始活动导出已删除，保留校验通过的 bundle；返回精确的 bundle 路径，提示用户打开 Listful，选择 Customize → Import from JSON 并选择该文件。不得直接编辑 Chrome 的 LevelDB 文件或 Listful 的 chrome.storage.local 后备文件；只有在用户明确要求导入自动化且其 Chrome 控制工具可用时，才使用 Chrome UI 控制。

整理规则

  • 在证据充分时创建 2–6 个 collections；宁可更少，也不要编造弱主题。
  • 每个 collection 创建 2–8 个 list，每个 list 4–10 个 item；Listful 列表不得超过 10 个 item。
  • 围绕重复工作流组织，而非泛化的职业标签。
  • 除非一个 URL 确实服务于两个不同工作流，否则整个 bundle 中优先只使用一次。
  • 为每个 collection、list 和 item 用用户语言编写简洁的标题或描述。
  • 每个 item 的推荐语针对该网站具体撰写，约 4–8 个英文单词或 10–15 个简体中文字符。
  • 只使用提取器生成的 HTTP(S) URL，不得编造 URL。
  • 在工作笔记中保留来源证据，但可移植 bundle 中不包含浏览计数、文件夹路径或来源字段。

适用场景 适合希望在本地、私下地将自己的 Chrome 书签与浏览习惯整理为个性化 Listful 主页的用户，尤其适合经常通过浏览器完成固定工作流、需要快速访问常用工具与参考资料的人。

限制与失败行为 当 Chrome 缺失、所选配置不明确或不存在、书签或历史无法读取、SQLite 模式不受支持、或输出无效时，必须显式失败。不得静默切换配置、缩短请求的历史窗口、替换为其他 Chromium 浏览器，或从书签与历史合并回退到单一来源。若权限阻止访问，应报告需要读取权限的确切配置路径，不要请求 Chrome 配置的写权限。