dsh-wsl-secret

语言： 中文（本页） · English

在 DSH（Cordis）里安全读取 pass / age 密钥。

为什么要单独插件

• dsh-wsl-cred → 只给 Git 推送/拉取的凭据提示
• dsh-wsl-secret → OpenRouter、Discord Bot Token 等应用密钥

secret_status 显示 ready=false = 已安装但未配置，属正常安全默认。

5 分钟上手

1. 装工具（一次）

sudo apt install pass age
# 需要时: pass init <gpg-id>

2. 密钥放在同一前缀下

pass insert dsh/openrouter
pass insert dsh/discord-bot

3. Cordis 放行该前缀

编辑 profile 的 cordis.patch.yml（例如 ~/.dsh/profiles/web/cordis.patch.yml）：

plugins:
  dsh-wsl-secret:
    enabled: true
    path: /mnt/c/Users/你/Desktop/AIFullStackDevelopment/dsh-wsl-secret
    config:
      allowPrefixes:
        - dsh
        # - ~/secrets          # age 用文件系统根
      reveal: false
      timeoutMs: 15000

重启 / 重载 profile。

4. 推荐工具链

{ "name": "secret_to_env", "arguments": {
  "name": "dsh/openrouter",
  "envKey": "OPENROUTER_API_KEY"
}}

之后同一 dsh 进程内其它工具可读 process.env.OPENROUTER_API_KEY。

工具一览

安全模型（摘要）

1. 空 allowPrefixes → 全部拒绝
2. pass 名必须匹配前缀（dsh → dsh/...）
3. age 路径必须在列表里的目录根下
4. 默认 reveal: false，结果不含完整密钥
5. 优先 secret_to_env，避免把明文塞进模型上下文
6. 永远不要把密钥贴进聊天

更细的英文说明见 README.en.md。

兼容性

License

MIT