Revise README for improved clarity and bilingual support

Updated README to enhance clarity and structure, adding sections in both English and Chinese.

Author: AgentLex

README.md

@@ -1,42 +1,81 @@
-# CodeCart
-CodeCart: A portable, single-file cognitive memory cartridge for AI collaboration. End long-context pollution and save tokens with DSL-driven knowledge graphs. / 专为 AI 协作设计的便携单文件认知记忆卡带，终结上下文污染并极致节省 Token。
-
-🇺🇸 English Version
-CodeCart: The Single-File Cognitive Memory Cartridge
-CodeCart is a portable, evolvable, and token-efficient knowledge graph stored in a single HTML file. It solves the "Long Context Inflation" and "Memory Pollution" issues in AI collaboration.
-
-🌟 Key Features
-Dual-Drive I/O: High-efficiency DSL instructions instead of bulky JSON.
-
-4D Timeline: Temporal playback to revisit historical decision points.
-
-Lens System: Multi-perspective projection (Engineering, Patent, Security, etc.).
-
-Physical Portability: Single-file HTML, zero-dependency, U-disk ready.
-
-🛠 How to Use
-Sync: Click "Copy for AI" to get a compressed Markdown context.
-
-Chat: Paste it to AI. AI replies with DSL commands (e.g., +CLAIM).
-
-Execute: Paste DSL back into the console and click "Execute".
-
-🇨🇳 中文说明
-CodeCart：单文件认知记忆卡带
-CodeCart 是一款便携、可演化且极致节省 Token 的认知图谱容器，封装于单个 HTML 文件中。它旨在解决 AI 协作中常见的“长上下文膨胀”与“记忆污染”痛点。
-
-🌟 核心特性
-非对称双擎 I/O：使用极简 DSL 指令取代臃肿的 JSON，节省 90% 输出 Token。
-
-4D 时间轴：状态时空切片，支持回溯任何历史决策现场。
-
-多维透镜：根据任务切换视角（工程、专利、安全等），精准过滤噪声。
-
-物理级便携：单文件零依赖，优盘即插即用，数据主权完全掌控。
-
-🛠 使用步骤
-同步：点击“复制给 AI”获取压缩后的 Markdown 上下文。
-
-对话：贴给 AI。AI 会输出 DSL 指令（如 +CLAIM）。
-
-回写：将指令贴回 CodeCart 控制台并点击“执行”。
+# CodeCart: The Cognitive Memory Cartridge for Human-AI Collaboration
+# CodeCart：人机协作认知记忆卡带
+
+CodeCart is a portable, single-file cognitive memory cartridge designed to end "AI Memory Pollution." It collapses thousands of words into structured logic nodes using a robust DSL engine.
+CodeCart 是一款专为终结“AI 记忆污染”而生的单文件认知图谱容器。它通过强大的 DSL 引擎，将万字长谈坍缩为结构化的认知节点。
+
+---
+
+## 🚀 快速上手指南 / Quick Start Guide
+
+### 第一步：开启认知白板 / Step 1: Initialize
+* **🆕 New Cartridge**: Click left-bottom button to clear all nodes.
+* **🆕 新建卡带**：点击左下角按钮，抹除所有节点，开启纯净画布。
+* **⚓ Set Anchors**: In the console, enter your hard constraints.
+* **⚓ 设定锚点**：在控制台输入物理级红线。
+  - *Example:* `+ANCHOR("Budget limit: $1000")` / `+ANCHOR("预算限额 1000 元")`
+
+### 第二步：认知同步循环 / Step 2: The Cognitive Loop
+1. **📋 Copy for AI**: Click the button to get a compressed Markdown context.
+1. **📋 复制给 AI**：点击按钮，系统自动将当前逻辑状态压缩为 Markdown。
+2. **💬 Chat with AI**: Paste the text to any AI (Gemini, Perplexity, Grok).
+2. **💬 对话 AI**：将文本贴给任意 AI，并要求其以 DSL 格式回答。
+3. **⚡ Get & Exec**: Copy the DSL commands from AI, paste back to console, and click **Execute**.
+3. **⚡ 执行指令**：复制 AI 回复的 DSL 指令，贴回控制台点击“执行”，见证节点涌现。
+
+---
+
+## 🧠 高阶方案：安插文档与跨模型协作 / Advanced Workflows
+
+### 方案 A：认知坍缩（安插长文档/对话） / Scenario A: Cognitive Collapse
+If you have long PDF documents or 100+ chat logs, do not paste them directly to all AIs.
+如果您有长篇 PDF 或上百轮聊天记录，不要直接发给所有 AI。
+1. **Feeding**: Upload document to AI A (e.g., Claude/Gemini).
+1. **喂料**：将文档发给 AI A。
+2. **Shrinking**: Ask AI A to "Collapse the core logic into 3-5 CodeCart `+CLAIM` commands."
+2. **坍缩**：要求 AI A “将核心逻辑坍缩为 3-5 条 CodeCart `+CLAIM` 指令”。
+3. **Injecting**: Paste these commands into CodeCart.
+3. **注入**：将指令贴入 CodeCart。这样，复杂的文档就变成了可参与讨论的结构化节点。
+
+### 方案 B：跨模型逻辑接力 / Scenario B: Cross-Model Relay
+1. **AI A (Strategist)**: Ask Perplexity to propose a solution. Execute its `+CLAIM`.
+1. **AI A（战略家）**：让 Perplexity 提出方案，执行其 `+CLAIM`。
+2. **AI B (Critic)**: Sync to Grok and ask: "Find logic holes in AI A's claim and optimize."
+2. **AI B（批判家）**：同步上下文给 Grok 并问：“找出 AI A 的逻辑漏洞并进行优化。”
+3. **Evolution**: AI B will output `>SUPERSEDE` to refine the knowledge graph.
+3. **演化**：AI B 会输出 `>SUPERSEDE` 指令，看图谱如何从旧逻辑中进化。
+
+---
+
+## 🤖 针对 API 用户与 Agent 协议 / For API & Agent Users
+
+If you are an API developer, inject this into your **System Prompt**:
+如果您是 API 开发者，请将此段加入您的**系统提示词**：
+
+> "You are an expert cognitive architect. Refer to the CodeCart Context. Your output MUST conclude with DSL:
+> - `+CLAIM(ID, 'Statement')` for new logic.
+> - `>SUPERSEDE(old_id, new_id, 'Reason')` for updates.
+> - No explanations. Just the logic commit."
+
+---
+
+## 🛠 指令集参考 / DSL Syntax Reference
+
+| Command 指令 | Effect 作用 | Example 示例 |
+| :--- | :--- | :--- |
+| **+CLAIM** | Add new knowledge 新增节点 | `+CLAIM(ent_01, "方案 A 可行")` |
+| **>SUPERSEDE** | Refute/Update 替代旧逻辑 | `>SUPERSEDE(clm_01, clm_02, "发现漏洞")` |
+| **+ANCHOR** | Hard constraint 物理红线 | `+ANCHOR("所有代码须使用 Python 3.10")` |
+
+---
+
+## 🌍 全球化适用 / Global Design
+* **Partitioned UI**: Shades of gray distinguish sidebar, canvas, and console.
+* **分区 UI**：通过不同深浅的灰色区分边栏、画布与控制台，减少视觉疲劳。
+* **Micro-Precision Timeline**: Backtrack through decisions second-by-second.
+* **高精度时间轴**：支持分秒级回溯，即使是连续快速操作也能精准还原。
+* **Data Sovereignty**: 100% Offline. Your logic never leaves your local file.
+* **数据主权**：100% 离线，您的认知逻辑永远不会离开本地文件。
+
+---
+Created by **AgentLex**. Open Source under MIT License.