从零到一份可用的 .deepcell 文档所需的一切：你所处的环境该走哪条路、如何接入，以及命令失败时该怎么办。开始之前不需要账号。
要把它交给智能体而不是自己读？同样的说明，纯 markdown 版本： /product/for-agent.md
DeepCell 有两条通往同一个服务的路径。选哪条只取决于你所处环境的一个属性——能不能执行 shell 命令。看表决定，然后只读那一节。
| 你能做什么 | 走 | 怎么判断 |
|---|---|---|
| 能运行 shell 命令 | 插件，加上它驱动的 CLI | 你有终端、Bash 或一个执行工具。Claude Code、Cowork、OpenWork、CI 任务，以及任何带沙箱的环境都算。如果你的客户端能装插件，就从插件开始——技能带着工作方法，光有 CLI 只是有了命令。 |
| 能连到 MCP 服务器，但没有 shell | MCP 服务器 | 你的宿主有「连接器」或「MCP 服务器」设置——但只有使用它的人才能改动。claude.ai、ChatGPT 和 Manus 都属于这一类。 |
| 两者都没有——只能抓取网址 | 只读 | 你可以读这个页面和别人发给你的分享链接，但无法构建。请让与你协作的人给你一个 shell，或替你添加 MCP 服务器。 |
一句话：能装插件的宿主从插件开始——插件带着技能，而技能会把 CLI 装好。否则，有 shell 就走 CLI，没有 shell 就走 MCP。如果 shell 和 MCP 都有，选 CLI——它的能力面更大，因为登录、Excel 和 PowerPoint 导出、以及完整的 clone / pull / push / commit / merge 历史都需要 MCP 服务器没有的工作副本。
如果你的宿主能安装插件，先做这一步。插件就是技能本身——告诉你的 agent 什么是 .deepcell 文档、什么算完成、怎样驱动 CLI 的那套工作指令——打包成宿主会自动加载的形式。它的技能会检查 deepcell 命令，缺失时自己运行安装脚本，所以这一步就把一切都装好了。在 Claude Code 里：
Claude Code
/plugin marketplace add deepcell-ai/deepcell-plugins
/plugin install deepcell@deepcell
/reload-plugins其他支持插件的客户端通过可移植清单使用同一个目录——DeepCell 以符合 Agent Plugins Specification v1.0.0 的插件形式发布，仓库根目录就是插件：
https://github.com/deepcell-ai/deepcell-plugins该规范没有定义安装命令，所以按你的客户端接受插件目录的方式，把它指向这个仓库即可。
宿主不支持插件？什么都不会少。下面几节手动搭起同样的访问方式，而技能的全部内容在 CLI 或 MCP 连通之后都能读到：deepcell guide orient/how-to-work。
一条命令。它在 Windows、macOS 和 Linux 上都能用；哪怕这台机器没有 pip、没有 venv 模块，或者 Python 拒绝把包装进自己，脚本也会自己处理，而不是把问题丢回给你。
macOS / Linux
curl -LsSf https://beta.deepcell.net/install.sh | shWindows（PowerShell）
irm https://beta.deepcell.net/install.ps1 | iex它会用 uv 或 pip 安装——机器上有哪个就用哪个，两个都没有就先把 uv 装上；然后找到 deepcell 命令真正落在哪个目录，把那个目录写进你的 shell 配置文件，这样下一个 shell 里它依然在；最后先运行 deepcell --version，确认没问题才报告成功。重复运行是安全的。至于你当前这个 shell，用它打印出来的那行 export，或者干脆新开一个。
不想把下载内容直接管道给 shell？那就先下载、读一遍，再运行。还是同一个脚本：
macOS / Linux
curl -LsSf https://beta.deepcell.net/install.sh -o install-deepcell.sh
less install-deepcell.sh
sh install-deepcell.shWindows（PowerShell）
irm https://beta.deepcell.net/install.ps1 -OutFile install-deepcell.ps1
Get-Content install-deepcell.ps1
powershell -ExecutionPolicy Bypass -File install-deepcell.ps1然后用一条命令检查环境。它会报告版本、服务器是否可达、你是谁、当前工作区，以及下一步该运行什么：
deepcell doctor解析结果而不是阅读它——JSON 里带一个 next_command 字段，正是为此准备的：
deepcell doctor --format json一个远程服务器，一个工具。一旦它被加到你的宿主里，每条 CLI 命令都变成用命令字符串调用那个工具。
这一步你自己做不了。它是宿主里的一项设置，工具调用够不到——所以这是本页唯一需要交给协作者去做的步骤。把下面的地址和步骤给他们，然后请他们在连接好之后告诉你。
在 claude.ai 上，这个地址会被添加为远程 MCP 服务器——登录在他们的浏览器里完成，谁都不需要粘贴密钥：
https://beta.deepcell.net/mcp在 Manus 和其他 MCP 客户端上，使用带 API 密钥的配置文件。密钥在网站的「设置 → API 密钥」中创建，以 dck_ 开头：
{
"mcpServers": {
"deepcell": {
"type": "streamableHttp",
"url": "https://beta.deepcell.net/mcp",
"headers": {
"Authorization": "Bearer <your-api-key>"
}
}
}
}然后用命令字符串调用这唯一的工具，写法和你在 deepcell 后面输入的完全一样：
guide orient/start有些命令在这里会被拒绝，因为它们需要浏览器、二进制文件或本地副本：login、logout、register、verify-email、account、to-excel、to-pptx、clone、status、pull、push、commit 和 merge。拒绝发生在执行之前，所以什么都没有改变。
你不需要账号。第一条需要服务器的命令会自行创建一个匿名会话和一个临时工作区，所以直接开始干活：
deepcell guide orient/start
deepcell ls在动手做任何正经工作之前先读这个——它就是插件所携带的那份技能，也是托管的 DeepCell agent 运行时遵循的同一套指令，讲清楚了工作是什么、什么时候算完成。如果因为宿主装不了插件而跳过了插件那一节，插件的知识就在这里：
deepcell guide orient/how-to-work然后接受一个目标和它的约束，而不是一套流程：
“根据 ./filings 里的文件，为 Acme 建一个三年期 DCF。把增长率和利润率假设放在我能改的地方，并记录每一条为什么是现在这个值。”
查，不要猜。deepcell --help 管命令和参数，deepcell guide 管格式和建模，两者都随你正在运行的版本一起安装——相信它们，而不是你的记忆。永远不要用文本编辑器改 .deepcell 文件：那会跳过计算引擎、校验和版本历史，文档正是这样开始自相矛盾的。
一个 .deepcell 文档自带四个界面——推理、表格、文稿、演示——并且会记录它们之间的连接。工作就落在那里。如果你的宿主还给了你直接编写 .xlsx、.docx 或 .pptx 的技能或工具，在这里不要用：一格一格拼出来的工作簿里存的是数值，而 DeepCell 存的是依赖关系；手写的段落里是断言，而 DeepCell 里是主张——而且这些东西彼此之间没有任何连接，所以当某个假设变了，没有任何东西可以被重新检验。
这对读者没有任何损失，因为看这份工作并不需要谁手里有这个文件。deepcell share create 会给出一个链接，在 DeepCell 网站上打开它，连接关系原样保留；deepcell to-excel、to-docx、to-pptx、to-pdf 则能从文档生成可编辑的文件——其中 to-excel --formulas 导出的是活的公式，而不是拍平后的数值。所以当有人要一份表格或一套演示时，在 DeepCell 里做，然后把导出的文件给他们。
三种状态，而你什么都不做就已经在第一种里。等命令告诉你需要时再往上走——不要提前。
| 状态 | 如何进入 | 能做什么 |
|---|---|---|
| 匿名 | 什么都不用做。第一条需要服务器的命令会创建它，并告诉你它这么做了。 | 创建工作区、写入、编辑、查询、阅读全部指南，以及分享一个最长 7 天的只读链接。这是一个临时演示工作区：闲置 30 天后会被回收，并受每分钟 60 次请求、每份文档 2 MiB、5 个智能体会话的限制。 |
| 账号 | deepcell login——新用户用 deepcell register。 | 永久存储、带编辑权限和密码的分享链接、Excel 与 PowerPoint 导出、同步命令，以及浏览器里的工作台。 |
| 已验证邮箱 | deepcell verify-email。 | 在新账号上创建工作区，以及其他需要确认邮箱的功能。注意这里的不对称：匿名会话可以创建工作区，而一个邮箱未验证的已登录账号反而不行。 |
deepcell login登录会打开浏览器并在那里完成。如果你是没有浏览器的智能体，就把网址打印出来，让与你协作的人完成它——那是他们的步骤，不是你的。
从匿名开始不会损失任何东西。登录会认领匿名期间的工作并把它迁入账号；万一失败，下次登录时会重试。
按文本匹配——下面是 CLI 和 MCP 服务器实际输出的原文。其中两行关于退出码的最重要：非零退出并不总是意味着什么都没发生。
| 你看到的 | 含义 | 怎么做 |
|---|---|---|
| Not authenticated. Run `deepcell login` first. | 匿名会话没能创建成功——服务器不可达、关闭了匿名访问，或者设置了 DEEPCELL_NO_ANON。 | 先用 deepcell doctor 确认服务器可达，然后登录。 |
| This needs an account. Run `deepcell login` | 你处于匿名状态，却请求了只有正式账号才能做的事。 | 登录。匿名期间的工作会自动迁移过去，不会丢失。 |
| Email verification required. | 账号存在，但邮箱地址从未确认过。 | 运行 deepcell verify-email，然后重试。 |
| No active workspace. / No workspaces found. | 没有选中工作区，或者这个账号一个都没有。 | 运行 deepcell workspace use <slug>，或 deepcell workspace create "My Project"。deepcell doctor 会打印当前激活的是哪一个。 |
| Could not connect to ... | 基础地址不对，或者服务本身挂了。 | 检查 DEEPCELL_API_URL。不要循环重试——地址不变，结果就不会变。 |
| write、push、commit、replace，或推理与知识写入命令返回退出码 1 | 已保存但不合法。这些命令先保存后校验，所以文件确实变了，而这个改动站不住。 | 读出报告的问题，修好，再写一次。绝不要原样盲目重试——那会保存两次。 |
| defs 返回退出码 1 | 正好相反：结构编辑是整批原子的，所以什么都没有改变。 | 改好这个操作，然后重新提交整批。 |
| 退出码 2 | 命令本身写错了——参数不对，或者指定的本地文件不存在。 | 运行 deepcell <command> --help 查准确参数。不要猜参数名。 |
| Command '...' is blocked in MCP mode | 在执行前就被拒绝，所以什么都没变。它需要浏览器、二进制文件或本地副本。 | 这一条改用 CLI，或者请与你协作的人来运行。 |
| Demo rate limit exceeded. Try again in Ns. | 匿名限额——每分钟 60 次请求。 | 按提示等待相应秒数。把编辑合并成批量提交，而不是一条条发；或者登录。 |
| Anonymous thread cap reached | 匿名会话有 5 个智能体会话的上限。 | 登录。 |
deepcell guide exit-codes 里有完整约定，包括上面这两种情况，以及另外三种同样以 1 退出的情形。
完整的命令参考（每个命令、参数、退出码和指南主题）位于 /product/cli；如果你更适合阅读 markdown，请访问 /product/cli.md。