<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: sun young</title>
    <description>The latest articles on DEV Community by sun young (@sun_young_517829fc09d0c05).</description>
    <link>https://dev.to/sun_young_517829fc09d0c05</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4059883%2F4d6b5d54-c8e2-437a-839e-aceeb57adb90.jpg</url>
      <title>DEV Community: sun young</title>
      <link>https://dev.to/sun_young_517829fc09d0c05</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/sun_young_517829fc09d0c05"/>
    <language>en</language>
    <item>
      <title>auto-ontology: A Chinese Translation of NVIDIA's Context Layer for Agents</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Wed, 04 Nov 2026 17:54:02 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/auto-ontology-a-chinese-translation-of-nvidias-context-layer-for-agents-5cjf</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/auto-ontology-a-chinese-translation-of-nvidias-context-layer-for-agents-5cjf</guid>
      <description>&lt;p&gt;A schema dump into the context window is the cheapest way to give an agent database access, and it is also the reason agents confidently return wrong revenue numbers. The column names are there. The meaning is not. NVIDIA's auto-ontology takes a different route: it compiles database metadata into an ontology — business terms mapped to columns, reviewed metric SQL, and relationships between tables — and lets the agent query through that layer.&lt;/p&gt;

&lt;p&gt;The project is Python, Apache-2.0, and sits at 4406 stars on the original repository. A Chinese translation of its documentation was published on 2026-11-05 at &lt;a href="https://github.com/yangshun2005/auto-ontology-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/auto-ontology-cn&lt;/a&gt;. That translation is what this article is about, plus what the tool actually does.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the service is
&lt;/h2&gt;

&lt;p&gt;Auto-Ontology runs next to your database. It ingests metadata and compiles an ontology from it. The ontology holds three things:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;business terms mapped to specific columns&lt;/li&gt;
&lt;li&gt;reviewed SQL expressions for metrics&lt;/li&gt;
&lt;li&gt;relationships between tables&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;An agent queries through the ontology instead of through raw schema. Before answering, it checks whether the question is answerable at all. When it does answer, it returns the SQL it ran and the reasoning steps, so a human can check the work.&lt;/p&gt;

&lt;p&gt;The README frames the problem in terms of reliability rather than speed: a revenue figure computed quickly is worthless if it is wrong. The agent needs to know where the data lives, what it means, whether it should be used, how to use it, where it came from, and which data is similar. That is the context layer.&lt;/p&gt;

&lt;h2&gt;
  
  
  The comparison that matters
&lt;/h2&gt;

&lt;p&gt;The README includes a table contrasting schema-in-context with the ontology tool approach. It is worth reproducing because it is the clearest statement of the design intent:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Schema in context window&lt;/th&gt;
&lt;th&gt;Auto-Ontology tools&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Token&lt;/td&gt;
&lt;td&gt;Grows with every table and column&lt;/td&gt;
&lt;td&gt;Only terms and tables relevant to the question&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Meaning&lt;/td&gt;
&lt;td&gt;Column names only, rest inferred by the agent&lt;/td&gt;
&lt;td&gt;Business terms mapped to columns and SQL&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Joins and metrics&lt;/td&gt;
&lt;td&gt;Improvised per question&lt;/td&gt;
&lt;td&gt;Resolved relationships and reviewed SQL expressions&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Unanswerable questions&lt;/td&gt;
&lt;td&gt;Confident answers, often wrong&lt;/td&gt;
&lt;td&gt;Answerability check, agent asks for clarification&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The last row is the one that changes behavior most. An agent that can say "I can't answer this from the available definitions" is more useful than one that produces a plausible-looking number.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quickstart, as documented
&lt;/h2&gt;

&lt;p&gt;The README's quickstart uses Docker Compose against the Wide World Importers sample database. The steps, in order:&lt;/p&gt;

&lt;p&gt;Clone and configure:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/NVIDIA/auto-ontology.git &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;cd &lt;/span&gt;auto-ontology
&lt;span class="nb"&gt;cp&lt;/span&gt; .env.example .env
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then set &lt;code&gt;DEFAULT_MODELS_API_KEY&lt;/code&gt; (an &lt;code&gt;nvapi-...&lt;/code&gt; key), &lt;code&gt;AUTH_SECRET&lt;/code&gt;, &lt;code&gt;APP_URL=http://localhost:3000&lt;/code&gt;, &lt;code&gt;POSTGRES_PASSWORD&lt;/code&gt;, &lt;code&gt;CONNECTION_STRINGS&lt;/code&gt;, &lt;code&gt;AUTO_ONTOLOGY_ADMIN_PASSWORD&lt;/code&gt;, and &lt;code&gt;PGADMIN_PASSWORD&lt;/code&gt; in &lt;code&gt;.env&lt;/code&gt;. The README gives a full example of each value.&lt;/p&gt;

&lt;p&gt;Start Postgres and seed the sample database. The seed script lives in the separate &lt;code&gt;auto-ontology-eval&lt;/code&gt; repository:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;docker compose up &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="nt"&gt;--wait&lt;/span&gt; postgres
git clone https://github.com/NVIDIA/auto-ontology-eval.git ../auto-ontology-eval
&lt;span class="o"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; ../auto-ontology-eval &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; uv &lt;span class="nb"&gt;sync&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;cp&lt;/span&gt; .env.example .env &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nv"&gt;POSTGRES_PASSWORD&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s1"&gt;' '&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  uv run python scripts/seed/seed_wwi.py &lt;span class="nt"&gt;--database-name&lt;/span&gt; wideworldimporters &lt;span class="nt"&gt;--drop&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Build and start the remaining services:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;docker compose up &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="nt"&gt;--build&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Open the app, log in with &lt;code&gt;AUTO_ONTOLOGY_ADMIN_EMAIL&lt;/code&gt; and &lt;code&gt;AUTO_ONTOLOGY_ADMIN_PASSWORD&lt;/code&gt; from &lt;code&gt;.env&lt;/code&gt;, go to &lt;strong&gt;Settings → Semantic Compilation&lt;/strong&gt;, and turn it on. Ingestion runs at startup; when compilation finishes you should see &lt;strong&gt;Semantic compilation is ready&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Then ask a question in &lt;strong&gt;Chat&lt;/strong&gt;. The README's example concerns revenue for a product in Pennsylvania in June 2015. The answer comes back with SQL and reasoning steps attached.&lt;/p&gt;

&lt;h2&gt;
  
  
  Requirements
&lt;/h2&gt;

&lt;p&gt;Docker and Compose v2 are required by the quickstart, as is &lt;a href="https://docs.astral.sh/uv/" rel="noopener noreferrer"&gt;uv&lt;/a&gt;. The project's &lt;code&gt;pyproject.toml&lt;/code&gt; requires Python &lt;code&gt;&amp;gt;=3.12&lt;/code&gt;. The Dockerfile is based on &lt;code&gt;nvcr.io/nvidia/base/ubuntu&lt;/code&gt; (jammy), and the Makefile's default multi-arch release targets are &lt;code&gt;linux/amd64,linux/arm64&lt;/code&gt;. The README does not specify special hardware requirements, and does not constrain the host OS beyond what Docker implies.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the Chinese version adds
&lt;/h2&gt;

&lt;p&gt;The translation repository is explicit about its structure. The README body is a translation of the original documentation, kept close to the source. On top of that, the page opens with a section labeled 中文快速上手 ("Chinese quick start") that is marked as supplementary material, not part of the original text.&lt;/p&gt;

&lt;p&gt;That distinction is the useful part. A translated README is helpful; a translated README with a short path to a running instance in front of it is more helpful. The quick-start section answers four questions before the reader hits the full documentation: what this is, what problem it solves, what the shortest path to a working setup looks like, and what the environment needs.&lt;/p&gt;

&lt;p&gt;For a project whose setup involves a &lt;code&gt;.env&lt;/code&gt; file with seven or eight variables, a second repository for seed data, and a settings toggle that must be flipped before anything works, that ordering matters. The barrier for a Chinese-speaking developer is not usually the English prose in the middle of the README — it is the sequence of shell commands and the config values, where a single mistyped variable name produces an opaque failure.&lt;/p&gt;

&lt;p&gt;The translation also states its own limits: inaccuracies should be reported as an Issue or PR. That is the right posture for a translated technical document, since the original is the authority and will keep moving.&lt;/p&gt;

&lt;h2&gt;
  
  
  How the pieces fit
&lt;/h2&gt;

&lt;p&gt;The system has five verbs in the README's own framing, and they describe the workflow rather than the architecture:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Discover&lt;/strong&gt; — generate an ontology from database metadata, import existing semantic models, explore the result as a semantic graph.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Anchor&lt;/strong&gt; — give each business concept a single definition, mapped across tables and databases.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Certify&lt;/strong&gt; — review, edit, and certify definitions in the UI or via API.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Validate&lt;/strong&gt; — check answerability before querying, return SQL and agent steps with every answer.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Expose&lt;/strong&gt; — serve the context to any agent framework through MCP, agent skills, and a REST API.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The MCP and REST surfaces are what make this framework-agnostic. The ontology is not tied to a particular agent runtime.&lt;/p&gt;

&lt;h2&gt;
  
  
  Evaluation
&lt;/h2&gt;

&lt;p&gt;The companion repository &lt;a href="https://github.com/NVIDIA/auto-ontology-eval" rel="noopener noreferrer"&gt;auto-ontology-eval&lt;/a&gt; measures ontology performance on benchmarks. The README names BIRD, BEAVER, FDABench-Lite, and Wide World Importers, with each evaluation item pairing a question against gold-standard SQL. I have not run these benchmarks myself, so I can't speak to the numbers — the eval repository is where to look for them.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who this is for
&lt;/h2&gt;

&lt;p&gt;If you are building agents over an enterprise database and you have already hit the failure mode where the agent answers confidently and wrongly, the ontology approach is worth evaluating. The cost is real: you have to define business terms, review metric SQL, and certify definitions. That is human work, and it does not disappear because a service compiles metadata.&lt;/p&gt;

&lt;p&gt;The Chinese translation lowers the entry cost for teams whose developers read Chinese more comfortably than English. It does not change what the tool does. The original repository is still the source of truth, and the translation says so.&lt;/p&gt;

&lt;p&gt;The Chinese version is new — published 2026-11-05, with no stars yet. The original has 4406. If you are working through the quickstart and something in the translated text does not match what you see, the original README is the place to check first.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/auto-ontology-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/auto-ontology-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>agent-desktop: A Chinese Translation of Vercel Labs' Accessibility-Tree CLI for AI Agents</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Wed, 04 Nov 2026 17:44:35 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/agent-desktop-a-chinese-translation-of-vercel-labs-accessibility-tree-cli-for-ai-agents-3hl7</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/agent-desktop-a-chinese-translation-of-vercel-labs-accessibility-tree-cli-for-ai-agents-3hl7</guid>
      <description>&lt;p&gt;&lt;code&gt;agent-desktop&lt;/code&gt; doesn't take screenshots. It reads the OS accessibility tree and returns it as JSON, with a &lt;code&gt;ref&lt;/code&gt; attached to every actionable element. An agent clicks or types via that ref, then re-reads the UI to check what happened.&lt;/p&gt;

&lt;p&gt;That's the whole idea. The original is &lt;code&gt;vercel-labs/agent-desktop&lt;/code&gt; (14547 stars, written in Rust, Apache-2.0). A Chinese translation now exists at &lt;a href="https://github.com/yangshun2005/agent-desktop-cn" rel="noopener noreferrer"&gt;yangshun2005/agent-desktop-cn&lt;/a&gt;, published today. It has 0 stars — it's brand new, so treat it as a reading aid, not a community-validated fork.&lt;/p&gt;

&lt;p&gt;This article covers what the tool does, how the ref model works, where it breaks, and what the Chinese version actually adds.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the tool is, and what it deliberately isn't
&lt;/h2&gt;

&lt;p&gt;The official one-liner is "Computer use CLI for AI agents." Two things follow from that phrasing:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;It ships as a &lt;strong&gt;CLI and a C library&lt;/strong&gt;. Not a framework, not an SDK with an agent loop inside.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No model is bundled.&lt;/strong&gt; The observe → act → observe loop lives in whatever agent calls it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That second point matters more than it looks. A lot of "computer use" tooling hides a planner inside, which makes failures hard to attribute. Here, if the agent clicks the wrong thing, the agent chose the wrong ref. The tool just reported the tree.&lt;/p&gt;

&lt;p&gt;Supported platforms: macOS, Windows, Linux. Architectures: x64 and ARM64.&lt;/p&gt;

&lt;h2&gt;
  
  
  The ref model
&lt;/h2&gt;

&lt;p&gt;A snapshot returns an envelope. Trimmed example from the README:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"version"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"2.6"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"ok"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"command"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"snapshot"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"data"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"app"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Finder"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"snapshot_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"s8f3k2p9"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"ref_count"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;59&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"complete"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"tree"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"window"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Downloads"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"children"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"treeitem"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Documents"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"ref_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"@s8f3k2p9:e8"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"available_actions"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"Click"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two details in that payload are load-bearing.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The ref carries its snapshot id.&lt;/strong&gt; &lt;code&gt;@s8f3k2p9:e8&lt;/code&gt;, not &lt;code&gt;@e8&lt;/code&gt;. Write the bare form and you get &lt;code&gt;INVALID_ARGS&lt;/code&gt;. This is intentional: a ref without a snapshot id has no way to tell you whether the UI it referred to still exists.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;&lt;code&gt;complete&lt;/code&gt; is a field, not an assumption.&lt;/strong&gt; If the tree was truncated, the envelope says so. An agent that ignores it may act on a partial view and conclude the element is missing.&lt;/p&gt;

&lt;p&gt;The loop, in shell form:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;agent-desktop snapshot &lt;span class="nt"&gt;--app&lt;/span&gt; Finder &lt;span class="nt"&gt;-i&lt;/span&gt;      &lt;span class="c"&gt;# interactive elements only, each with a ref&lt;/span&gt;
agent-desktop click @s8f3k2p9:e8            &lt;span class="c"&gt;# act on a ref from that snapshot&lt;/span&gt;
agent-desktop snapshot &lt;span class="nt"&gt;--app&lt;/span&gt; Finder &lt;span class="nt"&gt;-i&lt;/span&gt;      &lt;span class="c"&gt;# observe again to verify&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;-i&lt;/code&gt; flag filters to interactive elements. On a busy window the full tree can be large; &lt;code&gt;-i&lt;/code&gt; is usually what you want for the act step.&lt;/p&gt;

&lt;h2&gt;
  
  
  Installation paths
&lt;/h2&gt;

&lt;p&gt;npm is the shortest route, and needs Node 18+:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm &lt;span class="nb"&gt;install&lt;/span&gt; &lt;span class="nt"&gt;-g&lt;/span&gt; agent-desktop
agent-desktop status                &lt;span class="c"&gt;# platform, permissions, supported surfaces&lt;/span&gt;
agent-desktop permissions &lt;span class="nt"&gt;--guide&lt;/span&gt;   &lt;span class="c"&gt;# macOS: walks you through Accessibility authorization&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Bun, Yarn and pnpm install the same package. It bundles native binaries for x64 and ARM64 plus platform helpers.&lt;/p&gt;

&lt;p&gt;Alternatives:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Homebrew&lt;/strong&gt; on macOS and Linux: &lt;code&gt;brew install agent-desktop&lt;/code&gt;. No official Scoop package; the repo no longer maintains a custom Homebrew tap or Scoop bucket.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;GitHub Releases&lt;/strong&gt;: download the matching native archive and place the helper next to the executable, if you want to skip the JavaScript launcher.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;From source&lt;/strong&gt;: requires Rust. &lt;code&gt;Cargo.toml&lt;/code&gt; declares &lt;code&gt;rust-version = "1.89"&lt;/code&gt; and edition 2024.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;On macOS, nothing works until Accessibility permission is granted. &lt;code&gt;agent-desktop permissions --guide&lt;/code&gt; is the guided path; skipping it means snapshots come back empty and you'll spend an hour debugging the wrong layer.&lt;/p&gt;

&lt;h2&gt;
  
  
  Failure modes worth knowing before you write the loop
&lt;/h2&gt;

&lt;p&gt;These are the ones that cost time.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Stale refs.&lt;/strong&gt; If the UI changed between snapshot and action, the command returns &lt;code&gt;STALE_REF&lt;/code&gt; or &lt;code&gt;AMBIGUOUS_TARGET&lt;/code&gt;. The fix is always the same: re-snapshot, use the new ref. Don't retry the old one. An agent that retries blindly will burn turns.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;PowerShell quoting.&lt;/strong&gt; On Windows PowerShell, &lt;code&gt;@token&lt;/code&gt; is the splatting operator. Every ref must be quoted:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="n"&gt;agent-desktop&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;click&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;'@s8f3k2p9:e8'&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Unquoted, the shell eats it before the CLI sees it.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Blocked postinstall.&lt;/strong&gt; If npm blocks the &lt;code&gt;postinstall&lt;/code&gt; script, every invocation pays roughly 125ms extra. Reinstall with &lt;code&gt;--allow-scripts=agent-desktop&lt;/code&gt;. For project-local installs there's a separate &lt;code&gt;npm install-scripts approve&lt;/code&gt; flow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Privacy.&lt;/strong&gt; Snapshots, clipboard reads, screenshots, command output and debug artifacts can all contain private desktop content. The README says this plainly, and it's not boilerplate. A snapshot of a mail client is a snapshot of your inbox. Don't put these in public logs or upload them to a shared trace viewer.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the Chinese version adds
&lt;/h2&gt;

&lt;p&gt;The translated repo is structured in two layers, and the split is the useful part.&lt;/p&gt;

&lt;p&gt;The top section — 「中文快速上手」 — is explicitly labeled as supplementary, not part of the original. It answers the questions a Chinese-speaking developer hits in the first ten minutes:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;What problem does this solve, in one paragraph&lt;/li&gt;
&lt;li&gt;The shortest install-to-first-snapshot path&lt;/li&gt;
&lt;li&gt;Environment requirements (Node 18+, x64/ARM64, the Homebrew and source-build routes)&lt;/li&gt;
&lt;li&gt;A "common pitfalls" list: the snapshot-id requirement, PowerShell quoting, the postinstall penalty, the privacy warning, macOS authorization&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Below that, the README body is a translation of the original documentation, with a stated goal of staying faithful to the source. The original English README is kept as &lt;code&gt;README_en.md&lt;/code&gt; for comparison. Translation errors are handled by Issue or PR, which is the right call — a translated technical doc that can't be diffed against its source is worse than no translation.&lt;/p&gt;

&lt;p&gt;The value here is narrow but real. The English README is not long, but it's dense with platform-specific caveats — the PowerShell splatting issue, the &lt;code&gt;STALE_REF&lt;/code&gt; semantics, the macOS permission gate. Those are exactly the sentences a non-native reader skims and then loses an afternoon to. Having them in Chinese, with the pitfalls pulled forward into a checklist, shortens the path to a working snapshot.&lt;/p&gt;

&lt;p&gt;One caveat on the translation date: the header lists 2026-11-05. The upstream project moves; if you're reading this much later, check &lt;code&gt;README_en.md&lt;/code&gt; for drift.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where this fits
&lt;/h2&gt;

&lt;p&gt;If you're building an agent that needs to drive a real desktop app, the accessibility-tree approach has a clear advantage over pixel matching: elements come back with roles, names and available actions, so the agent reasons over semantics instead of coordinates. It also has a clear cost: you're dependent on how well each app implements accessibility. Apps with poor trees will give you poor snapshots, and no amount of prompt engineering fixes that.&lt;/p&gt;

&lt;p&gt;The tool is honest about its scope. It reads, it acts, it reports. The loop is yours.&lt;/p&gt;

&lt;p&gt;Repo: &lt;a href="https://github.com/yangshun2005/agent-desktop-cn" rel="noopener noreferrer"&gt;yangshun2005/agent-desktop-cn&lt;/a&gt; — Chinese translation, published today, 0 stars. Upstream: &lt;a href="https://github.com/vercel-labs/agent-desktop" rel="noopener noreferrer"&gt;vercel-labs/agent-desktop&lt;/a&gt;, 14547 stars, Rust, Apache-2.0.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/agent-desktop-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/agent-desktop-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>t3code: a Chinese translation of the agent harness control panel, and what it actually gets you</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Sun, 01 Nov 2026 08:17:58 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/t3code-a-chinese-translation-of-the-agent-harness-control-panel-and-what-it-actually-gets-you-1i6g</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/t3code-a-chinese-translation-of-the-agent-harness-control-panel-and-what-it-actually-gets-you-1i6g</guid>
      <description>&lt;p&gt;T3 Code is a control surface for coding agents you already run on your own machine. The upstream project is &lt;code&gt;pingdotgg/t3code&lt;/code&gt;, 36,095 stars, written in TypeScript, MIT licensed. There is now a Chinese translation of its documentation at &lt;code&gt;yangshun2005/t3code-cn&lt;/code&gt;, published 2026-11-01.&lt;/p&gt;

&lt;p&gt;That translation is the subject here. Not because a translated README is remarkable in itself, but because of what the original project asks of its reader before anything works.&lt;/p&gt;

&lt;h2&gt;
  
  
  What T3 Code is, precisely
&lt;/h2&gt;

&lt;p&gt;The README calls it an "agent harness control surface." Read that literally. T3 Code ships no model. It does not proxy your API keys to some inference endpoint. It connects to agents already installed and authenticated on your local machine, and gives you an interface to drive them from an iOS app, an Android app, a web app, or an Electron desktop build.&lt;/p&gt;

&lt;p&gt;The supported providers, per the README:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Codex&lt;/li&gt;
&lt;li&gt;Claude Code&lt;/li&gt;
&lt;li&gt;Cursor&lt;/li&gt;
&lt;li&gt;Grok Build&lt;/li&gt;
&lt;li&gt;OpenCode&lt;/li&gt;
&lt;li&gt;Google Antigravity&lt;/li&gt;
&lt;li&gt;fx&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If none of those are installed and logged in on your machine, T3 Code has nothing to control. That constraint shapes the entire onboarding flow, and it is the first thing the Chinese version front-loads.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why the translation matters more than it sounds
&lt;/h2&gt;

&lt;p&gt;The original README is honest about the project's state: "very, very early, expect bugs," and contributions are largely closed — small fixes might be considered, large features will not. So this is not a project where you read the docs, file an issue, and wait. You read the docs, get it running, and decide for yourself.&lt;/p&gt;

&lt;p&gt;Getting it running means seven different authentication commands across seven different CLIs, plus platform-specific install paths for macOS, Linux, Windows, Debian, Ubuntu, Arch, and Nix. Every one of those steps is a place where a non-English reader stalls — not because the English is hard, but because the failure modes are terse and the commands are easy to mistype.&lt;/p&gt;

&lt;p&gt;The Chinese version addresses this with a structure the original does not have. It separates two things:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;A &lt;strong&gt;中文快速上手&lt;/strong&gt; section at the top, explicitly labeled as supplementary orientation material, not part of the original.&lt;/li&gt;
&lt;li&gt;The &lt;strong&gt;translated README body&lt;/strong&gt; below it, which aims to stay faithful to the source.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;That split is the right call. A translation that silently adds advice is a translation you cannot trust. A translation that only translates leaves the reader to assemble the setup sequence themselves. Marking the boundary lets you use the fast path and still know which parts are the author's additions.&lt;/p&gt;

&lt;h2&gt;
  
  
  The shortest path to a running instance
&lt;/h2&gt;

&lt;p&gt;The quick-start section condenses the setup into five steps. Here is what it says, in order.&lt;/p&gt;

&lt;p&gt;First, install and log in to at least one supported agent. The commands, as given:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Codex&lt;/span&gt;
codex login

&lt;span class="c"&gt;# Claude Code&lt;/span&gt;
claude auth login

&lt;span class="c"&gt;# Cursor CLI&lt;/span&gt;
agent login

&lt;span class="c"&gt;# Grok Build&lt;/span&gt;
grok login

&lt;span class="c"&gt;# OpenCode&lt;/span&gt;
opencode auth login
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Antigravity is the exception — no CLI. You enable it in Settings, then click &lt;strong&gt;Install Antigravity&lt;/strong&gt; and &lt;strong&gt;Sign in with Google&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;fx has its own wrinkle: &lt;code&gt;fx login&lt;/code&gt; must run on the machine hosting the T3 Code server, not just any machine. The Chinese version calls this out explicitly in its pitfalls section. The original mentions it too, but buried in a provider list; the translated version surfaces it as a standalone warning.&lt;/p&gt;

&lt;p&gt;Second, install the CLI. macOS and Linux:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-fsSL&lt;/span&gt; https://t3.codes/install.sh | sh
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Windows PowerShell:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="n"&gt;irm&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;https://t3.codes/install.ps1&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;iex&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Third, run &lt;code&gt;t3&lt;/code&gt;. That starts the server and opens the local web app.&lt;/p&gt;

&lt;p&gt;Fourth, optional service management:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;t3 service &lt;span class="nb"&gt;install&lt;/span&gt;   &lt;span class="c"&gt;# run in background&lt;/span&gt;
t3 update            &lt;span class="c"&gt;# upgrade&lt;/span&gt;
t3 &lt;span class="nt"&gt;--help&lt;/span&gt;            &lt;span class="c"&gt;# full command reference&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Fifth, if you want to try without installing: &lt;code&gt;npx t3@latest&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Desktop builds are also available from GitHub Releases or via package managers — &lt;code&gt;winget install T3Tools.T3Code&lt;/code&gt; and &lt;code&gt;brew install --cask t3-code&lt;/code&gt; are two the README lists.&lt;/p&gt;

&lt;h2&gt;
  
  
  The network caveat the original doesn't discuss
&lt;/h2&gt;

&lt;p&gt;The Chinese quick-start adds a note that the install scripts and desktop packages all download from overseas addresses: &lt;code&gt;t3.codes&lt;/code&gt;, GitHub Releases, and various package managers. Under restricted network conditions you may need your own acceleration or mirror.&lt;/p&gt;

&lt;p&gt;It also states plainly that the original provides no mirror sources. That is accurate and worth saying. A translated doc that pretends the network is uniform is less useful than one that flags the gap and admits it has no fix.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the translation does not claim
&lt;/h2&gt;

&lt;p&gt;No hardware requirements. No minimum OS versions. The Chinese version says so directly rather than inventing them: "原文未说明" appears in the environment requirements section for both hardware and OS version floors.&lt;/p&gt;

&lt;p&gt;That restraint is the thing I'd point to if you're evaluating whether to trust this translation. It would have been easy to fill those blanks with plausible guesses. The author didn't.&lt;/p&gt;

&lt;p&gt;The one build-from-source detail it does add: you need the global &lt;code&gt;vp&lt;/code&gt; (Vite+) tool installed, then run &lt;code&gt;vp i&lt;/code&gt;. That comes from the original's build instructions, just relocated to where a reader would look for it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who this is for
&lt;/h2&gt;

&lt;p&gt;If you already use Claude Code or Codex locally and want a unified, remote-capable interface across phone, web, and desktop, T3 Code is aimed at you. If you have none of the seven supported agents installed, there is no partial mode — the project simply won't do anything.&lt;/p&gt;

&lt;p&gt;The Chinese version lowers the entry barrier for that first group by removing the assembly work: the provider matrix, the per-platform install commands, and the ordering constraints are all in one place, in the language you're reading. My sense is that most of the friction in early-stage projects like this is not conceptual difficulty but sequence confusion — which command first, which machine, which login. That's exactly what the quick-start section targets. Your mileage may vary depending on which provider you pick; the fx path in particular has that server-machine constraint that's easy to miss even when it's written down.&lt;/p&gt;

&lt;p&gt;The translation is at &lt;code&gt;github.com/yangshun2005/t3code-cn&lt;/code&gt;. It carries zero stars as of publication — it went up today. The upstream project it documents has 36,095. Corrections to the translation go through Issues or PRs, per the README.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/t3code-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/t3code-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>Claude-Code-Game-Studios: A Chinese Translation for Claude Code's 49-Agent Game Studio</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Sun, 01 Nov 2026 07:47:32 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/claude-code-game-studios-a-chinese-translation-for-claude-codes-49-agent-game-studio-43g0</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/claude-code-game-studios-a-chinese-translation-for-claude-codes-49-agent-game-studio-43g0</guid>
      <description>&lt;p&gt;The original repo has 31,393 stars. The Chinese translation launched today with zero. That gap is the whole point of this article: the project is worth reading, and for a Chinese-speaking developer the barrier to reading it just dropped.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the project actually is
&lt;/h2&gt;

&lt;p&gt;Claude-Code-Game-Studios (original: &lt;code&gt;Donchitos/Claude-Code-Game-Studios&lt;/code&gt;, Shell, MIT) is a configuration template for Claude Code. It does not generate games. It restructures a single chat session into something that behaves like a studio hierarchy.&lt;/p&gt;

&lt;p&gt;The numbers from the README:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Category&lt;/th&gt;
&lt;th&gt;Count&lt;/th&gt;
&lt;th&gt;What it covers&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Agents&lt;/td&gt;
&lt;td&gt;49&lt;/td&gt;
&lt;td&gt;Sub-agents across design, programming, art, audio, narrative, QA, production&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Skills&lt;/td&gt;
&lt;td&gt;74&lt;/td&gt;
&lt;td&gt;Slash commands for each workflow stage&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Hooks&lt;/td&gt;
&lt;td&gt;15&lt;/td&gt;
&lt;td&gt;Automatic validation on commit, push, asset changes, design doc reads/writes, registry writes, session lifecycle, agent audit trail, gap detection&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Rules&lt;/td&gt;
&lt;td&gt;14&lt;/td&gt;
&lt;td&gt;Path-scoped coding standards&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Templates&lt;/td&gt;
&lt;td&gt;62&lt;/td&gt;
&lt;td&gt;GDD, UX spec, ADR, sprint plan, HUD design, accessibility, and more&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The problem it targets is stated plainly in the README: a solo developer using AI has no structure. Nobody stops you from hardcoding magic numbers. Nobody asks whether a feature matches the game's vision. There is no QA pass and no design review.&lt;/p&gt;

&lt;h2&gt;
  
  
  The three-layer hierarchy
&lt;/h2&gt;

&lt;p&gt;Agents are organized the way a real studio is:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Layer 1 — Directors
  creative-director    technical-director    producer

Layer 2 — Department Leads
  game-designer        lead-programmer       art-director
  audio-director       narrative-director    qa-lead
  release-manager      localization-lead

Layer 3 — Specialists
  gameplay-programmer  engine-programmer     ai-programmer
  network-programmer   tools-programmer      ui-programmer
  systems-designer     level-designer        economy-designer
  technical-artist     sound-designer        writer
  world-builder        ux-designer           prototyper
  performance-analyst  devops-engineer
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Each agent has a defined scope, an escalation path, and quality gates. You still make every decision. The difference is that the session now pushes back — asks the questions a lead would ask, catches errors earlier.&lt;/p&gt;

&lt;p&gt;One practical detail worth flagging before you start: model requirements differ per agent. The three director agents require Opus. &lt;code&gt;lead-programmer&lt;/code&gt; and 15 specialists specify Sonnet. The remaining 30 inherit whatever model your session is running. If your session model is lower than what a role expects, that role may not behave as intended.&lt;/p&gt;

&lt;h2&gt;
  
  
  Getting a session running
&lt;/h2&gt;

&lt;p&gt;The Chinese README adds a "中文快速上手" (quick start) section that is explicitly marked as supplementary, not part of the original translation. It exists so you can get moving without reading the full document first. The shortest path:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/Donchitos/Claude-Code-Game-Studios
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Open the project directory in Claude Code, then:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;/start&lt;/code&gt; — begins the guided flow&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;/setup-engine&lt;/code&gt; — pick Godot 4, Unity, or Unreal Engine 5&lt;/li&gt;
&lt;li&gt;Then move through &lt;code&gt;/brainstorm&lt;/code&gt;, &lt;code&gt;/design-system&lt;/code&gt;, &lt;code&gt;/create-epics&lt;/code&gt;, &lt;code&gt;/create-stories&lt;/code&gt;, &lt;code&gt;/dev-story&lt;/code&gt;, &lt;code&gt;/story-done&lt;/code&gt; as needed&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The engine choice matters. There are three separate agent sets, one per engine, and &lt;code&gt;/setup-engine&lt;/code&gt; selects the matching one. Pick wrong and your specialists won't line up with your project.&lt;/p&gt;

&lt;p&gt;The original README does not provide an explicit install or launch command, and the Chinese version says so rather than inventing one. Platform support and hardware requirements are also marked as not specified in the source material — the "Platform Support" section was truncated in what was available for translation. The only hard dependency stated is Claude Code itself.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why the Chinese version is worth having
&lt;/h2&gt;

&lt;p&gt;The translation is faithful to the original — the body of the README is translated text, and the quick-start section is clearly separated as an addition. That separation is the right call. You can tell at a glance which parts are the author's words and which are translator commentary.&lt;/p&gt;

&lt;p&gt;For a Chinese-speaking developer, the practical gain is not just language comfort. This is a document dense with role names, workflow vocabulary, and process concepts — "department lead," "escalation path," "quality gate," "sprint plan," "ADR." Reading that in a second language while also trying to learn an unfamiliar workflow is slow. Having the terminology in Chinese means you spend your attention on the structure instead of on parsing.&lt;/p&gt;

&lt;p&gt;The quick-start section also front-loads the things that trip people up:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Model cost.&lt;/strong&gt; Some agents require Opus or Sonnet. Budget for it or expect degraded behavior from those roles.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Engine selection is exclusive.&lt;/strong&gt; One of three agent sets, chosen via &lt;code&gt;/setup-engine&lt;/code&gt;. This is a one-time decision that shapes everything downstream.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;It is a process template, not a game generator.&lt;/strong&gt; Output is design docs, architecture, stories, reviews. Not a playable build.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Upgrades have their own doc.&lt;/strong&gt; The repo includes &lt;code&gt;UPGRADING.md&lt;/code&gt;. Read it before upgrading so you don't overwrite custom configuration. The specific upgrade steps aren't detailed in the available material.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That last point is a good example of how the translation handles uncertainty: it says what the source says and marks what the source doesn't cover, rather than filling gaps with guesses.&lt;/p&gt;

&lt;h2&gt;
  
  
  What it produces
&lt;/h2&gt;

&lt;p&gt;The README has a section titled "它产出游戏还是文档？" (Does it produce games or documents?). The available material is truncated at that point, so the original's conclusion isn't stated here. What is clear from the rest of the document is that the output is process artifacts — GDDs, UX specs, ADRs, sprint plans, HUD designs, accessibility docs, drawn from the 62 templates. Treat it as scaffolding for a solo project that would otherwise have none.&lt;/p&gt;

&lt;h2&gt;
  
  
  A note on the numbers
&lt;/h2&gt;

&lt;p&gt;31,393 stars belong to the original project. The Chinese translation is new and has none yet. If you're evaluating whether to adopt this, the star count tells you the original is widely used; it tells you nothing about the translation's quality. The translation's own claim is modest — if something is inaccurate, open an issue or a PR.&lt;/p&gt;

&lt;p&gt;My read is that the translation is competent and the structure is honest about its own limits. That's a small sample, and it may not hold for you.&lt;/p&gt;

&lt;h2&gt;
  
  
  Repository
&lt;/h2&gt;

&lt;p&gt;Chinese version: &lt;a href="https://github.com/yangshun2005/Claude-Code-Game-Studios-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/Claude-Code-Game-Studios-cn&lt;/a&gt;&lt;br&gt;
Original: &lt;a href="https://github.com/Donchitos/Claude-Code-Game-Studios" rel="noopener noreferrer"&gt;https://github.com/Donchitos/Claude-Code-Game-Studios&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;License: MIT. Language: Shell.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/Claude-Code-Game-Studios-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/Claude-Code-Game-Studios-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>claude-mem: a Chinese translation of the persistent-memory layer for Claude Code</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Fri, 30 Oct 2026 19:40:28 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/claude-mem-a-chinese-translation-of-the-persistent-memory-layer-for-claude-code-3pd5</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/claude-mem-a-chinese-translation-of-the-persistent-memory-layer-for-claude-code-3pd5</guid>
      <description>&lt;p&gt;Every time you open a new Claude Code session, the model starts from zero. It doesn't remember that you already fixed the auth bug two hours ago, or which file holds the retry logic, or why you rejected the first approach. You re-explain, it re-reads, and the loop repeats.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;claude-mem&lt;/code&gt; is a project that tries to close that gap. The upstream repo is &lt;code&gt;thedotmack/claude-mem&lt;/code&gt;, written in TypeScript, Apache-2.0 licensed, with 105,900 stars. A Chinese translation of its documentation was published today at &lt;a href="https://github.com/yangshun2005/claude-mem-cn" rel="noopener noreferrer"&gt;&lt;code&gt;yangshun2005/claude-mem-cn&lt;/code&gt;&lt;/a&gt;. That translation is what I want to look at here — not because the translation itself is technically interesting, but because of what it changes for a specific group of developers.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the project actually does
&lt;/h2&gt;

&lt;p&gt;The one-line description from upstream is: &lt;em&gt;"Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions."&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Stripped of the marketing, the mechanism is:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Capture.&lt;/strong&gt; During a Claude Code session, claude-mem records "observations" about tool usage — what the agent read, ran, changed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Compress.&lt;/strong&gt; Those raw observations get summarized into semantic form.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Inject.&lt;/strong&gt; In later sessions, relevant pieces of that compressed memory are fed back into context.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The stated goal is knowledge continuity: Claude keeps a working model of the project across session boundaries and reconnects. It's advertised as working with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode and others.&lt;/p&gt;

&lt;p&gt;That's the whole pitch. Whether the compression is good enough to be useful rather than noisy is something you'd have to judge on your own codebase — I haven't benchmarked it, and the README doesn't publish accuracy numbers.&lt;/p&gt;

&lt;h2&gt;
  
  
  Install path
&lt;/h2&gt;

&lt;p&gt;The primary install command from the README:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx claude-mem &lt;span class="nb"&gt;install&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For Grok Bot there's a separate invocation:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx claude-mem &lt;span class="nb"&gt;install&lt;/span&gt; &lt;span class="nt"&gt;--ide&lt;/span&gt; grok-bot
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The installer configures the environment first, then asks you to log in through the browser using an email magic link. No credit card. Login assigns your account a memory key and unlocks the claude-mem observer with a 30-day free trial.&lt;/p&gt;

&lt;p&gt;After login you pick a memory provider:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;claude-mem observer (the hosted option)&lt;/li&gt;
&lt;li&gt;your own OpenRouter key&lt;/li&gt;
&lt;li&gt;your own Gemini key&lt;/li&gt;
&lt;li&gt;your Anthropic plan&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you'd rather not log in at all, the README lists three escape hatches: pass &lt;code&gt;--provider&lt;/code&gt; explicitly, set &lt;code&gt;CLAUDE_MEM_ONLINE_OPTIN=false&lt;/code&gt;, or run in a CI / non-interactive environment. The README text is truncated at that point, so the full non-interactive details aren't documented in what I have.&lt;/p&gt;

&lt;p&gt;Node.js &lt;code&gt;&amp;gt;=20.0.0&lt;/code&gt; is the dependency floor. Current version is 15.7.0. The README doesn't state which operating systems are supported or what hardware it wants — that's a gap, not an omission on my part.&lt;/p&gt;

&lt;h2&gt;
  
  
  The parts that will bite you
&lt;/h2&gt;

&lt;p&gt;Three things in the README are worth reading twice before you install.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The trial expires.&lt;/strong&gt; The claude-mem observer is a 30-day free trial. When it ends, memory functionality falls back to your Anthropic plan unless you subscribe. If you're evaluating this for a team, that's a cost decision you should make up front rather than discover in month two.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Grok Bot works differently.&lt;/strong&gt; Grok Bot has no host hooks, so claude-mem watches chat log files instead. It defaults to hosted CMEM Pro; the local observer requires &lt;code&gt;--provider host&lt;/code&gt; to be turned on explicitly. Installing that plugin does not install Cursor.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Awareness push writes to disk.&lt;/strong&gt; For Grok Bot, key observations — &lt;code&gt;decision&lt;/code&gt;, &lt;code&gt;bugfix&lt;/code&gt;, &lt;code&gt;security_alert&lt;/code&gt;, &lt;code&gt;sensitive&lt;/code&gt; — get appended as dated &lt;code&gt;- YYYY-MM-DD [awareness] …&lt;/code&gt; lines into &lt;code&gt;memory/log/YYYY-MM.md&lt;/code&gt;. Grok Bot already re-reads logs from disk. This does &lt;em&gt;not&lt;/em&gt; write to &lt;code&gt;profile.md&lt;/code&gt;, user memory, or project memory. You can disable it with &lt;code&gt;CLAUDE_MEM_GROK_BOT_AWARENESS_ENABLED=false&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;That last one matters if you care about what lands in your repo. A log file accumulating security-flagged observations is exactly the kind of thing you want to know about before it's committed.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why a Chinese translation is more than a convenience
&lt;/h2&gt;

&lt;p&gt;Here's the part I actually want to argue.&lt;/p&gt;

&lt;p&gt;The upstream README is long. It has a 30-language selector strip, a quick start, a "how it works" section, search tools, docs, configuration, and troubleshooting. For an English reader that's a lot of scrolling. For a Chinese-speaking developer it's worse: you're parsing configuration semantics in a second language while simultaneously trying to decide whether the tool fits your workflow. Those are two different cognitive loads, and doing them at once is how people misread &lt;code&gt;--provider host&lt;/code&gt; as optional.&lt;/p&gt;

&lt;p&gt;The &lt;code&gt;claude-mem-cn&lt;/code&gt; repo does something slightly smarter than a straight translation. It splits the page into two layers:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A &lt;strong&gt;中文快速上手&lt;/strong&gt; section at the top, explicitly marked as supplementary material, not part of the original. This is a curated导读 — what the project is, what problem it solves, the shortest path to running it, environment requirements, and common pitfalls.&lt;/li&gt;
&lt;li&gt;The &lt;strong&gt;translated README body&lt;/strong&gt; below, which the maintainer states aims to stay faithful to the original.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That distinction is stated openly in the README: &lt;em&gt;"本页顶部的「中文快速上手」为面向中文用户的补充导读（非原文内容）"&lt;/em&gt; — the top section is a guide for Chinese users, not original content. And: &lt;em&gt;"如有翻译不准确之处，欢迎提 Issue 或 PR"&lt;/em&gt; — inaccuracies should go to issues or PRs.&lt;/p&gt;

&lt;p&gt;I like this because it's honest about provenance. A translation that silently blends editorial additions into the source text is worse than useless; you can't tell which claims are the project's and which are the translator's. Here the boundary is drawn in the document itself.&lt;/p&gt;

&lt;p&gt;The quick-start section also front-loads the things that would otherwise cost you an hour: that login is required by default, that the free trial has an end date, that Grok Bot has different constraints, that awareness push can be turned off. Those are all in the English README too, but scattered. Collecting them into one screen is the actual value-add, more than the translation itself.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the translation doesn't solve
&lt;/h2&gt;

&lt;p&gt;Two honest caveats.&lt;/p&gt;

&lt;p&gt;First, the quick-start section inherits the same truncation as the source. The non-interactive install path is described as "原文此处被截断，后续细节未说明" — the original is cut off there, details not given. So if you're trying to wire this into CI, the Chinese version won't get you further than the English one. You'll need to read the source.&lt;/p&gt;

&lt;p&gt;Second, the translation is dated 2026-10-31 and the project is at 15.7.0. Fast-moving repos drift. If you're reading this much later, check whether the Chinese README still matches upstream before trusting a specific flag name.&lt;/p&gt;

&lt;h2&gt;
  
  
  Should you try it
&lt;/h2&gt;

&lt;p&gt;If you use Claude Code on a project that spans multiple sessions — which is most real projects — the problem claude-mem addresses is real. Session amnesia is annoying and it costs tokens.&lt;/p&gt;

&lt;p&gt;Whether claude-mem is the right fix depends on things the README can't tell you: how well the compression holds up on your codebase, whether the hosted observer is worth a subscription after the trial, and whether you're comfortable with observations being written to log files in your repo. My sample of one README is not enough to answer any of those.&lt;/p&gt;

&lt;p&gt;What I can say is that the Chinese translation lowers the entry cost meaningfully. If your team reads Chinese and has been putting off evaluating this because the docs are dense English, the barrier just got smaller. The install is one command, the trial is 30 days, and the pitfalls are now listed in one place at the top of the page.&lt;/p&gt;

&lt;p&gt;That's a reasonable place to start.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Original: &lt;a href="https://github.com/thedotmack/claude-mem" rel="noopener noreferrer"&gt;thedotmack/claude-mem&lt;/a&gt; — 105,900 stars, TypeScript, Apache-2.0&lt;/li&gt;
&lt;li&gt;Chinese version: &lt;a href="https://github.com/yangshun2005/claude-mem-cn" rel="noopener noreferrer"&gt;yangshun2005/claude-mem-cn&lt;/a&gt; — published today&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/claude-mem-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/claude-mem-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>browser: A Chinese Translation of Lightpanda, the Zig Headless Browser for AI Agents</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Fri, 30 Oct 2026 19:12:42 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/browser-a-chinese-translation-of-lightpanda-the-zig-headless-browser-for-ai-agents-3eb</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/browser-a-chinese-translation-of-lightpanda-the-zig-headless-browser-for-ai-agents-3eb</guid>
      <description>&lt;p&gt;Lightpanda's own README makes a specific claim: 933 real web pages, fetched over the network on an AWS EC2 m5.large instance, peak memory around 123MB against roughly 2GB for Headless Chrome, execution time around 5s against roughly 46s. Those are the numbers the project publishes, and they are the reason a translation of its documentation is worth talking about at all.&lt;/p&gt;

&lt;p&gt;The project is &lt;a href="https://github.com/lightpanda-io/browser" rel="noopener noreferrer"&gt;lightpanda-io/browser&lt;/a&gt;, 38165 stars, written in Zig, licensed AGPL-3.0. It is not a Chromium fork and not a WebKit patch. It is a new headless browser built from scratch for AI agents and automation workloads.&lt;/p&gt;

&lt;p&gt;A Chinese translation of that documentation now exists: &lt;a href="https://github.com/yangshun2005/browser-cn" rel="noopener noreferrer"&gt;yangshun2005/browser-cn&lt;/a&gt;. It is new — published today, zero stars. This article is about what is in it and why the translation matters more than it might sound.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the Chinese repository actually contains
&lt;/h2&gt;

&lt;p&gt;Two distinct layers, and the repository is explicit about the separation:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;A translated README&lt;/strong&gt; (&lt;code&gt;README.md&lt;/code&gt;), described as a faithful Chinese translation of the original project documentation. The original English README is kept alongside as &lt;code&gt;README_en.md&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A "中文快速上手" (Chinese quick start) section at the top&lt;/strong&gt;, marked as supplementary editorial content that is &lt;em&gt;not&lt;/em&gt; part of the original README. Its stated purpose: get you running without reading the whole document first.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;That second layer is the interesting one. A pure translation of a README assumes you already know what you want to do with the tool. A quick-start layer assumes you don't — which is the realistic state of most people arriving at a headless browser repository for the first time.&lt;/p&gt;

&lt;p&gt;The repository also states its own fallibility: translation inaccuracies are to be reported via Issue or PR. Given the translation date listed as 2026-10-31 and the fast-moving nature of the upstream project, expect drift over time.&lt;/p&gt;

&lt;h2&gt;
  
  
  The quick start, condensed
&lt;/h2&gt;

&lt;p&gt;The Chinese page lists every install path the upstream README offers. Reproduced here as they appear:&lt;/p&gt;

&lt;p&gt;Homebrew:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;brew install lightpanda-io/browser/lightpanda
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Arch Linux AUR:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;yay -S lightpanda-nightly-bin
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Linux x86_64 binary:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux &amp;amp;&amp;amp; \
chmod a+x ./lightpanda
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;macOS aarch64 binary:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-aarch64-macos &amp;amp;&amp;amp; \
chmod a+x ./lightpanda
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Docker:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:latest
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then verify the binary runs:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;./lightpanda version
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Fetch a URL and dump HTML:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;./lightpanda fetch --obey-robots --dump html --log-format pretty  --log-level info https://demo-browser.lightpanda.io/campfire-commerce/
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;--dump&lt;/code&gt; flag has other modes worth knowing about, all documented in the translated README: &lt;code&gt;--dump markdown&lt;/code&gt; for Markdown output, &lt;code&gt;--dump png &amp;gt; page.png&lt;/code&gt; and &lt;code&gt;--dump pdf &amp;gt; page.pdf&lt;/code&gt; for text-rendered output, and &lt;code&gt;--dump structured_data&lt;/code&gt; for JSON-LD and OpenGraph structured data.&lt;/p&gt;

&lt;p&gt;Start the CDP server:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight console"&gt;&lt;code&gt;&lt;span class="go"&gt;./lightpanda serve --obey-robots --log-format pretty  --log-level info --host 127.0.0.1 --port 9222
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then point Puppeteer at &lt;code&gt;browserWSEndpoint: "ws://127.0.0.1:9222"&lt;/code&gt;. The upstream README includes a full example script; the translation carries it over.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why a Chinese quick-start layer is not just a nicety
&lt;/h2&gt;

&lt;p&gt;Headless browser setup is a category of task where documentation friction compounds. You are usually doing three things at once: choosing an install method, confirming your platform is supported, and figuring out what the tool's output modes are. Every one of those steps has a failure mode that costs time.&lt;/p&gt;

&lt;p&gt;The Chinese page front-loads exactly those failure modes. Three of them are worth calling out because they are the ones people hit.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;No native Windows binary.&lt;/strong&gt; The supported platforms are Linux (x86_64, aarch64) and macOS (aarch64, x86_64). Windows requires WSL2, following the Linux steps. The page notes &lt;code&gt;wsl --install&lt;/code&gt; as the entry point. Android/Termux has no native build.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;musl distributions break.&lt;/strong&gt; The Linux release binaries link glibc. On Alpine and other musl-based systems you get &lt;code&gt;cannot execute: required file not found&lt;/code&gt; because the glibc dynamic linker is absent. The fix is a glibc base image such as &lt;code&gt;debian:bookworm-slim&lt;/code&gt; or &lt;code&gt;ubuntu:24.04&lt;/code&gt;, or building from source. This is a genuinely annoying error message — it says nothing about glibc — and having it pre-explained in your first language is a real saving.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Building from source is slow.&lt;/strong&gt; The Makefile comments note that compiling V8 from source takes more than 10 minutes. &lt;code&gt;make download-v8&lt;/code&gt; pulls a precompiled V8 archive instead. The translated page flags this; the exact build commands are not fully reproduced in the material available.&lt;/p&gt;

&lt;p&gt;There is also a network note: installs pull from GitHub Releases, ziglang.org, and Docker Hub, so users on mainland Chinese networks may need mirror sources or download acceleration. That is the kind of sentence that never appears in an upstream README written for a global audience, and it is precisely the kind of sentence that saves an afternoon.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the translation does not claim
&lt;/h2&gt;

&lt;p&gt;Worth being clear about the boundaries, because the repository is:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The star count of 38165 refers to the &lt;strong&gt;original&lt;/strong&gt; project. The Chinese repository has zero stars as of writing.&lt;/li&gt;
&lt;li&gt;The benchmark figures (123MB vs ~2GB, 5s vs ~46s) are the upstream project's published results on AWS EC2 m5.large, not independently reproduced by the translator.&lt;/li&gt;
&lt;li&gt;The translation does not state a minimum Zig version, because the upstream README does not list one in its body. The Dockerfile reads &lt;code&gt;minimum_zig_version&lt;/code&gt; from &lt;code&gt;build.zig.zon&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;It does not state hardware requirements beyond the benchmark instance type.&lt;/li&gt;
&lt;li&gt;It does not describe what happens if you omit &lt;code&gt;--obey-robots&lt;/code&gt;. Every example command includes the flag; the behavior without it is undocumented in the source material.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That last point deserves a moment. Every fetch and serve example carries &lt;code&gt;--obey-robots&lt;/code&gt;. If you are crawling at any scale, whether the flag is on by default and what it does when absent is a question you should answer before pointing the tool at a target, not after.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where this fits
&lt;/h2&gt;

&lt;p&gt;Lightpanda's pitch is narrow and concrete: a browser for agents that does not carry Chromium's memory footprint. The benchmark gap — roughly 16x on memory, roughly 9x on time — is the whole argument. If your crawler runs in a container with a memory limit, or if you are paying per-instance-hour for a fleet of them, that gap is the difference between a viable architecture and an expensive one.&lt;/p&gt;

&lt;p&gt;The Chinese translation does not change any of that. What it changes is the number of people who can evaluate the claim quickly. A developer who can read the install matrix, spot the musl incompatibility, and know to use &lt;code&gt;make download-v8&lt;/code&gt; in their first ten minutes is a developer who gets to the actual benchmark question — does this work for &lt;em&gt;my&lt;/em&gt; pages — much sooner.&lt;/p&gt;

&lt;p&gt;My sample here is one repository published today, so I can't tell you how the translation holds up over time or how responsive the maintainer will be to corrections. The structure is right, though: original preserved as &lt;code&gt;README_en.md&lt;/code&gt;, translation clearly labeled, editorial additions clearly separated from translated content. That is the correct way to do this, and it is more than many translation repositories bother with.&lt;/p&gt;

&lt;p&gt;If you have been meaning to try Lightpanda and the English README was the thing you kept tabbing away from, the Chinese version is at &lt;a href="https://github.com/yangshun2005/browser-cn" rel="noopener noreferrer"&gt;github.com/yangshun2005/browser-cn&lt;/a&gt;. The upstream project is at &lt;a href="https://github.com/lightpanda-io/browser" rel="noopener noreferrer"&gt;github.com/lightpanda-io/browser&lt;/a&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/browser-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/browser-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>superpowers: a Chinese translation of the 307,936-star agent skills framework</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Thu, 29 Oct 2026 12:41:20 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/superpowers-a-chinese-translation-of-the-307936-star-agent-skills-framework-3nkj</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/superpowers-a-chinese-translation-of-the-307936-star-agent-skills-framework-3nkj</guid>
      <description>&lt;p&gt;Most coding agents have the same failure mode. You describe a feature, and before you finish the second sentence, the agent is already editing files. No clarifying questions, no spec, no plan. You get code that compiles and solves the wrong problem.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;obra/superpowers&lt;/code&gt; exists to interrupt that reflex. It is a software development methodology packaged as a set of composable skills plus bootstrap instructions, written for coding agents. The original repository has 307,936 stars, is primarily Shell, and ships under the MIT license.&lt;/p&gt;

&lt;p&gt;A Chinese translation was published today: &lt;a href="https://github.com/yangshun2005/superpowers-cn" rel="noopener noreferrer"&gt;yangshun2005/superpowers-cn&lt;/a&gt;. It has zero stars at the time of writing and no track record. What it does have is a translated README plus a short Chinese quick-start guide that the original doesn't include.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the project actually does
&lt;/h2&gt;

&lt;p&gt;The core behavior is a forced pause. When the agent detects you're building something, it does not start writing code. It steps back and asks what you're really trying to accomplish.&lt;/p&gt;

&lt;p&gt;From that conversation it produces a spec, presented in chunks small enough to actually read and digest. After you confirm the design, it writes an implementation plan — detailed enough, in the project's own framing, for an enthusiastic junior engineer with poor taste, no judgment, no context on the project, and a dislike of tests to follow. The plan emphasizes real red/green TDD, YAGNI, and DRY.&lt;/p&gt;

&lt;p&gt;Then, on your go-ahead, it runs a subagent-driven development loop: the agent works through each engineering task one at a time, checks and reviews the work, then moves on. The project claims agents can often work autonomously for hours without drifting from the plan.&lt;/p&gt;

&lt;p&gt;Skills trigger automatically. There is no special command to invoke them; the premise is that your agent simply has these capabilities once installed.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Chinese version: what's different
&lt;/h2&gt;

&lt;p&gt;The translation date listed in the repo is 2026-10-29. The structure is deliberately split in two:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A Chinese quick-start guide&lt;/strong&gt; at the top, explicitly labeled as supplementary material, not part of the original README. It covers what the project is, the shortest install path, environment requirements, and common pitfalls.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A faithful translation of the original README body&lt;/strong&gt; below it, with &lt;code&gt;README_en.md&lt;/code&gt; kept alongside for reference.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That split matters. Translated READMEs often bury the practical part — install commands, harness differences, update procedures — under a long conceptual preamble. Here the practical part comes first and is marked as an addition, so you can tell what's original and what's editorial.&lt;/p&gt;

&lt;p&gt;The maintainer asks for issues or PRs where the translation is inaccurate. That's the right posture for a translation of a fast-moving project: the English source will drift, and the Chinese copy will need to follow.&lt;/p&gt;

&lt;h2&gt;
  
  
  Installation, and why it's the main friction point
&lt;/h2&gt;

&lt;p&gt;Superpowers installs differently depending on your harness. If you use more than one, you install it separately for each. The original says this explicitly, and it's the first thing people get wrong.&lt;/p&gt;

&lt;p&gt;For Claude Code, via the official Anthropic plugin marketplace:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;/plugin &lt;span class="nb"&gt;install &lt;/span&gt;superpowers@claude-plugins-official
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Or register the Superpowers marketplace first, then install from it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;/plugin marketplace add obra/superpowers-marketplace
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;/plugin &lt;span class="nb"&gt;install &lt;/span&gt;superpowers@superpowers-marketplace
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;After that, start your coding agent normally. Skills fire on their own.&lt;/p&gt;

&lt;p&gt;The README lists per-harness instructions for Antigravity, Codex App, Codex CLI, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent, and Muse. Do not copy a command from one harness into another; several use entirely different mechanisms, some going through a plugin marketplace and others installing from the repository.&lt;/p&gt;

&lt;h2&gt;
  
  
  Pitfalls worth knowing before you start
&lt;/h2&gt;

&lt;p&gt;The Chinese quick-start collects these, and they're the ones that cost people time:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Install per harness.&lt;/strong&gt; Multiple harnesses means multiple installs. There is no shared installation.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;OpenCode is separate.&lt;/strong&gt; Even if Superpowers is already running in another harness, OpenCode needs its own install.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Update procedures differ.&lt;/strong&gt; Some harnesses have dedicated update commands, such as &lt;code&gt;devin plugins update superpowers&lt;/code&gt; and &lt;code&gt;gemini extensions update superpowers&lt;/code&gt;. Antigravity updates by re-running the same install command. For the rest, the original doesn't specify.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Network access.&lt;/strong&gt; Install commands pull from GitHub or from each harness's plugin marketplace. In mainland China this may require a mirror or accelerated download. The Chinese guide flags this; the original does not, for obvious reasons.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;On requirements, the original is silent about operating system, hardware, and version. The only hard dependency is a supported harness. &lt;code&gt;package.json&lt;/code&gt; lists the project version as 7.0.1.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why a Chinese translation is worth the effort
&lt;/h2&gt;

&lt;p&gt;The barrier here isn't the English language in the abstract. It's that this project's value is concentrated in behavioral nuance. "The agent steps back and asks what you're really trying to accomplish" is easy to translate. The reasoning behind it — why the spec is chunked, why the plan is written for a specific caricature of a junior engineer, why subagents review each other — is where readers decide whether to trust the methodology.&lt;/p&gt;

&lt;p&gt;Chinese-speaking developers are a large share of the audience for coding agents, and the harness list already includes Qwen Code and Kimi Code. A translated README with a practical entry point lowers the cost of evaluating the project from "read a long English document and hope the install section makes sense" to "run two commands and see what happens."&lt;/p&gt;

&lt;p&gt;That's the honest value proposition. Not that the translation is better than the original, but that it removes a step between curiosity and a working install.&lt;/p&gt;

&lt;h2&gt;
  
  
  A reasonable way to evaluate it
&lt;/h2&gt;

&lt;p&gt;Don't judge Superpowers by whether the agent writes code faster. Judge it by whether the agent asks better questions before writing anything.&lt;/p&gt;

&lt;p&gt;A small experiment: give your agent a feature request with a deliberate ambiguity in it — an unstated constraint, an unclear scope boundary. Run it once without Superpowers and once with. Watch whether the second run surfaces the ambiguity or silently picks an interpretation. My sample here is one project, so this may not hold for you, but the difference tends to be visible on the first try.&lt;/p&gt;

&lt;p&gt;If the agent does pause and ask, the methodology is doing its job. If it doesn't, check that the skills actually loaded for your harness — the per-harness install requirement is the usual culprit.&lt;/p&gt;

&lt;h2&gt;
  
  
  Links
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Chinese version: &lt;a href="https://github.com/yangshun2005/superpowers-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/superpowers-cn&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Original: &lt;a href="https://github.com/obra/superpowers" rel="noopener noreferrer"&gt;https://github.com/obra/superpowers&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;License: MIT&lt;/li&gt;
&lt;li&gt;Original stars: 307,936&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/superpowers-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/superpowers-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>DeepTutor: A Chinese Translation of the HKUDS Tutoring Agent, and What It Actually Saves You</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Thu, 29 Oct 2026 12:36:23 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/deeptutor-a-chinese-translation-of-the-hkuds-tutoring-agent-and-what-it-actually-saves-you-4dle</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/deeptutor-a-chinese-translation-of-the-hkuds-tutoring-agent-and-what-it-actually-saves-you-4dle</guid>
      <description>&lt;p&gt;The original README for HKUDS/DeepTutor is long. Long enough that a reader whose English is serviceable but not fast will bounce off it before reaching the install steps. That is the problem the Chinese translation at &lt;code&gt;yangshun2005/DeepTutor-cn&lt;/code&gt; tries to solve, and it is a narrower problem than "make the project accessible" — worth being precise about.&lt;/p&gt;

&lt;p&gt;The original project: 48925 stars, written in Python, Apache-2.0 licensed. Topics listed are ai-agents, ai-tutor, clawbot, cli-tool, deepresearch. Its own one-line description is "Lifelong Personalized Tutoring." The Chinese version was published today and has zero stars. Nothing in this article should be read as a claim that the translation has traction; it doesn't yet.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the translation actually contains
&lt;/h2&gt;

&lt;p&gt;The repository is structured around two distinct pieces of text, and the distinction matters:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;A translated version of the original README&lt;/strong&gt; (&lt;code&gt;README_en.md&lt;/code&gt; holds the English original). The stated intent is fidelity to the source — "力求忠于原文."&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A supplementary Chinese quick-start guide&lt;/strong&gt; at the top of the page, explicitly marked as &lt;em&gt;not&lt;/em&gt; part of the original document ("非原文内容"). Its purpose is to get you from zero to a running instance without reading the full README.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;That second part is the interesting one. A pure translation of a 3000-line README still leaves you reading 3000 lines. The quick-start is a different artifact: a curated path through the project for someone who wants to evaluate it in fifteen minutes.&lt;/p&gt;

&lt;p&gt;The translation is dated 2026-10-29. The README invites issues and PRs for inaccuracies, which is the right posture — translations of fast-moving projects rot quickly, and this one will too.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why a Chinese README is worth more than it sounds
&lt;/h2&gt;

&lt;p&gt;For a project like this, the documentation is not a wrapper around the code. It is where most of the design decisions live.&lt;/p&gt;

&lt;p&gt;Look at the release history in the README. Between v1.6.3 and v1.7.0 the project shipped, among other things: a breaking frontend/backend refactor, learner and guardian accounts, bounded tutoring memory, resumable embedding checkpoints, a Mastery Path mode with gated tools, LightRAG character models, Kiwix archives, per-model API capability declarations, and a single &lt;code&gt;exec&lt;/code&gt; tool unified across languages. Each of those is a paragraph or two in the changelog. Reading them in a second language, at speed, while also trying to understand the architecture, is where comprehension quietly fails.&lt;/p&gt;

&lt;p&gt;The failure mode isn't total. You get the gist. But you miss the qualifiers — the "bounded" in bounded memory, the "gated" in gated tools, the "explicit" in explicit per-model capabilities. Those words carry the actual engineering constraints. A reader working in a second language tends to skim past them and then wonder why the system behaves unexpectedly.&lt;/p&gt;

&lt;p&gt;The Chinese version's value is concentrated here: it lets a Chinese-speaking developer read the constraints at full resolution instead of at 70%.&lt;/p&gt;

&lt;h2&gt;
  
  
  The quick-start path
&lt;/h2&gt;

&lt;p&gt;The supplementary guide states the Python requirement plainly: 3.11 or above, per &lt;code&gt;pyproject.toml&lt;/code&gt; (&lt;code&gt;&amp;gt;=3.11&lt;/code&gt;). That is the first thing to check, and it is the kind of detail that gets buried in an English README's prerequisites section.&lt;/p&gt;

&lt;p&gt;The original README's own navigation reflects the project's shape:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;功能特性 · 快速开始 · 探索 DeepTutor · CLI · 生态 · 社区
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In English: features, quick start, exploring DeepTutor, CLI, ecosystem (EduHub and a skills community), community.&lt;/p&gt;

&lt;p&gt;That ordering is informative. The CLI section gets its own top-level slot — the README labels it "agent 原生接口," agent-native interface. If you are coming from a web-app mental model, that is the part to read first, because it tells you what the system considers its primary surface.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the project is, structurally
&lt;/h2&gt;

&lt;p&gt;From the README and the &lt;code&gt;pyproject.toml&lt;/code&gt; description, DeepTutor describes itself as an agent-native personalized learning companion with multi-agent collaboration and RAG. The pieces it integrates into a single learning workspace:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Document parsing&lt;/li&gt;
&lt;li&gt;Knowledge base retrieval&lt;/li&gt;
&lt;li&gt;Practice and assessment&lt;/li&gt;
&lt;li&gt;Voice and video reading&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That is a wide surface. The changelog confirms the width — releases mention exercise generation from original sources, question banks, reading folders with in-chat selection actions, paginated Office previews, chart images sent to vision models, native Gemini voice, Polish/German/French/Ukrainian interfaces, and a research toolset.&lt;/p&gt;

&lt;p&gt;A project this broad has a real onboarding cost, and documentation is the main lever on that cost. This is the argument for the translation, and it is a modest argument, not a dramatic one. It removes a language tax. It does not remove the complexity.&lt;/p&gt;

&lt;h2&gt;
  
  
  Reading the changelog as a design document
&lt;/h2&gt;

&lt;p&gt;One practical suggestion for anyone evaluating DeepTutor through the Chinese version: read the release notes before the feature list.&lt;/p&gt;

&lt;p&gt;The v1.6.7 entry is a list of fixes — whole books collapsing into empty chapters, quizzes producing no output, model drafts leaking into body text, formulas printing as raw source, unsubmittable cards. v1.6.6 mentions unsubmittable answers, a copy button that lied, Docker-internal Codex login, and a 100 KB reduction on the homepage route.&lt;/p&gt;

&lt;p&gt;These are not marketing entries. They tell you what breaks under load and what the maintainers prioritize. A translated changelog is arguably more useful than a translated feature list, because feature lists translate cleanly (the nouns survive) while bug descriptions carry the specific texture of what went wrong.&lt;/p&gt;

&lt;h2&gt;
  
  
  Caveats
&lt;/h2&gt;

&lt;p&gt;The translation is one day old. Expect drift: the original ships releases at a pace of roughly one every few days based on the dates in the README (v1.6.3 through v1.7.0 span September 2 to October 28). The Chinese README will lag.&lt;/p&gt;

&lt;p&gt;The quick-start is a supplement, not a substitute. If you hit something the guide doesn't cover, the English original is authoritative, and &lt;code&gt;README_en.md&lt;/code&gt; is right there in the same repository.&lt;/p&gt;

&lt;p&gt;And a translation is only as good as its review. The repository says as much. If you find a term rendered badly — "有界辅导记忆" for bounded tutoring memory is a reasonable choice, but reasonable choices are still choices — file an issue.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where to look
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Chinese version: &lt;a href="https://github.com/yangshun2005/DeepTutor-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/DeepTutor-cn&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Original: &lt;a href="https://github.com/HKUDS/DeepTutor" rel="noopener noreferrer"&gt;https://github.com/HKUDS/DeepTutor&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Project site: &lt;a href="https://deeptutor.info/" rel="noopener noreferrer"&gt;https://deeptutor.info/&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you are a Chinese-speaking developer who has been putting off trying DeepTutor because the README is a wall of English, the translation removes that specific excuse. The rest of the work — Python 3.11, the CLI, the knowledge base setup — is unchanged, and no translation makes it smaller.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/DeepTutor-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/DeepTutor-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>VoiceStudio: A Chinese Translation That Lowers the Setup Barrier</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Tue, 27 Oct 2026 12:51:11 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/voicestudio-a-chinese-translation-that-lowers-the-setup-barrier-150d</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/voicestudio-a-chinese-translation-that-lowers-the-setup-barrier-150d</guid>
      <description>&lt;p&gt;VoiceStudio's README is long. It covers voice cloning, voice design, video dubbing, dictation, transcription, audiobook creation, 646 languages, several engine options, and a hardware matrix that changes depending on whether you're on an NVIDIA card, an Apple Silicon Mac, an Intel Mac, or Windows on ARM. For a Chinese-speaking developer who just wants to hear the thing generate one sentence, that's a lot of English to read before the first &lt;code&gt;curl&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;The Chinese version of the project — &lt;a href="https://github.com/yangshun2005/VoiceStudio-cn" rel="noopener noreferrer"&gt;yangshun2005/VoiceStudio-cn&lt;/a&gt; — addresses exactly that. It is a translation of &lt;a href="https://github.com/debpalash/VoiceStudio" rel="noopener noreferrer"&gt;debpalash/VoiceStudio&lt;/a&gt;, which has 90387 stars and is written primarily in Python. The translation was published on 2026-10-27 and is licensed AGPL-3.0, matching the original.&lt;/p&gt;

&lt;p&gt;One thing worth stating up front so there's no confusion: the Chinese repository is brand new. It has no stars to speak of. The 90387 figure belongs to the original project, and every number in this article that refers to popularity refers to that original repo.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the Chinese repo actually contains
&lt;/h2&gt;

&lt;p&gt;It's not a fork with modified code. It's a documentation layer, and it's split into two clearly separated parts:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A translated README&lt;/strong&gt; (&lt;code&gt;README_en.md&lt;/code&gt; holds the original English). The translation aims to stay faithful to the source text.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A "中文快速上手" section at the top&lt;/strong&gt; that is explicitly marked as supplementary material, not part of the original. Its stated purpose is to let you get the project running without reading the whole README first.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That distinction matters. If you're trying to understand what an engine does or how a feature is specified, read the translated body. If you're trying to get from zero to a generated audio file, read the quick-start block. The repo says so itself, and it invites issues or PRs where the translation is inaccurate.&lt;/p&gt;

&lt;h2&gt;
  
  
  The quick-start path, in Chinese
&lt;/h2&gt;

&lt;p&gt;The most useful part of the translation for a first-time user is the condensed install sequence. On macOS or Linux:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-fsSL&lt;/span&gt; https://voicestudio.sh/install | sh
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;On Windows, in PowerShell:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="n"&gt;irm&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;https://voicestudio.sh/install.ps1&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;iex&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The Chinese guide adds a fallback the English README also mentions but which is easy to miss: if &lt;code&gt;voicestudio.sh/install&lt;/code&gt; is unreachable or returns a 404, run the script from the repository instead.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-fsSL&lt;/span&gt; https://raw.githubusercontent.com/debpalash/VoiceStudio/main/scripts/install.sh | sh
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;There's also the direct-download route. Releases ship per-platform packages — &lt;code&gt;.dmg&lt;/code&gt; for macOS, &lt;code&gt;.exe&lt;/code&gt; for Windows, &lt;code&gt;.AppImage&lt;/code&gt; and &lt;code&gt;.deb&lt;/code&gt; for Linux, &lt;code&gt;.apk&lt;/code&gt; for Android, &lt;code&gt;.ipa&lt;/code&gt; for iPhone — and Linux users can install via &lt;code&gt;sudo snap install voicestudio&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Once the app is open, the first-run flow is: go to &lt;strong&gt;Voice cloning&lt;/strong&gt;, pick an existing voice or add a clean reference recording, type your text, generate. When prompted, install the models it asks for.&lt;/p&gt;

&lt;h2&gt;
  
  
  The hardware table is where people get stuck
&lt;/h2&gt;

&lt;p&gt;This is the section I'd point a Chinese-speaking colleague to first, because the failure modes are non-obvious and they're all hardware-related.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;NVIDIA GPU on Windows or Linux&lt;/strong&gt;: CUDA acceleration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Apple Silicon (M1–M5)&lt;/strong&gt;: Metal (MPS) acceleration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AMD Radeon and some Ryzen AI on Windows&lt;/strong&gt;: CPU by default, with an optional Windows ROCm configuration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No discrete GPU&lt;/strong&gt;: runs entirely on CPU, but slower. The installer pulls a small CPU build of PyTorch and needs roughly 5 GB of free disk.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Intel Mac&lt;/strong&gt;: UI only. You need a remote backend; local inference isn't available.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Windows on ARM&lt;/strong&gt;: experimental, CPU only.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Two of those deserve emphasis. An Intel Mac cannot run the backend locally at all — that's not a performance caveat, it's a hard limitation. And "runs on CPU" is not the same as "runs well on CPU," which the original README is honest about.&lt;/p&gt;

&lt;p&gt;The translated guide also flags something the English text doesn't foreground: the install script and release packages are pulled from &lt;code&gt;voicestudio.sh&lt;/code&gt; and GitHub, so users on mainland Chinese networks may need their own acceleration or mirroring. The translation notes that the original provides no specific mirror sources. That's an accurate hedge rather than a fabricated workaround.&lt;/p&gt;

&lt;h2&gt;
  
  
  Dependencies, in one place
&lt;/h2&gt;

&lt;p&gt;The translation consolidates the requirements that are otherwise scattered:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Python &amp;gt;= 3.11 per &lt;code&gt;pyproject.toml&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Release downloads need &lt;code&gt;curl&lt;/code&gt; and a SHA-256 tool.&lt;/li&gt;
&lt;li&gt;Building from &lt;code&gt;--main&lt;/code&gt; additionally needs Git, Node.js 22+, Bun, Rust/Cargo, and platform build tools.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you're only installing a release, the second and third bullets mostly don't apply to you. If you're building from source, all of them do.&lt;/p&gt;

&lt;h2&gt;
  
  
  Licensing
&lt;/h2&gt;

&lt;p&gt;AGPL-3.0. The Chinese guide states plainly that closed-source commercial use requires a separate commercial license, and points to &lt;code&gt;hi@voicestudio.sh&lt;/code&gt; as the contact mentioned in the original. If you're evaluating VoiceStudio for anything commercial, read the license before you build a workflow around it. This is the kind of detail that's easy to skim past in a second language.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why a translation is worth having here
&lt;/h2&gt;

&lt;p&gt;VoiceStudio's stated scope is broad: voice cloning, voice design, video dubbing, dictation, transcription, audiobook creation, across 646 languages, with k2-fsa/OmniVoice as the default engine and other engines selectable. The original description frames it as an open-source, fully-local alternative to ElevenLabs, with local workflows running on your own hardware and remote services optional.&lt;/p&gt;

&lt;p&gt;That breadth is the reason the documentation is long, and the reason translation helps. A developer deciding whether to invest an afternoon in setup needs to answer specific questions fast: does my GPU qualify, which install path applies to my OS, what happens on an Intel Mac, what does the license permit. Those answers exist in the English README, but they're spread across a feature catalog, an engine guide, and a hardware matrix. Having them pre-digested in your first language shortens the time between "this looks interesting" and "it's running."&lt;/p&gt;

&lt;p&gt;The translation is also honest about its own limits. It marks the quick-start as supplementary, keeps the original English available as &lt;code&gt;README_en.md&lt;/code&gt;, and asks for corrections. That's the right posture for a translated technical document — the source of truth stays visible.&lt;/p&gt;

&lt;h2&gt;
  
  
  What it doesn't do
&lt;/h2&gt;

&lt;p&gt;It doesn't change the code, add mirrors, or fix the Intel Mac limitation. It won't make CPU inference fast. If your network can't reach &lt;code&gt;voicestudio.sh&lt;/code&gt; or GitHub, the translation tells you that's a known gap rather than pretending otherwise. And it won't help you if you don't read Chinese — the original repo remains the place to go.&lt;/p&gt;

&lt;p&gt;My own read is that the highest-value audience here is Chinese-speaking developers who already know they want a local TTS stack and just need the setup details without a translation detour. If that's you, start with the quick-start block, then check the hardware table against your machine before you commit the disk space. If your machine is an Intel Mac, check it before you commit anything at all.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/VoiceStudio-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/VoiceStudio-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>TradingAgents: A Chinese Translation of the Multi-Agent LLM Trading Framework</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Tue, 27 Oct 2026 10:57:56 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/tradingagents-a-chinese-translation-of-the-multi-agent-llm-trading-framework-72b</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/tradingagents-a-chinese-translation-of-the-multi-agent-llm-trading-framework-72b</guid>
      <description>&lt;p&gt;The original TradingAgents repository has 116882 stars. That number is the first thing most people see, and it is also the least interesting thing about the project. What matters more for a developer trying to read the code is that the documentation is in English, and the framework itself is a fairly dense multi-agent system with a lot of moving parts.&lt;/p&gt;

&lt;p&gt;A Chinese translation of the repository now exists: &lt;a href="https://github.com/yangshun2005/TradingAgents-cn" rel="noopener noreferrer"&gt;yangshun2005/TradingAgents-cn&lt;/a&gt;. It is a translation of &lt;a href="https://github.com/TauricResearch/TradingAgents" rel="noopener noreferrer"&gt;TauricResearch/TradingAgents&lt;/a&gt;, released today. It has no stars yet. This article is about what the project is, what the translation adds, and where the documentation still stops short.&lt;/p&gt;

&lt;h2&gt;
  
  
  What TradingAgents actually is
&lt;/h2&gt;

&lt;p&gt;The official one-line description is "Multi-Agents LLM Financial Trading Framework." In practice, the framework assigns different roles to LLM-driven agents and lets them discuss a market situation before producing a decision. The roles named in the translated README include a fundamentals analyst, a sentiment specialist, a technical analyst, a trader, and a risk management team.&lt;/p&gt;

&lt;p&gt;The structure is meant to mirror how a real trading desk divides labor. Each agent looks at a different slice of the problem, and the discussion between agents is part of the mechanism, not an afterthought. The project is written in Python and licensed under Apache-2.0.&lt;/p&gt;

&lt;p&gt;If you want to read the source, the language is not a barrier. If you want to understand the design decisions, the release history, and the data-handling rules, the documentation is where the friction lives.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the Chinese version adds
&lt;/h2&gt;

&lt;p&gt;The translation is faithful to the original README, and it says so explicitly. The translated body is marked as a translation of the original document. On top of that, the maintainer added a section labeled "中文快速上手" (Chinese quick start), which is clearly marked as supplementary material, not part of the original.&lt;/p&gt;

&lt;p&gt;That distinction is worth noting because it is easy to blur. The quick-start section is the part that lowers the barrier for Chinese-speaking developers. It answers questions the original README does not answer in its opening pages: what Python version do I need, how do I install it, what command do I run.&lt;/p&gt;

&lt;p&gt;The translation date is recorded as 2026-10-27, and the original English README is kept in the repository as &lt;code&gt;README_en.md&lt;/code&gt;. If you suspect a translation error, you can check the source directly. The maintainer invites issues and pull requests for inaccuracies.&lt;/p&gt;

&lt;h2&gt;
  
  
  Getting it running
&lt;/h2&gt;

&lt;p&gt;The quick-start section is short and concrete. The minimum Python version is 3.11, taken from &lt;code&gt;requires-python&lt;/code&gt; in &lt;code&gt;pyproject.toml&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Install the project and its dependencies from the repository root:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pip &lt;span class="nb"&gt;install&lt;/span&gt; &lt;span class="nb"&gt;.&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The README notes that &lt;code&gt;requirements.txt&lt;/code&gt; is equivalent to &lt;code&gt;pip install .&lt;/code&gt;, so either path works.&lt;/p&gt;

&lt;p&gt;If you need Amazon Bedrock support, install the optional dependency instead:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pip &lt;span class="nb"&gt;install&lt;/span&gt; &lt;span class="s2"&gt;"tradingagents[bedrock]"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The core install does not include &lt;code&gt;langchain-aws&lt;/code&gt;. That is a common trip-up: if you configure Bedrock and the import fails, you installed the wrong variant.&lt;/p&gt;

&lt;p&gt;After installation, a command-line entry point named &lt;code&gt;tradingagents&lt;/code&gt; is registered via &lt;code&gt;[project.scripts]&lt;/code&gt; in &lt;code&gt;pyproject.toml&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;tradingagents
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;There is also a Docker path. The repository root contains a &lt;code&gt;Dockerfile&lt;/code&gt; and a &lt;code&gt;docker-compose.yml&lt;/code&gt;, and the image entry point is &lt;code&gt;tradingagents&lt;/code&gt;. The translation does not spell out the exact startup command for Docker, and it says as much rather than inventing one.&lt;/p&gt;

&lt;h2&gt;
  
  
  Dependencies and environment
&lt;/h2&gt;

&lt;p&gt;The core dependencies listed in &lt;code&gt;pyproject.toml&lt;/code&gt; include:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;langchain-core&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;langchain-openai&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;langchain-anthropic&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;langchain-google-genai&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;langgraph&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;pandas&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;yfinance&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;typer&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;rich&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Bedrock support is the optional &lt;code&gt;langchain-aws&lt;/code&gt; extra. The Dockerfile is based on &lt;code&gt;python:3.13-slim&lt;/code&gt;, which is Debian-family Linux. The README does not list supported operating systems or hardware requirements, and the translation does not fill those gaps.&lt;/p&gt;

&lt;p&gt;One practical note the translation includes: dependencies come from PyPI, so users in mainland China may need a mirror or a proxy. The project mentions proxy support, but the exact configuration is not documented in the excerpt available.&lt;/p&gt;

&lt;h2&gt;
  
  
  The LLM key problem
&lt;/h2&gt;

&lt;p&gt;The framework is driven by LLMs, so you need API keys for whichever provider you use. The material mentions API-key auto-detection and multiple provider support, along with &lt;code&gt;TRADINGAGENTS_*&lt;/code&gt; environment variables. The specific variable names are not spelled out in the available excerpt.&lt;/p&gt;

&lt;p&gt;This is the most likely place for a first run to fail. Prepare your keys before you run &lt;code&gt;tradingagents&lt;/code&gt;, and expect to consult the full README body and &lt;code&gt;CHANGELOG.md&lt;/code&gt; for the details the quick start does not cover.&lt;/p&gt;

&lt;h2&gt;
  
  
  Reading the release history
&lt;/h2&gt;

&lt;p&gt;The translated README includes the news section, and it is more useful than it looks. Several releases in 2026 changed behavior in ways that affect how you interpret results.&lt;/p&gt;

&lt;p&gt;Version 0.7.1 scores decisions only at the final closing price and settles across long holidays. It also fixed a bug where the model could read files committed after the run date. Version 0.7.0 added the ability to run on your own ChatGPT Plus or Pro plan, changed backtesting to score from the first close after each decision, added a new-version prompt at startup, and began shipping a wheel with each GitHub release.&lt;/p&gt;

&lt;p&gt;Version 0.6.0 saves reports as a single HTML page, allows per-tier provider configuration so managers and analysts can run on different models, settles historical decisions per ticker while analysts work, and reads company news from Yahoo search when the Yahoo news feed is down.&lt;/p&gt;

&lt;p&gt;Earlier releases in September and August 2026 dealt with point-in-time integrity across dated paths, SEC EDGAR fundamentals, backtesting over grids of tickers and dates, portfolio-aware runs, and look-ahead issues in FRED macro data, social sentiment, and decision-log memory.&lt;/p&gt;

&lt;p&gt;If you are evaluating the framework for research, the point-in-time work is the part to read closely. A backtest that can see data published after the analysis date is not a backtest.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where the translation stops
&lt;/h2&gt;

&lt;p&gt;The translated README body is truncated after the "TradingAgents Framework" introduction. The full Installation and CLI sections are not included in the available material. The translation says this directly rather than guessing.&lt;/p&gt;

&lt;p&gt;So the quick-start section gets you to a running command, but the finer configuration steps — CLI flags, provider setup, environment variable names — are not covered. For those, the translation points you to the repository README body and &lt;code&gt;CHANGELOG.md&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;That is the honest state of the documentation. A translation is not a rewrite, and the maintainer did not pretend otherwise.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who this is for
&lt;/h2&gt;

&lt;p&gt;If you read English documentation comfortably, the translation adds little beyond the quick-start section. The original repository is the canonical source, and it will always be more current.&lt;/p&gt;

&lt;p&gt;If you are a Chinese-speaking developer who wants to understand the agent roles, the release history, and the data-integrity decisions without translating in your head, the translation is a reasonable starting point. The quick-start section in particular saves you from reading the whole README just to get the install right.&lt;/p&gt;

&lt;p&gt;The star count belongs to the original project. The translation is new, and its quality will be judged by whether the issues and pull requests it invites actually get addressed.&lt;/p&gt;

&lt;p&gt;Repository: &lt;a href="https://github.com/yangshun2005/TradingAgents-cn" rel="noopener noreferrer"&gt;yangshun2005/TradingAgents-cn&lt;/a&gt;&lt;br&gt;
Original: &lt;a href="https://github.com/TauricResearch/TradingAgents" rel="noopener noreferrer"&gt;TauricResearch/TradingAgents&lt;/a&gt;&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/TradingAgents-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/TradingAgents-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>OpenShell: NVIDIA's Sandboxed Runtime for AI Agents Now Has a Chinese README</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Sun, 25 Oct 2026 10:28:53 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/openshell-nvidias-sandboxed-runtime-for-ai-agents-now-has-a-chinese-readme-5fji</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/openshell-nvidias-sandboxed-runtime-for-ai-agents-now-has-a-chinese-readme-5fji</guid>
      <description>&lt;p&gt;OpenShell's install command is one line, but the README that follows it is not. NVIDIA's project ships a fair amount of documentation: policy semantics, a formal verification step, a gateway/supervisor/sandbox architecture, and a support matrix that rules out a good chunk of machines people will try it on. For a Chinese-speaking developer evaluating whether to spend an afternoon on it, that's a real cost before the first &lt;code&gt;openshell sandbox create&lt;/code&gt; ever runs.&lt;/p&gt;

&lt;p&gt;A translated version of the repository now exists at &lt;a href="https://github.com/yangshun2005/OpenShell-cn" rel="noopener noreferrer"&gt;yangshun2005/OpenShell-cn&lt;/a&gt;. It is a documentation translation, not a fork of the code. The original is &lt;a href="https://github.com/NVIDIA/OpenShell" rel="noopener noreferrer"&gt;NVIDIA/OpenShell&lt;/a&gt;, 19,704 stars, written in Rust, Apache-2.0.&lt;/p&gt;

&lt;p&gt;Below is what the project actually does, what the Chinese version adds, and the parts of the setup that tend to go wrong.&lt;/p&gt;

&lt;h2&gt;
  
  
  What OpenShell is for
&lt;/h2&gt;

&lt;p&gt;The one-line description NVIDIA uses is "the safe, private runtime for autonomous AI agents." The longer version: agents are most useful when they can read files, install packages, call APIs, and use credentials. Those are also the four things you least want an unsupervised process doing on your machine.&lt;/p&gt;

&lt;p&gt;OpenShell's answer is not to remove the capabilities but to declare them. You write a policy describing what each agent may touch, and the runtime enforces it. Two mechanisms do the work:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Kernel-level enforcement.&lt;/strong&gt; Each agent runs in an isolated sandbox. The kernel is instrumented so that every file access, every syscall, and every outbound network connection is checked against policy. Credentials never reach the agent directly — OpenShell injects them into requests headed to approved endpoints only.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Formal verification of policy changes.&lt;/strong&gt; Before a policy change takes effect, OpenShell checks what new access it would grant. If a change would let an agent use a credential against a new host, or call a new API method, it gets flagged and waits for human review.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That second point is the interesting design choice. Most sandboxing tools treat policy as configuration you edit and reload. OpenShell treats a policy diff as something to be analyzed, which is a different threat model — it assumes the person editing the policy might be an agent, or might be acting on an agent's suggestion.&lt;/p&gt;

&lt;h2&gt;
  
  
  Getting it running
&lt;/h2&gt;

&lt;p&gt;The quick start is two commands, and the first one needs a working container or virtualization backend already in place:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-LsSf&lt;/span&gt; https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create &lt;span class="nt"&gt;--name&lt;/span&gt; demo
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The installer sets up both the CLI and a local gateway.&lt;/p&gt;

&lt;h3&gt;
  
  
  Platform requirements
&lt;/h3&gt;

&lt;p&gt;This is where people lose time, so it's worth listing plainly:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;OS:&lt;/strong&gt; Linux, macOS on Apple Silicon, or Windows with WSL 2 (experimental).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Runtime dependency:&lt;/strong&gt; Docker, Podman, or host virtualization — one of the three, already installed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Linux:&lt;/strong&gt; the install script pulls a Debian or RPM package. The script states a minimum glibc of 2.28.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;macOS:&lt;/strong&gt; Apple Silicon only. Installed via a Homebrew formula, which manages the binary layout and the launchd service lifecycle.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Python SDK:&lt;/strong&gt; Python &amp;gt;= 3.11 (per &lt;code&gt;pyproject.toml&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Building from source:&lt;/strong&gt; the workspace declares &lt;code&gt;rust-version = "1.94"&lt;/code&gt; and &lt;code&gt;edition = "2024"&lt;/code&gt; in &lt;code&gt;Cargo.toml&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Windows support being labeled experimental is not boilerplate. If you're on an Intel Mac, you're out — there's no path in the support matrix for you.&lt;/p&gt;

&lt;h2&gt;
  
  
  The default sandbox has no agent in it
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;openshell sandbox create --name demo&lt;/code&gt; gives you a minimal Ubuntu image. No agent is installed. This surprises people who expect the demo to do something agent-like out of the box.&lt;/p&gt;

&lt;p&gt;To run an actual agent, the official docs point at &lt;a href="https://docs.nvidia.com/openshell/latest/about/run-your-first-agent" rel="noopener noreferrer"&gt;Run Your First Agent&lt;/a&gt;, which wires OpenCode to a free OpenRouter model and walks through the approval flow when the agent requests new access. That approval flow is the part worth reading carefully — it's the human-in-the-loop side of the formal verification described above.&lt;/p&gt;

&lt;p&gt;There's also an optional step for coding agents that support skills:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx skills add NVIDIA/OpenShell
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Telemetry is on by default
&lt;/h2&gt;

&lt;p&gt;Worth stating up front rather than burying. OpenShell collects anonymous telemetry. Per the documentation, it's limited to operational categories and counts — no sandbox names, hostnames, file paths, prompts, or credentials.&lt;/p&gt;

&lt;p&gt;To turn it off:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# on the gateway&lt;/span&gt;
&lt;span class="nv"&gt;OPENSHELL_TELEMETRY_ENABLED&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nb"&gt;false&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For Helm installs, set &lt;code&gt;server.telemetryEnabled=false&lt;/code&gt; instead.&lt;/p&gt;

&lt;p&gt;The docs also recommend keeping the SDK and gateway on the same OpenShell version. Version skew between the two is the kind of thing that produces confusing failures rather than clean errors.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the Chinese version actually contains
&lt;/h2&gt;

&lt;p&gt;The repository at &lt;code&gt;yangshun2005/OpenShell-cn&lt;/code&gt; is structured in two layers, and the split matters.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Layer one: a Chinese quick-start guide written for this translation.&lt;/strong&gt; This is explicitly marked as supplementary material, not part of the original README. It covers:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;What the project is and what problem it solves, in a few paragraphs&lt;/li&gt;
&lt;li&gt;The shortest path to a running sandbox&lt;/li&gt;
&lt;li&gt;The full environment requirements list, including the glibc, Rust, and Python version floors&lt;/li&gt;
&lt;li&gt;A "common pitfalls" section&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That pitfalls section is the most useful part, because it collects the failure modes that are scattered across the upstream docs: the empty default sandbox, the Apple Silicon restriction, the mandatory container backend, telemetry defaults, and SDK/gateway version alignment.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Layer two: a translation of the upstream README itself.&lt;/strong&gt; The stated goal is fidelity to the original. The translation date is recorded as 2026-10-25, and the original English README is kept alongside as &lt;code&gt;README_en.md&lt;/code&gt; so you can diff them.&lt;/p&gt;

&lt;p&gt;The repository explicitly invites issues and PRs for inaccurate translations. Given that OpenShell is at 0.1.x with a stated cadence of stable releases, the English docs will move; a translation will always lag somewhat. My sample of one reading suggests the quick-start layer is the more durable part, since it describes requirements and pitfalls rather than API surface.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where the translation helps, concretely
&lt;/h2&gt;

&lt;p&gt;Three places, I think.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Version floors.&lt;/strong&gt; "glibc 2.28", "&lt;code&gt;rust-version = "1.94"&lt;/code&gt;", "Python &amp;gt;= 3.11" — these are easy to skim past in a long English README and expensive to discover after a failed build. Having them collected in one place in your first language reduces the chance you start an install that can't succeed.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The gap between "installed" and "working."&lt;/strong&gt; The upstream quick start is honest that the default sandbox is bare, but that fact sits in a paragraph after the commands. The Chinese guide puts it in the pitfalls list, which is where people look when the demo doesn't behave as expected.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Policy semantics.&lt;/strong&gt; This is the part I'd want translated most carefully, because policy is where the project's whole value proposition lives. Getting the enforcement model wrong — assuming policy is advisory, or that credentials are visible to the agent — leads to a very different mental model of what you've deployed. The translated README covers the enforcement and verification mechanisms directly.&lt;/p&gt;

&lt;h2&gt;
  
  
  What it doesn't do
&lt;/h2&gt;

&lt;p&gt;It doesn't change the software. If you're building against OpenShell, you're building against NVIDIA's code, and the translated repo is a reading aid. Bug reports and feature requests belong upstream.&lt;/p&gt;

&lt;p&gt;It also doesn't solve the network problem. The install script downloads release artifacts from GitHub, and the translation notes that users in mainland China may need a proxy or an accelerated download path. The original documentation doesn't provide a mirror, and neither does the translation — it just flags the issue so you're not debugging a timeout wondering whether the script is broken.&lt;/p&gt;

&lt;h2&gt;
  
  
  Should you read it
&lt;/h2&gt;

&lt;p&gt;If you already read English technical documentation comfortably, the upstream README is fine and always current. The Chinese version earns its place for two groups: developers who'd rather absorb the requirements and pitfalls in Chinese before committing an afternoon, and teams where the person evaluating the runtime isn't the person who'll operate it — handing over a translated quick-start is cheaper than a meeting.&lt;/p&gt;

&lt;p&gt;The project is Apache-2.0, so the licensing question is settled either way. Start with the quick-start layer, then read the translated README for the policy model, then go upstream for anything version-specific.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/OpenShell-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/OpenShell-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
    <item>
      <title>security-audit-skill: a Chinese translation of Cloudflare's coding-agent audit skill</title>
      <dc:creator>sun young</dc:creator>
      <pubDate>Sun, 25 Oct 2026 10:21:45 +0000</pubDate>
      <link>https://dev.to/sun_young_517829fc09d0c05/security-audit-skill-a-chinese-translation-of-cloudflares-coding-agent-audit-skill-3b7g</link>
      <guid>https://dev.to/sun_young_517829fc09d0c05/security-audit-skill-a-chinese-translation-of-cloudflares-coding-agent-audit-skill-3b7g</guid>
      <description>&lt;p&gt;Cloudflare's &lt;code&gt;security-audit-skill&lt;/code&gt; has 45,592 stars on GitHub. The Chinese translation was published today and has zero. That gap is the whole reason the translation exists — not because the original is hard to read for everyone, but because a security workflow is one of the few things where misreading a sentence changes what you actually run.&lt;/p&gt;

&lt;p&gt;The Chinese version lives at &lt;a href="https://github.com/yangshun2005/security-audit-skill-cn" rel="noopener noreferrer"&gt;yangshun2005/security-audit-skill-cn&lt;/a&gt;. It is a translation of &lt;a href="https://github.com/cloudflare/security-audit-skill" rel="noopener noreferrer"&gt;cloudflare/security-audit-skill&lt;/a&gt;, MIT licensed, original language JavaScript, translation dated 2026-10-25. The original README is kept as &lt;code&gt;README_en.md&lt;/code&gt; so you can diff the two.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the skill actually does
&lt;/h2&gt;

&lt;p&gt;It turns a coding agent into a security auditor. Not by prompting "find bugs" harder, but by forcing a six-phase process where different agents do different jobs and the one who finds a candidate is not the one who confirms it.&lt;/p&gt;

&lt;p&gt;The six phases, as listed in the README:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Reconnaissance&lt;/strong&gt; — map architecture, trust boundaries, input surfaces, existing evidence, and deterministic coverage into &lt;code&gt;architecture.md&lt;/code&gt; and &lt;code&gt;coverage-ledger.json&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Coverage-driven hunting&lt;/strong&gt; — assign isolated hunters from ledger units, record what they checked, and use a coverage reviewer to find gaps.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Candidate validation&lt;/strong&gt; — hand each unique candidate to a fresh validator whose job is to falsify it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Structured output&lt;/strong&gt; — write &lt;code&gt;confirmed&lt;/code&gt;, &lt;code&gt;needs_validation&lt;/code&gt;, and &lt;code&gt;rejected&lt;/code&gt; records to &lt;code&gt;findings.json&lt;/code&gt;, validated against &lt;code&gt;report-schema.json&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Independent record verification&lt;/strong&gt; — a fresh agent verifies final source claims. Substantive replacements go through another independent validator.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Target-neutral reporting&lt;/strong&gt; — generate &lt;code&gt;REPORT.md&lt;/code&gt;, &lt;code&gt;FINDINGS-DETAIL.md&lt;/code&gt;, and &lt;code&gt;NEEDS-VALIDATION.md&lt;/code&gt; from verified records and the coverage ledger.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The three verdicts are deliberately distinct. &lt;code&gt;confirmed&lt;/code&gt; means full source tracing plus bounded observation. &lt;code&gt;needs_validation&lt;/code&gt; means there is a specific unresolved fact and no severity assigned. &lt;code&gt;rejected&lt;/code&gt; records a candidate that was disproven. That last one matters — a rejected candidate is data, not noise, because it tells the next run what not to re-hunt.&lt;/p&gt;

&lt;p&gt;Two Node scripts enforce the shape of the output. The parent runs &lt;code&gt;validate-coverage-ledger.cjs&lt;/code&gt; after creating the ledger and after every update to it. &lt;code&gt;validate-findings.cjs&lt;/code&gt; runs in phase 4, and again in phase 5 after each replacement.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why a Chinese version is worth more than the usual translation
&lt;/h2&gt;

&lt;p&gt;Most translated READMEs are a convenience. This one is closer to a prerequisite, for three reasons.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The sandbox requirement is a hard gate, and it's easy to skim past.&lt;/strong&gt; The skill needs an OS-enforced sandbox to run builds, tests, processes, browsers, emulators, fuzzers, and fixtures against the target code. That sandbox must have external network disabled, a sanitized allowlist environment, enforced resource limits, and write access only to designated temp paths. Without those controls, the workflow keeps the relevant leads at &lt;code&gt;needs_validation&lt;/code&gt; instead of executing target code. A reader who half-understands this will run the skill, get a shallow audit, and conclude the tool doesn't work. The Chinese quick-start section states this plainly as a "常见坑" — a common pitfall — before you get to the workflow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The default output path is not obvious.&lt;/strong&gt; In full audit mode, if you don't specify an output directory, results go to &lt;code&gt;~/security-audit-skill/ /run-&lt;/code&gt; (that spacing appears in the source). The workflow only writes inside the target repo when you explicitly pick a directory that version control ignores. If you're auditing a repo you care about, getting this wrong is annoying at best.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;One run does not cover everything.&lt;/strong&gt; The original README states that a single run finds roughly half of the vulnerabilities that repeated runs find in total. Runs are additive. The recommendation is to run the skill multiple times against the same repository. Someone who reads this as "run once, get a report" will under-audit and never know.&lt;/p&gt;

&lt;p&gt;None of these are translation problems in the sense of wrong words. They're the kind of detail that gets lost when you're reading a long English document in a second language and pattern-matching for the install command.&lt;/p&gt;

&lt;h2&gt;
  
  
  Installing
&lt;/h2&gt;

&lt;p&gt;The command is unchanged from the original:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx skills add https://github.com/cloudflare/security-audit-skill &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;--skill&lt;/span&gt; security-audit
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For a user-level install, add &lt;code&gt;--global&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx skills add https://github.com/cloudflare/security-audit-skill &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;--skill&lt;/span&gt; security-audit &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;--global&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Note that this pulls from the upstream repo, not the translation. The Chinese repo is documentation — the skill itself is the same code. &lt;code&gt;npx skills --help&lt;/code&gt; covers agent selection and non-interactive options.&lt;/p&gt;

&lt;p&gt;Then open or point your coding agent at the codebase and ask:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;security audit this codebase
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Or with a target and output location:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;find security vulnerabilities in ./src
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;do a security review, output to ~/audits/my-project
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The skill activates on trigger phrases like "security audit", "find vulnerabilities", and "pen-test the code".&lt;/p&gt;

&lt;p&gt;If you're on a network where GitHub fetches are slow, the Chinese README flags this directly: you may need an npm mirror or a proxy for the &lt;code&gt;npx skills add&lt;/code&gt; step. Small thing, but it's the first thing that fails.&lt;/p&gt;

&lt;h2&gt;
  
  
  Requirements, including the ones the README doesn't answer
&lt;/h2&gt;

&lt;p&gt;Confirmed dependencies:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A coding agent and model that support tool use and parallel sub-agents.&lt;/li&gt;
&lt;li&gt;Node.js, for the zero-dependency findings and coverage-ledger validation scripts.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The parallel sub-agent requirement is structural, not cosmetic. The design depends on isolated agents doing separated work — hunters, a coverage reviewer, fresh validators, an independent record verifier. If your agent or model can't spawn parallel sub-agents, the workflow can't run as designed. The README does not describe a fallback.&lt;/p&gt;

&lt;p&gt;Things the original README does not specify, and the translation honestly leaves as "原文未说明" rather than inventing answers: supported operating systems, hardware requirements, and the specific Node.js version. If you need those, you'll have to determine them yourself. I'd rather see a translation that admits the gap than one that fills it in.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the file layout tells you
&lt;/h2&gt;

&lt;p&gt;The skill is split across files by phase, which is a decent signal of how much process is packed in:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;File&lt;/th&gt;
&lt;th&gt;Purpose&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;SKILL.md&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Setup, core principles, platform terminology, workflow overview, audit anti-patterns&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;RECONNAISSANCE.md&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Phase 1 recon prompts and synthesis instructions&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;HUNTING.md&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Phase 2 orchestration, hunting methods, validation rules&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ATTACK-CLASSES.md&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Attack prompts for core, wildcard, and obvious-issue categories&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;MEMORY-SAFETY-AND-BINARY.md&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Memory safety, binary, and kernel work for native targets&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The existence of &lt;code&gt;MEMORY-SAFETY-AND-BINARY.md&lt;/code&gt; is worth noticing. This is not only a web-app scanner. It has guidance for native targets.&lt;/p&gt;

&lt;h2&gt;
  
  
  Provenance
&lt;/h2&gt;

&lt;p&gt;The skill is the single-repository starting point of Cloudflare's vulnerability discovery framework, described in their post &lt;a href="https://blog.cloudflare.com/build-your-own-vulnerability-harness" rel="noopener noreferrer"&gt;Build your own vulnerability harness&lt;/a&gt;. That framework later grew into a multi-stage, fleet-wide system. What you install here is the origin version, not the fleet version. Worth knowing before you compare it to anything Cloudflare has written about at scale.&lt;/p&gt;

&lt;h2&gt;
  
  
  On the translation itself
&lt;/h2&gt;

&lt;p&gt;The repo is structured so you can check the work. The Chinese page opens with a "中文快速上手" section that is explicitly marked as supplementary guidance, not part of the original document — it covers what the project is, the shortest install path, environment requirements, and the pitfalls above. Below that, the README body is a translation that aims to stay faithful to the original. The English original sits alongside as &lt;code&gt;README_en.md&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;That separation is the right call. A translation that quietly blends a translator's opinions into the source text is worse than no translation, because you can't tell which claims are the project's. Here the boundary is stated on the page.&lt;/p&gt;

&lt;p&gt;The repo also asks for issues and PRs on inaccurate translations, which is the only realistic way this gets better. My sample of one reading is not a review; if you find a phase description that reads wrong against the English, that's a bug worth filing.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who this is for
&lt;/h2&gt;

&lt;p&gt;If you already read English technical documentation comfortably, use the upstream repo — it will always be current, and the translation is dated 2026-10-25, so it will drift. If you or your team would otherwise skim the sandbox and multi-run caveats, the Chinese version is the difference between running this skill correctly and running it once, getting a thin report, and moving on.&lt;/p&gt;

&lt;p&gt;The star count on the translation is zero. That's fine. The thing it translates has 45,592, and the value here is comprehension, not popularity.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Chinese documentation: &lt;a href="https://github.com/yangshun2005/security-audit-skill-cn" rel="noopener noreferrer"&gt;https://github.com/yangshun2005/security-audit-skill-cn&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;I'm an independent enterprise AI delivery consultant — private LLM deployment, RAG, agent workflows, AIOps. If your team is stuck somewhere in that stack, my inbox is open.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
  </channel>
</rss>
