jcode 的这个教程只处理标题中的具体任务。jcode 能发现多种已有 CLI 凭据，但凭据复用不等于复制文件；应先判断 Provider 是否能非交互工作，再决定登录路径。
下面所有操作都先放在测试仓库、测试账号或仅回环监听的服务中。命令中的域名、用户名、路径与密钥是占位符，执行前需要替换。
先盘点本机已有的模型会话
这一节解决的是“先盘点本机已有的模型会话”。先记录当前状态，再执行最小动作，最后用独立证据确认结果。
对 jcode 而言，判断依据是：jcode 能发现多种已有 CLI 凭据，但凭据复用不等于复制文件；应先判断 Provider 是否能非交互工作，再决定登录路径。不要在这个阶段顺手打开更多权限。
|
|
执行后保留命令输出和时间戳。若输出依赖当前终端里的临时变量，打开新终端复查一次。
Windows 安装后确认 PATH
按下面顺序处理：
- 读取实际版本和当前配置。
- 只改变与本节相关的一项设置。
- 运行一个只读或可撤销的请求。
- 检查日志、退出码和最终文件。
- 失败时恢复刚才那一项修改。
|
|
这里的完成标准不是界面出现，而是“Windows 安装后确认 PATH”有可重复结果。
jcode 自有认证目录放在哪里
| 要检查的内容 | 合格表现 | 需要停止的信号 |
|---|---|---|
| jcode 自有认证目录放在哪里 | 输入和输出范围明确 | 自动扩大到其他项目或账号 |
| 权限 | 只获得完成任务所需权限 | 要求管理员权限或完整密钥 |
| 日志 | 能定位失败且已经脱敏 | 出现 Token、Cookie 或私有正文 |
| 回退 | 能恢复上一步状态 | 修改不可逆且没有备份 |
|
|
表格中的停止信号一旦出现，先撤销本节改动，不要继续后面的自动化。
复用 Codex 登录态前做只读检查
围绕“复用 Codex 登录态前做只读检查”准备一个成功样本和一个失败样本。成功样本验证正常路径，失败样本验证限制是否真的生效。
|
|
建议记录以下四项：
- 执行前的版本或 Git 提交。
- 实际输入，不记录秘密值。
- 可观察的输出、状态码或 diff。
- 恢复动作以及恢复后的复查结果。
如果失败原因仍不清楚，每次只修改一个变量；不要同时换端口、运行时、Provider 和代理。
Claude 凭据的搜索顺序
这一节解决的是“Claude 凭据的搜索顺序”。先记录当前状态，再执行最小动作，最后用独立证据确认结果。
对 jcode 而言，判断依据是：jcode 能发现多种已有 CLI 凭据，但凭据复用不等于复制文件；应先判断 Provider 是否能非交互工作，再决定登录路径。不要在这个阶段顺手打开更多权限。
|
|
执行后保留命令输出和时间戳。若输出依赖当前终端里的临时变量，打开新终端复查一次。
Gemini OAuth 与环境变量的区别
按下面顺序处理：
- 读取实际版本和当前配置。
- 只改变与本节相关的一项设置。
- 运行一个只读或可撤销的请求。
- 检查日志、退出码和最终文件。
- 失败时恢复刚才那一项修改。
|
|
这里的完成标准不是界面出现，而是“Gemini OAuth 与环境变量的区别”有可重复结果。
OpenRouter 和 Azure OpenAI 的独立配置
| 要检查的内容 | 合格表现 | 需要停止的信号 |
|---|---|---|
| OpenRouter 和 Azure OpenAI 的独立配置 | 输入和输出范围明确 | 自动扩大到其他项目或账号 |
| 权限 | 只获得完成任务所需权限 | 要求管理员权限或完整密钥 |
| 日志 | 能定位失败且已经脱敏 | 出现 Token、Cookie 或私有正文 |
| 回退 | 能恢复上一步状态 | 修改不可逆且没有备份 |
|
|
表格中的停止信号一旦出现，先撤销本节改动，不要继续后面的自动化。
多 Provider 同时存在时如何选默认模型
围绕“多 Provider 同时存在时如何选默认模型”准备一个成功样本和一个失败样本。成功样本验证正常路径，失败样本验证限制是否真的生效。
|
|
建议记录以下四项：
- 执行前的版本或 Git 提交。
- 实际输入，不记录秘密值。
- 可观察的输出、状态码或 diff。
- 恢复动作以及恢复后的复查结果。
如果失败原因仍不清楚，每次只修改一个变量；不要同时换端口、运行时、Provider 和代理。
新终端验证而不是沿用当前环境
这一节解决的是“新终端验证而不是沿用当前环境”。先记录当前状态，再执行最小动作，最后用独立证据确认结果。
对 jcode 而言，判断依据是：jcode 能发现多种已有 CLI 凭据，但凭据复用不等于复制文件；应先判断 Provider 是否能非交互工作，再决定登录路径。不要在这个阶段顺手打开更多权限。
|
|
执行后保留命令输出和时间戳。若输出依赖当前终端里的临时变量，打开新终端复查一次。
避免把刷新令牌写入日志
按下面顺序处理：
- 读取实际版本和当前配置。
- 只改变与本节相关的一项设置。
- 运行一个只读或可撤销的请求。
- 检查日志、退出码和最终文件。
- 失败时恢复刚才那一项修改。
|
|
这里的完成标准不是界面出现，而是“避免把刷新令牌写入日志”有可重复结果。
迁移失败时恢复原 CLI
| 要检查的内容 | 合格表现 | 需要停止的信号 |
|---|---|---|
| 迁移失败时恢复原 CLI | 输入和输出范围明确 | 自动扩大到其他项目或账号 |
| 权限 | 只获得完成任务所需权限 | 要求管理员权限或完整密钥 |
| 日志 | 能定位失败且已经脱敏 | 出现 Token、Cookie 或私有正文 |
| 回退 | 能恢复上一步状态 | 修改不可逆且没有备份 |
|
|
表格中的停止信号一旦出现，先撤销本节改动，不要继续后面的自动化。
多会话使用前的安全检查
围绕“多会话使用前的安全检查”准备一个成功样本和一个失败样本。成功样本验证正常路径，失败样本验证限制是否真的生效。
|
|
建议记录以下四项：
- 执行前的版本或 Git 提交。
- 实际输入，不记录秘密值。
- 可观察的输出、状态码或 diff。
- 恢复动作以及恢复后的复查结果。
如果失败原因仍不清楚，每次只修改一个变量；不要同时换端口、运行时、Provider 和代理。
本地 Embedding 与内存占用
这一节解决的是“本地 Embedding 与内存占用”。先记录当前状态，再执行最小动作，最后用独立证据确认结果。
对 jcode 而言，判断依据是：jcode 能发现多种已有 CLI 凭据，但凭据复用不等于复制文件；应先判断 Provider 是否能非交互工作，再决定登录路径。不要在这个阶段顺手打开更多权限。
|
|
执行后保留命令输出和时间戳。若输出依赖当前终端里的临时变量，打开新终端复查一次。
浏览器工具单独授权
按下面顺序处理：
- 读取实际版本和当前配置。
- 只改变与本节相关的一项设置。
- 运行一个只读或可撤销的请求。
- 检查日志、退出码和最终文件。
- 失败时恢复刚才那一项修改。
|
|
这里的完成标准不是界面出现，而是“浏览器工具单独授权”有可重复结果。
Swarm 多会话避免修改冲突
| 要检查的内容 | 合格表现 | 需要停止的信号 |
|---|---|---|
| Swarm 多会话避免修改冲突 | 输入和输出范围明确 | 自动扩大到其他项目或账号 |
| 权限 | 只获得完成任务所需权限 | 要求管理员权限或完整密钥 |
| 日志 | 能定位失败且已经脱敏 | 出现 Token、Cookie 或私有正文 |
| 回退 | 能恢复上一步状态 | 修改不可逆且没有备份 |
|
|
表格中的停止信号一旦出现，先撤销本节改动，不要继续后面的自动化。
卸载后保留原 Provider 登录
围绕“卸载后保留原 Provider 登录”准备一个成功样本和一个失败样本。成功样本验证正常路径，失败样本验证限制是否真的生效。
|
|
建议记录以下四项：
- 执行前的版本或 Git 提交。
- 实际输入，不记录秘密值。
- 可观察的输出、状态码或 diff。
- 恢复动作以及恢复后的复查结果。
如果失败原因仍不清楚，每次只修改一个变量；不要同时换端口、运行时、Provider 和代理。
jcode 常见问题
是否可以跳过测试环境，直接把 jcode 用到正式项目？
不建议。至少先完成一次最小成功请求、一次故意失败和一次恢复演练。
jcode 命令能运行但结果不对，先查哪里？
先查输入范围、实际生效的配置和上游响应，再查模型总结。进程正常不代表业务结果正确。
如何避免 jcode 的密钥或令牌进入 Git？
使用系统环境变量、Secret 管理或项目外配置文件，并在提交前搜索 diff。发现泄露后必须轮换密钥。
升级 jcode 时最容易漏掉什么？
最容易漏掉配置格式、默认监听地址、权限范围和缓存兼容性。升级前保存版本与验证样本。
jcode 验收问题
完成后应能回答下面的问题：
- 使用的是哪个确切版本？
- 哪些目录、端口、账号和外部服务可被访问？
- 成功结果如何回到原始数据或 Git diff？
- 上游失败时会报错、重试还是切换？
- 密钥是否可能出现在日志或历史记录？
- 如何在十分钟内回到修改前状态？
如果其中任何一项无法回答，jcode 仍处于试用状态，不应扩大权限或接入生产自动化。