# ISOS 自动记忆

> 最后更新: 2026-04-19

> 项目核心规范在 [.claude/CLAUDE.md](../.claude/CLAUDE.md)，此处仅记录跨会话学习内容。

## 用户偏好

- [user-preferences](user-preferences.md) — 文档层级管理、上下文管理
- [vcs-preference-jj](vcs-preference-jj.md) — 默认使用 jj 替代 git
- [memory-vs-team-responsibility](memory-vs-team-responsibility.md) — memory 记录项目经验/偏好，team 记录公共跨团队知识

## 文档规范

- [docs-chinese-naming](docs-chinese-naming.md) — docs/ 下所有 .md 文件强制使用中文名字
- [docs-readme-index](docs-readme-index.md) — 按场景加载文档到上下文的入口
- [doc-versioning-rules](doc-versioning-rules.md) — MAJOR 统一、MINOR/PATCH 独立、语义化版本

## 关键经验

- [terminology-consistency](terminology-consistency.md) — 术语澄清方法论：识别→判断→建边界→修复→补规范
- [member-directory-rules](member-directory-rules.md) — member/ 由用户编写或 hook 记录，Claude 禁止修改
- [tasks-directory-location](tasks-directory-location.md) — tasks 文档保存在 /workspace/tasks/
- [tasks-doc-line-limit](tasks-doc-line-limit.md) — 单个任务文件 ≤200 行（编排索引文档除外）
- [font-cross-platform](font-cross-platform.md) — 设计文档字体必须考虑目标平台可用性和 CJK 支持
- [agent-team-collaboration](agent-team-collaboration.md) — Agent 完成后立即 shutdown、验证产出物、SendMessage 带 summary
- [agent-team-tmux-constraints](agent-team-tmux-constraints.md) — 最多 1 Window 4 Pane
- [subagent-alternative](subagent-alternative.md) — GLM 环境下 SubAgent 不可用时用 tmux pane 替代
- [playwright-screenshots](playwright-screenshots.md) — 保存到 `.playwright-screenshots/`
- [agent-pane-cleanup](agent-pane-cleanup.md) — 快照覆盖竞态、清理策略增强、持久化日志
- [claude-code-model-config](claude-code-model-config.md) — settings.json env 覆盖陷阱、tmux 三层传播
- [cc-alias](cc-alias.md) — cc 是 bashrc 函数（runcc.sh），跳过权限用 claude --dangerously-skip-permissions
- [claude-code-rename](claude-code-rename.md) — --name 不可靠，必须用 /rename 持久化会话名称
- [devcontainer-sync](devcontainer-sync.md) — templates/ 是单一信源，运行时文件由 Dockerfile/post-create.sh 生成
- [tmux-send-keys-enter](tmux-send-keys-enter.md) — send-keys 后必须确认 Enter 已生效
- [jj-untrack-ignored-files](jj-untrack-ignored-files.md) — jj 中 .gitignore 对已跟踪文件需用 jj file untrack

## 项目历史

- [desktop-tech-stack-change](desktop-tech-stack-change.md) — PySide6/Qt → PyWebView + Svelte (2026-04-05)

## 设计模式

- [design-patterns](design-patterns.md) — Bridge API 通信、数据流完整性检查

## 参考

- [ui-testing](ui-testing.md) — Playwright E2E 测试方法
- [ci-cd-experience](ci-cd-experience.md) — Python 版本固定、Ruff 规则
- [pdf2md-usage](pdf2md-usage.md) — PDF 转 Markdown 工具（`/isos-pdf2md`）

---
*此文件由 Claude 自动记忆功能维护。*