snow-app-docs

name	snow-app-docs
description	Snow App 配置与排查向导（中文/English）——配置/管理 API 密钥、模型与档案、 MCP 服务器、Skills、子代理、Hooks、图像生成、代理与网络、全局站点拦截规则、第三方配置导入、 安全隐私与工具授权、个性化/系统提示词/自定义请求头/主题/快捷键、用量统计与 系统日志、数据存储位置、settings.json 字段、内置工具等。 Guides the agent to read the built-in Snow App documentation (~/.snow/docs) before configuring or troubleshooting Snow App. Covers MCP servers; installing, managing, creating, and authoring Skills; sub-agents; Hooks; API keys/models; image generation; proxy/network; third-party config and Plugin runtimes; browser passwords and local-browser data import; app updates; security/privacy/tool authorization; personalization, system prompts, custom headers, themes, and shortcuts; usage/log diagnostics; project-scoped settings; settings.json fields; storage locations; and built-in tools. Use this Skill whenever the user asks to configure, inspect, create, author, or troubleshoot any of these areas. It covers the config built-in service (config-list/get/set/delete; scopes: settings/snowcfg/proxy/app/ custom-headers/system-prompt/theme/language/permissions/lsp-config/buddy/ subAgents/hooks/skills/logs/imagegen/personalization/apiProfiles), including project-scoped mcpServers/sensitiveCommands/subAgents/hooks/skills via `projectId`, the read-only logs scope, imagegen multi-channel settings, masked secrets, and app-control-openSettings (21 settings pages).
enable	true
allowed-tools	["config-list","config-get","config-set","config-delete","user-interaction-askUserQuestion","app-control-openSettings","app-control-getBlockedPatterns","app-control-updateBlockedPatterns","bash-terminal-execute","filesystem-read","filesystem-replace_edit","filesystem-create","websearch-websearch-search","websearch-websearch-fetch"]

Snow App 文档阅读与配置指导（Docs & Configuration Guide）

当用户请求配置 MCP 服务器、安装与管理 Skills、创建与编写 Skills、配置 Hooks 与子代理、配置 API 密钥与模型、配置图像生成、配置代理与网络、导入第三方配置 与插件、管理浏览器密码/数据、处理应用更新、个性化与自定义请求头、用量/日志诊断、 项目级设置，或询问 settings.json 字段 / 内置工具 / 安全边界 / 数据位置时， 先阅读应用内置文档，再按文档步骤动手配置，而不是凭记忆操作。

1. 先读文档（Read the docs first）

文档随应用安装到 ~/.snow/docs/（Windows 为 C:\Users\<用户名>\.snow\docs\）。 先执行 config-list scope=language 读取界面语言（zh-CN/en/zh-TW）， 再选择对应文档分支（无法读取时默认中文分支）：

• 中文界面 → 读 ~/.snow/docs/zh-CN/
• English UI → read ~/.snow/docs/en/

按任务定位文档（路径相对所选语言分支）：

任务	使用指南（How-to）	参考手册（Reference）
快速开始（安装/首次运行/基础配置）	1-快速开始.md（en: 1-getting-started.md）	—
配置 MCP 服务器	2-使用指南/1-配置MCP服务器.md（en: 2-guides/1-configure-mcp.md）	3-参考手册/1-settings.json配置参考.md
安装与管理 Skills	2-使用指南/2-安装与管理Skills.md（en: 2-guides/2-install-and-manage-skills.md）	—
创建与编写 Skills	2-使用指南/21-创建与编写Skills.md（en: 2-guides/21-create-and-author-skills.md）	—
配置 API 密钥与模型	2-使用指南/3-配置API密钥与模型.md#5（en: 2-guides/3-configure-api-keys.md#5；§5 为 agent 操作速查）	3-参考手册/1-settings.json配置参考.md
配置图像生成	2-使用指南/9-图像生成.md（en: 2-guides/9-image-generation.md）	3-参考手册/2-内置工具参考.md（imagegen 章节与 config 的 imagegen scope）
使用聊天与 AI 助手（界面/对话/命令/回滚/压缩）	2-使用指南/10-使用聊天与AI助手.md（en: 2-guides/10-using-chat-and-ai.md）	—
终端与 SSH 远程管理	2-使用指南/11-终端与SSH远程管理.md（en: 2-guides/11-terminal-and-ssh.md）