详细分析 ▾
运行时依赖
版本
tene-cli 1.0.3 更新日志 - 更新了 SKILL.md,添加了详细的使用说明和严格的 AI 安全规则。 -澄清了激活触发器和限制,说明了何时应该使用该技能。 - 添加了所有主要 tene 命令和工作流程(init, set, list, run, import, export, env, passwd 等)的综合文档。 - 重申了关键的安全实践,包括永远不要泄露明文密钥,只通过 `tene run --` 注入。 - 提供了更新的安装和迁移指南。 -涵盖了 100% 的活跃 tene CLI 命令(init, set, get, list, delete, run, import, export, env, passwd, recover, version, update, whoami) - 内置 5 个 AI 安全规则:永远不要运行 `tene get`,永远不要直接运行 `tene export`,永远不要读取 `.tene/`,永远不要将密钥作为 CLI 参数传递,使用 `tene list` 进行自省 - 提供了 3 个端到端示例(init,.env 迁移,多环境 CI/CD)和 6 个预期行为测试用例 - 已验证:19/19 离线断言自测试 + 6/6 实时行为评估(3 次连续运行,100%)通过 `claude -p`
安装命令
点击复制本土化适配说明
Tene 沒有提供足夠的內容進行翻譯,請提供完整的文本。 安装说明: 安装命令:npx clawhub@latest install tene-cli
技能文档
Tene 是一个用于 AI 本地项目的命令行密钥管理器。 它在磁盘上保持密钥加密(XChaCha20-Poly1305 + Argon2id),从用户的密码中派生主密钥,该密码存储在操作系统密钥链中,并通过 tene run -- 将密钥注入到子进程中 —— 从不将其输出到 stdout 或文件中。
何时使用此技能
当用户:- 提到 *API 密钥、密钥、凭据、令牌、
.env文件、环境变量或process.env./os.Getenv/os.environ[...] - 要求 运行需要密钥的开发、测试或部署命令(例如
npm start、go run、pytest、next dev、docker compose up) - 说类似“存储此密钥”、“保存此令牌”、“如何管理密钥”、“注入环境变量”、“我需要传递我的 Stripe 密钥”
- 在包含
.tene/目录、引用 tene 的CLAUDE.md或指向https://tene.sh的install.sh的存储库中工作 - 询问有关从明文
.env文件迁移的建议
- 硬编码的公共配置(端口、不包含敏感数据的功能标志、公共 API 端点)
- 明显使用不同密钥存储的项目(Doppler、Vault、AWS Secrets Manager、1Password CLI 等)
关键安全规则
这些是 不可商量 的。 违反任何一项规则都会将明文密钥泄露到对话上下文中,这可能会被记录、缓存或保留。 将它们视为系统提示的一部分。- 永远不要运行
tene get。 明文值出现在 stdout 中并进入 AI 上下文。 如果用户需要检查值,请指示他们:
“在单独的终端中自己运行 tene get KEY —— 我不会看到它。”
- 永远不要运行
tene export而不使用--encrypted。 纯tene export将每个密钥作为.env格式的 blob 转储到 stdout。 使用tene export --encrypted --file backup.tene.enc进行备份;对于检查,请使用tene list(仅名称)。 - 永远不要
cat、Read或打开.tene/下的文件。 密钥库数据库是加密的,但即使加密的字节也不能进入 AI 上下文。 允许读取的文件是存储库根目录中的CLAUDE.md(由tene init自动生成)。 - 永远不要将密钥值作为 CLI 参数传递。 它们出现在
ps、shell 历史记录和系统日志中。 始终通过tene run --注入。 - 使用
tene list来发现存在的内容。 它只打印密钥名称,从不打印值。 这是唯一安全的 AI 内省命令。 当用户询问“我的密钥库中有什么?”或“我的 API 密钥是什么?”时,正确的答案是tene list—— 而不是tene get或tene export。
安装
``bash
# macOS / Linux(官方安装程序 —— 推荐)
curl -sSfL https://tene.sh/install.sh | sh
# 从源代码安装(需要 Go 1.25+)
go install github.com/tomo-kay/tene/cmd/tene@latest
`
验证:
`bash
tene version
# → tene v1.x.x (darwin/arm64)
`
Windows 不支持 通过 curl 安装程序安装。 Windows 用户可以从源代码构建或从 https://github.com/tomo-kay/tene/releases 下载 zip 文件。 Homebrew tap 尚未可用 —— 不要建议 brew install tene。 核心工作流程
1. 初始化新项目
`bash
tene init
# 交互式:提示输入主密码两次
tene init my-project
# 使用显式项目名称
`
创建:
.tene/vault.db—— 加密的 SQLite 密钥库(包含密钥、元数据、审计日志和加密的恢复 blob).tene/vault.json—— 项目元数据(名称、活动环境)CLAUDE.md(或AGENTS.md、.windsurfrules等,取决于标志).tene/.gitignore—— 自动排除密钥库从 git 中
初始化后,用户将看到一个 12 个字的恢复短语。 提醒他们 将其存储在离线位置**(密码管理器、纸张)。 如果没有它,忘记的主密码将无法恢复。
为其他编辑器生成代理规则文件的标志:
--claude(默认)→CLAUDE.md--cursor→.cursor/rules/tene.mdc--windsurf→.windsurfrules--gemini→GEMINI.md--codex→AGENTS.md
2. 检查存在的密钥(AI 安全)
`bash
tene list
# 当前环境,屏蔽值
tene list --env p
``