空缺的博客

生命不息，折腾不止。前两课我们把 Server 造出来、挂上公网，工具是能给模型用了；这一课补上另一半——让人也用得顺手：给 Server 加一份能点的菜单（Prompts）、会猜的参数框（Completion）、长任务不再干等的进度条（Progress），最后把好几个 Server 同时挂进 dsh 和 Claude Code，拼出一套混合工作流。 一、先把「给客户端看的东西」分清楚前两课我们一直在做「模型能用的东西」：Tools 给模型调、Resources 给应用读。但一个 Server 挂在客户端上，用户打开界面看到的是什么？是三个东西： 原语 谁在控制 长什么样 典型用途 Tools 模型 模型自己决定要不要调 干活、改数据、调外部 API Resources 应用 像附件，被应用读进来当上下文 文件、日志、数据库行 Prompts 用户 客户端里的一份菜单／斜杠命令 固定套路的提问模板 除了这三个「正牌原语」，MCP 还给了两个辅助能力，专门改善「人用起来的手感」，也是这一课的重点： Completion：用户在参数框里打字时，Serve...

生命不息，折腾不止。上一篇的 MCP Server 只会算加法，这一篇把它变成真能干活的：接上真实的 SQLite 和文件目录，把 Resources 的 URI 模板讲透，再把 Server 从本地 stdio 换成 Streamable HTTP 加鉴权挂到公网，让 dsh、Claude Code 几个客户端共用同一套工具。 上一篇（MCP 实战第一课）我们把 MCP 是什么、三个原语、客户端-服务器架构讲清了，也跑通了一个只会 add(a, b) 的玩具 Server。说实话，玩具跑通那一下爽，但它连你硬盘上的一个文件都读不到，更别说数据库。 这一篇就解决「玩具到真家伙」的距离。全程还是 Python，还是当前稳定版的 mcp（2.3.0，协议修订 2026-07-28），命令我都实机跑过或者对着官方文档核过，拿不准的地方我会标出来。 一、先想明白：从玩具到真家伙，差三块别看代码量不大，一个能用的 Server 和玩具之间隔着三件事，缺一件都上不了生产： 数据层——它得能碰到你真实的数据。SQLite、MySQL、一堆 Markdown 文件、公司内部 API，随便哪...

生命不息，折腾不止。这一篇开个新坑：MCP 实战系列第一课，先把「MCP 到底解决什么问题、它凭啥不是又一个 API 规范」讲透，再手把手跑通你人生中第一个 MCP Server，让任意 Agent 客户端都能调用你本地暴露出来的工具。 前面折腾 DeepSeek Harness 的时候，我在十几篇里反复提到一个词：MCP。装插件接 MCP、给 Claude Code 接 MCP 外接工具……但每次都只用了它的一小块，从没停下来认真问一句：这东西到底是个啥，为什么现在 Claude、Cursor、DeepSeek Harness、各种 Agent 框架都在抢着认它？ 今天把这个问题彻底掰开，然后自己动手写一个，跑通为止。看完这篇你会发现，MCP 真不是又一个「会过时的 API 规范」，而是给 AI 工具定了根「USB-C 线」。 一、先搞清楚：MCP 在解决「N×M 对接地狱」先看没有 MCP 的时候，世界长什么样。 你有 N 个 AI 客户端：Claude Desktop、Claude Code、Cursor、dsh、各种自研 Agent……每个都挺能干，但都「手不够长」，...

生命不息，折腾不止。这个系列前前后后折腾了十几篇，今天把它们全压成一张可收藏的速查表——从「怎么装」到「半夜自动跑」一条龙查得到，前面零散的命令，看完这篇就串起来了。 从 8 月底接入中转站到现在，我们在 DeepSeek Harness（下称 dsh）这条线上折腾了十几次：装插件、写插件、接 MCP、自定义 Provider、Creator 自进化、权限、沙箱、Trajectory 回放，最后到无头自动化。内容不少，散在十几篇里，真要抄命令得翻半天。这一篇做收口：把命令、配置、环境变量、目录结构全摊成表，当字典用。建议直接收藏。 一、先记住一句话：dsh 是「profile 启动器」很多人以为 dsh 是个聊天终端，不是。官方定位很明确——dsh 是 profile 启动器，本身不管交互，只负责把你交给某个 profile（一组插件的组合）去跑。整个 CLI 只有四个入口，记住这张表基本就够用了： 命令 干什么 dsh --profile <name> 启动 $DSH_HOME/profiles/<name> 这个 profile d...

生命不息，折腾不止。这一篇把「人工守着点」变成「写完睡觉、明早收结果」——不开浏览器、不起服务，一条命令让 dsh 的 Agent 自己把活干完。 前面几篇我们一直在 Web 界面里点来点去玩 dsh（DeepSeek Harness），今天聊点真正能落地的：无头模式（headless）。它干的事特别朴素——跑一个任务、把最后一段回答打到终端、然后退出。就这三个动作，却正好是自动化（cron、CI、shell 脚本）要的形状。上个月就有不少兄弟问我「能不能让它半夜自己干活」，答案全在这一篇。 一、先想明白：dsh 不是「聊天终端」，它是个 profile 启动器很多人以为 dsh 命令是个类似终端聊天（TUI）的东西，其实不是。官方对它的定位很明确：dsh 是一个 profile 启动器，它本身不管交互，只负责把你交给某个「profile」（配置组合）去跑。它有四个入口： 命令 干什么 dsh --profile <name> 启动 $DSH_HOME/profiles/<name> 这个 profile dsh --profile h...

生命不息，折腾不止。今天教你读懂 dsh 那张「只增不改」的会话日志——Agent 每一步干了啥、烧了多少 token、哪里跑偏了，全都有据可查。 一、先搞清楚一个核心：dsh 的会话是「只追加」的账本很多人用 DeepSeek Harness（dsh）跑 Agent，跑完就完事了，从没想过「它刚才到底怎么想的」。其实 dsh 从底层就把每一次会话都当成一本只追加（append-only）的账本在记——这正是官方反复强调的那句「Every run is traceable（每次运行都可追溯）」的底气所在。 什么意思？你发一句话，Agent 思考、调工具、改文件、回结果，这一连串动作会被拆成一条条事件（event），按顺序（seq 从 0 连续编号，events[i].seq === i）追加进日志里。关键点在于： 只追加、不改写：历史事件写进去就永远在那里，不会被覆盖。这跟 git 的 commit 是一个思路，所以它天然支持「回放」「分叉」「回溯」。 resume、fork、search、replay 全都操作同一条事件流：这是 dsh 官方原话。恢复会话、从中间分叉、搜...

生命不息，折腾不止。上一篇我们亲手写了一个插件，这一篇反着来——不写代码，一条命令把别人写好的插件搬进来，五分钟把 Agent 武装起来。 上个月我们搞定了 DeepSeek Harness（下称 dsh）的基础安装和「写第一个插件」，算是把「一切皆插件」的骨架摸了一遍。但说实话，什么都自己写太累了，一个能用的 Agent 要的插件堆起来能绕地球半圈。好在 dsh 的生态起得飞快，社区已经攒了一堆现成插件，还有专门的插件市场帮你挑。这篇就讲清楚：去哪儿找插件、怎么一条命令装上、装完怎么验证、以及装第三方代码时安全这条线怎么守住。 一、先想清楚：你在「用插件」还是「写插件」dsh 的插件机制上一回已经讲过核心——每个能力都是插件，插件通过一个 dsh.bundle 清单告诉 Harness 自己贡献了什么。落到使用上，就有两个完全不同的动作： 写插件：自己在本地写代码、打包成 bundle 再挂上去（上一篇文章干的活）； 用插件：从 npm 或 GitHub 把别人打包好的 bundle 拉下来，装进某个 profile，重启就能用。 这篇专注第二个动作。你只需要记住两个名...

生命不息，折腾不止。上一篇把「权限」和「沙箱」两个旋钮盘明白了，这一篇钻进去看沙箱本身——dsh 到底靠什么把命令关进笼子，又是怎么靠一条命令就能验出这笼子是铁的、还是纸糊的。 上一篇聊到最后，我留了一句挺关键的话：dsh 的沙箱不是「绝对安全边界」。这话只说了一半，今天把它补完整——沙箱这条链路上，ctx.sandbox.confine 到底在做什么，三套后端（Linux 的 bwrap / Landlock、macOS 的 Seatbelt、Windows 的 ACL）各自怎么落地文件隔离，为什么有的地方只能「部分生效」，以及最要命的：文件被锁死了，沙箱就真的安全了吗？ 一、先破除一个错觉：dsh 的沙箱，只管「文件写」这一件事一提「沙箱」，很多人脑子里浮现的是 Docker 那套——网络隔离、进程隔离、文件系统隔离全套。但 dsh 的 ctx.sandbox 不是这么回事，它的官方定义窄得有点反直觉： SandboxMode 只管 filesystem effects（文件系统的写入效果），三个档：read-only（只读，只放行 /dev/null 这一个...

生命不息，折腾不止。上一篇让 Agent 学会「给自己造工具」，这一篇补上最关键的那道闸：造出来的工具、跑起来的命令，到底谁能写文件、谁得先问你一句——两个旋钮，一个叫沙箱、一个叫审批，今天就把它俩彻底盘明白。 接上一篇的尾。Creator 模式聊到最后，收在了一句挺吓人的话：「沙箱 ≠ 安全边界，信任这套工具集，等价于信任 bash」。那句话其实只讲了 cordis_* 那七个工具自带的 node:vm 沙箱。今天要聊的，是 dsh 每个 Agent 每次跑命令都会过的那道文件边界——权限系统（Permissions）。 这套东西看着简单，其实最容易被两拨人同时误解：一拨人以为「开了 danger-full-access 就百无禁忌」，另一拨人以为「开了沙箱就刀枪不入」。两个都是错的。咱们一层层拆。 一、先分清：权限（Permission）和沙箱（Sandbox）不是一回事这是官方文档开篇就警告的点，但 90% 的人会把它俩混成一个词。它俩的分工清清楚楚： 权限（Permission） 沙箱（Sandbox） 管什么 操作的「模式档」+ 要不要批准 命令执行那...

生命不息，折腾不止。DeepSeek Harness 最反直觉的一招：Agent 不只能「用」工具，还能在运行时给自己「造」工具——Creator 模式配七个 cordis_* 工具，就是这套「自进化」的总开关。 前两篇我们把 dsh 跑起来、接上了自定义 Provider（想接 Claude/GPT 的话，中转站 ai.aklibk.com 国内直连、免绑卡、人民币按量付费，上一篇文章有完整步骤）。今天聊点更野的：让 Agent 在跑的时候，自己查运行时、自己写插件、自己热插拔。这就是 Creator 模式。 一、Creator 模式到底是什么dsh 一共四个运行模式，切模式切换的不是模型，而是「这台 Agent 被允许拥有什么手脚」： Standard（标准）：完整工具组合——文件编辑、shell、搜索，默认的编码 Agent 就是它。 Code（代码，也叫 PTC）：让模型生成一段代码来编排多轮工具调用，而不是一次只吐一个工具调用。 Minimal（极简）：只留一个 shell + 一个文件编辑工具，专给模型做基准测试用，是最诚实的「框架本身贡献了多少」的测...