เริ่มต้นใช้งาน

DEPLOY

เริ่มต้นใช้งาน

จากศูนย์จนรันได้ ใช้แค่สี่ขั้นตอน ทุกคำสั่งตรวจทานทีละบรรทัดกับ README ทางการ

ติดตั้ง CLI

คำสั่ง npx เดียวก็รันได้เลย ใช้ได้ทั้ง macOS / Linux / Windows ขอแค่มี Node 22.19+

เชื่อมต่อโมเดล

ใส่ API key ของ DeepSeek หรือจะต่อ Ollama เพื่อใช้โมเดลที่รันอยู่ในเครื่องคุณก็ได้

เริ่มรัน

ลงมือทำงานจากเทอร์มินัลได้เลย ถ้าไม่ถนัดบรรทัดคำสั่ง สั่ง dsh web เพื่อเปิดหน้าจอบนเบราว์เซอร์

ติดตั้งปลั๊กอินตัวแรก

เลือกสักตัวจากรายการคัดสรรแล้วติดตั้ง — จากจุดนี้ไป ทุกอย่างคือปลั๊กอิน

REQUIREMENTS

runtime · readme_wording

Install `Node.js`, then run: npx @deepseek-ai/dsh web

runtime · package_json_engines_node

^22.19.0 || >=24.0.0

runtime · package_json_packageManager

pnpm@11.7.0

runtime · root_package

@deepseek-ai/dsh-root 0.1.0-rc.7

runtime · engines_source_url

https://raw.githubusercontent.com/deepseek-ai/de…

linux_build_tools_note

ทางการไม่ได้เขียนไว้ แต่การถกในคอมมิวนิตี้ (#1772/#49/#897) ยืนยันว่าโมดูลเนทีฟ node-pty บน Linux ต้องคอมไพล์ในเครื่อง: Debian ต้องมี build-essential, Arch ต้องมี base-devel, และ g++ ต้องรองรับ gnu++20 (GCC 10+)

status_warning

DeepSeek Harness is currently in _developer preview_ and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES. (ข้อความต้นฉบับใน README)

รันด้วย npx โดยตรง (วิธีที่ README ทางการแนะนำเป็นอันดับแรก)

★

npx @deepseek-ai/dsh web

ต้นฉบับ

รันจากซอร์สโค้ด (pnpm)

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

ต้นฉบับ

ผสานกับ Ollama (รันในเครื่อง/ระบบปิด)

ollama launch dsh

ต้นฉบับ

ติดตั้งแบบ global ด้วย npm (วิธีของคอมมิวนิตี้ ไม่ได้อยู่ใน README ทางการ)

npm install -g @deepseek-ai/dsh

dsh web

ต้นฉบับ

MODEL

api · deepseek_key

ใน Web UI ไปที่ Settings → Models กรอก API key (จาก https://platform.deepseek.com/ ) ลงในการ์ด DeepSeek แล้วบันทึก; ต้นฉบับทางการ: "The model route becomes usable immediately without restarting the server" (บันทึกแล้วมีผลทันที ไม่ต้องรีสตาร์ท)

api · key_storage

ต้นฉบับใน providers.md: "Keys are write-only. The page receives a redacted descriptor after saving, never the literal secret. The key is stored in `$DSH_HOME/.credentials.yaml`"; ส่วนนิยามของโมเดลเก็บไว้ที่ $DSH_HOME/settings.yaml

api · catalog_providers

Anthropic

api · catalog_providers

OpenAI

api · catalog_providers

Bedrock

api · catalog_providers

Vertex

api · catalog_providers

Azure

api · catalog_providers

Codex

api · catalog_config

Add provider → เลือกผู้ให้บริการ → กรอก API key → บันทึก; ส่วน Bedrock/Vertex/Azure/Codex ใช้เครดิเชียล AWS + region, ADC project, api-version และ OAuth ตามลำดับ

api · env_var

ฉีดเครดิเชียลผ่านตัวแปรสภาพแวดล้อมได้ (ฟิลด์ apiKeyEnv ในตัวอย่างการตั้งค่า เช่น GATEWAY_API_KEY)

api · source_url

https://github.com/deepseek-ai/deepseek-harness/…

local · custom_openai_compatible

Add a custom provider: กรอก Provider ID (ตัวพิมพ์เล็ก แก้ไม่ได้ภายหลัง), ชื่อที่แสดง, base URL, โปรโตคอล API, เครดิเชียล และอย่างน้อยหนึ่งโมเดล; รองรับ Fetch available models ที่เรียก GET /models แบบเข้ากันได้กับ OpenAI เพื่อดึงรายชื่อโมเดลอัตโนมัติ ส่วนเอ็นด์พอยต์ที่ไม่รองรับให้กรอกชื่อโมเดลเอง

local · ollama

ollama launch dsh คำสั่งเดียวรันในเครื่องได้ครบ พร้อมติดตั้งปลั๊กอิน Ollama web search มาให้ (ตามคำอธิบายทางการของ Ollama)

local · source_url

https://github.com/deepseek-ai/deepseek-harness/…

LAUNCH

web_ui · command

npx @deepseek-ai/dsh web

web_ui · alias

dsh web เป็นชื่อย่อของ dsh --profile web

web_ui · default_address

http://127.0.0.1:3080

web_ui · first_run_flow

① Settings → Models กรอก DeepSeek API key → ② Choose workspace เลือกไดเรกทอรีทำงาน (ต้นฉบับทางการ: "The session composer remains unavailable until a workspace is selected") → ③ เปิดเซสชันแล้วสั่งงาน

web_ui · source_url

https://github.com/deepseek-ai/deepseek-harness/…

terminal · headless

dsh --profile headless "job" — คำอธิบายทางการ: "Run one fresh persisted session, print the final answer, and exit"

terminal · profile

dsh --profile <name> — "Boot the named profile under $DSH_HOME/profiles/<name>"; profile ชื่อ web และ headless จะถูกสร้างจากเทมเพลตอัตโนมัติเมื่อใช้ครั้งแรก ส่วน profile อื่นต้องสร้างผ่าน dsh plugin

terminal · plugin_mgmt

dsh plugin --profile <name> <pnpm args> — ส่งต่อพารามิเตอร์ของ pnpm ไปยังไดเรกทอรีของ profile เพื่อจัดการปลั๊กอิน

terminal · flags

--port

terminal · flags

--resume

terminal · flags

--patch

terminal · flags

--dump-default-config

terminal · flags

--dump-config

terminal · flags

--help

terminal · source_url

https://github.com/deepseek-ai/deepseek-harness/…

modes · list · name_zh

โหมดมาตรฐาน

modes · list · name_en

Standard

modes · list · dir

standard

modes · list · official_desc_zh

Agent เขียนโค้ดที่มีฟีเจอร์ครบ รองรับการแก้ไขไฟล์, Shell, การค้นหาไฟล์และเว็บ, Skills, แผนงาน, เป้าหมาย, ซับเอเจนต์ และเวิร์กโฟลว์

modes · list · name_zh

โหมด PTC

modes · list · name_en

Code

modes · list · dir

code

modes · list · official_desc_zh

มีความสามารถครบเท่าโหมดมาตรฐาน และเปิดเผยทูลผ่าน Code Mode SDK ให้โมเดลประกอบการทำงานหลายขั้นตอนด้วยโปรแกรม TypeScript ตัวเดียว

modes · list · name_zh

โหมดมินิมอล

modes · list · name_en

Minimal

modes · list · dir

minimal

modes · list · official_desc_zh

Agent เขียนโค้ดที่มีเพียงสองทูล คือ bash แบบคงอยู่ต่อเนื่องกับ str_replace_editor

modes · list · name_zh

โหมดสร้างสรรค์

modes · list · name_en

Creator

modes · list · dir

cordis

modes · list · official_desc_zh

ใช้สร้าง Agent preset ของตัวเอง: มีความสามารถครบเท่าโหมดมาตรฐาน พร้อมการตรวจสอบขณะรันไทม์ การทดลองปลั๊กอิน และคำแนะนำการสร้าง preset

modes · definition_location

อยู่ใน apps/cli/config/agent-presets/ แยกเป็นสี่ไดเรกทอรี (code/cordis/minimal/standard) โดยไฟล์นิยาม preset ทางการเขียนเป็นภาษาจีนโดยตรง

modes · source_url

https://github.com/deepseek-ai/deepseek-harness/…

UPGRADE / UNINSTALL

note

ทั้ง README, apps/cli/README.md และคู่มือผู้ใช้ใน docs ไม่มีคำสั่งอัปเกรด/ถอนการติดตั้งให้เลย (ตรวจทีละแหล่งแล้วได้ผลว่า ABSENT); ในคอมมิวนิตี้เคยมีวิธีล้างแคชของ npx (rm -rf ~/.npm/_npx ดู #49/#897) ซึ่งเป็นวิธีแก้ปัญหาเฉพาะหน้า ไม่ใช่ขั้นตอนอัปเกรดอย่างเป็นทางการ

ISSUES

ติดตั้งด้วย npx ไม่ได้ | npm ก็ติดตั้งไม่ได้ (#1772, ตอบแล้ว)

เจ้าของกระทู้ตอบเอง (2026-08-16): Debian ยังไม่ได้ติดตั้ง build-essential ทำให้คอมไพล์โมดูลเนทีฟ node-pty ไม่ผ่าน; หลังติดตั้ง build-essential ผ่าน apt ก็ติดตั้งสำเร็จ

ติดตั้งบน ArchLinux ไม่ได้ (#49, 18 ความคิดเห็น)

วิธีแก้ที่ได้โหวตสูง: ① pacman -Syu base-devel เพื่อติดตั้งเครื่องมือคอมไพล์; ② เปลี่ยนไปใช้ Bun: bun add --global @deepseek-ai/dsh (node-pty อยู่ในไวต์ลิสต์ของ Bun); ③ ถ้ายืนยันจะใช้ npm ให้ล้างแคชแล้วอนุญาตสคริปต์บิลด์: rm -rf ~/.npm/_npx && npx --allow-scripts=node-pty @deepseek-ai/dsh@0.1.0-rc.6 web; อีกทางเลือกหนึ่ง: npm config set allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs --location=user

ติดตั้งผ่านบรรทัดคำสั่งไม่สำเร็จ (#897, 10 ความคิดเห็น)

คอมมิวนิตี้วินิจฉัยว่า: g++ 9.4.0 ที่มากับระบบไม่รองรับ -std=gnu++20 (ต้องใช้ GCC 10+); วิธีแก้: ล้างแคชของ npx ก่อน แล้วรัน CC=gcc-11 CXX=g++-11 npm install -g @deepseek-ai/dsh จากนั้นค่อย dsh web

ติดตั้งแบบ global ด้วย npm แล้ว dsh web เปิดไม่ขึ้น: ไม่มีโมดูลเนทีฟ pty.node ของ node-pty (#1219)

ต้นเหตุ: node-pty v1.1.0 ไม่มีไฟล์คอมไพล์สำเร็จรูปสำหรับ Linux x64 (Node 24/ABI 137) สคริปต์ติดตั้งของ npm จึงล้มเหลวแบบเงียบ ๆ; วิธีเลี่ยงแบบทำมือ: เข้าไปในไดเรกทอรี node-pty แล้วรัน npx node-gyp rebuild เพื่อสร้าง pty.node ที่ขาดไป; ในกระทู้ไม่มีคำตอบจากทางการ (0 ตอบกลับ)

dsh ขึ้นข้อผิดพลาด Ignored build scripts ตอนติดตั้งปลั๊กอิน (#2230)

ยังไม่ได้เก็บรายละเอียดวิธีแก้ (1 ความคิดเห็น ยังไม่ได้ตรวจเชิงลึก); อาการเกี่ยวข้องกับนโยบายความปลอดภัยของ pnpm ที่ข้ามสคริปต์บิลด์ของดีเพนเดนซีโดยค่าเริ่มต้น เทียบเคียงกับวิธี allow-scripts ใน #49 ได้ — วิธีแก้ข้อนี้ยังรอเติม