Jingyun DSH 使用手册

本规划旨在为 Jingyun DSH Client（井云一站式 AI 商业化桌面客户端）构建一套多维度、全方位的产品文档体系。

由于 Jingyun DSH Client 不仅是一个 AI 工具客户端，更是一个能够帮助 AI 创业者闭环商业模式的平台，我们将文档体系拆分为 三大手册（用户篇、运营篇、技术篇） 以及 常见问题与免责声明。

🎯 文档体系架构图

graph TD
    A[Jingyun DSH 官方文档中心] --> B[1. 用户指南 - C端用户]
    A --> C[2. 商业化运营手册 - AI创业者]
    A --> D[3. 开发者手册 - 技术团队]
    A --> E[4. 常见问题与条款声明]

    B --> B1[注册登录/订阅升级]
    B --> B2[AI专家库与技能]
    B --> B3[产物工作台]
    
    C --> C1[井云 Studio 对接]
    C --> C2[算力管控与充值定价]
    C --> C3[卡密激活与分销配置]
    
    D --> D1[npm 包无缝集成]
    D --> D2[整仓二次开发/UI定制]
    D --> D3[GUI 一键打包 Windows 客户端]

📖 目录大纲规划

第一部分：用户指南 (C端最终用户篇)

目标：引导最终用户快速上手，无缝体验客户端的各项 AI 增强与商业化功能。

1. 产品简介与安装

   • 什么是 Jingyun DSH Client
   • 支持的系统与硬件要求
   • 客户端下载与安全安装指南

2. 账号与会员体系

   • 手机号一键登录与注册
   • 个人中心与算力余额查询
   • 会员套餐订阅、升级与自动续费
   • 线下卡密激活码的使用与兑换

3. AI 对话与专家切换

   • 新建对话与基本交互
   • 专家库（Role/Agent）：按需一键切换不同领域的 AI 专家（会话级隔离）
   • 技能库（Skills）：如何激活与在对话中使用专家技能

4. 插件市场

   • 浏览 800+ 社区开源插件
   • 插件一键安装、启用与卸载
   • 第三方插件安全提示

5. 产物工作台的使用

   • 侧边产物面板（Artifact Inspector）的拖拽与隐藏
   • 代码文件、Markdown 文档、数据图表的实时预览与导出

6. 云数据与资产库

   • 历史对话云端同步
   • 个人专属知识库文件上传与管理

第二部分：商业化运营手册 (AI创业者/商户篇)

目标：指导 AI 创业者如何零代码/低代码完成井云 Studio 后台接入，配置并发布自己的 AI 商业产品。

1. 平台入驻与租户初始化

   • 注册并登录 井云 Studio (jingyun.studio)
   • 获取你的 tenant_host（租户唯一标识）与 api_url

2. 定价与商业模式配置

   • 订阅套餐设计：如何配置月卡/季卡/年卡会员
   • 算力额度管控：如何针对不同套餐限制每日/每月 Token 用量（按 Token 计费配置）
   • 渠道定价：按量计费与免费额度设定

3. 卡密与激活码管理

   • 批量生成不同规格的卡密激活码（例如：“100万Token算力卡”、“月度体验卡”）
   • 卡密核销状态监控与日志审计
   • 线下分销、私域赠送场景的卡密运营指南

4. 资产上架与应用市场运营

   • 封装发布你的专属 AI 智能体、定制技能包或插件
   • 设置应用市场资产的定价与售卖状态
   • 用户使用反馈与满意度收集

第三部分：开发者手册 (二次开发与打包篇)

目标：指导技术开发团队如何进行定制化开发，或将井云 DSH 商业功能集成到已有产品中。

1. 快速本地开发环境搭建

   • 前置依赖准备（Node.js, pnpm, Rust 编译环境）
   • 获取内嵌运行时（Node.js / Python / Git 便携版）并放入 src-tauri/resources/vendor/
   • 初始化依赖：pnpm install
   • 运行 Web 开发模式：pnpm build && pnpm start
   • 运行桌面开发模式：pnpm tauri:dev

2. 集成方式一：npm 插件包集成 (对于已有 DSH 项目)

   • 运行 npm install @jingyun-ai/jingyun-dsh
   • 配置文件 jingyun-config.json 属性详解
   • 在 DSH 路由和中间件中注入井云身份验证与商业化模块

3. 集成方式二：整仓拉取与品牌定制 (全新定制桌面端)

   • 客户端定制配置：编辑 packages/jingyun-dsh/jingyun-config.json
   • 自定义应用名称、服务域名、Logo 资源替换
   • Tauri 配置（src-tauri/tauri.conf.json）与安全权限（capabilities/default.json）修改指南

4. 客户端构建与一键打包

   • 使用 GUI 打包控制台：在 Windows 下双击运行 run_pack.bat（pack_gui.py 详解）
   • 命令行打包：pnpm tauri:build
   • 基于 NSIS 的安装向导自定义（如安装路径、许可协议界面）

5. 架构设计与核心模块剖析

   • 客户端-服务端（Tauri IPC / HTTP API）通信架构
   • 侧边产物面板（Artifact Inspector）的渲染与扩展机制
   • 专家包生命周期管理器（expert-manager）解析
   • 第三方开源插件注册表数据结构与沙箱安全防范

第四部分：附录与安全声明

1. 常见问题解答 (FAQ)

   • 登录收不到短信怎么办？
   • 算力消耗异常如何排查？
   • 客户端闪退或依赖环境缺失的处理办法

2. 安全合规与免责声明

   • 第三方开源插件安全合规使用声明
   • 用户数据隐私与云同步安全保护条例

3. 开源许可说明

   • Apache 2.0 开源许可规范
   • 关联第三方开源组件（DSH, Tauri 等）许可溯源