# @dench\.com/cli 中文文档规范地址：https://npmcn.com/package/%40dench.com/cli/ 版本：3\.11\.59 npm 元数据更新时间：2026-11-04T18:47:03.708Z 中文译文更新时间：2026-11-11T22:31:54.429Z 软件包许可：未声明本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。原始 npm 页面：https://www.npmjs.com/package/%40dench.com/cli 原文对照：https://npmcn.com/package/%40dench.com/cli/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：3.9 MB，105 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20\.0\.0 - 运行依赖：4 个 - 首次发布：2026-05-01T23:59:32.611Z - 最新版本发布：2026-11-04T18:47:03.558Z - 近 30 天下载量：11095（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：215（近 12 个月 215 个） ## 中文简介 Dench代理工作空间CLI. ## 安装 ```sh npm install @dench.com/cli ``` 也可以使用：`pnpm add @dench.com/cli`、`yarn add @dench.com/cli`、`bun add @dench.com/cli` ## README # 脱氧核糖核酸 Dench代理工作空间的CLI特工. ## 使用量运行不安装。 npm 软件包是 `@dench.com/cli`但二进制它的安装命名 `dench`,所以总是引用它作为 `npx -y -p @dench.com/cli dench `。一个赤裸的 `npx -y @dench.com/cli ` 将会失败,因为 `npx` 寻找垃圾桶匹配软件包上一个路径段(`cli`)没有. ```bash npx -y -p @dench.com/cli dench signin --name "AI Agent - Billing Repo" ``` 或在全球安装: ```bash npm install -g @dench.com/cli dench signin --name "AI Agent - Billing Repo" ``` `--kind` 接受任意字符串。建议数值: `claude_code`, (中文(简体) ), `codex`, (中文(简体) ), `cursor`, (中文(简体) ), `hermes`, (中文(简体) ), `openclaw`,或任何诸如 `aider`, (中文(简体) ), `goose`,或 `some_custom_agent`默认为 `other` 当省略时。价值观正常化到发送前的小写蛇大小写(例如). `--kind "Claude Code"` 变成 `claude_code`) (中文(简体) ). 默认后端是 `https://dench.com` (生产)。使用 `dench backend` 切换: ```bash dench backend show dench backend set production dench backend set staging dench backend set local # http://localhost:3000 dench backend set https://example.com # custom URL dench backend clear # revert to production ``` 对于一发覆盖( 无配置更改) : ```bash dench --prod dench --staging dench --backend local dench --host https://example.com DENCH_HOST=https://example.com dench ``` 平滑设置流为: 1. 运行 `dench signin --name "AI Agent - Billing Repo"` 一次一次吗. 2. 让CLI打开审批链接. 如果不行,请人类打开打印链接并确认电子邮件/工作空间。使用 `--no-open` 打印链接而不打开它. 3. 运行 `dench status --mine --json` 财务报告和审定财务报表 `dench crm entries list task --json` 以验证设置。任务作为客户关系管理进行直播 `task` 条目——没有单独的 `dench tasks` 命令. CLI 为以后的命令自动选择已核准的会话. 安装完成后,两个核查命令都有效,你知道选择哪个 Dench 代理/会话 . 批准在人类浏览器中发生, 使用当前选中的 Dench 工作空间。人类在批准前,应转换到预定的工作空间. CLI尽可能自动打开批准链接. 如果打开失败, 手动使用打印链接. 如果已经存在多个会话, 请不要再次登录以修正模糊性并做而不是悄悄猜测从最新的时间戳,代理名,或类型。清单会话问人类用哪段 ```bash dench sessions dench use ``` 用人能读的 `DENCH_SESSION_KEY` 只有在长生不老时才签到特工或当人类要求稳定身份时: ```bash DENCH_SESSION_KEY=billing-repo-agent dench signin --name "AI Agent - Billing Repo" DENCH_SESSION_KEY=billing-repo-agent dench status --mine --json ``` 未设置 `DENCH_SESSION_KEY` 向诸如 `auto:...` 或者说 `explicit:...`。。。 . 这些是内部范围: `dench sessions`; 用 `dench use ` 换句话说. `dench logout` 只删除此本地代理的当前选中会话上下文。其他被保存的会话仍然可以被未来的聊天所再用. 要删除错误的本地会话, 运行 `dench logout --session `启用 `dench logout --all` 只有在您想要清除每个本地的 Dench 会话时. 在设置期间不创建或编辑本地代理内存文件。使用 Dench 记忆只当人类问及或保存稳定的工作空间事实时. 任务作为客户关系管理进行直播 `task` 条目——没有单独的 `dench tasks`, (中文(简体) ), `dench task`, (中文(简体) ), `dench claim`,或 `dench log` 命令。通过 `dench crm entries create task --data '{"Name":"…","Status":"To Do"}'` 只有在人类指派持久工作或协调从中得益的情况下跟踪条目(确认字段名称 `dench crm fields list task` 第一——拒绝未知字段)。对于临时请求,直接工作. 使用 `dench context` 当你需要知道你是谁, 哪个工作空间你正在使用, 连接的应用程序, 和最好的下一个命令。添加 `--json` 用于结构化输出. ## 过去聊天线索浏览和搜索此工作空间( own +) 中的用户过去聊天线索页:1 当用户提及时, 用于调取上下文他们之前讨论过的事情共享聊天带使用相同的CLI 命令通过它的执行工具; 没有单独的仅代理聊天历史命令家族. ```bash dench chat list [--query ] [--limit N] [--include-archived] [--json] dench chat search "" [--limit N] [--json] dench chat read [--limit N] [--json] ``` 可见范围:只有当前用户创建的线程外加线程在同一组织内 `shared`。。。 . `dench chat search` 是一个关键字全文搜索到过去信件文本 —— 选择上次聊天会使用的具体符号(文件路径、产品名称、出错字符串)而不是句法. 在一个沙盒里, `dench chat` 用途 `DENCH_API_KEY` + 键 `DENCH_RUN_ID` 自动; 本地, 运行 `dench signin` 先说. ## 计费新的工作空间在启动者学分之前验证预防虐待的卡片页:1 查证卡不收费给人. 接收新工作空间 5元为起步AI入分,自动超龄默认残疾. 请检查access-date=中的日期值 (帮助) : ```bash dench billing status --json ``` 创建供人类付费的顶级链接 : ```bash dench billing topup --amount 5 --json ``` 在 Strade 返回成功之前不要声称补上成功, 或者 `dench billing status --json` 显示新的信用. ## 外部应用程序列出连接的应用程序 : ```bash dench integrations --json ``` `dench integrations` 是用于 `dench tool status` 没有工具包. 其他工具命令 : ```bash dench tool status [toolkit] --json dench tool connect --json dench tool search "list recent gmail emails" --toolkit gmail dench tool run --args '{"key":"value"}' --json ``` `dench tool connect gmail`, (中文(简体) ), `outlook`, (中文(简体) ), `linkedin`,以及 `calendar` 打印使用与网络相同的应用程序、范围和召回的登录链接应用 `dench signin` 或使用成员拥有的 Dench API 键,然后打开返回链接以授权您的账户。新建邮箱和链接连接默认是私有的。只有组织的密钥不能拥有个人联系. 检查结果为 `dench tool status --json`。。。 . `calendar` 显示谷歌和展望日历; `google-calendar` (单位:千美元)`googlecalendar`和 `outlook-calendar` (单位:千美元)`outlookcalendar`, (中文(简体) ), `microsoft-calendar`)选择一个提供者. 这些状态检查使用Dench自己的连接状态,不需要网关密钥. 其他工具包作为连接的应用程序连接. `--callback-url` 仅支持用于连接的应用程序; Dench 连接的账户使用 Dench 管理的回调. 在JSON中,每个连接有一个 `source` 联合国 `app` 或者说 `dench`,以及 `nativeAvailable: false` 表示无法检查连接到的账户 . 从紧凑开始 `dench tool search` 输出。上面列出了排行榜上的工具, 工具包、连接状态和只读/写提示。添加 `--json` 仅在您需要完整的原始策略或确切的论证细节. 通过 Dench 直接运行清晰的只读信息检索工具。这个包括含有 `FETCH`, (中文(简体) ), `GET`, (中文(简体) ), `LIST`, (中文(简体) ), `SEARCH`, (中文(简体) ), `READ`,或 `FIND`, (中文(简体) ), 例如 `GMAIL_FETCH_EMAILS`数字 : ```bash dench tool run GMAIL_FETCH_EMAILS --args '{"max_results":10}' --json ``` 任何其它动作在连接的应用程序运行后立即进行; Dench 没有批准步骤,所以确认它与人类第一除非他们要求它. 对于Gmail和其他电子邮件工具,请安全总结. 首选元数据与片段. 不重复 OTP 代码、安全代码、密码、令牌、 API 密钥或秘密从电子邮件机构。非杰森语 `tool run` 显示可能的敏感代码; `--json` 对需要的个案保留原始提供者的响应. 运行 `dench tool --help` 或者说 `dench integrations --help` 命令帮助. 用于装入 : ```bash dench signin --staging dench signin --host https://staging.dench.com ``` ## 已保存的前景列表查找支持单独的过去资历和配置/工作描述过滤器 . 过去的资历可以与过去的雇主不同:前雇主创建了单独启动的微软工程师可以匹配两者. 创建者包括"共同创始人";"创建团队"和"C级"是独立的选择. 企业业务重点不同于合法公司类型. ```bash dench leads find --titles "CTO,VP of Engineering,Director of Engineering" \ --headcount "51-200,201-500,501-1000" --company-keywords "SaaS,B2B,Cloud" \ --past-company-names "Apple,Microsoft,Google,Alphabet,Amazon,Nvidia,Meta,Facebook,Tesla" \ --profile-keywords "AI infrastructure,Cloud migration,DevOps" \ --locations "California,Washington,Oregon,British Columbia" \ --past-seniorities "Founder" --limit 25 --json ``` 这些字段也可以在Find的可编辑过滤器中找到, `search_people`, (中文(简体) ), 还有API. `dench leads filters --filter past-seniorities` 列出选择. 描述使用单词匹配;缺失的证据不匹配. 候选人限定条件,在返回续签时继续拨号, 包括空页后。公司焦点需要另一个候选过滤器. 发现的人 `dench leads find` 保留在清单草案中,而不是客户关系管理. 产生的结果, `--save-as` 搜索,以及 `dench lists save` 未公布单击之前 **保存列表** 在聊天或寻找中。这保存了同样的文物标识, 行和评论,然后将列表添加到Find Leads和所保存列表目录. 增加联系人或明确进口人员不公布草案. 没有元数据草稿的现有清单仍然保存. 关于新的前景发现,牵头调查技能为: `/workspace/ORGANISATION.md` 不创建 `ICP.md`。当前请求覆盖该摘要。结果是一个保存的列表 . 普通网络、公司或雇用研究不需要牵头调查或比较方案问、读或评分。比较方案没有强制性的逐一决定. 在“查找”中,单击 **查找** 在工作电子邮件、电话或个人电子邮件单元格中请求该字段。控制披露信用使用; 查询直接开始. 不同的人同时运行; 等待一个人的当前搜索前开始另一个字段。细胞会发光 **丰富**,然后显示返回值或 **未找到**。标题播放所选目标配置文件,或全部保存的列表当没有选中时, 并在线确认信用. 散装进度会暂时浮出水面,完成后会消失,包括漏出. 联系结果仍在列表中;其他栏目仍在视图设置中. ```bash dench leads find --titles "VP Sales" --save-as "Q3 targets" --json dench lists save --title "10 RevOps leaders" --people-file /tmp/shortlist.json --json # Click Save list in chat or Find before looking it up in the saved directory. dench lists --search "Q3 targets" --limit 25 --json dench lists rows --enrichment enriched --limit 100 --json dench lists rows --enrichment enriched --limit 100 --cursor --json ``` `lists save` 取一个非空 JSON 阵列的人行(`name` 或者说 `fullName` 将选定的发现合并到新的清单中不搜索、丰富或导入CRM行。它留下了源列表不变。可选 `--filters-json` 存储标准/源证据元数据. 在聊天中,明确列出最后清单;研究批次仍在活动细节而不是成为相互竞争的结果. 分红是可选的,并且只有在用户询问时才会进行. 仍有节省的摊款可用列表中读取和 CSV 导出 **比较方案适合** 财务报告和审定财务报表 **为什么这个线索** 列为暂时隐藏在"查找"中. 分数不是转换概率或客户关系管理状态。将评估用于犬科返回行数 `lists rows`,创建 JSON 阵列 `{row, suggestion: {fit, score, reason}}` (每个文件1至100个项目): ```bash dench lists assess --assessments-file /tmp/icp-assessments.json --json ``` `fit` 实值 `likely_fit`, (中文(简体) ), `unlikely_fit`,或 `unknown`· ; `score` 是一个整数从0到100。 CLI 在撰写和部分报告前验证文件失败; 重试更新现有评估。重读行以校验每行保存分数和理由。在评估之前,旧情况没有保存分数. 目录和行读取返回 `page`, (中文(简体) ), `continueCursor`,以及 `isDone`。。。 . 目录/ 搜索只显示保存列表; 行读也接受草稿的 ID . 即使通过已过滤的空页也跟踪光标。名单在新的聊天中幸存; 读取新行和联系人,而不是旧的笔录或CSV。每行原为零 `index`富足意味着联系人被退回, 不只是检查完成。永远不要重新提交待职/不确定的工作. 仅在用户明确要求导入所选配置文件时 : ```bash dench artifacts import --to lead --rows 0,4,9 --status "Contacted" --view "Q3 outbound" --pin ``` 输入的正是这些原始指数和已知的联系人,并重用现有的 CRM记录. 先检查实际的铅状态选项. 奥米 `--status` 以保留默认新建; 使用 `--enrichment enriched` 用于接通行. 浓缩是明确进口品的可选选择。仅导入设置状态, 甚至合格:它从不购买联系人,发送联系人,或转换记录. 见 `lead-finding` 技术与 [销售管道播放本](https://dench.com/references/SALES.md)。。。 . ## 外联活动 `dench campaign` 在外联运动(外联)中运行电子邮件+链接活动网页),从终端,从简介到发布:搜人包含过滤器和排除, 从搜索、 CSV、已保存列表、 CMM 视图中添加或一次一个,写出步骤和AI写行,预览准确信息,检查准备,发射, 并跟踪答复. `` 是一个 iD或一个准确的,对案件不敏感的名字. 确认 `dench campaign help` 列表 `draft`, (中文(简体) ), `search`, (中文(简体) ), `add`, (中文(简体) ), `steps`, (中文(简体) ), `person` 财务报告和审定财务报表 `preview`它需要一个工作空间成员全权证书`dench signin`),用于搜索的有薪工作空间,以及连接的发件人账户`dench campaign accounts` 清单. ```bash dench campaign accounts --json # email + LinkedIn sender ids, warm-up, availability and capacity dench campaign draft --name "Founder outreach" --request-id founders-q4 --timezone America/Los_Angeles --window "Mon-Fri 9-18" --daily-cap 30 --email-mailboxes , --linkedin-accounts dench campaign search --filters '{"titles":["Founder"],"locations":["United States"]}' --not-industries "Staffing and Recruiting" --limit 25 --out audience.json dench campaign add --people-file audience.json dench campaign steps set --file steps.json dench campaign personalize set --file lines.json dench campaign preview --person "Ada Lovelace" dench campaign launch --check dench campaign launch --ack-linkedin-risk dench campaign get # status, schedule, funnel, Now/Next, holds, people dench campaign replies --since 7d dench campaign people --status paused dench campaign events dench campaign pause|resume|archive dench campaign stop --person ``` `dench campaign create --name "Founder outreach"` 做同样的草案作为 `draft` (这也需要 `--request-id`,所以重试返回相同的页:1 每人返回1%的搜索费用,并尽量打印运行前的成本; `add --people-file` 增加那些没有搜索的人再来一次填补竞选的其他方式: `add --csv people.csv`, (中文(简体) ), `--list ` (保存的查找列表), `--search ''` (搜索并在一个账单中添加), `--object lead --view "Q3 targets"`, (中文(简体) ), `--object people --entries ,`, (中文(简体) ), 或者说 `--email ada@example.com` 为了一个人. `--not-industries`, (中文(简体) ), `--not-titles`, (中文(简体) ), `--not-domains` 以及其它问题 `--not-` 旗帜离开查找中值. 一场运动最多容纳了300人, `dench campaign duplicate ` 编写新的草案,步骤、时间表和发件人相同,没有搜索的下一页输入副本。解决错误草稿与 `dench campaign remove --person ` 或者说 `dench campaign person set`· ; `dench campaign sync` 绘制新的联系方式从CRM记录. `steps set` 取代每一步,只负责起草; `steps edit --file steps.json` 更改一个步骤的文本并等待到位, 也发射后. `launch --check` 从不发射: 它列出每个阻塞器, 并带有命令修改它,并在被封锁时退出 1。时间表、每日上限和 stop- on-reply 保留可编辑 `dench campaign set`。每个命令需要 `--json`从阅读简报到监测发射的完整指南, 包括《京都议定书》 `steps.json` 形状和 `--window` 光谱,是 `references/CAMPAIGNS.md` (单位:千美元)`dench campaign help` 旗帜列表). `dench email multichannel` 以更少的控制驱动同样的运动. 使用 `--email-mailboxes` 编号 : `--linkedin-accounts` 活动发送者池 (每个频道最多可访问账户50个). 接受逗号分隔的代号或 a JSON 阵列; 省略一面旗来保存, 或是通过 `none` 编号 : `'[]'` 来清理它. API 字段 : `emailMailboxAccountIds` 编号 : `linkedinAccountIds`. 集合运动省去每步发送者 ID; 遗留步骤直到转换。仍然发射检查可用性,每个对话都保留其原始发送者. `dench campaign accounts --json` 发现信箱和链接账户,包括未使用的发送者。只有代理会员的私人和工作空间共享连接被列出; 提供者证书永远不会已经返回。链接概述 `linkedinAccountId`,显示/所有者标签, 可用性, `remainingToday` (邀请/信息/简介)和 `remainingInvitesThisWeek`。能力是账户-本地使用前的快照排队工作和竞选限制;今天的邀请也尊重周封. API 等效为 `GET $DENCH_API_BASE/campaigns/accounts/linkedin`。。。 . 外联需要一名工作空间成员证书(a) `dench signin` 届会,a 成员 `DENCH_API_KEY`或代理会话) 被拒绝. ## 工作空间文件和可重复使用的设置使用 `dench files` 用于保存的工作空间文档和 `dench stage` 产出. 节奏每个任务都有一个单独的抓取目录. 旧文件系统和 home-sync 守护进程是遗留的相容性基础设施;不需要它们以执行命令或恢复已保存的环境. ```sh dench files cat /reports/example.md dench env list --json dench env save openai-report --path ./openai-report --json dench env show openai-report --json dench env run openai-report -- node report.mjs dench secrets set OPENAI_API_KEY --stdin < /private/path/key.txt ``` 需要保存目录 `dench-env.json`, (中文(简体) ), `SKILL.md`,一个明确的文件允许列表和核查命令。它建立附属性一次,发布一个准备修改,并重新使用已准备好的快照或相容捆绑。只有选中的环境已装入。机密被单独加密并注入到执行程序;它们从未成为附属档案或记忆事实. 新的自动化运行选择最新的即时修订; 活动任务及其儿童保留已解决的修订案。国家因工作或自动化而孤立除非选择明确的共享状态密钥。国家写作和刷新证书文件使用比较和设定版本;冲突不重放业务操作。旋转证书而不重排软件包 . 在不同的本地 OS/ 运行时间, 明确准备单独的平台缓存一次使用 `dench env run openai-report --prepare-local -- node report.mjs`。。。 . 正常的已准备运行从不引用软件包安装器。本地执行人提供单独的目录,而不是操作系统隔离. 见 [环境参考](https://dench.com/references/ENVIRONMENTS.md) 包括清单、冷启动费用、可变状态和回收收据。使用 `dench memory search/save` 对事实和喜好, `dench context set` 页:1 常设背景,以及 `dench secrets` 证书。一个老记忆声称无法替换成功的存储收据. ## Sandbox / API 密钥认证( 否) `dench signin` (所需) 在Dench沙盒内,当环境沙盒开始。何时 `DENCH_API_KEY` 正在显示, CLI 跳过 `dench signin` 全部流出并使用密钥作为每个 org 瞄准镜的载人符命令 - `dench crm`, (中文(简体) ), `dench files`,以及其他工作空间操作。这个选定连接决定后端; 主机证书保留范围授权的工作空间和工作. ```bash export DENCH_API_KEY=dench_pk_live_… # Optional but enables nicer URLs in CLI output: export DENCH_API_URL=https://app.dench.com export DENCH_ORG_ID=… export DENCH_ORG_SLUG=… dench crm entries list people ``` 自动优先 : 1. 一个当地储存的 `dench signin` 当前后端的会话(通过 `dench backend`, (中文(简体) ), `--host`, (中文(简体) ), `--prod`,或 `--staging`· ; `DENCH_HOST=` 对一个命令也一样. 2. `DENCH_API_KEY` (散装箱/自动化路径). 没有保存会话的普通终端使用或 `DENCH_API_KEY` 返回时 `login_required`。。。 . 需要冒充特定代理人(例如: `dench memory`)仍然需要代理会话 (单位:千美元)`dench signin`)——统一的API密钥为org-scoped并不能说话作为单一的特工。这些命令返回一个明确的“代理会话” 在 API- key 模式中出现错误. ### 重点工作空间背景 `dench context --instructions` 阅读明确的身份、规则和工具说明, 加上文件提供/修订。它不装入业务简介, 个人简介或汇总内存。只获取任务需要的 : ```sh dench context --sections organisation,user,memory --json ``` 区域名称是 `identity`, (中文(简体) ), `organisation`, (中文(简体) ), `user`, (中文(简体) ), `memory`, (中文(简体) ), `rules`,以及 `tools`。多个名称使用一个查询。阅读从不填充配置文件或写入记忆。编辑选定上下文 `dench context set --stdin`; 旧简介别名仍为相容路径。无法共享个人 USER 上下文频道会话. `dench context --json` 保持其现有的工作空间概览. ## 常见问题 ### @dench\.com/cli 是什么？ Dench代理工作空间CLI\. ### 如何安装 @dench\.com/cli？在项目目录运行 npm install @dench\.com/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dench、dench-fs-daemon、dench-home-sync，可以用 npx dench 直接运行。 ### @dench\.com/cli 支持 TypeScript 吗？支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @dench\.com/cli 支持 ESM 还是 CommonJS？以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require 不含顶层 await 的 ES Module，更早的版本需要改用动态 import。 ### @dench\.com/cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @dench\.com/cli 可以商用吗？ @dench\.com/cli 使用未声明许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @dench\.com/cli 的下载量有多少？根据 npm 官方下载统计，@dench\.com/cli 在 2026/10/12 – 2026/11/10 这 30 天内被下载 11,095 次，日均约 370 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dench\.com/cli 还在维护吗？最新版本 3\.11\.59 发布于 2026/11/05（7 天前）；至今共发布 215 个版本，其中过去 12 个月发布了 215 个；首次发布于 2026/05/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。