Add bilingual documentation and screenshot

Author: s1oopX

.gitignore

@@ -9,5 +9,7 @@ Thumbs.db
 *.jpeg
 *.webp
 *.gif
+!assets/
+!assets/screenshot.png
 outputs/
 work/

README.en.md

@@ -0,0 +1,79 @@
+# Codex API Switchboard
+
+Default language: [简体中文](README.md) | English
+
+A privacy-first static utility for generating a complete Codex configuration TXT when switching custom API providers.
+
+[Live demo](https://codex-config-txt.pages.dev)
+
+![Codex API Switchboard interface screenshot](assets/screenshot.png)
+
+## Purpose
+
+Codex users may sign in with account credentials while routing model requests through a custom API provider. When switching API sites, replacing the entire configuration can accidentally remove plugin, conversation, feature, and profile settings.
+
+Codex API Switchboard focuses on this narrow workflow:
+
+- import, drag in, or paste a local `config.toml`
+- replace only `base_url` and `experimental_bearer_token` under `[model_providers.custom]`
+- automatically normalize `base_url` with a `/v1` suffix
+- export a complete TXT while preserving the rest of the Codex configuration
+- mask the token in the visible output while copy/download use the full generated content in the current session
+
+## Important Scope
+
+This tool is only for account credential login combined with custom API usage.
+
+It is not a Codex account-login replacement, and it does not create, validate, or host API credentials.
+
+## Privacy and Security Model
+
+This is a static, browser-local utility.
+
+- No upload.
+- No storage.
+- No cookies.
+- No network requests from the page.
+- No backend service.
+- Cloudflare Pages `_headers` uses `connect-src 'none'`.
+
+File reading, text replacement, and TXT generation all happen inside the current browser tab.
+
+## Technical Tags
+
+`Codex` `Cloudflare Pages` `Static HTML` `Vanilla JavaScript` `TOML` `Content Security Policy` `Privacy-first` `API Routing` `Config Tooling`
+
+## Tech Stack
+
+- HTML, CSS, and vanilla JavaScript
+- Static deployment on Cloudflare Pages
+- Strict CSP through `_headers`
+- Local public artifact validation with Node.js
+- GitHub Actions validation workflow
+
+## Local Validation
+
+```bash
+npm run validate
+```
+
+The validation script checks:
+
+- inline JavaScript parses
+- the important scope warning remains visible
+- `_headers` keeps `connect-src 'none'`
+- no browser storage or network APIs are used
+- public files do not contain local machine paths, default API providers, or token-like secrets
+- removed legacy layout elements do not reappear
+
+## Deployment
+
+Deploy the repository root to Cloudflare Pages:
+
+```bash
+wrangler pages deploy . --project-name codex-config-txt
+```
+
+## License
+
+MIT

README.md

@@ -1,75 +1,79 @@
 # Codex API Switchboard
 
-Privacy-first static tool for rebuilding a complete Codex configuration TXT when switching custom API providers.
+默认语言：简体中文 | [English](README.en.md)
 
-[Live demo](https://codex-config-txt.pages.dev)
+隐私优先的静态工具，用于在切换 Codex 自定义 API 站点时，生成完整的配置 TXT。
 
-## Purpose
+[在线演示](https://codex-config-txt.pages.dev)
 
-Codex users who sign in with account credentials may still route model requests through a custom API provider. When switching API sites, replacing the whole configuration can accidentally drop plugin, conversation, feature, and profile settings.
+![Codex API Switchboard 界面截图](assets/screenshot.png)
 
-Codex API Switchboard solves that narrow workflow:
+## 项目定位
 
-- import or paste a local `config.toml`
-- replace only `base_url` and `experimental_bearer_token`
-- automatically normalize `base_url` with a `/v1` suffix
-- export a complete TXT while preserving the rest of the configuration
-- mask the token in the visible output while copy/download still use the full generated content
+Codex 用户通过账号凭证登录后，仍可能把模型请求路由到自定义 API Provider。切换不同 API 站点时，如果直接替换整份配置，容易丢失插件、对话、功能开关、profiles 等已有设置。
 
-## Important Scope
+Codex API Switchboard 专注解决这个窄场景：
 
-This tool is only for account credential login combined with custom API usage.
+- 导入、拖入或粘贴本地 `config.toml`
+- 只替换 `[model_providers.custom]` 下的 `base_url` 和 `experimental_bearer_token`
+- `base_url` 自动补齐 `/v1`
+- 输出完整 TXT，并保留其余 Codex 配置
+- 页面可见输出默认遮罩 token，复制和下载仍使用当前会话生成的完整内容
 
-It is not a general Codex account-login replacement, and it does not create or validate API credentials.
+## 重要适用范围
 
-## Privacy Model
+仅适用于账号凭证登录 + 使用自定义 API 的情况。
 
-The page is a static browser-only utility.
+本工具不是 Codex 账号登录替代方案，也不会创建、校验或托管 API 凭证。
 
-- No upload.
-- No storage.
-- No cookies.
-- No network requests from the page.
-- No backend service.
-- Cloudflare Pages CSP uses `connect-src 'none'`.
+## 隐私与安全模型
 
-All file reading and text replacement happens inside the current browser tab.
+这是一个纯静态、浏览器本地运行的工具。
 
-## Technical Tags
+- 不上传文件
+- 不存储数据
+- 不使用 Cookie
+- 页面不发起网络请求
+- 没有后端服务
+- Cloudflare Pages `_headers` 使用 `connect-src 'none'`
 
-`Codex` `Cloudflare Pages` `Static HTML` `Vanilla JavaScript` `TOML` `Content Security Policy` `Privacy-first` `API routing` `Config tooling`
+文件读取、文本替换和 TXT 生成都发生在当前浏览器标签页内。
 
-## Tech Stack
+## 技术标签
 
-- HTML, CSS, and vanilla JavaScript
-- Static deployment on Cloudflare Pages
-- Strict CSP via `_headers`
-- Local validation script with Node.js
-- GitHub Actions validation workflow
+`Codex` `Cloudflare Pages` `Static HTML` `Vanilla JavaScript` `TOML` `Content Security Policy` `Privacy-first` `API Routing` `Config Tooling`
 
-## Local Validation
+## 技术栈
+
+- HTML、CSS、Vanilla JavaScript
+- Cloudflare Pages 静态部署
+- `_headers` 配置严格 CSP
+- Node.js 本地公开产物校验
+- GitHub Actions 自动验证
+
+## 本地验证
 
 ```bash
 npm run validate
 ```
 
-The validation script checks:
+校验脚本会检查：
 
-- inline JavaScript parses
-- required scope warning remains visible
-- `connect-src 'none'` remains in `_headers`
-- no browser storage or network APIs are used
-- no local machine paths, default provider URLs, or token-like secrets are present in the public page
-- removed layout elements do not reappear
+- 内联 JavaScript 可解析
+- 重要适用范围提示仍存在
+- `_headers` 保留 `connect-src 'none'`
+- 未使用浏览器存储或联网 API
+- 公开页面不包含本机路径、默认 API 站点或 token-like secret
+- 已删除的旧布局元素不会重新出现
 
-## Deployment
+## 部署
 
-Deploy the repository root to Cloudflare Pages:
+将仓库根目录部署到 Cloudflare Pages：
 
 ```bash
 wrangler pages deploy . --project-name codex-config-txt
 ```
 
-## License
+## 许可证
 
 MIT

assets/screenshot.png

@@ -1684,7 +1684,7 @@ <h2 id="outputTitle">完整 TXT 输出</h2>
       }
 
       const testBaseUrl = "https://selftest.local";
-      const testToken = "selftest-token-123";
+      const testToken = "dummy-credential-value";
       if (!state.source.trim()) {
         state.source = [
           'model_provider = "custom"',
@@ -1706,8 +1706,8 @@ <h2 id="outputTitle">完整 TXT 输出</h2>
       const visibleOutput = elements.output.value;
       const checks = [
         /^base_url\s*=\s*"https:\/\/selftest\.local\/v1"$/m.test(output),
-        /^experimental_bearer_token\s*=\s*"selftest-token-123"$/m.test(output),
-        !visibleOutput.includes("selftest-token-123"),
+        /^experimental_bearer_token\s*=\s*"dummy-credential-value"$/m.test(output),
+        !visibleOutput.includes("dummy-credential-value"),
         !/^experimental_bearer_token\s*=\s*""$/m.test(output),
         elements.copyButton.disabled === false,
         elements.downloadButton.disabled === false,
@@ -1736,4 +1736,4 @@ <h2 id="outputTitle">完整 TXT 输出</h2>
     runSelfTest();
   </script>
 </body>
-</html>
+</html>

index.html

@@ -4,6 +4,9 @@ const path = require("path");
 const root = path.resolve(__dirname, "..");
 const indexPath = path.join(root, "index.html");
 const headersPath = path.join(root, "_headers");
+const readmePath = path.join(root, "README.md");
+const readmeEnPath = path.join(root, "README.en.md");
+const screenshotPath = path.join(root, "assets", "screenshot.png");
 
 function read(filePath) {
   return fs.readFileSync(filePath, "utf8");
@@ -17,6 +20,8 @@ function assert(condition, message) {
 
 const index = read(indexPath);
 const headers = read(headersPath);
+const readme = read(readmePath);
+const readmeEn = read(readmeEnPath);
 const publicText = `${index}\n${headers}`;
 
 const scriptMatch = index.match(/<script>([\s\S]*?)<\/script>/);
@@ -40,6 +45,8 @@ const forbiddenStrings = [
   "routePreview",
   "tokenSummary",
   "替换摘要",
+  "selftest-token",
+  "repair-token",
 ];
 
 const forbiddenHits = forbiddenStrings.filter((needle) => publicText.includes(needle));
@@ -51,5 +58,24 @@ assert(headers.includes("connect-src 'none'"), "CSP must keep connect-src 'none'
 assert(index.includes("重要提示：仅适用于账号凭证登录 + 使用 API 的情况"), "scope warning is missing");
 assert(index.includes("保留不变"), "preserved configuration panel is missing");
 assert(index.includes("impact-panel"), "impact panel alignment class is missing");
+assert(fs.existsSync(screenshotPath), "repository screenshot is missing");
+assert(readme.includes("默认语言：简体中文"), "Chinese README must be the default landing document");
+assert(readme.includes("[English](README.en.md)"), "Chinese README must link to the English version");
+assert(readmeEn.includes("[简体中文](README.md)"), "English README must link back to the Chinese version");
+assert(readme.includes("![Codex API Switchboard 界面截图](assets/screenshot.png)"), "Chinese README screenshot is missing");
+assert(readmeEn.includes("![Codex API Switchboard interface screenshot](assets/screenshot.png)"), "English README screenshot is missing");
+
+const requiredTags = [
+  "Codex",
+  "Cloudflare Pages",
+  "Vanilla JavaScript",
+  "TOML",
+  "Content Security Policy",
+  "Privacy-first",
+  "API Routing",
+  "Config Tooling",
+];
+const missingTags = requiredTags.filter((tag) => !readme.includes(tag) || !readmeEn.includes(tag));
+assert(missingTags.length === 0, `README technical tags missing: ${missingTags.join(", ")}`);
 
 console.log("PUBLIC_VALIDATE:OK");