claude-code/TODO.md

# TODO

尽可能实现下面的包, 使得与主包的关系完全吻合

## Packages

- [x] `url-handler-napi` — URL 处理 NAPI 模块 (签名修正，保持 null fallback)
- [x] `modifiers-napi` — 修饰键检测 NAPI 模块 (Bun FFI + Carbon)
- [x] `audio-capture-napi` — 音频捕获 NAPI 模块 (SoX/arecord)
- [x] `color-diff-napi` — 颜色差异计算 NAPI 模块 (纯 TS 实现)
- [x] `image-processor-napi` — 图像处理 NAPI 模块 (sharp + osascript 剪贴板)

- [x] `@ant/computer-use-swift` — Computer Use Swift 原生模块 (macOS JXA/screencapture 实现)
- [x] `@ant/computer-use-mcp` — Computer Use MCP 服务 (类型安全 stub + sentinel apps + targetImageSize)
- [x] `@ant/computer-use-input` — Computer Use 输入模块 (macOS AppleScript/JXA 实现)
<!-- - [ ] `@ant/claude-for-chrome-mcp` — Chrome MCP 扩展 -->

## 工程化能力

- [x] 代码格式化与校验
- [x] 冗余代码检查
- [x] git hook 的配置
- [x] 代码健康度检查
- [x] Biome lint 规则调优（适配反编译代码，关闭格式化避免大规模 diff）
- [x] 单元测试基础设施搭建 (test runner 配置)
- [x] CI/CD 流水线 (GitHub Actions)
-												feat: 加入 TODO; 开始夜间行者模式

											
										
										
											2026-03-31 23:59:04 +08:00
+								# TODO
 								尽可能实现下面的包, 使得与主包的关系完全吻合
 								## Packages
-												docs: 更新 TODO.md 标记 NAPI 包全部完成

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 01:08:12 +08:00
+								- [x] `url-handler-napi` — URL 处理 NAPI 模块 (签名修正，保持 null fallback)
 								- [x] `modifiers-napi` — 修饰键检测 NAPI 模块 (Bun FFI + Carbon)
 								- [x] `audio-capture-napi` — 音频捕获 NAPI 模块 (SoX/arecord)
 								- [x] `color-diff-napi` — 颜色差异计算 NAPI 模块 (纯 TS 实现)
 								- [x] `image-processor-napi` — 图像处理 NAPI 模块 (sharp + osascript 剪贴板)
-												feat: 加入 TODO; 开始夜间行者模式

											
										
										
											2026-03-31 23:59:04 +08:00
-												feat: 实现 @ant/computer-use-swift — macOS JXA/screencapture

用 JXA + screencapture 替代原始 Swift 原生模块：
- display.getSize/listAll: CGGetActiveDisplayList/NSScreen 获取显示器信息
- apps.listRunning: System Events 获取前台应用列表
- apps.listInstalled: 扫描 /Applications 目录
- apps.open/unhide: AppleScript 应用控制
- apps.appUnderPoint: NSWorkspace frontmostApplication
- screenshot.captureExcluding/captureRegion: screencapture 命令
- resolvePrepareCapture: 截图 + base64 编码

实测：display 返回 {width:1710, height:1112}，running apps 正确识别。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 08:48:04 +08:00
+								- [x] `@ant/computer-use-swift` — Computer Use Swift 原生模块 (macOS JXA/screencapture 实现)
-												feat: 升级 @ant/computer-use-mcp — 类型安全 stub + sentinel apps

- types.ts: 替换所有 any 为真实类型 (CoordinateMode, CuSubGates,
  Logger, GrantFlags, CuPermissionRequest/Response, ComputerUseHostAdapter)
- index.ts: 所有导出类型化 (DisplayGeometry, FrontmostApp, InstalledApp,
  RunningApp, ScreenshotResult, CuCallToolResult 等)；
  targetImageSize() 实现真实缩放逻辑；
  bindSessionContext() 返回类型正确的空调度器
- sentinelApps.ts: 添加 10 个 macOS 敏感应用 (Terminal, iTerm2,
  Finder, System Preferences 等) 及其分类

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 08:36:12 +08:00
+								- [x] `@ant/computer-use-mcp` — Computer Use MCP 服务 (类型安全 stub + sentinel apps + targetImageSize)
-												feat: 实现 @ant/computer-use-input — macOS 键鼠模拟

使用 AppleScript + JXA (JavaScript for Automation) 实现完整 API：
- moveMouse: CGEvent 鼠标移动
- key/keys: System Events 键盘输入（支持修饰键组合）
- mouseLocation: CGEvent 查询当前鼠标位置
- mouseButton: CGEvent 鼠标点击/按下/释放
- mouseScroll: CGEvent 滚轮事件
- typeText: System Events 文本输入
- getFrontmostAppInfo: 获取前台应用 bundleId + 名称

兼容 require() 调用方式（所有方法作为命名导出）。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 08:27:08 +08:00
+								- [x] `@ant/computer-use-input` — Computer Use 输入模块 (macOS AppleScript/JXA 实现)
 								<!-- - [ ] `@ant/claude-for-chrome-mcp` — Chrome MCP 扩展 -->
-												feat: 配置 Biome 代码格式化与校验工具

添加 biome.json 配置（formatter + linter + organizeImports），
.editorconfig 统一编辑器配置，package.json 新增 lint/format scripts。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 01:40:27 +08:00
 								## 工程化能力
 								- [x] 代码格式化与校验
-												feat: 添加 knip 冗余代码检查工具

配置 knip.json 检测未使用的文件、exports、依赖等。
新增 check:unused script，运行 knip-bun 扫描死代码。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 04:57:34 +08:00
+								- [x] 冗余代码检查
-												feat: 配置 git pre-commit hook — 提交前自动运行 Biome 检查

使用 .githooks/ 目录 + core.hooksPath 方案，零依赖。
prepare script 确保 bun install 后自动激活。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 01:44:55 +08:00
+								- [x] git hook 的配置
-												feat: 添加代码健康度检查脚本

scripts/health-check.ts 汇总项目各维度指标：
代码规模、lint 问题、测试结果、冗余代码、构建状态和产物大小。
新增 health script 一键运行。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 07:17:09 +08:00
+								- [x] 代码健康度检查
-												fix: 调优 Biome lint 规则，关闭 formatter 避免大规模代码变更

- 关闭 formatter 和 organizeImports（保持原始代码风格，减少 git diff）
- lint/format script 改为 biome lint（只做规则检查）
- 新增关闭规则：noConsole, noArrayIndexKey, noConfusingLabels,
  useIterableCallbackReturn, noVoidTypeReturn, noConstantCondition,
  noUnusedFunctionParameters, noUselessEmptyExport, useArrowFunction,
  useLiteralKeys, useImportType, useNodejsImportProtocol
- 零源码改动，仅调整配置文件

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 07:34:29 +08:00
+								- [x] Biome lint 规则调优（适配反编译代码，关闭格式化避免大规模 diff）
-												feat: 搭建单元测试基础设施 — Bun test runner + 示例测试

添加 bunfig.toml 配置、test script，以及三组示例测试：
- src/utils/array.ts (intersperse, count, uniq)
- src/utils/set.ts (difference, intersects, every, union)
- packages/color-diff-napi (ansi256FromRgb, colorToEscape, detectLanguage 等)

41 tests, 0 failures.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 02:08:38 +08:00
+								- [x] 单元测试基础设施搭建 (test runner 配置)
-												feat: 添加 GitHub Actions CI 流水线

push/PR 时自动运行 lint → test → build 三步检查。
使用 oven-sh/setup-bun 配置 Bun 环境。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

											
										
										
											2026-04-01 03:47:47 +08:00
+								- [x] CI/CD 流水线 (GitHub Actions)