一次性任务（headless）profile —— dsh run 默认使用 headless

dsh plugin --profile headless add "C:/path/to/dsh-tool-encoding"


包内 `dsh.bundle.patch`（指向 `cordis.patch.yml`）会在安装后自动把插件加入 profile 的 layer stack；插件的 `cordis.patch.yml` 以 `- insert:` 插入 `tool-encoding` 条目。插件缺失的 peer 依赖（`cordis`、`@deepseek-ai/dsh-tools`）由 profile 的 healed `profiles/node_modules` 回退安装提供。

> ⚠️ web 与 headless 是**不同 profile**：web 安装不会自动覆盖 headless；`dsh run` 默认使用 headless profile。Windows 路径使用正斜杠（`C:/...`）。

### 验证安装

```sh
dsh --profile web --dump-config | grep tool-encoding

运行验证

dsh run "使用 encoding 工具把 hello 做 base64 编码"

手动安装与旧版本兼容

仅适用于不支持 Profile Bundle 的旧快照或插件开发调试环境：

放入 monorepo：cp -r encoding ~/.dsh/source/master/packages/tools/encoding（开发调试）
apps/cli/package.json 加 "@deepseek-ai/dsh-tool-encoding": "workspace:^"；tsconfig.host.json references 加 { "path": "./packages/tools/encoding" }
pnpm install && pnpm run build
在 profile 用户层 patch 插入插件（~/.dsh/profiles//cordis.patch.yml）：

- insert:
    - id: tool-encoding
      name: '@deepseek-ai/dsh-tool-encoding'

验证：dsh --profile --dump-config | grep tool-encoding

0806 注意：patch 是 id-targeted 语义——裸 - id: 条目会报 entry "xxx" not found，必须用 - insert: 列表包裹。

已知限制

分发链路：@deepseek-ai/dsh-tools 私有，需 monorepo workspace
任意二进制（不可打印字节）编解码需 v2 的 output: "utf8" | "hex" 模式
hash 仅摘要，无 HMAC/加盐/密钥派生；MD5/SHA-1 仅兼容性/非安全完整性校验
URL 是 component 语义；表单编码（空格 → +）需独立 action（v2）

测试

pnpm test

功能/错误/攻击载荷共 41 个用例（RFC 4648/1321/6234 已知向量、UTF-8 边界区分、canonical padding 边界、surrogate 统一拒绝等）。完整清单见本地维护的设计文档。

许可

MIT

@deepseek-ai/dsh-tool-encoding

AI 分析

安装

说明文档

一次性任务（headless）profile —— dsh run 默认使用 headless

运行验证

手动安装与旧版本兼容

已知限制

测试

许可