chore: 精简 CLAUDE.md，遵循官方最佳实践 (#17)

- 从 153 行精简到 72 行 - 删除逐文件项目结构树（Claude 可自行读取） - 删除标准 Python 命名约定和 PEP 8（默认已知） - 删除技术栈列表（可从 pyproject.toml 推断） - 删除已移除的 PROMPT.md 引用 - 新增 Git 工作流规范（禁止直接推送 main） Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

chore: 精简 CLAUDE.md，遵循官方最佳实践 (#17)
- 从 153 行精简到 72 行 - 删除逐文件项目结构树（Claude 可自行读取） - 删除标准 Python 命名约定和 PEP 8（默认已知） - 删除技术栈列表（可从 pyproject.toml 推断） - 删除已移除的 PROMPT.md 引用 - 新增 Git 工作流规范（禁止直接推送 main） Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
zy · GitHub
Commit 549ebf27925c6d71c6001ec543829475b00a1a85 549ebf27 1 parent 5e5dbc15
Showing 1 changed file with 17 additions and 93 deletions
CLAUDE.md
--- a/CLAUDE.md
View file @549ebf2
+++ b/CLAUDE.md
View file @549ebf2
 # xiaohongshu-skills
 小红书自动化 Claude Code Skills，基于 Python CDP 浏览器自动化引擎。
-为 OpenClaw 生态提供小红书操作能力，同时支持 Claude Code skills 格式。
-## 项目结构
+## Git 工作流
-```
-xiaohongshu-skills/
-├── scripts/                        # Python CDP 自动化引擎
-│   ├── xhs/                        # 核心 XHS 自动化包
-│   │   ├── __init__.py
-│   │   ├── cdp.py                  # CDP WebSocket 客户端（Browser, Page, Element）
-│   │   ├── stealth.py              # 反检测 JS 注入 + Chrome 启动参数
-│   │   ├── cookies.py              # Cookie 文件持久化
-│   │   ├── types.py                # 数据类型（dataclass）
-│   │   ├── errors.py               # 异常体系
-│   │   ├── selectors.py            # CSS 选择器常量
-│   │   ├── urls.py                 # URL 常量和构建函数
-│   │   ├── human.py                # 人类行为模拟（延迟、滚动）
-│   │   ├── login.py                # 登录检查、二维码登录
-│   │   ├── feeds.py                # 首页 Feed 列表
-│   │   ├── search.py               # 搜索 + 筛选
-│   │   ├── feed_detail.py          # 笔记详情 + 评论加载
-│   │   ├── user_profile.py         # 用户主页
-│   │   ├── comment.py              # 评论、回复
-│   │   ├── like_favorite.py        # 点赞、收藏
-│   │   ├── publish.py              # 图文发布（fill + click 分步支持）
-│   │   ├── publish_video.py        # 视频发布（fill + click 分步支持）
-│   │   └── publish_long_article.py # 长文发布（模板选择 + 排版）
-│   ├── cli.py                      # 统一 CLI 入口（19 个子命令）
-│   ├── chrome_launcher.py          # Chrome 进程管理（含 restart 降级）
-│   ├── account_manager.py          # 多账号管理
-│   ├── image_downloader.py         # 媒体下载（SHA256 缓存）
-│   ├── title_utils.py              # UTF-16 标题长度计算
-│   ├── run_lock.py                 # 单实例锁
-│   └── publish_pipeline.py         # 发布编排器
-├── skills/                         # Claude Code Skills 定义
-│   ├── xhs-auth/SKILL.md           # 认证管理
-│   ├── xhs-publish/SKILL.md        # 内容发布（图文+视频）
-│   ├── xhs-explore/SKILL.md        # 内容发现与分析
-│   ├── xhs-interact/SKILL.md       # 社交互动（评论/点赞/收藏）
-│   └── xhs-content-ops/SKILL.md    # 复合内容运营工作流
-├── pyproject.toml                  # uv 项目配置
-├── SKILL.md                        # 统一入口（路由到子技能）
-├── CLAUDE.md                       # 本文件
-├── PROMPT.md                       # Ralph Loop 驱动文件
-└── README.md
-```
-
-## 技术栈
-
-- **Python**: >=3.11
-- **包管理**: uv
-- **依赖**: requests + websockets（直接 CDP WebSocket 通信）
-- **浏览器**: Chrome（通过 CDP 远程调试协议控制）
-- **代码规范**: ruff（lint + format）
-- **数据提取**: `window.__INITIAL_STATE__`（与 Go 源码一致）
+- 所有代码修改必须在分支上进行，禁止直接推送 main 分支
+- 分支开发完成后通过 PR 合入 main
 ## 开发命令
@@ -66,73 +16,47 @@ uv run ruff format .       # 代码格式化
 uv run pytest              # 运行测试
 ```
-## 架构设计
-
-### 双层结构
+## 架构
-1. **scripts/ — Python CDP 引擎**
-   - 基于 xiaohongshu-mcp Go 源码从零重写
-   - `xhs/` 包：模块化的核心自动化库
-   - `cli.py`：统一 CLI 入口，19 个子命令（13 个 MCP + 6 个增强）
-   - JSON 结构化输出，便于 agent 解析
-   - 多账号支持，独立 Chrome Profile 隔离
-   - 反检测保护（stealth flags + JS 注入）
+双层结构：`scripts/` 是 Python CDP 自动化引擎，`skills/` 是 Claude Code Skills 定义（SKILL.md 格式）。
-2. **skills/ — Claude Code Skills 定义**
-   - SKILL.md 格式，指导 Claude 如何调用 scripts/
-   - 包含输入判断、约束规则、工作流程、失败处理
+- `scripts/xhs/` — 核心自动化库（模块化，每个功能一个文件）
+- `scripts/cli.py` — 统一 CLI 入口，19 个子命令，JSON 结构化输出
+- `scripts/publish_pipeline.py` — 发布编排器（含图片下载和登录检查）
+- `skills/*/SKILL.md` — 指导 Claude 如何调用 scripts/
 ### 调用方式
 ```bash
-# 统一 CLI 入口
 python scripts/cli.py check-login
 python scripts/cli.py search-feeds --keyword "关键词"
 python scripts/cli.py publish --title-file t.txt --content-file c.txt --images pic.jpg
-
-# 发布流水线（含图片下载和登录检查）
 python scripts/publish_pipeline.py --title-file t.txt --content-file c.txt --images URL1
 ```
 ## 代码规范
-### Python 风格
-- 遵循 PEP 8，使用 ruff 强制执行
-- 完整的 type hints（PEP 484），使用 `str | None` 语法
-- 公共函数和类必须有 docstring
 - 行长度上限 100 字符
-- 使用 `from __future__ import annotations` 启用延迟注解
-
-### 命名约定
-- 文件名：snake_case
-- 类名：PascalCase
-- 函数/变量：snake_case
-- 常量：UPPER_SNAKE_CASE
-
-### 错误处理
-- 自定义异常类继承自 `XHSError` 基类（`xhs/errors.py`）
-- CLI 命令使用结构化 exit code：0=成功，1=未登录，2=错误
-- 所有用户可见的错误信息使用中文
+- 完整 type hints，使用 `from __future__ import annotations`
+- 异常继承 `XHSError`（`xhs/errors.py`）
+- CLI exit code：0=成功，1=未登录，2=错误
+- 用户可见错误信息使用中文
+- JSON 输出 `ensure_ascii=False`
 ### 安全约束
+
 - 发布类操作必须有用户确认机制
 - 文件路径必须使用绝对路径
-- 不在命令行参数中内联敏感内容（使用文件传递）
+- 敏感内容通过文件传递，不内联到命令行参数
 - Chrome Profile 目录隔离账号 cookies
-## 参考资源
-
-- **xiaohongshu-mcp Go 源码**: /Users/zy/src/zy/xiaohongshu-mcp/
-
 ## CLI 子命令对照表
-scripts/cli.py 的 19 个子命令：
-
 | CLI 子命令 | 对应 MCP 工具 | 分类 |
 |--|--|--|
 | `check-login` | check_login_status | 认证 |
 | `login` | get_login_qrcode | 认证 |
-| `phone-login` | — | 认证（手机号+验证码，无界面服务器适用） |
+| `phone-login` | — | 认证 |
 | `delete-cookies` | delete_cookies | 认证 |
 | `list-feeds` | list_feeds | 浏览 |
 | `search-feeds` | search_feeds | 浏览 |