Otter
VSCode 插件，用于统一管理和组织 AI Prompt，支持本地存储、Git 同步、AI 辅助生成（开发测试中）
✨ 功能特性
- 📝 选区创建 Prompt - 选中文本一键创建 Prompt，支持智能识别
# prompt: 标记和标准 Markdown H1 标题
- 🗂️ 活动栏视图 - 侧边栏浏览、搜索、管理所有 Prompt，扁平化右键菜单设计
- 📂 快速访问仓库 - 一键在系统文件管理器中打开 Prompt 存储文件夹
- 🎨 Emoji 支持 - 为 Prompt 添加 emoji 图标，快速识别
- 💾 本地存储 - JSON 格式存储，支持 Markdown 镜像
- 🔄 Git 同步 - 支持 Git 版本控制和远程备份
- 🤖 AI 辅助 - 自动生成标题、emoji、优化内容（开发中）
- 🎯 首次引导 - 友好的配置向导，快速上手
- ⚙️ 高度可配置 - 灵活的配置选项，满足不同需求
🚀 快速开始
安装
- 打开 VSCode
- 搜索扩展市场中的 "Otter"
- 点击安装
使用
1. 从选区创建 Prompt
标准方式：
- 选中文本
- 右键选择 "Otter: 从选区创建"
- 输入名称、emoji、标签
- 保存
智能识别方式（推荐）：
在选中文本的第一行添加标记：
# prompt: 🖨️ 代码审查清单
在审查代码时，请检查以下方面：
1. 代码质量
2. 安全性
3. 性能
或使用标准 Markdown H1 标题：
# 🖨️ 代码审查清单
在审查代码时，请检查以下方面：
1. 代码质量
2. 安全性
3. 性能
创建时会自动：
- 提取名称 "代码审查清单"
- 提取 emoji 🖨️
- 移除标记行
2. 活动栏管理
- 点击侧边栏 "Otter" 图标
- 单击 Prompt 复制内容
- 鼠标悬停显示快速操作按钮（复制、编辑、优化、删除）
- 右键查看更多操作
3. 命令面板搜索
- 按
Ctrl+Shift+P（Mac: Cmd+Shift+P）
- 输入 "Otter: 搜索 Prompt"
- 模糊搜索并快速复制
📖 文档
详细文档请参阅：
⚙️ 配置
存储路径
{
"otter.storagePath": "~/.otter"
}
支持的路径格式：
~/.otter - 用户主目录${workspaceFolder}/.prompts - 项目级别E:/Projects/my-prompts - 绝对路径
选区智能识别
{
"otter.selection.autoDetectPromptName": true,
"otter.selection.removePromptMarker": true
}
AI 批量（本地 CLI 合并调用）
{
"otter.ai.batchDelayMs": 500,
"otter.ai.batchChunkSize": 10,
"otter.ai.batchItemPreviewChars": 600,
"otter.ai.batchMaxPromptChars": 7000
}
🛠️ 开发
开发测试说明（给参与测试的同学）
- 当前版本处于开发/回归测试阶段，功能、命令与配置项可能会调整（尤其是 AI 相关能力）。
- 建议使用 Extension Development Host（按
F5）或独立的 VSCode Profile/测试环境进行验证，避免影响日常工作环境。
- 涉及 Git 导入/同步时请使用专门的测试仓库（或 fork），避免误提交到生产仓库；建议操作前备份存储目录。
- AI 调用可能产生费用：可先在无 Key 情况下回归“提示/回退”类用例，或优先使用本地 Provider（
local-claude / local-codex）验证流程。
- 手工回归用例：
docs/test-cases.md；批量生成功能专项：完整测试指南.md；本地 AI 调试日志：docs/DEBUG_LOGGING_SUMMARY.md。
- 反馈问题时建议附上：复现步骤、VSCode 版本/OS、相关设置片段，以及 Output 面板
Otter 日志（必要时开启 otter.git.debugLog）。
环境要求
本地开发
# 安装依赖
npm install
# 编译
npm run compile
# 监听模式
npm run watch
# 运行测试
npm test
# 打包
npm run package
调试
按 F5 启动 Extension Development Host
TODO / 待实现
- AI 辅助生成、优化等功能未在当前版本上线，相关按钮、命令、向导步骤不会显示。
- AI 配置项
otter.ai.* 及 “AI 生成标题/emoji、AI 优化内容” 等命令仍未在 package.json 注册，UI 上不可用。
- AI 消耗查看、日志统计目前未实施。
- 首次使用向导目前仅包含存储、Git 配置，AI 配置未能请求。
- Markdown 新建文件文件名询问、文末 AI 自动生成标题等设计项仍未上线。
🤝 贡献
欢迎提交 Issue 和 Pull Request！
📄 许可证
MIT
🙏 致谢
感谢所有贡献者和用户的支持！
| |
