Commit Graph

2259 Commits

Author SHA1 Message Date
Guoguo
bffc37fd44 fix(docs): repair page links to moved or renamed pages
These pages were moved or renamed but the links were not updated; they
only work today because the old HTML is still in the COS bucket.

- tang (en): common-doc/install-the-ide.md moved to get_started/,
  common/ was renamed to common-doc/.
- ai/deploy/ax-pi: sdk.html was renamed to sdk_usage.html; there is no
  English Maix-III index, link the English AXera-Pi page instead.
- faq: Tang-Nano-Doc/questions moved to common-doc/questions.
2026-10-13 16:18:34 +08:00
Guoguo
2a5cc9df29 fix(docs): repair media references hidden by stale COS copies
- maixpy3 notebooks: point 15 GIF references to the WebP files they were
  converted to, and M2Dock_pin.jpg to its deduplicated copy under
  hardware/zh/maixII/M2/asserts/.
- NanoKVM Pro (en) extended: the demo videos live under pro/lcd/.
- M4 Chat (en) quick start: video filename typo (m4chat -> m4nhat); this
  one returned 404 on the live site.
2026-10-13 16:18:34 +08:00
Guoguo
1e109fdc1b ci(links): check notebook markdown cells and video/audio sources
The image link check only looked at markdown and <img> tags, so two kinds
of references were never verified:

- MaixPy3 docs are Jupyter notebooks (.ipynb). The GIF->WebP conversion
  updated the markdown pages but not the notebooks, and the check did not
  notice.
- <video>/<source>/<audio> src and poster attributes.

Both kinds of breakage stay invisible on the live site because the COS
bucket still serves files that were removed from the repo.

Notebooks that are not valid JSON are reported on stderr instead of being
skipped silently. Also drop the two baseline entries fixed by #1048.
2026-10-13 16:18:34 +08:00
Guoguo
e02273aa81 chore(slogic32u3): update Kickstarter campaign links (#1054) 2026-10-13 11:21:52 +08:00
Guoguo
6049327cdc chore(ad): switch top hint to SLogic32U3 Kickstarter campaign (#1053) 2026-10-13 10:09:53 +08:00
taorye
38052e0101 docs(slogic32u3): repair broken cross-page links and anchors
Two separate causes made the cross-references unreachable:

- teedoc rewrites "./Page.md" to "./Page.html" only when the link carries no
  fragment, so every "Page.md#section" link stayed a .md URL and 404ed on the
  built site (15 links)
- a browser matches a fragment literally against the id attribute, while teedoc
  percent-encodes special ASCII characters, so anchors written in lowercase
  ("#act-indicator") or with a raw ASCII colon ("#Linux:-udev-rules") never
  resolved in any browser (7 anchors)

- point the ".md#section" links at .html
- match the generated id case in the in-page anchors (#ACT-Indicator,
  #MODE-Button, #Drivers-and-Permissions and the zh equivalents)
- give the two linked English headings a readable {#id}, as already done for
  the NanoKVM_Go EDID heading, because teedoc writes their ":" as %3A
- include the pending English accessories link fix from the working tree

Verified on a clean full build: no broken relative reference among the 128 in
the 10 built pages, and all 26 anchor links load and match a heading in
Chromium.
2026-10-12 17:47:20 +08:00
taorye
79461d7fd6 docs(FAQ): update links in FAQ for Hardware and Software guides to use .html extension 2026-10-12 17:36:00 +08:00
kingo0807
040ebbf32c docs(nanokvm): repair broken ATX diagram and LED strip demo media (#1048) 2026-10-12 16:23:46 +08:00
taorye
7059aedbac docs(slogic32u3): update link format for SLogicWeb in Quick Start guide 2026-10-12 16:19:04 +08:00
taorye
d89dbe6361 docs(slogic_agent): align the en page with the thin sigrok-cli forwarder
Mirror the zh update: Appendix A now describes the wrapper as a pure
cross-platform forwarder and lists capabilities as native sigrok-cli operations
discovered via --help/-L/--show, with the SLogic driver accuracy notes
(logic_channels before samplerate, voltage_threshold low-high pair, trigger
letters). Drop the removed subcommand/flag references (--time-ms, filename-only
--output, run --), the auto-1000ms default, and the dead decoder-show literals.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-09 18:58:47 +08:00
taorye
e480e3363d docs(slogic_agent): align with the thin sigrok-cli forwarder
The sigrok-cli-slogic-plugin wrapper is now a pure cross-platform forwarder, so
Appendix A no longer describes scan/show/capture/decode subcommands or wrapper
flags (--time-ms, filename-only --output, run --). Document the capabilities as
native sigrok-cli operations forwarded through the wrapper, discovered from the
binary via --help/-L/--show, with the SLogic driver's accuracy notes
(logic_channels before samplerate, voltage_threshold as a low-high pair, trigger
letters). Fix stale behavior (auto-1000ms default, --output restriction) and
replace the removed decoder-show subcommand references.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-09 18:55:16 +08:00
taorye
5b02b5ea09 docs(slogic32u3): firmware released, link the download directory
SLogic32U3 firmware is now published; point the Firmware Update section to
https://dl.sipeed.com/shareURL/SLogic/SLogic32U3/4_Firmware (future updates too).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 18:52:36 +08:00
taorye
7802cdc71b docs(slogic32u3): mark as crowdfunding, not coming soon
- ngscopeclient support table: SLogic32U3 '即将推出' -> '正在众筹'
- Introduction: add a crowdfunding callout with the Kickstarter link (zh+en)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 18:49:46 +08:00
taorye
09ca752e5d docs(ngscopeclient): refresh with new recordings; merge first-run and connect
- Merge Getting Started + Connecting into one section with per-OS connect
  demo videos (Windows, Linux)
- Replace outdated bridge/add-SLogic/waveform images with trimmed screen
  recordings: usage (channel mode + digital waveforms), software trigger,
  analog mode; add a Filter Graph still
- Update download asset names to the SLogic release naming convention
- Remove 11 stale screenshots (old two-binary bridge flow)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 18:37:21 +08:00
taorye
6664ead2f6 docs(slogic32u3): add SLogicView screenshots and screen recordings
- SLogicView section uses trimmed screen-recording demos: main window,
  Configure panel (channel count / sample rate), sample depth, threshold,
  channel order, waveform browsing, cursors, and live PWM decode
- Replace the PulseView placeholder images; keep the two decoder reference
  figures and the SLogicWeb UI shot
- Fix waveform navigation shortcuts (drag=pan; wheel or -/+ zoom;
  Shift/Alt+wheel horizontal; Ctrl+wheel vertical); cursors via the toolbar

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 17:13:06 +08:00
taorye
4a11ccb96d docs(ngscopeclient): update connection to SLogic:slogic:null driver
- Add Instrument now uses Driver=SLogic, Transport=slogic, Path=null
  (replaces the old sigrok / twinlan / localhost:10101)
- Flag the connection screenshots as outdated with a TODO to re-capture
  with the new parameters (same add-SLogic-*.png filenames)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 12:01:05 +08:00
taorye
47074eeda7 docs(slogic16u3): correct SLogic32U3 size to 59x51x13 in en comparison table
The en table still had the old 50x50x10mm placeholder; align it with the
authoritative 59x51x13mm used in every slogic32u3 spec page and the zh table.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 11:51:57 +08:00
taorye
eb0e981c78 docs(slogic32u3): align Software guide & FAQ wording and fixed-channel groups
- Same install-action wording fix in the Software guide download table
- SLogicWeb: 'the only truly install-free' -> 'download-free, install-free'
- Clarify fixed channel groups and no custom channels in the sample-rate
  section and FAQ; note channel reorder/recolor is display-only

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 11:48:29 +08:00
taorye
07a5f6bd0e docs(slogic32u3): fix Quick_Start wording, drop manual heading numbers, repair anchors
- Windows action 'run the installer' -> 'run directly'; macOS -> 'open the
  dmg to run directly, or drag into Applications'
- Drop manual 'N.' numbers from Quick_Start headings (site auto-numbers)
- Clarify reduced-channel capture uses fixed groups (D0-D3/D0-D7/D0-D15);
  custom channel combinations are unsupported
- Repair the #connect-the-device anchor in Hardware_Specification (zh+en)
  and slogic_agent (zh) after the renumber

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 11:48:18 +08:00
zepan
f2d7087c21 fix(i18n): use the correct AliExpress links for 9 products
同事提供了正确的速卖通链接,替换掉 babel fuzzy 自动乱配的那批
(原先多个不同淘宝 ID 被配到同一个速卖通地址,明显是错配,
当时保留 fuzzy 让它回退到淘宝链接,没有发布出去)。

  SLogic16U3 / MaixCAM2 / MaixCAM / Maix-IV
  NanoKVM PCIe / Pro / USB
  Tang Mega Console / Tang Nano 4K

9 条全部填入并清除 fuzzy 标记,构建后英文首页确认已跳速卖通。

仍跳淘宝的 3 个产品(T256s、Maix-I K210、Maix-III AXeraPi)本就
没有速卖通译文,不在这次的错配范围内,待有链接再补。
2026-10-08 00:20:20 +08:00
zepan
1bfda69409 chore: add .gitattributes to pin line-ending behaviour
本仓库历史上 CRLF 与 LF 混用。用 text=auto 让 git 识别文本文件但
不主动改写已有文件的行尾——全局强制转换会把几万行无关内容塞进
diff,git blame 从此失效。

同时把图片/视频等明确标记为 binary,避免被当作文本做行尾转换
或在 diff 里展开。

批量脚本编辑文档时仍需用 newline='' 保留原始行尾,见 AGENTS.md
「批量处理素材时的纪律」。
2026-10-07 21:43:49 +08:00
zepan
79f839bbf0 docs(AGENTS): codify asset size limits and batch-editing discipline
把这轮媒体治理沉淀成规范,核心是一张体积上限表:

  静态图 300KB/500KB  ·  SVG 500KB/1MB
  3 秒内动图 WebP 500KB/1MB(严禁 GIF,超 5 秒别用 WebP)
  5 秒以上动图 MP4 1MB/2MB,等效 1080p 1Mbps(录屏类 0.5Mbps)
  画质对比样片放宽到 4MB;再大的传 B 站/YouTube 内嵌,不进仓库

新增三节:
- MP4 按「等效 1080p 码率」衡量而不是只看文件大小。实测一个 2.2MB
  的小动图折合 1080p 高达 39.6Mbps,按 1Mbps 重编后 57KB;反过来
  7.7MB 的长录屏折合才 1098k,压它只会糊。先看帧率再调码率,
  120fps 降 30fps 直接省 3/4。
- 不要重复存放同一张图:没有中英差异的只放中文目录一份。清理历史
  重复要同时满足「文件名相同」和「不含同族两个型号」,后者防止把
  lpi3a/lpi4a 这类独立产品线绑在一起。
- 批量处理素材的纪律:基线对比、以构建产物为准、保留 CRLF 行尾、
  替换带定界符、通用文件名不自动匹配、删引用要删整个标记。

自检清单与坑速查表同步更新。
2026-10-07 21:37:48 +08:00
zepan
0724332cf8 chore(assets): deduplicate same-product images across doc trees
同一产品的素材散在多个文档树里各存一份(hardware/assets、
hardware/{zh,en}/<产品>、soft/<产品> 等),260 组、399 个副本,49MB。

判别「同产品」用两个条件,缺一不可:
  1. 文件名完全相同 —— 文件名不同说明是两个产品碰巧用了同一张图
     (cleam.png 与 clean_core_board.png),不是刻意复制
  2. 路径里不含同一产品族的两个不同型号

第 2 条拦下了 100 组:lpi3a/lpi4a、lpi3h/lpi4a、tang-nano/-1k/-4k、
tang-primer-20k/25k、tang-mega-138k/60k、spmod_eink/spmod_rfid。
这些合并会制造耦合——更新一个产品的图会让另一个产品的文档悄悄跟着变。

规范副本优先级:hardware/assets 共享区 > zh > 路径较短者。
引用改写基于解析后的目标文件,128 个 md 共 381 处,增删一一对应。

验证:断链 5 -> 5(新增 0),构建通过,抽查页面图片全部可取到。
2026-10-07 21:32:47 +08:00
zepan
3cb995f851 chore(assets): deduplicate zh/en mirrored images
早期文档的素材基本是中英共用一套,却在 docs/.../zh/ 和 docs/.../en/
各存了一份完全相同的文件。251 组镜像副本,白占 39.5MB。

只处理「路径仅差语言段」的镜像组:保留 zh 作为规范副本,删除 en 副本,
把 en 页面的引用改向 zh(32U3 已经是这个约定)。引用改写基于解析后的
目标文件而非字符串匹配,共 39 个页面 214 处;文件读写保留原始行尾。

跨产品的重复没有动——tang-primer-20k 与 25k、lc3a 与 lc4a 虽然碰巧
共用同一张图,但文件名本就不同,合并会制造耦合:以后更新一个产品的
图会让另一个产品的文档悄悄跟着变。为省空间绑定两条独立产品线不划算。

验证:断链 5 -> 5(新增 0),构建通过,抽查英文页图片全部可取到。
2026-10-07 21:27:07 +08:00
zepan
b127ebeb82 fix(docs): apply human decisions on the remaining broken image links
人工逐条确认后处置 39 项:

- delete 33 处:素材在整个仓库都不存在(从未提交或连同目录被删),
  删掉整个图片标记而非只删路径,markdown ![]() 与 <img src> 两种
  写法都处理;表格内只清空单元格、保留表格结构;删后遗留的空
  <center class=half></center> 等空壳标记一并清理
- use 1 处:uboot_conf_9.gif -> uboot_conf_9.jpg(扩展名写错)
- todo 4 处:保留引用等工程师补图,见下
- skip 1 处:pages/index/zh/threshold.html 的 demo_color.jpg

读写文件保留原始行尾——这批文件多为 CRLF,用默认模式会把整个文件
转成 LF,改动量会从 42 行虚增到 1200 多行。

待补素材(3 张,补进来后基线可再缩减):
  docs/hardware/assets/NanoKVM/guide/atx_2024.png
  docs/hardware/assets/NanoKVM/pro/ledstrip/ledstrip_show.png
  docs/hardware/en/logic_analyzer/slogic16u3/assets/Screenshots/SLogic_Connect_1.png

断链 39 -> 5。
2026-10-07 21:24:11 +08:00
zepan
5ad7a1a59e fix(docs): resolve cross-tree and case-only ambiguities; ignore commented-out refs
- Lichee-RV 文档在 docs/soft/Lichee/zh/,素材却在 docs/hardware/zh/lichee/
  assets/RV/,中英各存一份。按页面语言消歧(两份 md5 相同),2 处
- BiT.png / Bit.png 仅大小写不同、内容相同,取与引用大小写一致的那份。
  注意它写在 <img src> 里而非 markdown ![](),替换要覆盖两种写法
- 检查器补剥离 HTML 注释:被 <!-- --> 包住的引用根本不渲染,
  算断链是误报(sipeed_longan_logo.jpg 即此例)

断链 50 -> 39。剩下 37 处是文件在整个仓库都不存在,自动规则已无能为力。
2026-10-07 21:14:31 +08:00
zepan
14df4354c3 fix(docs): repair misspelled image filenames
目录没问题,是文件名本身拼错了:

  enviroument.png -> environment.png   (作者把自己文章名都拼错了)
  succeed_login.png -> susseed_login.png (这次反过来,是文件名拼错,
                                          引用是对的)

判定:引用指向的目录必须存在,在该目录内按编辑距离找同扩展名的近似
文件名,且最优解必须严格优于次优解。

护栏:纯数字或短于 4 字符的文件名不参与近似匹配——实测有一例
1.jpg 被匹配到 WE1.jpg,编辑距离在短名上毫无区分力。

断链 52 -> 50。
2026-10-07 21:09:50 +08:00
zepan
8a1ee30543 fix(docs): repair references to renamed asset directories
又一类笔误:中间某一级目录被改过名,引用没跟着改。

  Tang-Nano-1K/Nano_1K_examples/ -> Tang-Nano-1K/examples/
  maixpy assets/dk_board/        -> assets/hardware/
  Tang Nano-4K/                  -> assets/Nano-4K/

这类前两条规则都够不着:按文件名匹配是多候选(同名图在别的产品
目录下也有),按整段尾路径匹配又因为中间那级对不上而失败。

改用「锚定最长存在前缀 + 匹配最深后缀」:先从左往右找仍然存在的
最长目录前缀作为锚点,再在锚点下按尽可能深的路径后缀唯一匹配。
8 处全部零歧义。断链 60 -> 52。
2026-10-07 21:08:00 +08:00
zepan
b668c2c952 fix(docs): repair wrong '../' depth in image references
spmod 等页面把 ../assets/... 写成了 ../../assets/...,多了一级。

判定方式不是靠文件名撞运气,而是整段尾路径精确匹配:沿页面的各级
父目录向上找,看哪一级拼上 assets/spmod/spmod_bt/back.jpg 这样的
完整尾路径能命中。命中多处时取最近的祖先——依据是同目录下能正常
显示的页面(spmod_ethernet/fpc/weather)用的就是 ../assets/...。

13 组多处命中里 11 组是逐字节相同的副本,取哪个都一样;另 2 组是
同一张图的不同分辨率,按同目录惯例取 en/maix 下的高清原图。

断链 76 -> 60。
2026-10-07 21:02:49 +08:00
zepan
47089a4329 fix(docs): repair 42 more broken image paths by unique-name matching
接着上一轮,按「候选在仓库中唯一」继续批量修复素材搬家遗留的断链:

- 页面自身目录内的子目录名写错 12 处
  assets/lc3a -> assets, assets/images -> assets/image,
  assets/lbook -> assets/lbook4a, 以及文件名大小写笔误
- maixface 24 处:文档在 docs/hardware/maixface/{zh,en}/,素材却留在
  docs/hardware/zh/maixface/assets/(目录层级顺序相反),位移规则统一
- 其余跨目录唯一匹配 6 处

护栏:纯数字或过短的文件名(11.png 这类)即使全仓库唯一也不自动匹配,
因为很可能只是撞车——实测确有一例指向了毫不相关的文档。

断链 118 -> 76,基线同步更新;新引入 0 处(构建产物复核过)。
2026-10-07 20:54:20 +08:00
zepan
66300f5dd7 fix(tools): resolve site-absolute image paths the way teedoc does
构建产物核验发现检查器有 3 个误报,成因是绝对路径解析不全:

- /news/... 由 blog 插件发布,site_config 的 route 里没有登记
- 不匹配任何路由的绝对路径,teedoc 是按「该文档所属路由的根」解析,
  而不是站点根。例如 /assets/x.jpg 出现在 docs/soft/maixpy/en/ 的
  页面里,实际指向 docs/soft/maixpy/assets/x.jpg

补上这两条回退后,断链 121 -> 118,基线同步更新。
拿构建产物复核:118 项里 112 项在生成的网站里确实取不到。
2026-10-07 20:41:00 +08:00
zepan
8baa566a07 chore(assets): compress the last oversized bitmaps to under 300KB
10 张超 500KB 的静态位图按 300KB 目标压缩,文件名不变:
  长边逐档下调 + 质量逐档下调,直到达标
  JPEG 走质量阶梯 85->65;PNG 保持扩展名,走调色板量化 256->128

6.72MB -> 2.78MB。至此仓库内已无超过 500KB 的静态位图。

SVG 暂不处理:大的几个都是历史遗留图,且其中最大的一张
(Tang_nano_4K_0813.svg) 69% 是内嵌 base64 位图,svgo 优化不到,
整体收益有限。
2026-10-07 20:35:31 +08:00
zepan
9f2da4cd6c docs(AGENTS): add image and animation compression guidelines
把这轮媒体治理实测出来的规律写进编写规范,避免后来人重犯:

- 压缩标准补上理由:git 永久保存每个历史版本,一张没压的大图
  即使以后删掉,仍让此后每个完整 clone 的人多下载一次
- 静态图按「照片 vs 合成图形」二分,两类处理方向完全相反
- 动图不要直接提交 GIF;有损 WebP 对文字是灾难(实测 +93%)
- 缩放必须用最近邻而非 lanczos(同尺寸差 3.5 倍),并给出
  2/3(录屏)与 512(实拍)两个尺度
- 长录播转 MP4 的取舍,以及 muted/playsinline 不能省
2026-10-07 20:19:05 +08:00
zepan
e137cf58a5 chore(assets): convert remaining GIFs to WebP and re-encode bloated MP4s
动图 52 个按内容分流重编(51.2MB -> 27.4MB):
  录屏/合成图形 -> WebP 无损(有损 DCT 会把文字编得又大又糊,
                实测同一文件无损 -58%、有损 q45 反而 +93%)
  实物影像     -> WebP 有损 q35
  需要缩放的用最近邻而非 lanczos:插值做抗锯齿会让同一字形在不同
  位置变成不同像素图案,LZ77 的重复匹配全部失效(同尺寸差 3.5 倍)

MP4 9 个按等效 1080p 码率重编(21.7MB -> 7.9MB):
  M2A-1 折合 1080p 高达 39.6Mbps(338x450 用了近 3Mbps),-98%
  其余按等效 1080p 1Mbps;combo8 的 156 秒录屏按等效 500k,-62%
  传感器对比、微光星空、已极省的 120fps 录屏保持原样

媒体总量 572MB -> 534MB。断链检查 0 新增。
2026-10-07 20:18:51 +08:00
zepan
2821a421bc ci: check that referenced images exist; document shallow clone
断链图片一直在悄悄累积(本次清理前有 230 处),而且线上看不出来:
teedoc-upload 只上传不删除对象存储里已移除的文件,旧副本把断链盖住了,
所以页面看起来正常。CI 里也从来没有任何链接检查。

- tools/check_image_links.py:只认 markdown ![]() 与 <img src>,
  先剥离代码块以免把 `convert in.jpg out.jpg` 这类示例当成引用,
  并按 site_config 的 route 解析站点绝对路径。
- tools/known_broken_images.txt:当前仍存在的 121 处已知断链基线。
  CI 对不在基线中的断链报错,基线只许减不许增。
- .github/workflows/check_links.yml:push 与 PR 均运行。
- README:建议 --depth=1 浅克隆并解释原因——文档站的历史里保留了
  每张图的所有旧版本(约 1GB),而贡献者只需要当前版本。
2026-10-07 01:01:33 +08:00
zepan
73defb366b fix(docs): update image references and repair broken paths
两部分改动:

1. 跟随上一个提交的格式变更,改写引用(PNG→JPG、GIF→WebP),
   共 408 处。注意站点绝对路径(/hardware/zh/...)需按 site_config
   的 route 映射解析,不能当成仓库相对路径。

2. 修复 108 处本来就断掉的图片引用——文件还在仓库里,但素材目录
   搬家/改名后引用没跟着改。只在候选唯一且与页面处于同一产品线时
   自动改写;多候选的 75 处与文件确实缺失的 83 处保留,记入
   tools/known_broken_images.txt 待人工处理。

以 HEAD 为基线用同一检查器核对:断链 230 → 121,新引入 0 处。
2026-10-07 01:01:21 +08:00
zepan
8ad1862fdf chore(assets): compress oversized images and convert GIFs to WebP
全仓库媒体资源体积治理。4332 张图中有 440 张超过 500KB、合计 512MB,
基本都是未经处理的原图/原始截图,量级错了一两档。

- 366 张超 500KB 的图按类型分流处理:
    照片     → 限宽 1920px、JPEG q85、去元数据
    截图/线稿 → 保持 PNG,调色板量化(文字保持锐利)
    透明 PNG → 合成白底后转 JPEG
  369MB → 57MB
- 106 个动画 GIF 转为动画 WebP,116MB → 40MB
  (31 个转换后反而变大的保留 GIF 原样)
- 删除 slogic32u3 下 6 个无任何页面引用的孤儿文件

相机样片(传感器对比、微光夜视)未做有损处理,画质本身即内容。
MP4 共 21 个仅 34MB 且已是合理码率的 H.264,未改动。
2026-10-07 01:01:10 +08:00
zepan
16f14cfc10 feat(home): refresh product carousel and SLogic series cards
- 轮播更新为按发布时间倒序的 8 款新品,中英各一套海报
  (NanoKVM Go / SLogic32U3 / T256s / MaixCAM2 / SLogic16U3 /
   NanoKVM Pro / Maix-IV / NanoCluster),旧配置注释保留
- SLogic 系列卡片按发布时间排序 (Combo8 / 16U3 / 32U3),
  换用白底正式素材、统一比例,视觉体量匹配产品定位
- 修复 babel fuzzy 导致英文页漏中文:硬件文档、16U3/32U3 卡片描述
  三条译文正确但被标 fuzzy,compile 时跳过。清除标记后生效。
  淘宝购买链接的 9 条 fuzzy 译文为误配(内容实为其它产品的速卖通
  链接),保留 fuzzy 以回退,待补正确链接后再清。
2026-10-07 00:21:15 +08:00
zepan
135482bbc5 docs(ngscopeclient,slogic16u3): align with single-binary flow and 32U3 specs
- ngscopeclient 中英页统一为单可执行文件流程,清理过时的 bridge 说明
- slogic16u3 对比表补上 SLogic32U3 尺寸 59x51x13mm
2026-10-07 00:21:04 +08:00
zepan
46bf14df51 docs(slogic_agent): rewrite around end-to-end AI circuit analysis
从「语音转按键」改写为端到端 AI 电路分析:观察-假设-验证闭环流程图,
两条接入路径(sigrok-cli Plugin / ALL LOGIC MCP),底层细节下沉为附录 A-D。

- 新增两个案例:TPM SPI 协议逆向(入门)、GBA 卡带 32 通道总线分析(旗舰)
- GBA 案例目标为实时还原游戏画面与关键变量监控
- 配图中英双版(gba-setup / gba-channel-map / tpm-spi-setup / wiring-essentials)
- 移除故事悬赏章节
2026-10-07 00:21:04 +08:00
zepan
dfc8c47db8 docs(slogic32u3): restructure into 5 pages following slogic16u3
Intro/QS/UG 重组为 Introduction / Quick_Start / Hardware_Specification /
Software_User_Guide / FAQ,中英同名以便 teedoc 翻译索引匹配。

- 快速上手独立成页,每步给可验证结果
- 规格校正:2 Gbit DDR3、数字信号带宽 350MHz、800MB/s(6.4Gbps)、
  59x51x13mm、探头线 15cm 同轴 + 特氟龙杜邦、ADC 模拟带宽 10MHz
- Mini-HDMI 引脚表(奇数脚 GND / 偶数脚信号)、通道颜色表加色块
- 上位机统一主推 SLogicView,移除 PulseView 描述;LogicWeb 改名 SLogicWeb
- 补 AFE 警告、10Gbps 口提示、配件与 ADC 模组说明
- 删除 15MB 工程样机带水印照片,换用正式素材
- 侧边栏中英更新;短链目标跟随改名修正
2026-10-07 00:20:53 +08:00
zepan
b1c057acce docs: add AGENTS.md wiki authoring guide
给后续 AI / 自动化协作者的编写规范:仓库结构、构建与双语机制、
产品文档 5 页模板、图片与叙事规范、首页 layout 与 babel 陷阱、
提交前自检清单与坑速查表。CLAUDE.md 指向它。
2026-10-07 00:20:41 +08:00
taorye
e3c83e533c docs(ngscopeclient): align en page to single-binary; clean stale bridge caption
- Rewrite en ngscopeclient page to match the single-binary zh version
- Remove the leftover 'bridge terminal log' caption wording on both languages

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:30:33 +08:00
taorye
ae2f81050a docs(slogic32u3): add English docs (Intro/QS/UG/FAQ) mirroring zh
- Translate the full zh set to English; expand en sidebar to the full set
- Shared hero image referenced from the zh assets dir
- Cross-file/in-page anchors use English heading slugs

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:30:23 +08:00
taorye
c55c5de2d0 docs(slogic32u3): unify on Intro naming
- Delete orphaned zh Introduction.md placeholder (zh sidebar uses Intro.md)
- Rename en Introduction.md -> Intro.md and update en sidebar
- Aligns the #1045 placeholders to the Intro/QS/UG/FAQ convention

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:07:05 +08:00
taorye
9ca16a3733 docs(slogic32u3): drop scaffolding notes and manual heading numbers
- Remove leftover '复用 16U3' migration annotations (keep the content)
- Drop manual heading numbers (wiki auto-numbers headings)
- Confirm PulseView native Windows has no software rate cap (machine-bound)
- Merge a duplicate VCC safety bullet

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:02:28 +08:00
taorye
6e4af1c152 docs(slogic32u3): fill P0 hardware specs from probe schematic and confirmations
- Mini-HDMI (HDMI Type-C 1.4): 8ch/coax per connector, GND/VCC(+5V)/CK
  shared across the 4 groups; CK = 100MHz LVCMOS33 fixed clock output
- Digital input impedance 100k, power 5V@65mA, min pulse ~0.71ns (1 interval)
- ADC module: 4ch/8-bit/100MSa/s/20MHz BW/+-15V safe (correct earlier values)
- LED semantics match 16U3; pre-trigger supported; MODE = hidden pinhole
  (SIM pin) toggling APP/DFU; firmware via slogic16u3-tools
- Pricing left to crowdfunding page (retail not open); formalize wording
- Upgrade release-photo placeholders to highlighted [!NOTE] callouts

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:02:28 +08:00
taorye
693d34b91c feat(home): add SLogic32U3 to homepage series and short link
- Add SLogic32U3 card, reorder cards newest-first (32U3 -> 16U3 -> Combo8)
- Add /slogic32u3 short link (language-detect redirect to Intro)
- Add homepage card image (downscaled product photo)
- Extract new i18n strings; add en translations for card brief and 众筹

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:02:28 +08:00
taorye
737f587e2c docs(ngscopeclient): drop legacy sigrok-bridge/CLI flow, single-binary download-and-run
- Remove two-binary architecture, sigrok-bridge launch, TCP ports, twinlan,
  --adc-mode CLI, RUST_LOG and bridge-only FAQ entries
- Single binary, download-and-run on Windows/Linux/macOS (was macOS 'coming soon')
- Downloads via GitHub Release with dl.sipeed backup mirror
- Keep all image assets and UI operation text; scope udev ID_MM_DEVICE_IGNORE
  to the 359f rule; fix a stale in-page anchor

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:00:23 +08:00
taorye
7b815590d9 docs(slogic32u3): fill confirmed specs and update ngscopeclient to single-binary UI
- ngscopeclient now single-binary, UI-configured (drop sigrok-bridge/--adc-mode/TCP)
- Downloads via GitHub Release (dl.sipeed as backup mirror)
- Stream mode 6.4Gbps/800MB/s, 2Gbit DDR, samplerate table
  (4ch@1400/8ch@800/16ch@400/32ch@200), max 1400M
- Threshold 0-6V step 0.1V (Vth), Mini-HDMI 8-color coding, min pulse ~0.71ns
- Multi-ch/multi-edge trigger (ngscopeclient single-ch/edge), MODE=DFU/APP
- macOS fully supported; scope udev ID_MM_DEVICE_IGNORE to the 359f rule

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-02 00:00:23 +08:00