这篇不讲过程，把这套工作流现在的功能点按层拆开。每一层都是踩坑踩出来的，坑也照写。

看板层：从「能记任务」到「自动流转的任务系统」

上一篇的看板只能算记事本，这一轮它长出了四处自动化。地基是一条约定：一个 issue = 一个 worktree = 一个 PR，一张卡从开工到合并走完整闭环，下面的自动化都围着它转。

主卡 + 子卡（官方 sub-issue）。一个专项一张主卡，拆出的子卡用 GitHub 官方 sub-issue API 挂接，父卡页面自动显示进度条，子卡关闭自动勾选。之前手写 - [ ] #N tasklist 的做法废弃——它没有任何联动，最后一个子卡关了父卡还傻开着（这个坑真踩过：两个专项主卡都手动收的尾）。后来干脆写了个 30 行的 Action：最后一个子卡关闭时自动关闭父卡，专项生命周期零手动维护。

这个 Action 上线前还撞了一堵测试永远测不出的墙：issues 事件的 workflow，GitHub 只认默认分支上的版本。PR 分支里写得再对、本地 dry-run 全过，事件就是不派发——静默的，连报错都没有。「关父卡」这个动作因此没法在 PR 里真实验证，只能合进 master，等第一张收官的专项卡来检验。改 CI 配置类的东西，验证闭环天生缺一半。

建卡脚本。手工建 issue 的坑：14 张新卡全部漏挂看板、漏设字段——看板过滤直接失灵。现在建卡一律走脚本：

scripts/new-issue.sh --title "xxx" --body-file card.md \
  --type bug --phase 1 --area backend --priority P1 --labels area/hotkey

一条命令完成：issue 创建（含类型标签 + @me 指派）→ 挂板 → Status=Todo → Phase/Area/Priority/Milestone。建卡即合规，不靠记性。

三条自动流转：PR squash 合并 → issue 自动关 → 卡片自动进 Done；master CI 变红 → 自动开一张「master CI 红」跟卡，恢复绿自动关；最后一个子卡关闭 → 父专项卡自动关闭。加上 master 红时其他 PR 的停线门禁（快速失败，修复类 PR 打 area/ci 标签放行），看板从「任务的墓志铭」变成了「活的调度器」——这句是合并当天写的，现在看依然成立。

认领协议（防撞车）：开工前必须先把卡片置 In Progress 占坑 + 扫一眼有没有同卡的 open PR。这条是被撞出来的——两个会话同时开工一张卡，第二个的分支自动加了 -2 后缀：

执行层：多实例隔离，测试与正式互不打架

上一篇没解决的一个问题：正式实例在自测，另一个会话要起实例验证代码——单实例锁、端口、数据目录全绑死一份，只能互相杀。

解法是给实例一个身份：PANTA_DATA_DIR 环境变量把数据目录（锁、数据库、日志）整体搬走，PANTA_PORT 换端口：

scripts/dev.sh                                                    # 正式实例
PANTA_DATA_DIR=~/.pantalog-dev PANTA_PORT=9787 scripts/dev.sh     # 测试实例

两个实例并行互不知道对方存在。不设环境变量时行为与原来完全一致，单实例防护不削弱。测试实例默认不注册全局热键（双实例抢系统热键没有赢家）。

CI 层：把「review 跟不上」交给机器

这是整个体系里最实的一层。先把丑话说在前面：多 agent 并行交付，PR 产生的速度远超我读 diff 的速度，很多 PR 我是扫一眼描述就合并的，并不确定测试是否存在、断言是否有效。解法不是更认真地 review（不可扩展），是把 review 里能机械化的部分全机械化。

还有一个前提得先交代：仓库在 GitHub 免费套餐上，分支保护配不了，API 实测 403。原生 required checks 用不了，「不让红的进 master」就没法交给平台，只能自己造两层：机器能硬卡的做进 CI（下面这些门禁全是）；机器管不了的，比如「合并前到底看没看 checks」，写成红线协议塞进 CONTRIBUTING.md，当每个会话的交通规则。

覆盖率三件套：

1. PR 自动评论覆盖率变化——数字可见本身就有约束力：

2. 基线棘轮：--cov-fail-under 把全量覆盖率封底，只许升不许降（71.5 一路涨到 79，因为还债和带测试的修复在推高它）
3. diff-cover 增量门禁：PR 改动/新增的行强制测试触达 ≥80%，否则红、无法合并——存量零覆盖不追缴，新代码没测试就物理上进不来

覆盖率只回答「有没有测试」，回答不了「测试测的是什么」。最疼的一次来自旧库升级：测试套件每个用例都从 create_all 建新库开始，全绿；用户手里的旧库升级路径零覆盖，一启动就崩——新库永远测不出迁移 bug。此后立了铁律：动 schema 必须附「旧库就地升级」测试，用旧 schema 建库、跑迁移、断言结果，新库验证不算数。

前端三道棘轮（思路同源：存量封顶、增量达标）：禁新增 ts-ignore、单文件行数封顶、i18n 双语 key 一致性。加上 oxlint+oxfmt 基线，前端从零约束追平了后端 Ruff 的治理水平。

运维细节：每个 job 硬超时（默认 360 分钟，挂死一次烧穿私库按分钟计费的额度）、concurrency 取消旧 run、runner 只用 ubuntu（私库按分钟计费，macOS 十倍费率用不起）、master 红自动跟卡：

红线协议：测试永远测不出的那部分。门禁管代码，管不住流程。五天里真正造成损失的坑，没有一个能被测试拦住：

• 带红合并：master 变红过两次，都是 PR 还红着就合造成的。其中一次特别迷惑——本地全绿、CI 红，最后查清是 pytest 撞了 UTC 边界，北京早 8 点前后才触发。此后第一条红线：gh pr checks 全绿才许合并；日期相关的测试失败，先怀疑时区再怀疑代码。
• 重复修：master 红了一次，两个会话同时开工修同一个问题，先落地的合了，后落地的整个作废重做。此后修前必看板 + 最新 run，确认没有别人在修同一张卡。
• 继承错误逐卡修：master 红时切出去的新分支，错误跟着进每个 worktree。正解是修完 master 后各自 rebase，继承的错误随 rebase 消失；在多张卡里各自修同一个 master 问题，等于把一个 bug 修 N 遍。
• 网页绕行：PR 冲突必须在本地 rebase 解决、跑绿、--force-with-lease 推回。在 GitHub 网页上手改文件「绕过」冲突，等于跳过本地测试直接进 master。

五条规则（还有一条「master 红就停线：不合并、不开新卡」）全写在 CONTRIBUTING.md 的「CI 红线规则」里，每个会话开工前必读。

基建层：崩溃教出来的基础设施

日志落盘。起因是某天早上的一场三连崩：启动时 16 条积压任务批量补投，每条各起线程调本地转写模型，MLX 的 GPU stream 线程绑定、并发直接 Metal 层 C++ 异常 → 主进程当场死亡 → 不走任何清理逻辑 → 子进程 UI 窗口成孤儿还开着。排查时发现日志只在终端，崩了连现场都没留下。修完之后日志体系是三层：后端轮转落盘、前端错误上报落盘、测试进程隔离（不污染用户日志）。

日志第一次派上用场就值回票价：排查「转写卡很久」——从日志实锤三个叠加原因（批量串行排队、同日期聚合被重复触发 N 次、GLM 偶发返回不合规 JSON），顺手各修各的卡。

转写 worker 子进程。转写是 GPU 满载的重活，还持有 Python 全局锁把 API 线程饿死。挪进独立子进程后主进程永远响应，子进程退出连显存缓存一起释放。配套硬约束：父死子退（getppid 看门狗）——强退程序就是全停，转写中的任务重启后自动补投，不丢数据。

导入内容校验。测试残留的 23 个假 WAV（内容是 2048 个字母 x）被当真导入，直到转写才报一坨错。现在文件头魔数 + ffprobe 可解码探测，垃圾在门口被拦。配套还有时长上限：超长录音入库标 too_long 待手动转写，不再占用队列。

最有价值的一课：AI 实现跑偏了产品意图

五天里最值得写的发现不是技术问题。复盘时我意识到：每条录音处理完都会调一次 LLM 生成「AI 回顾草稿」（评分、心情、下一步），还会触发一次当日汇总——而我的产品文档写的是：录音级只做转写和结构化提取；每日回顾是「当天多条语音的合并」，在复盘页看。文档白纸黑字，实现凭空多出一层。

代价清单：LLM 调用量翻倍（当天额度打爆）、时间线多了没人要的草稿块、状态机多了误导性的「转写中」、队列被拉长。它存在了好几天，写它的 agent 没发现，验收它的我也没发现。

教训：agent 写完不会自己拿产品文档对照，这个验收动作只能人做。修正卡当天开、当天关：录音级只留转写 + 提取（事实/计划/想法/问题，承诺闭环的数据源），AI 回顾回归日级聚合（带防抖），prompt 集中管理与评测联动。

反思：AI 时代的质量观

五天下来，对「AI 写代码，人干什么」有了具体得多的答案。「review 跟不上」的正确解法不是更认真地 review，认真不可扩展。能机械化的部分全机械化：覆盖率棘轮挡住没有测试的代码，diff-cover 挡住改了没测的行，lint 和 guards 挡住风格漂移。下限交给机器，人只管机器管不了的那部分——这个功能该不该有，做得好不好，是不是我想要的。

多 agent 并行同理：协调成本是真实的。五个会话同时开工时，撞车、抢号、互相污染工作区都会发生——规范和脚本不是官僚主义，是把协调成本从人肉记忆挪进脚本。

下一步：V0.1 的退出条件是连续 14 天真机自测（录音 → 次日勾选闭环）。护栏立完了，接下来该真用了。

数据截至 2026-09-16 定稿：122 commits / 111 merged PRs / 127 issues；覆盖率 71.5% → 79.6% 且基线棘轮持续生效；全部工作由多个 Claude Code agent 在 Orca worktree 中并行完成。

背景：手头有个 side project（panta-log，本地优先的语音复盘工具），之前 issue/PR 规范一直躺在另一个项目里没落地。这次目标很明确：看板管任务，Orca 跑 agent，一天之内把「领任务 → 开发 → 测试 → 合并 → 状态自动流转」整条链跑通。

先看最终跑通后的闭环长什么样：

看板挑卡(Todo) → Orca 从卡片开 worktree → agent 干活（自跑测试）
→ PR 触发 CI → 审 diff → squash merge
→ issue 自动关闭 → 看板卡片自动进 Done → 远端分支自动删除

第一步：规范落地

直接从自己的 boss-zhipin-scraper 项目抄了一套：issue 模板（bug/feature/question 三个 yml）、PR 模板、CONTRIBUTING.md，改成新项目的技术栈（uv、pytest、macOS 权限那些禁忌）。推上去之后仓库的 New issue 页面就有中文表单了，这步没什么好说的，五分钟的事。

第二步：用 gh CLI 批量建 backlog

Roadmap 文档里本来就有六个工作包、带验收标准，照着拆就行。原则：

• 只把「需改造」和「需新建」的任务建成 issue，已经能用的不建，别污染看板
• 标题带上任务编号（WP-A1 这种），看板上一眼能对回文档
• 正文直接引用 roadmap 的验收标准原文，再加一句建议批次（第几周做）
• 全部挂到 milestone 上，milestone 描述里写清退出条件

18 个 issue，两个 for 循环的事。

第三步：踩坑重灾区——gh project CLI

Projects 的操作大部分能用命令行做，但命令的坑一个接一个，全是实际踩出来的：

坑 1：gh auth refresh 非交互执行必须加 -h

在 Claude Code 里用 ! 前缀跑命令是非交互模式，直接报错：

--hostname required when not running interactively

要写成 gh auth refresh -h github.com -s read:project,project。另外这个命令要设备授权，进程会卡在那等浏览器确认，放后台跑，从输出里把 one-time code 捞出来，去 github.com/login/device 输入就行。

坑 2：field-create 的参数是 --name，不是 --title

gh project field-create --title "Phase" 会直接 unknown flag。帮助文档里两种写法都出现过，以 --name 为准。

坑 3：-q 必须配 --format json

这条最阴险。gh project item-add <n> --owner me --url xxx -q '.id' 会静默失败，报错是 cannot use --jq without specifying --format json。批量脚本里 18 个 item 全挂了还看不到原因（stderr 被吞了）。正确写法：

gh project item-add 2 --owner eatmoreduck --url "https://github.com/xxx/issues/1" --format json -q '.id'

坑 4：item-edit 用的是 --project-id，不是 --owner + --project-number

前面 item-add 都是 number + owner 的组合，到 item-edit 突然变了，要用项目全局 ID（形如 PVT_xxxx，project list 里能看到）：

gh project item-edit --id <item-id> --project-id PVT_xxxx \
  --field-id <field-id> --single-select-option-id <option-id>

坑 5：item-list 的 JSON 里 fieldValues 是 null

挂完板想核对字段值，gh project item-list --format json 返回的 fieldValues 全是 null，不是没设置上，是这接口压根不返回。想验证只能上 GraphQL：

gh api graphql -f query='query($login:String!,$number:Int!){
  user(login:$login){ projectV2(number:$number){
    items(first:30){ nodes{
      content{ ... on Issue { number } }
      fieldValues(first:20){ nodes{
        ... on ProjectV2ItemFieldSingleSelectValue { name field{ ... on ProjectV2FieldCommon { name } } }
      } }
    } } } }
}' -f login=eatmoreduck -F number=2 --jq '...'

建两个单选字段（Phase 对应版本分期、Area 对应模块），18 张卡批量挂板、设 Status/Phase/Area，再建两个日期字段给时间线用。一次搞定。

Orca 接入：比想象的省事

本来以为要在 Orca 里走一遍 GitHub OAuth，结果打开集成页面发现 GitHub 已经是 Connected 状态。原因是 Orca 的 GitHub 集成直接读本机 gh CLI 的登录凭据，gh 登录过就算接好了，根本不存在「连接并授权」按钮。

还有个小迷惑：想找看板找不到。Orca 的「任务」页面顶部有三个标签——议题、PR、项目。issue 列表在「议题」里，看板在「项目」标签里，从卡片右键就能创建 worktree，composer 会自动预填任务名并链接 issue。

看板自动化：两条规则，默认就是开的

闭环的引擎是 Project 自带的两条工作流：

• Item added to project → Set Status = Todo（新卡自动入列）
• When pull request merged → Set Status = Done（合并自动流转）

有个反直觉的地方：这两条项目创建出来就是 On 的状态，什么都不用配。我一开始以为得去网页设置里手动开，还专门写进了待办清单，后来打开 Workflows 面板一看，人家早就在干活了。查了一圈才确认 gh CLI 压根没有管理 Workflows 的子命令（gh project --help 里只有增删改查 item 和 field），所以这东西既没法命令行关掉也没法命令行开，只能去项目页面的 Workflows 面板查看和调整。

它们生效之后，merge PR 的瞬间：issue 自动关（commit 里写了 Closes #n）、卡片自动进 Done，全程无感。

Roadmap 时间线：日期值可以命令行灌

时间线视图打开一片空白，因为每个 item 都没有日期。做法：

1. 建 Start date / Target date 两个日期字段
2. 视图工具栏的 Date fields 里把起止指向这两个字段
3. 日期值按 roadmap 的执行批次用命令灌：

gh project item-edit --id <item-id> --project-id PVT_xxxx \
  --field-id <start-field-id> --date "2026-09-14"

灌完时间线上就是一根根条了，之后直接拖拽调期，字段值会跟着变。

多开 agent：可以，但别贪

Orca 的核心玩法就是一个任务一个独立 git worktree，几个 agent 并行互不踩分支。实测确实如此，两个任务同时跑，互不干扰。

但有几个实际经验：

• 挑卡要避开文件冲突。两个任务都改同一个文件，后合的必然冲突。同子系统的任务（比如都动转写模块的）别并行
• 并行 2-3 张，merge 串行。瓶颈根本不在写代码，在 review。一口气开五个 agent，五个 PR 堆在那里你审不过来，盲合进核心管线等于裸奔
• 智能体仪表盘三列（需要你 / 工作中 / 已完成）就是多开时的管理面板，agent 停下来等确认会出现在「需要你」列

另外 Orca 不会自动从看板领卡派活，挑哪张卡什么时候开还是人说了算。这反而是好事。

CI 也扔给 agent 建

仓库没有 CI，PR 级的自动测试就是空的。我的做法是先提一个 issue 把约束写死：私有仓库 Actions 分钟数计费、macOS runner 按 10 倍费率所以必须锁 ubuntu runner、只加一个 workflow 文件、不引入 ESLint/mypy。然后开个 worktree 交给 agent。

结果它把验收标准全打勾了：backend（ruff + 88 个测试）和 frontend build 双 job 全绿，合计 40 秒出头。中间还自己踩坑自己修——ubuntu 的 sounddevice 缺 PortAudio 依赖，它在 CI 里补了 apt-get install libportaudio2。更绝的是第一轮它故意看着 CI 红了一次才修，验证失败报警机制真的能响。

这里有个经验值得记：给 agent 的 issue 写得越具体（约束、边界、验收标准），产出越省心。模糊的「帮我加个 CI」和带计费约束、验收标准的 issue，产出质量差很远。

审查和合并不用出 Orca

审 diff、给 agent 提修改意见、合并，全程在 Orca 里：

• Diff viewer 逐行看，有问题直接在那个 worktree 的 agent 会话里说，改完 push 同一个 PR 自动更新
• Checks 面板看 CI 状态，失败可以直接一键把失败的 check 交给 agent 修

然后是这次最典型的一个误用：合并按钮找不着，右上角那个「提交」按钮还是灰的。

灰是对的——那是 git 推送按钮，没东西可推当然灰。合并入口在 PR 详情视图里（从 PR 列表点进去那一页），合并按钮带方式下拉，跟网页版一个逻辑。

merge 方式：选 squash，别犹豫

三种方式的区别一句话说清：

• Squash：整个 PR 压成 master 上一个提交，中间提交全丢弃
• Rebase：每个提交逐个重放上来，中间提交全保留
• Merge commit：原样合并，再加一个合并节点，历史变分叉图

AI agent 的产出场景，squash 是唯一解。agent 的中间提交全是「fix typo」「round 2」这种碎片，没有保留价值。squash 之后一张卡对应 master 上一个干净提交，回滚就是 revert 一条，Closes #n 写在 PR 描述里照样生效。另外两种只在多人协作保留分支拓扑、或你亲手精心整理过提交序列时才有意义。

仓库设置：两个开关分开看

• Automatically delete head branches：合并后自动删远端分支。开了立即受益，不然二十张卡的分支堆在远端没人清。本地 worktree 不受影响，用完在 Orca 里手动删
• Allow auto-merge：让 PR 可以设「checks 全绿自动合」。注意这只是解锁功能，不对具体 PR 启用就什么都不会发生。还有，没有 CI 的时候开了也是摆设——没有任何 checks 可等。所以顺序是：先开自动删分支，auto-merge 等 CI 上线再说

一天下来的小结

最大的感受：这套东西搭完之后，「管理任务」这个动作本身消失了——剩下的就是把卡一张张挪完。工具链各管一段：GitHub Projects 记状态，Orca 管 agent 和 worktree，gh CLI 补一切自动化的缝。

后面打算把「每天开工先看看板挑两张卡」养成习惯，看板不撒谎，进度不用记。

先说哪些变了

旧清单里这几个我现在已经不用了：

• Alfred —— 被 Raycast 完全取代了。付费墙又高，免费版能干的事太少。
• Mos / Mac Mouse Fix 二选一 —— 现在只留 Mac Mouse Fix，它新版本窗口管理也做了，比以前好用。
• Loop —— 留给 Mac Mouse Fix 的窗口管理之后撤了。
• EasyDevo —— DevToys 够用了。
• Termius —— SSH 直接交给 Ghostty + 系统 ssh 配置，多端同步的需求没了。
• lux（B 站下载） —— 不怎么下了。

下文按我现在真实的用法重新整理。

AI 编程

这是这两年变化最大的部分，单独拎出来。

说实话现在 AI 编程工具已经多到有点过剩了。我的实际状态是 Claude Code 当主力，剩下几个客户端拿来对比同一个问题不同模型的回答。没必要全装，挑一两个顺手的就行。

编辑器和 IDE

JetBrains 全家桶还是吃内存大户，但代码跳转和重构这块没什么能打的。Sublime 留着纯粹是因为它打开几万行的日志文件不卡。

笔记

笔记类我同时开着三个：Obsidian、语雀、Notion。不是因为选择困难，是它们在我这儿干的活不一样，谁也替代不了谁。

先给个速览：

Obsidian：我的主力

这篇博客就是 Obsidian 写的，平时记的笔记、写的 skill、攒的技术资料全在里面。它的核心好处是文件全在本地、纯 Markdown，不被任何一个云服务绑住，哪天想迁随时能迁。双链和图谱让笔记之间能连起来，越攒越有价值，不像传统笔记写到后面就成了一堆找不到的死文档。

它是个本地工具，发布得自己搭。我自己搭过两套，可以看看：

• hugo+obsidian 打造最强博客（一） 和 (二) —— 怎么把 Obsidian 接到 Hugo 博客上
• Obsidian + Claude Code 构建 AI 第二大脑 —— 后来又把 AI 接进来，让笔记真正"活"起来

语雀：技术文档沉淀

技术类的东西我往语雀放。它那套文档树结构很适合做知识库分层，一个项目从设计到实现拆成一块块挂上去，回头看一目了然。语雀的编辑器对代码块、公式、画板这些支持得比较细，写技术文档比 Markdown 裸写舒服。缺点是云端封闭，导出没那么自由，所以我只把"需要结构化整理、长期维护"的技术内容放这。

Notion：对外分享

Notion 我其实用得不多，但留着有它的道理——公开分享和对外知识库这块，它最好用。Notion 的页面能直接发布成公开链接，排版好看、多媒体混排方便，拿来做个人主页、项目介绍、对外教程很合适，对 SEO 也友好。我自己不拿它记日常笔记，但要做给别人看的东西，会优先考虑它。

我的实际分工

简单说就是：Obsidian 管输入和沉淀，语雀管技术整理，Notion 管对外输出。如果你只挑一个，长期沉淀选 Obsidian；要带团队做 Wiki 选语雀；要做对外内容选 Notion。三个都装也不是浪费，前提是给每个工具一个明确的角色，别什么都往一个里塞。

另外还有个 Anki，不在上面三个的赛道里。它是纯记忆工具，碎片时间拿来刷卡片，背单词和记技术知识点，配合 Easydict 存生词挺好用。

终端和 Shell

这块这两年换得最彻底。

以前用 iTerm2，换到 Ghostty 主要是图它快和干净。配置文件就一个，没有什么花里胡哨的设置面板，我反而更喜欢。

Shell 这套配置我没怎么折腾，就四样东西：Oh My Zsh、p10k、自动补全、语法高亮。够用了，再往上加插件启动会变慢。

命令行工具

这是旧清单里完全没覆盖的部分，但其实是我每天用得最多的。

包管理和运行时

uv 是这两年我最想安利的 Python 工具。装依赖、建虚拟环境、跑脚本，全用它一个，不用再记 python -m venv 那一串。配合 uv run 直接在临时环境里跑脚本特别舒服。

日常高频

task 这个我想多说一句。以前项目里一堆 Makefile，写起来不直观还容易写错。换成 task 之后，taskfile.yml 一眼能看懂在干什么，Windows 上也能跑，团队协作省心很多。

系统监控

mactop 是 Apple Silicon 上我比较推荐的。它能显示 CPU 各个性能核和能效核的占用，还有 GPU、内存带宽这些，htop 看不到。

容器和虚拟化

从 Docker Desktop 换到 OrbStack 是另一个"用完回不去"的体验。同样的容器，OrbStack 启动快一截，内存占用也小，而且它内置的 Linux 虚拟机可以当轻量开发环境用。Docker 留着主要是有些 CI 本地复现的时候要保证环境一致。

数据库和网络

Navicat 我现在没装了，DataGrip 一个顶所有。Wireshark 不常用，但真要排查网络问题的时候它是唯一靠谱的。

效率和启动器

Raycast 我每天用得最多的几个功能：启动应用、剪贴板历史、窗口管理、简单计算。它比 Alfred 好的地方是免费版就把核心功能全给了，不用纠结要不要买 Powerpack。

Easydict 这个之前我专门写过一篇 给 Easydict 加 Anki 功能，是真好用，划词就能查、能发音、能存生词。

浏览器和插件

主力 Google Chrome。日常用的插件：

其它日常

IINA 没什么好说的，装就完了。

旧的那篇 Mac 开发常用软件清单 留个时间戳，也没删。这篇是 2026 年的版本，估计过两年又得再更新一次。

初步想法，需要实现以下功能

1. 查询句子或单词时，中译音或音译中能直接制卡，将语句作为卡面，对应译文作为卡底
2. 要将录音文件的TTS也发送到anki，无需依赖其他API
3. 查单词时，卡底最好能有音标

于是经过跟Claude Code的多轮对话之后，基本实现功能，但语音层面仍需优化，后续考虑替换为大模型的 tts 服务

安装node

1. 安装brew install node 可指定版本，但openclaw 要求大于22
2. 验证 node –version 出现版本号，版本号大于20即可

安装git

brew install git
git --version   
输出有值即可                            
git version 2.39.5 (Apple Git-154)

安装并配置openclaw

1. 安装openclaw

 luna@ppmac  ~  curl -fsSL https://openclaw.ai/install.sh | bash

  🦞 OpenClaw Installer
  Because texting yourself reminders is so 2024.

✓ Detected: macos

Install plan
OS: macos
Install method: npm
Requested version: latest

[1/3] Preparing environment
✓ Homebrew already installed
✓ Node.js v25.6.1 found
· Active Node.js: v25.6.1 (/opt/homebrew/bin/node)
· Active npm: 11.9.0 (/opt/homebrew/bin/npm)

[2/3] Installing OpenClaw
✓ Git already installed
· Installing OpenClaw v2026.2.26
✓ OpenClaw npm package installed
✓ OpenClaw installed

[3/3] Finalizing setup
· Refreshing loaded gateway service
✓ Gateway service metadata refreshed
✓ Gateway service restarted
✗ Probing gateway service failed — re-run with --verbose for details
error: unknown option '--probe'
(Did you mean one of --no-probe, --profile?)

🦞 OpenClaw installed successfully (2026.2.26)!
I'm in. Let's cause some responsible chaos.

· Config already present; running doctor
· Running doctor to migrate settings
✓ Doctor complete
· Config already present; skipping onboarding
· Starting setup

2. 配置openclaw

   1. 安装好后会自动开始这步 选yes
   2. 先quickstart 后面可配置
   3. 模型选择自己想要的模型即可，我这里选用z.ai 使用智谱模型（需要先去生成apikey 并且填入，其他模型也是一样）
   4. channel官方推荐telegram 这里自行选择，需要准备上网工具增加proxy配置后，粘贴bot的token ，机器上需要加配置 “proxy”:“http://127.0.0.1:7890”, 给机器人发消息 ，/start 之后会收到回复的code 然后在终端使用。openclaw pairing approve telegram QRNT5UUY(code) 至此已经配置完，可以开始使用了openclaw

给openclaw操控浏览器的能力

macOS

1. 安装extension，命令执行后会自动下载extension包到对应文件夹下 /Users/{你的用户名}/.openclaw/browser/chrome-extension

openclaw browser extension install

2. 在chrome里地址栏输入 chrome://extensions/ 打开开发者模式

3. 点击加载未打包的扩展程序，然后选中extension文件夹即可

linux 可参照 https://cloud.tencent.com/developer/article/2626186

遇到的坑

1. 最初用nvm 安装node ，node全局安装后总时不时出现闪退问题，后面直接采用brew install node，官方脚本安装的openclaw
2. nvm安装后，卸载时，重新运行openclaw gatway install的plist .nvm路径，导致openclaw doctor始终有问题 原因是清理了.zshr后当前终端没有source 导致读取的环境变量是旧的，要么source ，要么重连一下ssh


查证go 和 go env 之后发现都没问题，最后注意到 ~/.bash_profile 中有这部分，确定造成报错的行是 export NODE_OPTIONS=–openssl-legacy-provider

#node
export PATH="/opt/homebrew/opt/node@20/bin:$PATH"
export LDFLAGS="-L/opt/homebrew/opt/node@20/lib:$LDFLAGS"
export CPPFLAGS="-I/opt/homebrew/opt/node@20/include:$CPPFLAGS"
export NODE_OPTIONS=--openssl-legacy-provider

使用vi编辑或者是使用其他文本编辑器打开 .bash_profile 文件

vi ~/.bash_profile
按i进入编辑模式
找到export NODE_OPTIONS=--openssl-legacy-provider 所在行
在 export NODE_OPTIONS=--openssl-legacy-provider 前加#
最后那行变成
#export NODE_OPTIONS=--openssl-legacy-provider
再按 esc 退出编辑模式
:wq! 
然后回车

如果不会使用 vi 可以直接终端执行

cd $HOME & open .

然后用喜欢的文本编辑器打开.bash_profile 更改所在行

将NODE_OPTIONS 注释掉后，重新进入 VScode 解决

登录之后，打开 https://dash.cloudflare.com/ ,保存/之后的字符串为 accountId

再打开 https://dash.cloudflare.com/profile/api-tokens

这一步完成后会看到如下图，保存好自己的 Workers AI API token

# 用户 API 令牌

#### Workers AI API 令牌已成功创建

复制此令牌以访问 Cloudflare API。为安全起见，将不再显示此令牌。

然后去 one-api 添加新渠道

添加完成后即可进行测试，后续可以再 next-chatgpt中直接使用

开发工具

实用工具

个人推荐：MonitorControl 和 Mac Mouse Fix/Mos 是真心推荐，用完就回不去了。

效率工具

RayCast 真的好用，我主要是用来：

• 快速启动应用
• 查剪贴板历史
• 简单的计算和转换
• 搜索文件

终端工具

网络工具

Chrome 插件

补充说明

上面的工具不是都要装，按需选择就行。如果你也在整理自己的工具清单，推荐看看 awesome-mac，那里更全。

最后更新：2024-04-07