# 可成长基础系统：另一台电脑详细使用与测试说明

编写日期：2026-09-12。适用对象：第一次在另一台 Windows 或 Mac 上测试空白包的人。

这份说明是空白包的操作伴读，不替代包内规则。若它与实际工具、包内说明冲突，先停下记录差异，不让 AI 修改框架来“配合说明”。

## 1. 这次到底测什么

测试你能否在一台新电脑上，把一个空白目录交给有实际执行能力的 AI，然后通过自然语言完成：

1. 说清一个小业务，生成真正能运行的实现。
2. 改一条规则，看到运行结果随之改变，旧功能不受影响。
3. 增加一个需要保存数据的功能，并确认数据确实留下。
4. 查看运行图，知道某次请求经过了哪些函数、输入输出是什么。
5. 拒绝失败改动、恢复旧代码，并确认数据没有被覆盖。

这不是安装一个完整客服后台，也不是把微信接上线。包内不自带 AI、不自带模型账号、不自动接收微信消息。你使用的 AI 帮你写和执行代码；运行图是结果查看器，不是聊天窗口。

已有本地及独立 Linux 演练结果不能替代这台电脑的验收。尤其不要因另一台 Mac 成功，就写“Windows 已兼容”。

## 2. 带走哪些文件

只需带走：

- `可成长基础系统-本地演练版.zip`：真正的空白包。
- 本份说明：给你按步骤操作。

空白包内已经有 `上手说明.md`，无需再复制一个不同版本进去。

不要带：豆包文具店结果包、Claude 的案例目录、旧的 `data/`、`evidence/`、他人的配置和整个工作台。那些是既有实验成果，不是干净起点。

用 U 盘、局域网或你认可的文件传输方式把上述文件带到新电脑。传完核对文件名、文件大小，必要时让 AI 对比源端和目标端 SHA-256。不要把账号凭据或真实客户资料一同传过去。

## 3. 准备新电脑

### 3.1 准备一个真正能做事的 AI 工具

可以使用你已经安装且获准使用的工具。关键不是名字，而是本次会话同时具备：

- 读取指定目录文件。
- 在指定测试目录中创建、修改文件。
- 启动 Python 命令并拿到退出码和输出。

能上传文件、读文件或写出代码，不等于能执行。不要根据产品名称猜能力，也不用为了测试先购买新服务。

如果工具有“打开文件夹／选择项目／工作目录”，选本次测试目录。如果没有这样的入口，在对话中提供目录的完整路径，并要求 AI 读回确认。

遇到系统权限弹窗，只核准本次确实需要的测试目录及命令。不要为省事把整个磁盘、其他业务目录或所有外部操作都放开。工具只能操作云端目录时，应明确这实际上是云端测试，而非这台电脑的本地执行。

### 3.2 检查 Python

本包要求 Python 3.10 或以上，框架使用标准库，不要求先装额外 Python 依赖或搭建服务器。

优先让 AI 检查；想自己检查时，Windows 打开 PowerShell，Mac 打开“终端”。

Windows 先运行：

```powershell
python --version
```

如果找不到命令，再试：

```powershell
py -3 --version
```

Mac 运行：

```sh
python3 --version
```

应看到 `Python 3.x.x`，且版本不低于 3.10。如果跳出商店、显示找不到命令或版本太低，尚未通过检查。

需要安装时，从 [Python 官方下载页](https://www.python.org/downloads/)选择适合本机的稳定版本，按官方安装程序操作；安装完重新打开终端，再核对版本。[Windows 官方使用说明](https://docs.python.org/3/using/windows.html)可用于检查安装与命令入口。不要照抄陌生网站的一键安装脚本。

后面命令用“实际可用的 Python 命令”执行：Mac 通常是 `python3`；Windows 以刚才成功的 `python` 或 `py -3` 为准。不要为了命令名字不同就改 `kit.py`。

## 4. 解压到一个全新目录

Windows：在文件资源管理器中找到 ZIP，右键选择“全部解压”，选择你有写入权限的新文件夹。

Mac：在访达中找到 ZIP，双击解压，把解压出的完整内容放进新文件夹。

建议目录名用简单英文，降低路径排查难度，例如：

- Windows：你的“文档”下 `learner-kit-trial-01`。
- Mac：你的“文稿”下 `learner-kit-trial-01`。

这是示例目录名，不是让你照搬另一台电脑的用户名。不要直接在 ZIP 预览窗口里运行，也不要覆盖已经存在的测试目录。再次从零测试时另建 `learner-kit-trial-02`。

找到直接包含 `kit.py` 的那一层。它应包含：

```text
learner-kit-trial-01/
├── kit.py
├── report.html
├── AGENTS.md
├── CLAUDE.md
├── 上手说明.md
├── .agents/skills/learner-grow/SKILL.md
└── current/                 ← 初始应为空
```

`.agents` 以点开头，可能被文件管理器隐藏。让 AI 检查完整路径即可；不要因为肉眼看不到就重新造一个 Skill。Mac 可用 Command + Shift + . 切换隐藏文件显示。

如果解压后中文文件名乱码、找不到 `上手说明.md` 或 `.agents/skills/learner-grow/SKILL.md`，先停在解压阶段。保留原 ZIP，让 AI 核对编码与解压方法，不要凭猜测批量重命名，也不要跳过规则。

`current/` 空、没有 `运行图.html`、没有 `data/`、没有成功记录，都是正常的空白起点。不要直接运行不存在的业务。

## 5. 第一轮：先让 AI 检查，不急着开发

在 AI 工具中新建对话。把下面的 `【本次目录的完整路径】` 替换成新电脑上的真实路径后发送。不要保留方括号占位文字。

```text
我正在另一台电脑上测试可成长基础系统空白包。
本次唯一工作目录是：【本次目录的完整路径】。

先做环境检查，不要生成业务：
1. 读回你实际访问的完整目录，确认这里直接有 kit.py，current 为空。
2. 完整读取 AGENTS.md、上手说明.md，以及 .agents/skills/learner-grow/SKILL.md。CLAUDE.md 存在时也读取。
3. 实际运行 Python 版本检查和 kit.py --help，报告操作系统、Python 版本、实际使用的解释器命令及退出码。
4. 确认能在本目录写文件并执行命令，分清本机环境和云端环境。任何能力缺失就明确停下，不能用文字推演代替。
5. 本轮只限合成本地演练；不得读取其他业务、家目录资料、客户信息，不连接外部业务服务。
6. 不得修改 kit.py、report.html 或框架规则来迁就测试，不伪造 evidence。

检查完告诉我“可以开始”或准确阻断，然后等待我提供业务。
```

你应该看到：正确目录、操作系统、Python 版本、帮助命令的真实结果。只回复“环境没问题”但不给实际检查依据，不算通过。

若需要自己核验帮助命令，先进入直接包含 `kit.py` 的目录，再执行：

```text
实际可用的Python命令 kit.py --help
```

上面是格式说明，不是完整可复制命令。Mac 例如 `python3 kit.py --help`；Windows 例如 `python kit.py --help` 或 `py -3 kit.py --help`。

## 6. 第二轮：说清业务，先看需求复述

先用下面这个合成文具店场景，把工具链跑通。它不使用真实客户数据。

```text
我开一家模拟文具店，这次先做商品询价。
笔记本每本 12 元，签字笔每支 3 元。
顾客问没有配置的商品时，明确不知道价格，并提示需要店主处理，不能猜价格。

只做本地演练，不真的给店主或顾客发消息。
请按包内流程把需求、规则依据、输入输出、转人工条件整理成需求稿。
需要补充的关键问题可以问我，先复述最小场景，等我确认后再实现。
```

你应该看到：AI 把你的价格、未知商品处理规则复述出来，标明这是合成演练。它不能擅自加会员、支付、微信群、数据库或后台。

核对正确后，再发：

```text
需求确认。请就在本实例的本地演练里做出来。
通过候选、实际验收、采用流程完成，再从当前生效业务入口分别查询笔记本、签字笔、修正带。
未知商品不仅状态要正确，还应明确没有已知价格，例如 price 为 null，并把这一点写进验收断言。
给我真实结果、证据位置和仍未验证的边界，不要只展示代码或修改需求文档。
```

你要检查的结果：

| 操作 | 应看到什么 |
|---|---|
| 查询笔记本 | 12 元 |
| 查询签字笔 | 3 元 |
| 查询修正带 | 不知道价格、需要店主处理，无猜测价格 |
| 看采用结果 | 业务已进入 current，不只是 candidate 通过 |
| 看验证 | 有真实通过结果及对应 evidence 文件 |

“转店主”在这里仅表示业务返回的处理建议，不代表真的给店主发过消息。若生成文案写“已通知店主”，要让 AI 说明实际未发送，不能当作外部动作成功。

## 7. 第三轮：改变一条规则

上一轮完成后再发，不要把所有后续要求一次贴完。逐轮发送才能观察它是否会基于当前业务改进。

```text
现在笔记本涨价为每本 14 元，签字笔仍为每支 3 元。
请按本包迭代流程先核对当前结果，再做候选修改、验收与采用。
只改这条价格需求，并保留签字笔和未知商品的旧对照。
采用后通过真实入口重新查询三种商品，告诉我改前和改后是什么。
```

应看到：笔记本 12 → 14，签字笔仍为 3，未知商品仍不猜价。不能只在 `需求稿.md` 中写 14，而真实运行还返回 12。

## 8. 第四轮：增加能记住数据的功能

```text
现在增加笔记本库存功能，初始为 5 本。
按请求编号预留库存；相同请求重复提交不得重复扣减。
可以取消预留并返还库存；重复取消不得重复返还。
库存不足时拒绝，不得出现负库存。
价格功能保持笔记本 14 元、签字笔 3 元，未知商品不猜价。

先把新增需求复述清楚，再在当前已授权本地演练范围内完成候选、验收和采用。
用独立验收数据测库存不足，并保留价格回归用例。
采用后，对本实例日常演练 data 依次执行下面五步，每一步单独真实调用业务入口：
1. REQ-100 预留 2 本。
2. 原样重复 REQ-100。
3. 取消 REQ-100。
4. 再次取消 REQ-100。
5. REQ-200 预留 1 本。
最后再用一次独立调用查询库存与预留记录，证明跨进程数据确实保存。
不要用同一段程序中的内存变量假装持久化，不重置 data 来凑结果。
```

你应该依次看到剩余库存：`3 → 3 → 5 → 5 → 4`。最后查询应能读到 REQ-200 预留了 1 本。

验收用例的临时数据与日常 `data/` 分开。同一个验收场景内步骤共享临时数据，不同场景从空数据开始。因此“验收已经预留了一本”不代表日常库存已经少了一本。

不要再次发送完整五步来“看一下”，因为它包含会改变数据的操作。想查看当前情况，只让 AI 查询库存；不确定是否执行过，先读回证据和数据。

## 9. 第五轮：查看运行图

发送：

```text
请刷新本实例的运行图，告诉我生成文件的完整路径和生成时间。
我想查看刚才最后一次库存查询：它收到什么、经过哪些实际函数、返回什么、对应哪份原始证据。
如果你的工具能查看页面，可以检查；不能查看就标“已生成，视觉未验”，不要假装看过。
```

然后你自己操作：

1. 在本实例目录找到 `运行图.html`，用浏览器打开。
2. 在“查看哪一次运行或验收”中选择刚才的库存查询。
3. 看该记录是否对应生成报告时的当前业务版本，别选到历史旧版后误以为当前仍这样运行。
4. 展开节点里的“查看实际输入与返回”，应能看到这次真实调用的信息。
5. 展开请求、结果和验收信息，核对库存为 4、REQ-200 仍在。
6. 保存一张你实际展开后的截图，作为这台电脑的人工查看证据。

这里的节点来自实际 Python 函数调用，不一定与你口头描述的业务步骤一一对应。图只展示发生过的路径，没执行到的分支不会自动证明已完成。

`report.html` 是模板，不是应该打开的业务结果。`运行图.html` 才是本实例的生成报告。图是快照，不是实时监控；改动后先重新生成，再刷新页面。

## 10. 第六轮：练习失败拦截和恢复

仅在前面都成功后做。本轮仍不涉及真实业务。

### 10.1 故意做错，让门禁拦住

```text
现在做一次受控失败演练，只在 candidate 中故意把未知商品改成猜测价格 10 元。
保留正确的验收要求和其他用例，不降低断言、不改框架。
实际执行候选验收，应失败；再尝试采用，应被拒绝。
读回当前业务，确认未知商品仍不猜价，库存和 REQ-200 记录未受影响。
然后放弃这个错误候选，保留失败证据，不删除历史记录或业务数据。
```

这里看到非零退出码、候选未通过和采用被拒，是预期成功。不要把这个失败“修成通过”后才报喜。

### 10.2 恢复旧代码，再回到库存版本

先发：

```text
先不要恢复。请列出本实例可用的历史版本，核对代码或规则，告诉我哪个是“14 元、尚无库存功能”的版本，以及如何恢复回当前“14 元加库存”版本。
不要只凭时间戳猜版本内容，不要选择 discarded 错误候选或空白初始版本。
告诉我每一步预期行为，以及为什么 data 不会被覆盖，等待我确认。
```

看清目标后，确认发送：

```text
确认按刚才核对的准确版本恢复到“14 元、尚无库存功能”。
实际核对价格与数据仍在，再恢复回“14 元加库存”的可用版本。
每次恢复后重新验证，最后通过真实业务入口查询库存和 REQ-200 记录。
不得覆盖、清空或迁移 data；如果遇到数据不兼容，停下说明，不自行删除数据解决。
```

旧版不能查询库存不等于数据丢了；回到支持库存的版本后，要通过业务入口读到剩余 4 和 REQ-200。最终应停留在这个可用版本。

“恢复”只恢复代码与规则，不撤销已经发生的业务动作，也不会自动把库存回到 5。

## 11. 换成自己的业务怎么说

先把上面合成测试做完。要做自己的业务时，另开干净实例，不直接拿文具店数据改名。

把下面提示词填成自己的实际情况，不知道的地方写“不确定”：

```text
我做的是：……
我想先让 AI 帮我处理的一件小事是：……
别人通常会输入：……
我希望它返回：……
它应该依据的规则是：……
这些情况必须交给我：……
第一轮只用我提供的合成例子做本地演练，不接真实账号。
请先访谈、复述需求，让我确认，再按本包流程实现和验收。
```

从“一件小事”开始，例如询价、根据已给规则判断是否符合条件。不要第一轮就要求整个公司自动运营。

## 12. 暂停、继续和报错时怎么说

暂停：

```text
暂停后续改动与采用。保留当前候选、代码、数据和证据，告诉我停在哪里、哪些动作已经发生。不删除或重置任何东西。
```

下次继续：

```text
继续这个实例，不要重新初始化。先读本目录需求稿、迭代记录、current、candidate 和最近证据，复述已完成和未完成的部分，再接着做。
```

报错：

```text
先不要重装、重建或改框架。请保留准确命令、完整错误和退出码，核对工作目录、解释器、候选状态和数据是否部分改变。在当前范围内定位，无法处理就明确停点。
```

| 看到的情况 | 下一步怎么做 |
|---|---|
| 找不到 kit.py | 核对是否选错了目录层级，不扫描全盘 |
| current 为空、找不到 app.py | 空白起点正常，先做需求与候选实现 |
| Python 命令找不到 | 按第 3 节核对解释器；不要改框架 |
| 中文乱码或 Unicode 错误 | 保留原错，区分解压文件名、文件编码、终端／进程编码；让 AI 检查实际环境，不批量改业务文件 |
| candidate 已存在 | 先看是不是未完成工作，选择继续或明确放弃，不能覆盖 |
| 候选验收通过但 adopt 被拒 | 核对是否验收后又改了候选，变更后必须重验 |
| 验收失败 | 保留失败，定位对应断言；不要统一把预期改成实际结果 |
| 运行超时 | 动作可能部分发生，先查数据与证据，不能盲目重试 |
| 图没有记录 | 确认已实际运行或验收，再刷新运行图 |
| 图还是旧结果 | 重新 report，打开本实例新生成的文件并刷新 |
| AI 只能读文件不能执行 | 记录能力阻断，不能称已完成程序测试 |

不要自行关闭安全软件、开放所有权限或安装一堆依赖来绕过问题。把具体阻断带回来即可。

## 13. 测完后带回什么

最后发送给 AI：

```text
请整理本实例的测试报告，不要修改既有证据来配合结论。
报告写明：电脑系统、AI 工具及本次实际运行位置、Python 版本、实际解释器命令、每阶段结果、关键退出码、原始证据位置、人工查看情况、失败和仍未验证项。
核对六个框架文件与原空白包是否一致。
把本实例业务代码、验收用例、规则、revisions、evidence、迭代记录、需求稿、运行图、截图和仅本次合成 data 打成结果包。
只打包本实例，不包含父目录、账号配置、凭据或客户资料。使用支持中文文件名的 UTF-8 ZIP，打包后核对目录清单，区分文件数和含文件夹的条目数。
报告与结果包留在本测试范围内，告诉我完整路径。
另外列出我在操作中卡住的地方，区分说明缺失、AI 没读到、环境限制和真实程序错误。
```

你给我带回：

- AI 的最终回复和测试报告。
- 结果 ZIP；不方便传 ZIP 时，先发准确路径与报告。
- 一张你亲自打开并展开节点的运行图截图。
- 如果中途失败：原始报错、发生在哪一步、之前有没有成功，不必为交报告硬把所有步骤做完。

不要上传真实资料到公开分享页。本次应只有合成文具店数据。

## 14. 人工验收表

只按实际发生的结果填写“通过／失败／未做”，不要预先打勾。

| 编号 | 我亲自确认的结果 | 状态与证据 |
|---|---|---|
| AC-001 | 正确目录、Python 可运行，AI 能读写执行 | 待填 |
| AC-002 | 从空白生成业务：12、3、未知不猜价 | 待填 |
| AC-003 | 改价后为 14、3、未知不猜价 | 待填 |
| AC-004 | 库存五步为 3、3、5、5、4，独立调用能读回 | 待填 |
| AC-005 | 我能打开运行图并展开实际输入输出 | 待填 |
| AC-006 | 错误候选被拒，原版及数据未受影响 | 待填 |
| AC-007 | 恢复往返后回到库存版本，REQ-200 仍在 | 待填 |
| AC-008 | 报告和结果包可读取，无真实客户数据 | 待填 |

这张表是本次跨电脑测试记录，不是新增产品功能要求。即便全部通过，也只证明这台电脑、这个工具、这个合成场景按这些步骤跑通，不代表真实客服上线或所有输入都已覆盖。

## 15. 本说明的边界

本次只补详细操作说明，没有改空白包、框架、业务或正式上手说明；没有新增安装器、自动部署、模型配置、服务器和微信接入。以上都不是完成本次跨电脑演练的必要条件。

手册已按当前包内命令与契约核对；目标电脑的环境、解压、执行和人工交互仍需由本次测试确认。