vault backup: 2026-06-09 23:15:17

claude-code-best/docs/task/task-016-backward-compat-tests.md

@@ -1,16 +1,28 @@
+---
+tags: [task, 向后兼容, 测试, deprecation, 重构]
+create time: 2026-06-09 22:30
+---
+
 # Task 016: 向后兼容 + 测试
 
-> 设计文档: [daemon-restructure-design.md](../features/daemon-restructure-design.md) § 五
-> 依赖: Task 014, Task 015
-> 分支: `feat/integrate-5-branches`
-
-## 目标
+## 概述
 
 确保旧命令向后兼容 (deprecation 警告 + 正常代理)，并为重构后的命令结构编写测试。
 
-## 文件清单
+> [!info]
+> 设计文档: [[claude-code-best/docs/features/daemon-restructure-design]] § 五
+> 依赖: Task 014, Task 015
+> 分支: `feat/integrate-5-branches`
 
-### 新增
+## 正文
+
+### 目标
+
+确保旧命令向后兼容 (deprecation 警告 + 正常代理)，并为重构后的命令结构编写测试。
+
+### 文件清单
+
+#### 新增
 
 | 文件 | 说明 |
 |------|------|
@@ -19,15 +31,15 @@
 | `src/cli/bg/__tests__/detached.test.ts` | DetachedEngine 启动/停止测试 |
 | `src/cli/bg/__tests__/tail.test.ts` | 日志 tail 功能测试 |
 
-### 修改
+#### 修改
 
 | 文件 | 变更 |
 |------|------|
 | `src/entrypoints/cli.tsx` | 确认 deprecation 路径正确代理 |
 
-## 实现方案
+### 实现方案
 
-### 1. 向后兼容矩阵
+#### 1. 向后兼容矩阵
 
 | 旧命令 | 新命令 | 处理方式 |
 |--------|--------|---------|
@@ -40,11 +52,12 @@
 | `claude list` | `claude job list` | stderr deprecation + 执行 |
 | `claude reply <id>` | `claude job reply <id>` | stderr deprecation + 执行 |
 
-**关键**: deprecation 输出到 stderr 而非 stdout，不影响脚本管道。
+> [!tip]
+> **关键**: deprecation 输出到 stderr 而非 stdout，不影响脚本管道。
 
-### 2. 测试计划
+#### 2. 测试计划
 
-#### 2.1 daemonMain 路由测试
+##### 2.1 daemonMain 路由测试
 
 ```typescript
 describe('daemonMain', () => {
@@ -59,7 +72,7 @@ describe('daemonMain', () => {
 })
 ```
 
-#### 2.2 引擎选择测试
+##### 2.2 引擎选择测试
 
 ```typescript
 describe('selectEngine', () => {
@@ -70,7 +83,7 @@ describe('selectEngine', () => {
 })
 ```
 
-#### 2.3 DetachedEngine 测试
+##### 2.3 DetachedEngine 测试
 
 ```typescript
 describe('DetachedEngine', () => {
@@ -80,7 +93,7 @@ describe('DetachedEngine', () => {
 })
 ```
 
-#### 2.4 Tail 测试
+##### 2.4 Tail 测试
 
 ```typescript
 describe('tailLog', () => {
@@ -90,7 +103,7 @@ describe('tailLog', () => {
 })
 ```
 
-### 3. 集成验证脚本
+#### 3. 集成验证脚本
 
 可选: 在 `scripts/` 下添加一个手动验证脚本:
 
@@ -113,7 +126,7 @@ echo "=== 5. claude list (deprecated) ==="
 bun run dev -- list 2>&1 | head -1
 ```
 
-## 验证清单
+### 验证清单
 
 - [ ] 旧命令全部正常工作 (仅多一行 stderr 警告)
 - [ ] `--bg` 保持无警告
@@ -121,3 +134,8 @@ bun run dev -- list 2>&1 | head -1
 - [ ] 现有 2695 个测试无回归
 - [ ] tsc --noEmit 零错误
 - [ ] 手动在 Windows + macOS/Linux 上验证关键路径
+
+## 关联笔记
+
+- [[claude-code-best/docs/task/task-014-daemon-command-hierarchy]]
+- [[claude-code-best/docs/task/task-015-job-command-hierarchy]]