Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

docs: remove Raven-specific manual ZIP install guidance

tt-a1ie93d25263176
diff --git a/README.md b/README.md
index 5fb9c88d..08f357bd 100644
--- a/README.md
+++ b/README.md
@@ -192,7 +192,7 @@ npx skills use tt-a1i/archify@archify --agent codex
[DSH community opt-in](integrations/deepseek-harness/README.md): `dsh plugin --profile web add @tt-a1i/[email protected]`
-The [agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, and `opencode`. For Raven's manual ZIP install, extract [`archify.zip`](archify.zip) into `~/.raven/workspace/skills`; it yields `~/.raven/workspace/skills/archify`. Raven is not a switcher target.
+The [agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, and `opencode`.
Archify may GET the fixed stable manifest solely to show an optional reminder; it never downloads or installs updates. Successful checks wait about 72 hours (±20%); active use retries failures after 6, then 24 hours. The server sees normal HTTP metadata (IP and time), but receives no version, Agent, project data, prompts, account/device ID, or ETag. You decide whether and when to update. Set `ARCHIFY_UPDATE_CHECK_DISABLED=1` to disable networking and reminder-state writes.
@@ -360,7 +360,6 @@ The complete generation and viewer contract lives in [`archify/SKILL.md`](archif
| Surface | Install location or method | Capability |
|---|---|---|
-| **Raven** | Manual ZIP into `~/.raven/workspace/skills` → `~/.raven/workspace/skills/archify` | Full renderer + validation workflow |
| **Claude Code** | `~/.claude/skills/` or `.claude/skills/` | Full renderer + validation workflow |
| **Codex CLI** | `~/.agents/skills/` or `.agents/skills/` | Full renderer + validation workflow |
| **opencode** | `~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/` | Full renderer + validation workflow |
diff --git a/README_EN.md b/README_EN.md
index 5fb9c88d..08f357bd 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -192,7 +192,7 @@ npx skills use tt-a1i/archify@archify --agent codex
[DSH community opt-in](integrations/deepseek-harness/README.md): `dsh plugin --profile web add @tt-a1i/[email protected]`
-The [agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, and `opencode`. For Raven's manual ZIP install, extract [`archify.zip`](archify.zip) into `~/.raven/workspace/skills`; it yields `~/.raven/workspace/skills/archify`. Raven is not a switcher target.
+The [agent switcher](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, and `opencode`.
Archify may GET the fixed stable manifest solely to show an optional reminder; it never downloads or installs updates. Successful checks wait about 72 hours (±20%); active use retries failures after 6, then 24 hours. The server sees normal HTTP metadata (IP and time), but receives no version, Agent, project data, prompts, account/device ID, or ETag. You decide whether and when to update. Set `ARCHIFY_UPDATE_CHECK_DISABLED=1` to disable networking and reminder-state writes.
@@ -360,7 +360,6 @@ The complete generation and viewer contract lives in [`archify/SKILL.md`](archif
| Surface | Install location or method | Capability |
|---|---|---|
-| **Raven** | Manual ZIP into `~/.raven/workspace/skills` → `~/.raven/workspace/skills/archify` | Full renderer + validation workflow |
| **Claude Code** | `~/.claude/skills/` or `.claude/skills/` | Full renderer + validation workflow |
| **Codex CLI** | `~/.agents/skills/` or `.agents/skills/` | Full renderer + validation workflow |
| **opencode** | `~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/` | Full renderer + validation workflow |
diff --git a/README_JA.md b/README_JA.md
index 9de7fa6d..a646d00b 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -192,7 +192,7 @@ npx skills use tt-a1i/archify@archify --agent codex
[DSH コミュニティ版(任意)](integrations/deepseek-harness/README.md): `dsh plugin --profile web add @tt-a1i/[email protected]`
-[エージェント切り替え](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture)は `cursor`、`codex`、`claude-code`、`opencode` に対応しています。Raven に手動 ZIP でインストールする場合は、[`archify.zip`](archify.zip) を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven は切り替え対象には含まれません。
+[エージェント切り替え](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture)は `cursor`、`codex`、`claude-code`、`opencode` に対応しています。
Archify は固定の安定版マニフェストを GET して任意の更新リマインダーを表示することがありますが、更新をダウンロードしたりインストールしたりすることはありません。チェックに成功すると次回まで約 72 時間(±20%)待機し、失敗した場合はアクティブに使用していれば 6 時間後、その後は 24 時間後に再試行します。サーバーが受け取るのは通常の HTTP メタデータ(IP と時刻)だけで、バージョン、Agent、プロジェクトデータ、プロンプト、アカウント/デバイス ID、ETag は送信されません。更新するかどうか、いつ更新するかは常にあなたが決めます。`ARCHIFY_UPDATE_CHECK_DISABLED=1` を設定すると、ネットワーク通信とリマインダー状態の書き込みを無効化できます。
@@ -360,7 +360,6 @@ node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tm
| 環境 | インストール先または方法 | 機能 |
|---|---|---|
-| **Raven** | `~/.raven/workspace/skills` に手動で ZIP 展開 → `~/.raven/workspace/skills/archify` | レンダラー + 検証ワークフローのフル機能 |
| **Claude Code** | `~/.claude/skills/` または `.claude/skills/` | レンダラー + 検証ワークフローのフル機能 |
| **Codex CLI** | `~/.agents/skills/` または `.agents/skills/` | レンダラー + 検証ワークフローのフル機能 |
| **opencode** | `~/.config/opencode/skills/`、`.opencode/skills/`、または `.agents/skills/` | レンダラー + 検証ワークフローのフル機能 |
diff --git a/README_ZH.md b/README_ZH.md
index bf8f0353..2ae2a214 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -190,7 +190,7 @@ npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy
npx skills use tt-a1i/archify@archify --agent codex
```
-DeepSeek Harness(社区集成、显式启用):运行 `dsh plugin --profile web add @tt-a1i/[email protected]`;参见[兼容范围、限制与安全说明](integrations/deepseek-harness/README.md)。[Agent 切换器](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture)只为 `cursor`、`codex`、`claude-code` 和 `opencode` 生成命令。Raven 仅支持 ZIP 手动安装:将 [`archify.zip`](archify.zip) 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于切换器目标。
+DeepSeek Harness(社区集成、显式启用):运行 `dsh plugin --profile web add @tt-a1i/[email protected]`;参见[兼容范围、限制与安全说明](integrations/deepseek-harness/README.md)。[Agent 切换器](https://tt-a1i.github.io/archify/start.html?agent=cursor&type=architecture)只为 `cursor`、`codex`、`claude-code` 和 `opencode` 生成命令。
安装后的 Skill 包含一个低频、失败静默的发布检查,它最多只显示可选更新提醒,绝不会自行下载或安装更新。一次成功检查后,下次网络请求通常约在 72 小时(±20%)后发出;检查失败后,活跃使用可能在首次 6 小时、后续 24 小时退避到期时重试。请求只访问 `https://tt-a1i.github.io/archify/skill-updates/archify/stable.json`。服务端会自然获得 IP、请求时间和常规 HTTP 元数据;检查器不会发送本地版本、Agent、项目数据、用户输入、账户/设备标识,也不会保存或回传 ETag。是否更新以及何时更新始终由你决定。如需完全关闭检查(包括网络请求和提醒状态写入),请在 Agent 环境中设置 `ARCHIFY_UPDATE_CHECK_DISABLED=1`。
@@ -361,7 +361,6 @@ node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tm
| 使用位置 | 安装位置或方法 | 能力 |
|---|---|---|
-| **Raven** | ZIP 手动安装:将 `archify.zip` 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify` | 完整 Renderer + Validation 工作流 |
| **Claude Code** | `~/.claude/skills/` 或 `.claude/skills/` | 完整 Renderer + Validation 工作流 |
| **Codex CLI** | `~/.agents/skills/` 或 `.agents/skills/` | 完整 Renderer + Validation 工作流 |
| **opencode** | `~/.config/opencode/skills/`、`.opencode/skills/` 或 `.agents/skills/` | 完整 Renderer + Validation 工作流 |
diff --git a/archify/test/release-identity.test.mjs b/archify/test/release-identity.test.mjs
index 0c8e1fe5..14a45ce9 100644
--- a/archify/test/release-identity.test.mjs
+++ b/archify/test/release-identity.test.mjs
@@ -48,21 +48,18 @@ function writeValidDevelopmentFixture(root, overrides = {}) {
'',
`Current development version: \`v${version}\``,
'',
- 'Raven uses manual ZIP installation: extract archify.zip into `~/.raven/workspace/skills`, which yields `~/.raven/workspace/skills/archify`; Raven is not an agent-switcher target.',
].join('\n');
const chinese = [
'![开发版本](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
'',
`当前开发版本:\`v${version}\``,
'',
- 'Raven 使用 ZIP 手动安装:将 archify.zip 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于 Agent 切换器目标。',
].join('\n');
const japanese = [
'![開発版](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
'',
`現在の開発版: \`v${version}\``,
'',
- 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven はエージェント切り替えの対象ではありません。',
].join('\n');
const files = {
'archify/package.json': JSON.stringify({ version }),
@@ -98,8 +95,8 @@ function writeValidDevelopmentFixture(root, overrides = {}) {
'scripts/start-template.html': 'development · 开发版 · [[ARCHIFY_VERSION]]',
'scripts/guide-template.html': 'development · 开发版 · [[ARCHIFY_VERSION]]',
'scripts/gallery-template.html': 'development · 开发版 · [[ARCHIFY_VERSION]]',
- 'docs/index.html': `<span>development · v${version} · 开发版 · 9/9 checks</span><p>Raven manual ZIP / ZIP 手动安装: extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify; 将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify; not an agent-switcher target.</p>`,
- 'docs/start.html': `<span>development · v${version} · 开发版</span><p>Raven manual ZIP / ZIP 手动安装: extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify; 将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify; not an agent-switcher target.</p>`,
+ 'docs/index.html': `<span>development · v${version} · 开发版 · 9/9 checks</span>`,
+ 'docs/start.html': `<span>development · v${version} · 开发版</span>`,
'ROADMAP.md': `The current development line is \`v${version}\`; it contains the work under Changelog Unreleased and is not a stable release.`,
};
for (const [relativePath, content] of Object.entries({ ...files, ...overrides })) {
@@ -114,21 +111,18 @@ function writeValidStableFixture(root, overrides = {}) {
'',
`Current stable version: \`v${version}\``,
'',
- 'Raven uses manual ZIP installation: extract archify.zip into `~/.raven/workspace/skills`, which yields `~/.raven/workspace/skills/archify`; Raven is not an agent-switcher target.',
].join('\n');
const chinese = [
'![稳定版本](https://img.shields.io/badge/version-2.13.0-blue)',
'',
`当前稳定版本:\`v${version}\``,
'',
- 'Raven 使用 ZIP 手动安装:将 archify.zip 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于 Agent 切换器目标。',
].join('\n');
const japanese = [
'![安定版](https://img.shields.io/badge/version-2.13.0-blue)',
'',
`現在の安定版: \`v${version}\``,
'',
- 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven はエージェント切り替えの対象ではありません。',
].join('\n');
const files = {
'archify/package.json': JSON.stringify({ version }),
@@ -160,8 +154,8 @@ function writeValidStableFixture(root, overrides = {}) {
'scripts/start-template.html': 'stable · 稳定版 · [[ARCHIFY_VERSION]]',
'scripts/guide-template.html': 'stable · 稳定版 · [[ARCHIFY_VERSION]]',
'scripts/gallery-template.html': 'stable · 稳定版 · [[ARCHIFY_VERSION]]',
- 'docs/index.html': `<span>stable · v${version} · 稳定版 · 9/9 checks</span><p>Raven manual ZIP / ZIP 手动安装: extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify; 将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify; not an agent-switcher target.</p>`,
- 'docs/start.html': `<span>stable · v${version} · 稳定版</span><p>Raven manual ZIP / ZIP 手动安装: extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify; 将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify; not an agent-switcher target.</p>`,
+ 'docs/index.html': `<span>stable · v${version} · 稳定版 · 9/9 checks</span>`,
+ 'docs/start.html': `<span>stable · v${version} · 稳定版</span>`,
'ROADMAP.md': `The current stable version is \`v${version}\`.`,
};
for (const [relativePath, content] of Object.entries({ ...files, ...overrides })) {
@@ -385,7 +379,7 @@ test('landing proof receipt matches the current nine-check artifact contract', (
const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));
try {
writeValidDevelopmentFixture(fixture, {
- 'docs/index.html': '<span>development · v2.13.0-dev.0 · 开发版 · 8/8 checks</span><p>Raven manual ZIP / ZIP 手动安装: extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify; 将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify; not an agent-switcher target.</p>',
+ 'docs/index.html': '<span>development · v2.13.0-dev.0 · 开发版 · 8/8 checks</span>',
});
const result = runCheck(fixture);
@@ -403,7 +397,6 @@ test('landing rejects every stale N/N contract count even when 9/9 is also prese
'docs/index.html': [
'<span>development · v2.13.0-dev.0 · 开发版 · 9/9 checks</span>',
'<span>legacy receipt · 7/7 checks</span>',
- '<p>Raven manual ZIP / ZIP 手动安装: extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify; 将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify; not an agent-switcher target.</p>',
].join('\n'),
});
@@ -415,7 +408,7 @@ test('landing rejects every stale N/N contract count even when 9/9 is also prese
}
});
-test('Raven stays a truthful manual ZIP install and never becomes a generated agent-switcher command', () => {
+test('Raven is not a generated agent-switcher target', () => {
const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));
try {
writeValidDevelopmentFixture(fixture, {
@@ -428,51 +421,7 @@ test('Raven stays a truthful manual ZIP install and never becomes a generated ag
const result = runCheck(fixture);
assert.notEqual(result.status, 0);
- assert.match(result.stderr, /Raven must remain a manual ZIP installation outside the agent switcher/);
- } finally {
- fs.rmSync(fixture, { recursive: true, force: true });
- }
-});
-
-test('Raven instructions reject extracting the archive into the final Skill directory', () => {
- const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));
- try {
- const nestedEnglish = [
- '![Development Version](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
- '',
- 'Current development version: `v2.13.0-dev.0`',
- '',
- 'Raven is manual ZIP only: extract archify.zip into `~/.raven/workspace/skills/archify`; Raven is not an agent-switcher target.',
- ].join('\n');
- writeValidDevelopmentFixture(fixture, {
- 'README.md': nestedEnglish,
- 'README_EN.md': nestedEnglish,
- });
-
- const result = runCheck(fixture);
- assert.notEqual(result.status, 0);
- assert.match(result.stderr, /extract archify\.zip into ~\/\.raven\/workspace\/skills, yielding ~\/\.raven\/workspace\/skills\/archify/);
- } finally {
- fs.rmSync(fixture, { recursive: true, force: true });
- }
-});
-
-test('Japanese Raven instructions reject extracting the archive into the final Skill directory', () => {
- const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));
- try {
- writeValidDevelopmentFixture(fixture, {
- 'README_JA.md': [
- '![開発版](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
- '',
- '現在の開発版: `v2.13.0-dev.0`',
- '',
- 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills/archify` に展開してください。Raven はエージェント切り替えの対象ではありません。',
- ].join('\n'),
- });
-
- const result = runCheck(fixture);
- assert.notEqual(result.status, 0);
- assert.match(result.stderr, /README_JA\.md: Raven must remain a manual ZIP installation outside the agent switcher/);
+ assert.match(result.stderr, /docs\/start\.html: Raven is not an agent-switcher target/);
} finally {
fs.rmSync(fixture, { recursive: true, force: true });
}
@@ -487,7 +436,6 @@ test('the Japanese README must carry its own development marker, not the English
'',
'Current development version: `v2.13.0-dev.0`',
'',
- 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven はエージェント切り替えの対象ではありません。',
].join('\n'),
});
diff --git a/docs/index.html b/docs/index.html
index 17747e04..27e5808c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -733,7 +733,7 @@
<div class="fade-up" style="margin-bottom:2.75rem">
<div class="section-label" data-i18n="label-qs">Quick Start</div>
<h2 class="section-heading" data-i18n="qs-h2">Up and running<br>in three steps.</h2>
- <p class="section-body" data-i18n="qs-body">One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands; for Raven, extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.</p>
+ <p class="section-body" data-i18n="qs-body">One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands.</p>
</div>
<div class="quickstart-layout">
<div class="qs-card fade-up d1">
@@ -742,7 +742,7 @@
<div class="step-num">1</div>
<div class="step-content">
<h4 data-i18n="step1-h">Install in one command</h4>
- <p data-i18n="step1-p">Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command. Raven is not a switcher target; for a manual ZIP install, extract archify.zip into <code>~/.raven/workspace/skills</code>, which yields <code>~/.raven/workspace/skills/archify</code>.</p>
+ <p data-i18n="step1-p">Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command.</p>
</div>
</div>
<div class="step">
@@ -890,8 +890,8 @@
'chip-external':'External','chip-external-use':'Users, 3rd parties, generic',
'label-qs':'Quick Start',
'qs-h2':'Up and running<br>in three steps.',
- 'qs-body':'One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands; for Raven, extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.',
- 'step1-h':'Install in one command','step1-p':'Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command. Raven is not a switcher target; for a manual ZIP install, extract archify.zip into <code>~/.raven/workspace/skills</code>, which yields <code>~/.raven/workspace/skills/archify</code>.',
+ 'qs-body':'One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands.',
+ 'step1-h':'Install in one command','step1-p':'Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command.',
'step2-h':'Describe your system','step2-p':'Describe components, connections, and cloud services — or ask your agent to analyze the repository first.',
'step3-h':'Ask your agent to draw it','step3-p':'Tell your agent to use Archify. It generates a self-contained HTML file you can open in any browser and refine in chat.',
'kbd-label':'Keyboard shortcuts','kbd-guide':'Diagram guide','kbd-theme':'Toggle theme','kbd-find':'Find node / route endpoint','kbd-route':'Trace, inspect, and play a route','kbd-radar':'Semantic radar','kbd-lens':'Compare semantic kinds','kbd-present':'Presentation stage','kbd-export':'Open export menu','kbd-focus':'Focus node','kbd-views':'Guided views','kbd-play':'Play story','kbd-zoom':'Reading depth / reset','kbd-nav':'Navigate menu','kbd-close':'Close menu',
@@ -950,8 +950,8 @@
'chip-external':'外部系统','chip-external-use':'用户、第三方、通用外部',
'label-qs':'快速开始',
'qs-h2':'三步上手,<br>即刻运行。',
- 'qs-body':'同一份经过检查的 Skill 可用于 Cursor、Claude Code、Codex 和 OpenCode,切换器会生成准确命令;Raven 采用 ZIP 手动安装:将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify。',
- 'step1-h':'一条命令安装','step1-p':'运行 <code>npx skills add tt-a1i/archify -g</code>,或打开<a href="start.html?agent=cursor&amp;type=architecture">可切换 Agent 的快速开始页</a>,获取准确的 Cursor、Codex、Claude Code 或 OpenCode 命令。Raven 不属于切换器目标;请将 archify.zip 解压到 <code>~/.raven/workspace/skills</code>,解压后会得到 <code>~/.raven/workspace/skills/archify</code>。',
+ 'qs-body':'同一份经过检查的 Skill 可用于 Cursor、Claude Code、Codex 和 OpenCode,切换器会生成准确命令。',
+ 'step1-h':'一条命令安装','step1-p':'运行 <code>npx skills add tt-a1i/archify -g</code>,或打开<a href="start.html?agent=cursor&amp;type=architecture">可切换 Agent 的快速开始页</a>,获取准确的 Cursor、Codex、Claude Code 或 OpenCode 命令。',
'step2-h':'描述你的系统','step2-p':'描述组件、连接关系和云服务,也可以先让 agent 分析代码仓库。',
'step3-h':'让 agent 绘制','step3-p':'告诉 agent 使用 Archify,它会生成可在任意浏览器打开的单文件 HTML,并可继续在对话中迭代。',
'kbd-label':'键盘快捷键','kbd-guide':'图表指南','kbd-theme':'切换主题','kbd-find':'查找节点 / 路径端点','kbd-route':'探查、检查并播放路径','kbd-radar':'语义雷达','kbd-lens':'对比语义类型','kbd-present':'演示舞台','kbd-export':'打开导出菜单','kbd-focus':'聚焦节点','kbd-views':'引导视图','kbd-play':'播放故事','kbd-zoom':'阅读层级 / 复位','kbd-nav':'菜单导航','kbd-close':'关闭菜单',
diff --git a/docs/start.html b/docs/start.html
index 0b0effe0..0f5db6ce 100644
--- a/docs/start.html
+++ b/docs/start.html
@@ -248,7 +248,6 @@
<div class="command-bar"><span data-en="This repository only" data-zh="仅安装到当前仓库">This repository only</span><button class="copy-button" type="button" data-copy-source="project-command" data-en="Copy" data-zh="复制">Copy</button></div>
<pre id="project-command">npx -y skills add tt-a1i/archify --skill archify --agent codex --copy --yes</pre>
</div>
- <p class="secondary-note" data-en="Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify." data-zh="Raven 采用 ZIP 手动安装,不使用 Agent 切换器生成命令。将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify。">Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.</p>
<p class="secondary-note" data-en="The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded." data-zh="Start 链接只携带 Agent、语言、图表类型、输入模式和粗粒度来源标签。转化步骤只保存在当前浏览器会话中,Archify 不会发送这些数据,也不会记录仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded.</p>
</article>
diff --git a/scripts/check-release-identity.mjs b/scripts/check-release-identity.mjs
index 699cf642..dc4c72d0 100644
--- a/scripts/check-release-identity.mjs
+++ b/scripts/check-release-identity.mjs
@@ -105,64 +105,9 @@ function checkDocument(relativePath, source, version, isDevelopment) {
}
}
-function checkRavenBoundary(relativePath, source, language) {
- const installParent = String.raw`~\/\.raven\/workspace\/skills`;
- const installedRoot = `${installParent}\/archify`;
- const pathBoundary = String.raw`(?=$|[\s\x60'"<>,.;:,;。])`;
- const hasEnglishManual = /manual ZIP/i.test(source);
- const hasChineseManual = /(?:手动[^\n<]{0,40}ZIP|ZIP[^\n<]{0,40}手动)/i.test(source);
- const hasJapaneseManual = /(?:手動[^\n<]{0,40}ZIP|ZIP[^\n<]{0,40}手動)/i.test(source);
- const hasRequiredCopy = language === 'both'
- ? hasEnglishManual && hasChineseManual
- : language === 'zh' ? hasChineseManual
- : language === 'ja' ? hasJapaneseManual
- : hasEnglishManual;
- const englishExtractsIntoParent = new RegExp(
- String.raw`(?:extract|unpack)[^\n]{0,180}archify\.zip[^\n]{0,180}(?:into|to)\s*[\x60'"<]*${installParent}${pathBoundary}`,
- 'i',
- ).test(source);
- const englishExplainsInstalledRoot = new RegExp(
- String.raw`(?:yields?|creates?|produces?|results? in)[^\n]{0,120}${installedRoot}`,
- 'i',
- ).test(source);
- const chineseExtractsIntoParent = new RegExp(
- String.raw`archify\.zip[^\n]{0,100}解压(?:到|至)\s*[\x60'"<]*${installParent}${pathBoundary}`,
- 'i',
- ).test(source);
- const chineseExplainsInstalledRoot = new RegExp(
- String.raw`(?:得到|生成|产生|最终位于)[^\n]{0,120}${installedRoot}`,
- 'i',
- ).test(source);
- const japaneseExtractsIntoParent = new RegExp(
- String.raw`archify\.zip[^\n]{0,120}[\x60'"<]*${installParent}${pathBoundary}[^\n]{0,20}(?:に|へ)\s*(?:展開|解凍)`,
- 'i',
- ).test(source);
- const japaneseExplainsInstalledRoot = new RegExp(
- String.raw`${installedRoot}[^\n]{0,40}(?:が|は)[^\n]{0,20}(?:作成|生成|でき)`,
- 'i',
- ).test(source);
- const hasCorrectDestination = language === 'both'
- ? englishExtractsIntoParent && englishExplainsInstalledRoot
- && chineseExtractsIntoParent && chineseExplainsInstalledRoot
- : language === 'zh'
- ? chineseExtractsIntoParent && chineseExplainsInstalledRoot
- : language === 'ja'
- ? japaneseExtractsIntoParent && japaneseExplainsInstalledRoot
- : englishExtractsIntoParent && englishExplainsInstalledRoot;
- const nestedDestination = new RegExp(
- String.raw`(?:\b(?:extract|unpack)[^\n]{0,220}(?:into|to)|解压(?:到|至))\s*[\x60'"<]*${installedRoot}`,
- 'i',
- ).test(source)
- || new RegExp(
- String.raw`${installedRoot}[^\n]{0,4}(?:に|へ)[^\n]{0,4}(?:展開|解凍)`,
- 'i',
- ).test(source);
- const inventsSwitcher = /data-agent=["']raven["']/i.test(source)
- || /--agent\s+raven\b/i.test(source)
- || /[?&]agent=raven\b/i.test(source);
- if (!/Raven/i.test(source) || !hasRequiredCopy || !hasCorrectDestination
- || nestedDestination || inventsSwitcher) {
- fail(`${relativePath}: Raven must remain a manual ZIP installation outside the agent switcher: extract archify.zip into ~/.raven/workspace/skills, yielding ~/.raven/workspace/skills/archify.`);
+function checkNoRavenSwitcher(relativePath, source) {
+ if (/data-agent=["']raven["']|--agent\s+raven\b|[?&]agent=raven\b/i.test(source)) {
+ fail(`${relativePath}: Raven is not an agent-switcher target.`);
}
}
@@ -275,10 +220,9 @@ if (hasSupportedVersion) {
checkReadme('README_EN.md', englishMirror, version, 'en', isDevelopment);
checkReadme('README_ZH.md', chinese, version, 'zh', isDevelopment);
checkReadme('README_JA.md', japanese, version, 'ja', isDevelopment);
- checkRavenBoundary('README.md', english, 'en');
- checkRavenBoundary('README_EN.md', englishMirror, 'en');
- checkRavenBoundary('README_ZH.md', chinese, 'zh');
- checkRavenBoundary('README_JA.md', japanese, 'ja');
+ for (const [path, content] of [['README.md', english], ['README_EN.md', englishMirror], ['README_ZH.md', chinese], ['README_JA.md', japanese]]) {
+ checkNoRavenSwitcher(path, content);
+ }
if (english !== englishMirror) fail('README_EN.md must remain byte-identical to README.md.');
if (newestStableLabel && isDevelopment) {
@@ -291,7 +235,7 @@ if (hasSupportedVersion) {
const landing = read('docs/index.html');
checkDocument('docs/index.html', landing, version, isDevelopment);
- checkRavenBoundary('docs/index.html', landing, 'both');
+ checkNoRavenSwitcher('docs/index.html', landing);
const proofCounts = [...landing.matchAll(/\b\d+\/\d+\b/g)].map((match) => match[0]);
const staleProofCounts = [...new Set(proofCounts.filter((count) => count !== '9/9'))];
if (proofCounts.length === 0 || staleProofCounts.length > 0) {
@@ -300,7 +244,7 @@ if (hasSupportedVersion) {
}
const start = read('docs/start.html');
checkDocument('docs/start.html', start, version, isDevelopment);
- checkRavenBoundary('docs/start.html', start, 'both');
+ checkNoRavenSwitcher('docs/start.html', start);
checkRoadmap('ROADMAP.md', read('ROADMAP.md'), version, isDevelopment);
for (const templatePath of [
diff --git a/scripts/start-template.html b/scripts/start-template.html
index 1f73d7e8..234b58ce 100644
--- a/scripts/start-template.html
+++ b/scripts/start-template.html
@@ -248,7 +248,6 @@
<div class="command-bar"><span data-en="This repository only" data-zh="仅安装到当前仓库">This repository only</span><button class="copy-button" type="button" data-copy-source="project-command" data-en="Copy" data-zh="复制">Copy</button></div>
<pre id="project-command">npx -y skills add tt-a1i/archify --skill archify --agent codex --copy --yes</pre>
</div>
- <p class="secondary-note" data-en="Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify." data-zh="Raven 采用 ZIP 手动安装,不使用 Agent 切换器生成命令。将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify。">Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.</p>
<p class="secondary-note" data-en="The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded." data-zh="Start 链接只携带 Agent、语言、图表类型、输入模式和粗粒度来源标签。转化步骤只保存在当前浏览器会话中,Archify 不会发送这些数据,也不会记录仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded.</p>
</article>
diff --git a/website/src/pages/index.astro b/website/src/pages/index.astro
index 407720a7..42f241aa 100644
--- a/website/src/pages/index.astro
+++ b/website/src/pages/index.astro
@@ -361,7 +361,7 @@ import pageScript from '../scripts/index.js?raw';
<div class="fade-up" style="margin-bottom:2.75rem">
<div class="section-label" data-i18n="label-qs">Quick Start</div>
<h2 class="section-heading" data-i18n="qs-h2">Up and running<br>in three steps.</h2>
- <p class="section-body" data-i18n="qs-body">One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands; for Raven, extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.</p>
+ <p class="section-body" data-i18n="qs-body">One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands.</p>
</div>
<div class="quickstart-layout">
<div class="qs-card fade-up d1">
@@ -370,7 +370,7 @@ import pageScript from '../scripts/index.js?raw';
<div class="step-num">1</div>
<div class="step-content">
<h4 data-i18n="step1-h">Install in one command</h4>
- <p data-i18n="step1-p">Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command. Raven is not a switcher target; for a manual ZIP install, extract archify.zip into <code>~/.raven/workspace/skills</code>, which yields <code>~/.raven/workspace/skills/archify</code>.</p>
+ <p data-i18n="step1-p">Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command.</p>
</div>
</div>
<div class="step">
diff --git a/website/src/pages/start.astro b/website/src/pages/start.astro
index 77c88719..fd16d7b2 100644
--- a/website/src/pages/start.astro
+++ b/website/src/pages/start.astro
@@ -65,7 +65,6 @@ import pageScript from '../scripts/start.js?raw';
<div class="command-bar"><span data-en="This repository only" data-zh="仅安装到当前仓库">This repository only</span><button class="copy-button" type="button" data-copy-source="project-command" data-en="Copy" data-zh="复制">Copy</button></div>
<pre id="project-command">npx -y skills add tt-a1i/archify --skill archify --agent codex --copy --yes</pre>
</div>
- <p class="secondary-note" data-en="Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify." data-zh="Raven 采用 ZIP 手动安装,不使用 Agent 切换器生成命令。将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify。">Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.</p>
<p class="secondary-note" data-en="The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded." data-zh="Start 链接只携带 Agent、语言、图表类型、输入模式和粗粒度来源标签。转化步骤只保存在当前浏览器会话中,Archify 不会发送这些数据,也不会记录仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded.</p>
</article>
diff --git a/website/src/scripts/index.js b/website/src/scripts/index.js
index 1732048d..fcc340a0 100644
--- a/website/src/scripts/index.js
+++ b/website/src/scripts/index.js
@@ -52,8 +52,8 @@
'chip-external':'External','chip-external-use':'Users, 3rd parties, generic',
'label-qs':'Quick Start',
'qs-h2':'Up and running<br>in three steps.',
- 'qs-body':'One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands; for Raven, extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.',
- 'step1-h':'Install in one command','step1-p':'Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command. Raven is not a switcher target; for a manual ZIP install, extract archify.zip into <code>~/.raven/workspace/skills</code>, which yields <code>~/.raven/workspace/skills/archify</code>.',
+ 'qs-body':'One checked Skill for Cursor, Claude Code, Codex, and OpenCode. Their switcher generates exact commands.',
+ 'step1-h':'Install in one command','step1-p':'Run <code>npx skills add tt-a1i/archify -g</code>, or open the <a href="start.html?agent=cursor&amp;type=architecture">agent-aware quick start</a> for an exact Cursor, Codex, Claude Code, or OpenCode command.',
'step2-h':'Describe your system','step2-p':'Describe components, connections, and cloud services — or ask your agent to analyze the repository first.',
'step3-h':'Ask your agent to draw it','step3-p':'Tell your agent to use Archify. It generates a self-contained HTML file you can open in any browser and refine in chat.',
'kbd-label':'Keyboard shortcuts','kbd-guide':'Diagram guide','kbd-theme':'Toggle theme','kbd-find':'Find node / route endpoint','kbd-route':'Trace, inspect, and play a route','kbd-radar':'Semantic radar','kbd-lens':'Compare semantic kinds','kbd-present':'Presentation stage','kbd-export':'Open export menu','kbd-focus':'Focus node','kbd-views':'Guided views','kbd-play':'Play story','kbd-zoom':'Reading depth / reset','kbd-nav':'Navigate menu','kbd-close':'Close menu',
@@ -112,8 +112,8 @@
'chip-external':'外部系统','chip-external-use':'用户、第三方、通用外部',
'label-qs':'快速开始',
'qs-h2':'三步上手,<br>即刻运行。',
- 'qs-body':'同一份经过检查的 Skill 可用于 Cursor、Claude Code、Codex 和 OpenCode,切换器会生成准确命令;Raven 采用 ZIP 手动安装:将 archify.zip 解压到 ~/.raven/workspace/skills,解压后会得到 ~/.raven/workspace/skills/archify。',
- 'step1-h':'一条命令安装','step1-p':'运行 <code>npx skills add tt-a1i/archify -g</code>,或打开<a href="start.html?agent=cursor&amp;type=architecture">可切换 Agent 的快速开始页</a>,获取准确的 Cursor、Codex、Claude Code 或 OpenCode 命令。Raven 不属于切换器目标;请将 archify.zip 解压到 <code>~/.raven/workspace/skills</code>,解压后会得到 <code>~/.raven/workspace/skills/archify</code>。',
+ 'qs-body':'同一份经过检查的 Skill 可用于 Cursor、Claude Code、Codex 和 OpenCode,切换器会生成准确命令。',
+ 'step1-h':'一条命令安装','step1-p':'运行 <code>npx skills add tt-a1i/archify -g</code>,或打开<a href="start.html?agent=cursor&amp;type=architecture">可切换 Agent 的快速开始页</a>,获取准确的 Cursor、Codex、Claude Code 或 OpenCode 命令。',
'step2-h':'描述你的系统','step2-p':'描述组件、连接关系和云服务,也可以先让 agent 分析代码仓库。',
'step3-h':'让 agent 绘制','step3-p':'告诉 agent 使用 Archify,它会生成可在任意浏览器打开的单文件 HTML,并可继续在对话中迭代。',
'kbd-label':'键盘快捷键','kbd-guide':'图表指南','kbd-theme':'切换主题','kbd-find':'查找节点 / 路径端点','kbd-route':'探查、检查并播放路径','kbd-radar':'语义雷达','kbd-lens':'对比语义类型','kbd-present':'演示舞台','kbd-export':'打开导出菜单','kbd-focus':'聚焦节点','kbd-views':'引导视图','kbd-play':'播放故事','kbd-zoom':'阅读层级 / 复位','kbd-nav':'菜单导航','kbd-close':'关闭菜单',