# Luma Tabs

任务优先的 Chrome 标签管理器：阻止精确重复标签，用最近优先和模糊匹配找回页面，并把长期工作现场保存成可继续的任务。

![Luma Tabs 任务工作现场](docs/media/luma-tabs-demo-poster.png)

## 下载

- [下载仅扩展程序版本](https://github.com/844587244-rgb/luma-tabs/releases/latest/download/luma-tabs-0.1.0.zip)
- [下载扩展 + Agent Companion 总包](https://github.com/844587244-rgb/luma-tabs/releases/latest/download/luma-tabs-beta-0.1.0.zip)
- [查看最新版本说明](https://github.com/844587244-rgb/luma-tabs/releases/latest)

当前为 `0.1.0-beta` 测试版，使用 Chrome 开发者模式加载，暂不支持自动更新。

## 核心能力

- 重复标签路由：新打开精确重复页面时，自动回到已打开标签。
- 最近优先搜索：统一搜索已打开、最近关闭、历史、书签和任务资料。
- 中文模糊召回：支持标题、网址、拼音、首字母、轻微错字和乱序关键词。
- 任务工作现场：保存网页或本地原型，一键恢复并投影为 Chrome 原生标签组。
- 分组联动：标签拖入任务对应的 Chrome 分组后自动加入任务，从任务移除时同步退出分组。
- 同屏添加：任务和已打开标签上下排列，默认最近优先，也可按标题排序并直接加入当前任务。
- Agent 连接：可选通过本机 Companion 让 Codex、Claude Code 等 MCP Client 操作任务。

## 只安装 Chrome 扩展

1. 下载并解压 `luma-tabs-0.1.0.zip`。
2. 在 Chrome 打开 `chrome://extensions`。
3. 开启“开发者模式”，点击“加载已解压的扩展程序”。
4. 选择根目录中含有 `manifest.json` 的文件夹。
5. 点击 Luma 图标打开侧边栏。

如需保存 `file://` 本地原型，在 Chrome 提示时允许文件网址访问；也可在扩展详情中开启“允许访问文件网址”。

## 启用 Agent

Agent 功能需要 Node.js 18 或更高版本。先安装 Chrome 扩展，再下载总包并安装 Companion：

```bash
npm install -g "/absolute/path/luma-tabs-agent-0.1.0.tgz"
luma install-host
```

Codex：

```bash
codex mcp add luma-tabs -- luma mcp
```

Claude Code：

```bash
claude mcp add --transport stdio --scope user luma-tabs -- luma mcp
```

重新加载 Luma，在“更多 -> 设置 -> Agent 连接”中开启“允许 Agent 操作 Luma”，然后重启 Agent。完整步骤见 [测试版安装说明](docs/beta-install-guide.md)。

## 本地开发

```bash
npm install
npm run check
npm run test:extension
```

构建后在 `chrome://extensions` 加载项目中的 `dist` 目录。视觉预览可运行：

```bash
npm run dev
```

## 隐私

Luma 本地处理标签、任务和搜索数据，不读取网页正文，不注入内容脚本，不申请 `<all_urls>`，也不包含广告或分析 SDK。历史、书签、标签组和 Agent 连接均使用可选权限。详见 [隐私说明](docs/privacy-policy.md)。

## 反馈

- 功能问题与建议：[提交 Issue](https://github.com/844587244-rgb/luma-tabs/issues)
- 安全问题：使用 GitHub Security Advisory 私下报告，不要公开敏感细节。

## License

[MIT](LICENSE)