Starter Templates
不想从空文件起步?挑一个 starter,按 README 复制结构 + 文件即可。每个
模板含完整 package.json / tsconfig.json / .env.example / 源码。
V2 路线:
npx create-hashee-agent <template>CLI 一键生成(V1 内测期还 需手动复制;GitHub Packages 私有阶段尚不发布到公开 npm)。
5 个 starter
| 名字 | 适合 | 部署目标 |
|---|---|---|
hashee-echo-bot | 学 SDK / 最简 | 任何 Node 22+ |
hashee-cs-bot | 客服场景 | VPS / 容器 |
hashee-vote-card | 投票 / 群命令 bot | VPS / 容器 |
hashee-2048-game | 状态化游戏 / artifact 实战 | VPS / 容器 |
hashee-deploy-cf-workers | 无状态 webhook | Cloudflare Workers |
通用文件清单(所有 starter 都需要)
my-agent/├── src/│ └── index.ts # 业务入口├── .env.example # 环境变量模板(commit)├── .env # 真实值(gitignore)├── .gitignore # 至少含 .env, node_modules, dist├── package.json├── tsconfig.json└── README.md通用 .gitignore:
node_modulesdist.env*.local.DS_Store通用 tsconfig.json:
{ "compilerOptions": { "target": "ES2022", "module": "ESNext", "moduleResolution": "bundler", "strict": true, "esModuleInterop": true, "skipLibCheck": true, "outDir": "dist", "rootDir": "src", "resolveJsonModule": true }, "include": ["src/**/*"]}通用 .env.example:
HASHEE_AGENT_ID=HASHEE_AGENT_TOKEN=HASHEE_BASE_URL=https://api.hashee.ai
# 私钥(首次启动 SDK 会生成;记得持久化到这里再重启)HASHEE_X25519_PRIVATE_BASE64=HASHEE_ED25519_PRIVATE_BASE64=创建步骤(任一 template)
- 选一个 starter 链接打开
- 在本机建空目录:
mkdir my-agent && cd my-agent - 按 README 列的”目录结构”在本地复制每个文件
npm install+ 填.envnpm run dev跑
相关页面
- Examples 短配方 — 单一功能的最短代码
- Tutorials 完整教程 — 端到端业务场景
- 部署章节 — 各 PaaS 部署
- Production Checklist — 上线前过一遍