loopdeck

提示教练 [English](README.md) | [한국어](README.ko.md) **本地优先的提示词记忆和 Claude Code 及 Codex 教练。** - 🗂️ 捕获您发送给 Claude Code / Codex 的每个提示词到本地 Markdown + SQLite 存档 — 不会离开您的机器。 - 🧠 根据五项标准为每个提示词评分 0–100，并告诉您哪些轴成本点，以便您学习而不是猜测。 - ✍️ 按需生成可复制的改进草稿（英语或韩语，自动检测）而无需自动重新提交任何内容。 ```sh npm install -g prompt-coach prompt-coach setup --profile coach --register-mcp --open-web # 然后发送一个真正的 Claude Code 或 Codex 提示词并运行： prompt-coach coach ``` `prompt-coach` 是一个开发者工具，安全地记录您输入到 AI 编程工具（如 Claude Code 和 Codex）的提示词，帮助您找到它们，分析弱提示模式，并帮助您编写更好的后续请求。 它在本地收集支持的工具提示，存储前会删除敏感值，写入 Markdown 文件，在 SQLite 中索引，并提供一个本地 Web UI 用于搜索、审查、存档评分、提示练习、分析、删除和基于复制的提示改进。 本项目与 Anthropic、OpenAI 或任何其他 AI 工具提供商无关、未获得其认可或赞助。诸如 Claude Code 和 Codex 之类的产品名称仅用于描述兼容性。 ## 首个 3 分钟教练循环 首个成功不是 Web 仪表盘。而是看到一个分数和一个有用的修复真正的 Claude Code 或 Codex 提示。 对于大多数用户，快乐路径是： ```sh prompt-coach start --open-web prompt-coach setup --profile coach --register-mcp --open-web # 发送一个真正的 Claude Code 或 Codex 编程提示 prompt-coach coach ``` 如果不需要在新代理会话中自动打开 Web 工作区，请跳过 `--open-web`。 仅在该路径失败后才进行故障排除： ```sh prompt-coach doctor claude-code prompt-coach doctor codex ``` 如果 MCP 注册失败，请重新运行一键设置： ```sh prompt-coach setup --profile coach --register-mcp --open-web手动 `claude mcp add` / `codex mcp add` 命令仅用于高级故障排除。`setup --register-mcp` 是首选，因为它使用当前的 CLI 入口点；从克隆的检出中，这意味着绝对的 Node + `dist/` 路径，因此 Codex 不依赖于 `prompt-coach` 在 `PATH` 中全局可用。 仅当您想要仪表盘、搜索、历史记录审查或导出时，才打开本地存档。 ## 状态 此仓库是预发布软件。 - Claude Code 支持：MVP 路径 - Codex 支持：测试适配器 - 本地基于规则的分析预览：已实现 - 提示质量评分：作为本地确定性 `0-100` 评分标准实现 - MCP 提示评分工具：作为本地_stdio_服务器实现 - 基于复制的提示教练：已实现，包括原始无报 - 提示练习工作区：作为具有评分历史和结果反馈的本地草稿和评分 UI 实现，不存储草稿文本导入：仅 CLI - 匿名导出：Web UI 和 CLI 预览/作业流程 - 基1：作为本地实现 - 英文文 Web UI： - 外部 LLMprompt-coach隐藏的提供商的 MCP 代理/判断数据包可以在进入活动用户控制/Codex/G CLI 提供商会话。 - 默认数据处理：仅 要求 .js `>=22 <- pnpm `` - `better` 支持的平台目标是 Node Node 24。 快速入门 有两个1. `` CLI，拥有、钩子、 UI 2 Code 或 Codex 市场代理人易于/打开工作市场插件不会自行安装进制文件。首先安装添加市场。 下面的示例 CLI 命令 `ach`。从开发检出运行pm prompt-coach` 代替。 ### 安装 CLI 在后： npm install -ach ``` 用于从此仓库进行本地开发sh git://github.com/wlsrompt-coach prompt-coach pnpm install # 还 生命周期构建 dist setup # Code + Codex MCP、状态行和服务 ``` `pnpm install` 通过 `prepare` 生命周期自动运行 `pnpm build`，因此新克隆的检出后会有可用的 `dist/`。 `pnpm setup` 是 `pnpm prompt-coprofile coach --register-mcp --open-web` 的别名 — 一个命令，连接每个检测到的代理（Claude Code 和 Codex），注册具有绝对路径的 MCP 服务器，安装 Claude Code 状态行，并启用会话启动时的本地服务器。 ### 2. 添加 Claude Code 市场 在 Claude Code 中： ```text /plugin marketplace add wlsdks/prompt-coach /plugin install prompt-coach /reload-plugins /prompt-coach:setup ``` `/prompt-coach:setup` 检查 CLI 是否可用，预览 `prompt-coach setup --profile coach --register-mcp`，在写入设置在批准后运行真正的设置。 ### 3. 添加 Codex 市场 从您的 shell： ```sh codex plugin marketplacedks/prompt-coach ``` 然后运行本地教练设置： ```sh prompt-coach setup --profile coach --register-mcp --open-web ``` Codex 目前通过 `codex plugin marketplace add/upgrade/remove` 公开市场管理。提示捕获钩子由 `prompt-coach setup` 安装 Codex 钩子配置，启用 `[features].hooks`，并注册 MCP 服务器。在开发检出中，运行与 `pnpm setup` 相同的流程；绝对路径注册 MCP。 ### 4. 检查捕获 ```sh prompt-coach doctor claude-code prompt-coach doctor codex prompt-coach statusline claude-code prompt-coach buddy --once prompt-coach coach ``` 打开本地存档： ```text http://127.0.0.1:17373 ``` ## 支持的平台 发布验证目前针对： - 通过 GitHub Actions 的 Linux x64 - Node.js 22 和 24 macOS、Linux arm64 和 Windows 支持是预期的，但它们仍然需要发布烟雾验证 `better-sqlite3`、文件系统权限和钩子命令行为，然后才能声称稳定发布。 ## 安装（开发检出）和设置选项 本贡献者和希望记录每个 `setup` 标志从 npm 安装 `prompt-coach` 的最终用户应遵循[快速入门](#快速入门)并将参考。 用于本地开发而无需代理市场流程： ```sh pnpm install pnpm build ``` 运行引导本地教练设置： ```sh pnpm prompt-coach setup --profile coach --register-mcp ``` `setup` 有意明确。安装 npm/pnpm 包不应默默编辑 Claude Code 或 Codex 设置，安装登录服务或启动本地后台服务器。`prompt-coach setup` 是同意步骤，准备本地存档，连接机器上安装的支持工具，并配置本地服务器启动（如果支持）。 ： - 初始化目录 - 检测 `claude` 和 `- 为检测到的工具安装 Claude Code 和/或 Codex 钩子 - 使用 `--profile coach`，通过钩子上下文添加低摩擦重写指导，而不是让您运行单独的评分/改进命令 - 使用 `--profile coach`，在检测到 Claude Code 时安装 Claude Code 状态行。现有的 Claude Code 状态行命令被链接和恢复，在可能的情况下卸载。 - 使用 `--register-mcp`，使用当前 CLI 入口点注册具有绝对路径的 MCP 服务器 - 使用 `--open-web`，安装 `SessionStart` 钩子，确保本地服务器正在运行，并在每个代理会话中打开 `http://127.0.0.1:17373` 一次 - 启用检测到 Codex 时的 `[features].hooks` - 在支持的平台上安装并启动 macOS LaunchAgent 以启动本地服务器 - 打印更改的下一步骤和路径 预览设置而： ```pm prompt-coprofile coach --register-mcp --dry-run选择类似 Serena 的启动体验，当您希望 Web在 Claude Code 或 Codex 旁边自动打开```sh pnpm prompt-coach setup coach --register-mcp --open-web ``` 默认情况下不启用此功能。它写入显式的 `Session 钩子，在每个代理会话 ID 中最多打开一次浏览器，并在没有提示正文、原始路径或令牌输出的情况下保持钩子失败打开。 仅在不需要指导时使用被动捕获： ```sh pnpm prompt-coach setup ``` 如果您不需要后台服务，请使用： ```sh pnpm prompt-coach setup --no-service pnpm prompt-coach server ``` Web UI URL 与快速入门相同：`http://127.0.0.1:17373`。 您仍然可以手动运行每个设置步骤。 初始化本地数据目录： ```sh pnpm prompt-coach init ``` 默认情况下，数据存储在： ```text ~/.prompt-coach ``` 您可以使用 `--data-dir` 使用不同的位置： ```sh pnpm prompt-coach init --data-dir /path/to/prompt-coach-data ``` ## 启动本地服务器 ```sh pnpm prompt-coach server ``` ```text http://127.0.1:17373 ``` 在浏览器中网址以使用 Web UI。 在 macOS 上，`setup` 可以安装 LaunchAgent，以便在登录时服务器。您也可以直接管理它： pnpm prompt-coach service install pnach service status pnpm prompt-coach service start pnpm prompt-coach service stop ``` ## 连接 Claude Code 安装 Claude Code 钩子： ```sh pnpm prompt-coach install-hook-code ``` 可选的提示重写保护： ```sh pnpm prompt-coach install-hook claude-code --rewrite-guard block-and-copy --rewrite-min-score 80 ``` 可选的 Web 自动打开： ```sh pnpm prompt-coach install-hook-code --open-web ``` `block-and-copy的 `User 决策路径：弱提示在 Claude Code 处理它们之前被阻止，的本地草稿，并尝试将该草稿复制到剪贴板。它不会键入终端，按 Enter，替换合成器内容或自动提交任何内容取服务器不可用或摄取失败，则打开，不会阻止提示。 `--rewrite-guard` 标志接受四种模式： ` — 仅捕获；无指导或阻止 - `context` — 软。注入改进作为 `` 与用户的提交Claude 看 - `ask` — 指示代理在提出一个或清问题。在 Claude Code 上，这使用原生 `Question` 工具；在 Codex 上，它调用 `ask_clarifying_questions` MCP 工具，并带有原生 OS 对话框备用方案 - `block-and-copy` — 上面描述 当 `ask` 模式触发时，prompt-coach 记录事件（工具、分数、频段、缺失轴、语言、提示长度），并在仪表板上显示一个 7 天询问模式** 面板，以便您查看触发门控（长度 ≥ 30，分数60，不是确认）是否正在触发正确的案例设置更改而无需写入： ```sh pnpm prompt-coach install-hook claude-code --dry-run ``` 诊断设置： ```sh pnpm prompt-coach doctor claude-code ``` ` 检查本地服务器可达性、摄取令牌、钩子安装和 MCP 命令访问。对于 MCP已知的本地需要时回只读 `claude mcp list`钩子： ```sh pnpmach uninstall-hook claude-code ``` 安装程序 Code 设置文件中写入一个 prompt-coach 命令，并在更改现有文件之前创建备份。钩子命令不包含摄取令牌。 ## 连接 Codex 测试版x 钩子支持处于测试阶段。 x 钩 ```sh pnpm prompt-coach install-hook codex ``` 可选的提示重写保护： ```sh pnach install-hook codex --rewrite-g-copy --rewrite-min-score 80 ``` 可选的 Web 自动打开： ```sh pnach install-hook --open-webx 支持使用相同的安全钩子命令路径 插件本地钩子可能因 Code异，`prompt-coach setup`-hook` 仍然写入用户级钩子摄取服务器不可用或摄取失败，则钩子失败打开，不会阻止提示。 .json` 和 `config.toml` 更改： ```sh pnpm prompt-coach install-hook codex --dry-run ``` 诊断设置： ```sh pnpm prompt-coachx ``` `doctor` 检查本地服务器可达性、摄取令牌、钩子安装、Codex 钩子功能状态和 MCP 命令访问。对于 MCP，它首先检查已知的本地配置文件，然后在需要时回落到只读 `codex mcp list`。 删除钩子： ```sh pnpm prompt-coach uninstall-hook codex ``` Codex 安装程序默认针对用户级配置： ```text ~/.codex/hooks.json ~/.codex/config.toml ``` 它启用：toml [features] hooks = true卸载会删除 prompt-coach 钩子条将 Codex 功能标志留在原处。 ## 代理包装器实验 `pc-claude` 和 `pc-codex` 是初始提示参数的实验性前门包装器。它们在本地对评分，在提示较弱时生成删节的改进，然后使用选启动真正的 `cl 或 `code进制文件。 pc-claude --pc-mode auto -- this" pc-codepc-mode auto this" pc-codepc-mode "fix this不启动代理使用 dry-run什么： pc-cl-mode auto --ry-run -- "fix this" pc-codepc-mode auto --pc-dry-run -- "fix this" ``` 包装以 `--pc-*` 为前缀，以便仍正常的 Claude/Codex 选项。默认模式为 `ask`； `--pc-mode auto` 是一种一键模式，无替换低分初始提示。诸如 `auth`、`mcp`、`plugin` 和 ` 之类的管理子命令在不重写的情况下直接传递。这些包装器不会拦截交互式会话中稍后输入的每个消息。 ## 插件仓库还提供插件打包工件： ```text .claude-plugin commands plugins/prompt-coach integrations/claude-code docs/PLUGINS.md ``` 推荐顺序： 1. 安装 `prompt` CLI 2. 添加代理市场 运行 `prompt-coach setup` 或 `/:setup` Claude Code 可以使用此仓库作为市场： ```text /plugin marketplace add wlsdks/prompt-coach /plugin install prompt-coach /reload-plugins /prompt-coach:setup ``` Claude Code 插件提供：text /promptsetup ach:status-coach/prompt-cobuddy ach:coach-coach/prompt-cojudge ach:im /prompthabits /prompt-coach:`/prompt-coguard` 打开一个交互式选择器（ 上下文 / 阻止并复制），该选择要求您记住标志的情况下切换Submit`保护模式。运行-coach hook 以查看每个检测当前安装的模式。 `/prompt-coach 首先运行 `prompt-coach setup --`，在询问，然后可以可选一个带有最新提示分数的小型 Claude CodeLine` ： ```sh pnpm prompt-coach install-statusline cl``` 如果已 Claude Code HUDach 通过一个 `statusLine保留它，在可能时恢复原始 Claude Code，请在代理终端窗始终开启的： ```pm prompt-co ``` 使用 prompt-coonce` 进行快照，或pm prompt-co --json`Codex 插件在 `plugins/p` 下包含codex-plugin单、一个的 `User钩子和一个小技能，帮助 安装、诊断和使用本地存档。 Codex 捕获通过其文档子设置公开，因此 `integraude-code/docs/settings.example.json`示例提供。对于正常使用，首 ```sh pnpm prompt-coach setup ``` 显式设置命令仍然是必需的，因为插件发现不应默默编辑用户设置，安装登录服务或启动本地服务器。参见 `docs/PLUGINS.md` 获取打包边界和手动配置说明。 手动渲染 Claude Code 状态行： ```sh pnpm prompt-coach statusline claude-code ``` 手动渲染侧窗格伙伴快照： pnpm prompt-coach buddy``` Codex 可以将添加为市场： ```sh plugin marketplace add wlsdrompt-coach ``` 之后，使用-coach setup` 安装 Codex并启用 Codex 钩子。 界面 列出提示: ```sh pnpm prompt-coach list ``` 搜索提示: ```sh pnpm prompt-coach search "迁移计划" ``` 显示提示的 Markdown 正文: ```sh pnpm prompt-coach show <提示 ID> ``` 删除提示: ```sh pnpm prompt-coach delete <提示 ID> ``` 在本地网页界面打开提示: ```sh pnpm prompt-coach open <提示 ID> ``` 从 Markdown 重建 SQLite/FTS 索引: ```sh pnpm prompt-coach rebuild-index ``` 预览和导入 JSONL 转录: ```sh pnpm prompt-coach import --dry-run --file ./transcript.jsonl --save-job pnpm prompt-coach import --execute --file ./transcript.jsonl pnpm prompt-coach import-job <任务 ID> ``` 导入目前以命令行界面为中心。网页界面可以通过常规存档和仅导入的筛选器浏览导入的提示，但没有网页导入上传屏幕。 创建并执行匿名导出: ```sh pnpm prompt-coach export --anonymized --preview --preset anonymized_review --json pnpm prompt-coach export --anonymized --job <导出任务 ID> --json ``` 网页界面仅暴露匿名导出。原始导出未实现。 预览的导出任务在选定的提示集、项目策略版本、编辑版本或预览次数更改时过期和失效。 生成基于复制的提示教练草稿: ```sh pnpm prompt-coach coach pnpm prompt-coach coach --json pnpm prompt-coach improve --text "使此请求更清晰" --json pnpm prompt-coach improve --latest --json ``` 在不返回提示正文的情况下，评估累计的提示习惯: ```sh pnpm prompt-coach score --json pnpm prompt-coach score --latest --json pnpm prompt-coach score --tool codex --json ``` 地分析预览 提示详细信息视图包括基于本地规则的。它总结了提示是否包含明确的目标、上下文、约束格式和验证标准。每个提示还接收一个确定性的 `0-100` 提示质量分数，附带基于检查清单的详细分解。 此预览在本地存储的、经过编辑的提示正文上运行。它不调用外部 LLM 提供程序。 ## 项目指令审查 项目屏幕可以分析项目本地的 `AGENTS.md` 和 `CLAUDE.md` 文件。审查存储带有文件名、哈希值、时间戳、检查清单状态、分数和改进提示的本地快照。 它不存储或返回指令文件正文、原始绝对路径或外部 LLM 结果。分数是项目上下文、代理工作验证命令、隐私/安全和报告规则的确定性本地评分标准。 ## MCP 提示评分 `prompt-coach` 可以通过 stdio MCP 服务器向 Claude Code、Codex 或任何 MCP 客户端公开相同的本地提示质量分数: ```sh prompt-coach mcp ``` MCP 服务器公开了十三个工具: - `get_prompt`: 检查本地存档是否已初始化、是否已捕获提示以及下一个 MCP 工具。 - `coach_prompt`: 为 Claude Code 或 Codex 运行默认的一键代理工作流: 本地准备就绪、最新的提示分数、需要批准的重写、最近的习惯审查、项目指令审查和下一个请求指导。 - `score_prompt`: 评估直接提示文本、存储的 `prompt_id` 或最新的存储提示。 - `improve_prompt直接提示文本、存储的 `prompt_id` 或提示生成一个准备好批准的改进提示草稿。结果还包括一个 `clarifying_questions` 数组（带有 JSON-Schema 格式的 `answer_schema.examples`），代理应通过其原生询问 UI 向用户询问。 - `apply_clarifications`: 获取用户的逐字答案（每个必须标记为 `origin: "user"`）并撰写最终的准备好批准的草稿。在代理通过其自己的询问 UI 收集答案后使用此功能。 - `ask_clarifying_questions`: 提示教练驱动整个询问-然后-应用流程。三个分层路径，按顺序: 1. 当客户端宣传 `capabilities.elicitation` 时（Claude Code 2.1.76+），使用 MCP `elicitation/create`。 . 当调用者通过 `allow_native_dialog: true `PROMPT_COACH=1` 选择加入原生 OS 对话框（macOS `osascriptLinux `zenity`，Windows PowerShell `Microsoft.VisualBasic.InputBox`）。目前在 Codex 上很有用，因为 `ask_user_question` 尚未上线。 3. 否则，返回 `clarifying 元数据（`interaction unsupported|declined|）。绝不自动写。 - `record_clarifications`: 保留用户的答案和生成的草比存储的提示在档（`prompt_improvement_drafts`）。仅返回元数据（`draft_id`、`answers_count`、`changed_sections`，...）- 绝不回显提示正文和草稿文本。仅限本地写入工具。 - `prepare_agent_rewrite`: 准备一个本地编辑的提示数据包、本地分数元数据、本地基线草稿和重写合约 Code/Codex/Gemini CLI 会话可以地改进提示。 - `record_agent_rewrite用户批准后，将重写保存为编辑稿，而不返回重写正文。 - `score_prompt_archive`: 评估最近存储的提示的，并返回聚合分数、重复出现的差距、实践计划、下一个提示模板和低分数提示 ID。 - `review_project_instructions`: 审查最新的或选定的项目的本地 `AGENTS.md` / `CLAUDE.md` 指令文件，并返回分数、检查清单状态和改进提示。 - `prepare_agent_judge_batch`: 为活动 Claude Code/Codex/Gemini CLI 会话准备一个有界的、本地编辑的包和评分标准来进行判断。`prompt-coach` 不会为您调用提供程序。 - `record_agent_j`: 存储由活动代理咨询分数和注释，而提示正文或原始路径。 所有读取工具都是本地的，并声明了一个 MCP `outputSchema` 用于结构化 JSON 元数据和文本 JSON 回退。`record_agent_rewrite` 和 `record_agent_judgments` 是非破坏性的写入工具。存档支持的本地工具不会返回存储的提示正文、原始绝对路径、机密或隐藏的外部 LLM 结果。代理重写/判断模式是可选的，并使用当前的代理会话作为重写者或评估者。 实用代理提示: ```text 使用 prompt-coach coach_prompt 并给我最新的请求的单次指导结果。不要自动提交重写。 使用 prompt-coach get_prompt_coach_status 并告诉我，在评估任何内容之前，提示捕获是否正常工作。 使用 prompt-coach score_prompt，其中 latest=true，并告诉我如何在上一个请求中进行改进。 使用 prompt-coach improve_prompt，其中 latest=true，并给我一个可以直接复制和重新、准备好批准的草稿。 使用 prompt-co_clarifying_questions，其中我的草稿>"您的客户端支持 MCP，prompt-coach 将原生询问 UI ；否则，返回 clar 元数据，以便您UserQuestion 或 Codex_question 询问并将我的答案传递给 apply_clarifications。 使用 prompt-coach prepare_agent_rewrite，其中 latest=true。自己重写该编辑后的提示，请求我的批准，然后如果我希望保存草稿，请调用 record_agent_rewrite。 使用 prompt-co_prompt_archive 评估最近的 Codex 总结我最主要的重复习惯差距。 -coach review_project_instructions，其中 latest=true，并告诉我我的 AGENTS.md/CLAUDE.md 规则是否足以应对编码代理。 使用 prompt-coach prepare_agent_judge_batch，其中 selection=low_score 和 max_prompts=5。自己判断这些提示，然后使用 record_agent_judgments 调用带有您的分数和建议。 ``` 这些工具返回分数元数据、检查清单分解、警告、重复出现的差距、准备好写草稿和改进它们不存储直接提示文本或进行隐藏的外部 LLM 调用。存档支持的评分/重写流程不会返回存储的原始提示正文。存档评分工具还避免原始绝对路径。项目指令审查工具还避免指令文件正文和原始绝对路径。状态工具仅返回安全计数、最新的提示元可用工具名称和下一个操作。 代理评估数据包不同: 当显式请求时，它们会返回本地编辑的提示正文，以便活动 Claude Code/Codex/Gemini CLI 会话可以评估它们。这在 [法律使用指南](docs/LEGAL_USAGE_GUIDE.md) 中有记录。`prompt-coach` 不会提取或代理 Claude.ai OAuth 令牌、Claude Code 内部身份验证令牌AI/Codex/ChatGPT 会话令牌或提供者 API 密钥。 克劳德代码注册示例sh claude mcp add --transport std-coach -- prompt-coach mcp ``` Codex 注册示例: ```sh codex mcp add prompt-coach -- prompt-coach mcp ``` 这些手动示例假设已发布的 `prompt-coach` 二进制文件可在 `PATH` 中找到。对于本地开发，优先使用: ```sh pnpm setup ``` 或重新运行: ```sh pnpm prompt-coach setup --profile coach --register-mcp --open-web ``` 设置命令使用绝对 Node + `dist/cli/index.js` 路径注册 MCP，对于克隆的检出，这对于 Codex 配置来说是更安全的选择。 如果您使用自定义数据目录: ```sh prompt-coach mcp --data-dir /path/to/prompt-coach-data ``` ## 基准 基准测试 v1 衡量本地回归信号的隐私性、检索性、基于规则的提示改进、`coach_prompt` 的可操作性、提示质量评分校准、分析和延迟: ```sh pnpm benchmark pnpm benchmark -- --json ``` 基准测试仅使用合成固定装置。它是一个本地基线，而不是声称完全解决了实际用户质量。 ## 发布烟雾测试 在发布或标记测试版之前运行本地发布烟雾测试: ```sh pnpm smoke:release ``` 烟雾测试脚本会构建软件包，创建一个隔离的临时数据目录和 HOME，启动本地服务器，捕获类似固定装置的 Claude Code 和 Codex 提示，验证 CLI list/search/show/delete/rebuild-index，检查 SQLite WAL/FTS5，并确认已删除的提示元数据已被删除。 还提供浏览器回归烟雾测试: ```sh pnpm e2e:browser ``` 它检查存档、提示详情、提示教练复制/保存流程、项目、匿名导出和移动问题，与真正的本地服务器对抗。 ## 存储 `prompt-coach` 将 Markdown 视为真实来源，将 SQLite 视为索引。 默认文件: ```text ~/.prompt-coach/config.json ~/.prompt-coach/hook-auth.json ~/.prompt-coach/prompt-coach.sqlite ~/.prompt-coach/prompts/ ~/.prompt-coach/logs/ ~/.prompt-coach/quarantine/ ~/.prompt-coach/spool/ ``` 在 POSIX 系统上，prompt-coach 以 `0700` 创建敏感目录，以 `0600` 创建令牌/配置文件。 ## 隐私和安全 默认行为: - 提示捕获仅限于 `127.0.0.1`。 - 钩子摄取使用存储在 `hook-auth.json` 中的本地承载令牌。 - 浏览器 UI 使用同源会话 cookie 和 CSRF 令牌。 - 在 `mask` 模式下，敏感值在 Markdown、SQLite 和 FTS 索引之前被编辑。 - `prompt-coach` 绝不会作为隐藏的后台调用触发外部 LLM 分析。可选的 MCP 代理重写/判断工作流可以在请求时将编辑后的提示数据包返回到活动用户控制的 Claude Code、Codex 或 Gemini CLI 会话，并且该代理可以根据用户的工具设置通过其提供者会话将数据包发送到其提供者会话。 - 提示教练基于复制。它不会自动键入、替换或重新提交提示到 Claude Code 或 Codex。 - 提示重写防护是可选的。在 `block-and-copy` 模式下，它会阻止弱提示并提供复制的本地重写以供手动粘贴/输入。在 `context` 模式下，它会添加模型可见的重写指导，但不会替换原始提示。 - 设置和本地诊断可能会向本地用户显示本地文件系统路径。浏览器提示/存档/导出界面会屏蔽提示正文路径并避免原始提示标识符。 重要限制: - 此工具会存储您提交到连接工具的提示。只有在您允许存储该内容的情况下，才启用钩子。 - 编辑是尽力而为，不应视为完整的数据丢失预防系统。 - 删除会删除提示教练的 Markdown 和 SQLite 行，但不会擦除可能存在于终端历史记录、编辑器缓冲区、备份、文件系统快照或上游 AI 工具转录的副本。 - 该项目不会提取、存储、代理、出售或重用 Claude.ai OAuth 令牌、Claude Code 内部身份验证令牌、OpenAI/Codex 会话令牌或 ChatGPT 帐户令牌。 ## 删除数据 删除单个提示: ```sh pnpm prompt-coach delete <提示 ID> ``` 删除钩子: ```sh pnpm prompt-coach uninstall-hook claude-code pnpm prompt-coach uninstall-hook codex ``` 删除所有提示教练数据: ```sh rm -rf ~/.prompt-coach ``` 如果您在其他地方初始化了 prompt-coach，请使用您配置的 `--data-dir` 路径。 ## 开发 运行完整的本地关卡: ```sh pnpm format pnpm test pnpm lint pnpm build pnpm pack:dry-run ``` 干运行软件包应包括构建的 CLI 文件、构建的 Web 资产、README 和发布文档。 在发布前，请参阅 [软件包内容](docs/PACKAGE_CONTENTS.md) 以确认哪些文件会发布到 npm，并参阅 [发布前隐私审计](docs/PRE_PUBLISH_PRIVACY_AUDIT.md) 获取当前的隐私审查检查清单。 ## 贡献 在打开问题、拉取请求或安全报告之前，请阅读 [CONTRIBUTING](CONTRIBUTING.md)、[CODE OF CONDUCT](CODE_OF_CONDUCT.md)、[SUPPORT](SUPPORT.md) 和 [SECURITY](.md)。 ## 文档 - [PRD](docs/PRD.md) - [第二阶段 PRD](docs/PRD_PHASE2.md) - [软件包内容](docs/PACKAGE_CONTENTS.md) - [发布前隐私审计](docs/PRE_PUBLISH_PRIVACY_AUDIT.md) - [效率docs/EFFICIENCY_REVIEW.md) - [架构](docs/ARCHITECTURE.md) - [技术规格](docs/TECH_SPEC.md) - [实施计划](docs/IMPLEMENTATION_PLAN.md) - [适配器指南](docs/ADAPTERS.md) - [发布检查清单](docs/RELEASE_CHECKLIST.md) - [安全策略](SECURITY.md) ## 许可证 MIT