Skip to content

fork v1.0.0-rc.1 - legacy source release candidate

Pre-release
Pre-release

Choose a tag to compare

View all tags
@DF-wu DF-wu released this 17 Jul 19:19
· 663 commits to master since this release
fork-v1.0.0-rc.1
efd24cb

fork-v1.0.0-rc.1 — legacy source-only release candidate

This is a GitHub pre-release from the exact maintenance/v1 commit
efd24cb1bd1ea5e624561dd869aaea9c5d5c02a5.

This release is deliberately source-only. It is the isolated legacy v1 line,
not fork v2, and it is not a stable real-device/model qualification claim.

Deliverables by role

Server

  • Legacy Linux bare-metal and Docker Server source.
  • WebSocket service on 6016.
  • Opt-in, transcription-only OpenAI-compatible HTTP API on 6017.
  • Compose builds locally as capswriter-offline-v1-local:source; no v1 image is
    published.
  • v1 must never consume or publish the v2
    ghcr.io/df-wu/capswriter-offline-server:latest image.

Client

  • Compatibility-preserved upstream-era Windows desktop Client source:
    start_client.py.
  • It owns microphone capture, tray, hotkeys, clipboard, and text injection, and
    connects to the Server over WebSocket 6016.
  • No Windows executable is attached.
  • v2 Web Console, CLI, TUI, and universal Windows package are not included.

External API callers

curl, the OpenAI SDK, or another compatible application can call the Server's
whisper-1-shaped file-transcription subset. This is a Server interface, not a
bundled Client. It supports the documented transcription formats; when a key is
configured, the transcription endpoint accepts Bearer authentication.
Translation, streaming, diarization, and the complete OpenAI Audio API are not
implemented. /v1/audio/translations returns 501.

Safety and documentation changes

  • Compose now passes the HTTP settings into the container even when the API is
    disabled. The container bind (0.0.0.0) and host publish bind (loopback
    127.0.0.1) are documented separately; remote use requires an authenticated
    TLS reverse proxy and an intentional host bind.
  • Mutable hot-server.txt, hot.txt, hot-rule.txt, and hot-rectify.txt are
    excluded from local Docker build layers.
  • The old v1 image-publish workflow was removed; the tagged tree contains no
    package-writing publish workflow and does not publish the shared v2 latest
    image.
  • English and Traditional Chinese README, maintenance, release, and HTTP API
    guides state the Server/Client boundary explicitly.

Automated evidence for this exact source

  • Push matrix run
    and pull-request matrix run
    both passed all four Ubuntu 24.04/Windows 2022 × Python 3.10/3.12 legs.
  • Each leg ran 51 maintenance tests and compile checks.
  • Compose and docker/server/entrypoint.sh validation ran in the Ubuntu 24.04 /
    Python 3.10 validation job.
  • Local verification additionally passed selected bilingual documentation-link
    checks and the isolated 51-test suite.

These checks do not prove model quality, known-audio recognition, GPU/CPU
performance, a disposable image build, or real Windows desktop behavior.

Still required before a stable v1 claim

  • Cold model bootstrap and Mandarin/English known-audio transcription.
  • Target CPU/GPU backend and driver/runtime evidence.
  • Real Windows launch/exit, tray, hotkey, microphone, clipboard, FFmpeg, model,
    and child-process cleanup checks.
  • A separately reviewed immutable v1 image workflow before advertising any v1
    image.

Documentation

fork-v1.0.0-rc.1 — legacy source-only release candidate（繁體中文）

這是精確指向 maintenance/v1 commit
efd24cb1bd1ea5e624561dd869aaea9c5d5c02a5 的 GitHub pre-release。

本 release 刻意只提供 source，屬於隔離的 legacy v1 line，不是 fork v2，也不
宣稱已完成真實裝置或 model qualification。

依角色說明

  • **Server：**Linux bare-metal／Docker Server source、WebSocket 6016，以及
    opt-in、transcription-only 的 HTTP API 6017。Compose 會從 source 建立
    capswriter-offline-v1-local:source；不發布 v1 image，也不會讀取或覆寫 v2
    的 latest。
  • **Client：**只有相容保留的 upstream-era Windows desktop source
    start_client.py，負責麥克風、tray、hotkey、clipboard、文字注入，透過
    WebSocket 6016 連到 Server。不附 Windows executable，不含 v2 Web／CLI／TUI
    或 universal Windows package。
  • **外部 API caller：**curl／OpenAI SDK 等外部程式呼叫 Server 的 whisper-1
    檔案轉錄 subset。它不是 bundled Client；不實作 translation、streaming、
    diarization 或完整 OpenAI Audio API，/v1/audio/translations 回 501。

Compose 的 container bind 0.0.0.0 與 host publish bind 127.0.0.1 已分開說明；
非 loopback 使用必須設定 authentication、TLS reverse proxy 與明確的 host bind。
可變 hotword 檔不會進入 local image layer；舊 v1 publish workflow 已移除。

這個 exact source 的自動化證據

  • Push matrix
    與 pull-request matrix
    均通過 Ubuntu 24.04／Windows 2022 × Python 3.10／3.12 四個 legs。
  • 每個 leg 執行 51 個 maintenance tests 與 compile checks；Compose／entrypoint
    validation 只在 Ubuntu 24.04／Python 3.10 validation job 執行。
  • 這些證據不代表 model quality、known-audio、GPU／CPU performance、image build
    或真實 Windows desktop 已驗證。

Stable v1 前仍需完成 cold model bootstrap、中文／英文 known-audio、target
CPU／GPU、真實 Windows desktop 與獨立審查的 immutable v1 image workflow。

完整雙語文件請見本 release 內的 繁中 README、
English README、
繁中 API guide
與 English API guide。

Assets 2
Loading