从零到一份可用的 .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——它的能力面更大，因为登录、升级、Office/PDF 导出，以及完整的 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://deepcell.net/install.sh | shWindows（PowerShell）
irm https://deepcell.net/install.ps1 | iex它会用 uv 或 pip 安装——机器上有哪个就用哪个，两个都没有就先把 uv 装上；然后找到 deepcell 命令真正落在哪个目录，把那个目录写进你的 shell 配置文件，这样下一个 shell 里它依然在；最后先运行 deepcell --version，确认没问题才报告成功。重复运行是安全的。至于你当前这个 shell，用它打印出来的那行 export，或者干脆新开一个。
不想把下载内容直接管道给 shell？那就先下载、读一遍，再运行。还是同一个脚本：
macOS / Linux
curl -LsSf https://deepcell.net/install.sh -o install-deepcell.sh
less install-deepcell.sh
sh install-deepcell.shWindows（PowerShell）
irm https://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://deepcell.net/mcp在 Manus 和其他 MCP 客户端上，使用带 API 密钥的配置文件。密钥在网站的「设置 → API 密钥」中创建，以 dck_ 开头：
{
"mcpServers": {
"deepcell": {
"type": "streamableHttp",
"url": "https://deepcell.net/mcp",
"headers": {
"Authorization": "Bearer <your-api-key>"
}
}
}
}然后用命令字符串调用这唯一的工具，写法和你在 deepcell 后面输入的完全一样：
guide orient/start有些命令在这里会被拒绝，因为它们需要浏览器、二进制文件或本地副本：account, clone, login, logout, merge, pull, push, register, status, to-docx, to-excel, to-pdf, to-pptx, upgrade, variant, verify-email。拒绝发生在执行之前，所以什么都没有改变。
你不需要账号。第一条需要服务器的命令会自行创建一个匿名会话和一个临时项目，所以直接开始干活：
deepcell guide orient/start
deepcell ls如果 DeepCell 插件已经加载，请跳过这份重复内容。否则，在动手做任何正经工作之前先读这里的同一份工作契约——插件和托管的 DeepCell agent 都遵循它，它讲清楚了工作是什么、什么时候算完成：
deepcell guide orient/how-to-work用五种参考入口，不要猜：命令的 --help 或 deepcell help [command] 管准确调用方式和退出语义；deepcell rules [id] 管必须保持的约束；deepcell guide [topic] 管当前流程；deepcell ref [id] 管合法名称和值；deepcell example 提供完整有效的文件和构建记录。
然后接受一个目标和它的约束，而不是一套流程：
“比较 ./proposals 里的供应商方案，并建议我们应该自建还是采购。记录假设、证据、被否决的替代方案，以及什么新证据会改变结论；交付一份简洁的决策备忘录。”
写入前先检查项目和已有文件。相信当前版本随附的帮助、规则、指南、引用和值域以及示例，而不是你的记忆。永远不要用文本编辑器改 .deepcell 文件：那会跳过计算引擎、校验和版本历史，文档正是这样开始自相矛盾的。
一个 .deepcell 文档连接四个可选界面——推理、表格、文稿和演示文稿。只选问题真正需要的：定性工作可以只用推理和文稿而没有网格，另一个任务也可以四者齐全。重新计算会更新计算依赖项；有链接的主张、正文和幻灯片则必须被明确复核，绝不会被静默改写。如果宿主还提供直接编写 .xlsx、.docx 或 .pptx 的工具，在这里不要用，因为那些文件会丢失彼此连接的事实来源。
这对读者没有任何损失，因为看这份工作并不需要谁手里有这个文件。deepcell share create 会给出一个链接，在 DeepCell 网站上打开它，连接关系原样保留；deepcell to-excel、to-docx、to-pptx、to-pdf 则能从文档生成可编辑的文件——其中 to-excel --formulas 导出的是活的公式，而不是拍平后的数值。所以当有人要一份表格或一套演示时，在 DeepCell 里做，然后把导出的文件给他们。
三种状态，而你什么都不做就已经在第一种里。等命令告诉你需要时再往上走——不要提前。
| 状态 | 如何进入 | 能做什么 |
|---|---|---|
| 匿名 | 什么都不用做。第一条需要服务器的命令会创建它，并告诉你它这么做了。 | 可以创建项目、写入、编辑、查询、阅读全部指南，并分享有效期最长 7 天的只读链接。这是临时演示项目：闲置 30 天后回收，且限制为每分钟 60 次请求、每份文档 2 MiB。智能体由你自己驱动——托管对话的运行次数上限属于浏览器端限制，在这里从不适用。 |
| 账号 | 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 project. / No projects found. | 没有选中项目，或者这个账号一个都没有。 | 运行 deepcell project use '<'slug>，或 deepcell project 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 次请求。 | 按提示等待相应秒数。把编辑合并成批量提交，而不是一条条发；或者登录。 |
deepcell guide exit-codes 里有完整约定，包括上面这两种情况，以及另外三种同样以 1 退出的情形。
完整的命令参考（每个命令、参数、退出码和指南主题）位于 /product/cli；如果你更适合阅读 markdown，请访问 /product/cli.md。