📌 站点维护规则 · Agent Skill

任何被授权维护本站的 AI Agent，读完本页即可按 SOP 完成新文章的自动归类收录 · v1.1 · 2026-10-19

机器可读版：/工具/分类规则.md（curl 直接拉取）

⚡ 一句话流程

新文章 → 按决策树选目录 → 放入该目录（同名侧车同迁）→ 完成

首页自动收录新文件并自动提取文章 <title> 作为卡片标题（零配置路径）。进阶可选：为 index.html 补 META 条目获得精装卡片（含简介与标签）。

🏗 站点架构速览

组件	位置 / 说明
Web 服务器	nginx 1.14.1 · `/etc/nginx/conf.d/desktop-html.conf` · 端口 8011
站点根	`/var/www/desktop-html/`
首页机制	`index.html` 逐分类 fetch `/listing/<目录>/`（autoindex JSON，非递归）→ 渲染卡片
标题来源	优先查内嵌 `META`（key=`"目录/文件名"`）；查不到时自动 fetch 文件提取 <title> 兜底，标签显示「自动收录」
兜底区	根目录散落 `.html` 显示在「📥 未归类」——放根目录不会丢，只是未归类
旧链兼容	nginx 回退：根级 .html 未命中按知乎→投资→调研→工具→其他顺序回退，旧扁平直链全部仍 200
子站（勿动）	`fq-book/` · `grid-data/` · `parking-viz/` · `/quota`（反代 8471）· `share.js` / `track.js`
备份惯例	服务器快照 `/var/www/backups/`；永久归档 `oss://agent-kanban/backup/desktop-html/`

分类目录（首页按此优先级展示）：知乎/ 投资/ 调研/ 工具/ 其他/ 数据/（数据目录不显示卡片）

🌳 分类决策树（按顺序执行）

核心原则：按文章主旨内容分类，而非来源平台。冲突时按站长主权排序：知乎 > 投资 > 调研 > 工具 > 其他。

内容主体是知乎（问答/回答汇总、知乎人物调研、热点观察）→ 知乎/
主旨是投资理财（行情日报、量化回测、ETF/基金、仓位纪律、投资类播客、事件驱动策略）→ 投资/
⚠ 特例：知乎来源但主题为 A股/投资机会/预期差方法论 → 投资/（先例：ashare-zhihu-*、zhihu_invest_q2、zhihu_expectation_q4、龙头18868）
深度调研报告（行业/技术/公司/地缘/产品拆解/项目文档/论文翻译/事件全景）→ 调研/
可复用交互工具与 SOP（地图类、可视化工具、工作流 SOP、工具横评）→ 工具/
生活/娱乐/影视人物 → 其他/
纯数据附件（json/csv/xlsx/md 且无同名 html 引用）→ 数据/（不展示）
判断不准 → 放根目录，「未归类」兜底。宁缺勿错。

📝 文件命名与侧车

推荐：中文描述性文件名或 slug-YYYY-MM-DD.html；避免空格（用连字符）；日期后缀放末尾
文件内 <title> 必须写完整中文标题——这是自动收录时卡片标题的唯一来源
同名侧车（.json/.md/.js）必须与 html 同目录（相对引用）
不新增一级目录；确需新分类，先更新本文件与 index.html 的 CATS 数组
清理 macOS ._* 垃圾文件

🚀 部署 SOP（有 ECS 执行权限的 Agent）

# Step 1 备份（红线，永远先做）
tar czf /var/www/backups/new-file-$(date +%Y%m%d%H%M%S).tgz -C /tmp 新文件.html

# Step 2 上传（二选一）
#  a) 云助手直传（小文件 <32KB）：aliyun ecs RunCommand … echo "<base64>" | base64 -d > 目标路径
#  b) OSS 中转（大文件/中文文件名推荐）：
#     agent 本地: aliyun oss cp 文件.html oss://agent-kanban/tmp/ --region cn-wulanchabu
#             aliyun oss sign oss://agent-kanban/tmp/文件.html --timeout 600 --region cn-wulanchabu
#     ECS 执行:   curl -sS -o /var/www/desktop-html/投资/文件.html '<预签名URL>'
#     ⚠ 管道会吞掉 oss cp 失败退出码，上传后必须 oss stat 核对字节数

# Step 3 放入分类目录（见决策树），确认同名侧车同迁

# Step 4 验证
curl -s -o /dev/null -w '%{http_code}\n' 'http://127.0.0.1:8011/投资/文件.html'   # 期望 200
curl -s 'http://127.0.0.1:8011/listing/投资/' | python3 -c 'import json,sys;print(len(json.load(sys.stdin)))'  # 计数+1

# Step 5 归档 + 清理中转
aliyun oss cp 文件.html oss://agent-kanban/backup/desktop-html/ --region cn-wulanchabu
aliyun oss rm oss://agent-kanban/tmp/文件.html --region cn-wulanchabu

回滚：文件级从备份 tar 恢复；动过 nginx 则 cp 备份.conf → nginx -t → systemctl reload nginx（常规加文章不需要动 nginx）。

💎 进阶：精装卡片（补 META）

v1.1 主路径：本地 build.py 的 NEW_META 加条目（key 是裸文件名）→ 同名文件注册进 CAT_FILES → python3 build.py 核对 meta 数 → index+CSV 回传。下方手动路径仅急用。

备份：cp -a index.html index.html.bak-meta-$(date +%Y%m%d%H%M%S)
在 index.html 的 const META = { 中插入（key 必须是 目录/文件名）：

"投资/我的新文章.html": {
  "title": "中文标题（≤30字）",
  "desc": "基于实际内容的一句话简介（≤120字），写给三个月后的自己",
  "tag": "投资 · 子主题 · 形态"
},

本地改完走 OSS 中转回传，ls -la 核对字节，浏览器强刷验证
全站 META 分类清单：/工具/分类清单.csv（与站点同步维护）

🧩 构建器规则（index.html 的隐形约束）

首页由本地 build.py 生成，两条隐形规则：NEW_META 的 key 是裸文件名（最终渲染才带「目录/文件名」前缀，写错会静默走兜底：tag=分类名、desc=标题）；文件必须注册进 CAT_FILES 才进 META/CSV，否则只被自动收录（无简介）
重建后核对 articles=N meta=N 两数相等；改完 META 必须重传 分类清单.csv

🔬 全站审计经验（已知误报源）

侧车引用检查不要 lstrip("./")：会把绝对路径 /share.js 剥前缀误报缺失
URL 编码的 href 可达（浏览器解码命中中文文件名），curl 实证后再定性
JS 模板字面量 ${r.url} 会被当相对链接，需排除
AK 扫描命中 LTAI 先看上下文——base64 数据里可能恰好含这四个字母
CSS 属性选择器匹配 href 时 encoded 中文匹配不到，卡片验证用 .card 文本过滤
修复一律先留 .bak-opt-时间戳 备份；每个「断链」先 curl 实证再修

🚫 红线（违反即事故）

不动 nginx 其他 server 块、/quota 反代、fq-book/、share.js、track.js
不删任何 *.bak-* 备份
不把 AK/密钥写入站点可访问文件
>50MB 文件先 df -h 确认磁盘
不在生产目录试跑未验证脚本

✅ 发布前自检清单

☐ 文章 HTTP 200（新路径）
☐ /listing/<分类>/ 计数 +1
☐ 首页卡片出现、标题为中文（自动提取或 META）
☐ 同名侧车资源 200（若有）
☐ 随机抽 3 条旧扁平直链仍 200
☐ 备份已落盘、OSS 中转已清理