A local-first multi-agent app development platform, built on PenguinHarness
docs: 项目自己的链接不再把用户送到上游站点
lmliheng3fa18ff26f66
diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.mdindex d88fd320..8e6e0b1f 100644--- a/.github/CODE_OF_CONDUCT.md+++ b/.github/CODE_OF_CONDUCT.md@@ -1,6 +1,6 @@# Contributor Covenant Code of Conduct-[中文版](https://github.com/Prism-Shadow/penguin-harness/blob/main/.github/CODE_OF_CONDUCT.zh.md)+[中文版](CODE_OF_CONDUCT.zh.md)## Our Pledgediff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.mdindex 8ca36996..18eefdf6 100644--- a/.github/CONTRIBUTING.md+++ b/.github/CONTRIBUTING.md@@ -139,7 +139,7 @@ Responsibilities split by source of truth: the **SDK** owns protocol and executi(message parsing, the agent loop, tools), the **Server** owns the multi-user runtime(auth, SSE streaming, scheduled tasks), and the **file layer** under `~/.penguin/data`owns everything editable and recorded (prompts, Skills, secrets, Traces). The full map-is in [Architecture → Division of responsibilities](https://penguin.ooo/docs/architecture).+is in [Architecture → Division of responsibilities](https://lmliheng.github.io/Adelie/docs/architecture).## Quality gatesdiff --git a/.github/CONTRIBUTING.zh.md b/.github/CONTRIBUTING.zh.mdindex 71e98288..1625ffca 100644--- a/.github/CONTRIBUTING.zh.md+++ b/.github/CONTRIBUTING.zh.md@@ -97,7 +97,7 @@ userData 目录随其名称一并搬家,Chromium 配置文件也跟着走,职责按事实来源划分:**SDK** 拥有协议与执行(消息解析、Agent 循环、工具),**Server** 拥有多用户运行时(认证、SSE 流式传输、定时任务),而 `~/.penguin/data` 下的**文件层**拥有一切可编辑与被记录的东西(Prompt、Skill、密钥、Trace)。完整对照见-[架构 → 职责划分](https://penguin.ooo/docs/architecture)。+[架构 → 职责划分](https://lmliheng.github.io/Adelie/docs/architecture)。## 质量门禁diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.ymlindex 40c38a1f..61ae51b3 100644--- a/.github/ISSUE_TEMPLATE/bug_report.yml+++ b/.github/ISSUE_TEMPLATE/bug_report.yml@@ -7,7 +7,7 @@ body:value: |Please search the open issues first, and check whether the newest release already fixes it — Adelie has no maintenance branches, so a fix only ever arrives in a later version.- **Never paste credentials.** A data root holds provider API keys, messaging bot tokens and Vault entries in readable form, so `system_config.yaml`, `.env`, a Trace and a full log are all likely to carry a secret. Quote the few lines that matter. If the bug *is* a leak or another security problem, do not file it here — follow the [security policy](https://github.com/Prism-Shadow/penguin-harness/blob/main/.github/SECURITY.md).+ **Never paste credentials.** A data root holds provider API keys, messaging bot tokens and Vault entries in readable form, so `system_config.yaml`, `.env`, a Trace and a full log are all likely to carry a secret. Quote the few lines that matter. If the bug *is* a leak or another security problem, do not file it here — follow the [security policy](https://github.com/lmliheng/Adelie/blob/main/.github/SECURITY.md).- type: textareaid: summarydiff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.ymlindex 53bbf3dd..c066431a 100644--- a/.github/ISSUE_TEMPLATE/config.yml+++ b/.github/ISSUE_TEMPLATE/config.yml@@ -4,8 +4,8 @@ contact_links:url: https://discord.gg/eFHKqqcU3Dabout: Ask on Discord — the issue tracker is for defects and proposals.- name: Documentation- url: https://penguin.ooo/docs/+ url: https://lmliheng.github.io/Adelie/docs/about: Installation, configuration, the CLI reference, and the architecture.- name: Security vulnerability- url: https://github.com/Prism-Shadow/penguin-harness/security/advisories/new+ url: https://github.com/lmliheng/Adelie/security/advisories/newabout: Report privately. Never in a public issue.diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.mdindex eabe7032..f2727112 100644--- a/.github/PULL_REQUEST_TEMPLATE.md+++ b/.github/PULL_REQUEST_TEMPLATE.md@@ -16,6 +16,6 @@ this change; the full chain CI runs is `pnpm build`, `pnpm format:check`, `pnpm## Checklist-- [ ] Changelog entry pair under `changelog/unreleased/` — `YYYY-MM-DD-<slug>.md` and its `.zh.md` counterpart, in the format [changelog/README.md](https://github.com/Prism-Shadow/penguin-harness/blob/main/changelog/README.md) describes.+- [ ] Changelog entry pair under `changelog/unreleased/` — `YYYY-MM-DD-<slug>.md` and its `.zh.md` counterpart, in the format [changelog/README.md](https://github.com/lmliheng/Adelie/blob/main/changelog/README.md) describes.- [ ] Docs updated where this changes documented behavior (README, `packages/docs/content/`).- [ ] No API key, bot token or other credential in the diff, the logs, or the screenshots.diff --git a/.github/SECURITY.md b/.github/SECURITY.mdindex 5769affb..58f35b9e 100644--- a/.github/SECURITY.md+++ b/.github/SECURITY.md@@ -67,7 +67,7 @@ These are not, because they are the documented design rather than a defect:- The `[command_policy]` sandbox failing to stop a command it never claimed to cover. It isdocumented as a deny-list at the approval boundary and explicitly not a filesystempermission or a confinement layer — see- [Configuration → Command policy](https://penguin.ooo/docs/configuration). Real confinement+ [Configuration → Command policy](https://lmliheng.github.io/Adelie/docs/configuration). Real confinement(bubblewrap, dsh) is a separate layer.- A server deliberately exposed to a network it should not be on. Adelie binds to`127.0.0.1` by default; putting it on a public address is a deployment decision.diff --git a/.github/SECURITY.zh.md b/.github/SECURITY.zh.mdindex 10b47b01..49b28a85 100644--- a/.github/SECURITY.zh.md+++ b/.github/SECURITY.zh.md@@ -53,7 +53,7 @@ Adelie 在你自己的机器上运行 Agent,而这个 Agent 会执行 shell- Agent 在你已批准的工具调用允许范围内所做的事,包括 `allow-all` 模式下的破坏性命令。- `[command_policy]` 沙箱没能拦住它从未声称覆盖的命令。文档中它被定义为审批边界上的一份 deny 列表,并明确说明它不是文件系统权限,也不是隔离层——见- [配置 → 命令策略](https://penguin.ooo/docs/configuration)。真正的隔离(bubblewrap、dsh)是另一层。+ [配置 → 命令策略](https://lmliheng.github.io/Adelie/docs/configuration)。真正的隔离(bubblewrap、dsh)是另一层。- 有意暴露到不该暴露的网络上的 server。Adelie 默认绑定 `127.0.0.1`,把它放到公网地址上是一项部署决定。- 已经拿到你的用户账号或数据根目录的人能够读到磁盘上的密钥。diff --git a/changelog/unreleased/2026-10-17-own-entry-links.md b/changelog/unreleased/2026-10-17-own-entry-links.mdnew file mode 100644index 00000000..d73233ce--- /dev/null+++ b/changelog/unreleased/2026-10-17-own-entry-links.md@@ -0,0 +1,50 @@+# Links to the project itself now point at Adelie, not at upstream's site++- **Date:** 2026-10-17+- **Type:** process+- **Scope:** `docs`, `tooling`, `cli`++[中文版](2026-10-17-own-entry-links.zh.md)++Every place that sent a reader to `penguin.ooo` or to the upstream repository now sends them to+Adelie's own entry points, so following a link from a README, the docs, an installer header or an+npm package page lands on a page that describes the release actually installed.++## Details++The mapping applied across the repository:++| Was | Now |+| --- | --- |+| `https://penguin.ooo/install.sh`, `install.ps1` | `https://github.com/lmliheng/Adelie/releases/latest/download/install.sh`, `install.ps1` |+| `https://penguin.ooo/download` | `https://github.com/lmliheng/Adelie/releases/latest` |+| `https://penguin.ooo/docs/…` | `https://lmliheng.github.io/Adelie/docs/…` |+| `https://github.com/Prism-Shadow/penguin-harness` | `https://github.com/lmliheng/Adelie` |++- The installers' header comment, `docker/compose.yaml`, the `.github` files (CONTRIBUTING,+ SECURITY, the issue-template config, the bug report's security link, the pull request template's+ changelog link) and the READMEs of `amsp`, `cli`, `core`, `docs`, `server` and `web` carry the new+ targets.+- `quickstart-cli` installs from source with `git clone https://github.com/lmliheng/Adelie.git`+ and `cd Adelie`; its THIRD-PARTY-NOTICES link is now this repository's own file.+- `packages/docs/src/lib/links.ts` — the docs site's repository, API and license URLs — and+ `packages/ui-gallery`'s release link point at this repository, so the docs site's "Edit this page"+ and the gallery's link demo no longer leave the project.+- `packages/{amsp,cli,core,hmr,server}/package.json` name this repository under `repository`, which+ is what an npm package page shows as the source.+- The language pairing link in `CODE_OF_CONDUCT.md` is relative again, so the two versions link to+ each other inside the checkout instead of out to upstream.+- On the requirements-box page served at `:3003`, the release-pipeline diagram's npm-registry node+ lists `@adelie/*` instead of the retired `@lmliheng/penguin-*` names.+- The `penguin-sdk` reference vendored into the `agent-development` plugin carries the same new+ URLs, and that plugin's `plugin.json` moved to `2026.10.17.2` so an installed copy learns of it.++## What deliberately still points upstream++- `token.penguin.ooo` and `go.penguin.ooo/modelscope`: the ModelScope bridge and platform sign-in+ run on upstream's servers, so the URLs and their `penguin-harness` client id stay as they are.+- The attribution and warning sections of both READMEs, and `docs/FORK.md`'s "upstream" row: these+ name upstream on purpose.+- The Dockerfile's OCI source label: the image is published under upstream's Docker Hub namespace.+- Release asset names (`penguin-linux-x64.tar.gz` and friends), the `penguin` command and the+ `PENGUIN_*` environment variables.diff --git a/changelog/unreleased/2026-10-17-own-entry-links.zh.md b/changelog/unreleased/2026-10-17-own-entry-links.zh.mdnew file mode 100644index 00000000..2baf46de--- /dev/null+++ b/changelog/unreleased/2026-10-17-own-entry-links.zh.md@@ -0,0 +1,44 @@+# 指向项目自己的链接改到 Adelie,不再指向上游的站点++- **Date:** 2026-10-17+- **Type:** process+- **Scope:** `docs`, `tooling`, `cli`++[English](2026-10-17-own-entry-links.md)++凡是把读者送到 `penguin.ooo` 或上游仓库的地方,现在都送到 Adelie 自己的入口,因此从 README、+文档、安装脚本头部或 npm 包页面点出去,落到的是与实际安装的那个版本相符的页面。++## 细节++全仓库按这张对照表替换:++| 原来 | 现在 |+| --- | --- |+| `https://penguin.ooo/install.sh`、`install.ps1` | `https://github.com/lmliheng/Adelie/releases/latest/download/install.sh`、`install.ps1` |+| `https://penguin.ooo/download` | `https://github.com/lmliheng/Adelie/releases/latest` |+| `https://penguin.ooo/docs/…` | `https://lmliheng.github.io/Adelie/docs/…` |+| `https://github.com/Prism-Shadow/penguin-harness` | `https://github.com/lmliheng/Adelie` |++- 两个安装脚本的头部注释、`docker/compose.yaml`、`.github` 下的文件(CONTRIBUTING、SECURITY、+ issue 模板配置、bug 报告里的安全策略链接、Pull Request 模板里的变更记录链接),以及 `amsp`、+ `cli`、`core`、`docs`、`server`、`web` 六个包的 README,都换成了新目标。+- `quickstart-cli` 的源码安装改成 `git clone https://github.com/lmliheng/Adelie.git` 与+ `cd Adelie`;其中 THIRD-PARTY-NOTICES 的链接指向本仓库自己的文件。+- `packages/docs/src/lib/links.ts`(文档站的仓库、API、许可地址)与 `packages/ui-gallery` 的+ 发布页链接指向本仓库,文档站的「编辑此页」和画廊的链接示例不再跳出去。+- `packages/{amsp,cli,core,hmr,server}/package.json` 的 `repository` 字段改指本仓库,也就是 npm+ 包页面上显示的源码地址。+- `CODE_OF_CONDUCT.md` 里指向中文版的链接改回相对路径,两个版本在检出内部互相链接,不再跳上游。+- 挂在 `:3003` 的需求箱页面里,发布链路图上 npm registry 那个节点由退役的 `@lmliheng/penguin-*`+ 改为 `@adelie/*`。+- `agent-development` 插件里那份 `penguin-sdk` 参考同样换了新地址,该插件的 `plugin.json` 升到+ `2026.10.17.2`,已安装的副本因此能看到这次更新。++## 有意保留指向上游的地方++- `token.penguin.ooo` 与 `go.penguin.ooo/modelscope`:ModelScope 桥接与平台登录跑在上游服务器上,+ 地址与它们的 `penguin-harness` 客户端标识保持原样。+- 两个 README 里的归属与警示段落、`docs/FORK.md` 的「上游」一行:这些是特意写明上游的。+- Dockerfile 的 OCI source 标签:镜像发布在上游的 Docker Hub 命名空间下。+- 发布资产名(`penguin-linux-x64.tar.gz` 等)、`penguin` 命令与 `PENGUIN_*` 环境变量。diff --git a/docker/compose.yaml b/docker/compose.yamlindex 29c42df1..50f86173 100644--- a/docker/compose.yaml+++ b/docker/compose.yaml@@ -1,7 +1,7 @@# Minimal Adelie deployment. `docker compose up -d`, then read the first-login# link out of `docker compose logs penguin`.#-# See https://penguin.ooo/docs/quickstart-docker for the first sign-in, upgrades, running+# See https://lmliheng.github.io/Adelie/docs/quickstart-docker for the first sign-in, upgrades, running# behind a reverse proxy, and the rescue path for a forgotten admin password.services:penguin:diff --git a/install.ps1 b/install.ps1index 22872abf..7af9741a 100644--- a/install.ps1+++ b/install.ps1@@ -29,7 +29,7 @@# reinstall/upgrade (which only replace bin/lib/web/node/git). Upgrading = re-running this installer.# The launcher exports the root it lives under, so an install made before the rename keeps its data.#-# Docs: https://penguin.ooo/docs/quickstart-cli+# Docs: https://lmliheng.github.io/Adelie/docs/quickstart-cliparam([string]$Version = "",[string]$InstallDir = "",diff --git a/install.sh b/install.shindex e3972209..5d0f086d 100644--- a/install.sh+++ b/install.sh@@ -26,7 +26,7 @@## The data dir (~/.adelie/data by default) sits under the install home but is never touched by reinstall/upgrade (which only replace bin/lib/web/node). The launcher exports the root it lives under, so an install made before the rename (at ~/.penguin) keeps reading its own data there.#-# Docs: https://penguin.ooo/docs/quickstart-cli+# Docs: https://lmliheng.github.io/Adelie/docs/quickstart-cliset -euREPO="https://github.com/lmliheng/Adelie"diff --git a/packages/amsp/README.md b/packages/amsp/README.mdindex 8df9f246..14411463 100644--- a/packages/amsp/README.md+++ b/packages/amsp/README.md@@ -51,8 +51,8 @@ const result = collector.result(); // throws AmspStreamError when the stream end## Documentation-- [Agent API](https://penguin.ooo/docs/agent-api): turning an agent's API on, keys, approval modes, routes, errors, the client in Node and browsers-- [AMSP](https://penguin.ooo/docs/amsp): the protocol, event by event+- [Agent API](https://lmliheng.github.io/Adelie/docs/agent-api): turning an agent's API on, keys, approval modes, routes, errors, the client in Node and browsers+- [AMSP](https://lmliheng.github.io/Adelie/docs/amsp): the protocol, event by event## Development@@ -62,4 +62,4 @@ pnpm --filter @adelie/amsp typecheckpnpm --filter @adelie/amsp test```-Part of [Adelie](https://github.com/Prism-Shadow/penguin-harness) · Apache-2.0+Part of [Adelie](https://github.com/lmliheng/Adelie) · Apache-2.0diff --git a/packages/amsp/package.json b/packages/amsp/package.jsonindex a0375da9..d6d8a4a7 100644--- a/packages/amsp/package.json+++ b/packages/amsp/package.json@@ -6,7 +6,7 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/Prism-Shadow/penguin-harness.git",+ "url": "git+https://github.com/lmliheng/Adelie.git","directory": "packages/amsp"},"engines": {diff --git a/packages/cli/README.md b/packages/cli/README.mdindex 8a4f559b..85a7be23 100644--- a/packages/cli/README.md+++ b/packages/cli/README.md@@ -19,13 +19,13 @@ penguin chat --resume # resume the lateTool calls go through an approval gate — `--approve allow-all` (default) `| deny-all | read-only | always-ask`. Data lives under `~/.adelie/data` (`ADELIE_HOME`, the pre-rename `PENGUIN_HOME`, or `--root`); model credentials come from the Project config or provider env vars (e.g. `DEEPSEEK_API_KEY`).-Prefer a one-line install with a bundled Node runtime? See [Quickstart → CLI and Web App](https://penguin.ooo/docs/quickstart-cli).+Prefer a one-line install with a bundled Node runtime? See [Quickstart → CLI and Web App](https://lmliheng.github.io/Adelie/docs/quickstart-cli).## Documentation-- [Quickstart](https://penguin.ooo/docs/quickstart)-- [CLI Reference](https://penguin.ooo/docs/cli)-- [Configuration Reference](https://penguin.ooo/docs/configuration)+- [Quickstart](https://lmliheng.github.io/Adelie/docs/quickstart)+- [CLI Reference](https://lmliheng.github.io/Adelie/docs/cli)+- [Configuration Reference](https://lmliheng.github.io/Adelie/docs/configuration)## Development@@ -36,4 +36,4 @@ pnpm --filter @adelie/cli typecheckpnpm --filter @adelie/cli test```-Part of [Adelie](https://github.com/Prism-Shadow/penguin-harness) · Apache-2.0+Part of [Adelie](https://github.com/lmliheng/Adelie) · Apache-2.0diff --git a/packages/cli/package.json b/packages/cli/package.jsonindex ca15e8a0..913288ed 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -6,7 +6,7 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/Prism-Shadow/penguin-harness.git",+ "url": "git+https://github.com/lmliheng/Adelie.git","directory": "packages/cli"},"bin": {diff --git a/packages/core/README.md b/packages/core/README.mdindex 189e664f..386b58cd 100644--- a/packages/core/README.md+++ b/packages/core/README.md@@ -23,11 +23,11 @@ A single `run` drives a complete Task: streaming output, per-call approvals, con## Documentation-- [Architecture](https://penguin.ooo/docs/architecture)-- [The OmniMessage Protocol](https://penguin.ooo/docs/omni-message)-- [Core Interfaces](https://penguin.ooo/docs/interfaces)-- [The Agent Loop](https://penguin.ooo/docs/agent-loop)-- [Sessions & Traces](https://penguin.ooo/docs/sessions-and-traces)+- [Architecture](https://lmliheng.github.io/Adelie/docs/architecture)+- [The OmniMessage Protocol](https://lmliheng.github.io/Adelie/docs/omni-message)+- [Core Interfaces](https://lmliheng.github.io/Adelie/docs/interfaces)+- [The Agent Loop](https://lmliheng.github.io/Adelie/docs/agent-loop)+- [Sessions & Traces](https://lmliheng.github.io/Adelie/docs/sessions-and-traces)## Development@@ -38,4 +38,4 @@ pnpm --filter @adelie/core testpnpm test:e2e # live-model e2e (needs DEEPSEEK_API_KEY)```-Part of [Adelie](https://github.com/Prism-Shadow/penguin-harness) · Apache-2.0+Part of [Adelie](https://github.com/lmliheng/Adelie) · Apache-2.0diff --git a/packages/core/package.json b/packages/core/package.jsonindex c532c13f..0a294d79 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -9,7 +9,7 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/Prism-Shadow/penguin-harness.git",+ "url": "git+https://github.com/lmliheng/Adelie.git","directory": "packages/core"},"exports": {diff --git a/packages/docs/README.md b/packages/docs/README.mdindex f96ea9d2..3e0a09c0 100644--- a/packages/docs/README.md+++ b/packages/docs/README.md@@ -2,7 +2,7 @@The PenguinHarness documentation site (React + Vite + Tailwind CSS 4). Its own package, sharing the landing page's visual language: bilingual pages (zh/en), light/dark themes, a sidebar + per-page table of contents, and a "Copy Markdown" button on every page.-Live at <https://penguin.ooo/docs/>.+Live at <https://lmliheng.github.io/Adelie/docs/>.## Content model@@ -37,4 +37,4 @@ pnpm --filter @adelie/landing preview # serve the assembled siteDeep links work without a 404 fallback: the post-build step copies the SPA shell to `dist/<slug>/index.html` for every content slug.-Part of [PenguinHarness](https://github.com/Prism-Shadow/penguin-harness) · Apache-2.0+Part of [Adelie](https://github.com/lmliheng/Adelie) · Apache-2.0diff --git a/packages/docs/content/quickstart-cli.en.md b/packages/docs/content/quickstart-cli.en.mdindex 0421fe1f..bf817c62 100644--- a/packages/docs/content/quickstart-cli.en.md+++ b/packages/docs/content/quickstart-cli.en.md@@ -16,11 +16,11 @@ Install the `penguin` command with one line, configure a model, and run your firRun the installer for your platform. The Linux / macOS and Windows installers bundle their own Node.js runtime; the npm route needs Node.js >= 24 already installed.```bash tab="Linux / macOS"-curl -fsSL https://penguin.ooo/install.sh | sh+curl -fsSL https://github.com/lmliheng/Adelie/releases/latest/download/install.sh | sh``````powershell tab="Windows"-irm https://penguin.ooo/install.ps1 | iex+irm https://github.com/lmliheng/Adelie/releases/latest/download/install.ps1 | iex``````bash tab="npm (any platform)"@@ -119,10 +119,10 @@ Which source then serves the package is measured, not assumed:Set `PENGUIN_DOWNLOAD_SPEED_PROBE=0` to skip the measurement, or set `PENGUIN_DOWNLOAD_SOURCE` to `oss` or `github` to force a source. The normal installer output names the source without printing the mirror's full URL.-The `penguin.ooo` stable entry resolves the current stable version each time it runs. A standalone script downloaded from a versioned GitHub or OSS Release is stamped with that Release's tag and installs the same version by default, which keeps the installer and the package format matched. To override the version, set `PENGUIN_VERSION`, or pass `--version` on POSIX systems. On Windows, set the variable before you run the installer:+The [`releases/latest/download` entry](https://github.com/lmliheng/Adelie/releases/latest/download/install.sh) resolves the current stable version each time it runs. A standalone script downloaded from a versioned GitHub or OSS Release is stamped with that Release's tag and installs the same version by default, which keeps the installer and the package format matched. To override the version, set `PENGUIN_VERSION`, or pass `--version` on POSIX systems. On Windows, set the variable before you run the installer:```powershell-$env:PENGUIN_VERSION = "vX.Y.Z"; irm https://penguin.ooo/install.ps1 | iex+$env:PENGUIN_VERSION = "vX.Y.Z"; irm https://github.com/lmliheng/Adelie/releases/latest/download/install.ps1 | iex```### Offline install@@ -150,8 +150,8 @@ You can also point the installer at a file explicitly: `install.sh --archive <fiBuilding from source requires Node.js >= 24 and pnpm:```bash-git clone https://github.com/Prism-Shadow/penguin-harness.git-cd penguin-harness+git clone https://github.com/lmliheng/Adelie.git+cd Adeliepnpm install && pnpm build```@@ -171,7 +171,7 @@ The dev entry points (`pnpm penguin`, `pnpm dev`, `pnpm desktop`) default to a s| Integrity check | Always on. Online downloads are verified against the published `.sha256`, and bundle payloads against the checksum sealed inside the bundle || Upgrade | Run the install script again; files are swapped atomically |-Script flags go after `sh -s --`, for example `curl -fsSL https://penguin.ooo/install.sh | sh -s -- --universal`.+Script flags go after `sh -s --`, for example `curl -fsSL https://github.com/lmliheng/Adelie/releases/latest/download/install.sh | sh -s -- --universal`.### Windows specifics@@ -186,7 +186,7 @@ Script flags go after `sh -s --`, for example `curl -fsSL https://penguin.ooo/inOther differences on Windows:-- **Agent shell**: the agent's `exec_command` runs in a POSIX shell, so Skills written for one keep working. The shell is picked in this order: `bash` on PATH, which is preferred because your own [Git for Windows](https://gitforwindows.org/) carries the full MSYS userland; then the **bundled bash**, since the Windows zip ships MinGit under `git\` and gives a machine without Git for Windows a POSIX shell, about sixty core utilities and `git.exe`; then PowerShell (`pwsh`, then `powershell`). Only npm installs, which bundle nothing, reach the PowerShell fallback. The `PENGUIN_SHELL` environment variable overrides the pick, and the Session's system prompt tells the model which shell is active. The bundled shell's licensing is recorded in [THIRD-PARTY-NOTICES.md](https://github.com/Prism-Shadow/penguin-harness/blob/main/THIRD-PARTY-NOTICES.md).+- **Agent shell**: the agent's `exec_command` runs in a POSIX shell, so Skills written for one keep working. The shell is picked in this order: `bash` on PATH, which is preferred because your own [Git for Windows](https://gitforwindows.org/) carries the full MSYS userland; then the **bundled bash**, since the Windows zip ships MinGit under `git\` and gives a machine without Git for Windows a POSIX shell, about sixty core utilities and `git.exe`; then PowerShell (`pwsh`, then `powershell`). Only npm installs, which bundle nothing, reach the PowerShell fallback. The `PENGUIN_SHELL` environment variable overrides the pick, and the Session's system prompt tells the model which shell is active. The bundled shell's licensing is recorded in [THIRD-PARTY-NOTICES.md](https://github.com/lmliheng/Adelie/blob/main/THIRD-PARTY-NOTICES.md).- **Ctrl-C**: sending Ctrl-C to a running command session (`input_command` with `"\u0003"`) terminates the whole command session tree instead of interrupting the foreground command. Windows cannot deliver a console Ctrl-C to a piped child process, so the interrupt becomes a hard kill of the tree.- **In-place update**: `penguin update` is not yet supported on Windows. To upgrade, run the installer again.- **Config file permissions**: on POSIX systems, config and credential files are written with `0600` (owner-only) permissions. Windows has no such mode bits, so these files fall under your profile's default NTFS ACLs.diff --git a/packages/docs/content/quickstart-cli.zh.md b/packages/docs/content/quickstart-cli.zh.mdindex 71f0d2b1..667eaf99 100644--- a/packages/docs/content/quickstart-cli.zh.md+++ b/packages/docs/content/quickstart-cli.zh.md@@ -16,11 +16,11 @@ description: 安装 penguin 命令,配置模型,打开 Web App,在终端按平台运行对应的安装命令。Linux / macOS 与 Windows 的安装器自带 Node.js 运行时;npm 方式要求机器上已经装有 Node.js >= 24。```bash tab="Linux / macOS"-curl -fsSL https://penguin.ooo/install.sh | sh+curl -fsSL https://github.com/lmliheng/Adelie/releases/latest/download/install.sh | sh``````powershell tab="Windows"-irm https://penguin.ooo/install.ps1 | iex+irm https://github.com/lmliheng/Adelie/releases/latest/download/install.ps1 | iex``````bash tab="npm(任意平台)"@@ -119,10 +119,10 @@ penguin chat设置 `PENGUIN_DOWNLOAD_SPEED_PROBE=0` 可以跳过测速,把 `PENGUIN_DOWNLOAD_SOURCE` 设为 `oss` 或 `github` 可以强制指定来源。安装器的常规输出只写明来源,不打印镜像的完整 URL。-`penguin.ooo` 稳定入口每次运行时都会解析当前的稳定版本。从 GitHub 或 OSS 某个版本的 Release 里单独下载的安装脚本,会写入所属 Release 的 tag,默认安装同一版本,从而保证安装器与安装包格式相互匹配。要改用其他版本,设置 `PENGUIN_VERSION`;在 POSIX 系统上也可以传入 `--version`。在 Windows 上,先设置环境变量,再运行安装器:+[`releases/latest/download` 这个稳定入口](https://github.com/lmliheng/Adelie/releases/latest/download/install.sh)每次运行时都会解析当前的稳定版本。从 GitHub 或 OSS 某个版本的 Release 里单独下载的安装脚本,会写入所属 Release 的 tag,默认安装同一版本,从而保证安装器与安装包格式相互匹配。要改用其他版本,设置 `PENGUIN_VERSION`;在 POSIX 系统上也可以传入 `--version`。在 Windows 上,先设置环境变量,再运行安装器:```powershell-$env:PENGUIN_VERSION = "vX.Y.Z"; irm https://penguin.ooo/install.ps1 | iex+$env:PENGUIN_VERSION = "vX.Y.Z"; irm https://github.com/lmliheng/Adelie/releases/latest/download/install.ps1 | iex```### 离线安装@@ -150,8 +150,8 @@ $env:PENGUIN_VERSION = "vX.Y.Z"; irm https://penguin.ooo/install.ps1 | iex从源码构建需要 Node.js >= 24 与 pnpm:```bash-git clone https://github.com/Prism-Shadow/penguin-harness.git-cd penguin-harness+git clone https://github.com/lmliheng/Adelie.git+cd Adeliepnpm install && pnpm build```@@ -171,7 +171,7 @@ pnpm install && pnpm build| 完整性校验 | 始终开启。在线下载对照发布的 `.sha256` 校验,安装包里的负载对照包内封入的校验值校验 || 升级 | 重新运行安装脚本,文件以原子方式替换 |-脚本参数写在 `sh -s --` 之后,例如 `curl -fsSL https://penguin.ooo/install.sh | sh -s -- --universal`。+脚本参数写在 `sh -s --` 之后,例如 `curl -fsSL https://github.com/lmliheng/Adelie/releases/latest/download/install.sh | sh -s -- --universal`。### Windows 细节@@ -186,7 +186,7 @@ pnpm install && pnpm buildWindows 上还有以下不同:-- **Agent shell**:Agent 的 `exec_command` 在 POSIX shell 中运行,这样面向 POSIX 编写的 Skill 可以照常工作。shell 的选择顺序是:首先是 PATH 上的 `bash`,优先使用它,因为你自己安装的 [Git for Windows](https://gitforwindows.org/) 带有完整的 MSYS 工具集;其次是**内置 bash**,Windows zip 在 `git\` 下自带 MinGit,没有安装 Git for Windows 的机器也能得到 POSIX shell、约六十个核心工具和 `git.exe`;最后是 PowerShell(先 `pwsh`,后 `powershell`)。只有 npm 安装不带任何内置组件,才会用到 PowerShell 这一兜底。环境变量 `PENGUIN_SHELL` 可以强制指定 shell,Session 的系统提示词会告诉模型当前使用的是哪个 shell。内置 shell 的许可信息见 [THIRD-PARTY-NOTICES.md](https://github.com/Prism-Shadow/penguin-harness/blob/main/THIRD-PARTY-NOTICES.md)。+- **Agent shell**:Agent 的 `exec_command` 在 POSIX shell 中运行,这样面向 POSIX 编写的 Skill 可以照常工作。shell 的选择顺序是:首先是 PATH 上的 `bash`,优先使用它,因为你自己安装的 [Git for Windows](https://gitforwindows.org/) 带有完整的 MSYS 工具集;其次是**内置 bash**,Windows zip 在 `git\` 下自带 MinGit,没有安装 Git for Windows 的机器也能得到 POSIX shell、约六十个核心工具和 `git.exe`;最后是 PowerShell(先 `pwsh`,后 `powershell`)。只有 npm 安装不带任何内置组件,才会用到 PowerShell 这一兜底。环境变量 `PENGUIN_SHELL` 可以强制指定 shell,Session 的系统提示词会告诉模型当前使用的是哪个 shell。内置 shell 的许可信息见 [THIRD-PARTY-NOTICES.md](https://github.com/lmliheng/Adelie/blob/main/THIRD-PARTY-NOTICES.md)。- **Ctrl-C**:向运行中的命令会话发送 Ctrl-C(`input_command` 传入 `"\u0003"`),会终止整棵命令会话进程树,而不是中断前台命令。Windows 无法把控制台 Ctrl-C 投递给通过管道连接的子进程,中断因此退化为强制结束整棵进程树。- **就地更新**:Windows 暂不支持 `penguin update`,升级请重新运行安装器。- **配置文件权限**:在 POSIX 系统上,配置文件与凭据文件以 `0600`(仅属主可读写)权限写入。Windows 没有这类权限位,这些文件遵循你用户目录的默认 NTFS ACL。diff --git a/packages/docs/content/quickstart-desktop.en.md b/packages/docs/content/quickstart-desktop.en.mdindex 14ee9d7b..0f45f520 100644--- a/packages/docs/content/quickstart-desktop.en.md+++ b/packages/docs/content/quickstart-desktop.en.md@@ -12,7 +12,7 @@ The desktop app is the full Web App as a standalone application. It embeds the s## Download and install-Download the installer for your platform from the [download page](https://penguin.ooo/download), which serves the OSS-accelerated mirror when it is reachable. The same files are attached to every [GitHub Release](https://github.com/Prism-Shadow/penguin-harness/releases).+Download the installer for your platform from the [download page](https://github.com/lmliheng/Adelie/releases/latest); the installer prefers the OSS-accelerated mirror when it is reachable. Every [GitHub Release](https://github.com/lmliheng/Adelie/releases) carries the same files.| Platform | Installers || --- | --- |diff --git a/packages/docs/content/quickstart-desktop.zh.md b/packages/docs/content/quickstart-desktop.zh.mdindex 771a3a6e..6f113305 100644--- a/packages/docs/content/quickstart-desktop.zh.md+++ b/packages/docs/content/quickstart-desktop.zh.md@@ -12,7 +12,7 @@ description: 安装 PenguinHarness 桌面应用,配置模型,跑通第一个## 下载并安装-从[下载页](https://penguin.ooo/download)下载对应平台的安装包;OSS 加速镜像可用时,下载页会走镜像。同样的文件也附在每个 [GitHub Release](https://github.com/Prism-Shadow/penguin-harness/releases) 里。+从[下载页](https://github.com/lmliheng/Adelie/releases/latest)下载对应平台的安装包;安装器在 OSS 加速镜像可用时会优先走镜像。每个 [GitHub Release](https://github.com/lmliheng/Adelie/releases) 里都有同样的文件。| 平台 | 安装包 || --- | --- |diff --git a/packages/docs/src/lib/links.ts b/packages/docs/src/lib/links.tsindex 2f73fd03..1d94717a 100644--- a/packages/docs/src/lib/links.ts+++ b/packages/docs/src/lib/links.ts@@ -1,7 +1,7 @@/** External links and language-independent constants used across the docs site. */-export const REPO_URL = "https://github.com/Prism-Shadow/penguin-harness";-export const REPO_API_URL = "https://api.github.com/repos/Prism-Shadow/penguin-harness";+export const REPO_URL = "https://github.com/lmliheng/Adelie";+export const REPO_API_URL = "https://api.github.com/repos/lmliheng/Adelie";export const LICENSE_URL = `${REPO_URL}/blob/main/LICENSE`;/**diff --git a/packages/docs/src/lib/remark-tabs.ts b/packages/docs/src/lib/remark-tabs.tsindex 7de1f862..30685cc5 100644--- a/packages/docs/src/lib/remark-tabs.ts+++ b/packages/docs/src/lib/remark-tabs.ts@@ -4,11 +4,11 @@* block, so the language keeps driving highlighting and nothing about the code changes.** ```bash tab="Linux / macOS"- * curl -fsSL https://penguin.ooo/install.sh | sh+ * curl -fsSL https://github.com/lmliheng/Adelie/releases/latest/download/install.sh | sh* ```** ```powershell tab="Windows"- * irm https://penguin.ooo/install.ps1 | iex+ * irm https://github.com/lmliheng/Adelie/releases/latest/download/install.ps1 | iex* ```** The group becomes a `div.md-tabs` carrying its labels, in child order, as JSON ondiff --git a/packages/hmr/package.json b/packages/hmr/package.jsonindex b3535254..6d20e53f 100644--- a/packages/hmr/package.json+++ b/packages/hmr/package.json@@ -7,7 +7,7 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/Prism-Shadow/penguin-harness.git",+ "url": "git+https://github.com/lmliheng/Adelie.git","directory": "packages/hmr"},"main": "./dist/index.js",diff --git a/packages/server/README.md b/packages/server/README.mdindex 5577c0a8..307c1337 100644--- a/packages/server/README.md+++ b/packages/server/README.md@@ -11,7 +11,7 @@ The Adelie Web backend — the Web implementation of the SDK's Human boundary. H- **Usage**: `token_usage` events are persisted row by row; costs are computed at query time from current per-model pricing.- **Terminals**: `src/terminal/` runs pty sessions server-side (node-pty) and feeds every byte into a headless xterm, so the daemon — not the browser — owns the screen. Control is JSON over HTTP (`/api/terminals`: list / create / capture / keys / kill; create accepts `cwd`, `name`, `cols`/`rows` and a `shell` override); the byte stream is a binary WebSocket at `/api/terminals/:id/stream` (`[opcode, slot, payload]`, output coalesced into ~5ms windows with an immediate leading flush). On attach the server renders the current grid back into an ANSI restore stream, so a reload or a second device rebuilds the exact screen — scrollback, colours, cursor and DEC input modes — while the shell keeps running the whole time. The web app surfaces this twice: an in-app dock (Ctrl+` , Codex-style) and the standalone `/terminal` page (`?id=` attaches an existing terminal — the dock's detach handoff — `?cwd=`/`?name=` parameterize a new one). Sessions run in-process (no forked terminal worker); this module is the only thing touching node-pty, which is where that split would go if load ever demands it.-The full route tables and the SSE protocol are documented in the [Server API reference](https://penguin.ooo/docs/server-api). DTO types are exported for type-only import via `@adelie/server/api`.+The full route tables and the SSE protocol are documented in the [Server API reference](https://lmliheng.github.io/Adelie/docs/server-api). DTO types are exported for type-only import via `@adelie/server/api`.## Environment@@ -51,4 +51,4 @@ pnpm --filter @adelie/server start # node dist/index.js- **Terminals are a shell as the OS account running the server**, i.e. the most privileged thing the API hands out — they are not Project-scoped. A terminal is only visible to the account that created it (someone else's id answers 404, not 403), and the stream WebSocket checks `Origin` on top of the session cookie because a WebSocket handshake is not subject to CORS. Do not expose a deployment with terminals enabled to accounts you would not give SSH.- Behind a reverse proxy, disable response buffering for SSE paths (the server already sends `X-Accel-Buffering: no`), and set `ADELIE_TRUST_PROXY=1` with `x-forwarded-proto` forwarded so session cookies are marked `Secure` — the header alone is not trusted, so without the opt-in an HTTPS deployment issues its cookies without the flag.-Part of [Adelie](https://github.com/Prism-Shadow/penguin-harness) · Apache-2.0+Part of [Adelie](https://github.com/lmliheng/Adelie) · Apache-2.0diff --git a/packages/server/package.json b/packages/server/package.jsonindex ad1a948e..fd34d81c 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -6,7 +6,7 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/Prism-Shadow/penguin-harness.git",+ "url": "git+https://github.com/lmliheng/Adelie.git","directory": "packages/server"},"exports": {diff --git a/packages/ui-gallery/src/library/boards/buttons.tsx b/packages/ui-gallery/src/library/boards/buttons.tsxindex 97a7e12e..1d3613d1 100644--- a/packages/ui-gallery/src/library/boards/buttons.tsx+++ b/packages/ui-gallery/src/library/boards/buttons.tsx@@ -7,7 +7,7 @@ import { Button, GlyphIcon, ICONS, IconButton, Kbd, Link, PlusIcon } from "@adelimport { BoardGroup } from "../../foundations/shared";import { useGallery } from "../../state";-const RELEASES_URL = "https://github.com/Prism-Shadow/penguin-harness/releases";+const RELEASES_URL = "https://github.com/lmliheng/Adelie/releases";/** The in-sentence link points nowhere real; following it would navigate the board's frame away. */const stay = (event: MouseEvent) => event.preventDefault();diff --git a/packages/ui-gallery/src/strings-en.ts b/packages/ui-gallery/src/strings-en.tsindex 1a200438..5f88dd22 100644--- a/packages/ui-gallery/src/strings-en.ts+++ b/packages/ui-gallery/src/strings-en.ts@@ -978,7 +978,7 @@ export const en: GalleryStrings = {inline: { before: "Run ", code: "pnpm install", after: " to install the dependencies." },prose: "Markdown prose",proseSample:- "## Release checks\n\nConfirm **three things** before you release, then run `pnpm -r build`. See the [release notes](https://penguin.ooo).\n\n- Type checks pass\n- Every test passes\n- The changelog is written\n\n> When a data root is taken, use another one — never end someone else's process.\n\n| Check | Command |\n| --- | --- |\n| Types | `pnpm typecheck` |\n| Tests | `pnpm test` |\n\n```bash\npnpm -r build && pnpm test\n```\n\nThe cache hit rate is \\(r = h / (h + m)\\).",+ "## Release checks\n\nConfirm **three things** before you release, then run `pnpm -r build`. See the [release notes](https://lmliheng.github.io/Adelie/).\n\n- Type checks pass\n- Every test passes\n- The changelog is written\n\n> When a data root is taken, use another one — never end someone else's process.\n\n| Check | Command |\n| --- | --- |\n| Types | `pnpm typecheck` |\n| Tests | `pnpm test` |\n\n```bash\npnpm -r build && pnpm test\n```\n\nThe cache hit rate is \\(r = h / (h + m)\\).",compact: "Compact: a channel message",compactSample: "Merged **#897** — `feat/ui-w2` can go.",code: "Code",diff --git a/packages/ui-gallery/src/strings.ts b/packages/ui-gallery/src/strings.tsindex 6043b31d..197653b3 100644--- a/packages/ui-gallery/src/strings.ts+++ b/packages/ui-gallery/src/strings.ts@@ -932,7 +932,7 @@ export const zh = {inline: { before: "先运行 ", code: "pnpm install", after: " 安装依赖。" },prose: "Markdown 正文",proseSample:- "## 部署检查\n\n发布前确认 **三件事**,再运行 `pnpm -r build`。详见[发布说明](https://penguin.ooo)。\n\n- 类型检查通过\n- 测试全部通过\n- 更新日志已写好\n\n> 数据根被占用时,换一个数据根,不要结束别人的进程。\n\n| 检查 | 命令 |\n| --- | --- |\n| 类型 | `pnpm typecheck` |\n| 测试 | `pnpm test` |\n\n```bash\npnpm -r build && pnpm test\n```\n\n缓存命中率为 \\(r = h / (h + m)\\)。",+ "## 部署检查\n\n发布前确认 **三件事**,再运行 `pnpm -r build`。详见[发布说明](https://lmliheng.github.io/Adelie/)。\n\n- 类型检查通过\n- 测试全部通过\n- 更新日志已写好\n\n> 数据根被占用时,换一个数据根,不要结束别人的进程。\n\n| 检查 | 命令 |\n| --- | --- |\n| 类型 | `pnpm typecheck` |\n| 测试 | `pnpm test` |\n\n```bash\npnpm -r build && pnpm test\n```\n\n缓存命中率为 \\(r = h / (h + m)\\)。",compact: "紧凑:频道消息",compactSample: "已合并 **#897**,`feat/ui-w2` 可以删了。",code: "代码",diff --git a/packages/web/README.md b/packages/web/README.mdindex 56de4073..72767db3 100644--- a/packages/web/README.md+++ b/packages/web/README.md@@ -1,6 +1,6 @@# @adelie/web-The Adelie Web App — a React 19 + Vite + Tailwind CSS 4 SPA that renders the OmniMessage stream (same protocol and statistics as the CLI) and manages Agents, Skills, Models, usage and Traces. Feature tour: [Web App Guide](https://penguin.ooo/docs/web-app).+The Adelie Web App — a React 19 + Vite + Tailwind CSS 4 SPA that renders the OmniMessage stream (same protocol and statistics as the CLI) and manages Agents, Skills, Models, usage and Traces. Feature tour: [Web App Guide](https://lmliheng.github.io/Adelie/docs/web-app).## Layout@@ -40,4 +40,4 @@ pnpm --filter @adelie/web build # vite build → dist/No separate static server needed: `@adelie/server` auto-hosts `packages/web/dist` (or `ADELIE_WEB_DIST`) with an SPA fallback — build the web app, start the server, done. The published npm packages bundle the built front end.-Part of [Adelie](https://github.com/Prism-Shadow/penguin-harness) · Apache-2.0+Part of [Adelie](https://github.com/lmliheng/Adelie) · Apache-2.0diff --git a/plugins/README.md b/plugins/README.mdindex 2e19acbb..e1abd611 100644--- a/plugins/README.md+++ b/plugins/README.md@@ -23,9 +23,9 @@ Included plugins, by category (`PLUGIN_CATEGORIES` in `packages/core/src/plugins## Documentation-- [Skills & Plugins](https://penguin.ooo/docs/skills)-- [Goal Mode](https://penguin.ooo/docs/goal-mode)-- [Self-Improvement](https://penguin.ooo/docs/self-improvement)+- [Skills & Plugins](https://lmliheng.github.io/Adelie/docs/skills)+- [Goal Mode](https://lmliheng.github.io/Adelie/docs/goal-mode)+- [Self-Improvement](https://lmliheng.github.io/Adelie/docs/self-improvement)## Developmentdiff --git a/plugins/agent-development/plugin.json b/plugins/agent-development/plugin.jsonindex 3dcbefec..c80ab61f 100644--- a/plugins/agent-development/plugin.json+++ b/plugins/agent-development/plugin.json@@ -3,6 +3,6 @@"description_zh": "基于 Adelie 的智能体开发:用 SDK 构建应用或经 Agent API 接入智能体、经统一的 LLM API 调用任意模型、管理模型与密钥、编排智能体/会话/成本/定时任务。","short_description": "SDK, Agent API, unified LLM API, config and orchestration.","short_description_zh": "SDK、Agent API、统一 LLM API、配置与编排。",- "version": "2026.10.17.1",+ "version": "2026.10.17.2","category": "ai-app-development"}diff --git a/plugins/agent-development/skills/penguin-sdk/reference/agent-api.md b/plugins/agent-development/skills/penguin-sdk/reference/agent-api.mdindex b45d413a..58cee57c 100644--- a/plugins/agent-development/skills/penguin-sdk/reference/agent-api.md+++ b/plugins/agent-development/skills/penguin-sdk/reference/agent-api.md@@ -1,6 +1,6 @@# The API path: a program that calls an Adelie Agent-Read this before you write a program that calls an Adelie Agent over the Agent API. The rules in SKILL.md, *The API path*, hold throughout. The user documentation has every detail: the [Agent API guide](https://penguin.ooo/docs/agent-api) and the [AMSP protocol](https://penguin.ooo/docs/amsp).+Read this before you write a program that calls an Adelie Agent over the Agent API. The rules in SKILL.md, *The API path*, hold throughout. The user documentation has every detail: the [Agent API guide](https://lmliheng.github.io/Adelie/docs/agent-api) and the [AMSP protocol](https://lmliheng.github.io/Adelie/docs/amsp).## 1. Hand the opening to the user