AI工具的使用

SeanTim0404

254人浏览 · 2026-09-08 11:29:23

SeanTim0404 · 2026-09-08 11:29:23 发布

一、安装WSL

1、搜索栏搜索启用或关闭Windows功能

五、DeepSeek Harness的启用

一、安装WSL

1、搜索栏搜索启用或关闭Windows功能

2、勾选如下两个选项

3、WSL命令安装

①管理员身份进入cmd

Win+R输入cmd，按Ctrl+Shift+Enter进入

②安装ubuntu

wsl --list --online：查看可用发行版列表

wsl --install -d Ubuntu：等待安装

wsl -l -v：查看已安装的发行版及其 WSL 版本

③升级为wsl 2

下载并安装内核更新包，访问微软官方链接：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

下载 wsl_update_x64.msi 文件。

下载完成后，双击运行它，按提示完成安装。

内核组件安装完成后，重新打开一个 CMD 窗口，执行转换命令：

wsl --set-version Ubuntu 2

将 WSL 2 设为默认架构，方便以后安装的新发行版直接使用 WSL 2：

wsl --set-default-version 2

④输入wsl进入linux

二、安装Node.js

Node.js — 下载 Node.js®

输入wsl进入linux后开始安装node.js

1、查看所有可用的 24.x 版本

nvm ls-remote | grep v24

2、安装具体的版本号

nvm install v24.20.0

3、验证 Node.js 版本

node -v # Should print "v24.20.0".

4、验证 npm 版本

npm -v # Should print "11.19.0".

三、安装Codex CLI

继续在wsl环境下安装，模型的安装需要自己可提供的模型

1、全局安装

npm install -g @openai/codex@latest

2、安装完成后，验证版本

codex --version

3、创建config.toml

在~/.codex目录下创建config.toml，写入数据

cat > ~/.codex/config.toml << 'EOF'
model_provider = "duckcoding"
model = "gpt-5.6-sol"
model_reasoning_effort = "ultra"
network_access = "enabled"
disable_response_storage = true

[model_providers.duckcoding]
name = "OpenAI"
base_url = "https://api.duckcoding.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

4、创建auth.json

在~/.codex目录下创建auth.json，写入数据

cat > ~/.codex/auth.json << 'EOF'

{
"OPENAI_API_KEY": "粘贴为CodeX专用分组令牌key"
}

EOF

5、启动

codex

四、Codex的使用

Codex 进阶使用技巧 | 菜鸟教程

1、AGENTS.md文件

AGENTS.md：Codex的记忆文件

一份有效的 AGENTS.md 通常包含四类信息：项目概述、技术栈、重要约定和禁止事项。

2、关键词命令

① 每次开启一次新对话的时候输入如下关键词：

阅读AGENTS.md了解项目，遵守AGENTS.md中的“约定与规则”。必须遵守的规则：“在新增或修改的的代码中一定要加上中文注释，只加上注释不用加“中文注释：”！文件行尾序列使用CRLF不要使用LF！不用构建和测试！代码风格使用 Allman 大括号风格！（左大括号另起一行）不要自己更新AGENTS.md文件！编码格式统一为UTF-8且无BOM”。新增/修改的功能：。。。，给我一个设计方案。

② 每次在一个新增/修改的功能上测试没有问题，功能完善，才去更新AGENTS.md：

把新增/修改的功能同步到AGENTS.md文件中，下次修改功能的时候不要自己更新AGENTS.md文件。

③ 创建一个全新的项目，从0开始编写代码，输入如下关键词：

阅读AGENTS.md了解项目，遵守AGENTS.md中的“约定与规则”。必须遵守的规则：“在新增或修改的的代码中一定要加上中文注释，只加上注释不用加“中文注释：”！文件行尾序列使用CRLF不要使用LF！不用构建和测试！代码风格使用 Allman 大括号风格！（左大括号另起一行）不要自己更新AGENTS.md文件！编码格式统一为UTF-8且无BOM”。项目采样的技术：C++语言和QT的界面设计，新建.ui文件设计UI界面，使用Cmake进行项目的编译。新增/修改的功能：。。。，给我一个设计方案。

3、Plan mode

shift+tab进入Plan mode模式。

什么是Plan mode模式？

它是 Codex 的一个专门用来“先规划，后动手”的工作模式。开启后，Codex 会进入一个“规划者”角色。它的任务不是直接写代码，而是通过分析你的项目、提出澄清问题，和你一起把需求变成一个非常详细、可以直接交给另一个工程师去执行的实施方案。

4、Codex的更新和回退

更新：

更新版本不好，回退版本：

查看历史版本列表：npm view @openai/codex versions --json

安装指定版本：npm install -g @openai/codex@<version>（将 <version> 替换为你想回退到的版本号）

我个人认为稳定好用的版本：

五、DeepSeek Harness的启用

cmd终端运行命令：npx @deepseek-ai/dsh web

六、Codex接入DeepSeek

接入 Codex | DeepSeek API Docs

1、创建模型目录文件 ~/.codex/models.json，向 Codex 声明 DeepSeek 模型的元数据。

2、编辑 Codex 配置文件 ~/.codex/config.toml（不存在则新建）。

中转站提供deepseeek：

修改auth.json文件的密钥。

七、一些Linux的命令和问题

对file.txt文件覆盖写入内容，用 << 加一个结束标记：

cat > file.txt << EOF
hello
world
EOF

对file.txt文件追加写入内容：

cat >> file.txt << EOF
new line
EOF

vi编辑器不能复制粘贴：

编辑配置文件，把鼠标模式关掉。

# 打开默认配置（路径可能因版本而异）
sudo vi /usr/share/vim/vim91/defaults.vim

# 找到 set mouse=a 这一行，改成：
set mouse-=a

vi编辑器的退出命令：

命令	保存	退出	说明
`:q`	❌	✅	未修改时退出
`:q!`	❌	✅	强制退出，放弃修改
`:w`	✅	❌	只保存，不退出
`:wq`	✅	✅	保存并退出

八、AGENTS.md模板

1、版本1：程序员版（专业开发场景）

适合日常项目开发、代码调试、工程重构等场景，规则严谨贴合开发规范。

## 编码前思考
- 明确假设，不确定时询问而非猜测。
- 存在歧义时，列出多种解释，不默默选定单一方案。
- 如果任务有明显更简单的做法，直接指出优化思路。
- 发现代码矛盾、逻辑不一致时及时暂停，请求信息澄清。

## 简洁优先
- 用最少的代码解决问题，拒绝冗余实现。
- 不为一次性需求创建抽象层、复杂架构。
- 不盲目增加扩展性、可配置性，应对“未来可能用到”的场景。
- 若代码可大幅精简，主动重写优化。
- 校验标准：以资深工程师视角判断，代码若过于复杂，立即简化。

## 精准修改
- 仅修改与当前任务直接相关的代码内容。
- 不顺手优化相邻代码、注释、排版格式。
- 不重构原本可以正常运行的代码模块。
- 严格匹配项目现有代码风格，保留原有编码习惯。
- 因本次修改产生的无效导入、废弃变量，可直接删除。
- 发现项目中原有的死代码、冗余内容，仅做文字提醒，不擅自删除。

## 目标驱动执行
- 执行任务前，定义清晰、可落地的成功标准。
- 将“修复Bug”转化为：编写用例复现问题，再调试至用例正常通过。
- 将“新增校验功能”转化为：针对异常输入编写测试用例，保证全部通过。
- 将“代码重构”转化为：完成重构后，确保原有所有测试用例正常运行。
- 多步骤复杂任务，先输出简短执行计划，同时标注每一步的验证方式。

2、版本2：通用版

做了去技术化处理，除代码编写外，文案整理、内容编辑、事务处理等场景也能使用。

## 先想清楚再动手
- 遇到不确定的内容主动询问，不要主观猜测。
- 同一内容存在多种解读方向时，逐条罗列说明。
- 发现更简单高效的处理方式，主动提出建议。
- 遇到逻辑矛盾、信息缺失时及时停止，不强行处理。

## 能简单就别复杂
- 采用最简方式完成任务，不刻意增加复杂度。
- 不为“后续可能使用”额外叠加多余功能与流程。
- 内容、流程明显啰嗦冗余时，及时精简优化。

## 只改该改的内容
- 仅处理和当前任务直接相关的部分。
- 不擅自改动周边无关内容、原有格式与备注。
- 发现其他问题可以文字提醒，不要直接修改。

## 定好目标再执行
- 提前明确任务完成标准，界定“做完”的范围。
- 把单纯“执行动作”，升级为“完成动作 + 结果验证”。
- 复杂多步骤任务，先梳理步骤清单，并说明每一步的验收标准。

3、版本3：自改版

自己总结的一版，可与其它版本进行结合，整理成一个AGENTS.md文件，主要是代码编写的场景。

## AI 行为规则

### 代码风格

- **注释**：必须使用中文注释，说明代码意图
- **命名**：函数 / 变量 / 属性 / 控件 `id` 统一使用 `snake_case`（如 `listen_button`、`video_area`、`current_index`）
- **界面文案**：显示文字用 `qsTr("...")` 包裹，便于国际化
- **大括号风格**：使用 Allman 风格，左大括号必须另起一行
- **文件行尾**：源代码、界面文件、Java 文件和文档统一使用 CRLF 行尾，不使用 LF 行尾
- **编码**：统一使用 UTF-8 编码且无 BOM

### 行为约束

- **不主动编译运行**：除非用户明确要求，不要执行 `cmake`、构建或运行命令
- **不擅自重构**：不重构未修改的代码，不添加未要求的功能
- **不创建无关文件**：不主动创建 README、文档、测试文件等，除非用户要求
- **修改前先阅读**：修改任何文件前必须先 Read 该文件，理解上下文
- **保持最小改动**：只做直接请求的改动，避免过度工程化
- **不自行更新本文件**：修改功能时不要自动更新 `AGENTS.md`；仅在用户明确要求时更新

4、版本4：经验版

大佬修改版，根据大佬的经验编写的一版，也可与其它版本进行结合，主要用于代码编程、软件开发。

## 约定与规则
测试: 在代码完成之后，不用自动测试，提示我进行手动测试验证。
构建: 在代码完成之后，不用自动构建代码验证，提示我进行手动构建操作。
代码注释: 项目中的代码都用中文注释。
新增功能: 新增加的功能都优先考虑模块化，同时开发时需要给新增的功能增加中文注释（正常注释就行了，开头不用写“中文注释”四个字），严禁不加注释。
新增UI界面: 界面都写在UI文件中，尽量不要把UI和业务逻辑耦合。
代码解耦/模块化: 项目中的代码能模块化的都用模块化开发，禁止全部耦合到WLAS.cpp（主窗口文件）。
AGENTS.md 同步: 功能代码修改完成后，除非用户明确要求更新，否则不要自行修改 AGENTS.md。
不需要执行git相关功能
遇到Error editing file就分批写入文件
文件行尾序列使用CRLF，不要使用LF
中文字符串非必要禁止使用QStringLiteral