Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

chore(release): v0.3.4 —— 版本戳与发布正文

lmliheng2dc1db192c4c
diff --git a/RELEASE-v0.3.4.md b/RELEASE-v0.3.4.md
new file mode 100644
index 00000000..a3874562
--- /dev/null
+++ b/RELEASE-v0.3.4.md
@@ -0,0 +1,66 @@
+# Adelie v0.3.4 —— 记账时就定价的用量成本、用户管理两列、长会话与 Trace 不再卡,外加反馈入口与模型库更新
+
+用户 2026-10-08 点单发这一版(需求箱 req-23「该更新 0.3.4 版本了」)。按巡台口径,普通需求要攒到
+10 个功能性提交才发版,这一版是 **9 个**(自 v0.3.3 起)—— 用户当场要,且下面这些改动都是**用户可见**、
+一直躺在本地的,发出去正合 `REQUIREMENTS.md` §1.4 那条「攒着不发等于没做」。**没有破坏性改动**:
+数据根、配置格式、HTTP 接口都没动,已装好的机器不需要改任何配置。
+
+## 这一版改了什么
+
+1. **用户管理表多了「最近登录时间」与「累计开销」两列**。管理员列表直接看到每个人最后一次进来的
+ 时刻与到目前为止花掉的钱(服务端按用量行汇总),不用再逐个点进去。
+2. **用量成本在写入用量行时就定格**。过去成本是读取时按当时的价目表算的,模型调价或补录价格会让
+ 历史账目跟着变;现在每条用量行落库时就把价格和金额记下来,账目是当时那一刻的事实(服务端一半,
+ 见 `changelog/unreleased/2026-10-08-usage-cost-at-record-time.md`)。
+3. **长会话与长 Trace 文件打开不再卡**(上游 `b8862716` 移植)。对话按更少的 Task 打开、历史页按
+ 字节设上限、图片改为链接,Trace 面板一次读一轮而不是整个文件。
+4. **插件市场把未安装的插件从「已安装」里分出去**。列表不再把「本机有、但没装进这个项目」的条目
+ 混在已安装分区里。
+5. **官方模型的接入地址与三档价格在配置对话框里只读**。已经固定的官方模型(baseURL、缓存命中/
+ 未命中、输入输出价)不再允许用户改坏。
+6. **左下角账户菜单加了「用户反馈」入口**。提交的反馈直接落进本机的需求箱(3003),不用另外写邮件。
+7. **模型库加入智谱官方的免费档 GLM-4.7 Flash**。
+8. **两处沙箱修复**:建沙箱前先把 Session 的 scratchpad 建出来(上游 `cba091e3` 移植);
+ `sandbox-dsh` 在 Windows 上拒绝 bash,并点名它要哪个 shell(否则报错只说「失败」)。
+
+## 升级
+
+桌面端(Windows / Linux 的 AppImage)在应用内更新:账号菜单的更新入口或应用菜单里的「检查更新」
+会读到这一版,默认走 OSS 镜像,镜像不通自动回退 GitHub Releases。Windows 安装包仍未签名,
+SmartScreen 会提示一次(「更多信息 → 仍要运行」)。
+
+服务器 / CLI 装的(tar 包或 npm 全局)用同一条链路,数据根(`~/.adelie/data`)不动:
+
+```bash
+penguin update --check # 看有没有新版
+penguin update --yes # 原地替换 bin/lib/web/node
+```
+
+| 产物 | 目标 |
+| --- | --- |
+| `adelie-desktop-win32-x64.exe` | Windows x64 桌面端(未签名,NSIS 安装器) |
+| `adelie-desktop-linux-x86_64.AppImage` / `adelie-desktop-linux-amd64.deb` | Linux x64 桌面端 |
+| `penguin-linux-x64.tar.gz` | Linux x64 命令行版(自带 Node 24.18.0) |
+| `penguin-win32-x64.zip` | Windows x64 命令行版(自带 Node 与 MinGit) |
+| `penguin-universal.tar.gz` | 任意平台(不带运行时,需要 Node ≥ 24) |
+| `install.sh` / `install.ps1` | 在线安装脚本(`penguin update` 取的就是它) |
+| `latest.yml` / `latest-linux.yml` | 桌面端自动更新读的元数据 |
+
+安装包都在 GitHub Release 上:<https://github.com/lmliheng/Adelie/releases/tag/v0.3.4>;
+同一份资产也在 OSS 镜像上(`.../releases/v0.3.4/` 与版本无关的 `.../latest/`)。
+npm 上整条链同样是 **0.3.4**:`npm install -g @lmliheng/penguin-cli`。
+
+## 质量门禁(本机跑过)
+
+- `pnpm typecheck`(8 个工作区包)、`pnpm lint`(oxlint,0 警告 0 错误)、`pnpm format:check`
+ (prettier)全过。
+- 测试全绿:**9037 通过 / 16 跳过 / 0 失败**(docs 62 · ui 1003 · core 1359 · server 2676 ·
+ cli 506 · web 2942 · desktop 286 · ui-gallery 131 · 四个 sandbox 插件 72)。
+
+## 已知待办
+
+- **没有代码签名**:Windows 的 Authenticode 与 macOS 的 Developer ID 都没有;macOS 的 dmg 会被
+ Gatekeeper 拦,所以仍不发 macOS。
+- 命令名仍是 `penguin`、数据根 `~/.adelie`;安装脚本与打包脚本里的产物名仍是 `penguin-*`。
+- `.github/workflows/release.yml` 仍是上游那条(只能手动 dispatch),Adelie 自己的发布流水线还没写;
+ 这一版的安装包是「本机脚本 + `desktop-build.yml` 手工 dispatch」打的。
diff --git a/package.json b/package.json
index ddb45702..dda77b9c 100644
--- a/package.json
+++ b/package.json
@@ -1,9 +1,9 @@
{
"name": "penguin-harness",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
- "description": "Adelie \u2014 TypeScript AI Agent (SDK + CLI).",
+ "description": "Adelie — TypeScript AI Agent (SDK + CLI).",
"engines": {
"node": ">=24"
},
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 47305374..233cd97d 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-cli",
- "version": "0.3.3",
+ "version": "0.3.4",
"type": "module",
"description": "Adelie CLI: interactive REPL and single-task runner over @lmliheng/penguin-core.",
"license": "Apache-2.0",
diff --git a/packages/core/package.json b/packages/core/package.json
index d52e93bc..f7c2b4c4 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-core",
- "version": "0.3.3",
+ "version": "0.3.4",
"type": "module",
"engines": {
"node": ">=24"
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 3bd03576..50d2ecc8 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -92,7 +92,7 @@ export type {
} from "./agent.js";
/** SDK version number. */
-export const VERSION = "0.3.3";
+export const VERSION = "0.3.4";
/** Release build date (UTC yyyy-mm-dd), stamped by the release workflow next to VERSION; null in a dev/source build. */
export const BUILD_DATE: string | null = null;
/** Full commit sha the release was built from, stamped by the release workflow next to VERSION; null in a dev/source build. */
diff --git a/packages/desktop/package.json b/packages/desktop/package.json
index e3e333c4..433687f7 100644
--- a/packages/desktop/package.json
+++ b/packages/desktop/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-desktop",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
"description": "Adelie desktop app: Electron shell running @lmliheng/penguin-server as a utilityProcess, window on http://localhost (same-origin HTTP/SSE, no private IPC).",
diff --git a/packages/docs/package.json b/packages/docs/package.json
index b3e11a24..3ee2a0da 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-docs",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
"description": "PenguinHarness documentation site (React + Vite + Tailwind CSS): bilingual zh/en Markdown pages with light/dark themes and per-page Copy Markdown, deployed to GitHub Pages under /docs/ next to the landing page.",
diff --git a/packages/hmr/package.json b/packages/hmr/package.json
index f0755c9b..a6d24236 100644
--- a/packages/hmr/package.json
+++ b/packages/hmr/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-hmr",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
"description": "The hot-update mechanism: the version store, the atomic commit, the resource registry and the park → boot → swap. Mechanism only.",
diff --git a/packages/server/package.json b/packages/server/package.json
index cb6b5e4f..b725fe23 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-server",
- "version": "0.3.3",
+ "version": "0.3.4",
"type": "module",
"description": "Adelie web server: multi-user authentication and authorization, Session execution with SSE streaming, and usage accounting, built on @lmliheng/penguin-core.",
"license": "Apache-2.0",
diff --git a/packages/ui-gallery/package.json b/packages/ui-gallery/package.json
index 0ff81634..0a2a311a 100644
--- a/packages/ui-gallery/package.json
+++ b/packages/ui-gallery/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-ui-gallery",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
"description": "Adelie UI gallery (local dev tool, Vite + React): the real Web App framed against an in-browser demo API, one page per surface in every theme, mode, text size, font pairing and language, plus the Foundations boards and the bundled fonts.",
diff --git a/packages/ui/package.json b/packages/ui/package.json
index be4a4dad..b7b511e5 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-ui",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
"description": "Adelie shared UI: design tokens, the three themes, bundled fonts and the component set the Web App and the gallery render.",
diff --git a/packages/web/package.json b/packages/web/package.json
index d3b53bcf..3874c85c 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/penguin-web",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"type": "module",
"description": "Adelie web frontend SPA: React + Vite + Tailwind CSS, rendering conversations streamed over the OmniMessage protocol, plus Agent configuration, model configuration, usage stats, and Traces.",
diff --git a/plugins/agent-company/package.json b/plugins/agent-company/package.json
index 541f3a77..fb512e2d 100644
--- a/plugins/agent-company/package.json
+++ b/plugins/agent-company/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/agent-company",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Company mode for Adelie agents: creating the organization with the user, the employee protocol every desk and ticket session follows, plus the CEO, HR and finance playbooks for running an organization on calendar events, tickets, channels and budgets.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/agent-development/package.json b/plugins/agent-development/package.json
index 1d3159f8..761030cc 100644
--- a/plugins/agent-development/package.json
+++ b/plugins/agent-development/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/agent-development",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Agent development on Adelie: build on the SDK, call any model through one unified LLM API, manage models and secrets, and orchestrate agents, sessions, costs and schedules.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/agent-tuning/package.json b/plugins/agent-tuning/package.json
index 025ea86c..745b7841 100644
--- a/plugins/agent-tuning/package.json
+++ b/plugins/agent-tuning/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/agent-tuning",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Agent tuning as a loop: initialize an agent from a requirement, design and calibrate a capability benchmark, run and score isolated cases, and improve the agent from measured results.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/browser-automation/package.json b/plugins/browser-automation/package.json
index e5035428..68c2d29c 100644
--- a/plugins/browser-automation/package.json
+++ b/plugins/browser-automation/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/browser-automation",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Drive the Adelie desktop app's built-in browser with penguin browser — read pages as simplified HTML or text, act with JavaScript and trusted clicks and typing, extract structured data, and import sign-ins from the system browser.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/continual-learning/package.json b/plugins/continual-learning/package.json
index 012d37f1..e4200952 100644
--- a/plugins/continual-learning/package.json
+++ b/plugins/continual-learning/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/continual-learning",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Continual learning: a stop hook that, when the task that just ended ran more than 30 completed turns, hands a condensed excerpt of that task to a background subagent, which folds the durable findings into the agent's own skills.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/csu-mail/package.json b/plugins/csu-mail/package.json
index 0c3ef9a1..ec165d28 100644
--- a/plugins/csu-mail/package.json
+++ b/plugins/csu-mail/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/csu-mail",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Manage a Coremail mailbox (CSU student mail, mail.csu.edu.cn) over IMAP/SMTP with a client app password instead of the unified auth portal — create the app password once, then list, search, read and send mail from the shell, with a copy kept in the Sent folder.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/data-analysis/package.json b/plugins/data-analysis/package.json
index 42907e8c..d6860659 100644
--- a/plugins/data-analysis/package.json
+++ b/plugins/data-analysis/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/data-analysis",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Complete data-analysis tasks with bounded inspection, correct data semantics, native artifact handling, complete delivery, and risk-based verification.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/goal/package.json b/plugins/goal/package.json
index 3a6b3db1..1c7a7a53 100644
--- a/plugins/goal/package.json
+++ b/plugins/goal/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/goal",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Goal mode: a stop hook that keeps the session working toward an objective — re-injecting it every round and checking the goal file — until the goal is complete, blocked, or out of token budget.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/humanizer/package.json b/plugins/humanizer/package.json
index 74ac7a84..8592087c 100644
--- a/plugins/humanizer/package.json
+++ b/plugins/humanizer/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/humanizer",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Rewrite or edit prose in any language so it reads like edited human writing in the register of books, newspapers and encyclopedias rather than default AI output. A small drafting core — vary every pattern, build density from anchored facts in whole grammar, cap the quotables, put a real writer with real material behind the text, let structure serve content, write each language from inside its idiom and typography, verify what you assert, and aim for the natural distribution of edited prose rather than a perfect scorecard — backed by a three-layer tell catalog, per-language cue files for six languages and a seven-round measured case study shipped as reference files for the diagnostic census.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/lesson-video/package.json b/plugins/lesson-video/package.json
index 34552947..8c1b8290 100644
--- a/plugins/lesson-video/package.json
+++ b/plugins/lesson-video/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/lesson-video",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Narrated vertical lesson videos (1080x1920) from a script: an HTML slide deck driven by time, edge-tts voice-over with word-level timing, Playwright frame capture, ffmpeg mux, cover art and publishing copy.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/model-development/package.json b/plugins/model-development/package.json
index 92a30b55..723f2473 100644
--- a/plugins/model-development/package.json
+++ b/plugins/model-development/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/model-development",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Model development on your own hardware: fine-tune with LlamaFactory, run local models with Ollama, and serve them with vLLM.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/requirements-box/package.json b/plugins/requirements-box/package.json
index f77f5ddc..2700bbc4 100644
--- a/plugins/requirements-box/package.json
+++ b/plugins/requirements-box/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/requirements-box",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "A requirements box: one keyed page where the user files what they want done, a scheduled task that wakes the agent to work through them, and a per-round report by mail — the service being a single dependency-free Node file with a JSON store and a keyed API, the patrol protocol one markdown file.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/skill-porting/package.json b/plugins/skill-porting/package.json
index 96fc23d0..fde99166 100644
--- a/plugins/skill-porting/package.json
+++ b/plugins/skill-porting/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/skill-porting",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Install skills from external ecosystems into this agent's agent_state/skills/ — resolve Claude Code plugin marketplaces, the Codex plugin repo, skills.sh registry names, GitHub repos, or local folders to their skill directories, review every file, and normalize SKILL.md frontmatter to the Penguin format.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/software-development/package.json b/plugins/software-development/package.json
index 9d22895a..709d2813 100644
--- a/plugins/software-development/package.json
+++ b/plugins/software-development/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/software-development",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Software development end to end — disciplined software-engineering practice for real tasks, plus the Penguin visual language for every generated web page and app UI.",
"license": "Apache-2.0",
"repository": {
diff --git a/plugins/use-bento-slides/package.json b/plugins/use-bento-slides/package.json
index ac71048d..1c8f478e 100644
--- a/plugins/use-bento-slides/package.json
+++ b/plugins/use-bento-slides/package.json
@@ -1,7 +1,7 @@
{
"name": "@lmliheng/use-bento-slides",
- "version": "0.3.3",
- "description": "Create and edit Bento presentations \u2014 self-contained .bento.html decks whose document is JSON. Use whenever the user wants a slide deck or presentation: from scratch, from source material, or by improving an existing file.",
+ "version": "0.3.4",
+ "description": "Create and edit Bento presentations — self-contained .bento.html decks whose document is JSON. Use whenever the user wants a slide deck or presentation: from scratch, from source material, or by improving an existing file.",
"license": "Apache-2.0",
"repository": {
"type": "git",
diff --git a/plugins/use-claude-code/package.json b/plugins/use-claude-code/package.json
index 2ec247b4..653080a5 100644
--- a/plugins/use-claude-code/package.json
+++ b/plugins/use-claude-code/package.json
@@ -1,7 +1,7 @@
{
"name": "@lmliheng/use-claude-code",
- "version": "0.3.3",
- "description": "Run Claude Code on a remote host over SSH \u2014 a persistent expect-driven login session, headless claude -p with the stdin fix, the interactive TUI inside a remote tmux driven by send-keys/capture-pane (one keystroke at a time, capture-verified; relayed user messages go through verbatim), and multi-turn continuity via --session-id/--resume or stream-json; hosts and credentials are placeholders resolved at runtime from the user or the vault, never hardcoded.",
+ "version": "0.3.4",
+ "description": "Run Claude Code on a remote host over SSH — a persistent expect-driven login session, headless claude -p with the stdin fix, the interactive TUI inside a remote tmux driven by send-keys/capture-pane (one keystroke at a time, capture-verified; relayed user messages go through verbatim), and multi-turn continuity via --session-id/--resume or stream-json; hosts and credentials are placeholders resolved at runtime from the user or the vault, never hardcoded.",
"license": "Apache-2.0",
"repository": {
"type": "git",
diff --git a/plugins/use-firecrawl/package.json b/plugins/use-firecrawl/package.json
index 617e2020..33e5db5e 100644
--- a/plugins/use-firecrawl/package.json
+++ b/plugins/use-firecrawl/package.json
@@ -1,7 +1,7 @@
{
"name": "@lmliheng/use-firecrawl",
- "version": "0.3.3",
- "description": "Search the web and scrape pages into clean markdown with the Firecrawl API \u2014 query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.",
+ "version": "0.3.4",
+ "description": "Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.",
"license": "Apache-2.0",
"repository": {
"type": "git",
diff --git a/plugins/wechat-miniprogram/package.json b/plugins/wechat-miniprogram/package.json
index 6eb9b88d..48474c64 100644
--- a/plugins/wechat-miniprogram/package.json
+++ b/plugins/wechat-miniprogram/package.json
@@ -1,6 +1,6 @@
{
"name": "@lmliheng/wechat-miniprogram",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "Publish a WeChat mini-program end to end from a headless Linux server: QR login to mp.weixin.qq.com, switching from a public account to the mini-program backend, the AppID and upload key, IP whitelisting, miniprogram-ci upload, the privacy policy, review and release.",
"license": "Apache-2.0",
"repository": {