动手用 dsh

dsh --help                    # 启动器自己的 help
dsh --profile web --help      # web app 的 help（--port 在这里）
dsh web --port 8080           # --port 属于 web app，不属于启动器
dsh --profile headless "跑测试"  # 之后全是任务文本

node -v                              # 期望 v22.x
npm i -g @deepseek-ai/dsh
which -a dsh                         # 看会不会命中多个版本
dsh --version                        # 期望 0.1.5-rc.2 或更新
npm config get prefix                # 确认 <prefix>/bin 在 PATH 里

dsh web                                  # = dsh --profile web，默认 3080
dsh --profile web --port 8080 --no-open
dsh --profile headless "任务"             # 一次性：答案走 stdout，推理走 stderr
dsh --profile acp                        # Agent Client Protocol stdio
dsh --profile sdk                        # SDK JSON-RPC stdio

# 彻底重启 web（只刷新浏览器不会加载新插件）
kill $(lsof -tiTCP:3080 -sTCP:LISTEN)
dsh web

dsh --profile web --dump-default-config   # 只看 bundle 默认层
dsh --profile web --dump-config           # 叠加你的 patch 后的完整树
dsh --profile web --dump-config | grep -c '^- id:'   # 数插件条目，本机 web = 152
dsh --profile web --dump-config | grep -B2 -A6 'patched by'  # 看哪条 patch 生效了

dsh --profile rescue --from-default-profile web   # 基于 web 模板建新 profile
dsh plugin --profile web add <npm-pkg>            # 转发给 profile 目录里的 pnpm
dsh plugin --profile web remove <npm-pkg>         # remove 会自动从 bundles 摘除
dsh --profile web --patch ./extra.yml             # 临时叠加一个覆盖层

# 会话是 zstd 压缩的 JSONL，逐行一个事件
zstd -dc ~/.dsh/sessions/*/session-*/session.v3.jsonl.zstd | head
# 事件类型：user/message, assistant/message, tool/call, tool/result, turn/start ...

dsh --profile web --dump-config | grep -B2 -A6 'patched by'

# 期望看到类似：
# == @deepseek-ai/dsh-base, patched by /path/to/disable-timer.yml
- id: timer
  name: '@deepseek-ai/cordis-plugin-timer'
  disabled: true

- id: skill-filesystem
  config:
    customSkillDirs:
      - /Users/you/.claude/skills

- id: hooks-claude-code
  name: '@deepseek-ai/dsh-hooks-claude-code'
  config:
    configPath: /Users/you/.dsh/hooks.json
    defaultTimeoutMs: 15000

# 拿一个只存在于 ~/.claude/skills 的自建 skill 去问，把 your-skill-name 换成你的
dsh --profile headless "你的可用 skill 列表里有没有 your-skill-name。不要调用工具。"
dsh --profile web --dump-config | grep -A5 'id: skill-filesystem'

rm -f ~/.dsh/cordis.patch.yml ~/.dsh/AGENTS.md ~/.dsh/hooks.json
rm -rf ~/.dsh/skills          # 只删软链，不动 ~/.claude/skills 本体

{
  "dependencies": { /* 树外插件装在这里 */ },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@liustack/modsearch",
        "dshmarket"
      ],
      "patchReload": "live"   // 或 "startup"
    }
  }
}

packages:
  - .

# pnpm 默认 isolated 模式会让部分子包嵌套收敛；hoisted 更稳
nodeLinker: hoisted
autoInstallPeers: false

# 第三方包的构建脚本默认被拦；false = 明确不执行（本项目不需要）
allowBuilds:
  cloudflared: false
  cpu-features: false
  node-pty: false
  ssh2: false

# 绕过 pnpm 11 对新发布包的时间门禁
minimumReleaseAgeExclude:
  - '@linxin666/*'

dsh plugin --profile web add /path/to/your-plugin
# 然后在 profiles/web/cordis.patch.yml 里 insert：
# - insert:
#     - id: your-plugin
#       name: your-plugin-name
# 重启 dsh web，刷新浏览器

node -v                                  # 期望 v22.x
which -a node dsh pnpm                   # 看 PATH 顺序，GUI 环境尤其要查
dsh --version                            # 期望 0.1.5-rc.2 或更新
dsh web --port 0 --no-open               # 能起来说明后端正常，Ctrl+C 退出
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3080
dscacheutil -q host -a name localhost    # 不应出现 198.18.x.x
dsh --profile web --dump-config | grep -c '^- id:'   # 本机实测 152

npm view @deepseek-ai/dsh version
npm view @deepseek-ai/dsh repository.url
dsh --version
dsh --profile web --dump-config | grep -c '^- id:'