@hkyhy / marsun-components-core

马森公司（react19 +和6）。从 maoyang_data-asset-system Common / AgentHub；不含业务数据。

远程仓库：[email protected]:hkyhy/MARSUN_components-core.git

演奏厅: https://hkyhy.github.io/MARSUN_components-core/

安装

npm install @hkyhy/marsun-components-core antd react react-dom

发布至 npm(GitHub秘密 HKYHY_PACKAGE_PUBLISH +标签 v* 触发，见「发布版本」）。

快速开始

import '@hkyhy/marsun-components-core/styles';
import '@hkyhy/marsun-components-core/tokens';

import {
  MarsunCoreProvider,
  SemanticTag,
  ChatPanel,
  SessionSidebar,
  applyThemeToCssVariables,
  generateTheme,
} from '@hkyhy/marsun-components-core';

const primaryColor = '#1677ff';
applyThemeToCssVariables(primaryColor);

<MarsunCoreProvider
  auth={{
    isAuthenticated: true,
    hasPermission: (p) => permissions.includes(p),
    hasAnyRole: (roles) => roles.some((r) => userRoles.includes(r)),
  }}
  fetch={{ baseUrl: '/api', headers: { Authorization: `Bearer ${token}` } }}
  primaryColor={primaryColor}
  themeConfig={generateTheme(primaryColor)}
>
  <SemanticTag color="primary">标签</SemanticTag>
  <ChatPanel messages={[]} inputValue="" onInputChange={() => {}} onSend={() => {}} />
</MarsunCoreProvider>;

Token

（v0.1.53+）

agthub / File / Llm：

再出口2级 @deprecated）；新代码请用子路径。

布局(v0.1.57 +)

AgentAppShell 中文名称：；UserProfileCard / brand / brand叠

0.1.54/0.1.55全类型检查；0.1.57 PermissionBindPanel

HTTP (v0.1.58 +)

createMarsunRequest：马森；getResponseError；passThroughEnvelopeError。0.1.60 isMarsunEnvelope（拒绝 {code:200,results} )+ FormData . JSON Content-Type。

项目可在 src/styles/tokens.css 展示；展示；展示 frontend-dev-spec → theme.md。

设计原则

• 零业务依赖：无 departmentPath、personOption 等领域工具；transformData 由消费方实现
• 双模式数据:道具传 data/treeData/options 优先；或 fetchUrl + transformData
• 也许吧：display / hidden / disabled 等支持 boolean | (ctx) => boolean
• 模拟：各组件 doc/*.mock.jsonNPM展示

目录

src/components/
  Auth/ Filter/ Form/ File/ Tag/ Icons/ ...   # Common 拍平
  AgentHub/                                    # Chat + KnowledgeBase

Dev

npm install
npm run dev              # 本地 showcase :5175
npm run build            # 库产物 dist/
npm run build:showcase   # 静态 showcase → dist-showcase/（GitHub Pages）
npm run preview:showcase # 预览 showcase 构建结果
npm run typecheck

GitHub页面

部署金融时报404:说明仓库尚未启用页面,按下列步骤操作(仅需一次):

1. 打开 https://github.com/hkyhy/MARSUN_components-core/settings/pages
2. 构建和部署→源代码 选择 GitHub的行为（从分支部署）
3. 保存后，到 操作→部署GitHub页面→重新运行所有作业

• 推送 main 后由 .github/workflows/pages.yml 自动部署
• 基准路径：/MARSUN_components-core/
• 【翻译】VITE_BASE_PATH=/MARSUN_components-core/ npm run build:showcase && npm run preview:showcase

（npm）

包名为 @hkyhy/marsun-components-core(npm scope . GitHub hkyhy 对齐）。

1. ★★★★★★★★ 设置→秘密→操作 配置 HKYHY_PACKAGE_PUBLISHnpm自动化令牌 @hkyhy 【翻译】
2. 顺号：日常 package.json = NPM最新 npm pack 不要磕碰。发版前 node scripts/version-check.mjs --apply(= npm + 1;0.1.98）
3. 发版2 . push push push push chore(release): vX.Y.Z … 的提交;release.yml →标签→ npm publish（www.zuezu.com）

# 当前 npm latest=0.1.98 时
node scripts/version-check.mjs --apply   # → 0.1.99
# 再 commit chore(release): v0.1.99 … 并 push main

动作 发布npm1、中文：

• 2026-10-29：v0.1.141 - InboxBell标签，标签，标签 #f8fbff（npm publish）

• 2026-10-29：v0.1.140 -表：http://www.chinac.chinac.com/ fixed 【中文翻译

• 2026-10-23：v0.1.138 - CreateActionForm:allocatorDisabled / defaultAssigneeUserId(相关s3 - 1523)

• 2026-10-22：v0.1.137 - InboxBell:action_assigned_ack ；相关S3-1721

• 2026-10-21：v0.1.136 —messagcenter levelOptions（l1 / l2 / l3; s3 l2 +）

• 2026-10-16：v0.1.135 — 新建跟踪任务分配人/执行人必填星与任务类型同为 is-req（去掉 marsun-form-info-is-req）

• 2026-10-14：v0.1.134 -收件铃抽屉 markAllRead;演示/急速地

• 2026-10-12：v0.1.133 ——DispositionBar短徽章;模板来源标签;ActionList去壳/铃铛摘要色;执行门禁SSOT;轻快地外部子路径防双反应(壮举分支曾误标0.1.135未进,顺号回正)

• 2026-10-11：v0.1.132 - 0.1.131 CI

• 2026-10-11：v0.1.131 -中国生物科技有限公司（中国生物科技有限公司）

• 2026-10-11：v0.1.130 - InboxBell selected 标签：标签：标签：标签

• 2026-10-10：v0.1.129 - InboxBell吐司 createPortal 渲.（蚂蚁通知）

• 2026-10-09：v0.1.124 - CreateAction FormInfo DatePicker . scopeMode=none（token token）

• 2026-09-23：v0.1.122 ——ActionListTable默认scrollX对齐长状态列(0.1.121已发后补发)

毛阳

【中文】 maoyang_data-asset-system 批量替换：

import { SemanticTag, FetchTreeSelect } from '@hkyhy/marsun-components-core';
// 业务 wrapper 留在 maoyang
import { DepartmentSelect } from '@/components/Common/Form/DepartmentSelect';