Skip to content

docs: sync Atlas subproject list (add mp4-player) #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
xhqing merged 1 commit into from
Oct 9, 2026
Merged

docs: sync Atlas subproject list (add mp4-player) #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/`。
Expand All @@ -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` 内容更新时，同步更新子项目对应内容。
Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 条目）不公开——规划涉及战略方向与内部决策，不宜进公开仓库。
Expand Down
Loading