hack/tools/scripts/llm-key-hunter/results/_cache/content/aric-jones_accounts.json

{"repo": "aric-jones/accounts", "files": {"README.md": {"d0f78520edf61324c6b1bb670fb95aa4f6d2edf3": {"t": 1786068578.0189757, "n": 2949, "h": "f2ba8beb970f870d", "c": "# 牌记 - AI智能打牌记账小程序\n\n> 告别手动算账，支持麻将/掼蛋/斗地主/跑得快等多种牌类，AI帮你搞定记账和结算。\n\n## 功能现状\n\n### 已实现\n\n- **多人记分** — 支持 2-8 人，基于 transactions 记账\n- **创建/加入房间** — 房间码 + 扫码两种方式\n- **记交易** — 任意玩家间转账记分，含茶水费、台面特殊处理\n- **撤销** — 支持撤销最后一笔（含茶水费情况一并撤销）\n- **AI 结算** — 自动计算最优转账方案，最少次数结清\n- **历史记录** — 查看过往牌局\n- **个人统计** — 胜率、胜负走势等\n- **AI 摘要** — 牌局结束生成趣味文案（需 DeepSeek API Key，不配置时用本地模板）\n- **AI 数据分析** — 手气指数等本地计算，广告解锁入口已暂停\n- **分享海报** — Canvas 绘制\n- **深色模式** — 跟随系统主题\n\n### 部分接入 / 待统一\n\n- **云开发** — 云函数已部署，数据存储以本地为主，多端实时同步**未完整实现**\n- **语音播报** — 预留接口，实际使用需手动接入微信同声传译插件\n- **广告** — 当前暂停展示和调用，后续如接入流量主需另补规格\n\n### 预留但未实现\n\n- 语音记分\n- 完整实时云同步\n\n## 技术栈\n\n```\nminiprogram/         # 小程序前端\n├── pages/           # 页面（index/create/join/room/settlement/history/analysis/profile）\n├── components/      # 组件（player-card/score-input；ad-banner 暂未消费）\n└── utils/           # 工具（settlement/ai/api/poster/voice/theme/util）\n\ncloudfunctions/      # 云函数（部分接入）\n├── createRoom/\n├── joinRoom/\n├── recordScore/\n├── settleRoom/\n├── aiSummary/      # DeepSeek API（可选）\n├── getHistory/\n├── getRoomDetail/\n└── getWxacode/\n```\n\n详细架构见 [docs/architecture/architecture.md](docs/architecture/architecture.md)\n\n## 快速开始\n\n### 1. 环境准备\n\n- [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)\n- 微信小程序 AppID（在 [微信公众平台](https://mp.weixin.qq.com) 注册）\n\n### 2. 项目配置\n\n1. 用微信开发者工具打开本项目\n2. 修改 `project.config.json` 中的 `appid` 为你的 AppID\n3. 在 `miniprogram/config/` 目录下创建 `env.js`：\n\n```bash\ncp miniprogram/config/env.example.js miniprogram/config/env.js\n```\n\n4. 填写 `env.js` 中的配置（见下方配置说明）\n\n### 3. Tab 图标\n\n打开 `miniprogram/images/generate-icons.html` 生成 TabBar 图标，保存 PNG 到 `miniprogram/images/`。\n\n### 4. 云函数部署（如需）\n\n在微信开发者工具中，右键每个云函数文件夹 → 上传并部署。\n\n云开发的具体启用、数据库集合和调试方式见 [docs/reference/cloud-dev-debug.md](docs/reference/cloud-dev-debug.md)。\n\n### 5. AI 功能（可选）\n\n1. 注册 [DeepSeek Platform](https://platform.deepseek.com)\n2. 创建 API Key\n3. 填入 `env.js` 的 `DEEPSEEK_API_KEY`\n\n不配置也可以正常使用，系统会使用内置本地模板生成文案。\n\n## 配置说明\n\n| 配置项 | 必填 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `CLOUD_ENV_ID` | 推荐 | `''` | 云开发环境 ID |\n| `DEEPSEEK_API_KEY` | 否 | `'__PLACEHOLDER__'` | DeepSeek API Key，不填则用本地模板 |\n\n详细说明见 [docs/reference/config.md](docs/reference/config.md)\n\n## 数据模型\n\n房间主数据以 `transactions` 为准，`rounds` 仅兼容读取旧数据。\n\n```\nRoom {\n  _id, name, gameType,\n  players[],           # 含 __tea__、__table__ 特殊角色\n  transactions[],      # 主记账数据 [{from, to, amount, fromName, toName, timestamp}]\n  unitPrice, teaFeePercent, teaCollectMode,\n  status, shareCode, winner, createdBy, createdAt, updatedAt\n}\n```\n\n> `__tea__`（茶水费）和 `__table__`（台面）属于内部记账角色，**不参与**玩家排名和统计。\n\n## 文档\n\n- [AGENTS.md](AGENTS.md) — 项目协作规范\n- [docs/product/spec.md](docs/product/spec.md) — 产品规格与能力边界\n- [docs/architecture/architecture.md](docs/architecture/architecture.md) — 架构文档\n- [docs/process/workflow.md](docs/process/workflow.md) — 文档先行工作流\n- [docs/reference/](docs/reference/) — 参考资料\n- [docs/reference/cloud-dev-debug.md](docs/reference/cloud-dev-debug.md) — 云开发使用与调试说明\n\n## 版权\n\nMIT License\n"}}}}