Posts for: #Tools

昨天重装了 eink 手机。安装后希望装少而精的几个工具即可：

Telegram、Pocket Casts、Claude、Google Tasks、Brave、YouTube、微信读书、微信输入法、Slax Reader、Slax Note、Dropbox、Gemini、Spotify。

Google 在 2025 年 11 月推出了 Code Wiki，对着任意 GitHub 公开仓库自动生成持续同步的可交互文档站——架构图、类图、时序图，加一个用这份 wiki 当上下文的 Gemini chat。

用法：把 github.com/<org>/<repo> 换成 codewiki.google/github.com/<org>/<repo>。

丢一个看效果：openclaw/openclaw 的 Code Wiki 视图。

私有仓库要走 Gemini CLI extension。

官方介绍：Introducing Code Wiki。

只要产品里嵌了 AI，就一定要做 evals。这是过去两个月在 sgai.md（新加坡 AI 战略观察站）上踩坑总结出来的判断。

eval 是什么

eval = 评估测试。给 AI 输出和数据完整性写的回归测试，但和单元测试不是一回事。

单元测试测的是「函数给定输入，输出是不是这个值」——确定性的。

eval 测的是「AI 这次生成的东西，和金标 / 规则相比，质量有没有掉」——非确定性的。

简单说：单元测试盯代码，eval 盯模型 + 数据。

eval 解决什么问题

任何依赖大模型的系统，都有三个天然漏洞。代码里写的单元测试管不到，人肉 review 一定漏。

模型会幻觉。 LLM 会编一个看起来合理但根本不存在的 URL、人名、事实。我自己在 sgai.md 上踩过——5 月初让 agent 给一批 voice 人物档案补「主导项目 / 公开引言」，agent 给两条记录写了根本不存在的 sourceUrl（一个伪造的 Fintech Festival 演讲者 ID，一个伪造的航空业报道）。URL 模式正确得肉眼分辨不出，靠用户事后报错才发现。

模型会退化。 升级模型（Claude 4.6 → 4.7）或改 prompt，输出可能变差。但你不会主动知道——除非有人发现产出明显烂了。等用户先发现就太晚了。

数据会漂移。 AI 生成的内容入库后，没人持续盯着完整性，漏字段、缺翻译、链接腐烂会慢慢累积。sgai.md 是中英日三语站，数据文件里每条 record 要求 title / titleEn / titleJa 三套字段必须同时给。我有一次只 commit 了中文，下一个 PR 想补英日——结果 EN/JA 页面立刻断裂。

Warp 是从终端起家的 AI 开发环境。2026 年 5 月，它把产品文档站 docs.warp.dev 的源代码开源了，仓库地址 github.com/warpdotdev/docs。这个仓库除了文档内容本身，还配了一整套用 AI agent 维护文档的工作流。

文档站基于 Astro 6 + Starlight，内容用 MDX 写在 src/content/docs/ 下。Node.js 22 起步，npm install 后 npm run dev 启动本地预览，端口 4321。“Ask AI” 按钮和 “Was this helpful?” 反馈是可选功能，需要在 .env 里填公开值。

下面分四块说明仓库里 agent 相关的结构。

.agents/ 目录

.agents/ 分四个子目录：

• skills/ — 25 个 skill。每个 skill 是一个子目录，里面至少有一个 SKILL.md 描述用途和执行步骤，部分含有 references/、scripts/。
• rules/ — 通用规则，当前只有一个 oz-style-guidelines.md。
• templates/ — 不同类型文档页面的模板（quickstart、guide、procedural 等）。
• references/ — 词汇表等参考资料。

25 个 skill 按用途分四类：

草稿生成（10 个）：draft_quickstart、draft_guide、draft_procedural、draft_conceptual、draft_reference、draft_faq、draft_troubleshooting、draft_feature_doc、draft_docs、missing_docs。从空白页起一篇新文档时使用。

看到一个开源的桌面录屏工具 Recordly，macOS / Windows / Linux 都能跑。

它把录制和后期合在一个 app 里。录完直接进编辑器，时间轴上做 trim、zoom、变速、注释、额外音轨、裁剪，不再把素材丢进另一个剪辑软件。

主要功能

• 自动 zoom 建议、光标平滑、点击反馈
• 把录制内容放进 styled frame：壁纸、渐变、阴影、圆角、留白
• webcam 浮窗，位置可调、可镜像、可加阴影，可设置随 zoom 缩放
• 项目可存为 .recordly 文件，之后再打开继续改
• 导出 MP4 或 GIF
• 扩展市场 marketplace.recordly.dev

平台支持

• macOS 14.0+：用 ScreenCaptureKit 原生捕获
• Windows 10 19041+：用 Windows Graphics Capture + WASAPI 音频
• Linux 现代发行版：Electron 捕获，目前不支持隐藏鼠标

项目情况

• 许可证：AGPL 3.0
• 主页：recordly.dev
• 仓库：webadderallorg/Recordly
• 从 OpenScreen fork 后另起的项目