随身AI工作台 MLXIAOCHANGAN/DeepPod

DeepPod — 便携版 DeepSeek Harness

一个自包含的、插上就能用的 AI 编程助手。
本体、运行时、插件、配置全在一个文件夹里，插到任意一台 Windows 电脑上双击即用 ——那台电脑不需要装过 Node.js，也不需要装过 DeepSeek Harness。

DeepPod 把 DeepSeek Harness（DSH）连同它的整条运行链打包成一个可携带的目录：把这一个文件夹拷到 U 盘、移动硬盘，或者直接放在本机某个分区里，它就是一个独立的、不污染宿主系统的 AI 工作台。所有配置、凭据、模型选择都写回这个目录，跟着介质走，换一台电脑接着用。

- 默认地址：
- 顶层只有两个可执行文件：启动DeepPod.bat 和 停止DeepPod.bat

亮点

| 零依赖 | 自带 Node.js 运行时，宿主机什么都不用装。插上就能跑。 |
| 盘符无关 | 配置文件里没有写死任何盘符。U 盘变成 E:、H:、Z: 都照样启动。 |
| 不碰宿主机 | 不写注册表、不装全局包、不建开机启动项。删掉文件夹 = 彻底卸载。 |
| 凭据随盘走 | API Key 存在盘上，换电脑不用重新配。 |
| 首次启动引导 | 第一次跑会先弹用户协议，再弹参数面板让你填自己的 Key 和模型。 |
| 可换端口 | 默认 2026，刻意避开 DSH 常用的 3080，可以和电脑上已有的 DSH 同时开。 |
| 干净的会话 | 盘上不带任何历史聊天记录，打开就是全新会话。 |
| 断电不残留 | 关掉命令窗口即停止服务，不留后台进程。 |

界面做了什么

这是一个品牌化的发行版，不是原始 DSH：

- 侧边栏字标改为 DeepPot-By MLXIAOCHANGAN
- 首页大标题改为 让想法即刻成真 | Unleash your imagination（中英双语均已替换）
- 移除了标题旁的「预览版」小标签
- 浏览器标签页标题改为 DeepPod（打开会话时显示为 会话名 — DeepPod）

快速开始

1. 把 DeepPod 文件夹放到 U 盘 / 移动硬盘，或者本机任意目录
2. 双击 启动DeepPod.bat
3. 浏览器打开 http://127.0.0.1:2026 （通常会自动打开）
4. 首次启动：先勾选同意用户协议 → 再在参数面板里填自己的 API Key 和模型
5. 关掉黑色命令窗口 = 停止服务；也可以双击 停止DeepPod.bat

换端口

把端口号当第一个参数传进去即可：

启动DeepPod.bat 3081 -> http://127.0.0.1:3081 停止DeepPod.bat 3081

不用每次手输 —— 想固定就用记事本改 启动DeepPod.bat 里的 set "PORT=2026"。

目录结构

DeepPod/
├─ 启动DeepPod.bat 启动（唯一的入口） ├─ 停止DeepPod.bat 停止 ├─ 使用说明.md 详细手册 ← 遇到问题先看这个 │ ├─ runtime/ 便携运行时（DSH 本体 + Node.js，约 330 MB） │ ├─ node.exe Node.js 运行时 │ ├─ node_modules/ DSH 本体、pnpm、npm │ ├─ dsh.cmd 命令行入口 │ ├─ stop-deeppod.ps1 停止脚本的判断逻辑 │ ├─ repair-profile.ps1 检查 / 修复插件树 │ └─ sync-plugins.ps1 把 plugins/ 的改动同步进 profile │ ├─ home/ 就是 $DSH_HOME —— DSH 的全部用户数据 │ ├─ settings.yaml 设置（模型选择、主题…）
│ ├─ .credentials.yaml 凭据（你的 API Key，明文） │ ├─ .env 环境变量说明 │ ├─ profiles/web/ web profile：插件清单 + 挂载补丁 │ └─ profiles/headless/ 无界面 profile │ ├─ plugins/ 插件源码副本 │ └─ backup/profile/ profile 的完好快照，供修复脚本还原用

启动DeepPod.bat 用 %~dp0 自己算盘符，所以整个树里没有任何写死的盘符 ——这也是它能在任意电脑、任意盘符上直接跑起来的原因。

装了哪些插件

| 插件 | 干什么 |
| deeppod-setup | 启动门禁：用户协议 + 参数设置面板 |
| deeppod-brand | 界面品牌化（字标、大标题、标签页标题） |
| dsh-at-file | 输入框里用 @ 引用文件 |
| dsh-usage-cost | 用量与成本统计 |
| glm-mcp | GLM-4.6V-Flash 视觉 MCP —— 给模型"眼睛"，可识图 |
| dshmarket | 插件市场 |
| dsh-chat-import | 从其它 AI 客户端导入历史对话 |
| @linxin666/dsh-web-ui-all | Web 界面增强合集 |

系统要求

- Windows 10 / 11，x64
- 介质需要是 NTFS（不要格式化成 FAT32 / exFAT ——见下）
- 首次启动需要联网（拉一次余额，以及你填 Key 之后的首个请求）

⚠️ 不要把这个盘格式化回 FAT32 或 exFAT。
DSH 启动时会在 home/profiles/node_modules 下维护一组目录联接（junction），这是 NTFS 的特性，FAT32 和 exFAT 都不支持，格式化回去会导致 DeepPod 直接起不来。
只能在 Windows x64 上跑。 运行时和几个原生模块都是 win-x64 的， macOS / Linux / ARM 上用不了。

安全须知（请务必读一遍）

DeepPod 是便携自用定位，它的安全模型很简单：

1. 凭据是明文。 home/.credentials.yaml 里的 API Key 没有加密，而且这类介质上的目录通常对任何账户可读。
丢掉介质 = 丢掉 Key。 请第一时间去服务商控制台吊销并换新。
2. 不要用别人的盘。 配置里能执行代码，拿到盘的人可以改配置让它在你的机器上运行东西。
"别人给的 U 盘别乱插"同样适用于这里。
3. 只用 127.0.0.1。 服务只监听本机，不对局域网暴露。
4. 协议弹窗是诚信门禁，不是防破解。 它的作用是明确告知并取得同意，不做技术强制。

更完整的说明见 使用说明.md。

常见问题

双击没反应 / 窗口一闪而过？
在 DeepPod 目录里开 PowerShell 手动跑，就能看到真实报错：

.\runtime\node.exe .\runtime\node_modules\@deepseek-ai\dsh\lib\bin.js --profile web

提示端口 2026 被占用？
脚本会直接打开已在运行的那个窗口。想同时开两个就换端口：启动DeepPod.bat 3081。

启动报 loader entries failed to apply？
插件树坏了。跑修复：

powershell -NoProfile -ExecutionPolicy Bypass -File .\runtime\repair-profile.ps1 -Root .

看不到协议弹窗 / 参数面板？
这是设计如此 —— 处理过一次就不再弹。想再看一次，删掉 home/.deeppod-eula.json 和 home/.deeppod-setup-ack.json 再启动。

杀软拦截？
部分企业电脑的安全策略会拦截可移动介质上的 node.exe，表现为双击一闪而过或杀软弹窗。这种只能换台电脑或找 IT 放行。

⚠️ 绝对不要在 home/profiles/web/ 里跑 pnpm install。
那里是已部署好的目录，不是 pnpm 管理的。pnpm 会从网上重新解析每个依赖：版本可能漂移，中途被打断还会留下写了一半的包，直接让插件树起不来。
真坏了就跑上面的修复脚本。

更多排错见 使用说明.md。

关于本仓库

这个仓库是 DeepPod 的公开说明与发行渠道，不是它的源码树。为了控制敏感面，以下内容有意没有放进来：

- 核心实现代码 —— 两个自研插件（deeppod-setup、deeppod-brand）的 lib/ 实现，以及视觉 MCP 服务的实现
- 构建流水线 —— 打包脚本、集成测试与自检脚本
- 预构建运行时 —— runtime/node.exe 与 node_modules/（300+ MB，随介质分发，不进 git）
- profile 快照 —— backup/profile/（340+ MB，同上）
- 任何真实凭据 —— 全部替换为占位符；home/.credentials.yaml 未跟踪，只提供 .credentials.example.yaml 模板

仓库里保留的是：面向使用者的说明、启动/停止与维护脚本、配置文件模板，以及插件的清单（package.json + cordis.patch.yml）。

致谢

- DeepSeek Harness（DSH）—— 上游主体，著作权归原作者所有。DeepPod 是对它的打包、配置与界面定制。
- 各第三方插件归其各自作者所有，遵循各自许可证。

许可

DeepPod 的打包与定制部分以 MIT 发布；随附的上游组件（DeepSeek Harness 及各第三方插件）仍遵循其各自的原始许可证。