DAL Code

DeepAILab 的终端编程助手。命令是 dal，配置目录是 ~/.dal。

安装

需要 Node.js 22.19 或更高版本。

npm install -g dal-code

这是公开 npm 包，不需要任何账号。若 npmjs 不可达，可从 GitHub Release 安装：

npm install -g https://github.com/DeepAILab-Team/dal-dist/releases/latest/download/deepailab-dal.tgz

GitHub 也不可达时，内部用户可改用私有 registry：

npm config set @deepailab:registry https://git.siweibot.com/api/packages/gitea/npm/
npm config set //git.siweibot.com/api/packages/gitea/npm/:_authToken <你的 Gitea token>
npm install -g @deepailab/dal

这条通道需要 DeepAILab 的 Gitea 凭据（实测无凭据访问返回 401）， 面向内部团队与自建环境。外部用户使用 npm install -g dal-code 或上面的 GitHub 安装方式。

只把 @deepailab 这个 scope 指过去。若用 --registry 全局覆盖，npm 会把上游依赖也发往私有源并以 404 失败。

平台：macOS、Linux、Windows 通用同一个包。

开始用

dal              # 进入交互模式
dal -p "任务"    # 单次执行，输出到 stdout

首次使用先登录：在 dal 里执行 /login，走设备码流程——终端会给出一个网址和一段验证码， 在任意设备的浏览器里打开完成授权即可。服务器上没有浏览器也能登录，这正是设备码的用途。

登录后用 /model 选择模型。

更新

dal update

启动时会检查新版本，但不会自动改写你机器上的安装——真正的更新由你显式执行。

主要能力

• dal-guard：危险命令的交互审批闸。破坏性命令由 cc-safety-net 硬拦； "有风险但合理"的操作会先问你。没有可交互界面时（CI、管道）默认拒绝而不是放行。
• dal-subagent：把任务分派给并行子代理，结果回流主对话。子代理的工具调用同样过审批闸。
• dal-mcp：MCP（Model Context Protocol）客户端，配置放 .dal/mcp.json（项目级） 或 ~/.dal/agent/mcp.json（用户级）。MCP 工具一律视为不可信边界，调用前弹审批。
• /rewind：回退会话到之前的状态。
• 扩展生态：dal install npm:<包名> 安装第三方扩展。 注意扩展是任意代码执行，不是沙箱——它能读你的文件、跑命令、联网。只装你信任的。

语言

界面支持中英文。/lang zh 或 /lang en 切换，也可用 DAL_LANG 环境变量。 默认跟随系统 LANG。

隐私

DAL 会发送匿名使用统计（会话、模型选择、工具成败、崩溃）， 不包含你的提示词、代码、文件路径、仓库名或 MCP 服务器名。

关闭方式任选其一：

/telemetry off          # 在 dal 里执行，永久关闭
export DAL_TELEMETRY=0
export DO_NOT_TRACK=1

CI 环境下默认不上报。完整说明见 PRIVACY.md。

环境变量

前缀是混合的，这里如实列出：DAL 自有的用 DAL_，从上游基座继承的仍是 PI_。

| 变量 | 作用 | |---|---| | DAL_CODING_AGENT_DIR | 覆盖 ~/.dal/agent 配置目录 | | DAL_CODING_AGENT_SESSION_DIR | 覆盖会话存放目录 | | DAL_LANG | 界面语言（zh / en） | | DAL_TELEMETRY | 设为 0 关闭匿名遥测 | | DO_NOT_TRACK | 设为 1 关闭匿名遥测（跨厂商通用约定） | | DAL_API_BASE | 覆盖网关地址 | | DAL_AUTH_ISSUER | 覆盖 OIDC 签发方 | | PI_OFFLINE | 禁用启动时的全部网络操作 | | PI_EXPERIMENTAL | 打开实验特性 |

许可证

MIT。DAL Code fork 自开源项目 Pi （Copyright © 2025 Mario Zechner，MIT）。完整署名见随包分发的 LICENSE 与 NOTICE。

问题反馈

https://github.com/DeepAILab-Team/dal-dist/issues