{
  "schemaVersion": "1.0",
  "site": {
    "name": "zephyrrtos.cn",
    "homepage": "https://zephyrrtos.cn/",
    "language": "zh-CN",
    "summary": "围绕 Zephyr RTOS 的中文工作组：国产芯片适配、中文内容建设、本土快速响应与产业赋能。",
    "workingGroup": {
      "name": "zephyrrtos.cn 工作组",
      "founded": "2026-09-11",
      "mission": "倡议并推动独立的 Zephyr RTOS 本土开源组织：把分散的经验沉淀成中文资料，把重复的工作做成开源工具，把踩过的坑变成别人少走的弯路。",
      "positioning": "不是另起炉灶，而是扎根全球开源、服务中国产业。",
      "focus": [
        "硬件适配：批量维护国产 MCU / 开发板 BSP 与适配仓库",
        "内容建设：官方文档中文精译、入门实战教程、案例库",
        "社区运营：中文问答、月度分享、年度开发者沙龙、贡献激励",
        "产业赋能：面向中小企业的技术咨询、方案适配与问题排查",
        "产学研联动：联合高校开设 Zephyr 实训课程"
      ]
    }
  },
  "topics": {
    "membership": {
      "summary": "先免费体验 3 个月，之后可选择开通正式会员（年费 RMB 200），不自动续费。",
      "freeTrial": {
        "durationMonths": 3,
        "price": {
          "amount": 0,
          "currency": "CNY"
        },
        "startsFrom": "回信确认开通之日"
      },
      "full": {
        "price": {
          "amount": 200,
          "currency": "CNY",
          "period": "year"
        },
        "optional": true,
        "autoRenew": false
      },
      "howToApply": {
        "method": "email",
        "email": "hakehuang@gmail.com",
        "subject": "申请 zephyrrtos.cn 会员",
        "provide": [
          "用户名",
          "邮箱"
        ],
        "note": "企业或高校团队可在邮件里说明团队情况与用途"
      },
      "whatYouGet": [
        "自建 Gitea 协作平台：代码托管、Issue / PR（已上线）",
        "工作组工具与插件：如 dsh-ubuntu-sandbox、DSH 标准工具链（已上线）",
        "动态与资料入口、订阅源（已上线）",
        "中文资料与教程、国产芯片适配仓库（建设中，会员优先获取）",
        "月度技术分享、年度开发者沙龙与会员答疑（规划中）"
      ],
      "page": "https://zephyrrtos.cn/join.html"
    },
    "tools": {
      "standard": {
        "name": "DSH",
        "fullName": "DeepSeek Harness",
        "role": "工作组标准工程协作工具",
        "reason": [
          "插件化可扩展",
          "本地优先、可自建可离线",
          "直接操作终端/文件/远端主机",
          "插件与目录源可自行发布"
        ],
        "url": "https://github.com/deepseek-ai/deepseek-harness"
      },
      "published": [
        {
          "name": "dsh-ubuntu-sandbox",
          "version": "0.1.1",
          "summary": "把远程 Ubuntu / Debian 主机当作像本地命令行一样的工作沙盒：默认 tmux 持久会话 + 远程读写",
          "license": "MIT",
          "npm": "https://www.npmjs.com/package/@hakehuang/dsh-ubuntu-sandbox",
          "install": "dsh plugin --profile <profile> add @hakehuang/dsh-ubuntu-sandbox@0.1.1",
          "update": "dsh plugin --profile <profile> add @hakehuang/dsh-ubuntu-sandbox@<version>，然后重启 DSH",
          "installGuide": "https://zephyrrtos.cn/plugin.html",
          "changelog": "https://zephyrrtos.cn:3000/hakehuang/dsh-ubuntu-sandbox/blob/main/CHANGELOG.md",
          "prerequisites": [
            "DSH >= 0.1.2-rc.1（插件清单声明的引擎要求）",
            "远端主机需装 tmux（默认即持久会话模式）：sudo apt-get install -y tmux",
            "目标主机写进 ~/.dsh/dsh-ssh.json（与 @linxin666/dsh-ssh 共用）"
          ],
          "installMethods": [
            "DSH Desktop → Community Market 添加源 https://zephyrrtos.cn/dsh-ubuntu-sandbox/catalog-source.json 后一键安装（目录里 latestVersion 已指向 0.1.1）",
            "命令行：dsh plugin --profile desktop add @hakehuang/dsh-ubuntu-sandbox@0.1.1（注意它只装依赖，需确认 profile 的 dsh.profile.bundles 含包名）",
            "手工 / 离线：在 profile 目录用与现有 node_modules 匹配的 pnpm 执行 pnpm add --save-exact ...，再手工补 dsh.profile.bundles"
          ],
          "tools": [
            "sb_cwd",
            "sb_session",
            "sb_exec",
            "sb_ls",
            "sb_read",
            "sb_write"
          ],
          "verification": [
            "profile 的 node_modules/@hakehuang/dsh-ubuntu-sandbox/package.json 版本号",
            "dsh --profile desktop --dump-config 中出现 id: ubuntu-sandbox",
            "重启后工具列表出现 sb_cwd / sb_session / sb_exec / sb_ls / sb_read / sb_write"
          ],
          "knownIssues": [
            "0.1.0 声明 schemastery ^3.18.2 而公共源仅 3.18.0，安装必然 notarget 失败；已在 0.1.1 修复，0.1.0 于 npm 标记废弃",
            "ERR_PNPM_UNEXPECTED_STORE：profile 的 node_modules 由 pnpm 10 建立（store v10），DSH 强制使用自带 pnpm 11（store v11）；处置为完全退出 DSH 后在 profile 目录运行 DSH 自带 pnpm 执行 install 迁移 store，或改用匹配版本的 pnpm 手工安装",
            "装了但工具不出现：dsh.profile.bundles 缺包名，或未重启 DSH（新 bundle 不热加载）",
            "插件被忽略：包内 cordis.patch.yml 的行名必须等于包名 @hakehuang/dsh-ubuntu-sandbox"
          ],
          "repo": "https://zephyrrtos.cn:3000/hakehuang/dsh-ubuntu-sandbox",
          "catalogSource": "https://zephyrrtos.cn/dsh-ubuntu-sandbox/catalog-source.json"
        },
        {
          "name": "dsh-llm-router",
          "version": "0.1.1",
          "summary": "把 Lead/Worker 模型路由做成 DSH 的一等公民：在 ctx.llm 上注册一条虚拟提供方路由（默认 lead-worker），并提供可观察、可拦截、可替换的 cordis 服务 ctx.llmRouter",
          "license": "MIT",
          "npm": "https://www.npmjs.com/package/@hakehuang/dsh-llm-router",
          "install": "dsh plugin --profile <profile> add @hakehuang/dsh-llm-router@0.1.1",
          "update": "dsh plugin --profile <profile> add @hakehuang/dsh-llm-router@<version>，然后重启 DSH",
          "installGuide": "https://zephyrrtos.cn/llm-router.html",
          "changelog": "https://zephyrrtos.cn:3000/hakehuang/dsh-llm-router/blob/main/CHANGELOG.md",
          "prerequisites": [
            "DSH >= 0.1.2-rc.1",
            "peer 依赖 @deepseek-ai/cordis ^4.0.2 与 @deepseek-ai/dsh-llm ^0.1.2-rc.1（随 DSH 提供）",
            "需要至少配置 lead 或 workers 之一，否则插件按设计休眠（只打一行日志）"
          ],
          "virtualModels": [
            "auto",
            "lead",
            "worker",
            "worker:<id>"
          ],
          "configExample": "config: { provider: lead-worker, lead: { provider: deepseek-official, model: deepseek-v4-pro, reasoningEffort: high }, workers: [{ id: flash, provider: deepseek-official, model: deepseek-v4-flash, reasoningEffort: low }] }",
          "installMethods": [
            "DSH Desktop → Community Market 添加源 https://zephyrrtos.cn/dsh-llm-router/catalog-source.json 后安装条目 Lead/Worker Model Router（目录里 latestVersion 已指向 0.1.1）",
            "命令行：dsh plugin --profile desktop add @hakehuang/dsh-llm-router@0.1.1（注意它只装依赖，需确认 profile 的 dsh.profile.bundles 含包名）",
            "手工：把 bundle 行（id: llm-router，含 config）粘进 profile 的 patch 层后重启"
          ],
          "verification": [
            "模型选择器出现分组 Lead/Worker Router，可选 auto / lead / worker / worker:<id>",
            "dsh --profile desktop --dump-config 中出现 id: llm-router",
            "接 llm-router/decision 监听器或读 ctx.llmRouter.snapshot() 确认命中的 rule"
          ],
          "knownIssues": [
            "0.1.0 与 dsh-ubuntu-sandbox 0.1.0 同源缺陷：schemastery ^3.18.2 在公共源不存在导致 notarget；0.1.1 已修复为 ^3.18.0，并新增 check-installable / verify-installed 发布前校验",
            "无 lead 也无 workers 时插件休眠（不挂载、不报错）；写了一半的路由（有 provider 缺 model）会明确报错",
            "模型选择器里没有该分组：profile 的 dsh.profile.bundles 缺包名，或未重启 DSH",
            "强度相关报错：调用方选的强度不在 acceptReasoningEfforts 里"
          ],
          "honestLimits": [
            "一轮只换一次模型（规划→执行）以保住 prompt cache；stickyTurns: false 用缓存换灵活性",
            "故障转移只在产出任何内容之前生效，绝不拼接答案；失败的 lead 是终点",
            "重试仍归 dsh-llm-retry；路由器只覆盖一次逻辑调用内产出前的失败",
            "路由决策不在持久会话日志里（无法从会话文件重放），但完整存在于 llmRouter.snapshot() 与事件总线中"
          ],
          "repo": "https://zephyrrtos.cn:3000/hakehuang/dsh-llm-router",
          "catalogSource": "https://zephyrrtos.cn/dsh-llm-router/catalog-source.json"
        }
      ]
    },
    "sandbox": {
      "summary": "基于 Radxa ROCK 5B+ 的远端 ARM64 开发沙盒，完全通过 dsh-ubuntu-sandbox 与 DSH 远程开发。",
      "platform": "Radxa ROCK 5B+（Rockchip RK3588，4×A76@2.2/2.4GHz + 4×A55@1.8GHz，NPU 6 TOPS）",
      "measured": {
        "os": "Armbian 24.11.2 bookworm",
        "kernel": "6.1.75-vendor-rk35xx (aarch64)",
        "cpuCores": 8,
        "memory": "15 GiB",
        "storage": "eMMC 116.5GB + 2×119.2GB NVMe 组 RAID1（/mnt/raid1）",
        "toolchain": [
          "tmux",
          "docker",
          "git 2.39",
          "cmake 3.31",
          "ninja 1.11",
          "west 1.4",
          "python3.11"
        ]
      },
      "purchase": {
        "store": "https://shop33733573.taobao.com/category.htm",
        "item": "https://item.taobao.com/item.htm?id=789553440055",
        "manual": "https://zephyrrtos.cn/files/getting-started-ai-code-datacenter.pdf",
        "productBrief": "https://zephyrrtos.cn/files/radxa-rock-5b-plus-product-brief.pdf"
      },
      "page": "https://zephyrrtos.cn/sandbox.html"
    },
    "mirror": {
      "summary": "Zephyr 官方仓库的国内镜像：一条 git 配置即可把 github.com/zephyrproject-rtos 重定向到 zephyrrtos.cn。",
      "command": "git config --global url.\"https://www.zephyrrtos.cn:3000/zephyrrtos_china/\".insteadOf \"https://github.com/zephyrproject-rtos/\"",
      "organization": "zephyrrtos_china",
      "gitea": "https://www.zephyrrtos.cn:3000/zephyrrtos_china",
      "auth": "镜像仓库需账号访问，请在 zephyrrtos.cn 申请账号并配置公钥或访问令牌",
      "workflow": [
        "sudo apt install git cmake ninja-build gperf ccache dfu-util device-tree-compiler wget python3-dev python3-venv python3-tk xz-utils file make gcc gcc-multilib g++-multilib libsdl2-dev libmagic1",
        "python3 -m venv ~/zephyrproject/.venv && source ~/zephyrproject/.venv/bin/activate && pip install west",
        "执行上面的 insteadOf 重定向",
        "west init . && west update",
        "git clone https://www.zephyrrtos.cn:3000/zephyrrtos_china/zephyr_sdk"
      ],
      "scripts": [
        "https://zephyrrtos.cn/files/zephyr_redirect.sh",
        "https://zephyrrtos.cn/files/zephyr_cn_setup.sh"
      ],
      "page": "https://zephyrrtos.cn/import.html"
    },
    "store": {
      "name": "zephyrrtos.cn 官方网店（淘宝）",
      "url": "https://shop33733573.taobao.com/category.htm",
      "sells": [
        "开发沙盒整机（ROCK 5B+ 平台，含定制散热/电源/外壳与双 NVMe RAID1）",
        "配件与扩展",
        "工作组周边"
      ]
    },
    "support": [
      {
        "channel": "智能体（智谱清言）",
        "use": "日常技术答疑：Zephyr 入门、镜像导入、沙盒与工具使用",
        "url": "https://www.chatglm.cn/main/gdetail/69992fe43e659c7211733083"
      },
      {
        "channel": "Gitea Issue",
        "use": "需要留痕与跟进的问题、适配贡献、文档修正",
        "url": "https://zephyrrtos.cn:3000/explore/repos"
      },
      {
        "channel": "邮件",
        "use": "会员开通与续费、采购与预装、企业与高校合作",
        "email": "hakehuang@gmail.com"
      }
    ],
    "gitea": {
      "web": "https://zephyrrtos.cn:3000",
      "orgs": {
        "cloud": "zephyrrtos_china",
        "lan": "zephyr_china"
      },
      "note": "自建 Gitea；公开仓库列表见 /explore/repos"
    }
  },
  "endpoints": {
    "info": "https://zephyrrtos.cn/info.json",
    "newsData": "https://zephyrrtos.cn/news.json",
    "newsPage": "https://zephyrrtos.cn/news.html",
    "pluginInstallGuide": "https://zephyrrtos.cn/plugin.html",
    "llmRouterPage": "https://zephyrrtos.cn/llm-router.html",
    "llmRouterCatalogSource": "https://zephyrrtos.cn/dsh-llm-router/catalog-source.json",
    "rss": "https://zephyrrtos.cn/feed.xml",
    "jsonFeed": "https://zephyrrtos.cn/feed.json",
    "catalogSource": "https://zephyrrtos.cn/dsh-ubuntu-sandbox/catalog-source.json",
    "files": "https://zephyrrtos.cn/files/"
  },
  "faq": [
    {
      "q": "怎么加入 / 怎么用会员资源？",
      "a": "邮件 hakehuang@gmail.com（主题「申请 zephyrrtos.cn 会员」），提供用户名与邮箱，即可开通 3 个月免费会员；3 个月后可选择正式会员（年费 RMB 200）。"
    },
    {
      "q": "dsh-ubuntu-sandbox 插件怎么安装 / 怎么更新？",
      "a": "三种方式：①DSH Desktop → Community Market 添加目录源 https://zephyrrtos.cn/dsh-ubuntu-sandbox/catalog-source.json 后一键安装；②命令行 dsh plugin --profile desktop add @hakehuang/dsh-ubuntu-sandbox@0.1.1；③内网离线在 profile 目录用 pnpm 手工安装。更新就是把版本号换成目标版本再重启 DSH。注意：dsh plugin 只装依赖、不写挂载清单，必须确认 profile 的 dsh.profile.bundles 含包名；前置条件是 DSH ≥0.1.2-rc.1 与远端主机装 tmux。完整步骤与常见报错见 https://zephyrrtos.cn/plugin.html"
    },
    {
      "q": "dsh-llm-router 是什么、怎么装？",
      "a": "它把 Lead/Worker 模型路由做成 DSH 的一等公民：在 ctx.llm 上注册一条虚拟提供方路由（默认 lead-worker，虚拟模型 auto/lead/worker/worker:<id>），并提供可观察、可拦截、可替换的 ctx.llmRouter 服务——一轮里 lead 规划、其余步骤交给 worker。三种安装方式：①Community Market 添加源 https://zephyrrtos.cn/dsh-llm-router/catalog-source.json 后安装 Lead/Worker Model Router；②dsh plugin --profile desktop add @hakehuang/dsh-llm-router@0.1.1；③手工把 bundle 行连同 config 粘进 profile 的 patch 层。注意：无 lead 也无 workers 时插件按设计休眠；完整字段与策略见 https://zephyrrtos.cn/llm-router.html"
    },
    {
      "q": "更新插件时提示 store 版本不一致（ERR_PNPM_UNEXPECTED_STORE）怎么办？",
      "a": "这是 profile 的 node_modules 由 pnpm 10 建立、而 DSH 强制使用自带 pnpm 11 造成的。根治：完全退出 DSH Desktop 后在 profile 目录执行一次 DSH 自带 pnpm 的 install（把树迁到 v11 store）；临时办法：改用与现有 store 匹配的 pnpm 手工安装，再把包名补进 dsh.profile.bundles。详见 https://zephyrrtos.cn/plugin.html"
    },
    {
      "q": "国内怎么拉 Zephyr 代码？",
      "a": "用 insteadOf 把 github.com/zephyrproject-rtos 重定向到 https://www.zephyrrtos.cn:3000/zephyrrtos_china/，然后正常 west init / west update；详见 https://zephyrrtos.cn/import.html"
    },
    {
      "q": "沙盒是什么、怎么用？",
      "a": "一台 ROCK 5B+（RK3588）Armbian 主机，通过 dsh-ubuntu-sandbox 插件远程使用：默认 tmux 持久会话 + 远程读写；见 https://zephyrrtos.cn/sandbox.html"
    },
    {
      "q": "遇到问题去哪里问？",
      "a": "日常答疑问智谱清言上的工作组智能体；需要留痕的提 Gitea Issue；账号/采购/合作发邮件。"
    }
  ],
  "generatedAt": "2026-09-21T14:53:43.367Z",
  "newsCount": 10,
  "news": [
    {
      "id": "2026-09-21-llm-router-0-1-1",
      "date": "2026-09-21",
      "title": "dsh-llm-router 0.1.1 发布：Lead/Worker 模型路由成为一等公民",
      "summary": "dsh-llm-router 0.1.1 已发布（2026-09-20）。它把 Lead/Worker 路由做成 harness 的一等公民：插件在 ctx.llm 上注册一条虚拟提供方路由（默认 lead-worker），并提供 cordis 服务 ctx.llmRouter。模型路由因此不再是躲在外部二进制或旁路代理里的决策——它就是每个模型调用都要经过的同一张注册表里的一条路由：可观察…",
      "url": "https://zephyrrtos.cn/news/2026-09-21-llm-router-0-1-1.html",
      "tags": [
        "插件",
        "DSH",
        "LLM 路由"
      ]
    },
    {
      "id": "2026-09-21-plugin-0-1-1-install-guide",
      "date": "2026-09-21",
      "title": "dsh-ubuntu-sandbox 0.1.1 发布，并上线插件安装与更新教程",
      "summary": "0.1.1 修掉了一个会让插件根本装不上的问题：0.1.0 声明依赖 schemastery ^3.18.2，而公共 npm 源里最新只有 3.18.0，于是 npm/pnpm install 与 DSH 社区市场的安装都会以 notarget 失败——之前只在「把插件目录手工拷进 profile」的场景下被掩盖了。现在依赖范围改为 ^3.18.0，安装恢复正常；0.1.0 已在 npm 上…",
      "url": "https://zephyrrtos.cn/news/2026-09-21-plugin-0-1-1-install-guide.html",
      "tags": [
        "插件",
        "DSH",
        "安装教程"
      ]
    },
    {
      "id": "2026-09-12-agent-support",
      "date": "2026-09-12",
      "title": "新增智能体入口：在智谱清言上直接向工作组提问",
      "summary": "除了邮件与 Gitea，我们把智能体支持接进了站点的几个入口：在智谱清言上的工作组智能体，可以直接问 Zephyr 入门、镜像导入（west / insteadOf 重定向）、远端沙盒接入与工具使用的日常问题。",
      "url": "https://zephyrrtos.cn/news/2026-09-12-agent-support.html",
      "tags": [
        "智能体",
        "支持渠道",
        "智谱清言",
        "答疑"
      ]
    },
    {
      "id": "2026-09-12-zephyr-project-import",
      "date": "2026-09-12",
      "title": "新页面：zephyrrtos.cn 项目导入 —— 把 Zephyr 官方仓库重定向到国内镜像",
      "summary": "国内直连 github.com/zephyrproject-rtos/* 经常慢到 west update 跑不完。我们把这条路径固化成一份可直接照做的说明：zephyrrtos.cn 项目导入。",
      "url": "https://zephyrrtos.cn/news/2026-09-12-zephyr-project-import.html",
      "tags": [
        "项目导入",
        "镜像",
        "west",
        "文档发布"
      ]
    },
    {
      "id": "2026-09-12-official-store",
      "date": "2026-09-12",
      "title": "官方网店上线：沙盒整机与配件可以直接买到了",
      "summary": "zephyrrtos.cn 官方网店现已开通。我们把这个远端开发沙盒的整机与配件放上了货架——需要一台能远程开发的 ARM64 机器，可以直接下单，不用自己攒。",
      "url": "https://zephyrrtos.cn/news/2026-09-12-official-store.html",
      "tags": [
        "网店",
        "硬件",
        "沙盒整机",
        "淘宝"
      ]
    }
  ]
}