edit | blame | history | raw

Taglauncher Raycast 扩展备忘

日期：2026-07-02
项目：Taglauncher
会话：Coder3
主题：Raycast 扩展备忘

用户目标

用户希望把“让 Raycast 搜索 TagLauncher 标签与备注”的方案写成需求文档，并列入计划备忘；明确今天不动手开发，以后再说。

已完成事项

  • 新增 PRD：/Users/ar/Projects/Taglauncher/src/Docs/Requirements/2026-07-02-raycast-extension-search-prd.md
  • 新增 Backlog 计划：/Users/ar/Projects/Taglauncher/src/.hermes/plans/2026-07-02-raycast-extension-search-backlog.md
  • 在项目 TODO.md 的 Todo 区登记 Backlog，明确今天不开发。
  • 补充 Raycast Store 发布前检查项：package metadata、MIT license、latest Raycast API、package-lock.json、category、512x512 PNG icon、README。

关键决策

  • 推荐方案：TagLauncher 导出本地只读 JSON 索引，Raycast Extension 读取该索引。
  • 不推荐 Raycast Extension 直接读取 TagLauncher 主数据库。
  • MVP 不承诺接入 Raycast 根搜索；先做 Raycast 内部命令 Search TagLauncher。
  • 默认不开放备注给第三方工具；需用户主动开启“允许 Raycast 搜索标签和备注”。
  • 今天不开发，只保存为 Backlog。

核心事实 / 变更快照

  • 变更对象：Raycast 集成需求状态。
  • 变更前：只有会话讨论，未形成项目需求文档。
  • 变更后：已有 PRD 和 Backlog 计划文档。
  • 范围边界：无代码实现、无 QA 脚本、无构建产物、无 DMG。
  • 事实来源：
    • /Users/ar/Projects/Taglauncher/src/Docs/Requirements/2026-07-02-raycast-extension-search-prd.md
    • /Users/ar/Projects/Taglauncher/src/.hermes/plans/2026-07-02-raycast-extension-search-backlog.md

文件变更

  • /Users/ar/Projects/Taglauncher/src/Docs/Requirements/2026-07-02-raycast-extension-search-prd.md
  • 记录目标、推荐方案、索引 schema 草案、隐私策略、验收标准、发布流程和不做范围。

  • /Users/ar/Projects/Taglauncher/src/.hermes/plans/2026-07-02-raycast-extension-search-backlog.md

  • 记录未来分阶段计划：索引导出、Raycast Extension 原型、QA / 隐私审查、Raycast Store 发布。

  • /Users/ar/Projects/Taglauncher/src/TODO.md

  • 新增 Raycast Extension Backlog 入口，链接 PRD 和计划文档。

可复用命令 / Runbook

用途：未来开发 Raycast Extension 后，本地构建和提交 Raycast Store 审核。

前置条件：

  • 已创建 Raycast Extension 项目。
  • 已完成本地开发和必要 metadata / icon / README / 截图准备。
  • 已登录 GitHub，并具备提交 Raycast 官方 raycast/extensions PR 所需环境。

设置命令：

npm run lint
npm run build
npm run publish

验证步骤：

  • npm run lint 静态检查通过。
  • npm run build 本地构建通过。
  • npm run publish 通过 GitHub 认证，并创建到 Raycast 官方 raycast/extensions 仓库的 Pull Request。
  • PR 经 Raycast 审核合并后进入 Raycast Store。

清理 / 恢复命令：

  • 本 Runbook 不修改 TagLauncher 本机状态。
  • 如发布流程生成本地临时文件，按 Raycast Extension 项目自身规则清理。

搜索关键词：Raycast Extension、Search TagLauncher、npm run build、npm run publish、raycast/extensions、Raycast Store、index.json。

未决问题

  • Raycast 搜索能力是否全部免费，还是部分能力纳入 Pro。
  • 索引刷新是即时写入还是 debounce / 批量写入。
  • 是否导出标签颜色供 Raycast accessory 展示。
  • 官网是否提供 Raycast Extension 安装说明。

后续建议

  • 未来启动开发前，先从 PRD 进入，不要直接从本会话摘要开工。
  • 先实现 TagLauncher 只读索引导出，再做 Raycast Extension 原型。