diff --git a/.github/workflows/deploy-gh-pages.yml b/.github/workflows/deploy-gh-pages.yml
index c470683..0afdc00 100644
--- a/.github/workflows/deploy-gh-pages.yml
+++ b/.github/workflows/deploy-gh-pages.yml
@@ -1,4 +1,4 @@
-name: Deploy to gh-pages
+name: Deploy docs to gh-pages
on:
push:
@@ -14,21 +14,10 @@ jobs:
- name: Checkout
uses: actions/checkout@v4
- - name: Setup Bun
- uses: oven-sh/setup-bun@v2
- with:
- bun-version: 1.3.11
-
- - name: Install dependencies
- run: bun install --frozen-lockfile
-
- - name: Build client
- run: bun run build:client
-
- name: Deploy to gh-pages
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: packages/client/dist
+ publish_dir: docs
publish_branch: gh-pages
force_orphan: true
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
index 8b298d0..9b8d938 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -1,4 +1,4 @@
-name: Deploy Client to GitHub Pages
+name: Deploy Docs to GitHub Pages
on:
push:
@@ -19,21 +19,10 @@ jobs:
- name: Checkout
uses: actions/checkout@v4
- - name: Setup Bun
- uses: oven-sh/setup-bun@v2
- with:
- bun-version: 1.3.11
-
- - name: Install dependencies
- run: bun install --frozen-lockfile
-
- - name: Build client
- run: bun run build:client
-
- name: Deploy to gh-pages
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: packages/client/dist
+ publish_dir: docs
publish_branch: gh-pages
force_orphan: true
diff --git a/.gitignore b/.gitignore
index b986d75..b517a53 100644
--- a/.gitignore
+++ b/.gitignore
@@ -26,3 +26,4 @@ bundle.*
docs/*
!docs/call-code-architecture.html
!docs/call-code-architecture.png
+.DS_Store # macOS
\ No newline at end of file
diff --git a/README.md b/README.md
index 4b1e340..235fdef 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ call-code 是一个本地运行的终端编程 Agent(CLI coding agent),基
- 本地记忆:短期记忆按任务保存,长期记忆按主题沉淀,仅在进程内使用,不写入本地 JSON。
- 上下文预算:运行时基于 token 估算对历史消息做裁剪,减少超出模型上下文的风险。
- 会话持久化:基于 Node 内置 `node:sqlite` 保存会话、条目、泳道、分支、记录、统计、事实和租约,默认写入 `.agent-sessions/sessions.db`。
-- 会话展示端:`packages/client` 提供 React + Vite 静态页面,可把会话数据导出为 JSON 后部署到 GitHub Pages。
+- 会话客户端:`packages/client` 提供 React + Vite 会话界面,静态展示已停止,后续用于实时对话展示。
## 架构
@@ -55,7 +55,7 @@ OpenAI-compatible LLM 模型层
-交互式版本见 [docs/call-code-architecture.html](docs/call-code-architecture.html),可明暗主题切换、搜索、关系高亮与节点聚焦,直接在浏览器打开。
+交互式版本见 [docs/call-code-architecture.html](docs/call-code-architecture.html),可明暗主题切换、搜索、关系高亮与节点聚焦,直接在浏览器打开。`docs/` 目录会由 GitHub Actions 发布到 `gh-pages` 分支。
运行时核心流程:
@@ -86,8 +86,8 @@ packages/
utils/ # shell 与文本截断等工具
types/ # 领域类型
utils/ # JSON、日志工具
- web/ # GitHub Pages 客户端数据导出
- client/ # TypeScript + React 会话历史界面,可部署到 GitHub Pages
+ web/ # 会话数据导出
+ client/ # TypeScript + React 会话界面客户端
session-sqlite/ # 基于 node:sqlite 的会话历史与运行状态存储
tests/ # 项目统一单元测试
vitest.config.ts # Vitest 测试配置
@@ -136,7 +136,7 @@ bun dev
/pages 打开相关页面选择
/memory 查看 memory 概览
/status 查看当前 CLI 状态
-/export 导出会话数据到 GitHub Pages 客户端
+/export 导出会话数据到 JSON 文件
/mode 查看当前模式和阶段
/plan 切换到 PLAN 模式
/build 切换到 BUILD 模式
@@ -170,10 +170,10 @@ bun run test
# 构建 agent-core
bun run build:agent-core
-# 导出会话历史到 packages/client/public/data.json
+# 导出会话数据到 packages/client/public/data.json
bun run export:web
-# 构建 GitHub Pages 客户端
+# 构建会话客户端(本地预览用)
bun run build:client
```
diff --git a/docs/call-code-architecture.html b/docs/call-code-architecture.html
index 879a330..9ac4637 100644
--- a/docs/call-code-architecture.html
+++ b/docs/call-code-architecture.html
@@ -4841,7 +4841,7 @@ call-code 架构
-
+
@@ -4920,7 +4920,6 @@
call-code 架构
-
@@ -5029,20 +5028,6 @@
call-code 架构
node:sqlite
-
- 会话展示端 · React + Vite · GitHub Pages · Architecture component
-
-
-
-
-
-
-
-
- 会话展示端
- React + Vite · GitHub Pages
-
-
@@ -5066,13 +5051,6 @@ call-code 架构
会话持久化
-
-
- 导出 data.json
-
-
-
-
Legend
@@ -5285,7 +5263,7 @@ 功能特性
• Ink 终端界面 · 双模式 PLAN/BUILD
• 本地工具集 · 结构化 action 协议
• 短期 / 长期记忆 · token 预算裁剪
- • node:sqlite 会话持久化 + GitHub Pages 展示
+ • node:sqlite 会话持久化
diff --git a/packages/agent-core/src/web/export.ts b/packages/agent-core/src/web/export.ts
index f8a7c56..2ecf2e7 100644
--- a/packages/agent-core/src/web/export.ts
+++ b/packages/agent-core/src/web/export.ts
@@ -6,7 +6,7 @@ import type {
SessionStatsLike,
} from '../harness/session/store-types';
-/** GitHub Pages 客户端读取的会话快照格式。 */
+/** Web 客户端读取的会话快照格式。 */
export interface WebEntry {
seq: number;
id: string;
@@ -120,7 +120,7 @@ const toWebEntry = (entry: EntryLike): WebEntry => {
};
/**
- * 把会话存储导出为静态客户端可用的 JSON 结构。
+ * 把会话存储导出为 Web 客户端可用的 JSON 结构。
* records 和 facts 是可选能力,存储未实现时自动省略。
*/
export const buildWebExport = (
@@ -164,7 +164,7 @@ export const buildWebExport = (
};
};
-/** 把会话快照写入 packages/client 可读取的静态 JSON 文件。 */
+/** 把会话快照写入 packages/client 可读取的 JSON 文件。 */
export const writeWebExport = (
store: WebStore,
outputPath: string,
diff --git a/packages/client/README.md b/packages/client/README.md
index 854e344..80f7bfa 100644
--- a/packages/client/README.md
+++ b/packages/client/README.md
@@ -1,19 +1,19 @@
# Call Code History Client
-这是 CLI 会话历史的静态展示端,基于 TypeScript、React 和 Tailwind CSS 构建,可直接部署到 GitHub Pages。页面默认读取 `data.json`,如果不存在则回退到 `data.example.json` 预览数据;也可以用 `?data=
` 指定数据文件,用 `?session=` 直达某个会话。
+这是 CLI 会话历史的静态展示端,基于 TypeScript、React 和 Tailwind CSS 构建,当前仅用于本地预览,不再部署到 GitHub Pages。页面默认读取 `data.json`,如果不存在则回退到 `data.example.json` 预览数据;也可以用 `?data=` 指定数据文件,用 `?session=` 直达某个会话。
## 构建
```bash
-pnpm build:client
+bun run build:client
```
-产物输出到 `packages/client/dist`,GitHub Actions 会构建后上传该目录。
+产物输出到 `packages/client/dist`,用于本地预览。
## 本地开发
```bash
-pnpm dev:client
+bun run dev:client
```
## 导出数据
@@ -21,19 +21,19 @@ pnpm dev:client
在仓库根目录运行:
```bash
-pnpm export:web
+bun run export:web
```
脚本会把当前 `SESSION_DB_PATH` 指向的会话数据库导出为 `packages/client/public/data.json`。也可以在 CLI 中执行 `/export` 完成同样操作。
-导出文件包含会话、消息、工具调用、统计和事实数据。发布到公开 GitHub Pages 前请先检查内容是否包含不该公开的路径、命令输出或密钥。
+导出文件包含会话、消息、工具调用、统计和事实数据。若后续公开发布,请先检查内容是否包含不该公开的路径、命令输出或密钥。
## 本地预览
预览构建产物:
```bash
-pnpm preview:client
+bun run preview:client
```
## 主题
diff --git a/source/app.tsx b/source/app.tsx
index bdbd887..d9c500e 100644
--- a/source/app.tsx
+++ b/source/app.tsx
@@ -173,7 +173,7 @@ const commandHelp = [
'/pages - 打开相关页面选择',
'/memory - 查看 memory 概览',
'/status - 查看当前 CLI 状态',
- '/export - 导出会话数据到 GitHub Pages 客户端',
+ '/export - 导出会话数据到 JSON 文件',
'/mode - 查看当前模式和阶段',
'/plan - 切换到 PLAN 模式',
'/build - 切换到 BUILD 模式',
diff --git a/tests/web-export.spec.ts b/tests/web-export.spec.ts
index 77bb095..bc1e57a 100644
--- a/tests/web-export.spec.ts
+++ b/tests/web-export.spec.ts
@@ -23,7 +23,7 @@ describe('WebExport', () => {
}
});
- it('构建 GitHub Pages 客户端可读的会话快照', () => {
+ it('构建 Web 客户端可读的会话快照', () => {
const store = createStore();
store.createSession({ cwd: '/tmp/project', id: 's-web' });
store.appendEntry('s-web', {