DSH CYBERLOCAL-FIRST AI CHARACTER & WORLD PLATFORM
一个本地优先、可具身、可成长、可连接真实世界的 AI 角色与世界平台。经营一家公司、开一间酒馆，或创造长期陪伴你的角色——他们拥有身份、记忆、身体、技能与关系，被授权时还能跨出虚拟世界，真正操作现实系统。
一个平台，多个世界
公司、酒馆、或你自己的创造——每个世界拥有各自的角色、会话、知识与产物。角色位置与状态由真实事件驱动，不是随机表演；用创意工坊，四步就能造一个新世界。
当前内置 2 个主题世界；创意工坊已支持自建世界，也欢迎你通过 World Theme 包向社区贡献新的主题空间。
赛博公司 · 总部指挥中心
产品经理、架构师、开发、测试、安全专家各司其职，项目攻坚会在会话中实时推进发布计划。
月影酒馆 · 今夜场景
酒馆老板娘、游吟诗人、负伤骑士群像演绎，角色卡、场景与剧情上下文彼此独立。
工作台 · 三栏布局
左侧会话列表、中间对话与轨迹、右侧世界侧边栏含世界 / 角色 / 知识 / 产物 / 轨迹 / 日程六项 Dock。
创意工坊 · 自建世界
四步向导配置世界、角色、权限与 Skills；本地项目库安全保存，可基于已有项目创建安全副本。
核心能力
不是聊天套壳，而是一个可视化、可玩、可扩展的本地 AI 世界平台——可审计、可成长、可连接真实世界。
真实多角色协作
每个角色拥有独立身份、canonical 私聊、模型策略与成长档案；共享经历与关系证据可持久化，主 Agent 不冒充其他角色。
具身世界模拟
World Runtime + PixiJS 可视化，角色移动、会议、灯光与动作由真实事件驱动；角色感知的氛围行为，拒绝无意义随机走动。
创意工坊
四步向导创建新世界：世界观、场景、Persona、Embodiment 与 Skill 请求分别建模，编译为标准扩展包经市场安装。
会话连续与轨迹审计
会话历史由本地 SQLite 恢复，跨重启不丢失；轨迹按角色、日期、关键词检索，展示真实 Token 用量，完整 Prompt 不入轨迹。
知识库与知识图谱
每世界独立资料库，支持 Markdown / PDF / 网页，FTS5 检索；对话自动整理为实体关系图谱，Canvas 可视化、证据可回溯。
世界产物中心
成果明确发布为不可变版本产物；Markdown、代码、PDF、图片与隔离网页阅读器，随世界进入本地备份，不自动发布。
可信技能运行时
Available → Requested → Granted → Approved → Executed 五段链路；Home Assistant、MCP、Firecrawl 适配器，真实动作可审批可审计。
审批门与世界管理
全局应用锁、18 项世界权限、逐动作决策卡（本次允许 / 一直允许 / 拒绝）；完整主机访问仅一次性显式签发，用后即失效。
本地优先存储
SQLite 为权威数据源，.dshbackup 完整备份覆盖世界、知识、产物与工坊；服务仅监听环回地址，正常升级不清空用户数据。
开源计划
代码、架构文档与包协议全部公开。当前处于 Pre-Alpha 快速架构期，适合本地体验、架构验证与共建——重大领域变化建议先讨论边界，再写实现。
仓库结构
├── packages/ 工作台、API 与内核服务（TypeScript monorepo）
├── marketplace/ 市场 starter 扩展包
├── e2e/ Playwright 端到端验证（Chromium）
├── docs/ 技术报告、架构设计与 Roadmap
└── LICENSE PolyForm Noncommercial 1.0.0
贡献流程
Fork 并克隆仓库
从 GitHub 主仓库创建你的开发分支，先读 CONTRIBUTING 与架构指南。
本地验证
提交前运行 pnpm typecheck 与 pnpm test，PR 必过单元 / 集成 CI。
提交 Pull Request
兼容性问题附 DSH 版本、操作系统、复现步骤与脱敏诊断输出。
评审合并
维护者评审合并，main 推送触发完整 Chromium E2E，贡献者进入致谢名单。
Creative Platform V1 稳定化
Workshop 项目版本与编辑生命周期、角色身份完全以用户设定为准、有证据的知识图谱与对话整理。
进行中工作系统与真实连接
Task / Job / Deliverable / Review 工作系统，GitHub Skill Adapter 与 Browser Skill Adapter。
规划中通道、云同步与 3D
飞书 / QQ / 微信 Channel Adapter，可选加密云同步（本地仍权威），自定义角色 Body / Rig 与未来 3D 世界。
规划中一条命令，启动你的世界
克隆、安装、构建、运行，服务默认监听 127.0.0.1:43123 并自动打开浏览器。点击右上角按钮一键复制全部命令。
# 克隆并安装 $ git clone https://github.com/cyber-ai-agent/dsh-cyber.git $ cd dsh-cyber $ pnpm install $ pnpm build # 启动 Web 工作台（127.0.0.1:43123） $ pnpm dsh-cyber web # 健康检查与完整本地备份 $ pnpm dsh-cyber doctor $ pnpm dsh-cyber backup --output ./backup.dshbackup
市场与 MOD 生态
统一市场包含 World Themes、Plugins 与 Character Blueprints；扩展包拥有 manifest、内容哈希、权限声明与安装事务，默认不执行任意 JS / shell。
World Themes
世界布局、术语、场景与事件动画映射
Plugins
模型、工具、通道、存储等声明式能力扩展
Character Blueprints
可实例化的角色模板，含语义 Embodiment
Skill Recipes
研究、开发、内容、项目管理等默认能力建议
Asset Packs
头像、服装、场景、声音等授权素材