Skip to content

Commit 0bafe4d

Browse files
committed
Document public v0.1.0 release status
1 parent 2a270e7 commit 0bafe4d

4 files changed

Lines changed: 90 additions & 28 deletions

File tree

README.md

Lines changed: 24 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ workbench. It is built for the loop you actually use while programming:
77
inspect a repository, edit files, run checks, review the result, and keep
88
iterating from the same terminal.
99

10-
> Status: usable for dogfooding and repository work. It is not yet a polished
11-
> hosted product, and the native PTY supervisor/release channels are still in
12-
> progress.
10+
> Status: usable for dogfooding and repository work. `v0.1.0` has GitHub
11+
> Release binaries and a GHCR image; npm and Homebrew publishing still need
12+
> registry/tap credentials, and native PTY/product polish remains in progress.
1313
1414
<p align="center">
1515
<img src="./docs/demo/deepseek-code-tui.svg" alt="DeepSeekCode TUI demo snapshot" width="100%">
@@ -32,8 +32,8 @@ iterating from the same terminal.
3232
- RLM helpers for recursive/long-input analysis, model-session context, live
3333
queue status, event replay, cancellation, recovery, and drain controls.
3434
- LSP-backed and fallback diagnostics runners with JSON/JSONL watch output.
35-
- Release packaging scaffolding for Cargo, npm wrappers, Docker, Homebrew
36-
formula rendering, and GitHub release assets.
35+
- Release assets for Linux x64, macOS x64, macOS arm64, and Windows x64,
36+
plus a GHCR image and npm/Homebrew packaging metadata.
3737

3838
## Quick Start
3939

@@ -45,6 +45,24 @@ deepseek version
4545
deepseek doctor --json
4646
```
4747

48+
Or download a release archive:
49+
50+
```bash
51+
curl -L -o deepseek-linux-x64.tar.gz \
52+
https://github.com/willamhou/DeepSeekCode/releases/download/v0.1.0/deepseek-linux-x64.tar.gz
53+
curl -L -o deepseek-linux-x64.tar.gz.sha256 \
54+
https://github.com/willamhou/DeepSeekCode/releases/download/v0.1.0/deepseek-linux-x64.tar.gz.sha256
55+
shasum -a 256 -c deepseek-linux-x64.tar.gz.sha256
56+
tar -xzf deepseek-linux-x64.tar.gz
57+
./deepseek version
58+
```
59+
60+
Or run the published container:
61+
62+
```bash
63+
docker run --rm ghcr.io/willamhou/deepseekcode:0.1.0 version
64+
```
65+
4866
Or use a local checkout:
4967

5068
```bash
@@ -83,7 +101,7 @@ Claude Code CLI / Codex CLI polish. The largest remaining gaps are:
83101

84102
- native supervisor-owned PTY attach/stdin/resize/replay/wait/cancel;
85103
- live external write-fixture validation across real repositories;
86-
- public release evidence for binary, npm, Homebrew, and container channels;
104+
- npm registry publishing and a Homebrew tap, both blocked on credentials;
87105
- product polish around onboarding, auth, model/provider setup, and demos.
88106

89107
## Demo Asset

README.zh-CN.md

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ DeepSeekCode 是一个 DeepSeek-first 的终端代码智能体,也是本地
66
TUI/runtime workbench。它面向真实写代码循环:阅读仓库、修改文件、运行检查、
77
查看结果,然后继续在同一个终端里迭代。
88

9-
> 当前状态:已经可以用于 dogfood 和仓库内编码任务,但还不是完全产品化的
10-
> hosted 工具;原生 PTY supervisor 和正式发布渠道仍在推进中。
9+
> 当前状态:已经可以用于 dogfood 和仓库内编码任务。`v0.1.0` 已有 GitHub
10+
> Release 二进制包和 GHCR 镜像;npm 与 Homebrew 发布还需要 registry/tap
11+
> 凭据,原生 PTY 和产品化打磨仍在推进中。
1112
1213
<p align="center">
1314
<img src="./docs/demo/deepseek-code-tui.svg" alt="DeepSeekCode TUI demo snapshot" width="100%">
@@ -30,8 +31,8 @@ TUI/runtime workbench。它面向真实写代码循环:阅读仓库、修改
3031
- 支持 RLM 递归/长输入分析、model-session context、live queue status、
3132
event replay、cancel、recover 和 drain 控制。
3233
- 支持 LSP-backed 与 fallback diagnostics,并能输出 JSON/JSONL watch。
33-
- 已有 Cargo、npm wrapper、Docker、Homebrew formula rendering 和 GitHub
34-
release assets 的发布打包脚手架
34+
- 已有 Linux x64、macOS x64、macOS arm64、Windows x64 的 Release
35+
assets,GHCR 镜像,以及 npm/Homebrew 发布元数据
3536

3637
## 快速开始
3738

@@ -43,6 +44,24 @@ deepseek version
4344
deepseek doctor --json
4445
```
4546

47+
或者下载 release archive:
48+
49+
```bash
50+
curl -L -o deepseek-linux-x64.tar.gz \
51+
https://github.com/willamhou/DeepSeekCode/releases/download/v0.1.0/deepseek-linux-x64.tar.gz
52+
curl -L -o deepseek-linux-x64.tar.gz.sha256 \
53+
https://github.com/willamhou/DeepSeekCode/releases/download/v0.1.0/deepseek-linux-x64.tar.gz.sha256
54+
shasum -a 256 -c deepseek-linux-x64.tar.gz.sha256
55+
tar -xzf deepseek-linux-x64.tar.gz
56+
./deepseek version
57+
```
58+
59+
或者运行已发布的容器镜像:
60+
61+
```bash
62+
docker run --rm ghcr.io/willamhou/deepseekcode:0.1.0 version
63+
```
64+
4665
或者从本地 checkout 安装:
4766

4867
```bash
@@ -80,7 +99,7 @@ Codex CLI 的产品成熟度。最大差距集中在:
8099

81100
- 原生 supervisor-owned PTY 的 attach/stdin/resize/replay/wait/cancel;
82101
- 真实外部仓库上的 live write-fixture 验证;
83-
- binary、npmHomebrew、container 等公开发布渠道的实际发布证据
102+
- npm registry 发布和 Homebrew tap,这两项还缺少对应凭据
84103
- onboarding、auth、model/provider 配置和 demo 展示的产品化打磨。
85104

86105
## Demo 素材

docs/install.md

Lines changed: 20 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ cargo build --release
4545

4646
```bash
4747
cargo fmt --check
48-
cargo test
48+
cargo test -- --test-threads=1
4949
cargo package --allow-dirty
5050
deepseek benchmark
5151
deepseek version
@@ -78,6 +78,19 @@ deepseek dogfood report --limit 5
7878

7979
## Release Binary
8080

81+
GitHub Release 已经提供 `v0.1.0` 的 Linux x64、macOS x64、macOS arm64 和
82+
Windows x64 包,以及对应 `.sha256` 文件。例如 Linux x64:
83+
84+
```bash
85+
curl -L -o deepseek-linux-x64.tar.gz \
86+
https://github.com/willamhou/DeepSeekCode/releases/download/v0.1.0/deepseek-linux-x64.tar.gz
87+
curl -L -o deepseek-linux-x64.tar.gz.sha256 \
88+
https://github.com/willamhou/DeepSeekCode/releases/download/v0.1.0/deepseek-linux-x64.tar.gz.sha256
89+
shasum -a 256 -c deepseek-linux-x64.tar.gz.sha256
90+
tar -xzf deepseek-linux-x64.tar.gz
91+
./deepseek version
92+
```
93+
8194
本地 release binary 路径固定为:
8295

8396
```bash
@@ -118,12 +131,12 @@ docker run --rm deepseek-code:local version
118131
Tag 版 `Release Matrix` workflow 会把同一个 Dockerfile 构建并推送到 GHCR:
119132

120133
```bash
121-
docker pull ghcr.io/<owner>/<repo>:<version>
122-
docker run --rm ghcr.io/<owner>/<repo>:<version> version
134+
docker pull ghcr.io/willamhou/deepseekcode:0.1.0
135+
docker run --rm ghcr.io/willamhou/deepseekcode:0.1.0 version
123136
```
124137

125138
同一次 tag 发布会写入 `<version>``v<version>``latest` 三个 tag;镜像名会按
126-
GHCR 要求转成小写。
139+
GHCR 要求转成小写。`v0.1.0` 的公开镜像已经通过 pull 和 `version` smoke test。
127140

128141
npm wrapper 位于 `npm/`,用于发布时把平台 binary 包装成 `deepseek` 命令。root 包通过 optional dependency 解析当前平台的 binary 包,例如 `@deepseek-code/cli-linux-x64``@deepseek-code/cli-macos-arm64``@deepseek-code/cli-macos-x64``@deepseek-code/cli-windows-x64`。发布前至少验证 wrapper 语法、平台包解析和本地 binary 转发:
129142

@@ -147,9 +160,9 @@ npm tarball,并在 tag run 且配置 `NPM_TOKEN` 时先发布平台包,再
147160
齐全;加 `--json` 会输出 `deepseek.publish_status.v1`,便于 CI 或 release
148161
脚本消费。输出中的 `public_install` 会区分 source checkout、GitHub Release、
149162
npm、Homebrew、GHCR 和 Cargo registry 当前是 `source_available`
150-
`ready_to_publish``requires_publish` 还是 `source_only_policy`在没有真实
151-
tag workflow、registry/tap 发布和外部验证前,不要把 npm/Homebrew/Docker 安装
152-
路径写成已可用
163+
`ready_to_publish``requires_publish` 还是 `source_only_policy`目前 GitHub
164+
Release 和 GHCR 已有公开验证;npm/Homebrew 在没有 registry/tap 凭据和外部验证前
165+
不要写成已可用
153166

154167
## Runtime 服务模板
155168

docs/superpowers/specs/2026-05-14-deepseek-tui-release-gate-parity.md

Lines changed: 22 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,11 @@ Date: 2026-05-14
88
DeepSeek-TUI has public release evidence for installable versions. On
99
2026-05-14, `Hmbown/DeepSeek-TUI` reported latest release `v0.8.36`, public
1010
topics `cli`, `deepseek`, `llm`, `rust`, `terminal`, and `tui`, and a public
11-
Cargo/npm install story. DeepSeekCode is now public with matching core topics,
12-
but `willamhou/DeepSeekCode` still had no tagged GitHub Release, GHCR image,
13-
npm package, or Homebrew tap evidence.
11+
Cargo/npm install story. DeepSeekCode is now public with matching core topics.
12+
At the start of this work, `willamhou/DeepSeekCode` still had no tagged GitHub
13+
Release, GHCR image, npm package, or Homebrew tap evidence. The `v0.1.0`
14+
release now provides public GitHub Release assets and a GHCR image; npm and
15+
Homebrew remain blocked on registry/tap credentials.
1416

1517
Before creating a public tag, the local release gate exposed a blocker:
1618
`cargo test` with default parallelism failed due existing process-global test
@@ -47,12 +49,15 @@ gate already used elsewhere is serial test execution.
4749
after the tag workflow queued indefinitely on `macos-13`.
4850
- Updated `docs/release.md` to use the same serial test command in the local
4951
release gate.
52+
- Published tag `v0.1.0` from commit
53+
`2a270e7aae926e11d4cf4f7491ce6c18b66bfb29`.
5054

5155
## Verification
5256

5357
- `cargo test` with default parallelism reproduced the release blocker:
5458
`1400 passed; 6 failed`.
55-
- `cargo test -- --test-threads=1`
59+
- `cargo test -- --test-threads=1` (`1407 passed`)
60+
- `cargo check --all-targets`
5661
- `cargo metadata --no-deps --format-version 1`
5762
- `cargo package --allow-dirty`
5863
- `node npm/scripts/check-version-sync.js`
@@ -73,15 +78,22 @@ gate already used elsewhere is serial test execution.
7378
- `cargo test handle_tui_action_renders_hooks_inventory --lib -- --test-threads=1`
7479
- `docker build -t deepseek-code:ci .`
7580
- `docker run --rm deepseek-code:ci version`
81+
- `gh run watch 25854373712 --repo willamhou/DeepSeekCode --interval 30 --exit-status`
82+
- `gh release view v0.1.0 --repo willamhou/DeepSeekCode`
83+
- `git ls-remote https://github.com/willamhou/DeepSeekCode.git HEAD`
84+
- `docker pull ghcr.io/willamhou/deepseekcode:0.1.0`
85+
- `docker run --rm ghcr.io/willamhou/deepseekcode:0.1.0 version`
86+
- `npm view @deepseek-code/cli version` returned `E404`, matching the release
87+
workflow log line `NPM_TOKEN is not configured; skipping npm publish.`
7688
- Local Homebrew formula syntax smoke was not run because `ruby` is not
7789
installed in this workspace image; the GitHub-hosted release runner still
7890
performs `ruby -c packaging/homebrew/deepseek.rb`.
91+
- The `Publish Homebrew Tap` job skipped its tap write because
92+
`HOMEBREW_TAP_REPOSITORY` and `HOMEBREW_TAP_TOKEN` were not configured.
7993

8094
## Remaining Gap
8195

82-
This stabilizes the release gate, but it is not itself public release evidence.
83-
The next packaging step is to retag `v0.1.0`, let the release workflow publish
84-
GitHub Release assets and the GHCR image, then re-run `deepseek update
85-
publish-status --json` against downloaded artifacts. npm and Homebrew still
86-
require registry/tap credentials before they can match DeepSeek-TUI's public
87-
install channels.
96+
DeepSeekCode now has public source, release assets, and a runnable GHCR image.
97+
npm and Homebrew still require registry/tap credentials before they can match
98+
DeepSeek-TUI's public install channels. Cargo registry distribution remains
99+
source-only by policy because `Cargo.toml` has `publish = false`.

0 commit comments

Comments
 (0)