Skip to content

release: v4.9.0 — hybrid 切割 deprecation 期#54

Merged
telagod merged 1 commit into
mainfrom
release/v4.9.0
Jun 26, 2026
Merged

release: v4.9.0 — hybrid 切割 deprecation 期#54
telagod merged 1 commit into
mainfrom
release/v4.9.0

Conversation

@telagod

@telagod telagod commented Jun 25, 2026

Copy link
Copy Markdown
Owner

Summary

v4.9.0 开启 hybrid 切割 deprecation 期:与姊妹项目 abyss CLI 的 v0.5.24 文档定位反转配对,把 claude/codex/gemini 三平台 hook 注入主入口移交给 abyss attach <host>,把 openclaw/pi/hermes 永久保留给 code-abyss npm 包(abyss CLI 设计上不接管这三平台,因 per-pack layout + 不稳定 hook shape)。v5.0 物理切割。

  • Deprecated(v5.0 移除)--with-abyss / --with-mcp / --with-hooks 对 claude/codex/gemini
  • Changed (net-new)--with-hooks 对 openclaw/pi/hermes 自动 spawn skills/indexing-code/hooks/common/install-hooks.sh——abyss 不接管这三平台,所以 --with-hooks 永久保留并真正服务它们
  • 零回归:424 现有 test + 30 verify:skills 全过;所有现有 flag 行为保留,仅加 deprecation warning + 引导

6-host 责任分工(hybrid 切割锁定)

Host Owner Reason
Claude abyss attach 共享 settings.json
Codex abyss attach 共享 config.toml (0.125+ 数组表)
Gemini abyss attach 共享 settings.json
OpenClaw code-abyss per-pack 布局,abyss 二进制无法可靠创建
Pi code-abyss hook shape 跨版本不稳定
Hermes code-abyss hook shape 跨版本不稳定

Migration path

存量用户用 --with-abyss 装过的:
```sh

Old (v4.8.x)

npx code-abyss -t claude --with-abyss --with-mcp --with-hooks

New (v4.9+)

npx code-abyss -t claude -y # persona/skills/style
curl -fsSL https://raw.githubusercontent.com/telagod/abyss/main/install.sh | bash # abyss CLI
abyss attach claude # hook 注入(idempotent)

MCP: 客户端配置加 mcpServers.abyss = { command: "abyss", args: ["mcp"] }

```

openclaw/pi/hermes 用户路径不变:
```sh
npx code-abyss -t openclaw --with-hooks # v4.9 起自动 spawn install-hooks.sh
```

Required follow-up

  • v4.10.0:残留检测——若检测到 ~/.code-abyss/bin/abyss 或 settings.json 含旧 HOOK_MARKER → 主动告警 + 引导 abyss attach <host> --force
  • v5.0.0 (BREAKING):物理删除 bin/lib/abyss-binary.js (107 行) + bin/adapters/codex.js L430-686 (~256 行) + bin/lib/abyss-integration.js 中 claude/gemini inject 函数 + --with-abyss / --with-mcp flag
  • Companion:abyss v0.5.24(telagod/abyss,同步发版)已准备文档定位反转 patch;本 PR 合并前后宜与之同期 release

Test plan

  • npm test → 424/424 passed
  • npm run verify:skills → 30 skills 全过
  • npm run packs:check + packs:vendor:sync --check → 全过
  • Smoke: npx code-abyss --with-abyss --with-mcp --with-hooks -t claude → 三条 DEPRECATED warning 全触发
  • Smoke: npx code-abyss -t openclaw --with-hooks → spawn install-hooks.sh openclaw → hook 已注入
  • CI 全绿(Node 18/20/22 × ubuntu/macos/windows × 4 targets smoke)

abyss CLI v0.5.24+ 文档定位反转后,本版开启 deprecation 期,把
claude/codex/gemini 三平台 hook 注入主入口移交给 `abyss attach <host>`,
把 openclaw/pi/hermes 永久保留给 code-abyss npm 包(abyss 设计上不接管
这三平台,因 per-pack layout + 不稳定 hook shape)。v5.0 物理切割。

Deprecated (v5.0 移除):
- --with-abyss      → 改用 curl install.sh / cargo binstall / @code-abyss/cli
- --with-mcp        → 客户端 MCP 配置直接写 mcpServers.abyss
- --with-hooks 对 claude/codex/gemini → 改用 abyss attach <host>

Changed:
- --with-hooks 对 openclaw/pi/hermes 改造为 spawn install-hooks.sh
  (abyss CLI 不接管这三平台,v5.0 后仍保留)
- finish.js reportAbyssStatus 引导文案改 abyss attach
- SKILL.md L103 字面冲突修复 (v4.8.1 起 hook opt-in)
- README/site/i18n.js/package.json 双源对齐 + 定位漂修复

Compatibility:
- 424 现有 test + 30 verify:skills 零回归
- 所有现有 flag 行为保留,仅加 deprecation warning

Companion: abyss v0.5.24 (telagod/abyss) 同步落地文档定位反转
(src/attach/mod.rs 注释、README、agent-hook.md、CHANGELOG)
@telagod telagod merged commit 0d235fa into main Jun 26, 2026
15 checks passed
@telagod telagod deleted the release/v4.9.0 branch June 26, 2026 04:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant