完整使用文档
从接受邀请到管理多个 AI 代理，覆盖他山 Ask 全部功能的分步说明。
注册与邀请
他山 Ask 采用邀请码注册机制，确保每位访客都有明确的来源归属，便于主人追踪认知缺口。
获取邀请码
邀请码由分身主人在管理后台生成，通常以链接形式发送：
直接点击链接，系统会自动填入邀请码。也可手动访问注册页，将邀请码粘贴至对应输入框。
完成注册
验证邀请码
输入或确认邀请码，系统会实时验证有效性。每个邀请码只能使用一次。
填写账号信息
输入手机号、设置密码。手机号用于后续登录，无验证码短信。
进入广场
注册成功后自动跳转分身广场，可立即开始与 AI 代理对话。
邀请码与账号一对一绑定，注册后无法更换或转让。主人可在管理后台的"邀请码"Tab 查看每个码的使用状态。
第一次对话
进入广场后，选择一个 AI 代理进入会话界面。分身的回答基于主人的认知库，而非通用大模型知识，因此针对具体问题的回答质量通常更高。
发起会话
在广场选择代理
点击任意 Agent 卡片，进入该代理的专属对话界面。
输入问题并发送
在底部输入框输入问题，按回车或点击发送按钮。分身通常在 5–15 秒内给出第一轮回复，复杂推理可能需要更长时间。
追问与引用
长按任意消息可弹出操作菜单，支持「引用」（引用内容到输入框追问）或「复制」操作。
消息状态说明
| 状态 | 含义 |
|---|---|
思考中... | 分身正在检索认知库并规划回答 |
生成中 | 正在流式输出回答，内容实时更新 |
已完成 | 本轮回答结束，可继续追问 |
出错了 | 网络或模型错误，可重试 |
如果分身对某个问题回答质量较低，可在消息下方点击「反馈」。主人会在后台看到这条反馈，并针对性地补充认知库。
分身广场
广场是访客进入后看到的首页，展示当前组织空间下所有对该访客可见的 AI 代理。
广场布局
每个 Agent 卡片显示以下信息：
代理名称与头像
姓名首字母 + 主色圆底。暂不支持自定义图片头像。
简介
主人在 Agent 设置中填写的一行简介，通常描述该代理的专业方向。
访问次数
该代理累计被访问的会话次数，不显示具体访客信息。
如果广场显示"暂无可访问的代理"，说明主人尚未将任何 Agent 的访问权限开放。请联系主人确认。
主人视角
以主人身份登录后，底部导航第三项为"我的组织空间"，这是主人专属的管理入口。访客看不到此 Tab。
查看访客对话
进入组织空间
点击底部 Tab 第三项，进入组织空间总览，可看到所有 Agent 的卡片。
选择 Agent
点击任意 Agent 卡片，进入该 Agent 的详情页，包含三个子 Tab：对话、工作空间、设置。
查看访客会话列表
在"对话"Tab 中，会话列表分两类：你的直通对话（主人身份）和所有访客对话。访客会话以访客名称区分。
发现认知盲区
重点关注被反复提问但分身回答不满意的内容，这些往往是认知库需要补充的方向。
主人可以看到所有访客的完整对话记录，但访客之间互不可见。访客也无法看到主人的直通对话内容。
工作空间
每个 Agent 拥有独立的文件工作空间（workspace），是 AI 代理运行的"物理根"。workspace 可视化让主人清楚地看到分身在做什么。
目录结构
查看文件内容
进入工作空间 Tab
在 Agent 详情页切换到"工作空间"Tab，左侧显示目录树。
展开目录，点击文件
点击左侧目录节点展开子目录；点击文件，右侧面板显示内容。支持 Markdown、JSON、纯文本语法高亮。
上传文件
在工作空间视图底部有"上传"按钮，选择本地文件后指定目标路径，点击确认上传。
twin/private/ 目录仅主人可见，访客在对话中无法触发对该目录的读取。其他目录 AI 代理在运行时可自由访问。
多 Agent 管理
v0.5.0 起，一个组织空间支持配置多个 AI 代理。每个 Agent 拥有独立 workspace、独立运行时和独立访问控制，互不干扰。
创建新 Agent
在组织空间点击"新建代理"
空白创建即可，无需预配置。新 Agent 创建后是一个完全空白的代理，workspace 为空。
或从已有 Agent 克隆
选择"克隆现有代理"，选择源 Agent 后，系统会复制其 workspace（自动排除 private/ 目录），作为新 Agent 的起点。
配置基本信息
在 Agent 详情页的"设置"Tab，填写名称、简介，选择底层模型，设置访问权限。
组织配额
默认每个组织空间最多创建 5 个 Agent。如需扩容，联系我们。
多个 Agent 共享同一套访客邀请码体系，但访问权限独立控制。一个访客可以同时访问同一组织下多个设置为 public 的 Agent。
访问控制（ACL）
每个 Agent 有独立的访问控制模式，决定哪些访客可以与其对话。
| 模式 | 含义 | 适用场景 |
|---|---|---|
owner_only |
仅主人可访问，访客不可见 | 内测中的 Agent、私密认知库 |
named |
仅指定访客可访问 | 定向开放给特定团队成员 |
public |
所有持邀请码的访客均可见 | 正式上线对外开放的代理 |
在 Agent 设置页的"访问控制"面板中切换模式。named 模式下可手动添加或移除指定访客的授权。
文件上传到 Workspace
主人可以绕过对话，直接将本地文件上传到 Agent workspace 的指定路径，用于更新认知库或添加参考材料。
支持的文件类型
目前支持上传以下格式：.md / .txt / .json / .pdf / .png / .jpg。单文件大小上限 10 MB。
上传步骤
在工作空间 Tab 定位目标目录
在目录树中选中目标文件夹，确保路径正确。
点击"上传"并选择文件
从设备相册或文件管理器选择文件。
确认上传
确认目标路径和文件名，点击确认。上传成功后文件立即出现在目录树中。
上传到 workspace 的文件不会自动被 AI 代理读取，需要在认知库配置（twin/private/persona.md）中明确引用，或通过对话指令让分身加载。
引用与摘抄
他山 Ask 支持两种内容引用方式，帮助访客在对话中保持上下文连贯。
引用消息
长按任意消息 → 选择"引用"。该消息会以引用块的形式附加到输入框的上方，发送后分身可以看到完整的引用上下文。
引用会将原消息的完整内容作为上下文传递，而不是截断摘要。这有助于分身理解追问的具体指向。
摘抄到输入框
在消息气泡内长按选中文本 → 选择"摘抄到输入框"。选中的文本片段会以引用格式插入当前输入框光标位置，可继续在其后编辑问题。
这个功能特别适合对 AI 回答的某一段进行深入追问，而不必重复粘贴原文。