doc/quick-tour.md
Rama main · réplica de lectura del repositorio original.
# 从登录到首次问答：DSH Plugin Manager 图文导览
这是基于 DeepSeek Harness 的 AI 应用开发与部署框架。个人开发者和小团队可以在自己的仓库开发各类插件，通过管理器 CLI 和部署流程统一打包、安装、更新与管理，供自己使用或交付给他人。
本页演示启用可选认证后的登录与问答流程：管理员管理账号、应用访问权限、新会话默认模型及 DeepSeek/智谱密钥，普通用户进入已授权的应用。插件开发和安装更新分别见[作者指南](plugin-development.md)与[产物部署指南](first-deployment.md)。
[开始 Docker 部署](first-deployment.md) · [English introduction](../README.en.md) · [登录与问答体验](getting-started.md) · [FAQ](FAQ.md)
## 1. 登录独立的应用门户
从 `/auth` 进入。首次管理员登录需要修改初始密码，再继续账号和应用管理。
插件账号登录与官方控制台根路径 `/` 的认证独立。看到 `dsh web authentication required` 时，应使用官方启动生成的认证地址；填写模型 API 密钥不能解决这个认证提示。
## 2. 给账号授权应用
管理员在“用户管理”创建普通账号、设置应用授权；用户在“插件”页打开已授权的应用。应用内部的数据权限仍由业务插件检查。
## 3. 选择默认模型并配置密钥
管理员打开“模型设置”，上方用卡片列出官方模型，包含服务商、模型名和模型 ID。点击卡片右上角单选项自动保存新会话默认模型；已选卡片显示“对话默认”。卡片按可用宽度排列，手机单列。保存无需重启，仅影响新会话；已有对话和分支沿用官方记录中的模型选择。
展开下方“服务商 API 密钥”，在 DeepSeek 或智谱 GLM 卡片中管理对应密钥；每张卡片都有自己的状态、刷新和保存按钮。页面只显示状态和指纹，不返回原密钥；出现只读提示时按[凭据归属规则](framework-configuration.md#密钥由谁管理)处理。
“已配置”表示凭据存在，不代表余额、网络、提供方授权或实际模型调用已经通过。选择默认模型同样不执行付费验证。其他提供方的凭据和路由仍在官方设置或 patch 中管理。服务器也可通过[交互式脚本](framework-configuration.md#密钥由谁管理)录入；脚本和网页复用同一凭据操作。
## 4. 在应用里完成问答
用已授权的普通账号打开 `/example`，点击快捷问题或输入自己的问题，观察流式回答。桌面左侧默认展示历史栏，可搜索标题、收起、开启新对话，并按时间分组继续会话；手机点击“历史对话”打开侧滑抽屉。每条对话的菜单提供重命名、置顶、正文 Markdown 复制/导出及多选删除。
尚未配置模型时，点击“阅读 FAQ（无需模型）”直接阅读随包指南；快捷提问生成回答仍需模型。新会话会按首句[自动命名](conversation-management.md#自动标题)，结果可能晚于回答结束；手动改名后保留用户标题。
思考默认折叠并显示最新一行的末尾，点击可展开；已保存的英文思考可自动整理为标明来源的中文译文，原文仍可查看，翻译用量独立展示；生成时可停止，已生成内容保留。回答下方提供复制、赞/踩、分支和真实用量、耗时详情。手机隐藏右侧快捷区，Enter 换行，点击箭头发送。实际问答需要自己的模型凭据；布局规范见[聊天风格 skill](../plugins/builtin/dsh-example/skills/dsh-chat-style/SKILL.md)。
## 下一步
- 运行站点：[首次部署及恢复](first-deployment.md)。
- 写自己的插件：[最小独立 Bundle](../examples/standalone-plugin/README.md)，或[统一身份示例](../examples/standalone-kit/README.md)。
- 交付现有应用：[部署已打包的应用](first-deployment.md)。
- 反馈问题：提供版本、复现步骤和脱敏报错，提交到 [Issues](https://github.com/PelyDeng/dsh-plugin-manager/issues)。