# 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 所需环境。

设置命令：

```bash
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 原型。