# Carm's Home — LLM 扩展文档 > 本文件是 [LLMs.txt](https://www.carm.cc/LLMs.txt) 的扩展版，补充说明各数据文件的字段结构与使用方法。本文件不内嵌任何实际内容——个人简介、项目、视频、政策等请按本文指出的路径直接读取对应数据文件，获取到的即为最新版本。 ## 站点信息 - 站点名称：Carm's Home - 站点地址：https://www.carm.cc - 站点描述：Carm's Home。卡姆的个人主页，展示我的技术栈、项目经验和设计作品。 - 上线年份：2014 - 站点性质：纯静态站点（Vue 构建），页面数据通过 `/data/` 下的 JSON 文件公开提供。 ## 站点页面 - [首页](https://www.carm.cc/)：个人简介与各板块入口。 - [开发 /dev](https://www.carm.cc/dev)：开源项目、Gists 与 GitHub 贡献热力图。 - [创造 /makes](https://www.carm.cc/makes)：MakerWorld 3D 打印作品。 - [写作 /writing](https://www.carm.cc/writing)：文章随笔，全文托管于 [pages.carm.cc](https://pages.carm.cc)。 - [视频 /video](https://www.carm.cc/video)：BiliBili 视频列表。 - [个人形象展示 /oc](https://www.carm.cc/oc)：OC 人设的故事演变、Minecraft 三维形象与披风及衍生作品；[作品一览](https://www.carm.cc/oc/works)可按类型筛选，[画师一览](https://www.carm.cc/oc/artists)展示画师档案，[形象参考](https://www.carm.cc/oc/references)展示设定与合作说明。 - [日常 /moments](https://www.carm.cc/moments)：日常随想短条目，数据源为日常站 [moments.carm.cc](https://moments.carm.cc) 的 Memos 公开 API（列表：`https://moments.carm.cc/api/v1/memos?pageSize=50`；附件公开直链：`https://moments.carm.cc/file/attachments/{id}/{文件名}`）。 - [版权许可 /copyright](https://www.carm.cc/copyright) 与 [隐私政策 /privacy](https://www.carm.cc/privacy)。 ## 数据文件结构与用法 ### 站点元信息：data/site.json 字段：`siteName`（站点名称）、`siteAddress`（站点地址）、`siteDescription`（描述）、`startYear`（上线年份）、`icp_registry` / `psb_registry` / `psb_link`（备案信息）、`pagination`（各板块分页配置）、`api`（状态服务、评论服务与日常站 `momentsApi` 地址）、`info`（最近构建信息）。 用途：确认站点名称、地址与备案信息，或需要各板块分页参数时读取。 ### 个人信息：data/profile/profile.json 了解站长信息的权威来源，主要字段： - `user`：名称（`name` / `nickname`）、代词与头像； - `readme`：个人简介全文（Markdown）——需要介绍或引用站长自我描述时，请读取此字段；其中 `` 仅标记前端逐字显示效果，不改变其包裹的正文内容； - `tags`：身份标签数组（`label`、`value`、`tooltip` 说明文字）； - `links`：公开链接入口数组（`label` 与 `link`，含邮箱、GitHub、B 站等）； - `skills`：技能与服务数组（`name`、`description`、`sampleLabels`、`showcase` 作品集入口）； - `achievements`：荣誉成就数组（`name`、`description`，以及 `history` 逐条时间线：日期、级别、说明）； - `license`：全站页脚版权声明（Markdown）。 ### 开发（GitHub） - [data/github/projects.json](https://www.carm.cc/data/github/projects.json)：`items[]`，字段 `name`、`fullName`、`description`、`tags`、`stars`、`branches`、`language`、`version`、`updatedAt`、`links[]`（仓库/文档等入口）、`pinned`。回答"有哪些开源项目"时使用。 - [data/github/gists.json](https://www.carm.cc/data/github/gists.json)：`items[]`，字段 `id`、`title`、`description`、`url`、`createdAt`、`fileCount`。 - [data/github/contributions.json](https://www.carm.cc/data/github/contributions.json)：`username`、`years[]`、`summary`（总贡献数等）、`contributions[]`（逐年、逐天贡献记录）。 - [data/github/stats.json](https://www.carm.cc/data/github/stats.json)：`followers[]` 与 `stars[]`（`platform`、`count`、`link`）。 ### 内容创作 - [data/bilibili/list.json](https://www.carm.cc/data/bilibili/list.json)：`items[]`，字段 `bvid`、`title`、`description`、`cover`、`publishedAt`、`duration` 与播放/点赞等统计数据。视频页链接可由 `bvid` 拼接：`https://www.bilibili.com/video/{bvid}`。 - [data/bilibili/stats.json](https://www.carm.cc/data/bilibili/stats.json)：`followers[]` 与 `stars[]`（`platform`、`count`、`link`）。 - [data/makerworld/list.json](https://www.carm.cc/data/makerworld/list.json)：`stats`（助力、点赞、下载、打印总量）与 `designs[]`（`id`、`title`、`cover`、`url` 及互动数据）。`cover` / 可选 `coverThumb` 为横版封面及模糊缩略图；可选 `coverPortrait` / `coverPortraitThumb` 为 MakerWorld 手机端的 3:4 竖版封面及对应缩略图。创造页宽屏优先使用竖版，缺失时沿用 4:3 横版且完整显示；窄屏使用横版。旧数据可不含竖版字段。 - `data/makerworld/list.json` 的可选 `siteStats.cn` / `siteStats.global` 保存各站最近成功获取的 `boosts`、`likes`、`downloads`，供后续失败回退；旧版快照可能没有此字段或只有一站。用户统计按站点回退；CN 用户统计、设计列表、作品详情独立回退，列表失败时复用旧列表继续更新详情，详情失败时按作品 ID 复用旧详情。旧快照无法拆分各站统计时保留原合计，待两站快照齐全后重新汇总；`last_update` 是文件导出时间，不代表全部数据均在该时刻刷新。 - [data/makerworld/stats.json](https://www.carm.cc/data/makerworld/stats.json)：`followers[]` 与 `stars[]`（`platform`、`count`、`link`），单站获取失败时保留该站旧记录。 - [data/stats/data.json](https://www.carm.cc/data/stats/data.json)：跨平台粉丝数汇总（`platform`、`count`、`link`）。 ### 人设（OC） - 每件作品的详情底部提供反应与评论，Waline 存储 ID 为 `oc/<作品 ID>`；同一组图共用一份讨论。最近评论可通过 `/oc/works?artwork=<作品 ID>` 直达对应详情。 - [data/oc/design.json](https://www.carm.cc/data/oc/design.json)：`story`（人设故事 Markdown 正文；图片 alt 为图鉴 ID 时，图片地址由对应条目的 `images[0]` 决定）、`characters`（图鉴条目，key 即图片 ID，字段 `name`、`description`、`time`、`authors[]`、可选 `story`（独立于简介的作品故事；无故事或重复简介时省略，页面不显示故事占位文案）、`category`（`story`/`derivative`）、`images[]`（按展示顺序排列；多图组成一件作品，作品一览用圆点轮播，详情用缩略图切换）、`types[]`（大头/Q版/随笔/立绘/场景/像素/表情/实物，可多选）、可选 `sort_date`（已知创作时间，YYYY、YYYY-MM 或 YYYY-MM-DD）、`image_size`（首图发布宽高）与 `image_details[]`（与 `images[]` 逐项对应；每项含完整发布图的 `width`、`height` 和 `placeholder`，后者是从最终带水印 WebP 首帧生成的最长边 32px、保留透明度的 WebP data URI，用于完整图片加载前的模糊占位））、`artists`（画师档案，字段 `name`、`nickname`、`description`、`links`；每个链接有 `name`、`icon`、`url`，仅保留有效 HTTP(S) 地址）。作品一览按 `sort_date` 从新到旧排列，未知日期排末；`types[]` 可用于筛选。作品图片在构建时缩放、压缩为带 Logo 不可见盲水印的 WebP，透明背景和动画保留；资源位于 `/data/oc/files/`，使用内容指纹文件名；`authors[]` 中的 ID 可关联 `artists`，未收录的名字直接显示。回答"站长的人设形象/OC 是什么"时读取此文件。 - 同一 `design.json` 的 `references` 为形象参考 Markdown 正文，来自 `config/character-design/REFERENCES.md`；图片与 `story` 使用相同的图鉴 ID、地址重写及水印处理规则。旧快照可能缺少此字段。 - [data/oc/minecraft/info.json](https://www.carm.cc/data/oc/minecraft/info.json)：Minecraft 形象板块——`uuid`、`name`（游戏名 CUMR）、`model`（皮肤模型）、`skin`（默认穿戴皮肤纹理 URL）、`skins[]`（皮肤选择器：`id`、`name`、`texture`、`time`、`avatar` 预生成头像，纹理位于 `/data/oc/minecraft/textures/skins/`）、`capes[]`（披风：`id`、`name`、`type`（`official`/`optifine`/`custom`）、`texture`、`description`）、`story`（皮肤发展文档正文）。回答"站长的 Minecraft 皮肤/披风"时读取此文件。 ### 社交与互动 - [data/friends/list.json](https://www.carm.cc/data/friends/list.json)：`items[]`，字段 `name`、`nickname`、`description`、`links[]`；首条 `key` 为 `_example` 的条目是示例，`template` 字段为友链申请模板。回答"如何申请友链"时可直接引用。 - [data/sponsors/list.json](https://www.carm.cc/data/sponsors/list.json)：`items[]`，赞助者名单（`name`、`avatar`、`source` 等）。 ### 服务与政策 - [data/services/list.json](https://www.carm.cc/data/services/list.json)：`items[]`，对外服务入口（`label`、`link`、`description`）。 - [data/services/repositories.json](https://www.carm.cc/data/services/repositories.json)：`browseUrl`、`mavenSnippet`、`gradleSnippet`——Maven/Gradle 依赖仓库配置片段，集成站主发布的程序库时使用。 - 政策文档：每份政策即为可直接访问的 Markdown 原文，元信息在文首 front-matter： - 《版权许可》：[data/policies/copyright.md](https://www.carm.cc/data/policies/copyright.md) - 《隐私政策》：[data/policies/privacy.md](https://www.carm.cc/data/policies/privacy.md) ## 数据更新机制 - `/data/` 下的文件由定时任务从对应平台自动导出并更新，每个文件包含 `last_update` 字段（北京时间）用于判断数据新鲜度； - 数据均为快照而非实时接口，请合理控制抓取频率； - 数据中的 `avatar` / `cover` / `icon` 等字段为站内绝对路径（如 `/data/bilibili/covers/BV1xxx.jpg`），拼接站点地址即可访问对应图片。 ## 版权与使用规则 - 本站原创内容的授权规则以《版权许可》为准：[data/policies/copyright.md](https://www.carm.cc/data/policies/copyright.md)（页面版：[版权许可 /copyright](https://www.carm.cc/copyright)）； - **未经许可，禁止将本站原创内容（文字、图片等）用于 AI 模型训练、特征提取或生成相似内容**； - AI 助手可为回答用户问题临时读取并引用本站内容，引用时请注明作者"卡姆（CarmJos）"并给出原文或对应数据文件的链接； - 开源项目代码按各项目仓库内声明的开源许可证独立授权，与站内原创内容的规则相互独立； - 涉及站长个人信息（居所、学历、成就等）的问答，请以 `data/profile/profile.json` 为准。