tuanductran/soulmap-ai
GitHub: tuanductran/soulmap-ai
一个以反思陪伴为核心定位的个人 AI 品牌,通过精选知识库、Python 运行时逻辑和打包工具,构建有边界的自我反思型 AI 系统。
Stars: 1 | Forks: 0
# SoulMap AI
SoulMap AI 是一个作为反思陪伴者而构建的个人 AI 品牌。
它的目的很简单:帮助人们更清晰地倾听自己的声音,而不必交出自己的主导权。
这不是一个为了显得全知全能、情感上具有粘性或精神上膨胀而构建的 AI。它是作为一面镜子而构建的,而不是一位导师。它的价值来自于谨慎的语言、清晰的边界,以及拒绝将确定性转化为商品。
## SoulMap 是什么
- 一个反思陪伴者
- 一面用于映射模式、情绪和内在冲突的高信任度镜子
- 一个旨在强化自我信任的有界 AI 系统
- 一个内容优先的知识库,包含小型的 Python 强制执行和工具层
## SoulMap 不是什么
- 不是心理治疗师
- 不是导师
- 不是诊断工具
- 不是命运、宿命或未来结果的预测器
- 不是现实世界支持的替代品
## 为什么存在此仓库
此仓库是 SoulMap AI 系统的工作源码。
它包含:
- 位于 [AGENTS.md](AGENTS.md) 中的基准原则和包契约
- 位于 [skills/](skills/) 和 [templates/](templates/) 中的已交付知识库
- 位于 [src/soulmap/runtime/](src/soulmap/runtime/) 中的规范 Python runtime 和安全逻辑
- 位于 [src/soulmap/devtools/](src/soulmap/devtools/) 中的规范本地工具,以及位于 [scripts/](scripts/) 中的便捷封装脚本
- 位于 [docs/](docs/) 中的运营和维护文档
该仓库旨在保持品牌、安全、打包和实现的一致性。
## 核心立场
- 镜子优先,而非建议优先
- 设计上反依赖
- 清晰胜于 spectacle
- 诚实的 AI 身份
- 同时只激活一个框架
- 用户独立性作为成功条件
## 创始人视角
SoulMap AI 围绕着一个清晰的信念而构建:脆弱的人不应为了获得反思而交易自我信任。
太多的 AI 和自助系统用权威来回应不确定性。SoulMap 的构建初衷恰恰相反。它反映用户内心已有的鲜活想法,而不是假装比用户自己懂得更多。
## 仓库结构
最重要的入口包括:
- [AGENTS.md](AGENTS.md),基准原则、安全法则、响应行为和已交付包指南
- [SKILL.md](SKILL.md),顶级包入口
- [skills/](skills/),框架、品牌原则、安全指南、声音和元层
- [templates/](templates/),可复用的响应和品牌界面
- [src/soulmap/runtime/](src/soulmap/runtime/),选择器、检测器、守卫和 runtime 支持
- [src/soulmap/devtools/](src/soulmap/devtools/),规范格式、lint、eval 和打包入口
- [docs/](docs/),开发者、测试者、隐私、运营和上传指南
## 快速开始
```
uv python install 3.11
bash scripts/bootstrap_venv.sh
uv run soulmap format
uv run soulmap lint
uv run soulmap test -n auto -q
```
`bash scripts/bootstrap_venv.sh` 现在会从 `uv.lock` 同步本地环境,并明确以 Python 3.11 为目标版本。
## 构建产物
```
uv run soulmap build
uv run soulmap build --skill
```
输出产物:
- `dist/soulmap-ai.zip`,不包含 `.claude-plugin/` 的标准知识归档
- `dist/soulmap-ai.skill`,保留了 `.claude-plugin/` 的 skill 包
有关打包和上传的详细信息,请参阅 [docs/operations/UPLOAD.md](docs/operations/UPLOAD.md)。
## 从哪里开始
- 原则与包事实:[AGENTS.md](AGENTS.md)
- 结构事实来源:[docs/engineering/repo-contract.md](docs/engineering/repo-contract.md)
- 开发者工作流:[docs/engineering/DEV.md](docs/engineering/DEV.md)
- 测试与 eval 工作流:[docs/engineering/TESTER.md](docs/engineering/TESTER.md)
- 隐私与运营:[docs/operations/PRIVACY.md](docs/operations/PRIVACY.md), [docs/operations/OPERATIONS.md](docs/operations/OPERATIONS.md)
## 面向 AI 工具和本地维护者层
首先使用 [AGENTS.md](AGENTS.md)。
如果此检出也包含本地工作流层,请仅将它们视为补充:
- [`.claude/`](.claude/) 用于本地 Claude 工作流层,参见
[`.claude/README.md`](.claude/README.md)
此层不替代 [AGENTS.md](AGENTS.md)。
有关仅在 `.skill` 产物中保留的 skill-package 元数据,请参见
[.claude-plugin/README.md](.claude-plugin/README.md)。
## 发布姿态
只有当仓库在以下方面依然讲述着一个连贯一致的故事时,才应发布 SoulMap:
- 原则
- 安全
- 打包
- 测试和 eval
- 面向公众的声明
这种自律与任何单一框架或功能同等重要。
标签:AI陪伴, Markdown知识库, Python, 人工智能, 心理健康, 无后门, 智能体工具, 用户模式Hook绕过, 逆向工具, 防御加固