JOJO
39a7a5fc6f
- website-content/：官网 10 篇文档内容 + README - website-design/：官网设计稿、动画实验、预览图与资源 - 根目录官网截图两张 - .gitignore 忽略 website-design/exp/static/dist 构建产物（7.1MB）
144 lines
7.6 KiB
HTML
144 lines
7.6 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>Astrion 手册</title>
|
||
<meta name="description" content="Astrion 使用手册：安装、核心概念、安全、能力。开源、自托管、数据不出本机。" />
|
||
<link rel="stylesheet" href="../shared/astrion-avatar.css" />
|
||
<link rel="stylesheet" href="css/style.css" />
|
||
</head>
|
||
<body>
|
||
|
||
<!-- ═══════ 固定左栏：品牌 + 简介 + 目录 ═══════ -->
|
||
<aside class="side">
|
||
<a class="side-brand" href="#top">
|
||
<span class="side-avatar" id="sideAvatar"></span>
|
||
<span class="side-name">Astrion</span>
|
||
</a>
|
||
<p class="side-intro">住在你机器上的智能体工作台。开源、自托管、数据不出本机。</p>
|
||
<nav class="toc" aria-label="目录">
|
||
<a href="#quickstart" class="toc-item">快速上手</a>
|
||
<a href="#concepts" class="toc-item">核心概念</a>
|
||
<a href="#security" class="toc-item">安全</a>
|
||
<a href="#capabilities" class="toc-item">能力</a>
|
||
<a href="#chapters" class="toc-item">文档章节</a>
|
||
</nav>
|
||
<a class="side-gh" href="https://github.com/JOJO6618/astrion" target="_blank" rel="noopener">GitHub ↗</a>
|
||
</aside>
|
||
|
||
<!-- ═══════ 正文 ═══════ -->
|
||
<main class="page" id="top">
|
||
|
||
<!-- 快速上手 -->
|
||
<section class="chapter" id="quickstart">
|
||
<h1><span class="ch-no">§1</span>快速上手</h1>
|
||
<p class="lead">三分钟，从克隆到对话。环境要求：Python 3.10+、Node.js 18+；docker 模式另需 Docker。</p>
|
||
|
||
<h3>host 模式</h3>
|
||
<p>本地个人智能体：数据落在本机 <code>~/.astrion</code>，命令跑在宿主机 OS 沙箱内。</p>
|
||
<div class="cmd-block">
|
||
<button class="copy-btn" data-copy aria-label="复制">
|
||
<svg class="icon-copy" viewBox="0 0 24 24"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
|
||
<svg class="icon-check" viewBox="0 0 24 24"><polyline points="20 6 9 17 4 12"/></svg>
|
||
</button>
|
||
<pre><code>git clone https://github.com/JOJO6618/astrion.git
|
||
cd astrion
|
||
./setup.sh # 向导：运行模式选 host → 端口 → 管理员 → 模型
|
||
npm install && npm run build
|
||
./start.sh # → http://localhost:8091</code></pre>
|
||
</div>
|
||
|
||
<h3>docker 模式</h3>
|
||
<p>线上多人服务（README 中称 web 模式）：应用本体仍在宿主机，Docker 为每个用户提供独立的命令沙箱容器。邀请码注册制。</p>
|
||
<div class="cmd-block">
|
||
<button class="copy-btn" data-copy aria-label="复制">
|
||
<svg class="icon-copy" viewBox="0 0 24 24"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
|
||
<svg class="icon-check" viewBox="0 0 24 24"><polyline points="20 6 9 17 4 12"/></svg>
|
||
</button>
|
||
<pre><code># 步骤 1-3 与 host 相同，向导中运行模式选 web
|
||
# 额外一步：构建沙箱镜像
|
||
docker build -f docker/terminal.Dockerfile -t my-agent-shell:latest .
|
||
./start.sh</code></pre>
|
||
</div>
|
||
<p class="fine">镜像名由 <code>TERMINAL_SANDBOX_IMAGE</code> 指定；容器名前缀由 <code>TERMINAL_SANDBOX_NAME_PREFIX</code> 指定。</p>
|
||
</section>
|
||
|
||
<!-- 核心概念 -->
|
||
<section class="chapter" id="concepts">
|
||
<h2><span class="ch-no">§2</span>核心概念</h2>
|
||
<p class="lead">行为边界由四组正交开关定义，一眼可见、一点即切。唯一例外：计划模式会把权限与执行环境锁定为「只读 + 沙箱」。</p>
|
||
<div class="spec-table">
|
||
<table>
|
||
<thead><tr><th>维度</th><th>可选值</th><th>含义</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>部署模式</td><td>host / docker</td><td>命令跑在宿主机，还是每个用户的独立容器</td></tr>
|
||
<tr><td>权限模式</td><td>只读 / 批准 / 自动审核 / 无限制</td><td>写操作落盘前要经过谁</td></tr>
|
||
<tr><td>执行环境</td><td>沙箱 / 直连</td><td>命令是否约束在 OS 沙箱内</td></tr>
|
||
<tr><td>运行模式</td><td>计划 / 询问 / 执行</td><td>AI 与你的交互节奏</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- 安全 -->
|
||
<section class="chapter" id="security">
|
||
<h2><span class="ch-no">§3</span>安全</h2>
|
||
<p class="lead">命令隔离强度取决于平台，如实列出；资产保护有三层，与平台无关。</p>
|
||
<div class="spec-table">
|
||
<table>
|
||
<thead><tr><th>平台</th><th>沙箱实现</th><th>水位</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>Windows</td><td>WSL2</td><td><i class="dot ok"></i>完全数据隔离，需先安装 WSL2</td></tr>
|
||
<tr><td>macOS</td><td>sandbox-exec</td><td><i class="dot warn"></i>限写入；全局可读，防不住泄露</td></tr>
|
||
<tr><td>Linux</td><td>bwrap + seccomp</td><td><i class="dot untested"></i>未实测，别依赖</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<ul class="facts">
|
||
<li><strong>版本控制</strong>——每条你发出的消息打一个检查点，随时回溯；浅备份只追踪 write_file / edit_file 编辑过的文件。</li>
|
||
<li><strong>修改留痕</strong>——每次编辑落盘一份标准 diff，<code>git apply</code> 重做，<code>git apply -R</code> 撤销。</li>
|
||
<li><strong>Git 状态栏</strong>——仓库状态实时可见。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<!-- 能力 -->
|
||
<section class="chapter" id="capabilities">
|
||
<h2><span class="ch-no">§4</span>能力</h2>
|
||
<ul class="facts">
|
||
<li><strong>多智能体团队</strong>——Team Leader 带领 5 个预置角色（全栈 / 评审 / 调研 / UI 操作 / 头脑风暴）分工协作，可自建角色。</li>
|
||
<li><strong>快捷窗口</strong>——对话区右侧五看板：待办、子智能体、后台命令、文件记录、工作流。</li>
|
||
<li><strong>工作流与技能包</strong>——流程沉淀为工作流，经验沉淀为 Skill；内置 4 个工作流、12 个技能包。</li>
|
||
<li><strong>目标模式（Beta）</strong>——给出长期目标，自动逐轮推进，审核智能体把关，触顶或达成才停。</li>
|
||
<li><strong>MCP 扩展</strong>——接入任意 MCP 工具服务；host 模式下说一句「帮我配置 xxx」即可装好。</li>
|
||
<li><strong>实时终端</strong>——对话里直接跑命令。这是效率设计，不是安全边界。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<!-- 文档章节 -->
|
||
<section class="chapter" id="chapters">
|
||
<h2><span class="ch-no">§5</span>文档章节</h2>
|
||
<div class="chapter-list">
|
||
<span><em>01</em>快速上手</span>
|
||
<span><em>02</em>核心概念</span>
|
||
<span><em>03</em>对话</span>
|
||
<span><em>04</em>输入与上下文</span>
|
||
<span><em>05</em>执行与安全</span>
|
||
<span><em>06</em>对话资产管理</span>
|
||
<span><em>07</em>智能体能力</span>
|
||
<span><em>08</em>快捷窗口</span>
|
||
<span><em>09</em>个人空间设置</span>
|
||
<span><em>10</em>CLI（开发中）</span>
|
||
</div>
|
||
</section>
|
||
|
||
<footer class="foot">
|
||
<p>© 2026 Astrion · 开源 · <a href="https://github.com/JOJO6618/astrion" target="_blank" rel="noopener">GitHub</a> · 星之子，星际粒子。</p>
|
||
</footer>
|
||
</main>
|
||
|
||
<script src="../shared/astrion-avatar.js"></script>
|
||
<script src="js/main.js"></script>
|
||
</body>
|
||
</html>
|