diff --git a/CLAUDE.md b/CLAUDE.md index 4a1bf70..3390670 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,17 +10,28 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## 版本控制 -`招标投标AI推广应用政策解读/` 子目录有独立的 `.git/`。部署通过 `/remote-sync`(rsync)完成,不走 git push 流程。 +代码托管在 **Gitea 私服**(非 GitHub),`.gitea/workflows/deploy.yml` 在 push 到 `main` 分支时自动 rsync 到 `/data/wiki/` 并 reload nginx。 -`.gitignore` 排除了 `.superpowers/`、`qModel/.git/` 以及嵌套子目录的独立 `.git/`。 +`招标投标AI推广应用政策解读/` 子目录有独立的 `.git/`。手动部署也可通过 `/remote-sync` 调用 rsync 到 `39.100.114.100:/data`。 + +`.gitignore` 排除了 `.superpowers/`、`qModel/.git/`、嵌套子目录的独立 `.git/`、`**/logs/`、`.claude/skills/ui-ux-pro-max/`。 + +### 部署排除 + +`.gitea/workflows/deploy.yml` 在 rsync 到生产环境时排除以下内容: +- `.claude/`、`.gitea/`、`.gitignore`、`CLAUDE.md` — 开发工具与配置 +- `*.pptx`、`*.xlsx` — 源材料/二进制文件 +- `.git/` — 版本控制元数据 + +> ⚠️ **安全提醒**:`.claude/skills/remote-sync/SKILL.md` 包含硬编码 SSH 凭证,该文件不会被部署到生产环境,但存在于 git 仓库中。如需公开此仓库,应先清理凭证。 ## 目录约定 每个子目录遵循 `{主题}/{类型}/` 的层级结构,类型包括 `报告/`、`代码/`、`笔记/` 等。新增主题目录时保持此约定。 **例外情况**: -- `crmeb-mer-graph-report.html` — 位于根目录的单文件报告,不走子目录结构 -- `mcp-services-guide/` — 有独立的 `index.html`,自成一体的子站,不遵循 `报告/` 子目录模式 +- `AI核心技能原理说明.html`、`crmeb-mer-graph-report.html`、`szihl-soe-reform-report.html`、`张德海_简历.html` — 根目录的单文件报告/简历,不走子目录结构 +- `mcp-services-guide/`、`深国际综合改革方案/` — 有独立 `index.html` 的自成一体子站,不遵循 `报告/` 子目录模式 - `交互式演示/` — 存放交互式前端 demo(如正四面体 3D 动画),非报告页 - `中医馆内部管理系统/报告/` 下有 `.md` 需求文档,是唯一在 `报告/` 目录下出现非 HTML 文件的情况(其他 `.md` 文件如 `研发型企业AI转型方案/section-*.md`、`政府审批流解决方案/*.md`、`YqBoot系统说明书/*.md` 位于主题根目录,属规划/源文件,不走报告页模板) - `研发型企业AI转型方案/` — `.md` 分段规划文件 + `.pptx`/`.xlsx` 源材料位于主题根目录,HTML 报告在 `报告/` 子目录 @@ -54,10 +65,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co **新增文档**:在对应分类的 `items` 数组中添加条目。如果分类不存在,新建一个分类对象。 **颜色映射**(`wikiData` 中 `color` 字段的语义约定,颜色值直接写在各分类条目中): -- `pink` — 深度分析、政策解读、政务行业 +- `pink` — 深度分析、政策解读、政务行业、企业AI转型 - `blue` — 工程指南、数据平台、医疗健康 - `mint` — 调研研究、商业分析、配送到家 - `lavender` — 参考资源、AI 工具、关于作者 +- `orange` — 抖音话题、短视频脚本 新增分类时选择语义匹配的颜色,颜色样式通过 `card-badge` 类渲染。 @@ -65,7 +77,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co - 侧栏导航(桌面端)+ 抽屉导航(移动端 ≤768px) - 实时搜索(按标题、描述、分类名匹配) -- 暗色/亮色模式切换(localStorage 持久化) +- 暗色/亮色模式切换(优先级:localStorage 键 `wiki-theme` → `prefers-color-scheme: dark` 系统偏好 → light 默认) - 响应式布局:≤768px 隐藏侧栏,显示移动端 chip 筛选栏 ### JS 运行时架构 @@ -84,8 +96,8 @@ wikiData (声明式) → allItems (展开数组, 附加 section/icon) → 视图 | `searchQuery` | 搜索框绑定值,实时过滤 | | `render()` | 分发函数:`currentView === 'all'` 时调用 `renderAllView(main)`,否则 `renderSectionView(main)` | | `buildNav(targetEl)` | 构建侧栏/抽屉导航 HTML,绑定点击事件切换视图 | -| `buildChips()` | 构建移动端 chip 筛选栏 | -| `setTheme(t)` | 主题切换:设置 `data-theme` 属性 + localStorage 键 `wiki-theme`,同时尊重 `prefers-color-scheme: dark` 系统偏好 | +| `buildChips()` | 构建移动端 chip 横向滚动筛选栏(分类 pill 按钮),点击切换 `currentView` | +| `setTheme(t)` | 主题切换:`document.documentElement.setAttribute('data-theme', t)` + `localStorage.setItem('wiki-theme', t)`。初始化优先级见「页面特性」 | ## 报告页模板 @@ -96,20 +108,39 @@ wikiData (声明式) → allItems (展开数组, 附加 section/icon) → 视图 4. Markdown 内容通过内联 HTML 渲染(表格、代码块、列表) 5. 语言属性 `lang="zh-CN"` -创建新报告页时,复制任意现有报告页的 `:root` 和 header 结构作为模板。 +创建新报告页时,复制任意现有报告页的 `:root` 和 header 结构作为模板。**推荐使用物流网系列报告页**(如 `市属国企参与物流网建设调研报告/报告/`)作为模板,它们有最完整的侧栏目录实现。 + +> **关键模式**:报告页是独立打开的 HTML 文件(非 iframe 嵌入),每个页面必须在自己的 `