{"id":24941829,"url":"https://github.com/interjc/kadomatsu","last_synced_at":"2026-01-07T10:31:11.055Z","repository":{"id":274718901,"uuid":"923389590","full_name":"interjc/kadomatsu","owner":"interjc","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-07T14:29:54.000Z","size":352,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T15:30:03.422Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://kadomatsu.sukina.ai","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/interjc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-28T06:32:21.000Z","updated_at":"2025-02-07T14:31:35.000Z","dependencies_parsed_at":"2025-01-29T00:29:46.832Z","dependency_job_id":"9982aa84-354a-455c-b2cd-c1fd54721760","html_url":"https://github.com/interjc/kadomatsu","commit_stats":null,"previous_names":["interjc/kadomatsu"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interjc%2Fkadomatsu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interjc%2Fkadomatsu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interjc%2Fkadomatsu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interjc%2Fkadomatsu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/interjc","download_url":"https://codeload.github.com/interjc/kadomatsu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246082466,"owners_count":20720811,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-02T18:56:46.717Z","updated_at":"2026-01-07T10:31:06.031Z","avatar_url":"https://github.com/interjc.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kadomatsu\n\n本项目开发文档，包含本地开发环境搭建和配置说明。\n\n## 环境要求\n\n- Node.js (推荐使用 v18 或更高版本)\n- pnpm (包管理工具)\n\n## 安装 pnpm\n\n如果你还没有安装 pnpm，可以使用以下方法安装：\n\n使用 npm 安装：\n```bash\nnpm install -g pnpm\n```\n\n使用 Homebrew 安装（macOS）：\n```bash\nbrew install pnpm\n```\n\n验证安装：\n```bash\npnpm --version\n```\n\n## 项目设置\n\n1. 克隆项目后，首先安装依赖：\n\n```bash\npnpm install\n```\n\n2. 配置环境变量：\n\n将 `.env.example` 文件复制为 `.env`：\n\n```bash\ncp .env.example .env\n```\n\n在 `.env` 文件中配置以下必要的环境变量：\n\n- `NUXT_OPENAI_BASE_URL`: OpenAI API 的基础 URL\n- `NUXT_OPENAI_API_KEY`: OpenAI API 密钥\n- `NUXT_OPENAI_MODEL`: 使用的模型名称\n- `SECRET_KEY`: 应用程序密钥\n\n## 本地开发\n\n使用提供的开发脚本启动项目：\n\n```bash\n./dev.sh\n```\n\n这将启动开发服务器，你可以在浏览器中访问应用。\n\n## 项目结构\n\n主要目录结构：\n\n- `pages/`: 页面组件\n- `components/`: 可复用组件\n- `server/`: 服务器端 API 接口\n- `constants/`: 常量定义\n- `middleware/`: 中间件\n\n## 注意事项\n\n- 确保所有敏感信息（如 API 密钥）都配置在 `.env` 文件中，且不要提交到版本控制系统\n- 开发时请遵循项目既定的代码规范和提交规范\n\n## 部署说明\n\n### Vercel 部署\n\n1. Fork 本项目到你的 GitHub 账号\n\n2. 在 Vercel 中导入项目：\n   - 登录 [Vercel](https://vercel.com)\n   - 点击 \"New Project\"\n   - 选择你 fork 的仓库\n   - Framework Preset 选择 \"Nuxt\"\n\n3. 配置环境变量：\n   - 在项目设置中找到 \"Environment Variables\" 部分\n   - 添加 `.env` 文件中的所有环境变量\n\n4. 点击 \"Deploy\" 开始部署\n\n### Cloudflare Pages 部署\n\n1. Fork 本项目到你的 GitHub 账号\n\n2. 在 Cloudflare Pages 中创建新项目：\n   - 登录 [Cloudflare Dashboard](https://dash.cloudflare.com)\n   - 进入 Pages 部分\n   - 点击 \"Create a project\"\n   - 选择你 fork 的仓库\n   - Framework preset 选择 \"Nuxt\"\n\n3. 环境变量配置：\n   - 在 \"Environment variables\" 部分\n   - 添加 `.env` 文件中的所有必要环境变量\n   - 确保变量在生产环境（Production）和预览环境（Preview）都已配置\n\n4. 点击 \"Save and Deploy\" 开始部署\n\n### 部署注意事项\n\n- 确保在部署平台上正确配置了所有环境变量\n- 如果使用自定义域名，需要在相应平台配置域名设置\n- 建议先在预览环境测试，确认无误后再部署到生产环境\n\n## Nuxt 配置说明\n\n项目的主要配置文件是 `nuxt.config.ts`，以下是一些重要配置项的说明：\n\n### 网站基本信息配置\n\n在 `app.head` 中配置网站的基本信息：\n\n```ts\napp: {\n  head: {\n    title: '网站标题',\n    titleTemplate: '%s - 副标题',\n    meta: [\n      { charset: 'utf-8' },\n      { name: 'description', content: '网站描述' },\n      // ... 其他 meta 标签\n    ]\n  }\n}\n```\n\n### Favicon 配置\n\n1. 将你的 favicon 文件放在 `public` 目录下，需要准备以下文件：\n   - `favicon.ico`\n   - `favicon-32x32.png`\n   - `favicon-16x16.png`\n   - `apple-touch-icon.png`（180x180）\n   - `android-chrome-512x512.png`（用于 Open Graph）\n\n2. 在 `nuxt.config.ts` 的 `app.head.link` 中配置：\n```ts\nlink: [\n  { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' },\n  { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon-32x32.png' },\n  { rel: 'icon', type: 'image/png', sizes: '16x16', href: '/favicon-16x16.png' },\n  { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' },\n]\n```\n\n### 站点 URL 配置\n\n在 `.env` 文件中设置 `NUXT_PUBLIC_SITE_URL` 环境变量：\n```\nNUXT_PUBLIC_SITE_URL=https://your-domain.com\n```\n\n这个值会被配置到 `runtimeConfig.public.siteUrl` 中，可以在应用中通过以下方式访问：\n```ts\nconst config = useRuntimeConfig()\nconst siteUrl = config.public.siteUrl\n```\n\n### 第三方脚本配置\n\n在 `app.head.script` 中可以添加第三方脚本，比如统计代码等：\n```ts\nscript: [\n  {\n    children: `(function() { /* 第三方脚本代码 */ })()`,\n    type: 'text/javascript'\n  }\n]\n```\n\n### 其他重要配置\n\n- `ssr: false`: 完全禁用服务端渲染，使用纯客户端渲染\n- `modules`: 项目使用的 Nuxt 模块\n- `runtimeConfig`: 运行时配置，包含环境变量等\n- `nitro`: 服务端相关配置\n- `experimental`: 实验性功能配置\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterjc%2Fkadomatsu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finterjc%2Fkadomatsu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterjc%2Fkadomatsu/lists"}