axetroy / axetroy/PromptFlow

待完成的功能清单 & 后续规划

Open
#11 0 comments 0 reactions 0 assignees View on GitHub
documentation enhancement
Dominant language
TypeScript
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## 📋 项目现状分析

根据对当前代码库的审查,以下是已实现的功能和待完成的功能清单。

---

## ✅ 已实现的功能

### 核心功能
- [x] `/prompts` 触发机制 - 在任意输入框输入触发词打开面板
- [x] Prompt 面板 UI - 浮动面板显示 Prompt 列表
- [x] Prompt 插入能力 - 将选中的 Prompt 插入到输入框光标位置
- [x] 本地存储 - 使用 chrome.storage.local 持久化数据
- [x] 搜索过滤 - 实时搜索过滤 Prompt
- [x] 键盘导航 - ↑↓ 选择,Enter 确认,Esc 关闭
- [x] 多网站兼容优化 - 支持 input/textarea/contenteditable

### 设置页面
- [x] 触发命令自定义
- [x] Prompt CRUD 操作
- [x] 导入/导出功能
- [x] 默认 Prompt 管理(7 个内置 Prompt)
- [x] 重置到默认功能

### GitHub 同步
- [x] 从 GitHub 仓库同步 Prompt
- [x] 仓库管理(添加/删除/启用/禁用)
- [x] 同步状态显示

### 主题与样式
- [x] 亮色/暗色主题跟随系统设置
- [x] Shadow DOM 隔离样式

### 测试
- [x] Playwright 集成测试(12 个测试文件)
- [x] Caret 定位测试
- [x] 焦点恢复测试
- [x] 触发词检测测试
- [x] Prompt 插入测试

---

## 🔄 建议后续开发的功能

### 高优先级

#### 1. **变量插值系统** (Template Variables)
**设计文档参考**: design.md 第 4.2 节

```
用户输入: /prompts
选择 Prompt 后: Write a {tone} explanation about {topic}
系统提示用户输入: tone 和 topic 的值
最终插入: Write a professional explanation about JavaScript
```

- [x] 定义变量语法 `{variable_name}`
- [x] 实现变量解析器
- [x] 添加变量输入 UI(弹窗或内联编辑)
- [x] 支持默认值 `{variable:default_value}`
- [x] 预览功能

#### 2. **自动同步功能** (Auto Sync)
- [x] 后台定时同步 GitHub 仓库
- [x] 配置同步间隔(5min/15min/30min/1hour)
- [x] ~同步状态通知~
- [x] ~冲突处理策略~

#### 3. **Prompt 分类/标签管理增强**
- [ ] 在设置页面支持按标签筛选
- [ ] 标签颜色自定义
- [ ] 批量操作(批量启用/禁用/删除)
- [ ] 标签统计

### 中优先级

#### 4. **Prompt 导入/导出增强**
- [ ] 支持更多格式(JSON、YAML)
- [ ] 导入时合并策略(覆盖/跳过/新建)
- [ ] 导出时选择特定 Prompt
- [ ] 导入/导出预览

#### 5. **面板定位优化**
- [ ] 更好的边界检测(防止面板超出视窗)
- [ ] 可选的固定位置模式
- [ ] 面板大小记忆

#### 6. **快捷键自定义**
- [x] 自定义触发词(已有基础)
- [ ] 自定义导航快捷键
- [ ] 快捷键冲突检测

#### 7. **历史记录**
- [x] 最近使用的 Prompt
- [x] 使用频率统计
- [x] 快速访问最近使用的 Prompt

### 低优先级(未来功能)

#### 8. **Workspace/项目分组**
**设计文档参考**: design.md 第 8.2 节

```
frontend/
- React 组件开发
- CSS 样式编写
backend/
- API 设计
- 数据库查询
```

- [ ] 按项目/工作区组织 Prompt
- [ ] 切换工作区快捷键
- [ ] 工作区特定触发词

#### 9. **AI Prompt 生成**
**设计文档参考**: design.md 第 8.1 节

```
用户输入: /ai "write a react performance prompt"
系统使用 AI 自动生成 Prompt 模板
```

- [ ] AI Prompt 生成界面
- [ ] 生成结果编辑
- [ ] 保存为自定义 Prompt

#### 10. **云同步**
- [ ] 云端存储
- [ ] 多设备同步
- [ ] 同步冲突解决

#### 11. **Prompt 分享系统**
- [ ] 导出为可分享格式
- [ ] 社区 Prompt 库集成
- [ ] Prompt 评分/评论

#### 12. **浏览器兼容扩展**
- [ ] Firefox 扩展
- [ ] Edge 扩展
- [ ] Safari 扩展

---

## 📝 技术债务 & 改进

### 代码质量
- [ ] 统一 types/prompt.ts 和 src/prompts/index.ts 中的 DEFAULT_PROMPTS 导入
- [x] content.ts 中有重复的 SyncedRepo/SyncedPrompt 接口定义
- [x] 增加单元测试覆盖率
- [ ] 添加 E2E 测试

### 文档
- [ ] 完善 API 文档
- [ ] 添加贡献指南
- [ ] 添加用户使用教程

### 构建 & 发布
- [ ] 自动发布到 Chrome Web Store
- [ ] 自动发布到 Firefox Add-ons
- [ ] 版本更新日志自动生成

---

## 🏷️ Labels 建议

- enhancement
- high-priority
- good-first-issue
- documentation
- technical-debt

---

## 📅 优先级建议

1. **P0**: 变量插值系统 - 这是一个核心差异化功能
2. **P1**: 自动同步 + Prompt 管理增强
3. **P2**: 导入/导出增强 + 快捷键自定义
4. **P3**: Workspace + AI Prompt 生成
5. **P4**: 云同步 + 分享系统

---

*此 issue 由 AI 自动生成,基于代码审查和 design.md 设计文档*

Contributor guide

No contributing guide indexed for this repository

Research direction

This issue is a broad roadmap rather than a single implementation task. Start by reading design.md, then inspect the relevant entries such as types/prompt.ts, src/prompts/index.ts, and content.ts for one specific unchecked item. Before coding, narrow the scope into a separate issue with acceptance criteria and tests that define when the selected feature is done.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
developer-experience
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.