ChatCode: Instructions file for Claude Code

chat-code

打包规矩（重要）

• 每次完成改代码的任务后都自动打包，不用等用户开口。
• 改完代码只打包，不要自动 quit app / pkill / 覆盖 /Applications。 原因：会搞坏用户其他会话里正在执行的任务。
• 必须签名打包，禁止打 adhoc 包。打包命令固定这一条：

  export APPLE_SIGNING_IDENTITY="$(security find-identity -v -p codesigning | awk -F'"' '/Apple Development/{print $2; exit}')"
  [ -n "$APPLE_SIGNING_IDENTITY" ] || { echo "无可用签名证书，停手"; exit 1; }
  PATH="$HOME/.cargo/bin:$PATH" npx tauri build
  

  （cargo 在 ~/.cargo/bin，不在默认 PATH；身份从 keychain 现取，真名不落仓库）
• 为什么非签不可：adhoc 包在 TCC 里靠 cdhash 认身份，每次重打包 cdhash 变， 屏幕录制/麦克风授权全部失效并重新弹窗（「隐私与安全性」里那行是残留旧记录）。 用开发者证书后 csreq 认 com.chatcode.app + 证书，重打包授权不掉。
• 打完 codesign -dvvv <app> 自检：必须是 Identifier=com.chatcode.app + Authority=Apple Development: …，出现 Signature=adhoc 就是没签上，重来。
• 打完只告诉用户新包路径，用户自己装： src-tauri/target/release/bundle/macos/ChatCode.app
• 签名身份不写进 tauri.conf.json / package.json（会把开发者真名 + 证书 ID 提交进仓库）。

产品介绍图出完就上传（重要）

• 用 product-intro-pic skill 出完一期图后自动上传，不用等用户开口：

  node scripts/publish-pics.mjs           # 传全部期(未改动的自动跳过)
  node scripts/publish-pics.mjs 13-功能特性横版   # 只传这一期
  node scripts/publish-pics.mjs drop chatcode/12-   # 标删一批(前缀匹配)
  

• 「上传」= 复制进本机 Obsidian 库 ~/Obsidian Vault/Obsidian Vault/chatcode/<期目录>/<文件> （scripts/obsidian-vault.mjs，OBSIDIAN_VAULT_DIR 可覆盖），Fast Note Sync 插件同步到 NAS 和手机。 Mac 上 Obsidian 得开着才会同步。2026-09-14 之前是经 public-services 的 /api/vault 传到 tt center， 知识库搬到 Obsidian 后废弃，vault.mjs 和登录凭据都不要了。 前缀只留一层 chatcode/，和 tt-center-app 的 publish-apk.mjs（packages/tt-center-app/）同一套。
• 增量靠 out/.published.json 记 mtime:size，跟着产物走、在 .gitignore 里。 图改了重跑即可，不会全量重传。

项目记忆跨电脑同步

• 记忆 tab 的「跨电脑同步…」：把记忆并进 <根目录>/<项目名>/，再往项目 .claude/settings.local.json 写 Claude Code 原生的 autoMemoryDirectory（src/memory.ts 的 syncMemoryTo）。 ChatCode 和终端里的 claude 都读这个设置，记忆直接落进同步盘，传到别的电脑靠同步盘（Obsidian 库 / iCloud / Dropbox）。
• 根目录每台电脑各存 localStorage；项目名默认取 git origin 仓库名，两台电脑填同一个名字就共用一份。
• settings.local.json 里是本机路径，必须在 .gitignore 里，syncMemoryTo 会补。
• 改了位置后 memoryDirFor 那条默认路径就不对了：面板走 resolveMemoryDir，气泡认引用走 useCustomMemoryDir。
• 记忆文件本身就是带 frontmatter 的 md，正文里的 [[xxx]] 正好是 Obsidian 双链，不用转换。
• 2026-10 以前用软链 + launchd 每小时搬（jkj-obsidian/link-memory.sh），launchd 进不了 ~/Downloads 静默失败，已废弃； scripts/publish-memory.mjs 的镜像（库里 memory/<项目名>/）也一并删了。