Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
docs: remove Raven-specific manual ZIP install guidance
tt-a1ie93d25263176
diff --git a/README.md b/README.mdindex 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.mdindex 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.mdindex 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.mdindex 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 --copynpx 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.mjsindex 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 = ['','',`当前开发版本:\`v${version}\``,'',- 'Raven 使用 ZIP 手动安装:将 archify.zip 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于 Agent 切换器目标。',].join('\n');const japanese = ['','',`現在の開発版: \`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 = ['','',`当前稳定版本:\`v${version}\``,'',- 'Raven 使用 ZIP 手动安装:将 archify.zip 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于 Agent 切换器目标。',].join('\n');const japanese = ['','',`現在の安定版: \`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 agconst 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 = [- '',- '',- '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': [- '',- '',- '現在の開発版: `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.htmlindex 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&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&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&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&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&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&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.htmlindex 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.mjsindex 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.htmlindex 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.astroindex 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&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&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.astroindex 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.jsindex 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&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&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&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&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':'关闭菜单',