登录部署

DFCode 安装、升级、企业登录、套餐查询、模型选择与故障处理（Windows / macOS / Linux）

Windows、macOS 和 Linux 都支持三种独立的安装方式。选择一种即可，不要重复执行多种方式：

方式	是否需要手动安装 Node.js	适合情况
方式一：命令行一键安装	不需要，脚本会自动检查并安装	希望快速完成安装
方式二：下载文件后运行	不需要，安装脚本会自动处理	不方便直接执行在线命令，或需要先下载、审核脚本
方式三：Node.js 与 npm 手动安装	需要	已经安装 Node.js，或希望使用标准 npm 流程

1. 选择一种安装方式

命令行脚本会检查并安装 Node.js，再安装和校验 DFCode。无需手动执行 npm 安装命令。

3.3.19 支持 macOS 的 Apple Silicon / Intel、Linux 的 arm64 / x64（glibc 与 musl）。Windows 提供 x64 包，需要 64 位系统和 x64 Node.js；Windows ARM64 通过系统的 x64 模拟运行，尚无原生 ARM64 包。

按系统选择对应入口：

Windows

Windows 上的 PowerShell 和 CMD 是两种并列的一键安装入口，任选一种即可。

PowerShell

irm http://dfcode.codes:8091/install.ps1 -TimeoutSec 120 -ErrorAction Stop | iex

CMD

for %F in ("%TEMP%\dfcode-install-%RANDOM%-%RANDOM%.bat") do (curl.exe -fsSL --connect-timeout 10 --max-time 120 http://dfcode.codes:8091/install/install_win_cmd.bat -o "%~F" && call "%~F")

如果安装过程中弹出 UAC 授权窗口，请点击是。

macOS / Linux

macOS 和 Linux 使用同一条 Unix 命令：

(dfcode_installer="$(mktemp "${TMPDIR:-/tmp}/dfcode-install.XXXXXX")" && trap 'rm -f "$dfcode_installer"' EXIT && curl -fsSL --connect-timeout 10 --max-time 120 http://dfcode.codes:8091/install.sh -o "$dfcode_installer" && test -s "$dfcode_installer" && bash "$dfcode_installer")

macOS 如果提示安装 Xcode Command Line Tools，按提示完成后重新执行命令。
Linux 如果需要 sudo 权限，请按终端提示输入密码。

运行前可打开命令中的 URL 查看脚本内容。执行后等待脚本完成，看到绿色的「环境就绪」即安装成功。安装需要联网；出现权限或网络提示时，按窗口说明处理。

2. 方式二：下载文件后运行

这种方式先把安装脚本保存到本地，再运行文件。适合不方便直接执行在线命令，或需要先审核脚本内容的情况。

Windows

PowerShell 安装器需要下载两个文件，并保存到同一个文件夹：

下载 install_win.bat —— 启动器。
下载 install_win.ps1 —— 安装程序本体。

下载完成后，双击 install_win.bat，等待安装完成：

如果 SmartScreen 提示「Windows 已保护你的电脑」，点击更多信息 → 仍要运行。
自动安装 Node.js 时可能弹出 UAC 授权窗口，请点击是。
重新下载这两个文件前先删除旧文件。浏览器可能把新文件命名为 install_win (1).ps1，而 install_win.bat 只读取 install_win.ps1，否则仍会运行旧脚本。

只使用 CMD 时，可单独下载 install_win_cmd.bat，再双击运行，或在 CMD 中执行 call install_win_cmd.bat。

macOS

下载 install_mac.sh。
打开 Terminal。如果文件保存在「下载」文件夹，执行：

bash ~/Downloads/install_mac.sh

如果文件保存在其他位置，请把命令中的路径替换为实际路径。首次运行时若提示安装 Xcode Command Line Tools，请按提示完成后重新运行脚本。

Linux

下载 install_mac.sh。该脚本也支持 Linux。
打开终端。如果文件保存在 Downloads 目录，执行：

bash ~/Downloads/install_mac.sh

如果服务器没有 Downloads 目录，请进入脚本所在目录后执行 bash install_mac.sh。

三个系统看到绿色的「环境就绪」即安装成功。Windows 安装窗口结束时不会自动关闭；如果出现红色 [X] 报错，请保留完整输出并联系支持人员，或改用方式三。

3. 方式三：手动安装 Node.js 后使用 npm

这种方式需要先手动安装 Node.js，适合已经在使用 Node.js/npm 或不希望运行自动安装脚本的情况。DFCode 最低需要 Node.js 18，新安装建议使用 Node.js 24 LTS。

3.1 安装与登录流程

使用方式一或方式二时，前两个阶段会由安装脚本完成：

图表加载中…

安装前准备：

一台可联网的电脑。
电脑系统：Windows、macOS 或 Linux。
企业账号，可访问企业登录门户。
可打开终端：Windows 用 PowerShell 或 Windows Terminal，macOS/Linux 用 Terminal。

3.2 安装 Node.js

已通过方式一或方式二安装完成的用户，可以跳过本节，直接进入第 4 章。

DFCode 需要 Node.js 作为运行环境。新安装建议使用 Node.js 24 LTS，最低要求 Node.js 18。

先检查电脑是否已经安装 Node.js

打开终端，输入：

node -v
npm -v

看到版本号后，进入第 3.3 节安装 DFCode：

v24.20.0
10.2.4

如果提示 command not found、不是内部或外部命令，或者版本低于 18，按对应系统继续安装。

Windows 安装 Node.js

Windows 推荐使用 PowerShell 或 Windows Terminal。

Windows 默认可能禁止运行 PowerShell 脚本。PowerShell 中的 npm 实际执行 npm.ps1，因此 npm -v 可能报「无法加载文件 ...\npm.ps1」。先执行这一行，无需管理员权限：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
也可以把命令里的 npm 换成 npm.cmd；.cmd 不经过脚本检查。

方式一：使用 winget 安装，推荐

在 PowerShell 中执行：

winget install OpenJS.NodeJS.LTS

安装完成后，关闭当前 PowerShell，再重新打开一个新的 PowerShell 窗口，然后验证：

node -v
npm -v

方式二：下载安装包安装

无法使用 winget 时，手动下载安装包：

打开 Node.js 官网。
选择 LTS 版本。
下载 Windows .msi 安装包。
双击安装包，按 Next 继续并保留默认选项。
安装完成后，关闭并重新打开 PowerShell。
执行 node -v 和 npm -v 验证。

Windows 终端建议

优先使用 Windows Terminal。
其次使用 PowerShell 7+。
不建议使用旧版 CMD，因为显示效果和编码兼容性较弱。
如果终端出现乱码，可执行：

chcp 65001

macOS 安装 Node.js

macOS 推荐使用 Homebrew 安装。

方式一：使用 Homebrew 安装，推荐

已安装 Homebrew 时，直接执行：

brew install node
node -v
npm -v

尚未安装 Homebrew 时，先安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程中如果提示需要安装 Xcode Command Line Tools，按提示确认即可。

Apple Silicon 芯片（M1/M2/M3/M4）用户注意：Homebrew 安装完成后，终端通常会提示将 brew 加入 PATH，例如：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

按终端提示执行，否则可能提示找不到 brew。

方式二：使用 nvm 安装

需要管理多个 Node.js 版本时，可用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zshrc
nvm install 24
node -v
npm -v

Linux 安装 Node.js

Linux 用户根据发行版选择安装方式。

Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
node -v
npm -v

CentOS / RHEL / Fedora

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs
node -v
npm -v

Fedora 也可以使用：

sudo dnf install -y nodejs

任意 Linux 发行版：使用 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 24
node -v
npm -v

3.3 安装 DFCode

已通过方式一或方式二安装完成的用户，可以跳过本节。

Node.js 和 npm 准备好后，安装 DFCode。

正常安装

Windows、macOS、Linux 都使用同一条命令：

npm install -g dfcode@latest --include=optional --registry=https://registry.npmjs.org

Windows：如果这条命令报「无法加载文件 ...\npm.ps1，因为在此系统上禁止运行脚本」，可将命令中的 npm 换成 npm.cmd，其余参数保持不变。

安装完成后验证：

dfcode --version

核对输出的版本号与安装目标一致。若提示缺少平台包、无法启动或版本不符，本次安装尚未完成。

Windows 升级时，只检查本次更新目录中的 DFCode。目标文件被占用时，安装器会显示路径和可查询到的 PID，并停止安装；其他安装目录的会话不受影响。保存工作并正常退出对应的终端、Studio 或 IDE 任务，再运行安装命令，无需卸载或清空缓存。安装器不会自动结束进程或删除历史会话。

升级后回到原项目目录，执行 dfcode -c 继续最近的会话，或启动后输入 /sessions 选择历史会话。退出前请先妥善停止正在执行的任务。

网络与镜像

镜像可能只有主包，尚未同步对应的平台包。一键安装器会先检查目标版本及平台包；镜像不完整时停止安装，日志中会列出缺失项。安装器每次运行使用独立的 npm 缓存，不会读取或清理用户的 ~/.npm。如果已有全局 DFCode 目录由其他用户创建且平台包版本不一致，安装器会改用独立的用户前缀，不覆盖原目录。不要通过改装旧版本或清空全局缓存来绕过错误。

官方源优先，版本查询、安装和重试共用 10 分钟等待时间。单次请求最多等待 5 分钟、最多重试两次；临时网络失败还会在剩余时间内再尝试一次安装。每 15 秒显示当前阶段和已用时间。

网络重试失败或超时后，依次尝试华为云、腾讯云。镜像包的版本和完整性必须通过独立的官方信息校验；校验失败则停止。文件占用、权限、空间不足和启动错误不会触发换源。

需要手动指定备用源时，先试华为云：

npm install -g dfcode@latest --include=optional --registry=https://repo.huaweicloud.com/repository/npm

华为云暂时不可用时，再试腾讯云：

npm install -g dfcode@latest --include=optional --registry=https://mirrors.cloud.tencent.com/npm

指定版本或渠道

下载相应安装脚本后，可以指定已发布版本。例如安装 3.3.19：

macOS / Linux

DFCODE_VERSION=3.3.19 bash ./install_mac.sh

Windows PowerShell

$env:DFCODE_VERSION = '3.3.19'
.\install_win.bat
Remove-Item Env:DFCODE_VERSION

Windows CMD

set "DFCODE_VERSION=3.3.19"
call install_win_cmd.bat
set "DFCODE_VERSION="

默认读取官方 latest，并保留已安装的更高版本。DFCODE_VERSION 指定安装目标，可覆盖较新版本；需要 beta 渠道时设置 DFCODE_DIST_TAG=beta，同时设置时以 DFCODE_VERSION 为准。Windows 的这些环境变量仅在当前终端会话中生效。

安装器会打印目标版本和日志位置；最终 dfcode --version 必须与目标一致。命令失败表示此次安装未完成，不要把旧版本仍能运行当作升级成功。

macOS / Linux 权限错误处理

遇到权限错误（例如 EACCES）时，可临时使用：

sudo npm install -g dfcode@latest --include=optional --registry=https://registry.npmjs.org

需要长期管理 Node.js 版本时，可用 nvm 安装；全局 npm 包通常不需要 sudo。

4. 更新 DFCode

方式一或方式二已完成目标版本安装及校验，无需紧接着再升级。

以后需要更新时，可以重新运行一键安装器。已有 npm 安装也可通过官方源升级到本次正式版：

npm install -g dfcode@3.3.19 --include=optional --registry=https://registry.npmjs.org

从 beta 切换到正式渠道时执行：

npm install -g dfcode@stable --include=optional --registry=https://registry.npmjs.org

Windows PowerShell 若拦截 npm.ps1，将命令中的 npm 换成 npm.cmd。更新完成后查看实际版本：

dfcode --version

本次升级预期输出 3.3.19。如果仍显示旧版本，先检查当前终端的 PATH 和 npm 全局目录，再查看安装日志。

CLI 也提供 dfcode upgrade，按当前安装方式和渠道更新：

5. 启动 DFCode

5.1 在当前目录启动

进入项目目录后执行：

dfcode

DFCode v3.3.19

Welcome to DFCode!Run /login or /models to get started.Press /login for enterprise MAAS, or /models to configure a provider.

Agent:: build (tab 切换)
Model:: No provider selected
Auto mode:: off
Directory:: ~

TipPermission external_directory protects files outside project

Ask anything...

Build (shift+tab 切换模式)No provider selected Connect a provider · 消耗：未知

5.2 在指定项目目录启动

macOS / Linux：

dfcode /path/to/your/project

Windows PowerShell：

dfcode D:\projects\my-app

5.3 启动后登录

启动后会进入 DFCode 终端界面，可在输入框输入自然语言或斜杠命令。

先登录：

/login

DFCode v3.3.19

Welcome to DFCode!Run /login or /models to get started.Press /login for enterprise MAAS, or /models to configure a provider.

Agent:: build (tab 切换)
Model:: No provider selected
Auto mode:: off
Directory:: ~

TipPermission external_directory protects files outside project

/login

Build (shift+tab 切换模式)No provider selected Connect a provider · 消耗：未知

6. 登录 DFCode

在 DFCode 输入框中输入：

/login

按回车后，CLI 会打开企业登录门户。浏览器未自动打开时，复制终端中的登录链接到浏览器。

6.2 在企业门户完成登录

在浏览器按门户提示完成身份验证和设备绑定，再确认授权。

授权完成后保持终端打开，等待 CLI 返回“登录成功”。CLI 最多等待 5 分钟。

6.3 登录失败时先检查什么

如果登录失败，先检查：

企业门户是否完成身份验证和设备绑定。
网络、代理和浏览器能否访问企业门户。
是否已经升级到最新版本：dfcode upgrade。
重新启动 DFCode 后再次执行 /login。

已经登录后遇到 HTTP 429、临时断网或可恢复的上游错误，3.3.18 起会保留有效凭据并退避重试，不必先 /logout。身份验证成功但模型配置或授权尚未就绪时，等待恢复后再查看 /models；只有明确提示凭据失效时才重新登录，账号被禁用时联系管理员。

7. 查看个人门户中的套餐与额度

登录成功后，按界面提示前往个人门户，查看账号和套餐信息。

7.1 查看套餐与额度信息

进入个人门户后，在同一页面确认：

当前订阅套餐名称、套餐总额和同步状态。
MAAS 今日剩余额度与下次重置时间。
高消耗模型的今日额度比例和重置时间。
今日上限、今日已用和今日剩余是否正常。

MAAS 今日额度

计费说明：模型服务页展示的是基础参考价格，实际用量会由 MAAS 计费平台结合请求资源峰值、Token 规模、缓存命中率等因素动态计算；因此今日用量不一定等于请求次数 × 单次参考价格。

高消耗模型今日余额

额度状态以企业门户的实时计算结果为准。

套餐未显示或显示异常时，先检查门户连接与授权状态，等待刷新后重试；仍有问题时联系支持人员。CLI 中 MaaS 今日额度从 3.3.18 起使用“积分”作为显示单位，额度数值和计算方式不变。

8. 回到 DFCode 并切换模型

8.1 回到 DFCode 主界面

查看套餐与额度后，回到终端里的 DFCode 会话。

DFCode v3.3.19

Welcome back!Type a message below to start a new session.

Agent:: build (tab 切换)
Model:: GPT 6 Astra · MaaS-1 · 消耗: medium
Auto mode:: off
Directory:: ~/projects/new-service

TipPermission external_directory protects files outside project

/login

登录成功，欢迎示例用户！

Build (shift+tab 切换模式)GPT 6 Astra MaaS-1 · 消耗：中

8.2 使用 /models 打开模型列表

在 DFCode 输入框中输入：

/models

DFCode v3.3.19

Welcome back!Type a message below to start a new session.

Agent:: build (tab 切换)
Model:: GPT 6 Astra · MaaS-1 · 消耗: medium
Auto mode:: off
Directory:: ~

TipPermission external_directory protects files outside project

/models

Build (shift+tab 切换模式)GPT 6 Astra MaaS-1 · 消耗：中

8.3 选择模型

打开模型列表后，按方向键选择模型，再按回车确认。

DFCode v3.3.19

Select modelesc

企业 MAAS · GPT

GPT 6 Astra

选好模型后，输入 /effort 调整推理深度，再按回车确认。可选档位取决于当前模型。

8.4 模型选择建议

使用场景	选择建议
日常问答、解释代码	选择响应快的模型（DeepSeek Flash/GLM Flash 等）
复杂需求分析、架构设计	选择推理能力更强的模型（DeepSeek Pro/Kimi for Coding 等）
大项目阅读、长文档处理	选择上下文更长的模型（Kimi K3 Max/DeepSeek Pro 等）
简单文本修改、补说明	选择成本更低、速度更快的模型（MiMo V2 Omni/Kimi K2P5 等）

不确定时先选择默认模型。模型清单以企业账号配置为准。

9. 首次提问

完成登录和模型切换后，先提出只读问题：

请解释当前项目的目录结构，不要修改文件。

请阅读 README 和 package.json，告诉我这个项目如何启动和测试。

请帮我总结当前项目的技术栈和主要模块。

确认 DFCode 能正常回复后，再修改代码或运行测试。

10. 安装与登录 QA

Q1：`node -v` 提示 command not found 怎么办？

说明 Node.js 没有安装成功，或环境变量没有生效。

Windows：关闭所有 PowerShell 窗口，重新打开后再试。
macOS/Linux：关闭终端重开，或检查 nvm/Homebrew 的 PATH 配置。
仍不行时，重新按第 3.2 节安装 Node.js。

Q2：Windows 提示 `node` 不是内部或外部命令怎么办？

通常是 PATH 没生效。处理方法：

关闭并重新打开 PowerShell。
如果仍失败，重启电脑。
重新安装 Node.js LTS，并保持默认安装路径。

Q3：`npm install -g dfcode` 很慢或失败怎么办？

先让一键安装器使用官方 npm 源。官方源长时间无响应或安装失败后，它会按华为云、腾讯云顺序检查同一版本；镜像未同时同步主包和平台包时会停止并保留日志。

Q4：安装 DFCode 时提示权限错误怎么办？

Windows 提示 EBUSY: resource busy or locked, copyfile ...dfcode.exe 时，先关闭相关 DFCode 会话后重试。只关闭页面后仍失败，可在任务管理器中查看 dfcode.exe 是否仍在运行；先保存工作并正常退出对应应用。EPERM 或 EACCES 还可能是安装目录权限或安全软件拦截，需要按实际错误排查。它们都不应通过反复换源解决。

macOS/Linux 可临时使用：

sudo npm install -g dfcode@latest --include=optional --registry=https://registry.npmjs.org

经常遇到 npm 权限问题时，改用 nvm 安装 Node.js。

Q5：安装 DFCode 时提示包/模块未找到（Could not find package）怎么办？

这通常是镜像缺少对应平台包。使用官方源并显式安装可选依赖：

npm install -g dfcode@latest --include=optional --registry=https://registry.npmjs.org
dfcode --version

安装失败时先查看日志，不要先卸载已有版本或清空整个 npm 缓存。

Q6：Windows 执行 `dfcode` 提示不是内部或外部命令怎么办？

先分清两种报错，它们的原因完全不同：

「dfcode 不是内部或外部命令」/「无法将"dfcode"项识别为…」：这是 PATH 问题，按本节处理。
「无法加载文件 …\dfcode.ps1，因为在此系统上禁止运行脚本」：这是执行策略问题，见 Q13。

PATH 问题先关闭并重新打开 PowerShell。如果仍失败，查看 npm 全局安装路径：

npm.cmd config get prefix

确认该路径已加入系统 PATH。无法配置 PATH 时，重新安装 Node.js 并保留默认路径。

用 npm.cmd 而不是 npm：如果遇到 Q13 的报错，npm 本身也无法运行。

如果使用 VS Code 集成终端：改完 PATH 后新开一个终端面板不够，需要重启 VS Code 本体（终端面板的环境变量继承自 VS Code 进程）。执行策略则相反，新开面板立即生效。

Q7：Windows 终端显示乱码怎么办？

执行：

chcp 65001

建议使用 Windows Terminal 或 PowerShell 7+。

Q8：如何确认 DFCode 已经是最新版？

执行：

dfcode upgrade
dfcode --version

Q9：`dfcode upgrade` 失败怎么办？

重新运行一键安装器，或使用第 3.3 节的官方 npm 安装命令。核对实际版本后再继续使用；失败日志中的缺包、证书或网络错误需要分别处理，不要先卸载已有版本。

Q10：`/login` 后无法登录怎么办？

按顺序检查：

企业门户是否完成身份验证和设备绑定。
网络、代理和浏览器能否访问企业门户。
是否已经执行 dfcode upgrade。
退出 DFCode 后重新启动，再执行 /login。

Q11：路径中有中文可以吗？

新版 DFCode 已改进中文路径支持，但外部工具可能仍有兼容问题，项目路径建议使用英文，例如：

D:\projects\my-app

而不是：

D:\项目\我的应用

Q12：一键安装脚本运行失败怎么办？

Windows：结束窗口不会自动关闭，先截图整个窗口内容；确认安装 Node.js 时没有拒绝 UAC 授权；没有 winget 的旧系统按第 3.2 节手动安装 Node.js。
macOS：如果弹出 Xcode Command Line Tools 安装提示，确认安装完成后重新运行脚本。
网络受限环境：脚本已内置国内镜像自动重试；仍失败时按第 3.2～3.3 节手动安装。

Q13：Windows 提示「无法加载文件…因为在此系统上禁止运行脚本」怎么办？

典型报错（中文界面 PowerShell 5.1）：

dfcode : 无法加载文件 C:\Users\你的用户名\AppData\Roaming\npm\dfcode.ps1，因为在此系统上禁止运行脚本。
    + CategoryInfo          : SecurityError: (:) []，PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

英文界面或 PowerShell 7 下是同一个问题：

dfcode : File C:\Users\...\npm\dfcode.ps1 cannot be loaded because running scripts is disabled on this system.

把 dfcode.ps1 换成 npm.ps1 也是同一个原因。

原因：npm 安装全局命令时，会在同一个目录同时生成 dfcode.cmd 和 dfcode.ps1。 PowerShell 输入 dfcode 时会优先选择 .ps1。Windows 家用版和客户端版的默认执行策略是 Restricted，允许执行单条命令，但禁止运行脚本文件。DFCode 通常已经安装完成，只是 PowerShell 未执行 .ps1 启动脚本；这与安装完整性和网络状态无关。

解决办法（复制这一行到 PowerShell 执行）：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force; dfcode --version

显示版本号后，当前窗口即可使用，无需重启终端。

关于这条命令：

只影响当前用户账户，不需要管理员权限。
RemoteSigned 会放行本机生成的脚本，从网上下载的脚本仍然必须有数字签名。 npm 生成的 dfcode.ps1 属于本机脚本，因此可以执行。
-Force 不能省。不加它会弹出确认框；默认选项是「否」，直接按回车不会修改策略。
不想敲命令的话，下载 fix_win.bat 双击运行，效果一样。

如果这条命令没有解决问题，查看报错结尾。常见情况如下：

报错结尾	原因	怎么办
……因为在此系统上禁止运行脚本	策略是 `Restricted`	上面那一行即可
……因为它未经数字签名	策略是 `AllSigned`	上面那一行通常也能解决；若是组策略下发的则不行，见下
……AuthorizationManager 检查失败	脚本所在位置被判定为网络位置（漫游配置、映射盘）	改策略无效，请用 cmd.exe 启动

确认策略到底改没改：

Get-ExecutionPolicy -List

修复后，CurrentUser 应显示为 RemoteSigned：

        Scope ExecutionPolicy
        ----- ---------------
MachinePolicy       Undefined
   UserPolicy       Undefined
      Process       Undefined
  CurrentUser    RemoteSigned
 LocalMachine       Undefined

如果 MachinePolicy 或 UserPolicy 显示 Restricted / AllSigned，说明策略由公司组策略锁定， 当前用户无法修改（这两个作用域优先级最高）。这种情况下：

改用 cmd.exe 或 Git Bash 启动 dfcode。这两个终端不经过 PowerShell 的脚本检查，无需修改策略。
或者联系 IT，说明诉求：为开发人员账户允许 RemoteSigned 执行策略，用途是运行 npm 全局安装的命令行工具。

11. 完成检查清单

完成下列检查：

适用于 DFCode 正式版

文档中心

1. 选择一种安装方式

Windows

PowerShell

CMD

macOS / Linux

2. 方式二：下载文件后运行

Windows

macOS

Linux

3. 方式三：手动安装 Node.js 后使用 npm

3.1 安装与登录流程

3.2 安装 Node.js

先检查电脑是否已经安装 Node.js

Windows 安装 Node.js

方式一：使用 winget 安装，推荐

方式二：下载安装包安装

Windows 终端建议

macOS 安装 Node.js

方式一：使用 Homebrew 安装，推荐

方式二：使用 nvm 安装

Linux 安装 Node.js

Ubuntu / Debian

CentOS / RHEL / Fedora

任意 Linux 发行版：使用 nvm

3.3 安装 DFCode

正常安装

网络与镜像

指定版本或渠道

macOS / Linux 权限错误处理

4. 更新 DFCode

5. 启动 DFCode

5.1 在当前目录启动

5.2 在指定项目目录启动

5.3 启动后登录

6. 登录 DFCode

6.1 输入 /login

6.2 在企业门户完成登录

6.3 登录失败时先检查什么

7. 查看个人门户中的套餐与额度

7.1 查看套餐与额度信息

8. 回到 DFCode 并切换模型

8.1 回到 DFCode 主界面

8.2 使用 /models 打开模型列表

8.3 选择模型

8.4 模型选择建议

9. 首次提问

10. 安装与登录 QA

Q1：node -v 提示 command not found 怎么办？

Q2：Windows 提示 node 不是内部或外部命令怎么办？

Q3：npm install -g dfcode 很慢或失败怎么办？

Q4：安装 DFCode 时提示权限错误怎么办？

Q5：安装 DFCode 时提示包/模块未找到（Could not find package）怎么办？

Q6：Windows 执行 dfcode 提示不是内部或外部命令怎么办？

Q7：Windows 终端显示乱码怎么办？

Q8：如何确认 DFCode 已经是最新版？

Q9：dfcode upgrade 失败怎么办？

Q10：/login 后无法登录怎么办？

Q11：路径中有中文可以吗？

Q12：一键安装脚本运行失败怎么办？

Q13：Windows 提示「无法加载文件…因为在此系统上禁止运行脚本」怎么办？

11. 完成检查清单

Q1：`node -v` 提示 command not found 怎么办？

Q2：Windows 提示 `node` 不是内部或外部命令怎么办？

Q3：`npm install -g dfcode` 很慢或失败怎么办？

Q6：Windows 执行 `dfcode` 提示不是内部或外部命令怎么办？

Q9：`dfcode upgrade` 失败怎么办？

Q10：`/login` 后无法登录怎么办？