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 ZIP install guidance from main

tt-a1i527886d321a4
diff --git a/README.md b/README.md
index bd8a6e1d..64790695 100644
--- a/README.md
+++ b/README.md
@@ -191,7 +191,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.
@@ -359,7 +359,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 bd8a6e1d..64790695 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -191,7 +191,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.
@@ -359,7 +359,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_ZH.md b/README_ZH.md
index 5372c8f8..77f168df 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -189,7 +189,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`。
@@ -360,7 +360,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 ca7232c4..059c53b6 100644
--- a/archify/test/release-identity.test.mjs
+++ b/archify/test/release-identity.test.mjs
@@ -48,14 +48,12 @@ 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 files = {
'archify/package.json': JSON.stringify({ version }),
@@ -90,8 +88,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 })) {
@@ -106,14 +104,12 @@ 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 files = {
'archify/package.json': JSON.stringify({ version }),
@@ -144,8 +140,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 })) {
@@ -367,7 +363,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);
@@ -385,7 +381,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'),
});
@@ -397,7 +392,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, {
@@ -410,30 +405,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/);
+ assert.match(result.stderr, /docs\/start\.html: Raven is not an agent-switcher target/);
} finally {
fs.rmSync(fixture, { recursive: true, force: true });
}
diff --git a/docs/index.html b/docs/index.html
index fa981b6f..1d70bdef 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 60e93eeb..e4922279 100644
--- a/docs/start.html
+++ b/docs/start.html
@@ -247,7 +247,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 8aa7e0c8..238a8b7b 100644
--- a/scripts/check-release-identity.mjs
+++ b/scripts/check-release-identity.mjs
@@ -101,47 +101,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 hasRequiredCopy = language === 'both'
- ? hasEnglishManual && hasChineseManual
- : language === 'zh' ? hasChineseManual : 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 hasCorrectDestination = language === 'both'
- ? englishExtractsIntoParent && englishExplainsInstalledRoot
- && chineseExtractsIntoParent && chineseExplainsInstalledRoot
- : language === 'zh'
- ? chineseExtractsIntoParent && chineseExplainsInstalledRoot
- : englishExtractsIntoParent && englishExplainsInstalledRoot;
- const nestedDestination = new RegExp(
- String.raw`(?:\b(?:extract|unpack)[^\n]{0,220}(?:into|to)|解压(?:到|至))\s*[\x60'"<]*${installedRoot}`,
- '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.`);
}
}
@@ -252,9 +214,9 @@ if (hasSupportedVersion) {
checkReadme('README.md', english, version, 'en', isDevelopment);
checkReadme('README_EN.md', englishMirror, version, 'en', isDevelopment);
checkReadme('README_ZH.md', chinese, version, 'zh', isDevelopment);
- checkRavenBoundary('README.md', english, 'en');
- checkRavenBoundary('README_EN.md', englishMirror, 'en');
- checkRavenBoundary('README_ZH.md', chinese, 'zh');
+ for (const [path, content] of [['README.md', english], ['README_EN.md', englishMirror], ['README_ZH.md', chinese]]) {
+ checkNoRavenSwitcher(path, content);
+ }
if (english !== englishMirror) fail('README_EN.md must remain byte-identical to README.md.');
if (newestStableLabel && isDevelopment) {
@@ -267,7 +229,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) {
@@ -276,7 +238,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 66e98599..915c777f 100644
--- a/scripts/start-template.html
+++ b/scripts/start-template.html
@@ -247,7 +247,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 80febf2e..96657fa7 100644
--- a/website/src/pages/start.astro
+++ b/website/src/pages/start.astro
@@ -64,7 +64,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':'关闭菜单',