Files
SayIt/CONTRIBUTING.md
crosswk 4c7605e5f0 feat: 0.1.4 — 本地识别换代,AI 服务与设置页重做
新增
- 本地识别改用 transcribe.cpp(GGUF/ggml):可选模型从 2 个扩到 5 个
  (SenseVoice Small、Fun-ASR Nano、Qwen3-ASR 0.6B/1.7B/1.7B 高精度),
  支持 Vulkan 显卡加速并可手动切回 CPU,加载后预热一次推理,空闲可卸载
- AI 服务改为卡片式管理:一张卡一套完整配置,可测连通性与响应延迟并分档留痕
- 应用 Prompt 规则支持用户自建,含「检测当前应用」自动填进程名
- 快捷键支持 Ctrl+Win 这类纯修饰键组合,三类快捷键之间做冲突检测
- 配置导出可按需选择,导入前给出新增/更新/跳过的变更预览
- 热词组、文本替换、润色模式支持拖拽排序

变更
- 移除 sherpa-onnx:安装体积与首次响应都由新引擎接管,旧 ONNX 权重开机自动回收
- 「格式规范」仅在未开 AI 整理时生效,开启后排版交给 AI;文本替换始终生效
- 单次录音上限提前在设置页说明,最后一分钟显示剩余时间
- 全应用统一称「AI 整理」(此前有三种叫法)

修复
- 本地模式下模型未下载时仍能开始录音
- 历史记录可同时播放多条录音
- 设置页开关与选择器在读回已保存值时出现一次跳变
- 应用规则误匹配(在 Outlook 中写标题含 Teams 的邮件被 Teams 规则抢走)
- 弹窗遮罩未覆盖整个窗口

构建
- 客户端构建新增 CMake 与 Vulkan SDK 前置,README/CONTRIBUTING 已同步
- 打包随附 VC++ 运行库(app-local),并在发版前校验安装包内容

详细变更见 CHANGELOG.md。
2026-08-06 21:40:32 +08:00

1.6 KiB
Raw Permalink Blame History

贡献指南

感谢你对 SayIt 的关注!

关于 PR

本项目暂不接受 Pull Request。

整个项目都是使用 AI(Claude Opus 4.6)开发的,PR 现在大概率也是 AI 写的,这种场景很难 review。

欢迎提交 Issue

我非常欢迎以下类型的 Issue:

  • 🐛 Bug 报告 — 描述问题、复现步骤、期望行为
  • 💡 功能建议 — 你希望 SayIt 增加什么功能
  • 📝 使用反馈 — 哪里体验不好、哪里不够直观

提交 Issue 时请尽量包含:

  • 操作系统版本
  • SayIt 版本号(在「关于」页面查看)
  • 使用的模式(服务器 / 云 API / 本地)
  • 问题的具体描述和复现步骤

本地开发

如果你想在本地跑起来看看:

客户端

cd client
npm install
npm run tauri dev

前置要求:Node.js 18+、Rust 1.75+、CMake 3.20+、Vulkan SDK (本地识别引擎要用 CMake 编原生库、Vulkan SDK 编 SPIR-V 着色器;装完请新开终端, 非英文 Windows 还需设 CL=/utf-8。详见 README 的「开发 / 客户端」一节。)

服务端

cd server
python3 -m venv .venv && source .venv/bin/activate
pip install -r backend/requirements.txt
cd backend && uvicorn app.main:app --port 8000

前置要求:Python 3.10+、NVIDIA GPU + CUDA

代码规范

  • TypeScript strict 模式
  • ESLint + Prettier 自动格式化
  • UI 文本使用中文

提交规范

使用语义化提交信息:

  • feat: 新功能
  • fix: 修复 bug
  • refactor: 重构
  • chore: 构建/工具/依赖变更
  • docs: 文档更新
  • perf: 性能优化