dsh-our-free-model 開(kāi)發(fā)指南內(nèi)核接縫、inject 依賴注入與 3 個(gè)耗時(shí)的內(nèi)核行為【免費(fèi)下載鏈接】dsh-our-free-model在 dsh 里裝上這個(gè)插件即可無(wú)需登錄、注冊(cè)或填 API Key就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在內(nèi)的前沿模型——完全免費(fèi)不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ds/dsh-our-free-modeldsh-our-free-model 是 dsh 的免費(fèi)模型插件裝上即可使用 DeepSeek V4.1 Flash、Kimi K3 等前沿模型——無(wú)需登錄、注冊(cè)或 API Key完全免費(fèi)不限量。這篇文章面向想給這個(gè)免費(fèi)模型插件寫(xiě)代碼的貢獻(xiàn)者講清插件坐在內(nèi)核上的兩個(gè)結(jié)構(gòu)性決策內(nèi)核接縫與inject 依賴注入并復(fù)盤 3 個(gè)真實(shí)消耗過(guò)調(diào)試時(shí)間的內(nèi)核行為幫你少走彎路。整體架構(gòu)一個(gè)適配器兩條 provider 路由先建立全局認(rèn)知。這個(gè)插件是純掛載式不改內(nèi)核、零依賴、無(wú)構(gòu)建步驟同一份代碼能同時(shí)跑在 dsh 0.1.5 與 0.1.7 兩代內(nèi)核上。目錄分工如下位置職責(zé)index.jsHost 半身適配器注冊(cè)、探測(cè)、存儲(chǔ)、路由、轉(zhuǎn)發(fā)端口、升級(jí)接線adapter/內(nèi)核接縫全包唯一允許 import 內(nèi)核模塊的位置src/adapter.js結(jié)構(gòu)性 LlmAdapterlistModels / resolveModel / stream 等src/messages.js消息投影到三種線協(xié)議 工具調(diào)用配對(duì)修復(fù)client.js瀏覽器半身設(shè)置頁(yè)六個(gè)頁(yè)面手寫(xiě) bundle核心技巧是結(jié)構(gòu)化實(shí)現(xiàn)鴨子類型內(nèi)核從不執(zhí)行 instanceof 檢查因此插件不 import 具體內(nèi)核類型、不鎖定內(nèi)核版本靠約定好的結(jié)構(gòu)契約掛載。這一點(diǎn)對(duì)多內(nèi)核版本兼容至關(guān)重要。內(nèi)核接縫一行 grep 就能審計(jì)的依賴邊界adapter/kernel.js 是全包唯一允許點(diǎn)名deepseek-ai/*模塊的文件——這條生態(tài)打包規(guī)則adapter 層外不允許引用內(nèi)核模塊用一行 grep 即可審計(jì)。目前接縫上只承載一件事歸因 User-Agent。設(shè)計(jì)上有兩個(gè)值得借鑒的點(diǎn)窄類型聲明——adapter/dsh-llm.d.ts 只聲明接縫實(shí)際調(diào)用的那一個(gè)函數(shù)刻意比內(nèi)核自身表面更窄類型檢查就只檢查這一小片。懶加載 降級(jí)——見(jiàn) resolveAttributionUserAgent插件不鎖定內(nèi)核版本模塊由宿主解析若當(dāng)前 composition 供不出該模塊就降級(jí)為一個(gè)字面量 User-Agent保證歸因始終存在。 啟示把「對(duì)內(nèi)核的依賴」收斂到一個(gè)文件其余源碼就變成純消費(fèi)者未來(lái)內(nèi)核升級(jí)時(shí)改動(dòng)面一目了然。inject 依賴注入三種服務(wù)訪問(wèn)方式插件與內(nèi)核cordis 容器交互的核心是一張表——不同的服務(wù)訪問(wèn)方式不同缺失時(shí)的行為天差地別方式語(yǔ)義服務(wù)缺失時(shí)本插件用法inject [llm]硬依賴聲明即待命整條 fiber 保持 PENDING模型車道唯一硬依賴ctx.get(name)機(jī)會(huì)式查找返回undefined不拋錯(cuò)connection、attachments 等可選服務(wù)ctx.inject(deps, cb)服務(wù)就緒后運(yùn)行回調(diào)回調(diào)掛起等待就緒后執(zhí)行webServer、credentials屬性直讀ctx.xxx讀未聲明服務(wù)的 mixin直接拋錯(cuò)不是 undefined禁用見(jiàn)下文行為 ③硬依賴聲明在 index.js只有一行export const inject [llm]這是刻意的最小化llm是插件存在的全部理由其它任何服務(wù)都不許出現(xiàn)在頂層 inject 里——否則在無(wú) HTTP 服務(wù)的極簡(jiǎn) composition如 TUI中插件會(huì)因等待一個(gè)永不提供的服務(wù)而永久不激活。headless 環(huán)境寧可「有模型、沒(méi)有設(shè)置頁(yè)」也不能什么都沒(méi)有。webServer 的正確打開(kāi)方式獨(dú)立 fiber 待命設(shè)置頁(yè)路由掛在 webServer 上而瀏覽器半身總是在插件加載之后才發(fā)布 webServer。于是有兩種讀法兩種結(jié)局?apply時(shí)讀一次ctx.get(webServer)→ 得到undefined→ 路由全部未注冊(cè) → 設(shè)置頁(yè)沒(méi)有數(shù)據(jù)源而 web server 正在用它自己的頁(yè)面「服務(wù)」你? 用 ctx.inject 獨(dú)立 fiber回調(diào)在 webServer 就緒前掛起自己的 fiber就緒后自動(dòng)執(zhí)行并注冊(cè)路由且從不阻塞上面的模型車道。connection服務(wù)同理但它更微妙瀏覽器半身發(fā)布它也在插件之后所以插件逐請(qǐng)求查找而不是在 apply 時(shí)快照一次快照會(huì)讓信任圍欄在整個(gè)進(jìn)程周期內(nèi)退化為降級(jí)形態(tài)。3 個(gè)真實(shí)消耗過(guò)調(diào)試時(shí)間的內(nèi)核行為以下三條來(lái)自 README.md 的開(kāi)發(fā)者復(fù)盤編寫(xiě) provider 插件時(shí)基本都會(huì)遇到① providerRetryPolicy() 的返回值會(huì)被「原樣保存并使用」兩代內(nèi)核都不解析該返回值退避調(diào)度器直接讀頂層的initialDelayMs / maxDelayMs / jitterRatio。如果把這些字段嵌套在backoff: {}里調(diào)度器讀到undefinedundefined * 2? NaN而持久會(huì)話日志拒絕非有限數(shù)值——一個(gè)本可恢復(fù)的瞬時(shí)故障因此報(bào)廢整輪對(duì)話。正確做法是返回已解析完畢的扁平策略見(jiàn) providerRetryPolicy同時(shí)注意retryableCodes里刻意不含RATE_LIMIT429 的 retry-after 是遞增的自動(dòng)重試等于把同一回合付費(fèi)三次。② 一次被中斷的工具調(diào)用會(huì)永久污染該會(huì)話工具調(diào)用與結(jié)果之間被中斷用戶取消、進(jìn)程崩潰會(huì)在持久歷史里留下一條「沒(méi)有對(duì)應(yīng)結(jié)果的工具調(diào)用」。重放時(shí)上游返回400 invalid_request_error此后該會(huì)話的每一次請(qǐng)求都失敗。插件的解法是在發(fā)送前統(tǒng)一修復(fù)配對(duì)三種線協(xié)議Chat / Messages / Responses共用同一處邏輯見(jiàn) repairToolPairing。③ 未在 inject 中聲明的服務(wù)屬性直讀拋錯(cuò)ctx.get() 卻返回 undefined這是本輪踩過(guò)的兩個(gè)坑的合流把 inject 縮減為僅剩llm后讀ctx.intervaltimer 服務(wù)上的 mixin直接拋出cannot get property timer without inject——插件在所有 composition 中不再激活。修法后臺(tái)循環(huán)改用普通 unref 定時(shí)器完全不碰未聲明服務(wù)改用ctx.get(webServer)后得到undefined——原因不是缺服務(wù)而是加載順序插件先于 web 半身。修法見(jiàn)上節(jié)ctx.inject(deps, callback)為該服務(wù)開(kāi)一條獨(dú)立 fiber 使其待命避免在加載瞬間做一次性判斷。一句話總結(jié)硬依賴進(jìn) inject可選服務(wù)用 ctx.get 逐次讀晚到服務(wù)用 ctx.inject 開(kāi) fiber 等待。驗(yàn)證不出網(wǎng)、不消耗額度的離線套件上述每個(gè)行為都有常駐斷言守門改動(dòng)后跑一條命令即可全量回歸npm test套件守住的行為scripts/retry-safety-test.mjs退避策略可持久化、429 不再自動(dòng)重試、usage 計(jì)數(shù)scripts/picker-test.mjs選擇器只廣播可用模型、401 信任圍欄scripts/tui-test.mjs無(wú) web server 的 composition 中插件照常啟動(dòng)scripts/speed-stat-test.mjs任何一次調(diào)用不被平均成虛假的 tok/s全部離線不出網(wǎng)、不消耗免費(fèi)額度共享測(cè)試腳手架會(huì)把兩條免密來(lái)源默認(rèn)指向已關(guān)閉的本機(jī)端口。用量看板數(shù)據(jù)留在本機(jī)布局修復(fù)有對(duì)照統(tǒng)計(jì)只落在本機(jī)stats.json。早期看板有一處純視覺(jué)問(wèn)題——Token 熱力圖格子間距過(guò)大、無(wú)法按周對(duì)齊修復(fù)后呈現(xiàn)連貫的貢獻(xiàn)圖譜觀感對(duì)應(yīng) issue #11布局本身已是列優(yōu)先周對(duì)齊只需 gap 歸零與圓角收小開(kāi)發(fā)者速查清單? 內(nèi)核 import 只進(jìn) adapter/其余源碼保持純結(jié)構(gòu)消費(fèi)者? 頂層inject只聲明llm其余服務(wù)全部「可選」? 晚到的服務(wù)webServer 等用ctx.inject獨(dú)立 fiber不在 apply 時(shí)做一次性快照? 重試策略返回扁平的完整對(duì)象字段別嵌套? 發(fā)送前跑一遍工具配對(duì)修復(fù)覆蓋三種線協(xié)議? 每個(gè)修復(fù)配一條離線斷言用 npm test 防回歸掌握內(nèi)核接縫與 inject 的分層思路、避開(kāi)這三個(gè)內(nèi)核行為的陷阱你就能在這個(gè)免費(fèi)模型插件上安全地做二次開(kāi)發(fā)。更多背景見(jiàn) README.md 的「實(shí)現(xiàn)結(jié)構(gòu)」與「已知邊界」兩節(jié)?！久赓M(fèi)下載鏈接】dsh-our-free-model在 dsh 里裝上這個(gè)插件即可無(wú)需登錄、注冊(cè)或填 API Key就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在內(nèi)的前沿模型——完全免費(fèi)不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ds/dsh-our-free-model創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考