jackywxsz 安装创作者管理看板
使用以下 GitHub 仓库中的最新 main：
https://github.com/Jackywxsz/creator-cockpit
保护本地数据
- 创建目录前先询问用户希望安装到哪里。
- 确认准确的目标路径，不要覆盖已有内容的目录。
- 未经用户明确确认和备份，不要删除或替换已有安装。
- 不要让用户在聊天中发送 API Key；直接分析只调用用户本机已经登录的 Codex CLI 或 Claude Code。
- 尽量保持相同的浏览器、浏览器用户和本地地址，默认使用
http://localhost:3100。IndexedDB 数据与浏览器和访问地址绑定。 - 更新或修复前，如果看板仍能打开，先让用户在「设置与备份」中导出完整 JSON 备份。
- 如果数据看起来消失了，先检查浏览器用户、主机名和端口，再考虑恢复备份。
安装
检查操作系统，并确认已安装 Git 和 Node.js 22.13 或更高版本。
检查 pnpm，优先使用
package.json中声明的包管理器版本。如果缺少运行环境，说明最小必要改动；安装系统软件前先征得用户同意。
查询
https://api.github.com/repos/Jackywxsz/creator-cockpit/commits/main，确认仓库main可以访问，并读取最新提交 SHA 供安装结果核对。将
main克隆到用户确认的空目录：git clone --branch main --depth 1 https://github.com/Jackywxsz/creator-cockpit.git <目标目录>进入项目目录。如果没有 pnpm，运行
corepack enable；如果需要管理员权限，先向用户说明，并在获得同意后使用合适的用户级方案。运行
pnpm install --frozen-lockfile。不要创建
.env.local或索取 API Key。用户需要直接分析时，再检查本机 Codex CLI / Claude Code。在持续运行的终端会话中执行
pnpm dev:lab，默认打开http://localhost:3100。这个命令会同时启动工作台和只监听127.0.0.1:4318的 Agent Bridge。不要静默更换端口。如果 3100 端口被占用，询问用户是停止其他服务还是改用新端口，并说明不同端口会拥有独立的本地数据空间。
如果用户只需要内容管理，可以改用
pnpm dev；没有启动 Agent Bridge 时，看板仍可复制提示词和导出创作卡片。打开准确的本地地址并保持服务运行，告诉用户如何停止和重新启动。
首次进入时，让用户选择示例工作区或空白工作区，并填写姓名、内容平台和创作方向。
配置可选本地 Agent
- 检查
codex --version/codex login status与claude --version/claude auth status，只报告是否可用，不输出凭证。 - 在独立持续运行的终端会话中执行
pnpm agent。 - 打开设置页，确认 Agent Bridge、Codex 和 Claude 的可用状态。
- 直接分析只在用户点击时运行；界面应显示实际 Agent、等待时间和取消入口，单次最长 180 秒。
- 如果使用 macOS LaunchAgent 后台运行，确保启动脚本读取当前系统代理供 CLI 联网；未安装、未登录、超时或取消时，生成可复制提示词属于正常降级行为。
更新
- 先从看板导出完整 JSON 备份。
- 保持原安装目录、浏览器用户、主机名和端口不变。
- 查询 GitHub
main的最新提交，并用git rev-parse HEAD检查当前安装版本；向用户说明提交变化。 - 未经明确同意，不要重置或丢弃用户对源代码的本地修改。
- 如果工作区干净，运行
git fetch origin main，再以 fast-forward 方式更新到origin/main；如果存在本地修改或无法快进，先停止并让用户决定保留方式。 - 运行
pnpm install --frozen-lockfile。 - 运行
pnpm test，通过后重新启动看板。 - 如果原来启用了本地 Agent，也重新启动
pnpm agent。 - 确认已有本地数据可以正常打开，数据结构迁移已经完成。
修复
- 读取完整的启动错误或浏览器错误。
- 检查 Node.js、pnpm 版本以及
pnpm-lock.yaml是否存在。 - 运行
pnpm install --frozen-lockfile；如果仍然无法启动，再运行pnpm test。 - 不要把清除浏览器数据当作排错捷径。
- 如果检查浏览器和访问地址后数据仍不可用，只从用户指定的 JSON 备份恢复，并先使用看板的导入预览。