Yichen Jiang
2426be893a
An image the manifest does not publish was rewritten to a raw.githubusercontent URL, which serves a private repository to nobody: raw answers 404 unauthenticated, and a github.com session does not authenticate it. Every image on the site was broken for every reader, and no gate could say so — link checking asks whether the file exists in the repository, not whether a site reader can fetch it. The projector now copies a referenced image into the generated tree beside the page and points the reference at it, so Vite bundles it like any other site asset and repository visibility cannot reach the published page. The copy lands beside the page so one relative URL is right from both locale trees and a page's assets leave with the page; two sources projecting onto one path throw rather than letting the last copy win. Canonical Markdown keeps writing ordinary repository-relative paths, so the same file still renders when read in the repository. The guide this was found through is renamed to its subject: 配置模型.
1.8 KiB
1.8 KiB
快速开始
English | 中文
本指南带你在 5 分钟内跑起一个 Agent。
环境准备
- Node.js ^22.19 或 >= 24
- 通过 Corepack 使用 pnpm 11
- DeepSeek Platform API key
node -v
corepack enable
pnpm -v
第一步：安装并配置 API key
git clone https://github.com/deepseek-harness/deepseek-harness.git
cd deepseek-harness
pnpm install
在仓库根目录创建已被 Git 忽略的 .env：
DEEPSEEK_API_KEY=sk-your-key-here
第二步：运行一个 Headless 任务
运行一个非交互式任务并打印最终回答：
pnpm run demo:headless "summarize the architecture of this workspace"
Headless 运行一个完整的模型/工具轮次，持久化会话，打印结果后退出。需要规范事件流时可使用 --output-format stream-json。
第三步：使用 Web UI
构建并启动浏览器界面：
pnpm run build
pnpm run dsh web
打开 http://127.0.0.1:3080。agent 可以读写文件、运行命令、分配子任务和跟踪计划。可以尝试：Create hello.js in the current directory, print "Hello from Harness!", and run it。
回头看
headless-agent 使用 @deepseek-ai/dsh-cli-demo app。dsh web 则组合 apps/cli/config/base.cordis.yml 与 apps/cli/config/web.cordis.yml，不使用 app 组合包。二者都会根据各自入口模式选择 DeepSeek 模型和能力插件。