วิธีตั้งค่า dsh: API Key, โมเดล และ Endpoint บน Linux
คู่มือการตั้งค่า dsh บน Linux ตั้งแต่การระบุตำแหน่งไฟล์คอนฟิกูเรชัน การเชื่อมต่อ DeepSeek API Key ไปจนถึงการตั้งค่า Ollama Endpoint พร้อมคำอธิบายข้อมูลที่ถูกส่งออกในแต่ละโหมด
ตำแหน่งที่ dsh เก็บการตั้งค่า
dsh (DeepSeek Harness) เก็บข้อมูลของ harness ไว้ที่ $DSH_HOME ซึ่งมีค่าเริ่มต้นเป็น ~/.dsh และอ่านการตั้งค่า agent ที่ใช้ร่วมกันจาก root แยกต่างหากคือ $DSH_AGENTS_HOME ซึ่งมีค่าเริ่มต้นเป็น ~/.agents ทุกอย่างที่คุณกำหนดใน Web UI จะถูกเขียนไว้ที่นั่นเป็นไฟล์ข้อความธรรมดา เมื่อต้องย้ายการตั้งค่าไปยังเซิร์ฟเวอร์อื่น ให้คัดลอก home ของ harness รวมถึง instructions และ skills ระดับ global จาก shared agent root ไปด้วย
มี 4 path ที่ใช้เก็บการตั้งค่าหลักของ harness, secrets และ session logs
~/.dsh/profiles/<profile>/cordis.patch.ymlเก็บการตั้งค่าที่ Web UI เขียนไว้สำหรับ profile นั้น รวมถึงเส้นทาง provider และ model ของคุณdsh webเรียกใช้ profilewebดังนั้นไฟล์จึงเป็น~/.dsh/profiles/web/cordis.patch.yml~/.dsh/.credentials.yamlเก็บ secrets การตั้งค่าจะเก็บไว้เพียง reference ไปยัง credential ดังนั้นค่า key จริงจึงอยู่ในไฟล์เดียว~/.dsh/profiles/เก็บ profile ที่ตั้งชื่อไว้ และ~/.dsh/sessions/เก็บ session logs ที่บันทึกไว้~/.dsh/cordis.patch.ymlเป็น patch layer ของคุณเอง โดยจะถูกนำไปใช้ทับ built-in configuration สำหรับทุก profile และมีลำดับความสำคัญสูงกว่าไฟล์ profile ดังนั้นการแก้ไขใน Web UI ที่ layer นี้จะทับค่าจะถูกปฏิเสธแทนที่จะบันทึก
shared agent root ยังคงอยู่นอก $DSH_HOME เพราะเครื่องมือ agent อื่นใช้ร่วมกัน dsh อ่าน instructions ระดับ user-global จาก ~/.agents/AGENTS.md และค้นหา skills ใน ~/.agents/skills/ หากต้องการย้าย root นี้ ให้กำหนด DSH_AGENTS_HOME
Build รุ่นก่อนหน้าเก็บการตั้งค่าเหล่านี้ไว้ใน ~/.dsh/settings.yaml Build รุ่นปัจจุบันจะ import ไฟล์นั้นเข้าสู่ profile ที่ใช้งานอยู่เพียงครั้งเดียว แล้วเปลี่ยนชื่อเป็น settings.yaml.imported ดังนั้นคู่มือเก่าที่แนะนำให้แก้ไข settings.yaml จะชี้ไปยังไฟล์ที่ dsh ไม่อ่านอีกต่อไป
DeepSeek เผยแพร่ harness ในรูปแบบ developer preview ภายใต้ MIT license และ README ระบุว่าจะมีการเปลี่ยนแปลงที่ทำให้ compatibility ใช้งานร่วมกันไม่ได้ ชื่อ field และ path ในคู่มือนี้ตรงกับเอกสารของ repository รุ่นปัจจุบัน ซึ่งตรวจสอบเมื่อ 5 November 2026 ให้ตรวจสอบกับเอกสารของ version ที่คุณติดตั้งก่อนคัดลอก config จากคู่มือใด ๆ รวมถึงคู่มือนี้ เนื่องจาก preview อาจเปลี่ยนชื่อสิ่งต่าง ๆ ระหว่าง releases
สิ่งจำเป็นขั้นต่ำเพื่อให้ได้ผลลัพธ์แรก
dsh ต้องใช้ Node.js 24.9 หรือใหม่กว่า ณ วันที่ 5 November 2026 ค่าใน package.json ระบุ >=24.9.0 ดังนั้นสาย 22 จึงไม่รองรับ Node.js 24.0 ถึง 24.8 ก็ไม่เพียงพอเช่นกัน ให้ตรวจสอบ version ก่อน เพราะ version ไม่ตรงกันจะทำให้โปรแกรมหยุดทำงานตั้งแต่เริ่มต้น และข้อความ error อาจทำให้เข้าใจว่า package เสีย
node -v
npx @deepseek-ai/dsh webnpx จะดาวน์โหลด package จาก npm registry และเริ่ม Web UI ที่ http://127.0.0.1:3080 โปรแกรมจะ bind กับ loopback address ซึ่งหมายความว่าพอร์ตนี้จะไม่สามารถเข้าถึงจากเครื่องอื่นได้ แม้ firewall จะอนุญาตก็ตาม บน VPS ให้ forward ผ่าน SSH แทนการเปิดพอร์ต 3080 สู่อินเทอร์เน็ต หาก URL ที่แสดงเป็นส่วนที่ทำให้สับสน เหตุผลที่ dsh เริ่มทำงานที่ address นี้ จะอธิบายว่า loopback bind ช่วยป้องกันอะไร และไม่ช่วยป้องกันอะไร
ssh -N -L 3080:127.0.0.1:3080 you@your-serverเปิด http://127.0.0.1:3080 บน laptop แล้วไปที่ Settings และ Models การ์ด DeepSeek มีช่อง API key เพียงช่องเดียว ให้วาง key จาก platform.deepseek.com แล้วบันทึก การเรียกใช้ model จะพร้อมใช้งานทันทีโดยไม่ต้อง restart เพราะ server ที่กำลังทำงานจะจัดเก็บ credential และ resolve reference แบบ live การเข้าถึง dsh Web UI บน remote server อธิบายกรณีใช้ tunnel และ reverse proxy ส่วน การติดตั้ง DeepSeek Harness บน VPS อธิบายการเตรียม server ที่คู่มือนี้ถือว่าได้ดำเนินการไว้แล้ว
หลังบันทึก ให้ตรวจสอบสิ่งที่แอปสร้างขึ้น
ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yamlควรพบ .credentials.yaml และ profiles/ โดย settings ของ Web UI อยู่ใน profiles/web/cordis.patch.yml home directory ที่ build รุ่นเก่าเคยสร้างอาจมี settings.yaml.imported อยู่ด้วย หาก stat แสดง mode ที่ไม่ใช่ 600 ให้เรียกใช้ chmod 600 ~/.dsh/.credentials.yaml ไฟล์ credentials ที่ group อ่านได้จะเปิดเผย key ของคุณแก่ account ที่อยู่ใน group นั้น ส่วนไฟล์ที่ทุก account อ่านได้จะเปิดเผย key แก่ account อื่นทุก account ในเครื่อง
สำหรับการเรียกใช้ครั้งแรกโดยไม่มี browser ใช้เพียง command เดียว
npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"headless profile จะทำงานเป็น session เดียวและแสดงคำตอบสุดท้าย
ตัวแปรสภาพแวดล้อมหรือไฟล์คอนฟิกูเรชัน
dsh สามารถดึงคีย์จากข้อมูลประจำตัวที่บันทึกไว้หรือใช้ตัวแปรสภาพแวดล้อมสำรองได้
ผู้ให้บริการแคตตาล็อก (DeepSeek, Anthropic, OpenAI และรายการอื่นๆ ที่มีมาให้ในตัว) จะรับคีย์ผ่านหน้า Models หรือใช้ตัวแปรสภาพแวดล้อมสำรองที่รองรับเมื่อไม่มีข้อมูลประจำตัวที่บันทึกไว้ ค่าดังกล่าวจะถูกเก็บไว้ใน ~/.dsh/.credentials.yaml และการตั้งค่าของคุณจะเก็บเพียงการอ้างอิงถึงค่านั้นไว้เท่านั้น Web UI จะไม่แสดงคีย์ดังกล่าวอีกหลังจากที่คุณบันทึกแล้ว
ผู้ให้บริการแบบกำหนดเองสามารถระบุการอ้างอิงข้อมูลประจำตัวด้วย apiKeyEnv ซึ่งรองรับตัวแปรสภาพแวดล้อมสำรองเช่นกัน นี่คือรูปแบบที่เอกสารระบุไว้สำหรับรายการใน profile patch เช่น ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
config:
providers:
my-gateway:
apiKeyEnv: GATEWAY_API_KEY
api: openai-completions
baseURL: https://gateway.example/v1
models:
- id: legacy-chat
- id: vision-preview
input: [text, image]ให้เพิ่มผู้ให้บริการหนึ่งรายการผ่าน Web UI ก่อน จากนั้นเปิด cordis.patch.yml ของโปรไฟล์แล้วคัดลอกโครงสร้างที่ระบบเขียนไว้ ในระหว่างช่วง developer preview โครงสร้างแบบซ้อนกัน (nesting) เป็นส่วนที่มีโอกาสเปลี่ยนแปลงมากที่สุด และไฟล์ที่แอปพลิเคชันเพิ่งเขียนขึ้นจะเป็นเวอร์ชันปัจจุบันเสมอ
apiKeyEnv จะทำการแก้ไขผ่านที่เก็บข้อมูลประจำตัว (credential store): โดยไฟล์ที่บันทึกไว้จะมีลำดับความสำคัญสูงสุด ตามด้วยสภาพแวดล้อมขณะเปิดใช้งาน (launch environment), .env ในไดเรกทอรีที่เรียกใช้งาน และ $DSH_HOME/.env ตามลำดับ คีย์ที่ถูก export ไว้เฉพาะใน interactive session จะไม่สามารถมองเห็นได้โดย systemd unit ดังนั้นหากไม่มีแหล่งข้อมูลประจำตัวอื่น คอนฟิกูเรชันเดียวกันที่ทำงานได้เมื่อคุณพิมพ์ dsh web ด้วยตนเอง จะส่งคืนค่า MISSING_CREDENTIAL เมื่อทำงานภายใต้ service ดังนั้นควรจัดเตรียมไฟล์แยกต่างหากให้กับ unit นั้น
[Service]
EnvironmentFile=/etc/dsh/dsh.envเก็บไฟล์ดังกล่าวไว้ที่โหมด 600 โดยให้ผู้ใช้ที่รัน service เป็นเจ้าของไฟล์
การเลือกโมเดลและ ID ที่เปลี่ยนชื่อไม่ได้
Provider ที่ตั้งค่าไว้ทั้งหมดจะแสดงในตัวเลือกโมเดล การเลือกโมเดลจะกำหนดให้โมเดลนั้นเป็นค่าเริ่มต้นสำหรับ session ใหม่ด้วย Session ที่ส่งคำขอไปแล้วจะเก็บโมเดลที่บันทึกไว้ใน session ดังกล่าว ดังนั้นการเปลี่ยนโมเดลจะไม่แก้ไข conversation เก่า
Provider ID เป็นค่าถาวร คำขอ, session ที่บันทึกไว้, ค่าเริ่มต้นของโมเดล และข้อมูลอ้างอิง credential ล้วนชี้ไปยัง ID นี้ จึงไม่มีปุ่มเปลี่ยนชื่อ หากต้องการเปลี่ยน ID ต้องสร้าง Provider ใหม่และลบ Provider เดิม เลือกชื่อที่สามารถใช้งานต่อไปได้ เช่น local-ollama แทน test2
โมเดลแบบกำหนดเองที่ไม่ได้สืบทอดความสามารถด้าน image จะรองรับเฉพาะข้อความ เว้นแต่จะระบุเป็นอย่างอื่น เพิ่ม input: [text, image] ในรายการโมเดลเพื่อระบุว่ารองรับ image หรือกำหนด defaultInput ในระดับ route เพื่อใช้เป็นค่า fallback สำหรับโมเดลที่ catalog ไม่ได้ระบุข้อมูลไว้ สำหรับ route ของ DeepSeek เอง โมเดลที่ไม่ได้ประกาศ modalities จะถือว่ารองรับเฉพาะข้อความ ดังนั้นให้เลือก catalog entry ที่รองรับ image เช่น deepseek-flash ซึ่งเป็นค่าเริ่มต้น ก่อนแนบ image หากส่ง image ไปยังโมเดลที่ไม่ได้ประกาศว่ารองรับ image ระบบจะปฏิเสธคำขอก่อนส่งข้อมูลใด ๆ
ชี้ dsh ไปที่ endpoint ในเครื่องเพื่อให้โค้ดของคุณทำงานอยู่บนเซิร์ฟเวอร์เดิม
Ollama ให้บริการ API ที่รองรับ OpenAI บน http://127.0.0.1:11434/v1 โดย dsh จะสื่อสารกับ base URL ใดๆ ที่รองรับ OpenAI ผ่าน custom provider ทำให้ทั้งสองเชื่อมต่อกันได้โดยตรงโดยไม่ต้องมีตัวกลาง ให้ตั้งค่า model server ก่อน: การ self-host LLM ด้วย Ollama บน VPS ครอบคลุมขั้นตอนการติดตั้งและการดึงโมเดล
ตรวจสอบว่า endpoint ตอบสนองก่อนที่คุณจะเริ่มใช้งาน dsh
ollama list
curl -s http://127.0.0.1:11434/v1/modelsollama list จะแสดง tag ที่ถูกต้องของทุกโมเดลที่คุณดึงมา ให้คัดลอกสตริงนั้น ส่วน curl จะส่งคืนรายการโมเดลในรูปแบบ JSON หากรายการว่างเปล่าหมายความว่า Ollama กำลังทำงานอยู่แต่ยังไม่ได้ดึงโมเดลใดๆ มา ส่วน Connection refused หมายความว่า Ollama ไม่ได้ทำงานอยู่ หรือไม่ได้ฟังที่พอร์ต 11434
เลือกโมเดลที่ทำงานบนเครื่องนี้ได้ เซิร์ฟเวอร์ Ollama ที่ล็อกอินอยู่จะให้บริการโมเดลบนคลาวด์ผ่านที่อยู่ภายในเครื่องเดียวกันด้วย และ tag ของคลาวด์อย่างเช่น gemma4:cloud จะทำงานบนเซิร์ฟเวอร์ของ Ollama ดังนั้น prompt ของคุณจะถูกส่งออกจากเครื่องแม้ว่า dsh จะสื่อสารกับ 127.0.0.1 เท่านั้นก็ตาม
จากนั้นเพิ่ม provider เข้าไปใน profile patch โดยกำหนดค่า API key ที่ไม่ว่างเปล่าสำหรับการตั้งค่านี้ เนื่องจากเซิร์ฟเวอร์ Ollama ภายในเครื่องจะเพิกเฉยต่อค่าดังกล่าว
- id: llm-pi-ai
config:
providers:
local-ollama:
apiKeyEnv: OLLAMA_API_KEY
api: openai-completions
baseURL: http://127.0.0.1:11434/v1
models:
- id: <the exact tag printed by ollama list>Export ตัวแปรเพื่อให้กระบวนการของ dsh มองเห็นค่านี้
sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.envความล้มเหลว 3 รูปแบบครอบคลุมเกือบทุกกรณีที่พยายามทำสิ่งนี้ MISSING_CREDENTIAL หมายความว่า reference ที่ระบุโดย apiKeyEnv ไม่พบค่าใดๆ ดังนั้นให้ตรวจสอบ credentials ที่บันทึกไว้และสภาพแวดล้อมการทำงาน (launch environment) ไม่ใช่แค่ที่ terminal ของคุณ UNKNOWN_MODEL หมายความว่า id ไม่ตรงกับโมเดลที่กำหนดค่าไว้ ให้เปรียบเทียบกับ ollama list ทีละตัวอักษร รวมถึง tag หลังเครื่องหมาย colon หากเกิดข้อผิดพลาด 401 ขณะดึงข้อมูลโมเดลที่มีอยู่ แสดงว่าเกิดจาก model discovery ซึ่งเรียกใช้ GET /models บน base URL ของคุณ endpoint ที่ไม่ได้ให้บริการ path ดังกล่าวจำเป็นต้องระบุชื่อโมเดลด้วยตนเอง
อีกหนึ่งจุดที่มักพลาดคือ base URL อย่าลืมใส่ /v1 ต่อท้าย มิฉะนั้นคำขอจะส่งไปยัง path ที่ Ollama ไม่ได้ให้บริการ ทำให้ได้รับข้อผิดพลาด 404 และโมเดลจะไม่ทำงาน suffix ดังกล่าวเป็นส่วนหนึ่งของอินเทอร์เฟซที่รองรับ OpenAI ไม่ใช่แค่ส่วนประกอบเสริม
หาก Ollama ทำงานบนเครื่องอื่น ที่อยู่ของเครื่องนั้นจะกลายเป็น base URL และ prompt ของคุณจะถูกส่งผ่านเครือข่ายในรูปแบบข้อความธรรมดา (cleartext) ผ่าน HTTP ปกติ ควรเก็บไว้บนโฮสต์เดียวกัน หรือวางไว้หลัง TLS (transport layer security) และการยืนยันตัวตน: การจำกัดสิทธิ์ endpoint ของ Ollama ที่เปิดเผยต่อสาธารณะ
สิ่งที่ออกจากเครื่องในแต่ละโหมด
เมื่อใช้ DeepSeek key และ endpoint เริ่มต้น คำขอไปยังโมเดลจะส่งไปยัง API ของ DeepSeek คำขอดังกล่าวมี prompt ของคุณ เนื้อหาไฟล์ที่ agent อ่านเพื่อใช้ตอบ ค่าผลลัพธ์จากคำสั่งที่ agent เรียกใช้ และผลลัพธ์จากเครื่องมือที่ agent เลือกใส่ไว้ source code ของคุณจะอยู่ใน payload นี้ทุกครั้งที่ agent เปิดไฟล์ นี่เป็นวิธีทำงานของโมเดลที่โฮสต์อยู่ภายนอก และเป็นเหตุผลที่ควรพิจารณาว่าจะเริ่ม agent ในไดเรกทอรีใด
รุ่นที่เผยแพร่ในปัจจุบันยังแนบส่วนท้ายของ event log ใน session ที่ยังไม่ได้รับการยอมรับไปกับคำขอผ่าน native DeepSeek adapter รวมถึง gateway ที่กำหนดค่าไว้ โดยค่าเริ่มต้น ในฟิลด์ dsh_session_log แยกต่างหาก โมเดลจะไม่เห็นข้อมูลนี้ แต่ปลายทางที่รับคำขอจะได้รับข้อมูลดังกล่าว ให้ปิดใน Settings, General ("Upload Session Log when using the official model API") หรือกำหนด enabled: false ในปลั๊กอิน session-log-deepseek สวิตช์ telemetry ด้านล่างไม่ได้ควบคุมการอัปโหลดนี้
โปรไฟล์ที่เผยแพร่ยังส่งชื่อและเวอร์ชันของแพ็กเกจปลั๊กอินที่กำลังใช้งานผ่าน native DeepSeek adapter ในฟิลด์ dsh_plugin_packages แยกต่างหาก ให้กำหนด enabled: false ใน plugin-package-inventory-deepseek เพื่อหยุดการส่งข้อมูลส่วนนี้
เมื่อใช้ catalog provider อื่นหรือ gateway ของบริษัท payload เดียวกันจะถูกส่งไปยัง vendor นั้นแทน base URL จะระบุปลายทางที่แน่นอน
เมื่อใช้ endpoint ภายในเครื่อง คำขอไปยังโมเดลจะส่งไปยัง 127.0.0.1:11434 แต่การใช้ loopback address เพียงอย่างเดียวไม่ได้ทำให้ข้อมูลอยู่ภายในเครื่องเสมอไป เอกสารของ Ollama ระบุว่า "To use cloud models through this server, sign in to Ollama," ดังนั้นโมเดล cloud ที่เลือกผ่าน local server เดียวกันจะส่ง prompt และ code ของคุณไปยัง cloud ของ Ollama เฉพาะเมื่อโมเดลทำงานอยู่ภายในเครื่องเท่านั้น คำขอไปยังโมเดลจึงจะอยู่ในเครื่อง มีข้อมูล 3 ประเภทที่ยังคงออกผ่าน network แม้ในกรณีนี้ npx จะดาวน์โหลดแพ็กเกจจาก npm registry เครื่องมือใดก็ตามที่ agent เรียกใช้สามารถเข้าถึงอินเทอร์เน็ตได้เอง รวมถึง MCP (model context protocol) server ที่คุณเชื่อมต่อไว้ รายละเอียดอยู่ใน การรัน MCP server บน VPS ปลั๊กอินก็อยู่ในหมวดเดียวกัน เพราะการติดตั้งปลั๊กอินจะเรียกใช้ code ของผู้เขียนรายอื่นด้วยสิทธิ์ของ agent ดังนั้นควร ตรวจสอบว่าปลั๊กอินเข้าถึงอะไรได้บ้างก่อนติดตั้ง และยังมี telemetry ซึ่งรุ่นปัจจุบันอนุญาตให้ส่งออกไปยัง DeepSeek เมื่อคุณส่ง feedback ไม่ว่าโมเดลจะทำงานภายในเครื่องหรือโฮสต์อยู่ภายนอก
โดยค่าเริ่มต้น telemetry จำกัดอยู่ที่ feedback DSH_TELEMETRY_MODE ใช้เลือกโหมด และในการกำหนดค่าพื้นฐานที่เผยแพร่ในปัจจุบัน หากไม่ได้กำหนดค่าหรือเป็นค่าว่าง จะตีความเป็น FEEDBACK_ONLY ในโหมดนี้ กิจกรรมทั่วไปจะไม่อนุญาตให้เก็บ telemetry เมื่อคุณส่ง feedback ที่เขียนข้อความ สร้างหรือแก้ไข rating แก้ไข note หรือถอน feedback dsh จะอนุญาตให้ส่งออก session-log prefix ที่ยังไม่ได้ส่งให้ exporter ผ่าน event ของ feedback นั้น และรวม context ที่สืบทอดมา ไปยัง https://dsh-otel-collector.deepseeksvc.com/v1/logs การส่งข้อมูลครบถ้วนไม่รับประกัน: event ที่มีขนาดใหญ่เกินไปจะถูกปฏิเสธโดยไม่มีการตัดทอน และ prefix ขนาดใหญ่อาจถูกส่งออกไปได้เพียงบางส่วนเมื่อออกจาก CLI batch ที่ได้รับอนุญาตแล้วอาจส่งต่อได้โดยไม่ต้องมีการโต้ตอบหรือเรียกโมเดลเพิ่มเติม README ของ telemetry ระบุว่าสิ่งนี้มีผล "for all users and providers" ดังนั้นการรันโมเดลภายในเครื่องจึงไม่ได้ปิดการทำงานนี้ DISABLED จะไม่สร้าง transport ของ OpenTelemetry (OTel) ใด ๆ FULL ไม่ได้รับการยอมรับอีกต่อไป: ค่าใดก็ตามที่ไม่ใช่ 2 ค่านี้จะถูกปฏิเสธด้วย unsupported mode การส่งออก feedback อาจมีข้อความ ข้อโต้แย้งและผลลัพธ์ของเครื่องมือ รวมถึง path ของ workspace ดังนั้นให้ถือว่าการส่ง feedback เป็นการอนุญาตให้ส่ง session prefix นั้นไปยัง DeepSeek
หากต้องการหยุดอย่างเด็ดขาดโดยไม่ต้องพึ่งพาการตั้งค่า mode string ให้ถูกต้อง ให้กำหนด DSH_TELEMETRY_DISABLED=1 ค่าใดก็ตามที่ไม่ว่างถือเป็นการเลือกไม่เข้าร่วมที่มีผลบังคับ รวมถึง 0 และ false และระบบจะอ่านค่านี้ก่อนเริ่มการรัน ดังนั้น project code จึงไม่สามารถเปิดใช้งานกลับระหว่าง session ได้ address ของ collector เริ่มต้นคือ dsh-otel-collector.deepseeksvc.com; DSH_TELEMETRY_OTLP_URL จะใช้แทนค่าเดิม
ให้ตรวจสอบแทนการเชื่อถือค่าที่ตั้งไว้ ขณะมี task ทำงานอยู่ ให้แสดงรายการ outbound connection ที่ process ถืออยู่
sudo ss -tnp | grep -i nodeเมื่อรันโมเดลภายในเครื่อง traffic ของโมเดลจะใช้ loopback port 11434 แต่ public connection ยังอาจเกิดจากเครื่องมือได้ แม้ไม่มีการส่ง feedback โปรไฟล์ที่เผยแพร่มี web search และ fetch และ permission preset เริ่มต้นไม่ได้จำกัดการเข้าถึง network ให้ระบุ public destination แต่ละรายการก่อนสรุปว่าเป็น telemetry เพราะการดูจากเวลาเพียงอย่างเดียวไม่ยืนยันว่า connection นั้นเป็นการส่งออก feedback snapshot นี้อาจพลาด connection ที่มีอายุสั้นได้เช่นกัน การตรวจสอบนี้ครอบคลุมเฉพาะ dsh process เท่านั้น: traffic ของโมเดล cloud จะออกจาก Ollama server ดังนั้นให้ตรวจสอบด้วยว่าโมเดล id ไม่ได้เป็น cloud tag เช่นกัน สิ่งอื่นใดที่ยังไม่ทราบที่มาควรระบุให้ได้ก่อนดำเนินการต่อ สิ่งที่ coding agent ส่งออกไป ใช้การตรวจสอบแบบเดียวกันกับ harness อื่น และอธิบายวิธีอ่านผลลัพธ์
สถานที่ที่ไม่ควรเก็บข้อมูลลับ
- ประวัติการใช้งาน Shell:
export DEEPSEEK_API_KEY=sk-...จะถูกบันทึกไว้ใน~/.bash_historyในรูปแบบข้อความธรรมดา และจะยังคงอยู่ตรงนั้นนานหลังจากที่คุณหมุนเวียนคีย์ไปแล้ว ให้เว้นวรรคหน้าคำสั่งเมื่อตั้งค่าHISTCONTROL=ignorespaceไว้ หรือข้ามการใช้ shell แล้วเขียนค่าลงในไฟล์ที่มีสิทธิ์ 600 โดยตรง - ไฟล์ dotfiles ที่ถูก commit: คีย์ที่อยู่ใน
~/.bashrcหรือ~/.zshrcอาจหลุดไปอยู่ใน public repository ได้เพียงแค่การทำgit addหากคุณเก็บ dotfiles ไว้ใน git ให้รันgit grep -I -n 'sk-'ใน repository นั้นก่อนทำการ push - ไฟล์ patch ของโปรไฟล์: ใช้
apiKeyEnvสำหรับผู้ให้บริการที่กำหนดเอง เพื่อให้cordis.patch.ymlเก็บเพียงชื่อตัวแปรแทนที่จะเป็นข้อมูลลับ ไฟล์คอนฟิกมักถูกคัดลอกไปวางในรายงานปัญหาหรือแชทสนับสนุน แต่ไฟล์ข้อมูลประจำตัวไม่ควรทำเช่นนั้น - ผลลัพธ์ของ
envและภาพหน้าจอของ terminal: ทุกสิ่งที่แสดง environment ทั้งหมดออกมาจะแสดงคีย์ติดไปด้วย - การสำรองข้อมูล:
~/.dshเป็นสิ่งที่ควรสำรองข้อมูล แต่.credentials.yamlที่อยู่ภายในนั้นเป็นข้อมูลลับที่ใช้งานจริง ให้ยกเว้นไฟล์ดังกล่าวออกจากการสำรองข้อมูล หรือทำการเข้ารหัสไฟล์สำรองนั้น
กฎเหล่านี้ไม่ได้จำกัดอยู่แค่ dsh และ การเก็บข้อมูลลับไว้นอกไฟล์ env ของ Compose ได้ครอบคลุมปัญหาเดียวกันนี้ในฝั่ง container ของเซิร์ฟเวอร์เดียวกัน
การใช้งานรุ่น Developer Preview
ให้ตรึงเวอร์ชันที่คุณทดสอบไว้เสมอ เนื่องจากรุ่นพรีวิวอาจมีการเปลี่ยนแปลงคีย์การตั้งค่าในรุ่นย่อย (patch release) ซึ่งจะทำให้ผู้ให้บริการของคุณโหลดค่าไม่ได้ หากการติดตั้งที่ตรึงเวอร์ชันไว้ไม่ยอมเริ่มทำงาน หรือ npx ยังคงส่งรุ่นที่คุณไม่ได้ต้องการมาให้ ข้อผิดพลาดในการติดตั้งและเวอร์ชันที่เกิดจากรุ่นพรีวิว จะครอบคลุมถึงการจัดการ npx cache และ npm ที่มาพร้อมกับ Node ของคุณ ให้เก็บโฮมไดเรกทอรี cordis.patch.yml และไฟล์แพตช์ภายใต้ profiles/ ไว้ในระบบควบคุมเวอร์ชัน (version control) โดยยกเว้นไฟล์ credentials ไว้ เพื่อให้คุณสามารถตรวจสอบการเปลี่ยนแปลงหลังจากการอัปเกรดได้
มีสองแฟล็กที่ช่วยได้เมื่อโปรไฟล์ทำงานไม่ถูกต้อง --dump-default-config จะแสดงการตั้งค่าเริ่มต้นที่ประกอบรวมไว้โดยไม่ต้องเริ่มระบบ และ --dump-config จะแสดงการตั้งค่าที่ประกอบรวมไว้สำหรับโปรไฟล์ของคุณในลักษณะเดียวกัน การเปรียบเทียบทั้งสองค่าจะแสดงให้เห็นว่าเลเยอร์แพตช์ของคุณเปลี่ยนแปลงอะไรไปบ้าง ซึ่งรวดเร็วกว่าการอ่านเลเยอร์ด้วยตนเอง
dsh --profile web --dump-configเมื่อมีบางอย่างเสียหายหลังจากการอัปเกรด ให้รันคำสั่งดังกล่าวเป็นอันดับแรก คีย์ที่ถูกย้ายตำแหน่งระหว่างรุ่นจะปรากฏเป็นกิ่ง (branch) ที่หายไปในข้อมูลที่ดัมพ์ออกมา และการแก้ไขทำได้เพียงแค่บรรทัดเดียว แทนที่จะต้องติดตั้งใหม่ทั้งหมด
FAQ
dsh จัดเก็บ DeepSeek API key ไว้ที่ใด
ใน $DSH_HOME/.credentials.yaml ซึ่งมีค่าเป็น ~/.dsh/.credentials.yaml หากคุณไม่ได้กำหนด DSH_HOME เอง หน้า Models จะเขียน key ไว้ที่นั่น ส่วน settings จะเก็บไว้เฉพาะ reference ไปยัง key ดังกล่าว ดังนั้น secret จึงอยู่ในไฟล์เดียว ตรวจสอบ mode ด้วย stat -c '%a %n' ~/.dsh/.credentials.yaml และตั้งเป็น 600 หาก mode เปิดกว้างกว่านั้น custom provider สามารถไม่ใช้ไฟล์นี้ได้เลย โดยระบุ environment variable ด้วย apiKeyEnv
จะตั้งค่าให้ dsh ใช้ local model แทน DeepSeek API ได้อย่างไร
เพิ่ม custom provider ที่มี base URL เป็น local OpenAI-compatible endpoint สำหรับ Ollama ให้ใช้ http://127.0.0.1:11434/v1 พร้อมกับ api: openai-completions และ model id โดยคัดลอกค่าจาก ollama list ให้ตรงกันทุกตัวอักษร การตั้งค่านี้ต้องมีค่า API key ที่ไม่ว่าง แต่ local Ollama server จะไม่สนใจค่านั้น ตรวจสอบว่า endpoint ตอบสนองด้วย curl -s http://127.0.0.1:11434/v1/models ก่อนแก้ไข dsh config เพราะ endpoint ที่ไม่ทำงานและ config ที่ไม่ถูกต้องอาจทำให้เกิด error ลักษณะเดียวกัน
โดยค่าเริ่มต้น dsh ส่ง code ของฉันไปที่อื่นหรือไม่
ส่ง หากใช้ hosted model prompt และเนื้อหาของไฟล์ที่ agent อ่านจะอยู่ภายใน API request ที่ส่งไปยัง vendor นั้น และ request ผ่าน native DeepSeek adapter รวมถึง gateway ที่กำหนดค่าไว้ จะมี session-log suffix แนบไปด้วยโดยค่าเริ่มต้น จนกว่าคุณจะปิดการอัปโหลดนี้ใน Settings, General หากใช้ model ที่ Ollama รันอยู่ภายในเครื่อง request จะไปยัง loopback และอยู่บนเครื่องนั้น แต่ cloud model เช่น gemma4:cloud จะส่งต่อ request ไปยัง Ollama's cloud ผ่าน loopback address เดียวกัน Built-in web search และ fetch, เครื่องมืออื่น และ plugins อาจติดต่อ public services ได้โดยอิสระจาก feedback
Telemetry เป็น feed แยกต่างหาก ใน releases ปัจจุบัน เมื่อไม่ได้กำหนดค่า DSH_TELEMETRY_MODE จะ resolve เป็น FEEDBACK_ONLY ดังนั้น feedback จึงอนุญาตให้ส่งออก session-log prefix ผ่าน event ดังกล่าว รวมถึง context ที่สืบทอดมา สำหรับทุก provider รวมถึง local models การส่งไม่รับประกันว่าจะสำเร็จ และ authorized uploads อาจดำเนินต่อหลังจากการโต้ตอบกับ feedback แล้ว ตั้งค่าเป็น DISABLED หากไม่ต้องการ exporter หรือตั้งค่า DSH_TELEMETRY_DISABLED=1 เพื่อ opt out โดยค่าดังกล่าวจะถูกอ่านก่อนเริ่ม run
เหตุใด dsh จึงรายงาน MISSING_CREDENTIAL ทั้งที่กำหนดตัวแปรไว้แล้ว
เนื่องจาก reference ที่ระบุโดย apiKeyEnv ต้อง resolve ได้จาก credential sources ของ dsh โดย saved credentials มี precedence สูงกว่า launch environment ตามด้วย .env และ $DSH_HOME/.env ของ directory ที่ใช้เรียกใช้งาน ตัวแปรที่ export ใน shell จะไม่ถูกส่งต่อไปยัง systemd service, session ของผู้ใช้อื่น หรือ process ที่เริ่มทำงานก่อน export ตัวแปรนั้น ใส่ค่าไว้ใน EnvironmentFile โดยตั้ง mode เป็น 600 สำหรับ unit หรือ export ค่าใน shell เดียวกับที่ใช้เริ่ม dsh ตรวจสอบค่าที่ running process ถืออยู่จริงด้วย sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ
dsh ต้องใช้ Node.js version ใด
Node.js 24.9 หรือใหม่กว่า ตาม package.json ของ repository ณ วันที่ 5 November 2026 สาย 22 ไม่ได้รับการรองรับแล้ว และ Node 24.0 ถึง 24.8 ก็ยังไม่เพียงพอ เรียกใช้ node -v ก่อนดำเนินการอื่น เนื่องจาก startup failure จาก runtime ที่ไม่รองรับอาจดูเหมือนการติดตั้งเสียหาย และทำให้ผู้ใช้ไปติดตั้ง package ใหม่แทนที่จะติดตั้ง runtime ใหม่