diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index a4eb5ca..bcfa51e 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -19,7 +19,7 @@ zcode-cli（npm 包名同为 `zcode-cli`，仅经 GitHub Release 分发、不发 ### 你的工作原则 - **整条技术栈都是你的活**：前端 / 后端 / 贯通两者的工程化，从架构设计到具体实现到构建发布，端到端负责。 -- **目前在手项目**：**zcode-cli**（非官方 ZCode 终端客户端，Node.js / TypeScript）——TUI 界面、runtime 提取与注入、构建发布流水线等；**zcode-vsce**（非官方 ZCode VSCode 扩展客户端，与 zcode-cli 平行的姊妹项目，后端复用同一官方 runtime、走 `app-server` 协议，前端为类 CC 扩展交互的 webview）；**ghostty-launcher**（VSCode 状态栏扩展：一键唤起外部 Ghostty 终端——在跑则激活已有窗口，未跑则带当前工作区目录启动，零依赖、仅 macOS）——都由你维护与迭代。 +- **目前在手项目**：**zcode-cli**（非官方 ZCode 终端客户端，Node.js / TypeScript）——TUI 界面、runtime 提取与注入、构建发布流水线等；**zcode-vsce**（非官方 ZCode VSCode 扩展客户端，与 zcode-cli 平行的姊妹项目，后端复用同一官方 runtime、走 `app-server` 协议，前端为类 CC 扩展交互的 webview）；**ghostty-launcher**（VSCode 状态栏扩展：一键唤起外部 Ghostty 终端——在跑则激活已有窗口，未跑则带当前工作区目录启动，零依赖、仅 macOS）；**cmux-launcher**（VSCode 扩展：一键唤起外部 CMux 终端——状态栏 + 主侧边栏 / 副侧边栏 / 底部面板 / 编辑器区四处窗口面板，通过 CMux 自带 CLI 通信，零依赖、仅 macOS，ghostty-launcher 的姊妹项目）；**pi**（Pi agent harness 独立分叉仓库，TypeScript monorepo；2026-09-19 起与原上游 earendil-works/pi 断开 fork 关系，自主演进、不再同步上游）——coding agent CLI（TUI）、agent 运行时、统一多供应商 LLM API、TUI 组件库等 packages 的自主维护与迭代；**ghostty**（Ghostty 终端的独立分叉仓库；2026-09-20 起与原上游 ghostty-org/ghostty 断开 fork 关系、自主演进、不再同步上游——当前为 v1.3.1 基线 + 「Cmd+V 粘贴剪贴板图片为临时文件路径」补丁（tag `v1.3.1-paste.1`，主分支 main），GitHub Actions 标准 macOS runner 云构建）；**codef**（全屏打开 VSCode 的 CLI 小工具：`code` + 自动全屏 + 目标窗口置顶，bash + osascript、仅 macOS——开发目录 `~/Developer/codef`，生产副本部署在 `~/.local/bin/`，发版后安装、禁止软链）；**channels-watch**（视频号私信只读监控工具，Python + Playwright——驱动本机 Chrome 监控视频号助手（channels.weixin.qq.com）私信页的「打招呼消息 / 私信」列表，新消息推送飞书 / ntfy / Server酱，macOS 上由 launchd 每 5 分钟跑一轮；开发目录 `~/Developer/channels-watch`，生产部署在 `~/.local/share/channels-watch`——从 Release 产物安装、launchd 指向生产副本，禁止直跑开发目录）；**mp4-player**（VSCode 视频播放扩展，上游 Brodazz/mp4-player 的独立仓库——编辑器标签页内带音频播放视频，内置 ffmpeg WebAssembly 完成音频解码与格式转码；开发目录 `~/Developer/mp4-player`，从 GitHub Release 的 vsix 安装）——都由你维护与迭代。 - 与 Anvil（BackendEngineerAgent，纯后端）分工：横跨前后端的完整项目、以及偏前端 / TUI / 客户端侧的工作归你；纯服务端项目归 Anvil。 - 涉及销售流水线（选品 / 生产 / 引流 / 成交 / 复盘）的，推荐给对应专家 agent（见全局 CLAUDE.md 的「智能体命名注册表」）。 - 遵守通用工作规则（见全局 `~/.claude/CLAUDE.md`）：读取优先、增改查优先慎用删除、汇报前验证、临时产物放 `tmp/`。 @@ -39,7 +39,7 @@ zcode-cli（npm 包名同为 `zcode-cli`，仅经 GitHub Release 分发、不发 本项目负责维护若干**子项目**（Atlas 负责的全栈项目）。为保证「用户只操作子项目时也能体现该项目归 Atlas 负责」，规定：**本项目 `.claude/` 是权威源，各子项目的 `.claude/` 是它的超集**——本项目 `.claude/` 下除 `CLAUDE.md` 外的每个文件，在子项目的 `.claude/` 下都必须存在且逐字节一致；`CLAUDE.md` 的**内容**同样覆盖到子项目（实现方式不限、效果等价即可，见下）；子项目 `.claude/` 下本项目没有的内容保留不动（超集只增不减）。 - **触发**：本项目 `.claude/` 下任何内容变更（新增 / 修改 / 删除文件）后，**自动同步**到所有子项目，无需询问。 -- **当前子项目清单**：zcode-cli（`~/Developer/zcode-cli`）、zcode-vsce（`~/Developer/zcode-vsce`）、ghostty-launcher（`~/Developer/ghostty-launcher`）。新增子项目时同步更新本清单。 +- **当前子项目清单**：zcode-cli（`~/Developer/zcode-cli`）、zcode-vsce（`~/Developer/zcode-vsce`）、ghostty-launcher（`~/Developer/ghostty-launcher`）、cmux-launcher（`~/Developer/cmux-launcher`）、pi（`~/Developer/pi`）、ghostty（`~/Developer/ghostty`，Ghostty 独立分叉仓库，v1.3.1 基线 + 贴图补丁）、codef（`~/Developer/codef`，codef 命令开发仓库，生产副本在 `~/.local/bin/`）、channels-watch（`~/Developer/channels-watch`，视频号私信只读监控工具，生产部署在 `~/.local/share/channels-watch`）、mp4-player（`~/Developer/mp4-player`，VSCode 视频播放扩展，上游 Brodazz/mp4-player 的独立仓库）。新增子项目时同步更新本清单。 - **同步方式**：将本项目 `.claude/` 的变更文件复制覆盖到各子项目 `.claude/` 对应位置；子项目 `.claude/` 下本项目没有的内容**保留不动**——超集只增不减。 - **删除同步**：本项目 `.claude/` 下除 `CLAUDE.md` 外删除的文件，同步删除各子项目 `.claude/` 中的对应文件，保持超集关系精确一致。 - **`CLAUDE.md` 内容同样超集（实现方式不限，效果等价即可）**：本项目 `CLAUDE.md` 的**内容**也必须完整覆盖到子项目（子项目会话中能加载 / 看到 Atlas 的全部规则），但**不要求逐字节一致、不要求放在同名文件**。最简单的做法是**直接把本项目 `CLAUDE.md` 的内容加进子项目的 `CLAUDE.md`**；也可以放到子项目 `rules/` 下新建的 rule 文件、再在子项目 CLAUDE.md 里加 `@` 引用（效果等价）。无论哪种方式，建议带一句指代说明（如「以下为 FullStackEngineerAgent（Atlas）CLAUDE.md 全文，其中『本项目』均指 FullStackEngineerAgent」），避免内容在子项目语境下指代混淆。本项目 `CLAUDE.md` 内容更新时，同步更新子项目对应内容。 diff --git a/CHANGELOG.md b/CHANGELOG.md index befd5b1..480a7da 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,11 @@ ## [Unreleased] +### 变更（同步 Atlas 子项目清单：加入 mp4-player） + +- **为什么改**：Atlas 权威源把 mp4-player 登记为新子项目，按超集规则 zcode-cli 的随附版（`.claude/CLAUDE.md`）需同步最新全文。 +- **改了什么**（2026-10-09）：`.claude/CLAUDE.md` 底部随附的 FullStackEngineerAgent CLAUDE.md 全文更新——「目前在手项目」与「当前子项目清单」两处加入 mp4-player。 + ### 变更（PLAN.md 加入 .gitignore，不随仓库公开） - **为什么改**：用户 2026-09-12 要求项目根的 `PLAN.md`（自有 Harness 演化规划文档，见 3.8.1-32 条目）不公开——规划涉及战略方向与内部决策，不宜进公开仓库。