@nick848/ft 0.1.0 → 0.1.1

package/locales/en.json

@@ -3,7 +3,6 @@
   "error.karpathyMissing": "andrej-karpathy-skills not found. See https://github.com/multica-ai/andrej-karpathy-skills or copy rule files manually.",
   "error.cometNonInteractive": "Comet failed in non-interactive (IDE) environment.",
   "error.cometUseTerminal": "Run in system terminal: comet <command>",
-  "hint.gitnexusOptional": "Tip: install GitNexus for code intelligence (npm install -g gitnexus)",
   "init.injectModeQuestion": "How should Karpathy rules be injected?",
   "init.injectModeManual": "1) Manually select target tools (recommended)",
   "init.injectModeAuto": "2) Auto-detect current environment",
@@ -15,9 +14,6 @@
   "init.runningComet": "Running comet init...",
   "init.success": "✓ FT initialization complete",
   "init.nextStep": "Next: run /ft-fill-context in your IDE to complete project context",
-  "mcp.writeSuccess": "MCP config written: {{path}}",
-  "mcp.manualTitle": "⚠️ Cannot write MCP config. Add the following to {{path}}:",
-  "mcp.pressKey": "Press any key to continue...",
   "gate.fillContextFirst": "Complete /ft-fill-context first — fill all [NEEDS LLM INPUT] placeholders in AGENTS.md before Comet workflow commands.",
   "fillContext.title": "AGENTS.md Context Fill Task",
   "fillContext.goal": "Edit `AGENTS.md` directly and replace `[NEEDS LLM INPUT]` with project-specific content.",
@@ -30,16 +26,99 @@
   "fillContext.reference": "Reference (from AGENTS-BAK.md)",
   "fillContext.backupNote": "Backup merge notes",
   "fillContext.backupMerge": "Regenerate template sections from backup; append custom sections from backup to the end with <!-- migrated from AGENTS-BAK.md -->",
-  "graph.setupGuide": "GitNexus not installed. Run:",
-  "graph.alreadyInstalled": "GitNexus is installed.",
-  "graph.handoffSummary": "Graph Summary",
-  "graph.handoffPrompt": "Guidance Prompt",
-  "graph.handoffPromptBody": "For upcoming coding tasks, prioritize GitNexus MCP tools (get_symbol, get_callers, query) for symbol-level dependencies instead of blind full-repo scans.",
-  "graph.handoffTimestamp": "Update AGENTS.md Timestamp",
-  "graph.timestampUpdated": "Graph refresh timestamp updated in AGENTS.md.",
-  "graph.summaryFailed": "Could not fetch graph summary (gitnexus query --summary failed).",
-  "graph.statusTitle": "GitNexus Status",
-  "graph.statusInstalled": "Installed",
-  "graph.statusGraph": "Graph directory",
-  "graph.statusIndexFiles": "Index files"
+  "init.cursorCommandsInjected": "Installed {{count}} Cursor slash commands to .cursor/commands/",
+  "init.figmaIntro": "We recommend configuring Figma Developer MCP so AI can read Figma designs during development.",
+  "init.figmaDocsHint": "Generate a Personal Access Token in Figma account settings:",
+  "init.figmaConfigureQuestion": "Configure Figma Developer MCP now? (You can skip and add it later in Cursor Settings)",
+  "init.figmaSkipped": "Skipped Figma MCP setup. Before /ft-build, ensure Figma/Lanhu links or MCP are available.",
+  "init.figmaApiKeyQuestion": "Enter your Figma Personal Access Token (API Key):",
+  "init.figmaApiKeyRequired": "API Key cannot be empty",
+  "init.figmaConfigured": "Figma Developer MCP written to {{path}}",
+  "init.figmaGitignoreHint": "Note: API Key is stored in .cursor/mcp.json — add it to .gitignore to avoid leaking secrets.",
+  "build.title": "FT Build — Visual Design Fidelity",
+  "build.mandatory": "**Prefer** obtaining visual designs (Figma / Lanhu) before coding. If unavailable, supplement via the options below or skip — the build flow **will not be blocked**.",
+  "build.stepFetch": "1. Obtain visual designs (priority order)",
+  "build.stepFetchDetail": "1. Use Figma Developer MCP (`get_figma_data`, `download_figma_images`) to fetch design data\n2. Check the Visual Design section in `AGENTS.md` for Figma / Lanhu links\n3. Confirm the design URL and frame/node for the current task with the user",
+  "build.designLinksFromAgents": "Visual design info from AGENTS.md",
+  "build.figmaMcpStatus": "2. Figma MCP status",
+  "build.figmaMcpReady": "✓ Figma Developer MCP detected. Fetch design data via MCP before coding.",
+  "build.figmaMcpMissing": "✗ Figma Developer MCP not detected. Supplement API Key below, or skip and continue build.",
+  "build.fidelityRules": "3. Visual fidelity standards",
+  "build.fidelityRulesDetail": "- When designs exist, match strictly: layout, spacing, colors, typography, radius, shadows, icons, and assets\n- Do not invent UI elements absent from the design\n- Keep component hierarchy aligned with design frames/layers\n- Follow responsive/adaptation rules from design specs or AGENTS.md",
+  "build.supplement": "4. Supplement visual design info (optional, non-blocking)",
+  "build.supplementDetail": "When designs or MCP are not ready, pick an option below — or skip; build will continue.",
+  "build.supplementQuestion": "Visual designs incomplete — choose next step:",
+  "build.supplementApiKey": "Supplement Figma API Key (write to .cursor/mcp.json)",
+  "build.supplementDesignLink": "Supplement Figma / Lanhu design link",
+  "build.supplementSkip": "Skip and continue build",
+  "build.supplementSkipped": "Skipped visual design supplement — continuing build.",
+  "build.supplementDesignLinkQuestion": "Enter Figma or Lanhu design link:",
+  "build.supplementDesignLinkRequired": "Link cannot be empty",
+  "build.supplementLinkNoted": "Design link noted: {{link}} (consider adding to AGENTS.md → Visual Design)",
+  "build.supplementMcpRestartHint": "Reconnect figma-developer-mcp in Cursor Settings → MCP for the API Key to take effect.",
+  "build.supplementNonInteractive": "Non-interactive terminal: ask the user in chat for Figma API Key or design link, or to skip; build continues regardless.",
+  "build.nextStep": "5. Next step",
+  "build.nextStepDetail": "Comet build starts below regardless of design availability. Match designs strictly when available; otherwise proceed with existing context and align later.",
+  "build.visualSpec": "3.5 Visual spec (mandatory)",
+  "build.visualSpecDetail": "Before coding, read `.cursor/skills/visual-fidelity/SKILL.md` and work against `.ft/visual-spec.md` and `.ft/visual-checklist.json`.",
+  "build.visualSpecWritten": "✓ Visual spec: {{path}}",
+  "build.visualChecklistWritten": "✓ Acceptance checklist: {{path}}",
+  "build.figmaTokensExtracted": "✓ Auto-extracted {{count}} design tokens from Figma API",
+  "build.figmaTokensEmpty": "⚠ Figma API returned no tokens (supplement visual-spec via MCP manually)",
+  "build.visualSkillPath": "✓ Visual fidelity skill: {{path}}",
+  "build.checklistSummary": "Checklist: {{passed}} passed / {{pending}} pending / {{total}} total",
+  "build.agentMustReadSkill": "→ Agent: read visual-fidelity skill before coding; output acceptance report and update checklist after.",
+  "tweak.title": "FT Tweak — Visual Regression Guard",
+  "tweak.regressionIntro": "When fixing visual issues, items with passed status must not regress. Run full checklist after every fix.",
+  "tweak.agentMustReadSkill": "→ Agent: read visual-fidelity skill Tweak section; run full regression check after fix.",
+  "hotfix.title": "FT Hotfix — Visual Regression Guard",
+  "hotfix.regressionIntro": "Hotfixes follow the same visual regression protocol: passed items must not regress; run full checklist after every fix.",
+  "hotfix.agentMustReadSkill": "→ Agent: read visual-fidelity skill Tweak/Hotfix section; run full regression check after fix.",
+  "regression.specPath": "Visual spec: {{path}}",
+  "regression.specMissing": "⚠ .ft/visual-spec.md not found — run /ft-build first",
+  "regression.checklistSummary": "Checklist: {{passed}} passed (locked) / {{pending}} pending / {{failed}} failed / {{total}} total",
+  "regression.lockedItems": "Locked items (must not regress)",
+  "regression.checklistMissing": "⚠ .ft/visual-checklist.json not found — run /ft-build first",
+  "regression.skillPath": "Visual fidelity skill: {{path}}",
+  "regression.protocol": "Regression-safe fix protocol",
+  "regression.protocolDetail": "1. Fix only the reported issue (one dimension: spacing / color / typography)\n2. Do not rewrite page layout or remove verified CSS variables for local fixes\n3. Re-verify entire checklist — all passed items must stay passed\n4. Output visual acceptance report with regression table",
+  "regression.designContext": "Design context (AGENTS.md)",
+  "verify.title": "FT Verify — Visual Acceptance & Pixel Diff",
+  "verify.intro": "Review checklist status and optionally run Playwright pixel diff, then continue Comet verify workflow.",
+  "verify.checklistGate": "1. Checklist status",
+  "verify.checklistSummary": "Checklist: {{passed}} passed / {{pending}} pending / {{failed}} failed / {{total}} total",
+  "verify.checklistFailed": "⚠ Failed items exist — fix before marking passed",
+  "verify.checklistPending": "⚠ Pending items exist — complete visual acceptance",
+  "verify.checklistMissing": "⚠ .ft/visual-checklist.json not found — run /ft-build first",
+  "verify.visualDiff": "2. Pixel-level visual diff (Playwright)",
+  "verify.configPath": "Config: {{path}}",
+  "verify.visualDiffDisabled": "Pixel diff disabled (visual-verify.json → enabled: false)",
+  "verify.enableHint": "To enable: edit .ft/visual-verify.json, then run /ft-visual-tools-install to install deps",
+  "verify.scriptPath": "Diff script: {{path}}",
+  "verify.depsMissing": "⚠ playwright / pixelmatch / pngjs not found",
+  "verify.depsInstall": "One-step install: run /ft-visual-tools-install in IDE, or `ft slash visual-tools-install` in terminal",
+  "verify.screensConfigured": "Configured screens:",
+  "verify.runningDiff": "Running pixel diff...",
+  "verify.visualDiffPassed": "✓ All pixel diffs passed",
+  "verify.visualDiffFailed": "✗ Pixel diff failed — see diff images in .ft/visual-diffs/",
+  "verify.nextStepDetail": "Comet verify workflow continues below.",
+  "verify.agentInstruction": "→ Agent: if diff fails, fix UI against baselines and update visual-checklist; first-time baselines: node scripts/visual-diff.mjs --update (or FT package script path).",
+  "init.visualSkillInjected": "Installed visual-fidelity skill ({{count}} files) to .cursor/skills/",
+  "init.visualSpecScaffolded": "Scaffolded .ft/visual-spec.md, visual-checklist.json, and visual-verify.json",
+  "cursor.commandsSynced": "Synced {{count}} Cursor slash commands to .cursor/commands/",
+  "cursor.skillsSynced": "Synced visual-fidelity skill ({{count}} files) to .cursor/skills/",
+  "cursor.commandsHint": "Type / in Cursor Agent chat to use /ft-fill-context and other commands",
+  "visualTools.title": "FT Visual Tools — Install Pixel Diff Dependencies",
+  "visualTools.intro": "Install all tools required for /ft-verify pixel diff: playwright, pixelmatch, pngjs, and Chromium.",
+  "visualTools.noPackageJson": "package.json not found — initialize an npm/pnpm project in the project root first",
+  "visualTools.packageManager": "Detected package manager: **{{pm}}**",
+  "visualTools.depsAlreadyInstalled": "✓ playwright / pixelmatch / pngjs already installed — skipping deps",
+  "visualTools.installingDeps": "Installing: {{packages}}",
+  "visualTools.depsInstalled": "✓ Dependencies installed",
+  "visualTools.depsInstallFailed": "✗ Dependency install failed — check network or install manually",
+  "visualTools.installingBrowsers": "Installing Playwright Chromium browser…",
+  "visualTools.browsersInstallFailed": "✗ Chromium install failed — try: npx playwright install chromium",
+  "visualTools.verifyFailed": "✗ Dependencies still missing after install — check node_modules",
+  "visualTools.success": "✓ Visual diff tools installed",
+  "visualTools.nextStep": "Next: enable pixel diff in .ft/visual-verify.json, then run /ft-verify"
 }

package/locales/zh-CN.json

@@ -3,7 +3,6 @@
   "error.karpathyMissing": "未检测到 andrej-karpathy-skills，请参考 https://github.com/multica-ai/andrej-karpathy-skills 安装，或手动复制规则文件后重试",
   "error.cometNonInteractive": "Comet 在非交互环境（IDE）中执行失败。",
   "error.cometUseTerminal": "请在系统终端执行：comet <command>",
-  "hint.gitnexusOptional": "提示：可安装 GitNexus 增强代码认知（npm install -g gitnexus）",
   "init.injectModeQuestion": "请选择 andrej-karpathy-skills 规则的注入方式：",
   "init.injectModeManual": "1) 手动选择目标工具（推荐）",
   "init.injectModeAuto": "2) 自动检测当前环境",
@@ -15,9 +14,6 @@
   "init.runningComet": "正在执行 comet init...",
   "init.success": "✓ FT 初始化完成",
   "init.nextStep": "下一步：在 IDE 中执行 /ft-fill-context 完善项目上下文",
-  "mcp.writeSuccess": "已写入 MCP 配置：{{path}}",
-  "mcp.manualTitle": "⚠️ 无法自动写入 MCP 配置，请手动将以下内容添加到 {{path}} 中：",
-  "mcp.pressKey": "完成后按任意键继续...",
   "gate.fillContextFirst": "请先完成 /ft-fill-context，将 AGENTS.md 中的 [NEEDS LLM INPUT] 占位符填充完毕后再执行 Comet 流程命令。",
   "fillContext.title": "AGENTS.md 上下文填充任务",
   "fillContext.goal": "请直接编辑 `AGENTS.md` 文件，将 `[NEEDS LLM INPUT]` 替换为具体内容。",
@@ -30,16 +26,99 @@
   "fillContext.reference": "参考内容（来自 AGENTS-BAK.md）",
   "fillContext.backupNote": "备份合并说明",
   "fillContext.backupMerge": "模板内字段请参考旧内容重新生成；超模板自定义章节须原样追加到 AGENTS.md 末尾，并添加注释 <!-- 以下内容来自 AGENTS-BAK.md，已自动迁移 -->",
-  "graph.setupGuide": "GitNexus 未安装。请执行：",
-  "graph.alreadyInstalled": "GitNexus 已安装。",
-  "graph.handoffSummary": "图谱摘要",
-  "graph.handoffPrompt": "引导提示词",
-  "graph.handoffPromptBody": "在后续编码任务中，请优先使用 GitNexus MCP 工具（如 get_symbol、get_callers、query）获取符号级依赖与调用关系，避免盲目全文扫描。",
-  "graph.handoffTimestamp": "更新 AGENTS.md 时间戳",
-  "graph.timestampUpdated": "已更新 AGENTS.md 中的图谱刷新时间。",
-  "graph.summaryFailed": "无法获取图谱摘要（gitnexus query --summary 失败）。",
-  "graph.statusTitle": "GitNexus 状态",
-  "graph.statusInstalled": "已安装",
-  "graph.statusGraph": "图谱目录",
-  "graph.statusIndexFiles": "索引文件数"
+  "init.cursorCommandsInjected": "已安装 {{count}} 个 Cursor Slash 命令到 .cursor/commands/",
+  "init.figmaIntro": "建议配置 Figma Developer MCP，以便 AI 在开发时读取 Figma 视觉稿。",
+  "init.figmaDocsHint": "在 Figma 账户设置中生成 Personal Access Token：",
+  "init.figmaConfigureQuestion": "是否现在配置 Figma Developer MCP？（可跳过，稍后在 Cursor 设置中手动添加）",
+  "init.figmaSkipped": "已跳过 Figma MCP 配置。使用 /ft-build 前请确保已提供 Figma/蓝湖链接或手动配置 MCP。",
+  "init.figmaApiKeyQuestion": "请输入 Figma Personal Access Token（API Key）：",
+  "init.figmaApiKeyRequired": "API Key 不能为空",
+  "init.figmaConfigured": "已写入 Figma Developer MCP 配置：{{path}}",
+  "init.figmaGitignoreHint": "提示：API Key 已写入 .cursor/mcp.json，建议将 .cursor/mcp.json 加入 .gitignore 避免泄露。",
+  "build.title": "FT Build — 视觉稿还原约束",
+  "build.mandatory": "**优先**在编码前获取并对齐视觉稿（Figma / 蓝湖等）。若暂时无法获取，可通过下方选项补充或跳过，**不会中断** build 流程。",
+  "build.stepFetch": "1. 获取视觉稿（按优先级）",
+  "build.stepFetchDetail": "1. 使用 Figma Developer MCP（`get_figma_data`、`download_figma_images`）读取设计数据\n2. 查阅 `AGENTS.md`「视觉稿」章节中的 Figma / 蓝湖链接\n3. 向用户确认当前任务对应的设计稿链接与 frame/node",
+  "build.designLinksFromAgents": "AGENTS.md 中的视觉稿信息",
+  "build.figmaMcpStatus": "2. Figma MCP 状态",
+  "build.figmaMcpReady": "✓ 已检测到 Figma Developer MCP 配置。请通过 MCP 拉取设计数据后再编码。",
+  "build.figmaMcpMissing": "✗ 未检测到 Figma Developer MCP。可通过下方选项补充 API Key，或跳过并继续 build。",
+  "build.fidelityRules": "3. 视觉还原标准",
+  "build.fidelityRulesDetail": "- 有视觉稿时严格还原：布局、间距、颜色、字体、圆角、阴影、图标与切图\n- 不得凭猜测补充设计中不存在的 UI 元素\n- 组件层级与命名尽量与设计稿 frame/layer 结构一致\n- 响应式/适配规则以设计稿标注或 AGENTS.md 说明为准",
+  "build.supplement": "4. 补充视觉稿信息（可选，不阻塞）",
+  "build.supplementDetail": "视觉稿或 MCP 未就绪时，请选择一项补充；也可跳过，build 流程将继续执行。",
+  "build.supplementQuestion": "视觉稿获取不完整，请选择下一步：",
+  "build.supplementApiKey": "补充 Figma API Key（写入 .cursor/mcp.json）",
+  "build.supplementDesignLink": "补充 Figma / 蓝湖设计链接",
+  "build.supplementSkip": "跳过，继续 build",
+  "build.supplementSkipped": "已跳过视觉稿补充，继续 build 流程。",
+  "build.supplementDesignLinkQuestion": "请输入 Figma 或蓝湖设计链接：",
+  "build.supplementDesignLinkRequired": "链接不能为空",
+  "build.supplementLinkNoted": "已记录设计链接：{{link}}（建议同步写入 AGENTS.md「视觉稿」章节）",
+  "build.supplementMcpRestartHint": "提示：请在 Cursor Settings → MCP 中重连 figma-developer-mcp 使 API Key 生效。",
+  "build.supplementNonInteractive": "非交互终端：请在对话中请用户补充 Figma API Key 或设计链接，或选择跳过；build 流程将继续。",
+  "build.nextStep": "5. 下一步",
+  "build.nextStepDetail": "无论是否已获取视觉稿，下方将继续 Comet build 工作流。有视觉稿时按标准严格还原；暂无时先按现有信息推进，待补充后再对齐。",
+  "build.visualSpec": "3.5 视觉规格单（强制）",
+  "build.visualSpecDetail": "编码前必须阅读 `.cursor/skills/visual-fidelity/SKILL.md`，并对照 `.ft/visual-spec.md` 与 `.ft/visual-checklist.json` 工作。",
+  "build.visualSpecWritten": "✓ 视觉规格单：{{path}}",
+  "build.visualChecklistWritten": "✓ 验收清单：{{path}}",
+  "build.figmaTokensExtracted": "✓ 已从 Figma API 自动提取 {{count}} 个 design token",
+  "build.figmaTokensEmpty": "⚠ Figma API 未返回 token（请通过 MCP 手动补充 visual-spec）",
+  "build.visualSkillPath": "✓ 视觉还原 Skill：{{path}}",
+  "build.checklistSummary": "验收项：{{passed}} 已通过 / {{pending}} 待验 / 共 {{total}} 项",
+  "build.agentMustReadSkill": "→ Agent：编码前读取 visual-fidelity skill；编码后输出视觉验收报告并更新 checklist。",
+  "tweak.title": "FT Tweak — 视觉回归防护",
+  "tweak.regressionIntro": "修复视觉问题时，已通过（passed）的验收项不得回退。每次修复后必须全量回归检查。",
+  "tweak.agentMustReadSkill": "→ Agent：读取 visual-fidelity skill 的 Tweak 章节，修复后全量回归验收。",
+  "hotfix.title": "FT Hotfix — 视觉回归防护",
+  "hotfix.regressionIntro": "紧急修复同样适用视觉回归协议：已通过（passed）的验收项不得回退，修复后必须全量回归检查。",
+  "hotfix.agentMustReadSkill": "→ Agent：读取 visual-fidelity skill 的 Tweak/Hotfix 章节，修复后全量回归验收。",
+  "regression.specPath": "视觉规格单：{{path}}",
+  "regression.specMissing": "⚠ 未找到 .ft/visual-spec.md — 建议先执行 /ft-build 生成规格单",
+  "regression.checklistSummary": "验收项：{{passed}} 已通过（锁定）/ {{pending}} 待验 / {{failed}} 失败 / 共 {{total}} 项",
+  "regression.lockedItems": "已锁定项（修复时不得回退）",
+  "regression.checklistMissing": "⚠ 未找到 .ft/visual-checklist.json — 建议先执行 /ft-build",
+  "regression.skillPath": "视觉还原 Skill：{{path}}",
+  "regression.protocol": "回归修复协议",
+  "regression.protocolDetail": "1. 仅修复当前报告的问题（单维度：间距 / 颜色 / 字号）\n2. 禁止为局部修复重写整页布局或删除已验收的 CSS 变量\n3. 修复后逐项核对 checklist — 所有 passed 项必须保持 passed\n4. 输出视觉验收报告（含回归对照表）",
+  "regression.designContext": "设计稿上下文（AGENTS.md）",
+  "verify.title": "FT Verify — 视觉验收与像素对比",
+  "verify.intro": "验收 checklist 状态并可选运行 Playwright 像素 diff，随后继续 Comet verify 工作流。",
+  "verify.checklistGate": "1. 验收清单状态",
+  "verify.checklistSummary": "验收项：{{passed}} 已通过 / {{pending}} 待验 / {{failed}} 失败 / 共 {{total}} 项",
+  "verify.checklistFailed": "⚠ 存在 failed 项 — 请修复后再标记 passed",
+  "verify.checklistPending": "⚠ 存在 pending 项 — 请完成视觉验收",
+  "verify.checklistMissing": "⚠ 未找到 .ft/visual-checklist.json — 建议先执行 /ft-build",
+  "verify.visualDiff": "2. 像素级视觉对比（Playwright）",
+  "verify.configPath": "配置文件：{{path}}",
+  "verify.visualDiffDisabled": "像素对比已禁用（visual-verify.json → enabled: false）",
+  "verify.enableHint": "启用步骤：编辑 .ft/visual-verify.json，然后执行 /ft-visual-tools-install 安装依赖",
+  "verify.scriptPath": "对比脚本：{{path}}",
+  "verify.depsMissing": "⚠ 未检测到 playwright / pixelmatch / pngjs",
+  "verify.depsInstall": "一键安装：在 IDE 执行 /ft-visual-tools-install，或终端运行 `ft slash visual-tools-install`",
+  "verify.screensConfigured": "已配置页面：",
+  "verify.runningDiff": "正在运行像素对比...",
+  "verify.visualDiffPassed": "✓ 像素对比全部通过",
+  "verify.visualDiffFailed": "✗ 像素对比未通过 — 查看 .ft/visual-diffs/ 中的 diff 图",
+  "verify.nextStepDetail": "下方将继续 Comet verify 工作流。",
+  "verify.agentInstruction": "→ Agent：若 diff 失败，对照 baseline 修复 UI 并更新 visual-checklist；首次建立 baseline 可运行 node scripts/visual-diff.mjs --update（或通过 ft 包内脚本路径）。",
+  "init.visualSkillInjected": "已安装 visual-fidelity skill（{{count}} 个文件）到 .cursor/skills/",
+  "init.visualSpecScaffolded": "已生成 .ft/visual-spec.md、visual-checklist.json 与 visual-verify.json 模板",
+  "cursor.commandsSynced": "已同步 {{count}} 个 Cursor Slash 命令到 .cursor/commands/",
+  "cursor.skillsSynced": "已同步 visual-fidelity skill（{{count}} 个文件）到 .cursor/skills/",
+  "cursor.commandsHint": "在 Cursor Agent 聊天框输入 / 即可看到 /ft-fill-context 等命令",
+  "visualTools.title": "FT Visual Tools — 一键安装像素对比依赖",
+  "visualTools.intro": "安装 /ft-verify 像素 diff 所需的全部工具：playwright、pixelmatch、pngjs，以及 Chromium 浏览器。",
+  "visualTools.noPackageJson": "未找到 package.json — 请先在项目根目录初始化 npm/pnpm 项目",
+  "visualTools.packageManager": "检测到包管理器：**{{pm}}**",
+  "visualTools.depsAlreadyInstalled": "✓ playwright / pixelmatch / pngjs 已安装，跳过依赖安装",
+  "visualTools.installingDeps": "正在安装：{{packages}}",
+  "visualTools.depsInstalled": "✓ 依赖安装完成",
+  "visualTools.depsInstallFailed": "✗ 依赖安装失败 — 请检查网络或手动安装",
+  "visualTools.installingBrowsers": "正在安装 Playwright Chromium 浏览器…",
+  "visualTools.browsersInstallFailed": "✗ Chromium 安装失败 — 可手动运行 npx playwright install chromium",
+  "visualTools.verifyFailed": "✗ 安装后仍未检测到全部依赖，请检查 node_modules",
+  "visualTools.success": "✓ 视觉对比工具安装完成",
+  "visualTools.nextStep": "下一步：编辑 .ft/visual-verify.json 启用像素对比，然后执行 /ft-verify"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nick848/ft",
-  "version": "0.1.0",
-  "description": "Frontend Toolkit — CLI orchestration layer for Comet, Karpathy rules, and GitNexus",
+  "version": "0.1.1",
+  "description": "Frontend Toolkit — CLI orchestration layer for Comet and Karpathy rules",
   "type": "module",
   "bin": {
     "ft": "./dist/index.js"
@@ -10,6 +10,9 @@
     "dist",
     "templates",
     "rules-templates",
+    "cursor-commands-templates",
+    "skills-templates",
+    "scripts",
     "locales",
     "README.md",
     "LICENSE"
@@ -34,7 +37,6 @@
     "cursor",
     "codex",
     "opencode",
-    "gitnexus",
     "agents"
   ],
   "author": "nick848",
@@ -47,7 +49,6 @@
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "cosmiconfig": "^9.0.0",
-    "deepmerge": "^4.3.1",
     "execa": "^9.5.2",
     "handlebars": "^4.7.8",
     "inquirer": "^12.4.2",

package/scripts/visual-diff.mjs

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * FT visual diff — run from project root via `ft slash verify`.
+ * Requires project devDependencies: playwright, pixelmatch, pngjs
+ *
+ * Install: npm i -D playwright pixelmatch pngjs && npx playwright install chromium
+ * Update baselines: node <ft>/scripts/visual-diff.mjs --update
+ */
+import { createRequire } from 'node:module';
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+} from 'node:fs';
+import path from 'node:path';
+
+const projectRoot = process.cwd();
+const requireFromProject = createRequire(path.join(projectRoot, 'package.json'));
+
+function loadDependency(name) {
+  try {
+    return requireFromProject(name);
+  } catch {
+    console.error(
+      `Missing dependency "${name}". Install in project root:\n` +
+        '  npm i -D playwright pixelmatch pngjs\n' +
+        '  npx playwright install chromium',
+    );
+    process.exit(2);
+  }
+}
+
+const CONFIG_PATH = path.join(projectRoot, '.ft', 'visual-verify.json');
+const UPDATE_BASELINES = process.argv.includes('--update');
+
+function readConfig() {
+  if (!existsSync(CONFIG_PATH)) {
+    console.error(`Config not found: ${CONFIG_PATH}`);
+    console.error('Run `ft slash verify` to scaffold, then edit screens.');
+    process.exit(2);
+  }
+  return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
+}
+
+function rgbaToHex(r, g, b) {
+  const byte = (v) => Math.round(v).toString(16).padStart(2, '0');
+  return `#${byte(r)}${byte(g)}${byte(b)}`;
+}
+
+async function compareImages(baselinePath, actualPath, diffPath, threshold) {
+  const { PNG } = loadDependency('pngjs');
+  const pixelmatch = loadDependency('pixelmatch');
+
+  const baseline = PNG.sync.read(readFileSync(baselinePath));
+  const actual = PNG.sync.read(readFileSync(actualPath));
+
+  if (baseline.width !== actual.width || baseline.height !== actual.height) {
+    return {
+      passed: false,
+      diffPixels: baseline.width * baseline.height,
+      diffPercent: 100,
+      error: `Size mismatch: baseline ${baseline.width}x${baseline.height}, actual ${actual.width}x${actual.height}`,
+    };
+  }
+
+  const diff = new PNG({ width: baseline.width, height: baseline.height });
+  const diffPixels = pixelmatch(
+    baseline.data,
+    actual.data,
+    diff.data,
+    baseline.width,
+    baseline.height,
+    { threshold: threshold / 100 },
+  );
+
+  const totalPixels = baseline.width * baseline.height;
+  const diffPercent = (diffPixels / totalPixels) * 100;
+  const passed = diffPercent <= threshold;
+
+  if (!passed || diffPixels > 0) {
+    writeFileSync(diffPath, PNG.sync.write(diff));
+  }
+
+  return { passed, diffPixels, diffPercent };
+}
+
+async function main() {
+  const config = readConfig();
+  if (!config.enabled) {
+    console.log('Visual diff disabled in .ft/visual-verify.json (enabled: false).');
+    console.log(JSON.stringify({ passed: true, results: [], skipped: true }));
+    process.exit(0);
+  }
+
+  if (!config.screens?.length) {
+    console.error('No screens configured in visual-verify.json');
+    process.exit(2);
+  }
+
+  const { chromium } = loadDependency('playwright');
+  const outputDir = path.resolve(projectRoot, config.outputDir ?? '.ft/visual-diffs');
+  mkdirSync(outputDir, { recursive: true });
+
+  const browser = await chromium.launch({ headless: true });
+  const results = [];
+
+  try {
+    for (const screen of config.screens) {
+      const viewport = screen.viewport ?? { width: 1280, height: 720 };
+      const baselinePath = path.resolve(projectRoot, screen.baseline);
+      const actualPath = path.join(outputDir, `${screen.id}-actual.png`);
+      const diffPath = path.join(outputDir, `${screen.id}-diff.png`);
+      const url = `${config.baseUrl.replace(/\/$/, '')}${screen.path}`;
+
+      mkdirSync(path.dirname(baselinePath), { recursive: true });
+
+      const context = await browser.newContext({ viewport });
+      const page = await context.newPage();
+
+      try {
+        await page.goto(url, { waitUntil: 'networkidle', timeout: 30000 });
+        await page.screenshot({ path: actualPath, fullPage: false });
+
+        if (UPDATE_BASELINES || !existsSync(baselinePath)) {
+          writeFileSync(baselinePath, readFileSync(actualPath));
+          results.push({
+            id: screen.id,
+            passed: true,
+            diffPixels: 0,
+            diffPercent: 0,
+            baseline: screen.baseline,
+            actual: path.relative(projectRoot, actualPath),
+            updated: true,
+          });
+          console.log(`✓ Baseline updated: ${screen.baseline}`);
+          continue;
+        }
+
+        const comparison = await compareImages(
+          baselinePath,
+          actualPath,
+          diffPath,
+          config.threshold ?? 0.1,
+        );
+
+        results.push({
+          id: screen.id,
+          passed: comparison.passed,
+          diffPixels: comparison.diffPixels,
+          diffPercent: Number(comparison.diffPercent.toFixed(4)),
+          baseline: screen.baseline,
+          actual: path.relative(projectRoot, actualPath),
+          diff: comparison.diffPixels > 0 ? path.relative(projectRoot, diffPath) : undefined,
+          error: comparison.error,
+        });
+
+        const status = comparison.passed ? '✓' : '✗';
+        const pct = comparison.diffPercent.toFixed(2);
+        console.log(
+          `${status} ${screen.id}: ${pct}% diff (${comparison.diffPixels} px)` +
+            (comparison.error ? ` — ${comparison.error}` : ''),
+        );
+      } catch (err) {
+        results.push({
+          id: screen.id,
+          passed: false,
+          diffPixels: 0,
+          diffPercent: 100,
+          baseline: screen.baseline,
+          actual: path.relative(projectRoot, actualPath),
+          error: err.message,
+        });
+        console.error(`✗ ${screen.id}: ${err.message}`);
+      } finally {
+        await context.close();
+      }
+    }
+  } finally {
+    await browser.close();
+  }
+
+  const passed = results.every((r) => r.passed);
+  const report = { passed, results };
+  console.log(JSON.stringify(report));
+
+  process.exit(passed ? 0 : 1);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/skills-templates/visual-fidelity/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: visual-fidelity
+description: >-
+  Enforces pixel-level visual design fidelity from Figma/Lanhu specs. Reads
+  .ft/visual-spec.md and .ft/visual-checklist.json before coding. Use during
+  /ft-build, /ft-tweak, /ft-hotfix, or any UI implementation from design files.
+  Requires acceptance checklist pass and full regression re-check after changes.
+---
+
+# Visual Fidelity
+
+## Before coding
+
+1. Read `.ft/visual-spec.md` and `.ft/visual-checklist.json`
+2. If Figma MCP is available, call `get_figma_data` for the frame/node in the spec
+3. Update the spec with extracted tokens — **never guess** colors, spacing, or typography
+4. Mark unknown values as `TBD`; do not invent UI elements absent from the design
+
+## While coding
+
+- Use design tokens / CSS variables from the spec — no hardcoded magic numbers
+- Map Figma layers to code components in the Component Map table
+- One frame per task; do not mix unrelated screens in one edit
+
+## After coding
+
+Output a **Visual Acceptance Report** using this template:
+
+```markdown
+## 视觉验收报告
+
+### 本次变更
+- 问题/任务：…
+- 改动文件：…（仅列必要文件）
+
+### 验收对照
+| 验收项 ID | 状态 | 设计值 | 实现值 |
+|-----------|------|--------|--------|
+| … | ✅/❌ | … | … |
+
+### 回归检查（已通过项必须保持 ✅）
+| 验收项 ID | 状态 | 说明 |
+|-----------|------|------|
+| … | ✅ 保持 | … |
+```
+
+Update `.ft/visual-checklist.json`: set `status` to `passed` only when design and implementation match.
+
+## Verify / pixel diff
+
+During `/ft-verify`:
+
+1. Review checklist — no `failed` items should remain before sign-off
+2. If `.ft/visual-verify.json` has `enabled: true`, pixel diff runs automatically
+3. On diff failure, inspect `.ft/visual-diffs/*-diff.png` and fix UI
+4. First-time baselines: `node <ft-package>/scripts/visual-diff.mjs --update`
+
+## Tweak / hotfix regression protocol
+
+When fixing a visual issue:
+
+1. Read checklist — list all items with `status: "passed"` (**locked items**)
+2. Fix **one dimension** at a time (spacing OR color OR typography)
+3. Do **not** rewrite layout or remove CSS variables to fix a local issue
+4. After fix, re-run **full checklist** — every locked item must remain `passed`
+5. If a locked item regresses, revert the breaking change before continuing
+
+## Forbidden
+
+- Inventing UI elements not in the design
+- Hardcoding colors/spacing when tokens exist in the spec
+- Marking checklist items `passed` without verifying values
+- Fixing issue B by undoing a verified fix for issue A
+
+## Additional resources
+
+- Acceptance item schema: [checklist-schema.md](checklist-schema.md)

package/skills-templates/visual-fidelity/checklist-schema.md

@@ -0,0 +1,33 @@
+# Visual Checklist Schema
+
+`.ft/visual-checklist.json` structure:
+
+```json
+{
+  "version": 1,
+  "frame": "Frame name or TBD",
+  "figmaNodeId": "optional node id",
+  "items": [
+    {
+      "id": "unique-kebab-id",
+      "category": "color | spacing | typography | layout | asset | other",
+      "description": "Human-readable acceptance criterion",
+      "designValue": "Expected value from design",
+      "cssVariable": "optional --token-name",
+      "status": "pending | passed | failed"
+    }
+  ]
+}
+```
+
+## Status rules
+
+| Status | Meaning |
+|--------|---------|
+| `pending` | Not yet verified |
+| `passed` | Verified match — **locked** during tweak/hotfix |
+| `failed` | Known mismatch — must fix before marking passed |
+
+## ID naming
+
+Use `{category}-{element}-{property}`: e.g. `spacing-header-margin-bottom`, `color-cta-background`.

package/templates/AGENTS.md.en.hbs

@@ -27,6 +27,10 @@
 
 [NEEDS LLM INPUT]
 
+## Visual Design
+
+[NEEDS LLM INPUT]
+
 ## Mini Program Info
 
 [NEEDS LLM INPUT]
@@ -41,6 +45,4 @@
 
 ## AI Working Guide
 
-{{gitnexus_condition}}
-
-- Graph last refreshed: not initialized
+- Prefer Comet ecosystem tools (e.g. CodeGraph) for code analysis; follow project MCP and Comet workflow configuration.

package/templates/AGENTS.md.zh.hbs

@@ -27,6 +27,10 @@
 
 [NEEDS LLM INPUT]
 
+## 视觉稿
+
+[NEEDS LLM INPUT]
+
 ## 小程序信息
 
 [NEEDS LLM INPUT]
@@ -41,6 +45,4 @@
 
 ## AI 工作指南
 
-{{gitnexus_condition}}
-
-- 图谱最后刷新时间: 未初始化
+- 代码分析优先使用 Comet 生态工具（如 CodeGraph），遵循项目已配置的 MCP 与 Comet 工作流。