1

.gitignore

@@ -19,4 +19,5 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-conductor
+conductor
+CLAUDE.md

conductor/archive/add_i18n_support_20260210/index.md

@@ -0,0 +1,5 @@
+# Track add_i18n_support_20260210 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)

conductor/archive/add_i18n_support_20260210/metadata.json

@@ -0,0 +1,8 @@
+{
+  "track_id": "add_i18n_support_20260210",
+  "type": "feature",
+  "status": "new",
+  "created_at": "2026-02-10T00:00:00Z",
+  "updated_at": "2026-02-10T00:00:00Z",
+  "description": "Add i18n support starting with Simplified Chinese (zh-Hans)"
+}

conductor/archive/add_i18n_support_20260210/plan.md

@@ -0,0 +1,40 @@
+# Implementation Plan - Track: add_i18n_support_20260210
+
+## Phase 1: Configuration and Infrastructure [checkpoint: b94e453]
+- [x] Task: Update `docusaurus.config.js` to configure `i18n` for `en` and `zh-Hans`. [83a0197]
+    - [x] Update `i18n` object in config.
+    - [x] Add `localeDropdown` to `themeConfig.navbar.items`.
+- [x] Task: Verify configuration changes. [3e81130]
+    - [x] Run `yarn start` to verify the site starts and the language dropdown appears.
+- [x] Task: Conductor - User Manual Verification 'Configuration and Infrastructure' (Protocol in workflow.md) [b94e453]
+
+## Phase 2: UI String Translation [checkpoint: 9de1e15]
+- [x] Task: Scaffold translation files. [b5822c1]
+    - [x] Run `yarn docusaurus write-translations --locale zh-Hans`.
+- [x] Task: Translate essential UI strings. [16948b3]
+    - [x] Update `i18n/zh-Hans/docusaurus-theme-classic/navbar.json` with Chinese labels.
+    - [x] Update `i18n/zh-Hans/docusaurus-theme-classic/footer.json` with Chinese labels.
+- [x] Task: Conductor - User Manual Verification 'UI String Translation' (Protocol in workflow.md) [9de1e15]
+
+## Phase 3: Documentation Content Translation [checkpoint: f9a8dd0]
+- [x] Task: Create i18n directory structure for docs. [e6fd427]
+    - [x] Create `i18n/zh-Hans/docusaurus-plugin-content-docs/current` and replicate `docs/` folder structure.
+- [x] Task: Translate Documentation Files (Batch 1 - Root & Install). [7237d64]
+    - [x] Translate `docs/*.md` files (installation, faq, etc.) preserving technical terms.
+- [x] Task: Translate Documentation Files (Batch 2 - Profiles). [b42fff7]
+    - [x] Translate `docs/profile-format/**/*.md` files preserving technical terms.
+- [x] Task: Translate Documentation Files (Batch 3 - Proxy & Rules). [afaa1a0]
+    - [x] Translate remaining files in `docs/` subdirectories preserving technical terms.
+- [x] Task: Conductor - User Manual Verification 'Documentation Content Translation' (Protocol in workflow.md) [f9a8dd0]
+
+## Phase 4: Blog Content Translation [checkpoint: b0b1a8c]
+- [x] Task: Create i18n directory structure for blog. [9e9ed7c]
+    - [x] Create `i18n/zh-Hans/docusaurus-plugin-content-blog`.
+- [x] Task: Translate Blog Posts. [9031b77]
+    - [x] Translate all files in `blog/` to `i18n/zh-Hans/docusaurus-plugin-content-blog/` preserving technical terms.
+- [x] Task: Conductor - User Manual Verification 'Blog Content Translation' (Protocol in workflow.md) [b0b1a8c]
+
+## Phase 5: Final Build and Verification
+- [x] Task: Verify full site build. [9adbc85]
+    - [ ] Run `yarn build` to ensure both locales build successfully.
+- [ ] Task: Conductor - User Manual Verification 'Final Build and Verification' (Protocol in workflow.md)

conductor/archive/add_i18n_support_20260210/spec.md

@@ -0,0 +1,32 @@
+# Specification: add_i18n_support_20260210
+
+## Overview
+Implement internationalization (i18n) support for the Surfboard-NG documentation website following the [official Docusaurus i18n tutorial](https://docusaurus.io/docs/i18n/tutorial), including automated translation of documentation and blog content into Simplified Chinese (`zh-Hans`).
+
+## Functional Requirements
+- **Locale Configuration:** Update `docusaurus.config.js` to define `en` (default) and `zh-Hans` locales.
+- **Navigation Integration:** Add a `localeDropdown` type item to the `navbar` in `docusaurus.config.js`.
+- **UI String Translation:** Use `yarn docusaurus write-translations --locale zh-Hans` to generate JSON translation files.
+- **Automated Content Translation:**
+    - Use AI/LLM capabilities to translate all `.md` and `.mdx` files from `docs/` to `i18n/zh-Hans/docusaurus-plugin-content-docs/current/`.
+    - Use AI/LLM capabilities to translate all blog posts from `blog/` to `i18n/zh-Hans/docusaurus-plugin-content-blog/`.
+    - **Technical Term Preservation:** Ensure that technical terms, keywords, and specific configuration parameters (e.g., `Shadowsocks`, `VMess`, `Trojan`, `HTTP`, `SOCKS5`, `routing rules`, etc.) remain in their original English form.
+    - Maintain the original frontmatter, file names, and directory structure during translation.
+- **Localized Routing:** Verify that Docusaurus correctly serves localized content at `/zh-Hans/`.
+
+## Non-Functional Requirements
+- **Build Stability:** `yarn build` must successfully generate both the English and Chinese versions of the site.
+- **Translation Quality:** Automated translations should be technically accurate and maintain the formal tone of the project.
+- **Technical Accuracy:** Directory structure must strictly follow Docusaurus i18n conventions.
+
+## Acceptance Criteria
+- [ ] `docusaurus.config.js` is correctly configured for `en` and `zh-Hans`.
+- [ ] The language switcher dropdown is functional in the `navbar`.
+- [ ] `yarn build` completes without errors for both locales.
+- [ ] Initial automated translations for all `docs/` and `blog/` content are present in the `i18n/zh-Hans/` directories.
+- [ ] Technical terms remain untranslated in the Chinese version.
+- [ ] Localized versions of the documentation and blog are accessible at their respective `/zh-Hans/` URLs.
+
+## Out of Scope
+- Implementation of third-party SaaS translation platforms (e.g., Crowdin, Transifex).
+- Ongoing maintenance of translations (this track covers the initial automated pass).

conductor/archive/anytls_doc_20260215/index.md

@@ -0,0 +1,5 @@
+# Track anytls_doc_20260215 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)

conductor/archive/anytls_doc_20260215/metadata.json

@@ -0,0 +1,8 @@
+{
+  "track_id": "anytls_doc_20260215",
+  "type": "feature",
+  "status": "new",
+  "created_at": "2026-02-15T10:00:00Z",
+  "updated_at": "2026-02-15T10:00:00Z",
+  "description": "add anytls doc"
+}

conductor/archive/anytls_doc_20260215/plan.md

@@ -0,0 +1,24 @@
+# Implementation Plan: Add anytls Proxy Documentation
+
+## Phase 1: Implementation of anytls Proxy Documentation [checkpoint: 92b2ee98]
+
+- [x] Task: Write verification script `scripts/verify-anytls-doc.js` 4ed38401
+    - [ ] Create a script that checks for the existence of both English and Chinese `anytls.md` files.
+    - [ ] The script should also verify that the files contain the mandatory sections (Format, Parameters, Examples).
+- [x] Task: Implement English documentation `docs/profile-format/proxy/external-proxy/anytls.md` 774b0b43
+    - [ ] Follow the spec for content (name, server, port, password, etc.).
+    - [ ] Use `sidebar_position: 7`.
+- [x] Task: Implement Chinese documentation `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/proxy/external-proxy/anytls.md` cb2d48cc
+    - [ ] Translate English content to Simplified Chinese.
+    - [ ] Keep configuration examples literal.
+- [x] Task: Run verification script cde97bcd
+    - [ ] Execute `node scripts/verify-anytls-doc.js` and ensure it passes.
+- [x] Task: Update overview files `docs/profile-format/overview.md` and `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/overview.md` 3900a317
+    - [ ] Add AnyTls and Hysteria2 to the [Proxy] section example.
+- [ ] Task: Conductor - User Manual Verification 'Implementation of anytls Proxy Documentation' (Protocol in workflow.md)
+
+## Phase 2: Final Validation [checkpoint: 176bd229]
+
+- [x] Task: Run project build 28cc86eb
+    - [ ] Execute `yarn build` to ensure no broken links or site-wide build errors.
+- [x] Task: Conductor - User Manual Verification 'Final Validation' (Protocol in workflow.md) 176bd229

conductor/archive/anytls_doc_20260215/spec.md

@@ -0,0 +1,43 @@
+# Specification: Add anytls Proxy Documentation
+
+## Overview
+This track involves adding technical documentation for the `anytls` proxy type to the Surfboard-NG manual. The documentation will cover the configuration format, parameters, and provide usage examples in both English and Simplified Chinese.
+
+## Functional Requirements
+
+### 1. New Documentation Files
+- Create the English documentation at: `docs/profile-format/proxy/external-proxy/anytls.md`
+- Create the Simplified Chinese documentation at: `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/proxy/external-proxy/anytls.md`
+
+### 2. Content Specifications
+The documentation must include:
+- **Description:** A brief overview of the `anytls` proxy type.
+- **Format:** The standard comma-separated configuration line used in Surfboard profiles.
+- **Parameters:**
+    - `name`: Identifier for the proxy.
+    - `server`: Server address (IP or hostname).
+    - `port`: Server port.
+    - `password`: Authentication password.
+    - `skip-cert-verify` (Optional): `true` or `false`.
+    - `sni` (Optional): Server Name Indication.
+    - `reuse` (Optional): `true` or `false`. **Default is `true`.**
+- **Examples:**
+    - Full configuration: `ProxyAnyTLS = anytls, 1.2.3.4, 443, password, skip-cert-verify=true, sni=abc.com, reuse=false`
+    - Minimal configuration: `ProxyAnyTLSMin = anytls, 1.2.3.4, 443, password`
+
+### 3. Localization
+- Ensure the Chinese version accurately translates the technical descriptions while keeping the configuration parameters and examples in their literal form.
+
+## Non-Functional Requirements
+- **Consistency:** Maintain the formal and technical tone of the existing documentation.
+- **Formatting:** Use MDX and follow Docusaurus conventions.
+
+## Acceptance Criteria
+- [ ] `docs/profile-format/proxy/external-proxy/anytls.md` exists with correct English content.
+- [ ] `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/proxy/external-proxy/anytls.md` exists with correct Chinese content.
+- [ ] The new files are correctly indexed or visible in the sidebar (Docusaurus auto-generated sidebar should handle this).
+- [ ] `yarn build` completes successfully without errors.
+
+## Out of Scope
+- Implementing `anytls` proxy logic in the Surfboard application itself.
+- Updating documentation for other proxy types.

conductor/archive/hysteria2_proxy_20260208/index.md

@@ -0,0 +1,5 @@
+# Track hysteria2_proxy_20260208 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)

conductor/archive/hysteria2_proxy_20260208/metadata.json

@@ -0,0 +1,8 @@
+{
+  "track_id": "hysteria2_proxy_20260208",
+  "type": "feature",
+  "status": "new",
+  "created_at": "2026-02-08T19:30:00Z",
+  "updated_at": "2026-02-08T19:30:00Z",
+  "description": "add document for new hysteria2 proxy"
+}

conductor/archive/hysteria2_proxy_20260208/plan.md

@@ -0,0 +1,13 @@
+# Implementation Plan: Add Hysteria2 Proxy Documentation
+
+## Phase 1: Content Creation [checkpoint: fac9e6a]
+- [x] Task: Create the new documentation file `docs/profile-format/proxy/external-proxy/hysteria2.md` with initial header and summary. fac9e6a
+- [x] Task: Document the Hysteria2 configuration parameters (Mandatory and Optional) in a structured table. fac9e6a
+- [x] Task: Add the Hysteria2 configuration example with descriptive comments. fac9e6a
+- [x] Task: Update `docs/profile-format/proxy/index.md` to include Hysteria2 in the external proxies list. fac9e6a
+- [x] Task: Conductor - User Manual Verification 'Phase 1: Content Creation' (Protocol in workflow.md) fac9e6a
+
+## Phase 2: Verification
+- [x] Task: Run `yarn build` to verify the site builds correctly with the new content.
+- [x] Task: Perform a manual review of the Hysteria2 page to ensure formatting and relative links are correct.
+- [x] Task: Conductor - User Manual Verification 'Phase 2: Verification' (Protocol in workflow.md)

conductor/archive/hysteria2_proxy_20260208/spec.md

@@ -0,0 +1,32 @@
+# Specification: Add Hysteria2 Proxy Documentation
+
+## Overview
+This track involves adding a new documentation page for the Hysteria2 proxy protocol to the Surfboard-NG manual. Hysteria2 is a high-performance proxy based on the QUIC protocol, designed for challenging network environments.
+
+## Functional Requirements
+- **New Documentation Page:** Create `docs/profile-format/proxy/external-proxy/hysteria2.md`.
+- **Protocol Details:** Include a summary of Hysteria2 and a link to its official protocol standard/documentation.
+- **Configuration Specification:** Document the following parameters for Hysteria2:
+    - **Mandatory:**
+        - `server`: Server IP or domain.
+        - `port`: Server port.
+        - `password`: Authentication password.
+    - **Optional:**
+        - `download-bandwidth`: Maximum download speed (e.g., `100`).
+        - `port-hopping`: Port hopping configuration (e.g., `"1234;5000-6000"`).
+        - `port-hopping-interval`: Interval for port hopping in seconds (e.g., `30`).
+        - `skip-cert-verify`: Bypass TLS certificate verification (`true`/`false`).
+        - `sni`: Server Name Indication for TLS.
+        - `udp-relay`: Enable or disable UDP relay (`true`/`false`).
+- **Code Example:** Provide a clear, commented code block demonstrating a Hysteria2 configuration.
+- **Navigation Update:** Ensure the new page is correctly categorized under External Proxies.
+
+## Non-Functional Requirements
+- **Guideline Compliance:** Follow project guidelines: summary at the top, clear headings, descriptive code comments, and relative internal links.
+- **Build Stability:** Verification via `yarn build` is mandatory.
+
+## Acceptance Criteria
+- `docs/profile-format/proxy/external-proxy/hysteria2.md` exists and is correctly formatted.
+- The configuration example matches the provided format: `ProxyHysteria2 = hysteria2, 1.2.3.4, 443, password=pwd, download-bandwidth=100, port-hopping="1234;5000-6000", port-hopping-interval=30, skip-cert-verify=true, sni=example.com, udp-relay=true`.
+- All parameters (mandatory and optional) are clearly explained in a table or list.
+- `yarn build` completes without errors.

conductor/archive/logical_rule_doc_20260225/index.md

@@ -0,0 +1,5 @@
+# Track logical_rule_doc_20260225 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)

conductor/archive/logical_rule_doc_20260225/metadata.json

@@ -0,0 +1,8 @@
+{
+  "track_id": "logical_rule_doc_20260225",
+  "type": "feature",
+  "status": "new",
+  "created_at": "2026-02-25T11:00:00Z",
+  "updated_at": "2026-02-25T11:00:00Z",
+  "description": "add logical rule document"
+}

conductor/archive/logical_rule_doc_20260225/plan.md

@@ -0,0 +1,22 @@
+# Implementation Plan: Logical Rule Document
+
+## Phase 1: Test Scaffolding [checkpoint: 2fd0e67]
+- [x] Task: Create verification script `scripts/verify-logical-doc.js` 6245371 following the pattern of `scripts/verify-anytls-doc.js`.
+- [x] Task: Run the verification script and confirm it fails (Red Phase) 6245371.
+- [x] Task: Conductor - User Manual Verification 'Phase 1' 2fd0e67 (Protocol in workflow.md)
+
+## Phase 2: English Documentation [checkpoint: f24be8b]
+- [x] Task: Create `docs/profile-format/rule/logical.md` b74afe7 with AND, OR, NOT documentation.
+- [x] Task: Update `docs/profile-format/rule/index.md` b74afe7 to reference logical rules.
+- [x] Task: Run `scripts/verify-logical-doc.js` and ensure English part passes b74afe7 (Yellow Phase).
+- [x] Task: Conductor - User Manual Verification 'Phase 2' f24be8b (Protocol in workflow.md)
+
+## Phase 3: Chinese Translation [checkpoint: cebb358]
+- [x] Task: Create Simplified Chinese translation for logical rules 0e966e9 in `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/rule/logical.md`.
+- [x] Task: Update Simplified Chinese translation for rule index 0e966e9 in `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/rule/index.md`.
+- [x] Task: Run `scripts/verify-logical-doc.js` and ensure all parts pass 0e966e9 (Green Phase).
+- [x] Task: Conductor - User Manual Verification 'Phase 3' cebb358 (Protocol in workflow.md)
+
+## Phase 4: Final Validation [checkpoint: 78665a0]
+- [x] Task: Run `yarn build` to verify the site generates correctly.
+- [x] Task: Conductor - User Manual Verification 'Phase 4' 78665a0 (Protocol in workflow.md)

conductor/archive/logical_rule_doc_20260225/spec.md

@@ -0,0 +1,34 @@
+# Specification: Add Logical Rule Document
+
+## Overview
+Add a new technical reference document for "Logical Rules" (AND, OR, NOT) to the Surfboard profile format documentation. This track includes both English and Simplified Chinese versions.
+
+## Functional Requirements
+- Create `docs/profile-format/rule/logical.md` with English content.
+- Create `i18n/zh-Hans/docusaurus-plugin-content-docs/current/profile-format/rule/logical.md` with Simplified Chinese content.
+- Document the following operators:
+    - **AND**: Matches if all sub-rules match.
+    - **OR**: Matches if any sub-rule matches.
+    - **NOT**: Matches if the sub-rule does not match.
+- Each operator documentation must include:
+    - Description
+    - Syntax Format
+    - Parameters Table
+    - Practical Examples (including nesting and common use cases)
+- **External Reference:** Include a link to the [Surge manual](https://manual.nssurge.com/rule/logical.html) as a technical reference.
+- **Overview Update:** Update `docs/profile-format/rule/index.md` (and its translation) to mention the availability of logical rules.
+
+## Non-Functional Requirements
+- Maintain a formal and technical tone consistent with existing rule docs.
+- Adhere to the established Markdown structure (sidebar_position, headers).
+
+## Acceptance Criteria
+- Files exist in both the default and translated documentation paths.
+- Content accurately describes the logic and syntax of Surfboard logical rules.
+- `yarn build` completes successfully without errors.
+- Sidebar displays the new "Logical Rules" item under Profile Format -> Rule.
+- `index.md` (English and Chinese) includes a mention of logical rules.
+
+## Out of Scope
+- Documentation for other rule types (e.g., Domain, IP).
+- Changes to the Surfboard application logic.

conductor/archive/refactor_profile_format_20260208/index.md

@@ -0,0 +1,5 @@
+# Track refactor_profile_format_20260208 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)

conductor/archive/refactor_profile_format_20260208/metadata.json

@@ -0,0 +1,8 @@
+{
+  "track_id": "refactor_profile_format_20260208",
+  "type": "feature",
+  "status": "new",
+  "created_at": "2026-02-08T12:00:00Z",
+  "updated_at": "2026-02-08T12:00:00Z",
+  "description": "Refactor and update the profile format documentation for technical accuracy and guideline compliance."
+}

conductor/archive/refactor_profile_format_20260208/plan.md

@@ -0,0 +1,15 @@
+# Implementation Plan: Refactor and Update Profile Format Documentation
+
+## Phase 1: Audit and Preparation
+- [x] Task: List and audit all files in `docs/profile-format/` for guideline compliance.
+- [x] Task: Verify existing external links in the profile format section.
+
+## Phase 2: Content Refactoring
+- [x] Task: Update `docs/profile-format/overview.md` with summary and formatted code blocks. d459436
+- [x] Task: Update `docs/profile-format/general/` documentation. 0317b1c
+- [x] Task: Update `docs/profile-format/proxy/` and `docs/profile-format/proxygroup/` documentation. 326b18f
+- [x] Task: Update `docs/profile-format/rule/` and `docs/profile-format/host/` documentation. fff3a99
+
+## Phase 3: Verification
+- [x] Task: Run `yarn build` to ensure documentation integrity.
+- [x] Task: Perform a final manual review of link relative paths.

conductor/archive/refactor_profile_format_20260208/spec.md

@@ -0,0 +1,17 @@
+# Specification: Refactor and Update Profile Format Documentation
+
+## Objective
+Audit and update all documentation within `docs/profile-format` to ensure technical precision, adherence to new project guidelines, and build stability.
+
+## Scope
+- Audit all MDX/Markdown files in `docs/profile-format/` and its subdirectories.
+- Update code blocks to include syntax highlighting and descriptive comments.
+- Verify and correct all internal and external links.
+- Ensure every modified page follows the content structure (summary at the top).
+- Validate changes by running `yarn build`.
+
+## Success Criteria
+- `yarn build` completes without errors.
+- All code blocks have language tags.
+- No broken internal links.
+- Consistent formatting across the audited section.

conductor/archive/snell_doc_20260301/index.md

@@ -0,0 +1,5 @@
+# Track snell_doc_20260301 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)