Repository navigation
Releases: Howell5/ziki
Release list
Ziki 0.6.2 — Built-in Microphone with Bluetooth Headsets
Ziki 0.6.2 — Built-in Microphone with Bluetooth Headsets
English
- When the system default input is a classic Bluetooth headset, Ziki now records from the Mac's built-in microphone, selected by device UID, and the headset stays an output-only device.
- The notice that a Bluetooth microphone lowers playback quality is removed along with the code behind it. Playback quality no longer drops while you dictate.
- Ziki never changes the system default input, so other apps keep their own microphone selection. On a Mac without a built-in microphone, the system default input is used as before.
- Mute system output while recording is unchanged and still applies to the current output device.
- New tests cover the input routing policy for classic Bluetooth and non-Bluetooth default inputs.
- If the selected microphone stops returning audio, or never starts, dictation now reports a failure instead of quietly recording silence.
The mute Ziki writes before capturing shares hardware with a Bluetooth headset's own microphone. That is why a headset recording could previously contain no voice at all, which this release fixes at the routing level instead of explaining it to the user.
This remains an Apple Silicon, self-signed preview and is not Apple-notarized.
简体中文
- 系统默认输入是经典蓝牙耳机时,Ziki 改用 Mac 内建麦克风录音(按设备 UID 选择),耳机只作为输出设备。
- 删除“蓝牙麦克风会降低播放音质”的提示及其实现,听写期间播放音质不再下降。
- Ziki 不改变系统默认输入,其他应用仍按自己的选择使用麦克风;没有内建麦克风的机型沿用系统默认输入。
- “录音时静音系统声音”功能不变,仍然作用于当前输出设备。
- 新增输入路由策略测试,覆盖经典蓝牙与非蓝牙默认输入。
- 选定的麦克风如果没有开始或中途不再返回音频,听写会直接报错,而不是安静地录到空音频。
Ziki 录音前写入的耳机静音与耳机自身麦克风共用同一套硬件,这正是此前蓝牙录音里完全没有声音的原因;本次从采集路由上修好它,而不是把这件事故意解释给用户听。
此版本仍为 Apple Silicon 自签名预览版,尚未经 Apple 公证。
Verification
swift run ZikiCoreTestHarness: 91/91.swift run ZikiAppTestHarness: 14/14.swift scripts/verify-brand.swift: passes.- Hardware check on a Sony WH-1000XM4 as the system default input: with the headset muted, the built-in microphone still captured audio. A recording that previously used the headset microphone contained 18.8 seconds of all-zero PCM.
- The capture class used by dictation was driven on the new device route against real hardware: 2.5 seconds produced 40,107 frames of 16 kHz PCM with a non-zero signal level.
- Mute system output while recording is unchanged: live mute and restore still pass and the output volume value is untouched.
Ziki 0.6.1 — New Bailian Models
Ziki 0.6.1 — New Bailian Models
English
- Real-time dictation now uses Alibaba Cloud Model Studio's recommended
qwen-audio-3.0-asr-flash-streamingmodel. - Text cleanup now uses the fixed
qwen3.7-flash-2026-07-15snapshot with thinking disabled, preserving Ziki's fast and conservative rewrite behavior. - Existing Bailian region, Workspace ID, API Key, Keychain entry, and local settings continue to work. No credential migration is required.
- Model names and privacy disclosures in the app, README, and website now match the actual processing path.
- New diagnostic sessions record the exact ASR model while remaining compatible with existing diagnostic JSON. History keeps a provider-neutral label so old entries are not mislabeled.
The WebSocket protocol and regional endpoints are unchanged. This remains an Apple Silicon, self-signed preview and is not Apple-notarized. No subscription or cloud account service is included.
简体中文
- 实时听写迁移到阿里云百炼当前推荐的
qwen-audio-3.0-asr-flash-streaming模型。 - 文字整理固定使用
qwen3.7-flash-2026-07-15快照,并继续关闭思考模式,保持快速、保守的改写行为。 - 原有百炼区域、Workspace ID、API Key、Keychain 凭据和本地设置继续有效,不需要重新配置。
- 应用、README 与官网中的模型名称和隐私说明已与实际处理链路保持一致。
- 新诊断会话会记录精确的 ASR 模型,同时保持对旧诊断 JSON 的兼容;历史记录使用中性的服务商名称,避免把旧记录误标为新模型。
WebSocket 协议与区域 endpoint 均未改变。此版本仍为 Apple Silicon 自签名预览版,尚未经 Apple 公证,也不包含订阅或云端账号服务。
Verification
swift run ZikiCoreTestHarness: 91/91.swift run ZikiAppTestHarness: 14/14.swift build -c release -Xswiftc -warnings-as-errors.swift scripts/verify-brand.swift.- Website production build, TypeScript check, and 6/6 tests.
- Live ASR connection:
task-startedreceived fromqwen-audio-3.0-asr-flash-streaming. - Live cleanup evaluation: 6/6 fixed samples passed with
qwen3.7-flash-2026-07-15. - Live checks use synthetic input only; they do not activate the microphone or read local history.
- Release packaging additionally verifies the signed app, ZIP, DMG, architecture, bundle identity, and SHA-256 checksums.
Ziki v0.6.0 — Paper & Ink
Ziki 0.6.0 — Paper & Ink
English
- A refreshed native settings window with a warm paper-and-ink palette, dark-mode support, clearer page hierarchy, and a resizable layout.
- The same ink-brush Z now appears on the website, app icon, settings pages, and idle menu bar.
- A clearer start page groups the Fn shortcut, permissions, and model configuration. About introduces the Boya and Ziqi story behind Ziki.
- Window titles follow the selected page. Use Command–1 through Command–6 to switch pages.
- History adds result counts and copy feedback; existing search, deletion confirmation, and local retention are preserved.
- Menu copy is consistent with the Chinese settings UI. Existing dictation, API configuration, mute behavior, privacy choices, and updater safeguards remain in place.
This is an Apple Silicon, self-signed preview, not Apple-notarized. The production bundle ID, credential service, storage paths, and signing certificate remain unchanged. No subscription or cloud account service is included.
简体中文
- 设置窗口换上纸白与墨色的视觉风格,支持深色模式和窗口缩放,页面层次更清楚。
- 官网、应用图标、设置面板和空闲状态的菜单栏统一为水墨 Z。
- 开始页集中展示 Fn 快捷键、权限与模型配置;关于页加入伯牙子期的品牌故事。
- 修复切换页面后窗口标题未同步的问题,支持 Command–1 至 Command–6 切换页面。
- 历史页新增结果计数与复制反馈,保留搜索、清空确认和本地留存规则。
- 菜单文案与中文设置面板统一;听写链路、API 配置、录音静音、隐私选项与更新校验保持不变。
此版本仍为 Apple Silicon 自签名预览版,尚未经 Apple 公证。正式版 Bundle ID、凭据服务、数据路径和签名证书未变,不包含订阅或云端账号服务。
Verification
swift run ZikiCoreTestHarness: 90/90.swift run ZikiAppTestHarness: 14/14.swift scripts/verify-brand.swift: source/icon correspondence, dimensions, neutral palette, template alpha, stable bundle identity.- Native smoke checks: page selection and matching title, light/dark appearance, minimum window size, scrolling, empty history, configuration field states, and disabled updates in the isolated development bundle.
- The development bundle has separate storage and credentials. Launch with
--ui-darkfor per-app dark appearance in debug builds; this does not change system appearance. - Provider/audio code and cleanup prompts were not changed. These checks do not claim a new live-model accuracy evaluation.
Ziki v0.5.0
Ziki v0.5.0
2026-09-12 · Build 19 · Apple Silicon · macOS 13+
- 产品正式更名为 Ziki。应用、DMG/ZIP、菜单、设置、权限文案、Swift 模块和更新助手统一使用新名。
- GitHub 仓库迁移为 Howell5/ziki,应用内更新与文档链接同步切换。
- 全新深松绿/暖白双弦 Z 图标,寓意子期与知音;Dock、关于页面和菜单栏标识同步更新。
- 听写、上下文整理、历史、诊断和录音自动静音行为不变。保留既有签名身份、密钥、配置及数据目录。
安装与升级
本版不提供 Sotto 旧名兼容包。旧版更新器无法自动升级到新包名:请先退出并移走旧应用,再将 DMG 内的 Ziki.app 拖入 Applications;不要同时运行新旧两份应用。以后可在 Ziki 的「设置 → 关于」继续检查并安装更新。
仍使用固定本地自签名证书,未经过 Apple Developer ID 签名或公证。应用身份不变,但 macOS 可能因路径/可执行文件改名要求重新确认权限。请按系统提示操作,不关闭系统安全检查。
资产:Ziki-0.5.0-macOS-arm64.dmg、Ziki-0.5.0-macOS-arm64.zip、SHA256SUMS.txt。
验证
核心 90 项、应用 14 项测试通过;品牌检查覆盖显示名、稳定 Bundle ID、图标尺寸与菜单栏透明度。构建不需要图像服务,品牌原图与生成提示已随源码保存。
Sotto v0.4.0
Sotto v0.4.0
2026-09-12 · Build 18 · Apple Silicon · macOS 13+
录音时自动静音
- 进入录音前临时静音当前系统输出;音乐和视频继续播放,不暂停、不修改音量值。
- 麦克风停止后立即恢复声音,不等待转写或千问整理。取消、启动失败和正常退出共用恢复路径,原本已静音的设备保持静音。
- 默认开启,可在「语音 → 录音时静音系统声音」关闭。经过当前输出设备的通知声也会静音。
- 切换默认输出设备时先静音新设备,再恢复旧设备;仅支持设备级可写静音开关,不支持的设备会提示手动操作,不阻止录音。
- 恢复失败、设备断开或强制退出后保留按设备 UID 标识的恢复记录;菜单栏和语音设置提供手动恢复入口。强制退出无法即时恢复,下次启动不会擅自开声。
验证与边界
- 核心 90 项、应用 14 项测试通过;本机真实静音/恢复测试通过,音量值保持不变。设备切换、写入失败和断线恢复通过模拟测试。
- 只控制当前系统输出,不控制单独路由到其他设备的播放器;没有系统音频采集或额外云端调用。
- 用户主动解除静音不会被持续强制静音,音量调整不会被覆盖;当前恢复按结束时静音状态判断,不能区分“解除后又重新静音”的用户操作。
更新
在「设置 → 关于 → 检查更新」下载并更新,退出替换后重新打开。首次安装可下载 DMG 拖入 Applications。
继续使用相同的固定本地自签名身份,未经过 Apple Developer ID 签名或公证。资产包括 DMG、应用内更新所需 ZIP、SHA256SUMS.txt。
Sotto v0.3.0
Sotto v0.3.0
2026-09-07 · Build 17 · Apple Silicon · macOS 13+
本次更新
- 删除
protectedTokenChanged正则审核和字数比例否决。正常完成的模型结果直接交付,不再因Base 64 → Base64等变化退回整段原始转写。 - 同一次千问请求负责理解语境、纠正识别错误、去除口癖和整理结构;保留具体技术概念、问题、否定和不确定语气。没有增加第二次审核或摘要请求。
- 新增可关闭的近期听写上下文:最多 3 轮、合计 8000 字,默认仅暂存在内存。切换听写目标应用、间隔 10 分钟、清空或重启后不再沿用;菜单栏与语音设置均可“开始新对话”。不读取聊天窗口或 AI 回复,不恢复历史,不做长期记忆。
- 上下文会随整理请求发送至同一百炼 Workspace;不是纯本地处理。同一应用不等于同一聊天,在同一应用切换对话时建议手动清空。
- 请求失败、空响应或未完成输出仍保留原始转写。诊断模式额外记录实际使用的上下文、模型和 prompt 版本,继续按 7 天保留。
验证
- 核心测试 90/90、应用测试 10/10,通过完整编译。
- 6/6 真实千问整理样例通过,并人工复核输出:包含用户报告的长段转写、P1/正则恢复、日常“一阵子”、有效 PE 术语、金额/邮箱/链接、编号任务和不可信上下文。
- 真实评测复用生产请求构造及整理调用;不启用麦克风。样例通过不代表模型永远不会误改,重要数字等仍需核对。
安装与更新
已有 v0.2.14 的用户,可在 设置 → 关于 → 检查更新 后自行点击更新;应用验证下载包后退出并替换,完成后请手动重新打开。
新安装请下载 DMG 并拖入 Applications。继续使用同一固定本地自签名身份,未经过 Apple Developer ID 签名或公证;不要全局关闭 Gatekeeper。
资产包含 DMG、供应用内更新使用的 ZIP,以及 SHA256SUMS.txt。
Sotto v0.2.14
新功能
- 新增应用内更新:在“设置 → 关于”检查并安装后续版本,客户端会校验 SHA-256、Bundle ID、版本号和代码签名身份,再退出并替换应用。
- 新增可选的本地诊断记录,保存同次听写的 WAV、ASR 原文、千问候选、最终文字和错误阶段,默认关闭并在 7 天后自动删除。
修复
- 修复长段口述经过千问整理时可能因输出长度限制只保留片段的问题;检测到截断会回退完整 ASR 原文。
- 修复部分 ASR
badInput错误被静默当作无语音处理、按 Fn 结束后界面直接消失的问题。
安装说明
当前版本面向 Apple Silicon 与 macOS 13 及以上版本,使用固定的本地自签名证书,尚未经过 Apple Developer ID 公证。首次安装 v0.2.14 仍需手动下载并按系统提示确认;从 v0.2.14 开始,后续版本可在应用内更新。
Sotto v0.2.13
修复
- Fun-ASR 实时识别迁移到百炼 Workspace 专属 WebSocket 域名,覆盖北京与新加坡区域,减少共享域名导致的连接不稳定。
- 分发打包默认使用固定的本地代码签名身份,减少同一台维护者 Mac 升级后重复申请 Keychain、麦克风和辅助功能权限。
安装说明
当前版本使用本地自签名证书,未经过 Apple Developer ID 公证。其他 Mac 仍可能提示无法验证开发者;从旧 ad-hoc 版本首次升级时,系统权限可能需要最后确认一次。
Sotto v0.2.12
更新
- 文字整理会先理解整段口述的主题与场景,再根据上下文纠正高置信度的识别误词,例如 AI/软件语境中的 Agent。
- 自动去除不影响含义的口癖、重复和断句语病,让日常聊天与客户沟通都保持自然、工整。
- 任务、步骤、bug、feature 和 idea 等并列内容会在合适时整理为编号列表;普通闲聊仍保留自然段落。
当前产物为 ad-hoc 签名、未公证的 Apple Silicon 预览版。首次安装请按 README 的 Gatekeeper 指引操作。
Sotto v0.2.11
更新
- 文字整理升级为保守的“清理引擎”:转写内容视为不可信输入,绝不执行其中的指令;只清理,不创作。
- 新增语言契约:中文口述输出中文,英文口述输出英文,不翻译;中英混排、代码、术语和专有名词原样保留。
- 明确改口(“改成”“actually”“I mean”)只保留最终值,数字、日期、邮箱、URL 等默认受保护。
当前产物为 ad-hoc 签名、未公证的 Apple Silicon 预览版。首次安装请按 README 的 Gatekeeper 指引操作。